@ledgerhq/device-management-kit-devtools-core 1.1.1

package/LICENSE.MD

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2024-present Ledger
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,193 @@
+# Device Management Kit DevTools Core
+
+Core library for DMK developer tools. Contains:
+
+- **`DevToolsLogger`** — Relays DMK logs to the devtools dashboard
+- **`DevToolsDmkInspector`** — Enables device session inspection and DMK interaction from the dashboard
+
+## Getting Started
+
+Choose the setup that matches your app:
+
+- **Web, Node.js, Electron or React Native app** → [WebSocket devtools setup](../device-management-kit/README.md#web-nodejs-or-electron-app)
+- **React Native app with Rozenite** → [Rozenite devtools setup](../device-management-kit/README.md#react-native-app-with-rozenite) _(recommended for RN — better DX, less setup)_
+
+## Architecture
+
+The devtools system provides a bi-directional communication bridge between a client app (hosting the DMK) and a "Dashboard" app where the developer tools UI is displayed.
+
+```
+Client App                    Dashboard
+┌──────────────────┐         ┌──────────────────┐
+│  DevToolsLogger  │────────▶│  Logger Screen   │
+│                  │         │                  │
+│ DevToolsDmkInspector ◀────▶│ Inspector Screen │
+└──────────────────┘         └──────────────────┘
+        │                            │
+        └───────── Connector ────────┘
+            (WebSocket/Rozenite)
+```
+
+![DMK DevTools architecture](https://github.com/user-attachments/assets/2fa7785d-97e7-4f6c-a516-01eab2bccf15)
+
+### Packages
+
+| Package                        | Description                                                                                      |
+| ------------------------------ | ------------------------------------------------------------------------------------------------ |
+| `devtools-core`                | Core types, `DevToolsLogger` for logging, and `DevToolsDmkInspector` for session/DMK interaction |
+| `devtools-ui`                  | React component for the devtools dashboard UI                                                    |
+| `devtools-rozenite`            | Connector for React Native apps using [Rozenite](https://www.rozenite.dev/)                      |
+| `devtools-websocket-common`    | Common types and constants for the WebSocket layer                                               |
+| `devtools-websocket-connector` | WebSocket connector implementation for client apps                                               |
+| `devtools-websocket-server`    | Node WebSocket server that relays messages between client and dashboard                          |
+
+### Dashboard Implementations
+
+There are two dashboard implementations:
+
+- **Rozenite** (for React Native apps): The devtools appear directly in the React Native DevTools
+- **Electron** (for all other platforms): A standalone desktop app (`apps/devtools`)
+
+### Module Architecture
+
+#### Connector Interface
+
+Both `DevToolsLogger` and `DevToolsDmkInspector` communicate with the dashboard through a `Connector` interface:
+
+```ts
+interface Connector {
+  sendMessage: (type: string, payload: string) => void;
+  listenToMessages: (listener: (type: string, payload: string) => void) => {
+    unsubscribe: () => void;
+  };
+}
+```
+
+This interface is implemented by:
+
+- `DevToolsWebSocketConnector` — for web, Node.js, Electron, and React Native apps
+- `RozeniteConnector` — for React Native apps using Rozenite
+
+#### Module Handshake
+
+When a module is instantiated, it sends a `moduleConnected` message to identify itself to the dashboard. This allows the dashboard UI to show connection status for each module and conditionally render UI elements.
+
+This mechanism helps developers integrating the tools verify that their setup is working as expected. For instance, if someone only sets up `DevToolsLogger` or only `DevToolsDmkInspector` (which is allowed, but could be a user mistake), the Dashboard UI will reflect it with visual indicators.
+
+#### DevToolsLogger Protocol
+
+`DevToolsLogger` provides **one-way communication** from the client app to the dashboard for log streaming.
+
+```mermaid
+sequenceDiagram
+    participant App as Client App
+    participant Logger as DevToolsLogger
+    participant Dashboard
+
+    Logger->>Dashboard: moduleConnected (handshake)
+    App->>Logger: log()
+    Logger->>Dashboard: addLog
+```
+
+| Direction          | Message Type      | Payload                                                                |
+| ------------------ | ----------------- | ---------------------------------------------------------------------- |
+| Client → Dashboard | `moduleConnected` | `{ module: "logger" }`                                                 |
+| Client → Dashboard | `addLog`          | `DevToolsLog` object (timestamp, tag, verbosity, message, payloadJSON) |
+
+#### DevToolsDmkInspector Protocol
+
+`DevToolsDmkInspector` provides **bi-directional communication** for device session inspection and DMK interaction.
+
+**Session inspection flow:**
+
+```mermaid
+sequenceDiagram
+    participant DMK
+    participant Inspector as DevToolsDmkInspector
+    participant Dashboard
+
+    Inspector->>Dashboard: moduleConnected (handshake)
+    Inspector->>Dashboard: connectedDevicesUpdate
+    DMK-->>Inspector: device connected
+    Inspector->>Dashboard: connectedDevicesUpdate
+    Inspector->>Dashboard: deviceSessionStateUpdate
+    Dashboard->>Inspector: disconnect
+    Inspector->>DMK: disconnect()
+    Dashboard->>Inspector: sendApdu
+    Inspector->>DMK: sendApdu()
+    Inspector->>Dashboard: apduResponse
+```
+
+**Device discovery flow:**
+
+```mermaid
+sequenceDiagram
+    participant DMK
+    participant Inspector as DevToolsDmkInspector
+    participant Dashboard
+
+    Dashboard->>Inspector: startListeningDevices
+    Inspector->>DMK: listenToAvailableDevices()
+    DMK-->>Inspector: DiscoveredDevice[]
+    Inspector->>Dashboard: discoveredDevicesUpdate
+    Dashboard->>Inspector: connectDevice
+    Inspector->>DMK: connect(device)
+    DMK-->>Inspector: sessionId
+    Inspector->>Dashboard: connectedDevicesUpdate
+    Dashboard->>Inspector: stopListeningDevices
+```
+
+**Messages from Inspector to Dashboard:**
+
+| Message Type               | Payload                                              | Description                              |
+| -------------------------- | ---------------------------------------------------- | ---------------------------------------- |
+| `moduleConnected`          | `{ module: "dmk-inspector" }`                        | Handshake                                |
+| `connectedDevicesUpdate`   | `ConnectedDevice[]`                                  | List of all connected devices            |
+| `deviceSessionStateUpdate` | `{ sessionId, state }`                               | Session state change                     |
+| `providerValue`            | `{ provider: number }`                               | Response to getProvider                  |
+| `apduResponse`             | `{ requestId, success, statusCode?, data?, error? }` | Response to sendApdu                     |
+| `discoveredDevicesUpdate`  | `DiscoveredDevice[]`                                 | List of available devices for connection |
+
+**Commands from Dashboard to Inspector:**
+
+| Command Type            | Payload                          | Description                                         |
+| ----------------------- | -------------------------------- | --------------------------------------------------- |
+| `disconnect`            | `{ sessionId }`                  | Disconnect a device session                         |
+| `sendApdu`              | `{ sessionId, apdu, requestId }` | Send raw APDU to device                             |
+| `getProvider`           | —                                | Request current provider value                      |
+| `setProvider`           | `{ provider: number }`           | Set provider value                                  |
+| `startListeningDevices` | —                                | Start listening for available devices (passive)     |
+| `stopListeningDevices`  | —                                | Stop listening for available devices                |
+| `startDiscovering`      | —                                | Start active discovery (triggers permission prompt) |
+| `stopDiscovering`       | —                                | Stop active discovery                               |
+| `connectDevice`         | `{ deviceId }`                   | Connect to a discovered device                      |
+
+#### Lifecycle
+
+- **`DevToolsLogger`** — Instantiated _before_ DMK is built, then passed to `DeviceManagementKitBuilder.addLogger()`
+- **`DevToolsDmkInspector`** — Instantiated _after_ DMK is built, requires the DMK instance
+- Both modules should share the same `Connector` instance
+- Call `DevToolsDmkInspector.destroy()` to clean up subscriptions when done
+
+### Features
+
+#### DevToolsLogger
+
+- [x] **Real-time log display** — View all DMK logs in real-time with verbosity levels and tags
+- [x] **Filtering** — Filter logs by level and tag
+- [x] **Export** — Export logs to JSON
+
+#### DevToolsDmkInspector
+
+- [x] **Device sessions inspector** — Display all connected device sessions and their live states
+  - List all active device sessions with device info (model, name, connection type)
+  - Show live `DeviceSessionState` for each session (status, battery, current app, OS info)
+- [x] **Device session actions** — Interact with device sessions from the dashboard
+  - Disconnect a device session
+  - Send raw APDU commands to a session
+- [x] **Device discovery** — Discover and connect to devices from the dashboard
+  - Start/stop device discovery (passive listening and active discovery)
+  - View list of available devices
+  - Connect to a discovered device
+- [x] **DMK configuration** — View and modify DMK settings
+  - View and set the Manager API provider (`getProvider` / `setProvider`)

package/lib/cjs/index.js

@@ -0,0 +1,2 @@
+"use strict";var a=Object.defineProperty;var b=Object.getOwnPropertyDescriptor;var c=Object.getOwnPropertyNames;var d=Object.prototype.hasOwnProperty;var p=(r,o,f,x)=>{if(o&&typeof o=="object"||typeof o=="function")for(let e of c(o))!d.call(r,e)&&e!==f&&a(r,e,{get:()=>o[e],enumerable:!(x=b(o,e))||x.enumerable});return r},t=(r,o,f)=>(p(r,o,"default"),f&&p(f,o,"default"));var g=r=>p(a({},"__esModule",{value:!0}),r);var m={};module.exports=g(m);t(m,require("./src"),module.exports);0&&(module.exports={...require("./src")});
+//# sourceMappingURL=index.js.map

package/lib/cjs/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../index.ts"],
+  "sourcesContent": ["export * from \"./src\";\n"],
+  "mappings": "iaAAA,IAAAA,EAAA,kBAAAC,EAAAD,GAAAE,EAAAF,EAAc,iBAAd",
+  "names": ["index_exports", "__toCommonJS", "__reExport"]
+}

package/lib/cjs/package.json

@@ -0,0 +1,56 @@
+{
+  "dependencies": {},
+  "devDependencies": {
+    "@ledgerhq/device-management-kit": "workspace:^",
+    "@ledgerhq/eslint-config-dsdk": "workspace:^",
+    "@ledgerhq/ldmk-tool": "workspace:^",
+    "@ledgerhq/prettier-config-dsdk": "workspace:^",
+    "@ledgerhq/tsconfig-dsdk": "workspace:^",
+    "@ledgerhq/vitest-config-dmk": "workspace:^",
+    "rxjs": "catalog:"
+  },
+  "exports": {
+    ".": {
+      "import": "./lib/esm/index.js",
+      "require": "./lib/cjs/index.js",
+      "types": "./lib/types/index.d.ts"
+    },
+    "./*": {
+      "import": "./lib/esm/*",
+      "require": "./lib/cjs/*",
+      "types": "./lib/types/*"
+    }
+  },
+  "files": [
+    "./lib"
+  ],
+  "license": "Apache-2.0",
+  "main": "lib/index.js",
+  "name": "@ledgerhq/device-management-kit-devtools-core",
+  "peerDependencies": {
+    "@ledgerhq/device-management-kit": "^1.2.0",
+    "rxjs": "catalog:"
+  },
+  "private": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LedgerHQ/device-sdk-ts.git"
+  },
+  "scripts": {
+    "build": "pnpm ldmk-tool build --entryPoints index.ts,src/**/*.ts --tsconfig tsconfig.prod.json",
+    "dev": "concurrently \"pnpm watch:builds\" \"pnpm watch:types\"",
+    "lint": "eslint",
+    "lint:fix": "pnpm lint --fix",
+    "prebuild": "rimraf lib",
+    "prettier": "prettier . --check",
+    "prettier:fix": "prettier . --write",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "watch:builds": "pnpm ldmk-tool watch --entryPoints index.ts,src/**/*.ts --tsconfig tsconfig.prod.json",
+    "watch:types": "concurrently \"tsc --watch -p tsconfig.prod.json\" \"tsc-alias --watch -p tsconfig.prod.json\""
+  },
+  "types": "lib/index.d.ts",
+  "version": "1.1.1"
+}

package/lib/cjs/src/index.js

@@ -0,0 +1,2 @@
+"use strict";var D=Object.defineProperty;var x=Object.getOwnPropertyDescriptor;var _=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var l=(o,e)=>{for(var E in e)D(o,E,{get:e[E],enumerable:!0})},n=(o,e,E,m)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of _(e))!f.call(o,t)&&t!==E&&D(o,t,{get:()=>e[t],enumerable:!(m=x(e,t))||m.enumerable});return o};var C=o=>n(D({},"__esModule",{value:!0}),o);var O={};l(O,{DEVTOOLS_MODULES:()=>p.DEVTOOLS_MODULES,DevToolsDmkInspector:()=>T.DevToolsDmkInspector,DevToolsLogger:()=>s.DevToolsLogger,INSPECTOR_COMMAND_TYPES:()=>S.INSPECTOR_COMMAND_TYPES,INSPECTOR_MESSAGE_TYPES:()=>S.INSPECTOR_MESSAGE_TYPES,LOGGER_MESSAGE_TYPES:()=>i.LOGGER_MESSAGE_TYPES,MODULE_CONNECTED_MESSAGE_TYPE:()=>p.MODULE_CONNECTED_MESSAGE_TYPE,serializeConnectedDevice:()=>r.serializeConnectedDevice,serializeDeviceSessionState:()=>r.serializeDeviceSessionState,serializeDiscoveredDevice:()=>r.serializeDiscoveredDevice});module.exports=C(O);var S=require("./inspector/constants"),T=require("./inspector/DevToolsDmkInspector"),r=require("./inspector/serialization"),i=require("./logger/constants"),s=require("./logger/DevToolsLogger"),p=require("./modules");0&&(module.exports={DEVTOOLS_MODULES,DevToolsDmkInspector,DevToolsLogger,INSPECTOR_COMMAND_TYPES,INSPECTOR_MESSAGE_TYPES,LOGGER_MESSAGE_TYPES,MODULE_CONNECTED_MESSAGE_TYPE,serializeConnectedDevice,serializeDeviceSessionState,serializeDiscoveredDevice});
+//# sourceMappingURL=index.js.map

package/lib/cjs/src/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/index.ts"],
+  "sourcesContent": ["// Inspector module\nexport { type CommandHandlerContext } from \"./inspector/commandHandlers\";\nexport {\n  INSPECTOR_COMMAND_TYPES,\n  INSPECTOR_MESSAGE_TYPES,\n} from \"./inspector/constants\";\nexport { DevToolsDmkInspector } from \"./inspector/DevToolsDmkInspector\";\nexport {\n  serializeConnectedDevice,\n  serializeDeviceSessionState,\n  serializeDiscoveredDevice,\n} from \"./inspector/serialization\";\n\n// Logger module\nexport { LOGGER_MESSAGE_TYPES } from \"./logger/constants\";\nexport { type DevToolsLog } from \"./logger/DevToolsLog\";\nexport { DevToolsLogger } from \"./logger/DevToolsLogger\";\n\n// Shared\nexport {\n  DEVTOOLS_MODULES,\n  type DevToolsModule,\n  MODULE_CONNECTED_MESSAGE_TYPE,\n} from \"./modules\";\nexport { type Connector } from \"./types\";\n"],
+  "mappings": "yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,4hBAAAE,EAAAF,GAEA,IAAAG,EAGO,iCACPC,EAAqC,4CACrCC,EAIO,qCAGPF,EAAqC,8BAErCG,EAA+B,mCAG/BC,EAIO",
+  "names": ["src_exports", "__export", "__toCommonJS", "import_constants", "import_DevToolsDmkInspector", "import_serialization", "import_DevToolsLogger", "import_modules"]
+}

package/lib/cjs/src/inspector/DevToolsDmkInspector.js

@@ -0,0 +1,2 @@
+"use strict";var c=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var D=Object.getOwnPropertyNames;var l=Object.prototype.hasOwnProperty;var h=(i,e)=>{for(var r in e)c(i,r,{get:e[r],enumerable:!0})},E=(i,e,r,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of D(e))!l.call(i,o)&&o!==r&&c(i,o,{get:()=>e[o],enumerable:!(n=m(e,o))||n.enumerable});return i};var b=i=>E(c({},"__esModule",{value:!0}),i);var S={};h(S,{DevToolsDmkInspector:()=>C});module.exports=b(S);var a=require("../modules"),t=require("./commandHandlers"),s=require("./constants"),d=require("./deviceObserver"),v=require("./DiscoveryHandler");class C{ctx;destroyDeviceObserver;discoveryHandler;commandListenerUnsubscribe=null;constructor(e,r){this.ctx={connector:e,dmk:r},e.sendMessage(a.MODULE_CONNECTED_MESSAGE_TYPE,JSON.stringify({module:a.DEVTOOLS_MODULES.DMK_INSPECTOR})),this.destroyDeviceObserver=(0,d.createDeviceObserver)(r,e),this.discoveryHandler=new v.DiscoveryHandler(r,e),this.setupCommandListener()}destroy(){this.destroyDeviceObserver(),this.discoveryHandler.destroy(),this.commandListenerUnsubscribe&&(this.commandListenerUnsubscribe(),this.commandListenerUnsubscribe=null)}setupCommandListener(){const{unsubscribe:e}=this.ctx.connector.listenToMessages(async(r,n)=>{try{switch(r){case s.INSPECTOR_COMMAND_TYPES.DISCONNECT:await(0,t.handleDisconnect)(this.ctx,n);break;case s.INSPECTOR_COMMAND_TYPES.SEND_APDU:await(0,t.handleSendApdu)(this.ctx,n);break;case s.INSPECTOR_COMMAND_TYPES.GET_PROVIDER:(0,t.handleGetProvider)(this.ctx);break;case s.INSPECTOR_COMMAND_TYPES.SET_PROVIDER:(0,t.handleSetProvider)(this.ctx,n);break;case s.INSPECTOR_COMMAND_TYPES.START_LISTENING_DEVICES:this.discoveryHandler.startListening();break;case s.INSPECTOR_COMMAND_TYPES.STOP_LISTENING_DEVICES:this.discoveryHandler.stopListening();break;case s.INSPECTOR_COMMAND_TYPES.START_DISCOVERING:this.discoveryHandler.startDiscovering();break;case s.INSPECTOR_COMMAND_TYPES.STOP_DISCOVERING:this.discoveryHandler.stopDiscovering();break;case s.INSPECTOR_COMMAND_TYPES.CONNECT_DEVICE:await(0,t.handleConnectDevice)(this.ctx,n,this.discoveryHandler.discoveredDevices);break}}catch(o){console.error(`[DevToolsDmkInspector] Error handling command ${r}`,o)}});this.commandListenerUnsubscribe=e}}0&&(module.exports={DevToolsDmkInspector});
+//# sourceMappingURL=DevToolsDmkInspector.js.map

package/lib/cjs/src/inspector/DevToolsDmkInspector.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/inspector/DevToolsDmkInspector.ts"],
+  "sourcesContent": ["import { type DeviceManagementKit } from \"@ledgerhq/device-management-kit\";\n\nimport { DEVTOOLS_MODULES, MODULE_CONNECTED_MESSAGE_TYPE } from \"../modules\";\nimport { type Connector } from \"../types\";\nimport {\n  type CommandHandlerContext,\n  handleConnectDevice,\n  handleDisconnect,\n  handleGetProvider,\n  handleSendApdu,\n  handleSetProvider,\n} from \"./commandHandlers\";\nimport { INSPECTOR_COMMAND_TYPES } from \"./constants\";\nimport { createDeviceObserver } from \"./deviceObserver\";\nimport { DiscoveryHandler } from \"./DiscoveryHandler\";\n\n/**\n * DevToolsDmkInspector enables the devtools dashboard to inspect and interact\n * with the Device Management Kit.\n *\n * Features:\n * - Device sessions: list connected devices, observe session states\n * - Actions: disconnect sessions, send APDUs\n * - Configuration: get/set provider\n *\n * @example\n * ```ts\n * const connector = DevToolsWebSocketConnector.getInstance().connect({ url });\n * const dmk = new DeviceManagementKitBuilder().build();\n *\n * // Enable inspector after DMK is built\n * const inspector = new DevToolsDmkInspector(connector, dmk);\n *\n * // Clean up when done\n * inspector.destroy();\n * ```\n */\nexport class DevToolsDmkInspector {\n  private readonly ctx: CommandHandlerContext;\n  private readonly destroyDeviceObserver: () => void;\n  private readonly discoveryHandler: DiscoveryHandler;\n  private commandListenerUnsubscribe: (() => void) | null = null;\n\n  constructor(connector: Connector, dmk: DeviceManagementKit) {\n    this.ctx = { connector, dmk };\n\n    // Send handshake\n    connector.sendMessage(\n      MODULE_CONNECTED_MESSAGE_TYPE,\n      JSON.stringify({ module: DEVTOOLS_MODULES.DMK_INSPECTOR }),\n    );\n\n    // Start observing devices\n    this.destroyDeviceObserver = createDeviceObserver(dmk, connector);\n\n    // Initialize discovery handler\n    this.discoveryHandler = new DiscoveryHandler(dmk, connector);\n\n    // Listen for commands from dashboard\n    this.setupCommandListener();\n  }\n\n  /**\n   * Clean up subscriptions and listeners.\n   */\n  destroy(): void {\n    this.destroyDeviceObserver();\n    this.discoveryHandler.destroy();\n\n    if (this.commandListenerUnsubscribe) {\n      this.commandListenerUnsubscribe();\n      this.commandListenerUnsubscribe = null;\n    }\n  }\n\n  /**\n   * Listen for commands from the dashboard.\n   */\n  private setupCommandListener(): void {\n    const { unsubscribe } = this.ctx.connector.listenToMessages(\n      async (type, payload) => {\n        try {\n          switch (type) {\n            case INSPECTOR_COMMAND_TYPES.DISCONNECT:\n              await handleDisconnect(this.ctx, payload);\n              break;\n            case INSPECTOR_COMMAND_TYPES.SEND_APDU:\n              await handleSendApdu(this.ctx, payload);\n              break;\n            case INSPECTOR_COMMAND_TYPES.GET_PROVIDER:\n              handleGetProvider(this.ctx);\n              break;\n            case INSPECTOR_COMMAND_TYPES.SET_PROVIDER:\n              handleSetProvider(this.ctx, payload);\n              break;\n            case INSPECTOR_COMMAND_TYPES.START_LISTENING_DEVICES:\n              this.discoveryHandler.startListening();\n              break;\n            case INSPECTOR_COMMAND_TYPES.STOP_LISTENING_DEVICES:\n              this.discoveryHandler.stopListening();\n              break;\n            case INSPECTOR_COMMAND_TYPES.START_DISCOVERING:\n              this.discoveryHandler.startDiscovering();\n              break;\n            case INSPECTOR_COMMAND_TYPES.STOP_DISCOVERING:\n              this.discoveryHandler.stopDiscovering();\n              break;\n            case INSPECTOR_COMMAND_TYPES.CONNECT_DEVICE:\n              await handleConnectDevice(\n                this.ctx,\n                payload,\n                this.discoveryHandler.discoveredDevices,\n              );\n              break;\n          }\n        } catch (error) {\n          console.error(\n            `[DevToolsDmkInspector] Error handling command ${type}`,\n            error,\n          );\n        }\n      },\n    );\n    this.commandListenerUnsubscribe = unsubscribe;\n  }\n}\n"],
+  "mappings": "yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,0BAAAE,IAAA,eAAAC,EAAAH,GAEA,IAAAI,EAAgE,sBAEhEC,EAOO,6BACPC,EAAwC,uBACxCC,EAAqC,4BACrCC,EAAiC,8BAuB1B,MAAMN,CAAqB,CACf,IACA,sBACA,iBACT,2BAAkD,KAE1D,YAAYO,EAAsBC,EAA0B,CAC1D,KAAK,IAAM,CAAE,UAAAD,EAAW,IAAAC,CAAI,EAG5BD,EAAU,YACR,gCACA,KAAK,UAAU,CAAE,OAAQ,mBAAiB,aAAc,CAAC,CAC3D,EAGA,KAAK,yBAAwB,wBAAqBC,EAAKD,CAAS,EAGhE,KAAK,iBAAmB,IAAI,mBAAiBC,EAAKD,CAAS,EAG3D,KAAK,qBAAqB,CAC5B,CAKA,SAAgB,CACd,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,QAAQ,EAE1B,KAAK,6BACP,KAAK,2BAA2B,EAChC,KAAK,2BAA6B,KAEtC,CAKQ,sBAA6B,CACnC,KAAM,CAAE,YAAAE,CAAY,EAAI,KAAK,IAAI,UAAU,iBACzC,MAAOC,EAAMC,IAAY,CACvB,GAAI,CACF,OAAQD,EAAM,CACZ,KAAK,0BAAwB,WAC3B,QAAM,oBAAiB,KAAK,IAAKC,CAAO,EACxC,MACF,KAAK,0BAAwB,UAC3B,QAAM,kBAAe,KAAK,IAAKA,CAAO,EACtC,MACF,KAAK,0BAAwB,gBAC3B,qBAAkB,KAAK,GAAG,EAC1B,MACF,KAAK,0BAAwB,gBAC3B,qBAAkB,KAAK,IAAKA,CAAO,EACnC,MACF,KAAK,0BAAwB,wBAC3B,KAAK,iBAAiB,eAAe,EACrC,MACF,KAAK,0BAAwB,uBAC3B,KAAK,iBAAiB,cAAc,EACpC,MACF,KAAK,0BAAwB,kBAC3B,KAAK,iBAAiB,iBAAiB,EACvC,MACF,KAAK,0BAAwB,iBAC3B,KAAK,iBAAiB,gBAAgB,EACtC,MACF,KAAK,0BAAwB,eAC3B,QAAM,uBACJ,KAAK,IACLA,EACA,KAAK,iBAAiB,iBACxB,EACA,KACJ,CACF,OAASC,EAAO,CACd,QAAQ,MACN,iDAAiDF,CAAI,GACrDE,CACF,CACF,CACF,CACF,EACA,KAAK,2BAA6BH,CACpC,CACF",
+  "names": ["DevToolsDmkInspector_exports", "__export", "DevToolsDmkInspector", "__toCommonJS", "import_modules", "import_commandHandlers", "import_constants", "import_deviceObserver", "import_DiscoveryHandler", "connector", "dmk", "unsubscribe", "type", "payload", "error"]
+}

package/lib/cjs/src/inspector/DiscoveryHandler.js

@@ -0,0 +1,2 @@
+"use strict";var o=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var v=Object.getOwnPropertyNames;var d=Object.prototype.hasOwnProperty;var g=(e,i)=>{for(var t in i)o(e,t,{get:i[t],enumerable:!0})},p=(e,i,t,r)=>{if(i&&typeof i=="object"||typeof i=="function")for(let s of v(i))!d.call(e,s)&&s!==t&&o(e,s,{get:()=>i[s],enumerable:!(r=c(i,s))||r.enumerable});return e};var D=e=>p(o({},"__esModule",{value:!0}),e);var l={};g(l,{DiscoveryHandler:()=>h});module.exports=D(l);var n=require("./discoveryObserver");class h{dmk;connector;stopListeningFn=null;stopDiscoveringFn=null;_discoveredDevices=[];constructor(i,t){this.dmk=i,this.connector=t}get discoveredDevices(){return this._discoveredDevices}get isListening(){return this.stopListeningFn!==null}get isDiscovering(){return this.stopDiscoveringFn!==null}startListening(){this.stopListeningFn||(this.stopListeningFn=(0,n.startListeningObserver)(this.dmk,this.connector,i=>{this._discoveredDevices=i}))}stopListening(){this.stopListeningFn&&(this.stopListeningFn(),this.stopListeningFn=null,this._discoveredDevices=[])}startDiscovering(){this.stopDiscoveringFn||(this.stopDiscoveringFn=(0,n.startDiscoveringObserver)(this.dmk,this.connector,i=>{this._discoveredDevices=i}))}stopDiscovering(){this.stopDiscoveringFn&&(this.stopDiscoveringFn(),this.stopDiscoveringFn=null,this._discoveredDevices=[])}destroy(){this.stopListening(),this.stopDiscovering()}}0&&(module.exports={DiscoveryHandler});
+//# sourceMappingURL=DiscoveryHandler.js.map

package/lib/cjs/src/inspector/DiscoveryHandler.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/inspector/DiscoveryHandler.ts"],
+  "sourcesContent": ["import {\n  type DeviceManagementKit,\n  type DiscoveredDevice,\n} from \"@ledgerhq/device-management-kit\";\n\nimport { type Connector } from \"../types\";\nimport {\n  startDiscoveringObserver,\n  startListeningObserver,\n} from \"./discoveryObserver\";\n\n/**\n * Handles device discovery operations for the devtools inspector.\n * Encapsulates both passive listening and active discovery modes.\n *\n * @example\n * ```ts\n * const handler = new DiscoveryHandler(dmk, connector);\n *\n * // Start passive listening (no user gesture required)\n * handler.startListening();\n *\n * // Or start active discovery (triggers permission prompt in web)\n * handler.startDiscovering();\n *\n * // Get current discovered devices\n * const devices = handler.discoveredDevices;\n *\n * // Clean up\n * handler.destroy();\n * ```\n */\nexport class DiscoveryHandler {\n  private readonly dmk: DeviceManagementKit;\n  private readonly connector: Connector;\n\n  private stopListeningFn: (() => void) | null = null;\n  private stopDiscoveringFn: (() => void) | null = null;\n  private _discoveredDevices: DiscoveredDevice[] = [];\n\n  constructor(dmk: DeviceManagementKit, connector: Connector) {\n    this.dmk = dmk;\n    this.connector = connector;\n  }\n\n  /**\n   * Get the current list of discovered devices.\n   */\n  get discoveredDevices(): DiscoveredDevice[] {\n    return this._discoveredDevices;\n  }\n\n  /**\n   * Whether passive listening is currently active.\n   */\n  get isListening(): boolean {\n    return this.stopListeningFn !== null;\n  }\n\n  /**\n   * Whether active discovery is currently active.\n   */\n  get isDiscovering(): boolean {\n    return this.stopDiscoveringFn !== null;\n  }\n\n  /**\n   * Start passive listening for available devices.\n   * Does NOT trigger permission prompts - works with already-paired devices.\n   */\n  startListening(): void {\n    if (this.stopListeningFn) {\n      return; // Already listening\n    }\n\n    this.stopListeningFn = startListeningObserver(\n      this.dmk,\n      this.connector,\n      (devices) => {\n        this._discoveredDevices = devices;\n      },\n    );\n  }\n\n  /**\n   * Stop passive listening for available devices.\n   */\n  stopListening(): void {\n    if (this.stopListeningFn) {\n      this.stopListeningFn();\n      this.stopListeningFn = null;\n      this._discoveredDevices = [];\n    }\n  }\n\n  /**\n   * Start active device discovery.\n   * NOTE: In web apps (WebHID/WebBLE), this requires a user gesture in the app context.\n   * Calling this from the dashboard will NOT work for web apps.\n   */\n  startDiscovering(): void {\n    if (this.stopDiscoveringFn) {\n      return; // Already discovering\n    }\n\n    this.stopDiscoveringFn = startDiscoveringObserver(\n      this.dmk,\n      this.connector,\n      (devices) => {\n        this._discoveredDevices = devices;\n      },\n    );\n  }\n\n  /**\n   * Stop active device discovery.\n   */\n  stopDiscovering(): void {\n    if (this.stopDiscoveringFn) {\n      this.stopDiscoveringFn();\n      this.stopDiscoveringFn = null;\n      this._discoveredDevices = [];\n    }\n  }\n\n  /**\n   * Clean up all discovery operations.\n   */\n  destroy(): void {\n    this.stopListening();\n    this.stopDiscovering();\n  }\n}\n"],
+  "mappings": "yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,sBAAAE,IAAA,eAAAC,EAAAH,GAMA,IAAAI,EAGO,+BAuBA,MAAMF,CAAiB,CACX,IACA,UAET,gBAAuC,KACvC,kBAAyC,KACzC,mBAAyC,CAAC,EAElD,YAAYG,EAA0BC,EAAsB,CAC1D,KAAK,IAAMD,EACX,KAAK,UAAYC,CACnB,CAKA,IAAI,mBAAwC,CAC1C,OAAO,KAAK,kBACd,CAKA,IAAI,aAAuB,CACzB,OAAO,KAAK,kBAAoB,IAClC,CAKA,IAAI,eAAyB,CAC3B,OAAO,KAAK,oBAAsB,IACpC,CAMA,gBAAuB,CACjB,KAAK,kBAIT,KAAK,mBAAkB,0BACrB,KAAK,IACL,KAAK,UACJC,GAAY,CACX,KAAK,mBAAqBA,CAC5B,CACF,EACF,CAKA,eAAsB,CAChB,KAAK,kBACP,KAAK,gBAAgB,EACrB,KAAK,gBAAkB,KACvB,KAAK,mBAAqB,CAAC,EAE/B,CAOA,kBAAyB,CACnB,KAAK,oBAIT,KAAK,qBAAoB,4BACvB,KAAK,IACL,KAAK,UACJA,GAAY,CACX,KAAK,mBAAqBA,CAC5B,CACF,EACF,CAKA,iBAAwB,CAClB,KAAK,oBACP,KAAK,kBAAkB,EACvB,KAAK,kBAAoB,KACzB,KAAK,mBAAqB,CAAC,EAE/B,CAKA,SAAgB,CACd,KAAK,cAAc,EACnB,KAAK,gBAAgB,CACvB,CACF",
+  "names": ["DiscoveryHandler_exports", "__export", "DiscoveryHandler", "__toCommonJS", "import_discoveryObserver", "dmk", "connector", "devices"]
+}

package/lib/cjs/src/inspector/commandHandlers.js

@@ -0,0 +1,2 @@
+"use strict";var c=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var v=Object.prototype.hasOwnProperty;var u=(e,n)=>{for(var o in n)c(e,o,{get:n[o],enumerable:!0})},f=(e,n,o,s)=>{if(n&&typeof n=="object"||typeof n=="function")for(let r of p(n))!v.call(e,r)&&r!==o&&c(e,r,{get:()=>n[r],enumerable:!(s=m(n,r))||s.enumerable});return e};var D=e=>f(c({},"__esModule",{value:!0}),e);var C={};u(C,{handleConnectDevice:()=>y,handleDisconnect:()=>l,handleGetProvider:()=>a,handleSendApdu:()=>S,handleSetProvider:()=>g});module.exports=D(C);var d=require("./constants");async function l(e,n){const{sessionId:o}=JSON.parse(n);await e.dmk.disconnect({sessionId:o})}async function S(e,n){const{sessionId:o,apdu:s,requestId:r}=JSON.parse(n);try{const t=new Uint8Array(s),i=await e.dmk.sendApdu({sessionId:o,apdu:t});e.connector.sendMessage(d.INSPECTOR_MESSAGE_TYPES.APDU_RESPONSE,JSON.stringify({requestId:r,success:!0,statusCode:Array.from(i.statusCode),data:Array.from(i.data)}))}catch(t){e.connector.sendMessage(d.INSPECTOR_MESSAGE_TYPES.APDU_RESPONSE,JSON.stringify({requestId:r,success:!1,error:t instanceof Error?t.message:String(t)}))}}function a(e){const n=e.dmk.getProvider();e.connector.sendMessage(d.INSPECTOR_MESSAGE_TYPES.PROVIDER_VALUE,JSON.stringify({provider:n}))}function g(e,n){const{provider:o}=JSON.parse(n);e.dmk.setProvider(o),a(e)}async function y(e,n,o){const{deviceId:s,sessionRefresherOptions:r}=JSON.parse(n),t=o.find(i=>i.id===s);if(!t){console.error(`[DevToolsDmkInspector] Device not found for connect: ${s}`);return}try{await e.dmk.connect({device:t,sessionRefresherOptions:r})}catch(i){console.error(`[DevToolsDmkInspector] Error connecting to device ${s}`,i)}}0&&(module.exports={handleConnectDevice,handleDisconnect,handleGetProvider,handleSendApdu,handleSetProvider});
+//# sourceMappingURL=commandHandlers.js.map

package/lib/cjs/src/inspector/commandHandlers.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/inspector/commandHandlers.ts"],
+  "sourcesContent": ["import {\n  type DeviceId,\n  type DeviceManagementKit,\n  type DeviceSessionId,\n  type DiscoveredDevice,\n} from \"@ledgerhq/device-management-kit\";\n\nimport { type Connector } from \"../types\";\nimport { INSPECTOR_MESSAGE_TYPES } from \"./constants\";\n\n/**\n * Context passed to command handlers.\n */\nexport type CommandHandlerContext = {\n  dmk: DeviceManagementKit;\n  connector: Connector;\n};\n\n/**\n * Handle disconnect command - disconnects a device session.\n */\nexport async function handleDisconnect(\n  ctx: CommandHandlerContext,\n  payload: string,\n): Promise<void> {\n  const { sessionId } = JSON.parse(payload) as { sessionId: DeviceSessionId };\n  await ctx.dmk.disconnect({ sessionId });\n  // Device list update will be sent via the observer\n}\n\n/**\n * Handle sendApdu command - sends a raw APDU to a device.\n */\nexport async function handleSendApdu(\n  ctx: CommandHandlerContext,\n  payload: string,\n): Promise<void> {\n  const { sessionId, apdu, requestId } = JSON.parse(payload) as {\n    sessionId: DeviceSessionId;\n    apdu: number[];\n    requestId: string;\n  };\n  try {\n    // Convert array to Uint8Array for DMK\n    const apduBytes = new Uint8Array(apdu);\n    const response = await ctx.dmk.sendApdu({ sessionId, apdu: apduBytes });\n    ctx.connector.sendMessage(\n      INSPECTOR_MESSAGE_TYPES.APDU_RESPONSE,\n      JSON.stringify({\n        requestId,\n        success: true,\n        statusCode: Array.from(response.statusCode),\n        data: Array.from(response.data),\n      }),\n    );\n  } catch (error) {\n    ctx.connector.sendMessage(\n      INSPECTOR_MESSAGE_TYPES.APDU_RESPONSE,\n      JSON.stringify({\n        requestId,\n        success: false,\n        error: error instanceof Error ? error.message : String(error),\n      }),\n    );\n  }\n}\n\n/**\n * Handle getProvider command - returns the current provider value.\n */\nexport function handleGetProvider(ctx: CommandHandlerContext): void {\n  const provider = ctx.dmk.getProvider();\n  ctx.connector.sendMessage(\n    INSPECTOR_MESSAGE_TYPES.PROVIDER_VALUE,\n    JSON.stringify({ provider }),\n  );\n}\n\n/**\n * Handle setProvider command - sets the provider value and confirms.\n */\nexport function handleSetProvider(\n  ctx: CommandHandlerContext,\n  payload: string,\n): void {\n  const { provider } = JSON.parse(payload) as { provider: number };\n  ctx.dmk.setProvider(provider);\n  // Send back the new value to confirm\n  handleGetProvider(ctx);\n}\n\n/**\n * Handle connectDevice command - connects to a discovered device.\n *\n * @param ctx - Command handler context\n * @param payload - JSON payload containing deviceId and optional sessionRefresherOptions\n * @param discoveredDevices - Current list of discovered devices to find the device\n */\nexport async function handleConnectDevice(\n  ctx: CommandHandlerContext,\n  payload: string,\n  discoveredDevices: DiscoveredDevice[],\n): Promise<void> {\n  const { deviceId, sessionRefresherOptions } = JSON.parse(payload) as {\n    deviceId: DeviceId;\n    sessionRefresherOptions?: {\n      isRefresherDisabled: boolean;\n      pollingInterval?: number;\n    };\n  };\n\n  const device = discoveredDevices.find((d) => d.id === deviceId);\n  if (!device) {\n    console.error(\n      `[DevToolsDmkInspector] Device not found for connect: ${deviceId}`,\n    );\n    return;\n  }\n\n  try {\n    await ctx.dmk.connect({ device, sessionRefresherOptions });\n    // The connected device will be picked up by the deviceObserver\n  } catch (error) {\n    console.error(\n      `[DevToolsDmkInspector] Error connecting to device ${deviceId}`,\n      error,\n    );\n  }\n}\n"],
+  "mappings": "yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,yBAAAE,EAAA,qBAAAC,EAAA,sBAAAC,EAAA,mBAAAC,EAAA,sBAAAC,IAAA,eAAAC,EAAAP,GAQA,IAAAQ,EAAwC,uBAaxC,eAAsBL,EACpBM,EACAC,EACe,CACf,KAAM,CAAE,UAAAC,CAAU,EAAI,KAAK,MAAMD,CAAO,EACxC,MAAMD,EAAI,IAAI,WAAW,CAAE,UAAAE,CAAU,CAAC,CAExC,CAKA,eAAsBN,EACpBI,EACAC,EACe,CACf,KAAM,CAAE,UAAAC,EAAW,KAAAC,EAAM,UAAAC,CAAU,EAAI,KAAK,MAAMH,CAAO,EAKzD,GAAI,CAEF,MAAMI,EAAY,IAAI,WAAWF,CAAI,EAC/BG,EAAW,MAAMN,EAAI,IAAI,SAAS,CAAE,UAAAE,EAAW,KAAMG,CAAU,CAAC,EACtEL,EAAI,UAAU,YACZ,0BAAwB,cACxB,KAAK,UAAU,CACb,UAAAI,EACA,QAAS,GACT,WAAY,MAAM,KAAKE,EAAS,UAAU,EAC1C,KAAM,MAAM,KAAKA,EAAS,IAAI,CAChC,CAAC,CACH,CACF,OAASC,EAAO,CACdP,EAAI,UAAU,YACZ,0BAAwB,cACxB,KAAK,UAAU,CACb,UAAAI,EACA,QAAS,GACT,MAAOG,aAAiB,MAAQA,EAAM,QAAU,OAAOA,CAAK,CAC9D,CAAC,CACH,CACF,CACF,CAKO,SAASZ,EAAkBK,EAAkC,CAClE,MAAMQ,EAAWR,EAAI,IAAI,YAAY,EACrCA,EAAI,UAAU,YACZ,0BAAwB,eACxB,KAAK,UAAU,CAAE,SAAAQ,CAAS,CAAC,CAC7B,CACF,CAKO,SAASX,EACdG,EACAC,EACM,CACN,KAAM,CAAE,SAAAO,CAAS,EAAI,KAAK,MAAMP,CAAO,EACvCD,EAAI,IAAI,YAAYQ,CAAQ,EAE5Bb,EAAkBK,CAAG,CACvB,CASA,eAAsBP,EACpBO,EACAC,EACAQ,EACe,CACf,KAAM,CAAE,SAAAC,EAAU,wBAAAC,CAAwB,EAAI,KAAK,MAAMV,CAAO,EAQ1DW,EAASH,EAAkB,KAAMI,GAAMA,EAAE,KAAOH,CAAQ,EAC9D,GAAI,CAACE,EAAQ,CACX,QAAQ,MACN,wDAAwDF,CAAQ,EAClE,EACA,MACF,CAEA,GAAI,CACF,MAAMV,EAAI,IAAI,QAAQ,CAAE,OAAAY,EAAQ,wBAAAD,CAAwB,CAAC,CAE3D,OAASJ,EAAO,CACd,QAAQ,MACN,qDAAqDG,CAAQ,GAC7DH,CACF,CACF,CACF",
+  "names": ["commandHandlers_exports", "__export", "handleConnectDevice", "handleDisconnect", "handleGetProvider", "handleSendApdu", "handleSetProvider", "__toCommonJS", "import_constants", "ctx", "payload", "sessionId", "apdu", "requestId", "apduBytes", "response", "error", "provider", "discoveredDevices", "deviceId", "sessionRefresherOptions", "device", "d"]
+}

package/lib/cjs/src/inspector/constants.js

@@ -0,0 +1,2 @@
+"use strict";var s=Object.defineProperty;var _=Object.getOwnPropertyDescriptor;var I=Object.getOwnPropertyNames;var T=Object.prototype.hasOwnProperty;var i=(e,E)=>{for(var D in E)s(e,D,{get:E[D],enumerable:!0})},c=(e,E,D,t)=>{if(E&&typeof E=="object"||typeof E=="function")for(let S of I(E))!T.call(e,S)&&S!==D&&s(e,S,{get:()=>E[S],enumerable:!(t=_(E,S))||t.enumerable});return e};var n=e=>c(s({},"__esModule",{value:!0}),e);var N={};i(N,{INSPECTOR_COMMAND_TYPES:()=>C,INSPECTOR_MESSAGE_TYPES:()=>o});module.exports=n(N);const o={CONNECTED_DEVICES_UPDATE:"connectedDevicesUpdate",DEVICE_SESSION_STATE_UPDATE:"deviceSessionStateUpdate",PROVIDER_VALUE:"providerValue",APDU_RESPONSE:"apduResponse",DISCOVERED_DEVICES_UPDATE:"discoveredDevicesUpdate"},C={DISCONNECT:"disconnect",SEND_APDU:"sendApdu",GET_PROVIDER:"getProvider",SET_PROVIDER:"setProvider",START_LISTENING_DEVICES:"startListeningDevices",STOP_LISTENING_DEVICES:"stopListeningDevices",START_DISCOVERING:"startDiscovering",STOP_DISCOVERING:"stopDiscovering",CONNECT_DEVICE:"connectDevice"};0&&(module.exports={INSPECTOR_COMMAND_TYPES,INSPECTOR_MESSAGE_TYPES});
+//# sourceMappingURL=constants.js.map

package/lib/cjs/src/inspector/constants.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/inspector/constants.ts"],
+  "sourcesContent": ["/**\n * Message types sent from inspector to dashboard\n */\nexport const INSPECTOR_MESSAGE_TYPES = {\n  /** List of all connected devices updated */\n  CONNECTED_DEVICES_UPDATE: \"connectedDevicesUpdate\",\n  /** A device session state updated */\n  DEVICE_SESSION_STATE_UPDATE: \"deviceSessionStateUpdate\",\n  /** Response to a getProvider request */\n  PROVIDER_VALUE: \"providerValue\",\n  /** Response to a sendApdu request */\n  APDU_RESPONSE: \"apduResponse\",\n  /** List of discovered (available) devices updated */\n  DISCOVERED_DEVICES_UPDATE: \"discoveredDevicesUpdate\",\n} as const;\n\n/**\n * Message types sent from dashboard to inspector (commands)\n */\nexport const INSPECTOR_COMMAND_TYPES = {\n  /** Request to disconnect a session */\n  DISCONNECT: \"disconnect\",\n  /** Request to send an APDU */\n  SEND_APDU: \"sendApdu\",\n  /** Request to get current provider */\n  GET_PROVIDER: \"getProvider\",\n  /** Request to set provider */\n  SET_PROVIDER: \"setProvider\",\n  /** Request to start listening for available devices (passive, no user gesture required) */\n  START_LISTENING_DEVICES: \"startListeningDevices\",\n  /** Request to stop listening for available devices */\n  STOP_LISTENING_DEVICES: \"stopListeningDevices\",\n  /** Request to start discovering devices (triggers permission prompt, requires user gesture in web apps) */\n  START_DISCOVERING: \"startDiscovering\",\n  /** Request to stop discovering devices */\n  STOP_DISCOVERING: \"stopDiscovering\",\n  /** Request to connect to a discovered device */\n  CONNECT_DEVICE: \"connectDevice\",\n} as const;\n"],
+  "mappings": "yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,6BAAAE,EAAA,4BAAAC,IAAA,eAAAC,EAAAJ,GAGO,MAAMG,EAA0B,CAErC,yBAA0B,yBAE1B,4BAA6B,2BAE7B,eAAgB,gBAEhB,cAAe,eAEf,0BAA2B,yBAC7B,EAKaD,EAA0B,CAErC,WAAY,aAEZ,UAAW,WAEX,aAAc,cAEd,aAAc,cAEd,wBAAyB,wBAEzB,uBAAwB,uBAExB,kBAAmB,mBAEnB,iBAAkB,kBAElB,eAAgB,eAClB",
+  "names": ["constants_exports", "__export", "INSPECTOR_COMMAND_TYPES", "INSPECTOR_MESSAGE_TYPES", "__toCommonJS"]
+}

package/lib/cjs/src/inspector/deviceObserver.js

@@ -0,0 +1,2 @@
+"use strict";var v=Object.defineProperty;var b=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var d=Object.prototype.hasOwnProperty;var l=(e,t)=>{for(var i in t)v(e,i,{get:t[i],enumerable:!0})},C=(e,t,i,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of f(t))!d.call(e,n)&&n!==i&&v(e,n,{get:()=>t[n],enumerable:!(o=b(t,n))||o.enumerable});return e};var E=e=>C(v({},"__esModule",{value:!0}),e);var T={};l(T,{createDeviceObserver:()=>m,sendConnectedDevicesUpdate:()=>r,sendSessionStateUpdate:()=>a});module.exports=E(T);var D=require("./constants"),c=require("./serialization");function r(e,t){const i=e.listConnectedDevices();t.sendMessage(D.INSPECTOR_MESSAGE_TYPES.CONNECTED_DEVICES_UPDATE,JSON.stringify(i.map(c.serializeConnectedDevice)))}function a(e,t,i){e.sendMessage(D.INSPECTOR_MESSAGE_TYPES.DEVICE_SESSION_STATE_UPDATE,JSON.stringify({sessionId:t,state:(0,c.serializeDeviceSessionState)(i)}))}function m(e,t){const i=[],o=new Map,n=s=>{if(o.has(s))return;const u=e.getDeviceSessionState({sessionId:s}).subscribe({next:S=>{a(t,s,S)},error:S=>{console.error(`[DevToolsDmkInspector] getDeviceSessionState error for ${s}`,S),o.delete(s)},complete:()=>{o.delete(s),r(e,t)}});o.set(s,u)};r(e,t);const p=e.listenToConnectedDevice().subscribe({next:s=>{r(e,t),n(s.sessionId)},error:s=>{console.error("[DevToolsDmkInspector] listenToConnectedDevice error",s)}});return i.push(p),e.listConnectedDevices().forEach(s=>{n(s.sessionId)}),()=>{for(const s of i)s.unsubscribe();for(const s of o.values())s.unsubscribe();o.clear()}}0&&(module.exports={createDeviceObserver,sendConnectedDevicesUpdate,sendSessionStateUpdate});
+//# sourceMappingURL=deviceObserver.js.map

package/lib/cjs/src/inspector/deviceObserver.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/inspector/deviceObserver.ts"],
+  "sourcesContent": ["import {\n  type DeviceManagementKit,\n  type DeviceSessionId,\n  type DeviceSessionState,\n} from \"@ledgerhq/device-management-kit\";\nimport { type Subscription } from \"rxjs\";\n\nimport { type Connector } from \"../types\";\nimport { INSPECTOR_MESSAGE_TYPES } from \"./constants\";\nimport {\n  serializeConnectedDevice,\n  serializeDeviceSessionState,\n} from \"./serialization\";\n\n/**\n * Sends the current list of connected devices to the dashboard.\n */\nexport function sendConnectedDevicesUpdate(\n  dmk: DeviceManagementKit,\n  connector: Connector,\n): void {\n  const devices = dmk.listConnectedDevices();\n  connector.sendMessage(\n    INSPECTOR_MESSAGE_TYPES.CONNECTED_DEVICES_UPDATE,\n    JSON.stringify(devices.map(serializeConnectedDevice)),\n  );\n}\n\n/**\n * Sends a device session state update to the dashboard.\n */\nexport function sendSessionStateUpdate(\n  connector: Connector,\n  sessionId: DeviceSessionId,\n  state: DeviceSessionState,\n): void {\n  connector.sendMessage(\n    INSPECTOR_MESSAGE_TYPES.DEVICE_SESSION_STATE_UPDATE,\n    JSON.stringify({\n      sessionId,\n      state: serializeDeviceSessionState(state),\n    }),\n  );\n}\n\n/**\n * Creates a device observer that tracks connected devices and their session states.\n * Returns a cleanup function to unsubscribe from all observations.\n */\nexport function createDeviceObserver(\n  dmk: DeviceManagementKit,\n  connector: Connector,\n): () => void {\n  const subscriptions: Subscription[] = [];\n  const sessionStateSubscriptions = new Map<DeviceSessionId, Subscription>();\n\n  const subscribeToSessionState = (sessionId: DeviceSessionId): void => {\n    // Don't double-subscribe\n    if (sessionStateSubscriptions.has(sessionId)) {\n      return;\n    }\n\n    const sub = dmk.getDeviceSessionState({ sessionId }).subscribe({\n      next: (state: DeviceSessionState) => {\n        sendSessionStateUpdate(connector, sessionId, state);\n      },\n      error: (err) => {\n        console.error(\n          `[DevToolsDmkInspector] getDeviceSessionState error for ${sessionId}`,\n          err,\n        );\n        sessionStateSubscriptions.delete(sessionId);\n      },\n      complete: () => {\n        // Session ended, clean up and send updated device list\n        sessionStateSubscriptions.delete(sessionId);\n        sendConnectedDevicesUpdate(dmk, connector);\n      },\n    });\n\n    sessionStateSubscriptions.set(sessionId, sub);\n  };\n\n  // Send initial list of connected devices\n  sendConnectedDevicesUpdate(dmk, connector);\n\n  // Subscribe to new device connections\n  const deviceSub = dmk.listenToConnectedDevice().subscribe({\n    next: (device) => {\n      sendConnectedDevicesUpdate(dmk, connector);\n      subscribeToSessionState(device.sessionId);\n    },\n    error: (err) => {\n      console.error(\n        \"[DevToolsDmkInspector] listenToConnectedDevice error\",\n        err,\n      );\n    },\n  });\n  subscriptions.push(deviceSub);\n\n  // Subscribe to existing devices' session states\n  const existingDevices = dmk.listConnectedDevices();\n  existingDevices.forEach((device) => {\n    subscribeToSessionState(device.sessionId);\n  });\n\n  // Return cleanup function\n  return () => {\n    for (const sub of subscriptions) {\n      sub.unsubscribe();\n    }\n    for (const sub of sessionStateSubscriptions.values()) {\n      sub.unsubscribe();\n    }\n    sessionStateSubscriptions.clear();\n  };\n}\n"],
+  "mappings": "yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,0BAAAE,EAAA,+BAAAC,EAAA,2BAAAC,IAAA,eAAAC,EAAAL,GAQA,IAAAM,EAAwC,uBACxCC,EAGO,2BAKA,SAASJ,EACdK,EACAC,EACM,CACN,MAAMC,EAAUF,EAAI,qBAAqB,EACzCC,EAAU,YACR,0BAAwB,yBACxB,KAAK,UAAUC,EAAQ,IAAI,0BAAwB,CAAC,CACtD,CACF,CAKO,SAASN,EACdK,EACAE,EACAC,EACM,CACNH,EAAU,YACR,0BAAwB,4BACxB,KAAK,UAAU,CACb,UAAAE,EACA,SAAO,+BAA4BC,CAAK,CAC1C,CAAC,CACH,CACF,CAMO,SAASV,EACdM,EACAC,EACY,CACZ,MAAMI,EAAgC,CAAC,EACjCC,EAA4B,IAAI,IAEhCC,EAA2BJ,GAAqC,CAEpE,GAAIG,EAA0B,IAAIH,CAAS,EACzC,OAGF,MAAMK,EAAMR,EAAI,sBAAsB,CAAE,UAAAG,CAAU,CAAC,EAAE,UAAU,CAC7D,KAAOC,GAA8B,CACnCR,EAAuBK,EAAWE,EAAWC,CAAK,CACpD,EACA,MAAQK,GAAQ,CACd,QAAQ,MACN,0DAA0DN,CAAS,GACnEM,CACF,EACAH,EAA0B,OAAOH,CAAS,CAC5C,EACA,SAAU,IAAM,CAEdG,EAA0B,OAAOH,CAAS,EAC1CR,EAA2BK,EAAKC,CAAS,CAC3C,CACF,CAAC,EAEDK,EAA0B,IAAIH,EAAWK,CAAG,CAC9C,EAGAb,EAA2BK,EAAKC,CAAS,EAGzC,MAAMS,EAAYV,EAAI,wBAAwB,EAAE,UAAU,CACxD,KAAOW,GAAW,CAChBhB,EAA2BK,EAAKC,CAAS,EACzCM,EAAwBI,EAAO,SAAS,CAC1C,EACA,MAAQF,GAAQ,CACd,QAAQ,MACN,uDACAA,CACF,CACF,CACF,CAAC,EACD,OAAAJ,EAAc,KAAKK,CAAS,EAGJV,EAAI,qBAAqB,EACjC,QAASW,GAAW,CAClCJ,EAAwBI,EAAO,SAAS,CAC1C,CAAC,EAGM,IAAM,CACX,UAAWH,KAAOH,EAChBG,EAAI,YAAY,EAElB,UAAWA,KAAOF,EAA0B,OAAO,EACjDE,EAAI,YAAY,EAElBF,EAA0B,MAAM,CAClC,CACF",
+  "names": ["deviceObserver_exports", "__export", "createDeviceObserver", "sendConnectedDevicesUpdate", "sendSessionStateUpdate", "__toCommonJS", "import_constants", "import_serialization", "dmk", "connector", "devices", "sessionId", "state", "subscriptions", "sessionStateSubscriptions", "subscribeToSessionState", "sub", "err", "deviceSub", "device"]
+}

package/lib/cjs/src/inspector/discoveryObserver.js

@@ -0,0 +1,2 @@
+"use strict";var t=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var a=Object.prototype.hasOwnProperty;var b=(r,i)=>{for(var s in i)t(r,s,{get:i[s],enumerable:!0})},m=(r,i,s,o)=>{if(i&&typeof i=="object"||typeof i=="function")for(let e of u(i))!a.call(r,e)&&e!==s&&t(r,e,{get:()=>i[e],enumerable:!(o=d(i,e))||o.enumerable});return r};var f=r=>m(t({},"__esModule",{value:!0}),r);var x={};b(x,{sendDiscoveredDevicesUpdate:()=>c,startDiscoveringObserver:()=>S,startListeningObserver:()=>g});module.exports=f(x);var D=require("./constants"),p=require("./serialization");function c(r,i){i.sendMessage(D.INSPECTOR_MESSAGE_TYPES.DISCOVERED_DEVICES_UPDATE,JSON.stringify(r.map(p.serializeDiscoveredDevice)))}function g(r,i,s){let o=null;return o=r.listenToAvailableDevices({}).subscribe({next:e=>{c(e,i),s?.(e)},error:e=>{console.error("[DevToolsDmkInspector] listenToAvailableDevices error",e)}}),()=>{o&&(o.unsubscribe(),o=null)}}function S(r,i,s){let o=null;const e=[];return o=r.startDiscovering({}).subscribe({next:n=>{const v=e.findIndex(l=>l.id===n.id);v>=0?e[v]=n:e.push(n),c([...e],i),s?.([...e])},error:n=>{console.error("[DevToolsDmkInspector] startDiscovering error",n)},complete:()=>{}}),()=>{o&&(o.unsubscribe(),o=null),r.stopDiscovering()}}0&&(module.exports={sendDiscoveredDevicesUpdate,startDiscoveringObserver,startListeningObserver});
+//# sourceMappingURL=discoveryObserver.js.map