capacitor-rfid-plugin-ox 0.4.0 → 0.5.0

package/README.md

@@ -14,6 +14,9 @@ npx cap sync
 <docgen-index>
 
 * [`getCapabilities()`](#getcapabilities)
+* [`getConnectionState()`](#getconnectionstate)
+* [`listReaderPorts()`](#listreaderports)
+* [`selectReaderPort(...)`](#selectreaderport)
 * [`isConnected()`](#isconnected)
 * [`startScan()`](#startscan)
 * [`stopScan()`](#stopscan)
@@ -31,7 +34,10 @@ npx cap sync
 * [`writeEpcString(...)`](#writeepcstring)
 * [`startSearch(...)`](#startsearch)
 * [`stopSearch()`](#stopsearch)
+* [`addListener('onConnectionState', ...)`](#addlisteneronconnectionstate-)
+* [`addListener(string, ...)`](#addlistenerstring-)
 * [Interfaces](#interfaces)
+* [Type Aliases](#type-aliases)
 
 </docgen-index>
 
@@ -54,6 +60,71 @@ failure: the caller treats a rejection as a handheld Mobile Reader.
 --------------------
 
 
+### getConnectionState()
+
+```typescript
+getConnectionState() => Promise<ReaderConnectionState>
+```
+
+Connection state for the first render. The stream of later changes comes
+from the `onConnectionState` listener — "not responding" is only found out
+after a timeout, so it cannot be a return value.
+
+A reader is an exclusive resource, so its state is only knowable while it
+is held: an implementation that is not connected may start an attempt here
+and answer `connecting`, with the outcome arriving on the listener.
+
+Implementations that predate this method reject. The caller then hides the
+indicator instead of guessing.
+
+**Returns:** <code>Promise&lt;<a href="#readerconnectionstate">ReaderConnectionState</a>&gt;</code>
+
+--------------------
+
+
+### listReaderPorts()
+
+```typescript
+listReaderPorts() => Promise<{ ports: ReaderPort[]; }>
+```
+
+The readers plugged in right now, newest listing every call — a port that
+was there a minute ago may be gone.
+
+Only readers, not every serial port: what the caller does with this list
+is offer it as a choice, and a Bluetooth port is not a choice.
+
+Implementations that predate this method reject. The caller then keeps
+whatever the driver picks on its own.
+
+**Returns:** <code>Promise&lt;{ ports: ReaderPort[]; }&gt;</code>
+
+--------------------
+
+
+### selectReaderPort(...)
+
+```typescript
+selectReaderPort(options: { path: string; }) => Promise<void>
+```
+
+Use this reader from now on. Reconnects when another port is open.
+
+The choice itself is not stored here: the driver is restarted with the
+app, and where a choice belongs is the caller's question. The caller
+remembers the path and says it again on the next start.
+
+Rejects when the path is not in the current `listReaderPorts()` — a
+remembered reader that was unplugged has to be chosen again, not opened
+blindly.
+
+| Param         | Type                           |
+| ------------- | ------------------------------ |
+| **`options`** | <code>{ path: string; }</code> |
+
+--------------------
+
+
 ### isConnected()
 
 ```typescript
@@ -255,6 +326,40 @@ stopSearch() => Promise<void>
 --------------------
 
 
+### addListener('onConnectionState', ...)
+
+```typescript
+addListener(eventName: 'onConnectionState', listener: (state: ReaderConnectionState) => void) => Promise<PluginListenerHandle>
+```
+
+Every connection state change. Fires only on a change, not on a poll.
+
+| Param           | Type                                                                                        |
+| --------------- | ------------------------------------------------------------------------------------------- |
+| **`eventName`** | <code>'onConnectionState'</code>                                                            |
+| **`listener`**  | <code>(state: <a href="#readerconnectionstate">ReaderConnectionState</a>) =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
+### addListener(string, ...)
+
+```typescript
+addListener(eventName: string, listenerFunc: (...args: any[]) => any) => Promise<PluginListenerHandle>
+```
+
+| Param              | Type                                    |
+| ------------------ | --------------------------------------- |
+| **`eventName`**    | <code>string</code>                     |
+| **`listenerFunc`** | <code>(...args: any[]) =&gt; any</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
 ### Interfaces
 
 
@@ -271,4 +376,70 @@ that cannot.
 | **`isHandheld`** | <code>boolean</code>                                        | Reader is a handheld terminal rather than a desk device.              |
 | **`power`**      | <code>{ min: number; max: number; default: number; }</code> | Output power range in dBm. The power slider renders this range.       |
 
+
+#### ReaderConnectionState
+
+| Prop         | Type                                                                      | Description                                                                                                                                                                                         |
+| ------------ | ------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`status`** | <code><a href="#readerconnectionstatus">ReaderConnectionStatus</a></code> |                                                                                                                                                                                                     |
+| **`reason`** | <code><a href="#readerconnectionreason">ReaderConnectionReason</a></code> |                                                                                                                                                                                                     |
+| **`detail`** | <code>string</code>                                                       | Driver text: the port list, the command code, the OS error. This is the one field allowed to talk about the wiring, because nothing branches on it — it is shown as-is for support, not translated. |
+
+
+#### ReaderPort
+
+One reader the driver could talk to.
+
+`path` is the identity — `COM3` on Windows, `/dev/cu.usbserial-110`
+elsewhere. Two identical CH340 adapters carry no serial number of their own,
+so the path is all that separates them.
+
+The caller treats it as **opaque**: it compares, stores and hands it back,
+and never reads meaning out of it. A driver for a device that is not a
+serial port puts its own identity here.
+
+| Prop            | Type                | Description                                                              |
+| --------------- | ------------------- | ------------------------------------------------------------------------ |
+| **`path`**      | <code>string</code> |                                                                          |
+| **`label`**     | <code>string</code> | What the OS calls the device. For the operator to read, not to match on. |
+| **`vendorId`**  | <code>string</code> |                                                                          |
+| **`productId`** | <code>string</code> |                                                                          |
+
+
+#### PluginListenerHandle
+
+| Prop         | Type                                      |
+| ------------ | ----------------------------------------- |
+| **`remove`** | <code>() =&gt; Promise&lt;void&gt;</code> |
+
+
+### Type Aliases
+
+
+#### ReaderConnectionStatus
+
+The four states an operator can act on.
+
+`isConnected()` is too coarse for this: a reader that is plugged in but
+silent answers `false` the same way a missing one does, and the operator
+needs a different move in each case. `isConnected()` stays as it is.
+
+<code>'connecting' | 'connected' | 'not-found' | 'not-responding'</code>
+
+
+#### ReaderConnectionReason
+
+Why the reader is unusable. The status alone does not say what to do next:
+a busy reader needs another program closed, a missing one needs the
+connection checked. The UI picks its message from the reason when there is
+one.
+
+These name what happened to the *reader*, never how it is wired. A driver
+for a device with no serial port has to be able to answer in this
+vocabulary too, and the operator has to be told the truth either way —
+so nothing here says "COM port" or "USB". The device-specific sentence
+belongs in `detail`.
+
+<code>'busy' | 'not-detected' | 'disconnected' | 'no-answer' | 'not-chosen'</code>
+
 </docgen-api>

package/dist/docs.json

@@ -17,6 +17,46 @@
         ],
         "slug": "getcapabilities"
       },
+      {
+        "name": "getConnectionState",
+        "signature": "() => Promise<ReaderConnectionState>",
+        "parameters": [],
+        "returns": "Promise<ReaderConnectionState>",
+        "tags": [],
+        "docs": "Connection state for the first render. The stream of later changes comes\nfrom the `onConnectionState` listener — \"not responding\" is only found out\nafter a timeout, so it cannot be a return value.\n\nA reader is an exclusive resource, so its state is only knowable while it\nis held: an implementation that is not connected may start an attempt here\nand answer `connecting`, with the outcome arriving on the listener.\n\nImplementations that predate this method reject. The caller then hides the\nindicator instead of guessing.",
+        "complexTypes": [
+          "ReaderConnectionState"
+        ],
+        "slug": "getconnectionstate"
+      },
+      {
+        "name": "listReaderPorts",
+        "signature": "() => Promise<{ ports: ReaderPort[]; }>",
+        "parameters": [],
+        "returns": "Promise<{ ports: ReaderPort[]; }>",
+        "tags": [],
+        "docs": "The readers plugged in right now, newest listing every call — a port that\nwas there a minute ago may be gone.\n\nOnly readers, not every serial port: what the caller does with this list\nis offer it as a choice, and a Bluetooth port is not a choice.\n\nImplementations that predate this method reject. The caller then keeps\nwhatever the driver picks on its own.",
+        "complexTypes": [
+          "ReaderPort"
+        ],
+        "slug": "listreaderports"
+      },
+      {
+        "name": "selectReaderPort",
+        "signature": "(options: { path: string; }) => Promise<void>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "",
+            "type": "{ path: string; }"
+          }
+        ],
+        "returns": "Promise<void>",
+        "tags": [],
+        "docs": "Use this reader from now on. Reconnects when another port is open.\n\nThe choice itself is not stored here: the driver is restarted with the\napp, and where a choice belongs is the caller's question. The caller\nremembers the path and says it again on the next start.\n\nRejects when the path is not in the current `listReaderPorts()` — a\nremembered reader that was unplugged has to be chosen again, not opened\nblindly.",
+        "complexTypes": [],
+        "slug": "selectreaderport"
+      },
       {
         "name": "isConnected",
         "signature": "() => Promise<{ connected: boolean; }>",
@@ -222,6 +262,53 @@
         "docs": "",
         "complexTypes": [],
         "slug": "stopsearch"
+      },
+      {
+        "name": "addListener",
+        "signature": "(eventName: 'onConnectionState', listener: (state: ReaderConnectionState) => void) => Promise<PluginListenerHandle>",
+        "parameters": [
+          {
+            "name": "eventName",
+            "docs": "",
+            "type": "'onConnectionState'"
+          },
+          {
+            "name": "listener",
+            "docs": "",
+            "type": "(state: ReaderConnectionState) => void"
+          }
+        ],
+        "returns": "Promise<PluginListenerHandle>",
+        "tags": [],
+        "docs": "Every connection state change. Fires only on a change, not on a poll.",
+        "complexTypes": [
+          "PluginListenerHandle",
+          "ReaderConnectionState"
+        ],
+        "slug": "addlisteneronconnectionstate-"
+      },
+      {
+        "name": "addListener",
+        "signature": "(eventName: string, listenerFunc: (...args: any[]) => any) => Promise<PluginListenerHandle>",
+        "parameters": [
+          {
+            "name": "eventName",
+            "docs": "",
+            "type": "string"
+          },
+          {
+            "name": "listenerFunc",
+            "docs": "",
+            "type": "(...args: any[]) => any"
+          }
+        ],
+        "returns": "Promise<PluginListenerHandle>",
+        "tags": [],
+        "docs": "",
+        "complexTypes": [
+          "PluginListenerHandle"
+        ],
+        "slug": "addlistenerstring-"
       }
     ],
     "properties": []
@@ -263,9 +350,147 @@
           "type": "{ min: number; max: number; default: number; }"
         }
       ]
+    },
+    {
+      "name": "ReaderConnectionState",
+      "slug": "readerconnectionstate",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "status",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [
+            "ReaderConnectionStatus"
+          ],
+          "type": "ReaderConnectionStatus"
+        },
+        {
+          "name": "reason",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [
+            "ReaderConnectionReason"
+          ],
+          "type": "ReaderConnectionReason"
+        },
+        {
+          "name": "detail",
+          "tags": [],
+          "docs": "Driver text: the port list, the command code, the OS error. This is the\none field allowed to talk about the wiring, because nothing branches on\nit — it is shown as-is for support, not translated.",
+          "complexTypes": [],
+          "type": "string | undefined"
+        }
+      ]
+    },
+    {
+      "name": "ReaderPort",
+      "slug": "readerport",
+      "docs": "One reader the driver could talk to.\n\n`path` is the identity — `COM3` on Windows, `/dev/cu.usbserial-110`\nelsewhere. Two identical CH340 adapters carry no serial number of their own,\nso the path is all that separates them.\n\nThe caller treats it as **opaque**: it compares, stores and hands it back,\nand never reads meaning out of it. A driver for a device that is not a\nserial port puts its own identity here.",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "path",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "label",
+          "tags": [],
+          "docs": "What the OS calls the device. For the operator to read, not to match on.",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "vendorId",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "productId",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        }
+      ]
+    },
+    {
+      "name": "PluginListenerHandle",
+      "slug": "pluginlistenerhandle",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "remove",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "() => Promise<void>"
+        }
+      ]
     }
   ],
   "enums": [],
-  "typeAliases": [],
+  "typeAliases": [
+    {
+      "name": "ReaderConnectionStatus",
+      "slug": "readerconnectionstatus",
+      "docs": "The four states an operator can act on.\n\n`isConnected()` is too coarse for this: a reader that is plugged in but\nsilent answers `false` the same way a missing one does, and the operator\nneeds a different move in each case. `isConnected()` stays as it is.",
+      "types": [
+        {
+          "text": "'connecting'",
+          "complexTypes": []
+        },
+        {
+          "text": "'connected'",
+          "complexTypes": []
+        },
+        {
+          "text": "'not-found'",
+          "complexTypes": []
+        },
+        {
+          "text": "'not-responding'",
+          "complexTypes": []
+        }
+      ]
+    },
+    {
+      "name": "ReaderConnectionReason",
+      "slug": "readerconnectionreason",
+      "docs": "Why the reader is unusable. The status alone does not say what to do next:\na busy reader needs another program closed, a missing one needs the\nconnection checked. The UI picks its message from the reason when there is\none.\n\nThese name what happened to the *reader*, never how it is wired. A driver\nfor a device with no serial port has to be able to answer in this\nvocabulary too, and the operator has to be told the truth either way —\nso nothing here says \"COM port\" or \"USB\". The device-specific sentence\nbelongs in `detail`.",
+      "types": [
+        {
+          "text": "'busy'",
+          "complexTypes": []
+        },
+        {
+          "text": "'not-detected'",
+          "complexTypes": []
+        },
+        {
+          "text": "'disconnected'",
+          "complexTypes": []
+        },
+        {
+          "text": "'no-answer'",
+          "complexTypes": []
+        },
+        {
+          "text": "'not-chosen'",
+          "complexTypes": []
+        }
+      ]
+    }
+  ],
   "pluginConfigs": []
 }

package/dist/esm/definitions.d.ts

@@ -1,4 +1,4 @@
-import type { Plugin } from '@capacitor/core';
+import type { Plugin, PluginListenerHandle } from '@capacitor/core';
 /**
  * What the connected Reader can do. Mode gating comes from here, not from the
  * reader type — a desktop reader that can write must not be gated like one
@@ -18,6 +18,77 @@ export interface ReaderCapabilities {
         default: number;
     };
 }
+/**
+ * The four states an operator can act on.
+ *
+ * `isConnected()` is too coarse for this: a reader that is plugged in but
+ * silent answers `false` the same way a missing one does, and the operator
+ * needs a different move in each case. `isConnected()` stays as it is.
+ */
+export declare type ReaderConnectionStatus = 
+/** An attempt is running. */
+'connecting'
+/** The reader is open and answering. */
+ | 'connected'
+/** No reader to talk to — nothing found, or found but not openable. */
+ | 'not-found'
+/** The port opened but the reader did not answer a command. */
+ | 'not-responding';
+/**
+ * Why the reader is unusable. The status alone does not say what to do next:
+ * a busy reader needs another program closed, a missing one needs the
+ * connection checked. The UI picks its message from the reason when there is
+ * one.
+ *
+ * These name what happened to the *reader*, never how it is wired. A driver
+ * for a device with no serial port has to be able to answer in this
+ * vocabulary too, and the operator has to be told the truth either way —
+ * so nothing here says "COM port" or "USB". The device-specific sentence
+ * belongs in `detail`.
+ */
+export declare type ReaderConnectionReason = 
+/** Another program holds the reader. Only one may have it at a time. */
+'busy'
+/** No reader in sight — nothing connected, or nothing that is a reader. */
+ | 'not-detected'
+/** The reader was there and then went away. */
+ | 'disconnected'
+/** The reader is reachable but did not answer. */
+ | 'no-answer'
+/**
+ * Several readers are connected and none was picked. Guessing here would
+ * attach tags read by the wrong device, so nothing is opened until
+ * `selectReaderPort` says which one.
+ */
+ | 'not-chosen';
+export interface ReaderConnectionState {
+    status: ReaderConnectionStatus;
+    reason?: ReaderConnectionReason;
+    /**
+     * Driver text: the port list, the command code, the OS error. This is the
+     * one field allowed to talk about the wiring, because nothing branches on
+     * it — it is shown as-is for support, not translated.
+     */
+    detail?: string;
+}
+/**
+ * One reader the driver could talk to.
+ *
+ * `path` is the identity — `COM3` on Windows, `/dev/cu.usbserial-110`
+ * elsewhere. Two identical CH340 adapters carry no serial number of their own,
+ * so the path is all that separates them.
+ *
+ * The caller treats it as **opaque**: it compares, stores and hands it back,
+ * and never reads meaning out of it. A driver for a device that is not a
+ * serial port puts its own identity here.
+ */
+export interface ReaderPort {
+    path: string;
+    /** What the OS calls the device. For the operator to read, not to match on. */
+    label?: string;
+    vendorId?: string;
+    productId?: string;
+}
 export interface RFIDPlugin extends Plugin {
     /**
      * Capabilities of the connected Reader.
@@ -26,6 +97,46 @@ export interface RFIDPlugin extends Plugin {
      * failure: the caller treats a rejection as a handheld Mobile Reader.
      */
     getCapabilities(): Promise<ReaderCapabilities>;
+    /**
+     * Connection state for the first render. The stream of later changes comes
+     * from the `onConnectionState` listener — "not responding" is only found out
+     * after a timeout, so it cannot be a return value.
+     *
+     * A reader is an exclusive resource, so its state is only knowable while it
+     * is held: an implementation that is not connected may start an attempt here
+     * and answer `connecting`, with the outcome arriving on the listener.
+     *
+     * Implementations that predate this method reject. The caller then hides the
+     * indicator instead of guessing.
+     */
+    getConnectionState(): Promise<ReaderConnectionState>;
+    /**
+     * The readers plugged in right now, newest listing every call — a port that
+     * was there a minute ago may be gone.
+     *
+     * Only readers, not every serial port: what the caller does with this list
+     * is offer it as a choice, and a Bluetooth port is not a choice.
+     *
+     * Implementations that predate this method reject. The caller then keeps
+     * whatever the driver picks on its own.
+     */
+    listReaderPorts(): Promise<{
+        ports: ReaderPort[];
+    }>;
+    /**
+     * Use this reader from now on. Reconnects when another port is open.
+     *
+     * The choice itself is not stored here: the driver is restarted with the
+     * app, and where a choice belongs is the caller's question. The caller
+     * remembers the path and says it again on the next start.
+     *
+     * Rejects when the path is not in the current `listReaderPorts()` — a
+     * remembered reader that was unplugged has to be chosen again, not opened
+     * blindly.
+     */
+    selectReaderPort(options: {
+        path: string;
+    }): Promise<void>;
     isConnected(): Promise<{
         connected: boolean;
     }>;
@@ -80,4 +191,7 @@ export interface RFIDPlugin extends Plugin {
         playSound: boolean;
     }): Promise<void>;
     stopSearch(): Promise<void>;
+    /** Every connection state change. Fires only on a change, not on a poll. */
+    addListener(eventName: 'onConnectionState', listener: (state: ReaderConnectionState) => void): Promise<PluginListenerHandle>;
+    addListener(eventName: string, listenerFunc: (...args: any[]) => any): Promise<PluginListenerHandle>;
 }

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { Plugin } from '@capacitor/core';\n\n/**\n * What the connected Reader can do. Mode gating comes from here, not from the\n * reader type — a desktop reader that can write must not be gated like one\n * that cannot.\n */\nexport interface ReaderCapabilities {\n  /** Reader can write an EPC to a tag (Generate & Set mode depends on it). */\n  canWrite: boolean;\n  /** Reader reports RSSI (Find mode depends on it). */\n  hasRssi: boolean;\n  /** Reader is a handheld terminal rather than a desk device. */\n  isHandheld: boolean;\n  /** Output power range in dBm. The power slider renders this range. */\n  power: {\n    min: number;\n    max: number;\n    default: number;\n  };\n}\n\nexport interface RFIDPlugin extends Plugin {\n  /**\n   * Capabilities of the connected Reader.\n   *\n   * Implementations that predate this method reject. That is a signal, not a\n   * failure: the caller treats a rejection as a handheld Mobile Reader.\n   */\n  getCapabilities(): Promise<ReaderCapabilities>;\n\n  isConnected(): Promise<{ connected: boolean }>;\n\n  startScan(): Promise<void>;\n  stopScan(): Promise<void>;\n  clearData(): Promise<void>;\n\n  getScanData(): Promise<any>;\n  getOutputPower(): Promise<{ value: number }>;\n  setOutputPower(options: { power: number }): Promise<{ value: number }>;\n\n  getRange(): Promise<{ value: number }>;\n  setRange(options: { range: number }): Promise<{ value: number }>;\n\n  getQueryMode(): Promise<{ value: 0 | 1 | 2 | 3 }>;\n  setQueryMode(options: {\n    queryMode:\n      | 0 // epc\n      | 1 // epc+tid\n      | 2 // epc+user\n      | 3; // fasttid\n  }): Promise<{ value: number }>;\n\n  getReaderType(): Promise<{ value: number }>; // 80 - short, others - long distance mode\n  getFirmwareVersion(): Promise<{ value: string }>;\n\n  writeEpc(options: {\n    epc: string;\n    password?: string;\n  }): Promise<{ value: number }>;\n  writeEpcString(options: {\n    epc: string;\n    password?: string;\n  }): Promise<{ value: number }>;\n\n  startSearch(options: { searchableTags: string[], playSound: boolean }): Promise<void>;\n  stopSearch(): Promise<void>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { Plugin, PluginListenerHandle } from '@capacitor/core';\n\n/**\n * What the connected Reader can do. Mode gating comes from here, not from the\n * reader type — a desktop reader that can write must not be gated like one\n * that cannot.\n */\nexport interface ReaderCapabilities {\n  /** Reader can write an EPC to a tag (Generate & Set mode depends on it). */\n  canWrite: boolean;\n  /** Reader reports RSSI (Find mode depends on it). */\n  hasRssi: boolean;\n  /** Reader is a handheld terminal rather than a desk device. */\n  isHandheld: boolean;\n  /** Output power range in dBm. The power slider renders this range. */\n  power: {\n    min: number;\n    max: number;\n    default: number;\n  };\n}\n\n/**\n * The four states an operator can act on.\n *\n * `isConnected()` is too coarse for this: a reader that is plugged in but\n * silent answers `false` the same way a missing one does, and the operator\n * needs a different move in each case. `isConnected()` stays as it is.\n */\nexport type ReaderConnectionStatus =\n  /** An attempt is running. */\n  | 'connecting'\n  /** The reader is open and answering. */\n  | 'connected'\n  /** No reader to talk to — nothing found, or found but not openable. */\n  | 'not-found'\n  /** The port opened but the reader did not answer a command. */\n  | 'not-responding';\n\n/**\n * Why the reader is unusable. The status alone does not say what to do next:\n * a busy reader needs another program closed, a missing one needs the\n * connection checked. The UI picks its message from the reason when there is\n * one.\n *\n * These name what happened to the *reader*, never how it is wired. A driver\n * for a device with no serial port has to be able to answer in this\n * vocabulary too, and the operator has to be told the truth either way —\n * so nothing here says \"COM port\" or \"USB\". The device-specific sentence\n * belongs in `detail`.\n */\nexport type ReaderConnectionReason =\n  /** Another program holds the reader. Only one may have it at a time. */\n  | 'busy'\n  /** No reader in sight — nothing connected, or nothing that is a reader. */\n  | 'not-detected'\n  /** The reader was there and then went away. */\n  | 'disconnected'\n  /** The reader is reachable but did not answer. */\n  | 'no-answer'\n  /**\n   * Several readers are connected and none was picked. Guessing here would\n   * attach tags read by the wrong device, so nothing is opened until\n   * `selectReaderPort` says which one.\n   */\n  | 'not-chosen';\n\nexport interface ReaderConnectionState {\n  status: ReaderConnectionStatus;\n  reason?: ReaderConnectionReason;\n  /**\n   * Driver text: the port list, the command code, the OS error. This is the\n   * one field allowed to talk about the wiring, because nothing branches on\n   * it — it is shown as-is for support, not translated.\n   */\n  detail?: string;\n}\n\n/**\n * One reader the driver could talk to.\n *\n * `path` is the identity — `COM3` on Windows, `/dev/cu.usbserial-110`\n * elsewhere. Two identical CH340 adapters carry no serial number of their own,\n * so the path is all that separates them.\n *\n * The caller treats it as **opaque**: it compares, stores and hands it back,\n * and never reads meaning out of it. A driver for a device that is not a\n * serial port puts its own identity here.\n */\nexport interface ReaderPort {\n  path: string;\n  /** What the OS calls the device. For the operator to read, not to match on. */\n  label?: string;\n  vendorId?: string;\n  productId?: string;\n}\n\nexport interface RFIDPlugin extends Plugin {\n  /**\n   * Capabilities of the connected Reader.\n   *\n   * Implementations that predate this method reject. That is a signal, not a\n   * failure: the caller treats a rejection as a handheld Mobile Reader.\n   */\n  getCapabilities(): Promise<ReaderCapabilities>;\n\n  /**\n   * Connection state for the first render. The stream of later changes comes\n   * from the `onConnectionState` listener — \"not responding\" is only found out\n   * after a timeout, so it cannot be a return value.\n   *\n   * A reader is an exclusive resource, so its state is only knowable while it\n   * is held: an implementation that is not connected may start an attempt here\n   * and answer `connecting`, with the outcome arriving on the listener.\n   *\n   * Implementations that predate this method reject. The caller then hides the\n   * indicator instead of guessing.\n   */\n  getConnectionState(): Promise<ReaderConnectionState>;\n\n  /**\n   * The readers plugged in right now, newest listing every call — a port that\n   * was there a minute ago may be gone.\n   *\n   * Only readers, not every serial port: what the caller does with this list\n   * is offer it as a choice, and a Bluetooth port is not a choice.\n   *\n   * Implementations that predate this method reject. The caller then keeps\n   * whatever the driver picks on its own.\n   */\n  listReaderPorts(): Promise<{ ports: ReaderPort[] }>;\n\n  /**\n   * Use this reader from now on. Reconnects when another port is open.\n   *\n   * The choice itself is not stored here: the driver is restarted with the\n   * app, and where a choice belongs is the caller's question. The caller\n   * remembers the path and says it again on the next start.\n   *\n   * Rejects when the path is not in the current `listReaderPorts()` — a\n   * remembered reader that was unplugged has to be chosen again, not opened\n   * blindly.\n   */\n  selectReaderPort(options: { path: string }): Promise<void>;\n\n  isConnected(): Promise<{ connected: boolean }>;\n\n  startScan(): Promise<void>;\n  stopScan(): Promise<void>;\n  clearData(): Promise<void>;\n\n  getScanData(): Promise<any>;\n  getOutputPower(): Promise<{ value: number }>;\n  setOutputPower(options: { power: number }): Promise<{ value: number }>;\n\n  getRange(): Promise<{ value: number }>;\n  setRange(options: { range: number }): Promise<{ value: number }>;\n\n  getQueryMode(): Promise<{ value: 0 | 1 | 2 | 3 }>;\n  setQueryMode(options: {\n    queryMode:\n      | 0 // epc\n      | 1 // epc+tid\n      | 2 // epc+user\n      | 3; // fasttid\n  }): Promise<{ value: number }>;\n\n  getReaderType(): Promise<{ value: number }>; // 80 - short, others - long distance mode\n  getFirmwareVersion(): Promise<{ value: string }>;\n\n  writeEpc(options: {\n    epc: string;\n    password?: string;\n  }): Promise<{ value: number }>;\n  writeEpcString(options: {\n    epc: string;\n    password?: string;\n  }): Promise<{ value: number }>;\n\n  startSearch(options: { searchableTags: string[], playSound: boolean }): Promise<void>;\n  stopSearch(): Promise<void>;\n\n  /** Every connection state change. Fires only on a change, not on a poll. */\n  addListener(\n    eventName: 'onConnectionState',\n    listener: (state: ReaderConnectionState) => void,\n  ): Promise<PluginListenerHandle>;\n\n  addListener(\n    eventName: string,\n    listenerFunc: (...args: any[]) => any,\n  ): Promise<PluginListenerHandle>;\n}\n"]}

package/dist/esm/electron-bridge.d.ts

@@ -0,0 +1,30 @@
+import type { RFIDPlugin } from './definitions';
+/**
+ * The bridge built by the `@capacitor-community/electron` preload
+ * (`electron-rt.ts`). Its `addListener` returns an id **string** and is
+ * synchronous — `removeListener` takes that same id.
+ */
+export interface ElectronBridge {
+    addListener(eventName: string, callback: (...args: any[]) => void): string;
+    removeListener(id: string): void;
+}
+/**
+ * On native platforms Capacitor wraps the `addListener` result into a
+ * `PluginListenerHandle` itself (`addListenerNative`), but only when
+ * `PluginHeaders` are present. Electron has none, so the bridge's raw id
+ * string reaches the UI as-is and `handle.remove()` is missing: the listener
+ * is never removed, and scanning does not start the second time the modal
+ * opens.
+ *
+ * Do not wrap it with a `Proxy`. Methods of an object exposed through
+ * `contextBridge` arrive as `writable: false, configurable: false`, and for
+ * such a property a `get` trap must return **that exact value** — even a
+ * bound copy is rejected. Otherwise the engine throws the error we saw on
+ * the device:
+ *   TypeError: 'get' on proxy: property 'startScan' is a read-only and
+ *   non-configurable data property on the proxy target but the proxy did
+ *   not return its actual value
+ * So the bridge is used as the prototype instead: the other methods are
+ * found on it as usual, and only `addListener` is defined on top.
+ */
+export declare function withListenerHandles(bridge: ElectronBridge): RFIDPlugin;

package/dist/esm/electron-bridge.js

@@ -0,0 +1,55 @@
+const SCAN_EVENT = 'onScanEvent';
+/**
+ * The Electron main process sends the tags it read in one message per 250 ms
+ * window instead of one per frame — a single tag is read about 44 times a
+ * second. The contract does not change: the array is unrolled here, so a
+ * listener still gets one tag per call.
+ */
+const SCAN_BATCH_EVENT = 'onScanEventBatch';
+/**
+ * On native platforms Capacitor wraps the `addListener` result into a
+ * `PluginListenerHandle` itself (`addListenerNative`), but only when
+ * `PluginHeaders` are present. Electron has none, so the bridge's raw id
+ * string reaches the UI as-is and `handle.remove()` is missing: the listener
+ * is never removed, and scanning does not start the second time the modal
+ * opens.
+ *
+ * Do not wrap it with a `Proxy`. Methods of an object exposed through
+ * `contextBridge` arrive as `writable: false, configurable: false`, and for
+ * such a property a `get` trap must return **that exact value** — even a
+ * bound copy is rejected. Otherwise the engine throws the error we saw on
+ * the device:
+ *   TypeError: 'get' on proxy: property 'startScan' is a read-only and
+ *   non-configurable data property on the proxy target but the proxy did
+ *   not return its actual value
+ * So the bridge is used as the prototype instead: the other methods are
+ * found on it as usual, and only `addListener` is defined on top.
+ */
+export function withListenerHandles(bridge) {
+    const plugin = Object.create(bridge);
+    // A plain `plugin.addListener = ...` does not work: the prototype property
+    // is `writable: false`, so [[Set]] blocks it.
+    Object.defineProperty(plugin, 'addListener', {
+        value: async (eventName, callback) => {
+            const ids = [bridge.addListener(eventName, callback)];
+            if (eventName === SCAN_EVENT) {
+                // A desktop app older than the batch sends one message per tag on
+                // `onScanEvent`, a newer one sends only batches. Both are listened
+                // for, because the bundle in the browser and the installed desktop
+                // app are updated separately; only one of them ever fires.
+                ids.push(bridge.addListener(SCAN_BATCH_EVENT, (batch) => {
+                    for (const event of batch)
+                        callback(event);
+                }));
+            }
+            return {
+                remove: async () => {
+                    for (const id of ids)
+                        bridge.removeListener(id);
+                },
+            };
+        },
+    });
+    return plugin;
+}
+//# sourceMappingURL=electron-bridge.js.map

package/dist/esm/electron-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"electron-bridge.js","sourceRoot":"","sources":["../../src/electron-bridge.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,GAAG,aAAa,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAsB;IACxD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAe,CAAC;IAEnD,2EAA2E;IAC3E,8CAA8C;IAC9C,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE;QAC3C,KAAK,EAAE,KAAK,EACV,SAAiB,EACjB,QAAkC,EACH,EAAE;YACjC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;YAEtD,IAAI,SAAS,KAAK,UAAU,EAAE;gBAC5B,kEAAkE;gBAClE,mEAAmE;gBACnE,mEAAmE;gBACnE,2DAA2D;gBAC3D,GAAG,CAAC,IAAI,CACN,MAAM,CAAC,WAAW,CAAC,gBAAgB,EAAE,CAAC,KAAgB,EAAE,EAAE;oBACxD,KAAK,MAAM,KAAK,IAAI,KAAK;wBAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAC7C,CAAC,CAAC,CACH,CAAC;aACH;YAED,OAAO;gBACL,MAAM,EAAE,KAAK,IAAI,EAAE;oBACjB,KAAK,MAAM,EAAE,IAAI,GAAG;wBAAE,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;gBAClD,CAAC;aACF,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\nimport type { RFIDPlugin } from './definitions';\n\n/**\n * The bridge built by the `@capacitor-community/electron` preload\n * (`electron-rt.ts`). Its `addListener` returns an id **string** and is\n * synchronous — `removeListener` takes that same id.\n */\nexport interface ElectronBridge {\n  addListener(eventName: string, callback: (...args: any[]) => void): string;\n  removeListener(id: string): void;\n}\n\nconst SCAN_EVENT = 'onScanEvent';\n\n/**\n * The Electron main process sends the tags it read in one message per 250 ms\n * window instead of one per frame — a single tag is read about 44 times a\n * second. The contract does not change: the array is unrolled here, so a\n * listener still gets one tag per call.\n */\nconst SCAN_BATCH_EVENT = 'onScanEventBatch';\n\n/**\n * On native platforms Capacitor wraps the `addListener` result into a\n * `PluginListenerHandle` itself (`addListenerNative`), but only when\n * `PluginHeaders` are present. Electron has none, so the bridge's raw id\n * string reaches the UI as-is and `handle.remove()` is missing: the listener\n * is never removed, and scanning does not start the second time the modal\n * opens.\n *\n * Do not wrap it with a `Proxy`. Methods of an object exposed through\n * `contextBridge` arrive as `writable: false, configurable: false`, and for\n * such a property a `get` trap must return **that exact value** — even a\n * bound copy is rejected. Otherwise the engine throws the error we saw on\n * the device:\n *   TypeError: 'get' on proxy: property 'startScan' is a read-only and\n *   non-configurable data property on the proxy target but the proxy did\n *   not return its actual value\n * So the bridge is used as the prototype instead: the other methods are\n * found on it as usual, and only `addListener` is defined on top.\n */\nexport function withListenerHandles(bridge: ElectronBridge): RFIDPlugin {\n  const plugin = Object.create(bridge) as RFIDPlugin;\n\n  // A plain `plugin.addListener = ...` does not work: the prototype property\n  // is `writable: false`, so [[Set]] blocks it.\n  Object.defineProperty(plugin, 'addListener', {\n    value: async (\n      eventName: string,\n      callback: (...args: any[]) => void,\n    ): Promise<PluginListenerHandle> => {\n      const ids = [bridge.addListener(eventName, callback)];\n\n      if (eventName === SCAN_EVENT) {\n        // A desktop app older than the batch sends one message per tag on\n        // `onScanEvent`, a newer one sends only batches. Both are listened\n        // for, because the bundle in the browser and the installed desktop\n        // app are updated separately; only one of them ever fires.\n        ids.push(\n          bridge.addListener(SCAN_BATCH_EVENT, (batch: unknown[]) => {\n            for (const event of batch) callback(event);\n          }),\n        );\n      }\n\n      return {\n        remove: async () => {\n          for (const id of ids) bridge.removeListener(id);\n        },\n      };\n    },\n  });\n\n  return plugin;\n}\n"]}

package/dist/esm/index.js

@@ -1,13 +1,14 @@
 import { registerPlugin } from '@capacitor/core';
+import { withListenerHandles } from './electron-bridge';
 const RFID = registerPlugin('RFID', {
     web: () => import('./web').then(m => new m.RFIDWeb()),
     electron: () => {
         var _a, _b;
-        const plugin = (_b = (_a = window.CapacitorCustomPlatform) === null || _a === void 0 ? void 0 : _a.plugins) === null || _b === void 0 ? void 0 : _b.RFID;
-        if (!plugin) {
+        const bridge = (_b = (_a = window.CapacitorCustomPlatform) === null || _a === void 0 ? void 0 : _a.plugins) === null || _b === void 0 ? void 0 : _b.RFID;
+        if (!bridge) {
             throw new Error('RFID is not registered in the Electron runtime. Register the driver in electron-plugins.js.');
         }
-        return plugin;
+        return withListenerHandles(bridge);
     },
 });
 export * from './definitions';

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;AAQjD,MAAM,IAAI,GAAG,cAAc,CAAa,MAAM,EAAE;IAC9C,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IACrD,QAAQ,EAAE,GAAG,EAAE;;QACb,MAAM,MAAM,eAAI,MAAyB,CAAC,uBAAuB,0CAAE,OAAO,0CACtE,IAAI,CAAC;QAET,IAAI,CAAC,MAAM,EAAE;YACX,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAC;SACH;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC,CAAC;AAEH,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAE,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\n\nimport type { RFIDPlugin } from './definitions';\n\ntype ElectronWindow = Window & {\n  CapacitorCustomPlatform?: { plugins?: { RFID?: RFIDPlugin } };\n};\n\nconst RFID = registerPlugin<RFIDPlugin>('RFID', {\n  web: () => import('./web').then(m => new m.RFIDWeb()),\n  electron: () => {\n    const plugin = (window as ElectronWindow).CapacitorCustomPlatform?.plugins\n      ?.RFID;\n\n    if (!plugin) {\n      throw new Error(\n        'RFID is not registered in the Electron runtime. Register the driver in electron-plugins.js.',\n      );\n    }\n\n    return plugin;\n  },\n});\n\nexport * from './definitions';\nexport { RFID };\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAMxD,MAAM,IAAI,GAAG,cAAc,CAAa,MAAM,EAAE;IAC9C,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IACrD,QAAQ,EAAE,GAAG,EAAE;;QACb,MAAM,MAAM,eAAI,MAAyB,CAAC,uBAAuB,0CAAE,OAAO,0CACtE,IAAI,CAAC;QAET,IAAI,CAAC,MAAM,EAAE;YACX,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAC;SACH;QAED,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;CACF,CAAC,CAAC;AAEH,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAE,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\n\nimport type { RFIDPlugin } from './definitions';\nimport type { ElectronBridge } from './electron-bridge';\nimport { withListenerHandles } from './electron-bridge';\n\ntype ElectronWindow = Window & {\n  CapacitorCustomPlatform?: { plugins?: { RFID?: ElectronBridge } };\n};\n\nconst RFID = registerPlugin<RFIDPlugin>('RFID', {\n  web: () => import('./web').then(m => new m.RFIDWeb()),\n  electron: () => {\n    const bridge = (window as ElectronWindow).CapacitorCustomPlatform?.plugins\n      ?.RFID;\n\n    if (!bridge) {\n      throw new Error(\n        'RFID is not registered in the Electron runtime. Register the driver in electron-plugins.js.',\n      );\n    }\n\n    return withListenerHandles(bridge);\n  },\n});\n\nexport * from './definitions';\nexport { RFID };\n"]}

package/dist/esm/web.d.ts

@@ -1,6 +1,6 @@
 import { WebPlugin } from '@capacitor/core';
 import type { PluginListenerHandle } from '@capacitor/core';
-import type { ReaderCapabilities, RFIDPlugin } from './definitions';
+import type { ReaderCapabilities, ReaderConnectionState, ReaderPort, RFIDPlugin } from './definitions';
 export declare class RFIDWeb extends WebPlugin implements RFIDPlugin {
     /**
      * The one method the browser can answer truthfully. Everything else rejects:
@@ -15,6 +15,20 @@ export declare class RFIDWeb extends WebPlugin implements RFIDPlugin {
      */
     addListener(): Promise<PluginListenerHandle>;
     getCapabilities(): Promise<ReaderCapabilities>;
+    /**
+     * Not `not-found`: that state tells the operator to check the cable, and
+     * there is no cable to check in a browser. The rejection carries the one
+     * useful sentence — open the desktop app or the handheld.
+     */
+    getConnectionState(): Promise<ReaderConnectionState>;
+    /**
+     * Not an empty list: "no readers plugged in" would send the operator to look
+     * for a cable, and the browser has no serial ports to look at.
+     */
+    listReaderPorts(): Promise<{
+        ports: ReaderPort[];
+    }>;
+    selectReaderPort(): Promise<void>;
     startScan(): Promise<void>;
     stopScan(): Promise<void>;
     clearData(): Promise<void>;

package/dist/esm/web.js

@@ -18,6 +18,24 @@ export class RFIDWeb extends WebPlugin {
     async getCapabilities() {
         throw this.unimplemented(NO_READER_ON_WEB);
     }
+    /**
+     * Not `not-found`: that state tells the operator to check the cable, and
+     * there is no cable to check in a browser. The rejection carries the one
+     * useful sentence — open the desktop app or the handheld.
+     */
+    async getConnectionState() {
+        throw this.unimplemented(NO_READER_ON_WEB);
+    }
+    /**
+     * Not an empty list: "no readers plugged in" would send the operator to look
+     * for a cable, and the browser has no serial ports to look at.
+     */
+    async listReaderPorts() {
+        throw this.unimplemented(NO_READER_ON_WEB);
+    }
+    async selectReaderPort() {
+        throw this.unimplemented(NO_READER_ON_WEB);
+    }
     async startScan() {
         throw this.unimplemented(NO_READER_ON_WEB);
     }

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;AAK5C,MAAM,gBAAgB,GACpB,0FAA0F,CAAC;AAE7F,MAAM,OAAO,OAAQ,SAAQ,SAAS;IACpC;;;OAGG;IACH,KAAK,CAAC,WAAW;QACf,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW;QACf,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,eAAe;QACnB,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,kBAAkB;QACtB,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\nimport type { PluginListenerHandle } from '@capacitor/core';\n\nimport type { ReaderCapabilities, RFIDPlugin } from './definitions';\n\nconst NO_READER_ON_WEB =\n  'No RFID Reader in the browser. Use the desktop app (ox-desktop) or the Android handheld.';\n\nexport class RFIDWeb extends WebPlugin implements RFIDPlugin {\n  /**\n   * The one method the browser can answer truthfully. Everything else rejects:\n   * a silent `resolve` makes the UI report a success that never happened.\n   */\n  async isConnected(): Promise<{ connected: boolean }> {\n    return { connected: false };\n  }\n\n  /**\n   * Events never fire without a Reader, so registering a listener here would be\n   * the same silent lie as a resolving `startScan()`.\n   */\n  async addListener(): Promise<PluginListenerHandle> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async getCapabilities(): Promise<ReaderCapabilities> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async startScan(): Promise<void> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async stopScan(): Promise<void> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async clearData(): Promise<void> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async getScanData(): Promise<any> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async getOutputPower(): Promise<{ value: number }> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async setOutputPower(): Promise<{ value: number }> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async getRange(): Promise<{ value: number }> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async setRange(): Promise<{ value: number }> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async getQueryMode(): Promise<{ value: 0 | 1 | 2 | 3 }> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async setQueryMode(): Promise<{ value: number }> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async getReaderType(): Promise<{ value: number }> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async getFirmwareVersion(): Promise<{ value: string }> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async writeEpc(): Promise<{ value: number }> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async writeEpcString(): Promise<{ value: number }> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async startSearch(): Promise<void> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async stopSearch(): Promise<void> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n}\n"]}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAU5C,MAAM,gBAAgB,GACpB,0FAA0F,CAAC;AAE7F,MAAM,OAAO,OAAQ,SAAQ,SAAS;IACpC;;;OAGG;IACH,KAAK,CAAC,WAAW;QACf,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW;QACf,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,eAAe;QACnB,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,kBAAkB;QACtB,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe;QACnB,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,kBAAkB;QACtB,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\nimport type { PluginListenerHandle } from '@capacitor/core';\n\nimport type {\n  ReaderCapabilities,\n  ReaderConnectionState,\n  ReaderPort,\n  RFIDPlugin,\n} from './definitions';\n\nconst NO_READER_ON_WEB =\n  'No RFID Reader in the browser. Use the desktop app (ox-desktop) or the Android handheld.';\n\nexport class RFIDWeb extends WebPlugin implements RFIDPlugin {\n  /**\n   * The one method the browser can answer truthfully. Everything else rejects:\n   * a silent `resolve` makes the UI report a success that never happened.\n   */\n  async isConnected(): Promise<{ connected: boolean }> {\n    return { connected: false };\n  }\n\n  /**\n   * Events never fire without a Reader, so registering a listener here would be\n   * the same silent lie as a resolving `startScan()`.\n   */\n  async addListener(): Promise<PluginListenerHandle> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async getCapabilities(): Promise<ReaderCapabilities> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  /**\n   * Not `not-found`: that state tells the operator to check the cable, and\n   * there is no cable to check in a browser. The rejection carries the one\n   * useful sentence — open the desktop app or the handheld.\n   */\n  async getConnectionState(): Promise<ReaderConnectionState> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  /**\n   * Not an empty list: \"no readers plugged in\" would send the operator to look\n   * for a cable, and the browser has no serial ports to look at.\n   */\n  async listReaderPorts(): Promise<{ ports: ReaderPort[] }> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async selectReaderPort(): Promise<void> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async startScan(): Promise<void> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async stopScan(): Promise<void> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async clearData(): Promise<void> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async getScanData(): Promise<any> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async getOutputPower(): Promise<{ value: number }> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async setOutputPower(): Promise<{ value: number }> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async getRange(): Promise<{ value: number }> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async setRange(): Promise<{ value: number }> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async getQueryMode(): Promise<{ value: 0 | 1 | 2 | 3 }> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async setQueryMode(): Promise<{ value: number }> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async getReaderType(): Promise<{ value: number }> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async getFirmwareVersion(): Promise<{ value: string }> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async writeEpc(): Promise<{ value: number }> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async writeEpcString(): Promise<{ value: number }> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async startSearch(): Promise<void> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n\n  async stopSearch(): Promise<void> {\n    throw this.unimplemented(NO_READER_ON_WEB);\n  }\n}\n"]}

package/dist/plugin.cjs.js

@@ -4,15 +4,70 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var core = require('@capacitor/core');
 
+const SCAN_EVENT = 'onScanEvent';
+/**
+ * The Electron main process sends the tags it read in one message per 250 ms
+ * window instead of one per frame — a single tag is read about 44 times a
+ * second. The contract does not change: the array is unrolled here, so a
+ * listener still gets one tag per call.
+ */
+const SCAN_BATCH_EVENT = 'onScanEventBatch';
+/**
+ * On native platforms Capacitor wraps the `addListener` result into a
+ * `PluginListenerHandle` itself (`addListenerNative`), but only when
+ * `PluginHeaders` are present. Electron has none, so the bridge's raw id
+ * string reaches the UI as-is and `handle.remove()` is missing: the listener
+ * is never removed, and scanning does not start the second time the modal
+ * opens.
+ *
+ * Do not wrap it with a `Proxy`. Methods of an object exposed through
+ * `contextBridge` arrive as `writable: false, configurable: false`, and for
+ * such a property a `get` trap must return **that exact value** — even a
+ * bound copy is rejected. Otherwise the engine throws the error we saw on
+ * the device:
+ *   TypeError: 'get' on proxy: property 'startScan' is a read-only and
+ *   non-configurable data property on the proxy target but the proxy did
+ *   not return its actual value
+ * So the bridge is used as the prototype instead: the other methods are
+ * found on it as usual, and only `addListener` is defined on top.
+ */
+function withListenerHandles(bridge) {
+    const plugin = Object.create(bridge);
+    // A plain `plugin.addListener = ...` does not work: the prototype property
+    // is `writable: false`, so [[Set]] blocks it.
+    Object.defineProperty(plugin, 'addListener', {
+        value: async (eventName, callback) => {
+            const ids = [bridge.addListener(eventName, callback)];
+            if (eventName === SCAN_EVENT) {
+                // A desktop app older than the batch sends one message per tag on
+                // `onScanEvent`, a newer one sends only batches. Both are listened
+                // for, because the bundle in the browser and the installed desktop
+                // app are updated separately; only one of them ever fires.
+                ids.push(bridge.addListener(SCAN_BATCH_EVENT, (batch) => {
+                    for (const event of batch)
+                        callback(event);
+                }));
+            }
+            return {
+                remove: async () => {
+                    for (const id of ids)
+                        bridge.removeListener(id);
+                },
+            };
+        },
+    });
+    return plugin;
+}
+
 const RFID = core.registerPlugin('RFID', {
     web: () => Promise.resolve().then(function () { return web; }).then(m => new m.RFIDWeb()),
     electron: () => {
         var _a, _b;
-        const plugin = (_b = (_a = window.CapacitorCustomPlatform) === null || _a === void 0 ? void 0 : _a.plugins) === null || _b === void 0 ? void 0 : _b.RFID;
-        if (!plugin) {
+        const bridge = (_b = (_a = window.CapacitorCustomPlatform) === null || _a === void 0 ? void 0 : _a.plugins) === null || _b === void 0 ? void 0 : _b.RFID;
+        if (!bridge) {
             throw new Error('RFID is not registered in the Electron runtime. Register the driver in electron-plugins.js.');
         }
-        return plugin;
+        return withListenerHandles(bridge);
     },
 });
 
@@ -35,6 +90,24 @@ class RFIDWeb extends core.WebPlugin {
     async getCapabilities() {
         throw this.unimplemented(NO_READER_ON_WEB);
     }
+    /**
+     * Not `not-found`: that state tells the operator to check the cable, and
+     * there is no cable to check in a browser. The rejection carries the one
+     * useful sentence — open the desktop app or the handheld.
+     */
+    async getConnectionState() {
+        throw this.unimplemented(NO_READER_ON_WEB);
+    }
+    /**
+     * Not an empty list: "no readers plugged in" would send the operator to look
+     * for a cable, and the browser has no serial ports to look at.
+     */
+    async listReaderPorts() {
+        throw this.unimplemented(NO_READER_ON_WEB);
+    }
+    async selectReaderPort() {
+        throw this.unimplemented(NO_READER_ON_WEB);
+    }
     async startScan() {
         throw this.unimplemented(NO_READER_ON_WEB);
     }

package/dist/plugin.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst RFID = registerPlugin('RFID', {\n    web: () => import('./web').then(m => new m.RFIDWeb()),\n    electron: () => {\n        var _a, _b;\n        const plugin = (_b = (_a = window.CapacitorCustomPlatform) === null || _a === void 0 ? void 0 : _a.plugins) === null || _b === void 0 ? void 0 : _b.RFID;\n        if (!plugin) {\n            throw new Error('RFID is not registered in the Electron runtime. Register the driver in electron-plugins.js.');\n        }\n        return plugin;\n    },\n});\nexport * from './definitions';\nexport { RFID };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nconst NO_READER_ON_WEB = 'No RFID Reader in the browser. Use the desktop app (ox-desktop) or the Android handheld.';\nexport class RFIDWeb extends WebPlugin {\n    /**\n     * The one method the browser can answer truthfully. Everything else rejects:\n     * a silent `resolve` makes the UI report a success that never happened.\n     */\n    async isConnected() {\n        return { connected: false };\n    }\n    /**\n     * Events never fire without a Reader, so registering a listener here would be\n     * the same silent lie as a resolving `startScan()`.\n     */\n    async addListener() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getCapabilities() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async startScan() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async stopScan() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async clearData() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getScanData() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getOutputPower() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async setOutputPower() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getRange() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async setRange() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getQueryMode() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async setQueryMode() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getReaderType() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getFirmwareVersion() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async writeEpc() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async writeEpcString() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async startSearch() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async stopSearch() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":"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"}
+{"version":3,"file":"plugin.cjs.js","sources":["esm/electron-bridge.js","esm/index.js","esm/web.js"],"sourcesContent":["const SCAN_EVENT = 'onScanEvent';\n/**\n * The Electron main process sends the tags it read in one message per 250 ms\n * window instead of one per frame — a single tag is read about 44 times a\n * second. The contract does not change: the array is unrolled here, so a\n * listener still gets one tag per call.\n */\nconst SCAN_BATCH_EVENT = 'onScanEventBatch';\n/**\n * On native platforms Capacitor wraps the `addListener` result into a\n * `PluginListenerHandle` itself (`addListenerNative`), but only when\n * `PluginHeaders` are present. Electron has none, so the bridge's raw id\n * string reaches the UI as-is and `handle.remove()` is missing: the listener\n * is never removed, and scanning does not start the second time the modal\n * opens.\n *\n * Do not wrap it with a `Proxy`. Methods of an object exposed through\n * `contextBridge` arrive as `writable: false, configurable: false`, and for\n * such a property a `get` trap must return **that exact value** — even a\n * bound copy is rejected. Otherwise the engine throws the error we saw on\n * the device:\n *   TypeError: 'get' on proxy: property 'startScan' is a read-only and\n *   non-configurable data property on the proxy target but the proxy did\n *   not return its actual value\n * So the bridge is used as the prototype instead: the other methods are\n * found on it as usual, and only `addListener` is defined on top.\n */\nexport function withListenerHandles(bridge) {\n    const plugin = Object.create(bridge);\n    // A plain `plugin.addListener = ...` does not work: the prototype property\n    // is `writable: false`, so [[Set]] blocks it.\n    Object.defineProperty(plugin, 'addListener', {\n        value: async (eventName, callback) => {\n            const ids = [bridge.addListener(eventName, callback)];\n            if (eventName === SCAN_EVENT) {\n                // A desktop app older than the batch sends one message per tag on\n                // `onScanEvent`, a newer one sends only batches. Both are listened\n                // for, because the bundle in the browser and the installed desktop\n                // app are updated separately; only one of them ever fires.\n                ids.push(bridge.addListener(SCAN_BATCH_EVENT, (batch) => {\n                    for (const event of batch)\n                        callback(event);\n                }));\n            }\n            return {\n                remove: async () => {\n                    for (const id of ids)\n                        bridge.removeListener(id);\n                },\n            };\n        },\n    });\n    return plugin;\n}\n//# sourceMappingURL=electron-bridge.js.map","import { registerPlugin } from '@capacitor/core';\nimport { withListenerHandles } from './electron-bridge';\nconst RFID = registerPlugin('RFID', {\n    web: () => import('./web').then(m => new m.RFIDWeb()),\n    electron: () => {\n        var _a, _b;\n        const bridge = (_b = (_a = window.CapacitorCustomPlatform) === null || _a === void 0 ? void 0 : _a.plugins) === null || _b === void 0 ? void 0 : _b.RFID;\n        if (!bridge) {\n            throw new Error('RFID is not registered in the Electron runtime. Register the driver in electron-plugins.js.');\n        }\n        return withListenerHandles(bridge);\n    },\n});\nexport * from './definitions';\nexport { RFID };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nconst NO_READER_ON_WEB = 'No RFID Reader in the browser. Use the desktop app (ox-desktop) or the Android handheld.';\nexport class RFIDWeb extends WebPlugin {\n    /**\n     * The one method the browser can answer truthfully. Everything else rejects:\n     * a silent `resolve` makes the UI report a success that never happened.\n     */\n    async isConnected() {\n        return { connected: false };\n    }\n    /**\n     * Events never fire without a Reader, so registering a listener here would be\n     * the same silent lie as a resolving `startScan()`.\n     */\n    async addListener() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getCapabilities() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    /**\n     * Not `not-found`: that state tells the operator to check the cable, and\n     * there is no cable to check in a browser. The rejection carries the one\n     * useful sentence — open the desktop app or the handheld.\n     */\n    async getConnectionState() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    /**\n     * Not an empty list: \"no readers plugged in\" would send the operator to look\n     * for a cable, and the browser has no serial ports to look at.\n     */\n    async listReaderPorts() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async selectReaderPort() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async startScan() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async stopScan() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async clearData() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getScanData() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getOutputPower() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async setOutputPower() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getRange() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async setRange() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getQueryMode() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async setQueryMode() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getReaderType() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getFirmwareVersion() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async writeEpc() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async writeEpcString() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async startSearch() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async stopSearch() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":"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"}

package/dist/plugin.js

@@ -1,15 +1,70 @@
 var capacitorExample = (function (exports, core) {
     'use strict';
 
+    const SCAN_EVENT = 'onScanEvent';
+    /**
+     * The Electron main process sends the tags it read in one message per 250 ms
+     * window instead of one per frame — a single tag is read about 44 times a
+     * second. The contract does not change: the array is unrolled here, so a
+     * listener still gets one tag per call.
+     */
+    const SCAN_BATCH_EVENT = 'onScanEventBatch';
+    /**
+     * On native platforms Capacitor wraps the `addListener` result into a
+     * `PluginListenerHandle` itself (`addListenerNative`), but only when
+     * `PluginHeaders` are present. Electron has none, so the bridge's raw id
+     * string reaches the UI as-is and `handle.remove()` is missing: the listener
+     * is never removed, and scanning does not start the second time the modal
+     * opens.
+     *
+     * Do not wrap it with a `Proxy`. Methods of an object exposed through
+     * `contextBridge` arrive as `writable: false, configurable: false`, and for
+     * such a property a `get` trap must return **that exact value** — even a
+     * bound copy is rejected. Otherwise the engine throws the error we saw on
+     * the device:
+     *   TypeError: 'get' on proxy: property 'startScan' is a read-only and
+     *   non-configurable data property on the proxy target but the proxy did
+     *   not return its actual value
+     * So the bridge is used as the prototype instead: the other methods are
+     * found on it as usual, and only `addListener` is defined on top.
+     */
+    function withListenerHandles(bridge) {
+        const plugin = Object.create(bridge);
+        // A plain `plugin.addListener = ...` does not work: the prototype property
+        // is `writable: false`, so [[Set]] blocks it.
+        Object.defineProperty(plugin, 'addListener', {
+            value: async (eventName, callback) => {
+                const ids = [bridge.addListener(eventName, callback)];
+                if (eventName === SCAN_EVENT) {
+                    // A desktop app older than the batch sends one message per tag on
+                    // `onScanEvent`, a newer one sends only batches. Both are listened
+                    // for, because the bundle in the browser and the installed desktop
+                    // app are updated separately; only one of them ever fires.
+                    ids.push(bridge.addListener(SCAN_BATCH_EVENT, (batch) => {
+                        for (const event of batch)
+                            callback(event);
+                    }));
+                }
+                return {
+                    remove: async () => {
+                        for (const id of ids)
+                            bridge.removeListener(id);
+                    },
+                };
+            },
+        });
+        return plugin;
+    }
+
     const RFID = core.registerPlugin('RFID', {
         web: () => Promise.resolve().then(function () { return web; }).then(m => new m.RFIDWeb()),
         electron: () => {
             var _a, _b;
-            const plugin = (_b = (_a = window.CapacitorCustomPlatform) === null || _a === void 0 ? void 0 : _a.plugins) === null || _b === void 0 ? void 0 : _b.RFID;
-            if (!plugin) {
+            const bridge = (_b = (_a = window.CapacitorCustomPlatform) === null || _a === void 0 ? void 0 : _a.plugins) === null || _b === void 0 ? void 0 : _b.RFID;
+            if (!bridge) {
                 throw new Error('RFID is not registered in the Electron runtime. Register the driver in electron-plugins.js.');
             }
-            return plugin;
+            return withListenerHandles(bridge);
         },
     });
 
@@ -32,6 +87,24 @@ var capacitorExample = (function (exports, core) {
         async getCapabilities() {
             throw this.unimplemented(NO_READER_ON_WEB);
         }
+        /**
+         * Not `not-found`: that state tells the operator to check the cable, and
+         * there is no cable to check in a browser. The rejection carries the one
+         * useful sentence — open the desktop app or the handheld.
+         */
+        async getConnectionState() {
+            throw this.unimplemented(NO_READER_ON_WEB);
+        }
+        /**
+         * Not an empty list: "no readers plugged in" would send the operator to look
+         * for a cable, and the browser has no serial ports to look at.
+         */
+        async listReaderPorts() {
+            throw this.unimplemented(NO_READER_ON_WEB);
+        }
+        async selectReaderPort() {
+            throw this.unimplemented(NO_READER_ON_WEB);
+        }
         async startScan() {
             throw this.unimplemented(NO_READER_ON_WEB);
         }

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst RFID = registerPlugin('RFID', {\n    web: () => import('./web').then(m => new m.RFIDWeb()),\n    electron: () => {\n        var _a, _b;\n        const plugin = (_b = (_a = window.CapacitorCustomPlatform) === null || _a === void 0 ? void 0 : _a.plugins) === null || _b === void 0 ? void 0 : _b.RFID;\n        if (!plugin) {\n            throw new Error('RFID is not registered in the Electron runtime. Register the driver in electron-plugins.js.');\n        }\n        return plugin;\n    },\n});\nexport * from './definitions';\nexport { RFID };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nconst NO_READER_ON_WEB = 'No RFID Reader in the browser. Use the desktop app (ox-desktop) or the Android handheld.';\nexport class RFIDWeb extends WebPlugin {\n    /**\n     * The one method the browser can answer truthfully. Everything else rejects:\n     * a silent `resolve` makes the UI report a success that never happened.\n     */\n    async isConnected() {\n        return { connected: false };\n    }\n    /**\n     * Events never fire without a Reader, so registering a listener here would be\n     * the same silent lie as a resolving `startScan()`.\n     */\n    async addListener() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getCapabilities() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async startScan() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async stopScan() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async clearData() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getScanData() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getOutputPower() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async setOutputPower() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getRange() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async setRange() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getQueryMode() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async setQueryMode() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getReaderType() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getFirmwareVersion() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async writeEpc() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async writeEpcString() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async startSearch() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async stopSearch() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":"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"}
+{"version":3,"file":"plugin.js","sources":["esm/electron-bridge.js","esm/index.js","esm/web.js"],"sourcesContent":["const SCAN_EVENT = 'onScanEvent';\n/**\n * The Electron main process sends the tags it read in one message per 250 ms\n * window instead of one per frame — a single tag is read about 44 times a\n * second. The contract does not change: the array is unrolled here, so a\n * listener still gets one tag per call.\n */\nconst SCAN_BATCH_EVENT = 'onScanEventBatch';\n/**\n * On native platforms Capacitor wraps the `addListener` result into a\n * `PluginListenerHandle` itself (`addListenerNative`), but only when\n * `PluginHeaders` are present. Electron has none, so the bridge's raw id\n * string reaches the UI as-is and `handle.remove()` is missing: the listener\n * is never removed, and scanning does not start the second time the modal\n * opens.\n *\n * Do not wrap it with a `Proxy`. Methods of an object exposed through\n * `contextBridge` arrive as `writable: false, configurable: false`, and for\n * such a property a `get` trap must return **that exact value** — even a\n * bound copy is rejected. Otherwise the engine throws the error we saw on\n * the device:\n *   TypeError: 'get' on proxy: property 'startScan' is a read-only and\n *   non-configurable data property on the proxy target but the proxy did\n *   not return its actual value\n * So the bridge is used as the prototype instead: the other methods are\n * found on it as usual, and only `addListener` is defined on top.\n */\nexport function withListenerHandles(bridge) {\n    const plugin = Object.create(bridge);\n    // A plain `plugin.addListener = ...` does not work: the prototype property\n    // is `writable: false`, so [[Set]] blocks it.\n    Object.defineProperty(plugin, 'addListener', {\n        value: async (eventName, callback) => {\n            const ids = [bridge.addListener(eventName, callback)];\n            if (eventName === SCAN_EVENT) {\n                // A desktop app older than the batch sends one message per tag on\n                // `onScanEvent`, a newer one sends only batches. Both are listened\n                // for, because the bundle in the browser and the installed desktop\n                // app are updated separately; only one of them ever fires.\n                ids.push(bridge.addListener(SCAN_BATCH_EVENT, (batch) => {\n                    for (const event of batch)\n                        callback(event);\n                }));\n            }\n            return {\n                remove: async () => {\n                    for (const id of ids)\n                        bridge.removeListener(id);\n                },\n            };\n        },\n    });\n    return plugin;\n}\n//# sourceMappingURL=electron-bridge.js.map","import { registerPlugin } from '@capacitor/core';\nimport { withListenerHandles } from './electron-bridge';\nconst RFID = registerPlugin('RFID', {\n    web: () => import('./web').then(m => new m.RFIDWeb()),\n    electron: () => {\n        var _a, _b;\n        const bridge = (_b = (_a = window.CapacitorCustomPlatform) === null || _a === void 0 ? void 0 : _a.plugins) === null || _b === void 0 ? void 0 : _b.RFID;\n        if (!bridge) {\n            throw new Error('RFID is not registered in the Electron runtime. Register the driver in electron-plugins.js.');\n        }\n        return withListenerHandles(bridge);\n    },\n});\nexport * from './definitions';\nexport { RFID };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nconst NO_READER_ON_WEB = 'No RFID Reader in the browser. Use the desktop app (ox-desktop) or the Android handheld.';\nexport class RFIDWeb extends WebPlugin {\n    /**\n     * The one method the browser can answer truthfully. Everything else rejects:\n     * a silent `resolve` makes the UI report a success that never happened.\n     */\n    async isConnected() {\n        return { connected: false };\n    }\n    /**\n     * Events never fire without a Reader, so registering a listener here would be\n     * the same silent lie as a resolving `startScan()`.\n     */\n    async addListener() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getCapabilities() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    /**\n     * Not `not-found`: that state tells the operator to check the cable, and\n     * there is no cable to check in a browser. The rejection carries the one\n     * useful sentence — open the desktop app or the handheld.\n     */\n    async getConnectionState() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    /**\n     * Not an empty list: \"no readers plugged in\" would send the operator to look\n     * for a cable, and the browser has no serial ports to look at.\n     */\n    async listReaderPorts() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async selectReaderPort() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async startScan() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async stopScan() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async clearData() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getScanData() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getOutputPower() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async setOutputPower() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getRange() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async setRange() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getQueryMode() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async setQueryMode() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getReaderType() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async getFirmwareVersion() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async writeEpc() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async writeEpcString() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async startSearch() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n    async stopSearch() {\n        throw this.unimplemented(NO_READER_ON_WEB);\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "capacitor-rfid-plugin-ox",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "rfid read-write",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",
@@ -41,7 +41,9 @@
     "build": "npm run clean && npm run docgen && tsc && rollup -c rollup.config.js",
     "clean": "rimraf ./dist",
     "watch": "tsc --watch",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "devDependencies": {
     "@capacitor/android": "^6.0.0",
@@ -57,7 +59,8 @@
     "rimraf": "^3.0.2",
     "rollup": "^2.32.0",
     "swiftlint": "^1.0.1",
-    "typescript": "~4.1.5"
+    "typescript": "~4.1.5",
+    "vitest": "^0.34.6"
   },
   "peerDependencies": {
     "@capacitor/core": "^6.0.0"