@ledgerhq/device-mockserver-client 1.1.0 → 1.3.0

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

@@ -1,27 +1,80 @@
+import { DmkNetworkClient } from "@ledgerhq/device-management-kit";
+import { type ConnectionState } from "./model/Auth";
 import { type CommandResponse } from "./model/CommandResponse";
-import { type Device } from "./model/Device";
-import { type Mock } from "./model/Mock";
+import { type Device, type DeviceConfig } from "./model/Device";
+import { type Mock, type MockConfig } from "./model/Mock";
 import { type Session } from "./model/Session";
-import { ConnectivityService } from "./service/ConnectivityService";
-import { DiscoveryService } from "./service/DiscoveryService";
-import { MockService } from "./service/MockService";
-import { SendService } from "./service/SendService";
+import { type SessionExport } from "./model/SessionExport";
+import { type SpeculosAction, type SpeculosButton, type SpeculosInstance } from "./model/Speculos";
+export interface MockClientOptions {
+    /**
+     * An existing mock server session token. When provided the client operates
+     * within that session; when omitted the client lazily creates its own session
+     * through POST /auth.
+     */
+    readonly token?: string;
+    /** Inject a custom network client (mainly for testing). */
+    readonly httpClient?: DmkNetworkClient;
+}
+/**
+ * HTTP client for the device mock server.
+ *
+ * Implements the bearer-token contract: the session is
+ * resolved from an `Authorization: Bearer <token>` header rather than a
+ * `session_id` header, and sessions, devices and mocks are exposed as REST
+ * resources. The token can be injected or self-provisioned via /auth.
+ */
 export declare class MockClient {
-    connectivityService: ConnectivityService;
-    sendService: SendService;
-    discoveryService: DiscoveryService;
-    mockService: MockService;
-    constructor(baseUrl: string);
-    connect(sessionId: string): Promise<Session>;
-    disconnect(sessionId: string): Promise<boolean>;
+    private readonly client;
+    private token?;
+    private authPromise?;
+    constructor(baseUrl: string, options?: MockClientOptions);
+    /** Create a session and store the returned bearer token. */
+    authenticate(): Promise<string>;
+    /** The current bearer token, if a session has been established. */
+    getToken(): string | undefined;
+    listDevices(): Promise<Device[]>;
+    addDevice(config?: DeviceConfig): Promise<Device>;
+    getDevice(deviceId: string): Promise<Device>;
+    editDevice(deviceId: string, config: DeviceConfig): Promise<Device>;
+    deleteDevice(deviceId: string): Promise<boolean>;
+    connect(deviceId: string): Promise<ConnectionState>;
+    disconnect(deviceId: string): Promise<boolean>;
+    /** Disconnect every device attached to the session. */
     disconnectAll(): Promise<boolean>;
-    getConnected(): Promise<Session[]>;
-    send(sessionId: string, binaryCommand: Uint8Array): Promise<CommandResponse>;
-    scan(nbDevices?: number): Promise<Device[]>;
-    addMock(sessionId: string, prefix: string, response: string): Promise<boolean>;
-    getMocks(sessionId: string): Promise<Mock[]>;
-    deleteMocks(sessionId: string): Promise<boolean>;
-    toHexString(arr: Uint8Array): string;
-    fromHexString(hexString: string): Uint8Array;
+    sendApdu(deviceId: string, apdu: Uint8Array | string): Promise<CommandResponse>;
+    listMocks(deviceId: string): Promise<Mock[]>;
+    addMock(deviceId: string, config: MockConfig): Promise<Mock>;
+    editMock(deviceId: string, mockId: string, config: MockConfig): Promise<Mock>;
+    deleteMock(deviceId: string, mockId: string): Promise<boolean>;
+    clearMocks(deviceId: string): Promise<boolean>;
+    /**
+     * Resolve the live Speculos instance backing a device (the one currently
+     * proxying its APDUs). Throws if the device has no active instance.
+     */
+    getSpeculos(deviceId: string): Promise<SpeculosInstance>;
+    /**
+     * Capture the device's current screen as a PNG. Throws with status 409 when
+     * the device has no active instance, which is the case whenever no app is
+     * running.
+     */
+    getScreenshot(deviceId: string): Promise<Blob>;
+    /** Actuate a physical button on a button-driven device. */
+    pressButton(deviceId: string, button: SpeculosButton, action?: SpeculosAction): Promise<void>;
+    /** Tap a touchscreen device, in device screen pixels. */
+    touchScreen(deviceId: string, x: number, y: number, action?: SpeculosAction): Promise<void>;
+    getSession(): Promise<Session>;
+    disposeSession(): Promise<boolean>;
+    /** Export the session's devices and mocks as a portable snapshot. */
+    exportSession(): Promise<SessionExport>;
+    /**
+     * Replace the session's devices and mocks with a previously exported
+     * snapshot, returning the resulting (normalized) state.
+     */
+    importSession(snapshot: SessionExport): Promise<SessionExport>;
+    private decode;
+    private authHeaders;
+    private ensureToken;
+    private normalizeUrl;
 }
 //# sourceMappingURL=MockClient.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"MockClient.d.ts","sourceRoot":"","sources":["../../../src/MockClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,qBAAa,UAAU;IAErB,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,WAAW,EAAE,WAAW,CAAC;IACzB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,WAAW,EAAE,WAAW,CAAC;gBAEb,OAAO,EAAE,MAAM;IAQrB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5C,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/C,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IAIjC,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAIlC,IAAI,CACR,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,UAAU,GACxB,OAAO,CAAC,eAAe,CAAC;IAKrB,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAI3C,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC;IAIb,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAI5C,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKtD,WAAW,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM;IAIpC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU;CAQ7C"}
+{"version":3,"file":"MockClient.d.ts","sourceRoot":"","sources":["../../../src/MockClient.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=MockClient.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MockClient.test.d.ts","sourceRoot":"","sources":["../../../src/MockClient.test.ts"],"names":[],"mappings":""}

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

@@ -1,6 +1,10 @@
+export type { MockClientOptions } from "./MockClient";
 export { MockClient } from "./MockClient";
-export { CommandResponse } from "./model/CommandResponse";
-export { Device } from "./model/Device";
-export { Mock } from "./model/Mock";
-export { Session } from "./model/Session";
+export type { AuthResponse, ConnectionState } from "./model/Auth";
+export type { CommandResponse } from "./model/CommandResponse";
+export { type CatalogApp, catalogAppCodec, type Device, type DeviceApp, type DeviceConfig, deviceConfigCodec, type DeviceConnectivityType, } from "./model/Device";
+export { type Mock, type MockConfig, mockConfigCodec } from "./model/Mock";
+export type { Session } from "./model/Session";
+export { type SessionExport, sessionExportCodec } from "./model/SessionExport";
+export type { SpeculosAction, SpeculosButton, SpeculosInstance, } from "./model/Speculos";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAClE,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EACL,KAAK,UAAU,EACf,eAAe,EACf,KAAK,MAAM,EACX,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,iBAAiB,EACjB,KAAK,sBAAsB,GAC5B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC3E,YAAY,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,KAAK,aAAa,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC/E,YAAY,EACV,cAAc,EACd,cAAc,EACd,gBAAgB,GACjB,MAAM,kBAAkB,CAAC"}

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

@@ -0,0 +1,41 @@
+import { Codec } from "purify-ts";
+import { type Device } from "./Device";
+/**
+ * Response of POST /auth: an opaque bearer token identifying a session and its
+ * expiry timestamp (epoch ms).
+ */
+export interface AuthResponse {
+    readonly token: string;
+    readonly expires_at: number;
+}
+export declare const authResponseCodec: Codec<{
+    token: string;
+    expires_at: number;
+}>;
+/**
+ * State returned when connecting a device (POST /devices/:id/connect).
+ */
+export interface ConnectionState {
+    readonly device: Device;
+    readonly connected: boolean;
+}
+export declare const connectionStateCodec: Codec<{
+    device: {
+        id: string;
+        name: string;
+        device_type: string;
+        connectivity_type: string;
+        firmware_version: string | undefined;
+        apps: {
+            name: string;
+            version: string;
+            hash: string | undefined;
+        }[] | undefined;
+        masks: number[] | undefined;
+        connected: boolean | undefined;
+        onboarded: boolean | undefined;
+        language: string | undefined;
+    };
+    connected: boolean;
+}>;
+//# sourceMappingURL=Auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Auth.d.ts","sourceRoot":"","sources":["../../../../src/model/Auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,EAAkB,MAAM,WAAW,CAAC;AAE3D,OAAO,EAAE,KAAK,MAAM,EAAe,MAAM,UAAU,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,iBAAiB;;;EAG5B,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;EAG/B,CAAC"}

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

@@ -1,8 +1,14 @@
-export type CommandResponseArgs = {
+import { Codec } from "purify-ts";
+/**
+ * The result of simulating an APDU exchange (POST /devices/:id/apdu).
+ *
+ * {@link CommandResponse.response} is the full response hex, data followed by the
+ * two-byte status word.
+ */
+export interface CommandResponse {
     readonly response: string;
-};
-export declare class CommandResponse {
-    readonly response: string;
-    constructor({ response }: CommandResponseArgs);
 }
+export declare const commandResponseCodec: Codec<{
+    response: string;
+}>;
 //# sourceMappingURL=CommandResponse.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"CommandResponse.d.ts","sourceRoot":"","sources":["../../../../src/model/CommandResponse.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,qBAAa,eAAe;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,EAAE,QAAQ,EAAE,EAAE,mBAAmB;CAG9C"}
+{"version":3,"file":"CommandResponse.d.ts","sourceRoot":"","sources":["../../../../src/model/CommandResponse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAU,MAAM,WAAW,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,oBAAoB;;EAE/B,CAAC"}

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

@@ -1,14 +1,122 @@
-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;
+    readonly hash?: string;
+}
+export declare const deviceAppCodec: Codec<{
+    name: string;
+    version: string;
+    hash: string | undefined;
+}>;
+/**
+ * An installable app known to the mock "app store", keyed by its install
+ * `hash`. The secure-channel install flow resolves the hash sent by DMK to one
+ * of these entries to learn which app is being installed.
+ */
+export interface CatalogApp {
+    readonly hash: string;
+    readonly name: string;
+    readonly version: string;
+}
+export declare const catalogAppCodec: Codec<{
+    hash: string;
+    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;
+    /**
+     * Whether the device is onboarded. Omitted/`true` reports a normal onboarded
+     * device; `false` starts the onboarding simulation (the device reports itself
+     * as not onboarded and auto-advances through the onboarding steps as it is
+     * polled).
+     */
+    readonly onboarded?: boolean;
+    /**
+     * The installed language pack, by name (`"french"`, `"german"`, …). Omitted
+     * means the device runs on its built-in English, as one with no pack
+     * installed does. Installing a pack over the wire sets it.
+     */
+    readonly language?: string;
+}
+export declare const deviceCodec: Codec<{
+    id: string;
+    name: string;
+    device_type: string;
+    connectivity_type: string;
+    firmware_version: string | undefined;
+    apps: {
+        name: string;
+        version: string;
+        hash: string | undefined;
+    }[] | undefined;
+    masks: number[] | undefined;
+    connected: boolean | undefined;
+    onboarded: boolean | undefined;
+    language: string | 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[];
+    /** Installable apps the mock "app store" can resolve from an install hash. */
+    readonly catalog?: CatalogApp[];
+    /**
+     * Whether the device is onboarded. Omitted/`true` reports a normal onboarded
+     * device; `false` starts the onboarding simulation.
+     */
+    readonly onboarded?: boolean;
+    /** The installed language pack, by name (`"french"`, `"german"`, …). */
+    readonly language?: string;
 }
+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;
+        hash: string | undefined;
+    }[] | undefined;
+    masks: number[] | undefined;
+    mocks: {
+        prefix: string;
+        response: string | undefined;
+        responses: string[] | undefined;
+    }[] | undefined;
+    catalog: {
+        hash: string;
+        name: string;
+        version: string;
+    }[] | undefined;
+    onboarded: boolean | undefined;
+    language: string | 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;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,cAAc;;;;EAIzB,CAAC;AAEH;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,eAAe;;;;EAI1B,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;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;EAWtB,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;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;EAW5B,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,35 @@
+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;
+            hash: string | undefined;
+        }[] | undefined;
+        masks: number[] | undefined;
+        connected: boolean | undefined;
+        onboarded: boolean | undefined;
+        language: string | 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,40 @@
+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;
+            hash: string | undefined;
+        }[] | undefined;
+        masks: number[] | undefined;
+        mocks: {
+            prefix: string;
+            response: string | undefined;
+            responses: string[] | undefined;
+        }[] | undefined;
+        catalog: {
+            hash: string;
+            name: string;
+            version: string;
+        }[] | undefined;
+        onboarded: boolean | undefined;
+        language: string | 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,27 @@
+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;
+}>;
+/** A physical button on a button-driven device. */
+export type SpeculosButton = "left" | "right" | "both";
+/**
+ * How an input is delivered. `press-and-release` covers a normal click or tap;
+ * the split variants exist for flows that require a held input.
+ */
+export type SpeculosAction = "press" | "release" | "press-and-release";
+//# 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;AAEH,mDAAmD;AACnD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAEvD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,SAAS,GAAG,mBAAmB,CAAC"}