@ledgerhq/device-management-kit-devtools-core 0.0.0-develop-20261104000847 → 0.0.0-develop-20261107000805

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -9,8 +9,8 @@ Core library for DMK developer tools. Contains:
9
9
 
10
10
  Choose the setup that matches your app:
11
11
 
12
- - **Web, Node.js, Electron or React Native app** → [WebSocket devtools setup](../device-management-kit/README.md#web-nodejs-or-electron-app)
13
- - **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)_
12
+ - **Web, Node.js, Electron or React Native app** → [WebSocket devtools setup](../../device-management-kit/README.md#web-nodejs-or-electron-app)
13
+ - **React Native app with Rozenite** → [Rozenite devtools setup](../../device-management-kit/README.md#react-native-app-with-rozenite) _(less setup for RN, but no AI debugging: see [what each dashboard provides](#dashboard-implementations))_
14
14
 
15
15
  ## Architecture
16
16
 
@@ -28,6 +28,8 @@ Client App Dashboard
28
28
  (WebSocket/Rozenite)
29
29
  ```
30
30
 
31
+ When the app uses the mock server transport, the dashboard also calls the mock server directly over HTTP, outside the Connector, to show the mock device's live screen. `DevToolsDmkInspector` only shares the mock server's URL and session token (see [Mock server](#mock-server)).
32
+
31
33
  ![DMK DevTools architecture](https://github.com/user-attachments/assets/2fa7785d-97e7-4f6c-a516-01eab2bccf15)
32
34
 
33
35
  ### Packages
@@ -45,8 +47,18 @@ Client App Dashboard
45
47
 
46
48
  There are two dashboard implementations:
47
49
 
48
- - **Rozenite** (for React Native apps): The devtools appear directly in the React Native DevTools
49
- - **Electron** (for all other platforms): A standalone desktop app (`apps/devtools`)
50
+ - **Electron** (any app, through the WebSocket connector): a standalone desktop app (`apps/devtools`)
51
+ - **Rozenite** (React Native apps): the devtools appear directly in the React Native DevTools
52
+
53
+ They show the same `devtools-ui` dashboard, but not everything the host must provide is available in both:
54
+
55
+ | Feature | Electron | Rozenite |
56
+ | ----------------------- | ---------------------------------------------------- | ----------------- |
57
+ | Logger and Inspector | Yes | Yes |
58
+ | Mock device live screen | Yes, through a `mockserver://` proxy that asks first | Yes, direct calls |
59
+ | AI debugging | Yes, with the computer's Claude Code login | Not yet |
60
+
61
+ AI debugging runs Claude Code in the Electron main process, which Rozenite cannot host. In Rozenite the AI buttons are disabled. A React Native app can still use AI debugging by connecting to the desktop app with the [WebSocket setup](../../device-management-kit/README.md#web-nodejs-or-electron-app).
50
62
 
51
63
  ### Module Architecture
52
64
 
@@ -144,6 +156,7 @@ sequenceDiagram
144
156
  | `moduleConnected` | `{ module: "dmk-inspector" }` | Handshake |
145
157
  | `connectedDevicesUpdate` | `ConnectedDevice[]` | List of all connected devices |
146
158
  | `deviceSessionStateUpdate` | `{ sessionId, state }` | Session state change |
159
+ | `mockServerConfig` | `{ url, sessionToken? }` or `null` | The app's mock server, sent on handshake |
147
160
  | `providerValue` | `{ provider: number }` | Response to getProvider |
148
161
  | `apduResponse` | `{ requestId, success, statusCode?, data?, error? }` | Response to sendApdu |
149
162
  | `discoveredDevicesUpdate` | `DiscoveredDevice[]` | List of available devices for connection |
@@ -165,16 +178,36 @@ sequenceDiagram
165
178
  #### Lifecycle
166
179
 
167
180
  - **`DevToolsLogger`** — Instantiated _before_ DMK is built, then passed to `DeviceManagementKitBuilder.addLogger()`
168
- - **`DevToolsDmkInspector`** — Instantiated _after_ DMK is built, requires the DMK instance
181
+ - **`DevToolsDmkInspector`** — Instantiated _after_ DMK is built, requires the DMK instance. An optional third argument `{ mockServer: { url, sessionToken? } }` shares the app's mock server with the dashboard
169
182
  - Both modules should share the same `Connector` instance
170
183
  - Call `DevToolsDmkInspector.destroy()` to clean up subscriptions when done
171
184
 
185
+ ### Mock server
186
+
187
+ When the app uses the [device mock server](../../../apps/device-mock-server) transport, pass it to the inspector:
188
+
189
+ ```ts
190
+ const inspector = new DevToolsDmkInspector(connector, dmk, {
191
+ mockServer: { url: "http://127.0.0.1:9752", sessionToken },
192
+ });
193
+ ```
194
+
195
+ The inspector sends it in a `mockServerConfig` message (or `null` without one, so the dashboard forgets a previous app's mock server). The dashboard then calls the mock server itself, outside the Connector:
196
+
197
+ - The Inspector shows the mock device's live screen.
198
+ - A navigation-bar button opens the mock server website on the app's session. It only appears for an `http(s)` URL with a session token.
199
+
200
+ The app chooses the URL, so the Electron dashboard proxies these calls through `mockserver://`, asks before contacting a new origin and never follows a redirect.
201
+
172
202
  ### Features
173
203
 
174
204
  #### DevToolsLogger
175
205
 
176
206
  - [x] **Real-time log display** — View all DMK logs in real-time with verbosity levels and tags
177
- - [x] **Filtering** — Filter logs by level and tag
207
+ - [x] **Filtering** — Filter logs by level and tag, and by text (Ctrl/Cmd+K)
208
+ - [x] **Search** — Find text in the logs (Ctrl/Cmd+F) and step through the matches
209
+ - [x] **Payloads** — Preview each payload and expand it into a tree
210
+ - [x] **Large sessions** — Keeps the newest 20,000 logs, pause and clear
178
211
  - [x] **Export** — Export logs to JSON
179
212
 
180
213
  #### DevToolsDmkInspector
@@ -182,6 +215,9 @@ sequenceDiagram
182
215
  - [x] **Device sessions inspector** — Display all connected device sessions and their live states
183
216
  - List all active device sessions with device info (model, name, connection type)
184
217
  - Show live `DeviceSessionState` for each session (status, battery, current app, OS info)
218
+ - [x] **APDU list** — Every APDU exchanged with the selected session, with filter, pause, clear and export
219
+ - Each APDU is named after the command of the app open when it was sent (`getAppAndVersion`, `signPsbt`…) and tagged with the OS or app that answered
220
+ - The list is built from DMK's logs, so it needs `DevToolsLogger` on the same Connector
185
221
  - [x] **Device session actions** — Interact with device sessions from the dashboard
186
222
  - Disconnect a device session
187
223
  - Send raw APDU commands to a session
@@ -189,5 +225,14 @@ sequenceDiagram
189
225
  - Start/stop device discovery (passive listening and active discovery)
190
226
  - View list of available devices
191
227
  - Connect to a discovered device
192
- - [x] **DMK configuration** — View and modify DMK settings
193
- - View and set the Manager API provider (`getProvider` / `setProvider`)
228
+ - [x] **Mock server** — The mock device's live screen and a link to the mock server website (see [Mock server](#mock-server))
229
+
230
+ The inspector still answers `getProvider` / `setProvider`, but the dashboard no longer has a control for the My Ledger API provider.
231
+
232
+ #### AI debugging (Electron only)
233
+
234
+ - [x] **Explain with AI** — Select logs or APDUs and Claude explains what happened, why, and what to try next, then answers follow-up questions
235
+ - [x] **Read the code** — When the desktop app runs from this repository, Claude can also read DMK's source
236
+ - [x] **Create Jira ticket** — When the verdict is a bug, file it in `DSDK` through the user's Atlassian connector
237
+
238
+ See the [desktop app README](../../../apps/devtools/README.md#ai-debugging) for what it needs.
@@ -52,5 +52,5 @@
52
52
  "watch:types": "concurrently \"tsc --watch -p tsconfig.prod.json\" \"tsc-alias --watch -p tsconfig.prod.json\""
53
53
  },
54
54
  "types": "lib/index.d.ts",
55
- "version": "0.0.0-develop-20261104000847"
55
+ "version": "0.0.0-develop-20261107000805"
56
56
  }
@@ -1,2 +1,2 @@
1
- "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});
1
+ "use strict";var S=Object.defineProperty;var n=Object.getOwnPropertyDescriptor;var l=Object.getOwnPropertyNames;var x=Object.prototype.hasOwnProperty;var O=(o,e)=>{for(var E in e)S(o,E,{get:e[E],enumerable:!0})},_=(o,e,E,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of l(e))!x.call(o,t)&&t!==E&&S(o,t,{get:()=>e[t],enumerable:!(s=n(e,t))||s.enumerable});return o};var f=o=>_(S({},"__esModule",{value:!0}),o);var v={};O(v,{DEVTOOLS_MODULES:()=>D.DEVTOOLS_MODULES,DevToolsDmkInspector:()=>m.DevToolsDmkInspector,DevToolsLogger:()=>i.DevToolsLogger,INSPECTOR_COMMAND_TYPES:()=>p.INSPECTOR_COMMAND_TYPES,INSPECTOR_MESSAGE_TYPES:()=>p.INSPECTOR_MESSAGE_TYPES,LOGGER_MESSAGE_TYPES:()=>T.LOGGER_MESSAGE_TYPES,MODULE_CONNECTED_MESSAGE_TYPE:()=>D.MODULE_CONNECTED_MESSAGE_TYPE,serializeConnectedDevice:()=>r.serializeConnectedDevice,serializeDeviceSessionState:()=>r.serializeDeviceSessionState,serializeDiscoveredDevice:()=>r.serializeDiscoveredDevice});module.exports=f(v);var p=require("./inspector/constants"),m=require("./inspector/DevToolsDmkInspector"),r=require("./inspector/serialization"),T=require("./logger/constants"),i=require("./logger/DevToolsLogger"),D=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});
2
2
  //# sourceMappingURL=index.js.map
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../src/index.ts"],
4
- "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"],
5
- "mappings": "yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,4hBAAAE,EAAAF,GAEA,IAAAG,EAGO,iCACPC,EAAqC,4CACrCC,EAIO,qCAGPF,EAAqC,8BAErCG,EAA+B,mCAG/BC,EAIO",
4
+ "sourcesContent": ["// Inspector module\nexport { type CommandHandlerContext } from \"./inspector/commandHandlers\";\nexport {\n INSPECTOR_COMMAND_TYPES,\n INSPECTOR_MESSAGE_TYPES,\n} from \"./inspector/constants\";\nexport {\n DevToolsDmkInspector,\n type DevToolsDmkInspectorOptions,\n} 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"],
5
+ "mappings": "yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,4hBAAAE,EAAAF,GAEA,IAAAG,EAGO,iCACPC,EAGO,4CACPC,EAIO,qCAGPF,EAAqC,8BAErCG,EAA+B,mCAG/BC,EAIO",
6
6
  "names": ["src_exports", "__export", "__toCommonJS", "import_constants", "import_DevToolsDmkInspector", "import_serialization", "import_DevToolsLogger", "import_modules"]
7
7
  }
@@ -1,2 +1,2 @@
1
- "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});
1
+ "use strict";var c=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var D=Object.getOwnPropertyNames;var l=Object.prototype.hasOwnProperty;var E=(n,e)=>{for(var s in e)c(n,s,{get:e[s],enumerable:!0})},S=(n,e,s,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of D(e))!l.call(n,o)&&o!==s&&c(n,o,{get:()=>e[o],enumerable:!(i=m(e,o))||i.enumerable});return n};var h=n=>S(c({},"__esModule",{value:!0}),n);var C={};E(C,{DevToolsDmkInspector:()=>O});module.exports=h(C);var a=require("../modules"),t=require("./commandHandlers"),r=require("./constants"),d=require("./deviceObserver"),v=require("./DiscoveryHandler");class O{ctx;destroyDeviceObserver;discoveryHandler;commandListenerUnsubscribe=null;constructor(e,s,i={}){this.ctx={connector:e,dmk:s},e.sendMessage(a.MODULE_CONNECTED_MESSAGE_TYPE,JSON.stringify({module:a.DEVTOOLS_MODULES.DMK_INSPECTOR})),e.sendMessage(r.INSPECTOR_MESSAGE_TYPES.MOCK_SERVER_CONFIG,JSON.stringify(i.mockServer??null)),this.destroyDeviceObserver=(0,d.createDeviceObserver)(s,e),this.discoveryHandler=new v.DiscoveryHandler(s,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(s,i)=>{try{switch(s){case r.INSPECTOR_COMMAND_TYPES.DISCONNECT:await(0,t.handleDisconnect)(this.ctx,i);break;case r.INSPECTOR_COMMAND_TYPES.SEND_APDU:await(0,t.handleSendApdu)(this.ctx,i);break;case r.INSPECTOR_COMMAND_TYPES.GET_PROVIDER:(0,t.handleGetProvider)(this.ctx);break;case r.INSPECTOR_COMMAND_TYPES.SET_PROVIDER:(0,t.handleSetProvider)(this.ctx,i);break;case r.INSPECTOR_COMMAND_TYPES.START_LISTENING_DEVICES:this.discoveryHandler.startListening();break;case r.INSPECTOR_COMMAND_TYPES.STOP_LISTENING_DEVICES:this.discoveryHandler.stopListening();break;case r.INSPECTOR_COMMAND_TYPES.START_DISCOVERING:this.discoveryHandler.startDiscovering();break;case r.INSPECTOR_COMMAND_TYPES.STOP_DISCOVERING:this.discoveryHandler.stopDiscovering();break;case r.INSPECTOR_COMMAND_TYPES.CONNECT_DEVICE:await(0,t.handleConnectDevice)(this.ctx,i,this.discoveryHandler.discoveredDevices);break}}catch(o){console.error(`[DevToolsDmkInspector] Error handling command ${s}`,o)}});this.commandListenerUnsubscribe=e}}0&&(module.exports={DevToolsDmkInspector});
2
2
  //# sourceMappingURL=DevToolsDmkInspector.js.map
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/inspector/DevToolsDmkInspector.ts"],
4
- "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"],
5
- "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",
6
- "names": ["DevToolsDmkInspector_exports", "__export", "DevToolsDmkInspector", "__toCommonJS", "import_modules", "import_commandHandlers", "import_constants", "import_deviceObserver", "import_DiscoveryHandler", "connector", "dmk", "unsubscribe", "type", "payload", "error"]
4
+ "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, INSPECTOR_MESSAGE_TYPES } from \"./constants\";\nimport { createDeviceObserver } from \"./deviceObserver\";\nimport { DiscoveryHandler } from \"./DiscoveryHandler\";\n\nexport type DevToolsDmkInspectorOptions = {\n /**\n * The mock server the app's mock transport talks to. The dashboard uses it to\n * show the live screen of mock devices.\n */\n mockServer?: { url: string; sessionToken?: string };\n};\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 * - Mock server: share its URL and session with the dashboard\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(\n connector: Connector,\n dmk: DeviceManagementKit,\n options: DevToolsDmkInspectorOptions = {},\n ) {\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 // Sent even when absent, so the dashboard drops a previous app's mock server\n connector.sendMessage(\n INSPECTOR_MESSAGE_TYPES.MOCK_SERVER_CONFIG,\n JSON.stringify(options.mockServer ?? null),\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"],
5
+ "mappings": "yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,0BAAAE,IAAA,eAAAC,EAAAH,GAEA,IAAAI,EAAgE,sBAEhEC,EAOO,6BACPC,EAAiE,uBACjEC,EAAqC,4BACrCC,EAAiC,8BAgC1B,MAAMN,CAAqB,CACf,IACA,sBACA,iBACT,2BAAkD,KAE1D,YACEO,EACAC,EACAC,EAAuC,CAAC,EACxC,CACA,KAAK,IAAM,CAAE,UAAAF,EAAW,IAAAC,CAAI,EAG5BD,EAAU,YACR,gCACA,KAAK,UAAU,CAAE,OAAQ,mBAAiB,aAAc,CAAC,CAC3D,EAGAA,EAAU,YACR,0BAAwB,mBACxB,KAAK,UAAUE,EAAQ,YAAc,IAAI,CAC3C,EAGA,KAAK,yBAAwB,wBAAqBD,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,YAAAG,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",
6
+ "names": ["DevToolsDmkInspector_exports", "__export", "DevToolsDmkInspector", "__toCommonJS", "import_modules", "import_commandHandlers", "import_constants", "import_deviceObserver", "import_DiscoveryHandler", "connector", "dmk", "options", "unsubscribe", "type", "payload", "error"]
7
7
  }
@@ -1,2 +1,2 @@
1
- "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});
1
+ "use strict";var s=Object.defineProperty;var t=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})},o=(e,E,D,_)=>{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))||_.enumerable});return e};var C=e=>o(s({},"__esModule",{value:!0}),e);var N={};i(N,{INSPECTOR_COMMAND_TYPES:()=>n,INSPECTOR_MESSAGE_TYPES:()=>c});module.exports=C(N);const c={CONNECTED_DEVICES_UPDATE:"connectedDevicesUpdate",DEVICE_SESSION_STATE_UPDATE:"deviceSessionStateUpdate",PROVIDER_VALUE:"providerValue",APDU_RESPONSE:"apduResponse",DISCOVERED_DEVICES_UPDATE:"discoveredDevicesUpdate",MOCK_SERVER_CONFIG:"mockServerConfig"},n={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});
2
2
  //# sourceMappingURL=constants.js.map
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/inspector/constants.ts"],
4
- "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"],
5
- "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",
4
+ "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 /** Mock server the app's transport talks to, so the dashboard can show its device screens */\n MOCK_SERVER_CONFIG: \"mockServerConfig\",\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"],
5
+ "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,0BAE3B,mBAAoB,kBACtB,EAKaD,EAA0B,CAErC,WAAY,aAEZ,UAAW,WAEX,aAAc,cAEd,aAAc,cAEd,wBAAyB,wBAEzB,uBAAwB,uBAExB,kBAAmB,mBAEnB,iBAAkB,kBAElB,eAAgB,eAClB",
6
6
  "names": ["constants_exports", "__export", "INSPECTOR_COMMAND_TYPES", "INSPECTOR_MESSAGE_TYPES", "__toCommonJS"]
7
7
  }
@@ -52,5 +52,5 @@
52
52
  "watch:types": "concurrently \"tsc --watch -p tsconfig.prod.json\" \"tsc-alias --watch -p tsconfig.prod.json\""
53
53
  },
54
54
  "types": "lib/index.d.ts",
55
- "version": "0.0.0-develop-20261104000847"
55
+ "version": "0.0.0-develop-20261107000805"
56
56
  }
@@ -1,2 +1,2 @@
1
- import{INSPECTOR_COMMAND_TYPES as r,INSPECTOR_MESSAGE_TYPES as t}from"./inspector/constants";import{DevToolsDmkInspector as S}from"./inspector/DevToolsDmkInspector";import{serializeConnectedDevice as D,serializeDeviceSessionState as m,serializeDiscoveredDevice as T}from"./inspector/serialization";import{LOGGER_MESSAGE_TYPES as s}from"./logger/constants";import{DevToolsLogger as _}from"./logger/DevToolsLogger";import{DEVTOOLS_MODULES as l,MODULE_CONNECTED_MESSAGE_TYPE as n}from"./modules";export{l as DEVTOOLS_MODULES,S as DevToolsDmkInspector,_ as DevToolsLogger,r as INSPECTOR_COMMAND_TYPES,t as INSPECTOR_MESSAGE_TYPES,s as LOGGER_MESSAGE_TYPES,n as MODULE_CONNECTED_MESSAGE_TYPE,D as serializeConnectedDevice,m as serializeDeviceSessionState,T as serializeDiscoveredDevice};
1
+ import{INSPECTOR_COMMAND_TYPES as r,INSPECTOR_MESSAGE_TYPES as t}from"./inspector/constants";import{DevToolsDmkInspector as p}from"./inspector/DevToolsDmkInspector";import{serializeConnectedDevice as S,serializeDeviceSessionState as s,serializeDiscoveredDevice as m}from"./inspector/serialization";import{LOGGER_MESSAGE_TYPES as i}from"./logger/constants";import{DevToolsLogger as l}from"./logger/DevToolsLogger";import{DEVTOOLS_MODULES as O,MODULE_CONNECTED_MESSAGE_TYPE as _}from"./modules";export{O as DEVTOOLS_MODULES,p as DevToolsDmkInspector,l as DevToolsLogger,r as INSPECTOR_COMMAND_TYPES,t as INSPECTOR_MESSAGE_TYPES,i as LOGGER_MESSAGE_TYPES,_ as MODULE_CONNECTED_MESSAGE_TYPE,S as serializeConnectedDevice,s as serializeDeviceSessionState,m as serializeDiscoveredDevice};
2
2
  //# sourceMappingURL=index.js.map
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../src/index.ts"],
4
- "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"],
5
- "mappings": "AAEA,OACE,2BAAAA,EACA,2BAAAC,MACK,wBACP,OAAS,wBAAAC,MAA4B,mCACrC,OACE,4BAAAC,EACA,+BAAAC,EACA,6BAAAC,MACK,4BAGP,OAAS,wBAAAC,MAA4B,qBAErC,OAAS,kBAAAC,MAAsB,0BAG/B,OACE,oBAAAC,EAEA,iCAAAC,MACK",
4
+ "sourcesContent": ["// Inspector module\nexport { type CommandHandlerContext } from \"./inspector/commandHandlers\";\nexport {\n INSPECTOR_COMMAND_TYPES,\n INSPECTOR_MESSAGE_TYPES,\n} from \"./inspector/constants\";\nexport {\n DevToolsDmkInspector,\n type DevToolsDmkInspectorOptions,\n} 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"],
5
+ "mappings": "AAEA,OACE,2BAAAA,EACA,2BAAAC,MACK,wBACP,OACE,wBAAAC,MAEK,mCACP,OACE,4BAAAC,EACA,+BAAAC,EACA,6BAAAC,MACK,4BAGP,OAAS,wBAAAC,MAA4B,qBAErC,OAAS,kBAAAC,MAAsB,0BAG/B,OACE,oBAAAC,EAEA,iCAAAC,MACK",
6
6
  "names": ["INSPECTOR_COMMAND_TYPES", "INSPECTOR_MESSAGE_TYPES", "DevToolsDmkInspector", "serializeConnectedDevice", "serializeDeviceSessionState", "serializeDiscoveredDevice", "LOGGER_MESSAGE_TYPES", "DevToolsLogger", "DEVTOOLS_MODULES", "MODULE_CONNECTED_MESSAGE_TYPE"]
7
7
  }
@@ -1,2 +1,2 @@
1
- import{DEVTOOLS_MODULES as n,MODULE_CONNECTED_MESSAGE_TYPE as o}from"../modules";import{handleConnectDevice as a,handleDisconnect as c,handleGetProvider as d,handleSendApdu as v,handleSetProvider as m}from"./commandHandlers";import{INSPECTOR_COMMAND_TYPES as e}from"./constants";import{createDeviceObserver as D}from"./deviceObserver";import{DiscoveryHandler as l}from"./DiscoveryHandler";class T{ctx;destroyDeviceObserver;discoveryHandler;commandListenerUnsubscribe=null;constructor(r,s){this.ctx={connector:r,dmk:s},r.sendMessage(o,JSON.stringify({module:n.DMK_INSPECTOR})),this.destroyDeviceObserver=D(s,r),this.discoveryHandler=new l(s,r),this.setupCommandListener()}destroy(){this.destroyDeviceObserver(),this.discoveryHandler.destroy(),this.commandListenerUnsubscribe&&(this.commandListenerUnsubscribe(),this.commandListenerUnsubscribe=null)}setupCommandListener(){const{unsubscribe:r}=this.ctx.connector.listenToMessages(async(s,t)=>{try{switch(s){case e.DISCONNECT:await c(this.ctx,t);break;case e.SEND_APDU:await v(this.ctx,t);break;case e.GET_PROVIDER:d(this.ctx);break;case e.SET_PROVIDER:m(this.ctx,t);break;case e.START_LISTENING_DEVICES:this.discoveryHandler.startListening();break;case e.STOP_LISTENING_DEVICES:this.discoveryHandler.stopListening();break;case e.START_DISCOVERING:this.discoveryHandler.startDiscovering();break;case e.STOP_DISCOVERING:this.discoveryHandler.stopDiscovering();break;case e.CONNECT_DEVICE:await a(this.ctx,t,this.discoveryHandler.discoveredDevices);break}}catch(i){console.error(`[DevToolsDmkInspector] Error handling command ${s}`,i)}});this.commandListenerUnsubscribe=r}}export{T as DevToolsDmkInspector};
1
+ import{DEVTOOLS_MODULES as n,MODULE_CONNECTED_MESSAGE_TYPE as o}from"../modules";import{handleConnectDevice as a,handleDisconnect as c,handleGetProvider as d,handleSendApdu as v,handleSetProvider as m}from"./commandHandlers";import{INSPECTOR_COMMAND_TYPES as e,INSPECTOR_MESSAGE_TYPES as D}from"./constants";import{createDeviceObserver as l}from"./deviceObserver";import{DiscoveryHandler as E}from"./DiscoveryHandler";class p{ctx;destroyDeviceObserver;discoveryHandler;commandListenerUnsubscribe=null;constructor(r,s,t={}){this.ctx={connector:r,dmk:s},r.sendMessage(o,JSON.stringify({module:n.DMK_INSPECTOR})),r.sendMessage(D.MOCK_SERVER_CONFIG,JSON.stringify(t.mockServer??null)),this.destroyDeviceObserver=l(s,r),this.discoveryHandler=new E(s,r),this.setupCommandListener()}destroy(){this.destroyDeviceObserver(),this.discoveryHandler.destroy(),this.commandListenerUnsubscribe&&(this.commandListenerUnsubscribe(),this.commandListenerUnsubscribe=null)}setupCommandListener(){const{unsubscribe:r}=this.ctx.connector.listenToMessages(async(s,t)=>{try{switch(s){case e.DISCONNECT:await c(this.ctx,t);break;case e.SEND_APDU:await v(this.ctx,t);break;case e.GET_PROVIDER:d(this.ctx);break;case e.SET_PROVIDER:m(this.ctx,t);break;case e.START_LISTENING_DEVICES:this.discoveryHandler.startListening();break;case e.STOP_LISTENING_DEVICES:this.discoveryHandler.stopListening();break;case e.START_DISCOVERING:this.discoveryHandler.startDiscovering();break;case e.STOP_DISCOVERING:this.discoveryHandler.stopDiscovering();break;case e.CONNECT_DEVICE:await a(this.ctx,t,this.discoveryHandler.discoveredDevices);break}}catch(i){console.error(`[DevToolsDmkInspector] Error handling command ${s}`,i)}});this.commandListenerUnsubscribe=r}}export{p as DevToolsDmkInspector};
2
2
  //# sourceMappingURL=DevToolsDmkInspector.js.map
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/inspector/DevToolsDmkInspector.ts"],
4
- "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"],
5
- "mappings": "AAEA,OAAS,oBAAAA,EAAkB,iCAAAC,MAAqC,aAEhE,OAEE,uBAAAC,EACA,oBAAAC,EACA,qBAAAC,EACA,kBAAAC,EACA,qBAAAC,MACK,oBACP,OAAS,2BAAAC,MAA+B,cACxC,OAAS,wBAAAC,MAA4B,mBACrC,OAAS,oBAAAC,MAAwB,qBAuB1B,MAAMC,CAAqB,CACf,IACA,sBACA,iBACT,2BAAkD,KAE1D,YAAYC,EAAsBC,EAA0B,CAC1D,KAAK,IAAM,CAAE,UAAAD,EAAW,IAAAC,CAAI,EAG5BD,EAAU,YACRV,EACA,KAAK,UAAU,CAAE,OAAQD,EAAiB,aAAc,CAAC,CAC3D,EAGA,KAAK,sBAAwBQ,EAAqBI,EAAKD,CAAS,EAGhE,KAAK,iBAAmB,IAAIF,EAAiBG,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,KAAKP,EAAwB,WAC3B,MAAMJ,EAAiB,KAAK,IAAKY,CAAO,EACxC,MACF,KAAKR,EAAwB,UAC3B,MAAMF,EAAe,KAAK,IAAKU,CAAO,EACtC,MACF,KAAKR,EAAwB,aAC3BH,EAAkB,KAAK,GAAG,EAC1B,MACF,KAAKG,EAAwB,aAC3BD,EAAkB,KAAK,IAAKS,CAAO,EACnC,MACF,KAAKR,EAAwB,wBAC3B,KAAK,iBAAiB,eAAe,EACrC,MACF,KAAKA,EAAwB,uBAC3B,KAAK,iBAAiB,cAAc,EACpC,MACF,KAAKA,EAAwB,kBAC3B,KAAK,iBAAiB,iBAAiB,EACvC,MACF,KAAKA,EAAwB,iBAC3B,KAAK,iBAAiB,gBAAgB,EACtC,MACF,KAAKA,EAAwB,eAC3B,MAAML,EACJ,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",
6
- "names": ["DEVTOOLS_MODULES", "MODULE_CONNECTED_MESSAGE_TYPE", "handleConnectDevice", "handleDisconnect", "handleGetProvider", "handleSendApdu", "handleSetProvider", "INSPECTOR_COMMAND_TYPES", "createDeviceObserver", "DiscoveryHandler", "DevToolsDmkInspector", "connector", "dmk", "unsubscribe", "type", "payload", "error"]
4
+ "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, INSPECTOR_MESSAGE_TYPES } from \"./constants\";\nimport { createDeviceObserver } from \"./deviceObserver\";\nimport { DiscoveryHandler } from \"./DiscoveryHandler\";\n\nexport type DevToolsDmkInspectorOptions = {\n /**\n * The mock server the app's mock transport talks to. The dashboard uses it to\n * show the live screen of mock devices.\n */\n mockServer?: { url: string; sessionToken?: string };\n};\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 * - Mock server: share its URL and session with the dashboard\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(\n connector: Connector,\n dmk: DeviceManagementKit,\n options: DevToolsDmkInspectorOptions = {},\n ) {\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 // Sent even when absent, so the dashboard drops a previous app's mock server\n connector.sendMessage(\n INSPECTOR_MESSAGE_TYPES.MOCK_SERVER_CONFIG,\n JSON.stringify(options.mockServer ?? null),\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"],
5
+ "mappings": "AAEA,OAAS,oBAAAA,EAAkB,iCAAAC,MAAqC,aAEhE,OAEE,uBAAAC,EACA,oBAAAC,EACA,qBAAAC,EACA,kBAAAC,EACA,qBAAAC,MACK,oBACP,OAAS,2BAAAC,EAAyB,2BAAAC,MAA+B,cACjE,OAAS,wBAAAC,MAA4B,mBACrC,OAAS,oBAAAC,MAAwB,qBAgC1B,MAAMC,CAAqB,CACf,IACA,sBACA,iBACT,2BAAkD,KAE1D,YACEC,EACAC,EACAC,EAAuC,CAAC,EACxC,CACA,KAAK,IAAM,CAAE,UAAAF,EAAW,IAAAC,CAAI,EAG5BD,EAAU,YACRX,EACA,KAAK,UAAU,CAAE,OAAQD,EAAiB,aAAc,CAAC,CAC3D,EAGAY,EAAU,YACRJ,EAAwB,mBACxB,KAAK,UAAUM,EAAQ,YAAc,IAAI,CAC3C,EAGA,KAAK,sBAAwBL,EAAqBI,EAAKD,CAAS,EAGhE,KAAK,iBAAmB,IAAIF,EAAiBG,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,YAAAG,CAAY,EAAI,KAAK,IAAI,UAAU,iBACzC,MAAOC,EAAMC,IAAY,CACvB,GAAI,CACF,OAAQD,EAAM,CACZ,KAAKT,EAAwB,WAC3B,MAAMJ,EAAiB,KAAK,IAAKc,CAAO,EACxC,MACF,KAAKV,EAAwB,UAC3B,MAAMF,EAAe,KAAK,IAAKY,CAAO,EACtC,MACF,KAAKV,EAAwB,aAC3BH,EAAkB,KAAK,GAAG,EAC1B,MACF,KAAKG,EAAwB,aAC3BD,EAAkB,KAAK,IAAKW,CAAO,EACnC,MACF,KAAKV,EAAwB,wBAC3B,KAAK,iBAAiB,eAAe,EACrC,MACF,KAAKA,EAAwB,uBAC3B,KAAK,iBAAiB,cAAc,EACpC,MACF,KAAKA,EAAwB,kBAC3B,KAAK,iBAAiB,iBAAiB,EACvC,MACF,KAAKA,EAAwB,iBAC3B,KAAK,iBAAiB,gBAAgB,EACtC,MACF,KAAKA,EAAwB,eAC3B,MAAML,EACJ,KAAK,IACLe,EACA,KAAK,iBAAiB,iBACxB,EACA,KACJ,CACF,OAASC,EAAO,CACd,QAAQ,MACN,iDAAiDF,CAAI,GACrDE,CACF,CACF,CACF,CACF,EACA,KAAK,2BAA6BH,CACpC,CACF",
6
+ "names": ["DEVTOOLS_MODULES", "MODULE_CONNECTED_MESSAGE_TYPE", "handleConnectDevice", "handleDisconnect", "handleGetProvider", "handleSendApdu", "handleSetProvider", "INSPECTOR_COMMAND_TYPES", "INSPECTOR_MESSAGE_TYPES", "createDeviceObserver", "DiscoveryHandler", "DevToolsDmkInspector", "connector", "dmk", "options", "unsubscribe", "type", "payload", "error"]
7
7
  }
@@ -1,2 +1,2 @@
1
- const E={CONNECTED_DEVICES_UPDATE:"connectedDevicesUpdate",DEVICE_SESSION_STATE_UPDATE:"deviceSessionStateUpdate",PROVIDER_VALUE:"providerValue",APDU_RESPONSE:"apduResponse",DISCOVERED_DEVICES_UPDATE:"discoveredDevicesUpdate"},e={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"};export{e as INSPECTOR_COMMAND_TYPES,E as INSPECTOR_MESSAGE_TYPES};
1
+ const E={CONNECTED_DEVICES_UPDATE:"connectedDevicesUpdate",DEVICE_SESSION_STATE_UPDATE:"deviceSessionStateUpdate",PROVIDER_VALUE:"providerValue",APDU_RESPONSE:"apduResponse",DISCOVERED_DEVICES_UPDATE:"discoveredDevicesUpdate",MOCK_SERVER_CONFIG:"mockServerConfig"},e={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"};export{e as INSPECTOR_COMMAND_TYPES,E as INSPECTOR_MESSAGE_TYPES};
2
2
  //# sourceMappingURL=constants.js.map
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/inspector/constants.ts"],
4
- "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"],
5
- "mappings": "AAGO,MAAMA,EAA0B,CAErC,yBAA0B,yBAE1B,4BAA6B,2BAE7B,eAAgB,gBAEhB,cAAe,eAEf,0BAA2B,yBAC7B,EAKaC,EAA0B,CAErC,WAAY,aAEZ,UAAW,WAEX,aAAc,cAEd,aAAc,cAEd,wBAAyB,wBAEzB,uBAAwB,uBAExB,kBAAmB,mBAEnB,iBAAkB,kBAElB,eAAgB,eAClB",
4
+ "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 /** Mock server the app's transport talks to, so the dashboard can show its device screens */\n MOCK_SERVER_CONFIG: \"mockServerConfig\",\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"],
5
+ "mappings": "AAGO,MAAMA,EAA0B,CAErC,yBAA0B,yBAE1B,4BAA6B,2BAE7B,eAAgB,gBAEhB,cAAe,eAEf,0BAA2B,0BAE3B,mBAAoB,kBACtB,EAKaC,EAA0B,CAErC,WAAY,aAEZ,UAAW,WAEX,aAAc,cAEd,aAAc,cAEd,wBAAyB,wBAEzB,uBAAwB,uBAExB,kBAAmB,mBAEnB,iBAAkB,kBAElB,eAAgB,eAClB",
6
6
  "names": ["INSPECTOR_MESSAGE_TYPES", "INSPECTOR_COMMAND_TYPES"]
7
7
  }
@@ -1,6 +1,6 @@
1
1
  export { type CommandHandlerContext } from "./inspector/commandHandlers";
2
2
  export { INSPECTOR_COMMAND_TYPES, INSPECTOR_MESSAGE_TYPES, } from "./inspector/constants";
3
- export { DevToolsDmkInspector } from "./inspector/DevToolsDmkInspector";
3
+ export { DevToolsDmkInspector, type DevToolsDmkInspectorOptions, } from "./inspector/DevToolsDmkInspector";
4
4
  export { serializeConnectedDevice, serializeDeviceSessionState, serializeDiscoveredDevice, } from "./inspector/serialization";
5
5
  export { LOGGER_MESSAGE_TYPES } from "./logger/constants";
6
6
  export { type DevToolsLog } from "./logger/DevToolsLog";
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGzD,OAAO,EACL,gBAAgB,EAChB,KAAK,cAAc,EACnB,6BAA6B,GAC9B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,oBAAoB,EACpB,KAAK,2BAA2B,GACjC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGzD,OAAO,EACL,gBAAgB,EAChB,KAAK,cAAc,EACnB,6BAA6B,GAC9B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC"}
@@ -1,5 +1,15 @@
1
1
  import { type DeviceManagementKit } from "@ledgerhq/device-management-kit";
2
2
  import { type Connector } from "../types";
3
+ export type DevToolsDmkInspectorOptions = {
4
+ /**
5
+ * The mock server the app's mock transport talks to. The dashboard uses it to
6
+ * show the live screen of mock devices.
7
+ */
8
+ mockServer?: {
9
+ url: string;
10
+ sessionToken?: string;
11
+ };
12
+ };
3
13
  /**
4
14
  * DevToolsDmkInspector enables the devtools dashboard to inspect and interact
5
15
  * with the Device Management Kit.
@@ -8,6 +18,7 @@ import { type Connector } from "../types";
8
18
  * - Device sessions: list connected devices, observe session states
9
19
  * - Actions: disconnect sessions, send APDUs
10
20
  * - Configuration: get/set provider
21
+ * - Mock server: share its URL and session with the dashboard
11
22
  *
12
23
  * @example
13
24
  * ```ts
@@ -26,7 +37,7 @@ export declare class DevToolsDmkInspector {
26
37
  private readonly destroyDeviceObserver;
27
38
  private readonly discoveryHandler;
28
39
  private commandListenerUnsubscribe;
29
- constructor(connector: Connector, dmk: DeviceManagementKit);
40
+ constructor(connector: Connector, dmk: DeviceManagementKit, options?: DevToolsDmkInspectorOptions);
30
41
  /**
31
42
  * Clean up subscriptions and listeners.
32
43
  */
@@ -1 +1 @@
1
- {"version":3,"file":"DevToolsDmkInspector.d.ts","sourceRoot":"","sources":["../../../../src/inspector/DevToolsDmkInspector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAG3E,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAa1C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAwB;IAC5C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAa;IACnD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,0BAA0B,CAA6B;gBAEnD,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,mBAAmB;IAmB1D;;OAEG;IACH,OAAO,IAAI,IAAI;IAUf;;OAEG;IACH,OAAO,CAAC,oBAAoB;CA+C7B"}
1
+ {"version":3,"file":"DevToolsDmkInspector.d.ts","sourceRoot":"","sources":["../../../../src/inspector/DevToolsDmkInspector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAG3E,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAa1C,MAAM,MAAM,2BAA2B,GAAG;IACxC;;;OAGG;IACH,UAAU,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAwB;IAC5C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAa;IACnD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,0BAA0B,CAA6B;gBAG7D,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,mBAAmB,EACxB,OAAO,GAAE,2BAAgC;IA0B3C;;OAEG;IACH,OAAO,IAAI,IAAI;IAUf;;OAEG;IACH,OAAO,CAAC,oBAAoB;CA+C7B"}
@@ -12,6 +12,8 @@ export declare const INSPECTOR_MESSAGE_TYPES: {
12
12
  readonly APDU_RESPONSE: "apduResponse";
13
13
  /** List of discovered (available) devices updated */
14
14
  readonly DISCOVERED_DEVICES_UPDATE: "discoveredDevicesUpdate";
15
+ /** Mock server the app's transport talks to, so the dashboard can show its device screens */
16
+ readonly MOCK_SERVER_CONFIG: "mockServerConfig";
15
17
  };
16
18
  /**
17
19
  * Message types sent from dashboard to inspector (commands)
@@ -1 +1 @@
1
- {"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/inspector/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,uBAAuB;IAClC,4CAA4C;;IAE5C,qCAAqC;;IAErC,wCAAwC;;IAExC,qCAAqC;;IAErC,qDAAqD;;CAE7C,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,uBAAuB;IAClC,sCAAsC;;IAEtC,8BAA8B;;IAE9B,sCAAsC;;IAEtC,8BAA8B;;IAE9B,2FAA2F;;IAE3F,sDAAsD;;IAEtD,2GAA2G;;IAE3G,0CAA0C;;IAE1C,gDAAgD;;CAExC,CAAC"}
1
+ {"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/inspector/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,uBAAuB;IAClC,4CAA4C;;IAE5C,qCAAqC;;IAErC,wCAAwC;;IAExC,qCAAqC;;IAErC,qDAAqD;;IAErD,6FAA6F;;CAErF,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,uBAAuB;IAClC,sCAAsC;;IAEtC,8BAA8B;;IAE9B,sCAAsC;;IAEtC,8BAA8B;;IAE9B,2FAA2F;;IAE3F,sDAAsD;;IAEtD,2GAA2G;;IAE3G,0CAA0C;;IAE1C,gDAAgD;;CAExC,CAAC"}