@onekeyfe/hwk-trezor-connector 1.1.27-alpha.100

package/dist/index.d.mts

@@ -0,0 +1,69 @@
+import { IConnector, ConnectionType, ConnectorDevice, ConnectorSession, ConnectorEventType, ConnectorEventMap } from '@onekeyfe/hwk-adapter-core';
+import { TrezorThpSessionOptions, TrezorByteTransport, TrezorDeviceSession, TrezorThpCredentials } from '@onekeyfe/hwk-trezor-core';
+
+type TrezorConnectorByteTransport = TrezorByteTransport & {
+    close?(): Promise<void>;
+    /**
+     * Subscribe to physical-disconnect events from the underlying transport
+     * (e.g. BLE link drop). Returns an unsubscribe function.
+     */
+    onDisconnect?(handler: () => void): () => void;
+};
+type TrezorConnectorBaseOptions = {
+    connectionType?: ConnectionType;
+    chunkSize?: number;
+    thp?: TrezorThpSessionOptions;
+    deviceSessionFactory?: (params: {
+        transport: TrezorConnectorByteTransport;
+        connectionType: ConnectionType;
+        chunkSize: number;
+        thp?: TrezorThpSessionOptions;
+    }) => TrezorDeviceSession;
+};
+declare abstract class TrezorConnectorBase implements IConnector {
+    readonly connectionType: ConnectionType;
+    private readonly chunkSize;
+    private readonly thp?;
+    private readonly knownCredentials;
+    private readonly deviceSessionFactory;
+    private readonly eventHandlers;
+    private readonly uiRequests;
+    private readonly devices;
+    private readonly sessions;
+    protected constructor(options?: TrezorConnectorBaseOptions);
+    /**
+     * Replace the in-memory THP pairing credential list. Caller (host) reads
+     * persisted credentials from storage and pushes them in here before the
+     * first connect; the device sees them via `ThpHandshakeInitRequest` and
+     * routes through the autoconnect path instead of CodeEntry.
+     *
+     * Empty list = "no credentials known" = fresh pairing on next connect.
+     * The internal array is reused so any in-flight TrezorThpSession picks up
+     * the change too — we mutate, not replace.
+     */
+    setKnownCredentials(credentials: TrezorThpCredentials[]): void;
+    /**
+     * Push new credentials minted during pairing into the in-memory array.
+     * Deduplicates by the device-minted `credential` blob — the host has no
+     * other stable identity for a credential.
+     */
+    private mergeKnownCredentials;
+    protected abstract enumerateDevices(): Promise<ConnectorDevice[]>;
+    protected abstract createByteTransport(device: ConnectorDevice): Promise<TrezorConnectorByteTransport>;
+    protected resolveUnlistedDevice(_deviceId: string): ConnectorDevice | undefined;
+    searchDevices(): Promise<ConnectorDevice[]>;
+    connect(deviceId?: string): Promise<ConnectorSession>;
+    disconnect(sessionId: string): Promise<void>;
+    call(sessionId: string, method: string, params: unknown): Promise<unknown>;
+    cancel(_sessionId: string): Promise<void>;
+    uiResponse(_response: Parameters<IConnector['uiResponse']>[0]): void;
+    on<K extends ConnectorEventType>(event: K, handler: (data: ConnectorEventMap[K]) => void): void;
+    off<K extends ConnectorEventType>(event: K, handler: (data: ConnectorEventMap[K]) => void): void;
+    reset(): void;
+    protected emit<K extends ConnectorEventType>(event: K, data: ConnectorEventMap[K]): void;
+    private resolveDevice;
+    private createThpOptions;
+    private log;
+}
+
+export { TrezorConnectorBase, type TrezorConnectorBaseOptions, type TrezorConnectorByteTransport };

package/dist/index.d.ts

@@ -0,0 +1,69 @@
+import { IConnector, ConnectionType, ConnectorDevice, ConnectorSession, ConnectorEventType, ConnectorEventMap } from '@onekeyfe/hwk-adapter-core';
+import { TrezorThpSessionOptions, TrezorByteTransport, TrezorDeviceSession, TrezorThpCredentials } from '@onekeyfe/hwk-trezor-core';
+
+type TrezorConnectorByteTransport = TrezorByteTransport & {
+    close?(): Promise<void>;
+    /**
+     * Subscribe to physical-disconnect events from the underlying transport
+     * (e.g. BLE link drop). Returns an unsubscribe function.
+     */
+    onDisconnect?(handler: () => void): () => void;
+};
+type TrezorConnectorBaseOptions = {
+    connectionType?: ConnectionType;
+    chunkSize?: number;
+    thp?: TrezorThpSessionOptions;
+    deviceSessionFactory?: (params: {
+        transport: TrezorConnectorByteTransport;
+        connectionType: ConnectionType;
+        chunkSize: number;
+        thp?: TrezorThpSessionOptions;
+    }) => TrezorDeviceSession;
+};
+declare abstract class TrezorConnectorBase implements IConnector {
+    readonly connectionType: ConnectionType;
+    private readonly chunkSize;
+    private readonly thp?;
+    private readonly knownCredentials;
+    private readonly deviceSessionFactory;
+    private readonly eventHandlers;
+    private readonly uiRequests;
+    private readonly devices;
+    private readonly sessions;
+    protected constructor(options?: TrezorConnectorBaseOptions);
+    /**
+     * Replace the in-memory THP pairing credential list. Caller (host) reads
+     * persisted credentials from storage and pushes them in here before the
+     * first connect; the device sees them via `ThpHandshakeInitRequest` and
+     * routes through the autoconnect path instead of CodeEntry.
+     *
+     * Empty list = "no credentials known" = fresh pairing on next connect.
+     * The internal array is reused so any in-flight TrezorThpSession picks up
+     * the change too — we mutate, not replace.
+     */
+    setKnownCredentials(credentials: TrezorThpCredentials[]): void;
+    /**
+     * Push new credentials minted during pairing into the in-memory array.
+     * Deduplicates by the device-minted `credential` blob — the host has no
+     * other stable identity for a credential.
+     */
+    private mergeKnownCredentials;
+    protected abstract enumerateDevices(): Promise<ConnectorDevice[]>;
+    protected abstract createByteTransport(device: ConnectorDevice): Promise<TrezorConnectorByteTransport>;
+    protected resolveUnlistedDevice(_deviceId: string): ConnectorDevice | undefined;
+    searchDevices(): Promise<ConnectorDevice[]>;
+    connect(deviceId?: string): Promise<ConnectorSession>;
+    disconnect(sessionId: string): Promise<void>;
+    call(sessionId: string, method: string, params: unknown): Promise<unknown>;
+    cancel(_sessionId: string): Promise<void>;
+    uiResponse(_response: Parameters<IConnector['uiResponse']>[0]): void;
+    on<K extends ConnectorEventType>(event: K, handler: (data: ConnectorEventMap[K]) => void): void;
+    off<K extends ConnectorEventType>(event: K, handler: (data: ConnectorEventMap[K]) => void): void;
+    reset(): void;
+    protected emit<K extends ConnectorEventType>(event: K, data: ConnectorEventMap[K]): void;
+    private resolveDevice;
+    private createThpOptions;
+    private log;
+}
+
+export { TrezorConnectorBase, type TrezorConnectorBaseOptions, type TrezorConnectorByteTransport };