@ledgerhq/device-mockserver-client 0.0.0-develop-20260622003722 → 0.0.0-develop-20260624002956

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

@@ -1,14 +1,72 @@
-export type DeviceArgs = {
-    readonly id: string;
+import { Codec } from "purify-ts";
+import { type MockConfig } from "./Mock";
+export type DeviceConnectivityType = "USB" | "BLE";
+export interface DeviceApp {
     readonly name: string;
-    readonly device_type: string;
-    readonly connectivity_type: string;
-};
-export declare class Device {
+    readonly version: string;
+}
+export declare const deviceAppCodec: Codec<{
+    name: string;
+    version: string;
+}>;
+/**
+ * A mocked device attached to a session.
+ *
+ * The device exposes rich metadata (firmware
+ * version, installed applications, memory masks) so DMK can build a realistic
+ * device session.
+ */
+export interface Device {
     readonly id: string;
     readonly name: string;
+    /** DeviceModelId enum value, e.g. "nanoX", "stax", "flex". */
     readonly device_type: string;
     readonly connectivity_type: string;
-    constructor({ id, name, device_type, connectivity_type }: DeviceArgs);
+    readonly firmware_version?: string;
+    readonly apps?: DeviceApp[];
+    readonly masks?: number[];
+    readonly connected?: boolean;
+}
+export declare const deviceCodec: Codec<{
+    id: string;
+    name: string;
+    device_type: string;
+    connectivity_type: string;
+    firmware_version: string | undefined;
+    apps: {
+        name: string;
+        version: string;
+    }[] | undefined;
+    masks: number[] | undefined;
+    connected: boolean | undefined;
+}>;
+/**
+ * Payload used to attach (POST /devices) or edit (PATCH /devices/:id) a device.
+ */
+export interface DeviceConfig {
+    readonly name?: string;
+    readonly device_type?: string;
+    readonly connectivity_type?: string;
+    readonly firmware_version?: string;
+    readonly apps?: DeviceApp[];
+    readonly masks?: number[];
+    /** Device-scoped APDU mocks, used when attaching (POST) or importing a device. */
+    readonly mocks?: MockConfig[];
 }
+export declare const deviceConfigCodec: Codec<{
+    name: string | undefined;
+    device_type: string | undefined;
+    connectivity_type: string | undefined;
+    firmware_version: string | undefined;
+    apps: {
+        name: string;
+        version: string;
+    }[] | undefined;
+    masks: number[] | undefined;
+    mocks: {
+        prefix: string;
+        response: string | undefined;
+        responses: string[] | undefined;
+    }[] | undefined;
+}>;
 //# sourceMappingURL=Device.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Device.d.ts","sourceRoot":"","sources":["../../../../src/model/Device.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC,CAAC;AAEF,qBAAa,MAAM;IACjB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;gBAEvB,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,iBAAiB,EAAE,EAAE,UAAU;CAMrE"}
+{"version":3,"file":"Device.d.ts","sourceRoot":"","sources":["../../../../src/model/Device.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,EAA4B,MAAM,WAAW,CAAC;AAE5E,OAAO,EAAE,KAAK,UAAU,EAAmB,MAAM,QAAQ,CAAC;AAE1D,MAAM,MAAM,sBAAsB,GAAG,KAAK,GAAG,KAAK,CAAC;AAEnD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,cAAc;;;EAGzB,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,eAAO,MAAM,WAAW;;;;;;;;;;;;EAStB,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,kFAAkF;IAClF,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;CAC/B;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;EAQ5B,CAAC"}

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

@@ -1,10 +1,36 @@
-export type MockArgs = {
+import { Codec } from "purify-ts";
+/**
+ * A canned APDU response registered against a device.
+ *
+ * Whenever an incoming APDU starts with {@link Mock.prefix} (hex), the mock
+ * server returns the next entry of {@link Mock.responses}, advancing one entry
+ * per matching APDU and looping back to the start once the list is exhausted.
+ * Mocks are device-scoped: each device owns its own independent mock table.
+ */
+export interface Mock {
+    readonly id: string;
     readonly prefix: string;
-    readonly response: string;
-};
-export declare class Mock {
+    readonly responses: string[];
+}
+export declare const mockCodec: Codec<{
+    id: string;
+    prefix: string;
+    responses: string[];
+}>;
+/**
+ * Payload used to create (POST /mocks) or edit (PATCH /mocks/:id) a mock.
+ *
+ * Provide either an ordered {@link MockConfig.responses} list or a single
+ * {@link MockConfig.response} (shorthand for `responses: [response]`).
+ */
+export interface MockConfig {
     readonly prefix: string;
-    readonly response: string;
-    constructor({ prefix, response }: MockArgs);
+    readonly response?: string;
+    readonly responses?: string[];
 }
+export declare const mockConfigCodec: Codec<{
+    prefix: string;
+    response: string | undefined;
+    responses: string[] | undefined;
+}>;
 //# sourceMappingURL=Mock.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Mock.d.ts","sourceRoot":"","sources":["../../../../src/model/Mock.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,qBAAa,IAAI;IACf,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,QAAQ;CAI3C"}
+{"version":3,"file":"Mock.d.ts","sourceRoot":"","sources":["../../../../src/model/Mock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,EAAoB,MAAM,WAAW,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,eAAO,MAAM,SAAS;;;;EAIpB,CAAC;AAEH;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,eAAO,MAAM,eAAe;;;;EAI1B,CAAC"}

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

@@ -1,15 +1,32 @@
+import { Codec } from "purify-ts";
 import { type Device } from "./Device";
-export type SessionArgs = {
+/**
+ * A mock server session, resolved from a bearer token.
+ *
+ * All devices and mocks are scoped to the session that owns the token.
+ */
+export interface Session {
     readonly id: string;
-    readonly device: Device;
-    readonly current_app: string;
     readonly created_at: number;
-};
-export declare class Session {
-    readonly id: string;
-    readonly device: Device;
-    readonly currentApp: string;
-    readonly created_at: number;
-    constructor({ id, device, current_app, created_at }: SessionArgs);
+    readonly expires_at: number;
+    readonly devices: Device[];
 }
+export declare const sessionCodec: Codec<{
+    id: string;
+    created_at: number;
+    expires_at: number;
+    devices: {
+        id: string;
+        name: string;
+        device_type: string;
+        connectivity_type: string;
+        firmware_version: string | undefined;
+        apps: {
+            name: string;
+            version: string;
+        }[] | undefined;
+        masks: number[] | undefined;
+        connected: boolean | undefined;
+    }[];
+}>;
 //# sourceMappingURL=Session.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Session.d.ts","sourceRoot":"","sources":["../../../../src/model/Session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,qBAAa,OAAO;IAClB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,WAAW;CAMjE"}
+{"version":3,"file":"Session.d.ts","sourceRoot":"","sources":["../../../../src/model/Session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,EAAkB,MAAM,WAAW,CAAC;AAEzD,OAAO,EAAE,KAAK,MAAM,EAAe,MAAM,UAAU,CAAC;AAEpD;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;EAKvB,CAAC"}

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

@@ -0,0 +1,32 @@
+import { Codec } from "purify-ts";
+import { type DeviceConfig } from "./Device";
+/**
+ * A portable snapshot of a session's devices (and their mocks).
+ *
+ * Produced by `GET /export` and consumed by `POST /import` to save and restore
+ * complex scenarios. Only configuration is captured (no ids, connection state
+ * or response cursors), so importing recreates a fresh, deterministic session
+ * state. Mocks are nested under each device (`DeviceConfig.mocks`).
+ */
+export interface SessionExport {
+    readonly devices: DeviceConfig[];
+}
+export declare const sessionExportCodec: Codec<{
+    devices: {
+        name: string | undefined;
+        device_type: string | undefined;
+        connectivity_type: string | undefined;
+        firmware_version: string | undefined;
+        apps: {
+            name: string;
+            version: string;
+        }[] | undefined;
+        masks: number[] | undefined;
+        mocks: {
+            prefix: string;
+            response: string | undefined;
+            responses: string[] | undefined;
+        }[] | undefined;
+    }[];
+}>;
+//# sourceMappingURL=SessionExport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionExport.d.ts","sourceRoot":"","sources":["../../../../src/model/SessionExport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,KAAK,YAAY,EAAqB,MAAM,UAAU,CAAC;AAEhE;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC;CAClC;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;EAE7B,CAAC"}

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

@@ -0,0 +1,20 @@
+import { Codec } from "purify-ts";
+/**
+ * The live Speculos emulator instance backing a device, returned by
+ * `GET /devices/:id/speculos`. Control calls are proxied through
+ * `/devices/:id/speculos/*`.
+ */
+export interface SpeculosInstance {
+    /** Speculinho run id owning the emulator pod. */
+    readonly run_id: string;
+    /** Per-pod emulator URL (reachable from the mock server). */
+    readonly speculos_url: string;
+    /** Device model (e.g. "nanoX", "stax", "flex"). */
+    readonly model: string;
+}
+export declare const speculosInstanceCodec: Codec<{
+    run_id: string;
+    speculos_url: string;
+    model: string;
+}>;
+//# sourceMappingURL=Speculos.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Speculos.d.ts","sourceRoot":"","sources":["../../../../src/model/Speculos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAU,MAAM,WAAW,CAAC;AAE1C;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,qBAAqB;;;;EAIhC,CAAC"}