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

package/lib/types/src/inspector/DiscoveryHandler.d.ts

@@ -0,0 +1,67 @@
+import { type DeviceManagementKit, type DiscoveredDevice } from "@ledgerhq/device-management-kit";
+import { type Connector } from "../types";
+/**
+ * Handles device discovery operations for the devtools inspector.
+ * Encapsulates both passive listening and active discovery modes.
+ *
+ * @example
+ * ```ts
+ * const handler = new DiscoveryHandler(dmk, connector);
+ *
+ * // Start passive listening (no user gesture required)
+ * handler.startListening();
+ *
+ * // Or start active discovery (triggers permission prompt in web)
+ * handler.startDiscovering();
+ *
+ * // Get current discovered devices
+ * const devices = handler.discoveredDevices;
+ *
+ * // Clean up
+ * handler.destroy();
+ * ```
+ */
+export declare class DiscoveryHandler {
+    private readonly dmk;
+    private readonly connector;
+    private stopListeningFn;
+    private stopDiscoveringFn;
+    private _discoveredDevices;
+    constructor(dmk: DeviceManagementKit, connector: Connector);
+    /**
+     * Get the current list of discovered devices.
+     */
+    get discoveredDevices(): DiscoveredDevice[];
+    /**
+     * Whether passive listening is currently active.
+     */
+    get isListening(): boolean;
+    /**
+     * Whether active discovery is currently active.
+     */
+    get isDiscovering(): boolean;
+    /**
+     * Start passive listening for available devices.
+     * Does NOT trigger permission prompts - works with already-paired devices.
+     */
+    startListening(): void;
+    /**
+     * Stop passive listening for available devices.
+     */
+    stopListening(): void;
+    /**
+     * Start active device discovery.
+     * NOTE: In web apps (WebHID/WebBLE), this requires a user gesture in the app context.
+     * Calling this from the dashboard will NOT work for web apps.
+     */
+    startDiscovering(): void;
+    /**
+     * Stop active device discovery.
+     */
+    stopDiscovering(): void;
+    /**
+     * Clean up all discovery operations.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=DiscoveryHandler.d.ts.map

package/lib/types/src/inspector/DiscoveryHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiscoveryHandler.d.ts","sourceRoot":"","sources":["../../../../src/inspector/DiscoveryHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACtB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAM1C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAsB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IAEtC,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,kBAAkB,CAA0B;gBAExC,GAAG,EAAE,mBAAmB,EAAE,SAAS,EAAE,SAAS;IAK1D;;OAEG;IACH,IAAI,iBAAiB,IAAI,gBAAgB,EAAE,CAE1C;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;;OAGG;IACH,cAAc,IAAI,IAAI;IActB;;OAEG;IACH,aAAa,IAAI,IAAI;IAQrB;;;;OAIG;IACH,gBAAgB,IAAI,IAAI;IAcxB;;OAEG;IACH,eAAe,IAAI,IAAI;IAQvB;;OAEG;IACH,OAAO,IAAI,IAAI;CAIhB"}

package/lib/types/src/inspector/commandHandlers.d.ts

@@ -0,0 +1,34 @@
+import { type DeviceManagementKit, type DiscoveredDevice } from "@ledgerhq/device-management-kit";
+import { type Connector } from "../types";
+/**
+ * Context passed to command handlers.
+ */
+export type CommandHandlerContext = {
+    dmk: DeviceManagementKit;
+    connector: Connector;
+};
+/**
+ * Handle disconnect command - disconnects a device session.
+ */
+export declare function handleDisconnect(ctx: CommandHandlerContext, payload: string): Promise<void>;
+/**
+ * Handle sendApdu command - sends a raw APDU to a device.
+ */
+export declare function handleSendApdu(ctx: CommandHandlerContext, payload: string): Promise<void>;
+/**
+ * Handle getProvider command - returns the current provider value.
+ */
+export declare function handleGetProvider(ctx: CommandHandlerContext): void;
+/**
+ * Handle setProvider command - sets the provider value and confirms.
+ */
+export declare function handleSetProvider(ctx: CommandHandlerContext, payload: string): void;
+/**
+ * Handle connectDevice command - connects to a discovered device.
+ *
+ * @param ctx - Command handler context
+ * @param payload - JSON payload containing deviceId and optional sessionRefresherOptions
+ * @param discoveredDevices - Current list of discovered devices to find the device
+ */
+export declare function handleConnectDevice(ctx: CommandHandlerContext, payload: string, discoveredDevices: DiscoveredDevice[]): Promise<void>;
+//# sourceMappingURL=commandHandlers.d.ts.map

package/lib/types/src/inspector/commandHandlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandHandlers.d.ts","sourceRoot":"","sources":["../../../../src/inspector/commandHandlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EAExB,KAAK,gBAAgB,EACtB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAG1C;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,GAAG,EAAE,mBAAmB,CAAC;IACzB,SAAS,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,qBAAqB,EAC1B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,qBAAqB,EAC1B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,qBAAqB,GAAG,IAAI,CAMlE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,qBAAqB,EAC1B,OAAO,EAAE,MAAM,GACd,IAAI,CAKN;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,qBAAqB,EAC1B,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,gBAAgB,EAAE,GACpC,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

package/lib/types/src/inspector/constants.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Message types sent from inspector to dashboard
+ */
+export declare const INSPECTOR_MESSAGE_TYPES: {
+    /** List of all connected devices updated */
+    readonly CONNECTED_DEVICES_UPDATE: "connectedDevicesUpdate";
+    /** A device session state updated */
+    readonly DEVICE_SESSION_STATE_UPDATE: "deviceSessionStateUpdate";
+    /** Response to a getProvider request */
+    readonly PROVIDER_VALUE: "providerValue";
+    /** Response to a sendApdu request */
+    readonly APDU_RESPONSE: "apduResponse";
+    /** List of discovered (available) devices updated */
+    readonly DISCOVERED_DEVICES_UPDATE: "discoveredDevicesUpdate";
+};
+/**
+ * Message types sent from dashboard to inspector (commands)
+ */
+export declare const INSPECTOR_COMMAND_TYPES: {
+    /** Request to disconnect a session */
+    readonly DISCONNECT: "disconnect";
+    /** Request to send an APDU */
+    readonly SEND_APDU: "sendApdu";
+    /** Request to get current provider */
+    readonly GET_PROVIDER: "getProvider";
+    /** Request to set provider */
+    readonly SET_PROVIDER: "setProvider";
+    /** Request to start listening for available devices (passive, no user gesture required) */
+    readonly START_LISTENING_DEVICES: "startListeningDevices";
+    /** Request to stop listening for available devices */
+    readonly STOP_LISTENING_DEVICES: "stopListeningDevices";
+    /** Request to start discovering devices (triggers permission prompt, requires user gesture in web apps) */
+    readonly START_DISCOVERING: "startDiscovering";
+    /** Request to stop discovering devices */
+    readonly STOP_DISCOVERING: "stopDiscovering";
+    /** Request to connect to a discovered device */
+    readonly CONNECT_DEVICE: "connectDevice";
+};
+//# sourceMappingURL=constants.d.ts.map

package/lib/types/src/inspector/constants.d.ts.map

@@ -0,0 +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"}

package/lib/types/src/inspector/deviceObserver.d.ts

@@ -0,0 +1,16 @@
+import { type DeviceManagementKit, type DeviceSessionId, type DeviceSessionState } from "@ledgerhq/device-management-kit";
+import { type Connector } from "../types";
+/**
+ * Sends the current list of connected devices to the dashboard.
+ */
+export declare function sendConnectedDevicesUpdate(dmk: DeviceManagementKit, connector: Connector): void;
+/**
+ * Sends a device session state update to the dashboard.
+ */
+export declare function sendSessionStateUpdate(connector: Connector, sessionId: DeviceSessionId, state: DeviceSessionState): void;
+/**
+ * Creates a device observer that tracks connected devices and their session states.
+ * Returns a cleanup function to unsubscribe from all observations.
+ */
+export declare function createDeviceObserver(dmk: DeviceManagementKit, connector: Connector): () => void;
+//# sourceMappingURL=deviceObserver.d.ts.map

package/lib/types/src/inspector/deviceObserver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceObserver.d.ts","sourceRoot":"","sources":["../../../../src/inspector/deviceObserver.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACxB,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAO1C;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,mBAAmB,EACxB,SAAS,EAAE,SAAS,GACnB,IAAI,CAMN;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,kBAAkB,GACxB,IAAI,CAQN;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,mBAAmB,EACxB,SAAS,EAAE,SAAS,GACnB,MAAM,IAAI,CAiEZ"}

package/lib/types/src/inspector/discoveryObserver.d.ts

@@ -0,0 +1,34 @@
+import { type DeviceManagementKit, type DiscoveredDevice } from "@ledgerhq/device-management-kit";
+import { type Connector } from "../types";
+/**
+ * Callback type for when discovered devices are updated.
+ */
+export type OnDiscoveredDevicesUpdate = (devices: DiscoveredDevice[]) => void;
+/**
+ * Sends the list of discovered devices to the dashboard.
+ */
+export declare function sendDiscoveredDevicesUpdate(devices: DiscoveredDevice[], connector: Connector): void;
+/**
+ * Starts listening to available devices (passive discovery).
+ * Uses listenToAvailableDevices which returns the current list of known devices.
+ * Does NOT trigger permission prompts - works with already-paired devices.
+ *
+ * @param dmk - The Device Management Kit instance
+ * @param connector - The connector to send messages to the dashboard
+ * @param onDevicesUpdate - Optional callback when devices are updated (used to track current devices)
+ * @returns A cleanup function to stop listening
+ */
+export declare function startListeningObserver(dmk: DeviceManagementKit, connector: Connector, onDevicesUpdate?: OnDiscoveredDevicesUpdate): () => void;
+/**
+ * Starts active device discovery.
+ * Uses startDiscovering which triggers permission prompts in web apps.
+ * NOTE: In web apps (WebHID/WebBLE), this requires a user gesture in the app context.
+ * Calling this from the dashboard will NOT work for web apps.
+ *
+ * @param dmk - The Device Management Kit instance
+ * @param connector - The connector to send messages to the dashboard
+ * @param onDevicesUpdate - Optional callback when devices are updated (used to track current devices)
+ * @returns A cleanup function to stop discovering
+ */
+export declare function startDiscoveringObserver(dmk: DeviceManagementKit, connector: Connector, onDevicesUpdate?: OnDiscoveredDevicesUpdate): () => void;
+//# sourceMappingURL=discoveryObserver.d.ts.map

package/lib/types/src/inspector/discoveryObserver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discoveryObserver.d.ts","sourceRoot":"","sources":["../../../../src/inspector/discoveryObserver.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACtB,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAI1C;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,IAAI,CAAC;AAE9E;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,gBAAgB,EAAE,EAC3B,SAAS,EAAE,SAAS,GACnB,IAAI,CAKN;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,mBAAmB,EACxB,SAAS,EAAE,SAAS,EACpB,eAAe,CAAC,EAAE,yBAAyB,GAC1C,MAAM,IAAI,CAuBZ;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,mBAAmB,EACxB,SAAS,EAAE,SAAS,EACpB,eAAe,CAAC,EAAE,yBAAyB,GAC1C,MAAM,IAAI,CAkCZ"}

package/lib/types/src/inspector/serialization.d.ts

@@ -0,0 +1,15 @@
+import { type ConnectedDevice, type DeviceSessionState, type DiscoveredDevice } from "@ledgerhq/device-management-kit";
+/**
+ * Serialize a ConnectedDevice to a plain object for JSON transmission.
+ */
+export declare function serializeConnectedDevice(device: ConnectedDevice): ConnectedDevice;
+/**
+ * Serialize a DeviceSessionState to a plain object for JSON transmission.
+ * Converts enum values to their string names for readability.
+ */
+export declare function serializeDeviceSessionState(state: DeviceSessionState): DeviceSessionState;
+/**
+ * Serialize a DiscoveredDevice to a plain object for JSON transmission.
+ */
+export declare function serializeDiscoveredDevice(device: DiscoveredDevice): DiscoveredDevice;
+//# sourceMappingURL=serialization.d.ts.map

package/lib/types/src/inspector/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../../../src/inspector/serialization.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,kBAAkB,EAEvB,KAAK,gBAAgB,EACtB,MAAM,iCAAiC,CAAC;AAEzC;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,eAAe,GACtB,eAAe,CAEjB;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,kBAAkB,GACxB,kBAAkB,CASpB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,gBAAgB,GACvB,gBAAgB,CAElB"}

package/lib/types/src/logger/DevToolsLog.d.ts

@@ -0,0 +1,9 @@
+export type DevToolsLog = {
+    /** ISO 8601 timestamp */
+    timestamp: string;
+    tag: string;
+    verbosity: "debug" | "info" | "warning" | "error" | "fatal";
+    message: string;
+    payloadJSON: string;
+};
+//# sourceMappingURL=DevToolsLog.d.ts.map

package/lib/types/src/logger/DevToolsLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevToolsLog.d.ts","sourceRoot":"","sources":["../../../../src/logger/DevToolsLog.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG;IACxB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC"}

package/lib/types/src/logger/DevToolsLogger.d.ts

@@ -0,0 +1,8 @@
+import { type LoggerSubscriberService, type LogParams } from "@ledgerhq/device-management-kit";
+import { type Connector } from "../types";
+export declare class DevToolsLogger implements LoggerSubscriberService {
+    private readonly connector;
+    constructor(connector: Connector);
+    log(...logParams: LogParams): void;
+}
+//# sourceMappingURL=DevToolsLogger.d.ts.map

package/lib/types/src/logger/DevToolsLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevToolsLogger.d.ts","sourceRoot":"","sources":["../../../../src/logger/DevToolsLogger.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,SAAS,EACf,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAI1C,qBAAa,cAAe,YAAW,uBAAuB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAQjD,GAAG,CAAC,GAAG,SAAS,EAAE,SAAS,GAAG,IAAI;CAMnC"}

package/lib/types/src/logger/constants.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Message types sent from logger to dashboard
+ */
+export declare const LOGGER_MESSAGE_TYPES: {
+    /** A new log entry */
+    readonly ADD_LOG: "addLog";
+};
+//# sourceMappingURL=constants.d.ts.map

package/lib/types/src/logger/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/logger/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,oBAAoB;IAC/B,sBAAsB;;CAEd,CAAC"}

package/lib/types/src/logger/mapDmkLogToDevToolsLog.d.ts

@@ -0,0 +1,4 @@
+import { type LogParams } from "@ledgerhq/device-management-kit";
+import { type DevToolsLog } from "./DevToolsLog";
+export declare function mapDmkLogToDevToolsLog(dmkLog: LogParams): DevToolsLog;
+//# sourceMappingURL=mapDmkLogToDevToolsLog.d.ts.map

package/lib/types/src/logger/mapDmkLogToDevToolsLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapDmkLogToDevToolsLog.d.ts","sourceRoot":"","sources":["../../../../src/logger/mapDmkLogToDevToolsLog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAE3E,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,WAAW,CAyBrE"}

package/lib/types/src/modules.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Module identifiers for devtools handshake.
+ * Used by both client modules and dashboard UI to track which modules are connected.
+ */
+export declare const DEVTOOLS_MODULES: {
+    readonly LOGGER: "logger";
+    readonly DMK_INSPECTOR: "dmk-inspector";
+};
+export type DevToolsModule = (typeof DEVTOOLS_MODULES)[keyof typeof DEVTOOLS_MODULES];
+/**
+ * Message type for module connection handshake.
+ */
+export declare const MODULE_CONNECTED_MESSAGE_TYPE = "moduleConnected";
+//# sourceMappingURL=modules.d.ts.map

package/lib/types/src/modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.d.ts","sourceRoot":"","sources":["../../../src/modules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;CAGnB,CAAC;AAEX,MAAM,MAAM,cAAc,GACxB,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,6BAA6B,oBAAoB,CAAC"}

package/lib/types/src/types.d.ts

@@ -0,0 +1,7 @@
+export interface Connector {
+    sendMessage: (type: string, payload: string) => void;
+    listenToMessages: (listener: (type: string, payload: string) => void) => {
+        unsubscribe: () => void;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,gBAAgB,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,KAAK;QACvE,WAAW,EAAE,MAAM,IAAI,CAAC;KACzB,CAAC;CACH"}