@onekeyfe/hd-core 1.2.2-alpha.113 → 1.2.2-alpha.114

package/__tests__/core-error-output.test.ts

@@ -62,7 +62,13 @@ describe('Core 错误输出边界', () => {
         const request = core.handleMessage({
           id: 11,
           type: IFRAME.CALL,
-          payload: { method: 'getDeviceState', connectId: 'serial-V2' },
+          payload: {
+            method: 'getDeviceState',
+            connectId: 'serial-V2',
+            retryCount: 1,
+            pollIntervalTime: 1,
+            timeout: 1000,
+          },
         } as never);
         await new Promise(resolve => {
           setTimeout(resolve, 0);
@@ -87,7 +93,7 @@ describe('Core 错误输出边界', () => {
           setTimeout(resolve, 0);
         });
         expect(search).toHaveBeenCalledTimes(1);
-        expect(initialize).toHaveBeenCalledTimes(shouldCancel ? 0 : 1);
+        expect(initialize).toHaveBeenCalledTimes(shouldCancel ? 0 : 2);
       } finally {
         finishSearch?.();
         await core.dispose();

package/__tests__/search-devices.test.ts

@@ -4,6 +4,7 @@ jest.mock('../src/data-manager/TransportManager', () => ({
   __esModule: true,
   default: {
     configure: jest.fn(),
+    ensureInitialized: jest.fn(),
   },
 }));
 
@@ -21,9 +22,9 @@ jest.mock('../src/device/DevicePool', () => ({
   },
 }));
 
-const transportManagerMock: { default: { configure: jest.Mock } } = jest.requireMock(
-  '../src/data-manager/TransportManager'
-);
+const transportManagerMock: {
+  default: { configure: jest.Mock; ensureInitialized: jest.Mock };
+} = jest.requireMock('../src/data-manager/TransportManager');
 const devicePoolMock: {
   DevicePool: { getDevices: jest.Mock; getDeviceByPath: jest.Mock };
 } = jest.requireMock('../src/device/DevicePool');
@@ -33,8 +34,10 @@ const dataManagerMock: {
     isBleConnect: jest.Mock;
   };
 } = jest.requireMock('../src/data-manager');
-const { configure: mockConfigureTransport } = transportManagerMock.default;
-const { getDevices: mockGetDevices } = devicePoolMock.DevicePool;
+const { configure: mockConfigureTransport, ensureInitialized: mockEnsureInitialized } =
+  transportManagerMock.default;
+const { getDevices: mockGetDevices, getDeviceByPath: mockGetDeviceByPath } =
+  devicePoolMock.DevicePool;
 const { isBleConnect: mockIsBleConnect } = dataManagerMock.DataManager;
 
 describe('SearchDevices', () => {
@@ -52,32 +55,116 @@ describe('SearchDevices', () => {
         features: { protocol },
         toMessageObject: () => ({ connectId: `serial-${protocol}` }),
       }));
-      devicePoolMock.DevicePool.getDeviceByPath.mockImplementation(
+      mockGetDeviceByPath.mockImplementation(
         (path: string) => devices[['usb-V1', 'usb-V2'].indexOf(path)]
       );
+      const extraDevice = {
+        toMessageObject: () => ({ connectId: 'not-initialized' }),
+      };
+      mockGetDevices.mockResolvedValue({
+        devices: { 'not-initialized': extraDevice },
+        deviceList: [extraDevice],
+      });
       const method = new SearchDevices({
         id: 1,
         payload: { method: 'searchDevices' },
       } as never);
       method.init();
       method.context = {
-        requestQueue: { getRequestTasksId: () => [2] },
+        requestQueue: {
+          getRequestTasksId: () => [2],
+          getRequestTasksIdByConnectId: (connectId: string) =>
+            connectId === 'usb-V1' || connectId === 'usb-V2' ? [2] : [],
+        },
       } as never;
       method.connector = {
         enumerate: jest.fn().mockResolvedValue({
-          descriptors: [{ path: 'usb-V1' }, { path: 'usb-V2' }, { path: 'not-initialized' }],
+          descriptors: [
+            { path: 'usb-V1', commType: 'webusb' },
+            { path: 'usb-V2', commType: 'webusb' },
+            { path: 'not-initialized', commType: 'webusb' },
+          ],
         }),
       } as never;
 
       await expect(method.run()).resolves.toEqual([
         { connectId: 'serial-V1' },
         { connectId: 'serial-V2' },
+        { connectId: 'not-initialized' },
       ]);
-      expect(mockGetDevices).not.toHaveBeenCalled();
+      expect(mockGetDevices).toHaveBeenCalledTimes(1);
+      expect(mockGetDevices).toHaveBeenCalledWith(
+        [{ path: 'not-initialized', commType: 'webusb' }],
+        'not-initialized',
+        {
+          connectProtocol: undefined,
+          forceProtocolDetection: true,
+          refreshRuntimeState: true,
+        }
+      );
       expect(mockConfigureTransport).not.toHaveBeenCalled();
     }
   );
 
+  test('owned WebUSB cache miss still reports a SearchDevice without probing', async () => {
+    mockGetDeviceByPath.mockReturnValue(undefined);
+    const usbDevice = { vendorId: 0x1209, productId: 0x4f4c };
+    const method = new SearchDevices({
+      id: 1,
+      payload: { method: 'searchDevices' },
+    } as never);
+    method.init();
+    method.context = {
+      requestQueue: {
+        getRequestTasksId: () => [2],
+        getRequestTasksIdByConnectId: (connectId: string) => (connectId === 'serial-V2' ? [2] : []),
+      },
+    } as never;
+    method.connector = {
+      enumerate: jest.fn().mockResolvedValue({
+        descriptors: [
+          {
+            path: 'serial-V2',
+            device: usbDevice,
+            commType: 'webusb',
+          },
+        ],
+      }),
+    } as never;
+
+    await expect(method.run()).resolves.toEqual([
+      {
+        connectId: 'serial-V2',
+        uuid: 'serial-V2',
+        serialNo: 'serial-V2',
+        deviceId: null,
+        deviceType: 'unknown',
+        name: 'serial-V2',
+        commType: 'webusb',
+      },
+    ]);
+    expect(mockGetDevices).not.toHaveBeenCalled();
+    expect(mockConfigureTransport).not.toHaveBeenCalled();
+  });
+
+  test('searchDevices resolves empty when WebUSB bring-up is unavailable', async () => {
+    mockEnsureInitialized.mockRejectedValueOnce(
+      new Error('WebUSB is not supported by current browsers')
+    );
+    const method = new SearchDevices({
+      id: 1,
+      payload: { method: 'searchDevices' },
+    } as never);
+    method.init();
+    method.connector = {
+      enumerate: jest.fn().mockResolvedValue({ descriptors: [] }),
+    } as never;
+
+    await expect(method.run()).resolves.toEqual([]);
+    expect(mockEnsureInitialized).toHaveBeenCalled();
+    expect(mockConfigureTransport).toHaveBeenCalledTimes(1);
+  });
+
   test('搜索忽略调用方协议并主动探测，单个无响应设备不阻断后续结果', async () => {
     const unresponsiveDescriptor = {
       path: 'stale-usb-device',

package/dist/api/SearchDevices.d.ts

@@ -1,22 +1,9 @@
 import { BaseMethod } from './BaseMethod';
+import type { SearchDevice } from '../types/device';
 import type DeviceConnector from '../device/DeviceConnector';
 export default class SearchDevices extends BaseMethod {
     connector?: DeviceConnector;
     init(): void;
-    run(): Promise<(import("..").KnownDevice | null)[] | {
-        connectId: string;
-        serialNo: null;
-        uuid: string;
-        deviceId: null;
-        name: string | null;
-        deviceType: import("..").IDeviceType;
-        commType: import("packages/hd-transport/dist").OneKeyDeviceCommType;
-        path: string;
-        session?: string | null | undefined;
-        debugSession?: string | null | undefined;
-        debug: boolean;
-        id: string;
-        protocolType?: import("packages/hd-transport/dist").ProtocolType | undefined;
-    }[]>;
+    run(): Promise<SearchDevice[]>;
 }
 //# sourceMappingURL=SearchDevices.d.ts.map

package/dist/api/SearchDevices.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SearchDevices.d.ts","sourceRoot":"","sources":["../../src/api/SearchDevices.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAM1C,OAAO,KAAK,eAAe,MAAM,2BAA2B,CAAC;AAI7D,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,UAAU;IACnD,SAAS,CAAC,EAAE,eAAe,CAAC;IAE5B,IAAI;IAME,GAAG;;;;;;;;;;;;;;;CA0EV"}
+{"version":3,"file":"SearchDevices.d.ts","sourceRoot":"","sources":["../../src/api/SearchDevices.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAM1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,eAAe,MAAM,2BAA2B,CAAC;AAuC7D,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,UAAU;IACnD,SAAS,CAAC,EAAE,eAAe,CAAC;IAE5B,IAAI;IAME,GAAG,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;CAsFrC"}

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";AACA,OAAO,YAAY,MAAM,QAAQ,CAAC;AAClC,OAAO,EAEL,KAAK,6BAA6B,EAElC,KAAK,YAAY,EAIlB,MAAM,wBAAwB,CAAC;AAiChC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAsB1C,OAAO,eAAe,MAAM,2BAA2B,CAAC;AAYxD,OAAO,KAAK,EAAE,eAAe,EAAyB,MAAM,UAAU,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAmD,MAAM,WAAW,CAAC;AAI9F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAYpD,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;AA0E7D,eAAO,MAAM,OAAO,YAAmB,WAAW,WAAW,WAAW,iBA0FvE,CAAC;AAyFF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAY3F;AA8mBD,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,WAWpF;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,WAoB/E;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,WAQlF;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,WAEzD;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,WAI3D;AAiKD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,UAAU,GAAG,YAAY,GAAG,SAAS,CAMtF;AAwMD,eAAO,MAAM,MAAM,YAAa,WAAW,cAAc,MAAM,SA4G9D,CAAC;AA8GF,eAAO,MAAM,qBAAqB,gFAejC,CAAC;AAiLF,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,YAAY;IAC5C,OAAO,CAAC,cAAc,CAAoB;IAE1C,SAAgB,aAAa,EAAE,MAAM,CAAC;IAEtC,OAAO,CAAC,YAAY,CAAsB;IAE1C,OAAO,CAAC,cAAc,CAAC,CAAgB;IAGvC,OAAO,CAAC,sBAAsB,CAAoC;IAElE,OAAO,CAAC,iBAAiB,CAAoB;;IAS7C,OAAO,CAAC,cAAc;IAuChB,aAAa,CAAC,OAAO,EAAE,WAAW;IAuExC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAOV,gBAAgB;CAiC/B;AAED,eAAO,MAAM,QAAQ,YAIpB,CAAC;AAEF,eAAO,MAAM,aAAa,uBAYzB,CAAC;AAMF,eAAO,MAAM,IAAI,aACL,eAAe,aACd,GAAG,WACL,6BAA6B,8BAiBvC,CAAC;AAEF,eAAO,MAAM,eAAe;SAKrB,eAAe,CAAC,KAAK,CAAC;eAChB,GAAG;;UASf,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";AACA,OAAO,YAAY,MAAM,QAAQ,CAAC;AAClC,OAAO,EAEL,KAAK,6BAA6B,EAElC,KAAK,YAAY,EAIlB,MAAM,wBAAwB,CAAC;AAiChC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAsB1C,OAAO,eAAe,MAAM,2BAA2B,CAAC;AAYxD,OAAO,KAAK,EAAE,eAAe,EAAyB,MAAM,UAAU,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAmD,MAAM,WAAW,CAAC;AAI9F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAYpD,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;AA0E7D,eAAO,MAAM,OAAO,YAAmB,WAAW,WAAW,WAAW,iBA0FvE,CAAC;AA2FF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAY3F;AAunBD,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,WAWpF;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,WAoB/E;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,WAQlF;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,WAEzD;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,WAI3D;AAiKD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,UAAU,GAAG,YAAY,GAAG,SAAS,CAMtF;AA2MD,eAAO,MAAM,MAAM,YAAa,WAAW,cAAc,MAAM,SA4G9D,CAAC;AA8GF,eAAO,MAAM,qBAAqB,gFAejC,CAAC;AAiLF,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,YAAY;IAC5C,OAAO,CAAC,cAAc,CAAoB;IAE1C,SAAgB,aAAa,EAAE,MAAM,CAAC;IAEtC,OAAO,CAAC,YAAY,CAAsB;IAE1C,OAAO,CAAC,cAAc,CAAC,CAAgB;IAGvC,OAAO,CAAC,sBAAsB,CAAoC;IAElE,OAAO,CAAC,iBAAiB,CAAoB;;IAS7C,OAAO,CAAC,cAAc;IAuChB,aAAa,CAAC,OAAO,EAAE,WAAW;IAuExC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAOV,gBAAgB;CAiC/B;AAED,eAAO,MAAM,QAAQ,YAIpB,CAAC;AAEF,eAAO,MAAM,aAAa,uBAYzB,CAAC;AAMF,eAAO,MAAM,IAAI,aACL,eAAe,aACd,GAAG,WACL,6BAA6B,8BAiBvC,CAAC;AAEF,eAAO,MAAM,eAAe;SAKrB,eAAe,CAAC,KAAK,CAAC;eAChB,GAAG;;UASf,CAAC"}

package/dist/data-manager/TransportManager.d.ts

@@ -6,9 +6,11 @@ export default class TransportManager {
     static defaultMessages: JSON | Record<string, any>;
     static currentMessages: JSON | Record<string, any>;
     static reactNativeInit: boolean;
+    static webUsbInit: boolean;
     static protocolV1MessageSchema: ProtocolV1MessageSchema;
     static plugin: LowlevelTransportSharedPlugin | null;
     static load(): void;
+    static ensureInitialized(): Promise<void>;
     static configure(): Promise<void>;
     static reconfigure(features?: Features): Promise<void>;
     static setTransport(TransportConstructor: any, plugin?: LowlevelTransportSharedPlugin): void;

package/dist/data-manager/TransportManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TransportManager.d.ts","sourceRoot":"","sources":["../../src/data-manager/TransportManager.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAE,6BAA6B,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACvF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAgBzC,MAAM,CAAC,OAAO,OAAO,gBAAgB;IACnC,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC;IAE5B,MAAM,CAAC,eAAe,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEnD,MAAM,CAAC,eAAe,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEnD,MAAM,CAAC,eAAe,UAAS;IAE/B,MAAM,CAAC,uBAAuB,EAAE,uBAAuB,CAAqB;IAE5E,MAAM,CAAC,MAAM,EAAE,6BAA6B,GAAG,IAAI,CAAQ;IAE3D,MAAM,CAAC,IAAI;WAOE,SAAS;WAqDT,WAAW,CAAC,QAAQ,CAAC,EAAE,QAAQ;IAyB5C,MAAM,CAAC,YAAY,CAAC,oBAAoB,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,6BAA6B;IA6BrF,MAAM,CAAC,YAAY;mBAIE,2BAA2B;IAShD,MAAM,CAAC,kBAAkB;IAIzB,MAAM,CAAC,kBAAkB;IAIzB,MAAM,CAAC,0BAA0B;CAGlC"}
+{"version":3,"file":"TransportManager.d.ts","sourceRoot":"","sources":["../../src/data-manager/TransportManager.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAE,6BAA6B,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACvF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAgBzC,MAAM,CAAC,OAAO,OAAO,gBAAgB;IACnC,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC;IAE5B,MAAM,CAAC,eAAe,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEnD,MAAM,CAAC,eAAe,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEnD,MAAM,CAAC,eAAe,UAAS;IAE/B,MAAM,CAAC,UAAU,UAAS;IAE1B,MAAM,CAAC,uBAAuB,EAAE,uBAAuB,CAAqB;IAE5E,MAAM,CAAC,MAAM,EAAE,6BAA6B,GAAG,IAAI,CAAQ;IAE3D,MAAM,CAAC,IAAI;WAQE,iBAAiB;WAUjB,SAAS;WAmDT,WAAW,CAAC,QAAQ,CAAC,EAAE,QAAQ;IAyB5C,MAAM,CAAC,YAAY,CAAC,oBAAoB,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,6BAA6B;IA6BrF,MAAM,CAAC,YAAY;mBAIE,2BAA2B;IAShD,MAAM,CAAC,kBAAkB;IAIzB,MAAM,CAAC,kBAAkB;IAIzB,MAAM,CAAC,0BAA0B;CAGlC"}

package/dist/index.js

@@ -43705,6 +43705,18 @@ class TransportManager {
         this.defaultMessages = DataManager.getProtobufMessages();
         this.currentMessages = this.defaultMessages;
         this.protocolV1MessageSchema = 'v1CurrentSchema';
+        this.webUsbInit = false;
+    }
+    static ensureInitialized() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const env = DataManager.getSettings('env');
+            if (env !== 'webusb' && env !== 'desktop-webusb')
+                return;
+            if (this.webUsbInit)
+                return;
+            yield this.transport.init(WebUsbLogger, DevicePool.emitter);
+            this.webUsbInit = true;
+        });
     }
     static configure() {
         return __awaiter(this, void 0, void 0, function* () {
@@ -43733,7 +43745,7 @@ class TransportManager {
                     yield this.transport.init(WebBleLogger, DevicePool.emitter);
                 }
                 else if (env === 'webusb' || env === 'desktop-webusb') {
-                    yield this.transport.init(WebUsbLogger, DevicePool.emitter);
+                    yield this.ensureInitialized();
                 }
                 else {
                     yield this.transport.init(HttpLogger);
@@ -43816,6 +43828,7 @@ class TransportManager {
     }
 }
 TransportManager.reactNativeInit = false;
+TransportManager.webUsbInit = false;
 TransportManager.protocolV1MessageSchema = 'v1CurrentSchema';
 TransportManager.plugin = null;
 
@@ -47263,6 +47276,28 @@ class PreInitialize extends BaseMethod {
 }
 
 const Log$e = getLogger(exports.LoggerNames.DevicePool);
+const isOwnedByActiveWebUsbRequest = (descriptor, requestQueue) => {
+    if (!requestQueue)
+        return false;
+    const keys = [descriptor.path, descriptor.id].filter((key) => typeof key === 'string' && key.length > 0);
+    return keys.some(key => requestQueue.getRequestTasksIdByConnectId(key).length > 0);
+};
+const toSearchDeviceFromDescriptor = (descriptor) => {
+    const connectId = descriptor.path || descriptor.id || null;
+    return {
+        connectId,
+        uuid: connectId !== null && connectId !== void 0 ? connectId : '',
+        serialNo: connectId,
+        deviceId: null,
+        deviceType: hdShared.EDeviceType.Unknown,
+        name: descriptor.name || connectId || '',
+        commType: descriptor.commType,
+    };
+};
+const toSearchDevice = (device) => {
+    const message = device.toMessageObject();
+    return message ? message : null;
+};
 class SearchDevices extends BaseMethod {
     init() {
         this.useDevice = false;
@@ -47273,9 +47308,18 @@ class SearchDevices extends BaseMethod {
         var _a, _b, _c, _d, _e, _f, _g;
         return __awaiter(this, void 0, void 0, function* () {
             const env = DataManager.getSettings('env');
-            const useCachedWebUsbDevices = (env === 'webusb' || env === 'desktop-webusb') &&
-                ((_b = (_a = this.context) === null || _a === void 0 ? void 0 : _a.requestQueue.getRequestTasksId().length) !== null && _b !== void 0 ? _b : 0) > 0;
-            if (!useCachedWebUsbDevices)
+            const isWebUsb = env === 'webusb' || env === 'desktop-webusb';
+            const requestQueue = (_a = this.context) === null || _a === void 0 ? void 0 : _a.requestQueue;
+            const hasActiveWebUsbRequest = isWebUsb && ((_b = requestQueue === null || requestQueue === void 0 ? void 0 : requestQueue.getRequestTasksId().length) !== null && _b !== void 0 ? _b : 0) > 0;
+            if (isWebUsb) {
+                try {
+                    yield TransportManager.ensureInitialized();
+                }
+                catch (error) {
+                    Log$e.debug('WebUSB bring-up unavailable', error);
+                }
+            }
+            if (!hasActiveWebUsbRequest)
                 yield TransportManager.configure();
             const deviceDiff = yield ((_c = this.connector) === null || _c === void 0 ? void 0 : _c.enumerate());
             const devicesDescriptor = (_d = deviceDiff === null || deviceDiff === void 0 ? void 0 : deviceDiff.descriptors) !== null && _d !== void 0 ? _d : [];
@@ -47293,30 +47337,35 @@ class SearchDevices extends BaseMethod {
                 }
                 return devices;
             }
-            if (useCachedWebUsbDevices) {
-                return devicesDescriptor.flatMap(descriptor => {
-                    const device = DevicePool.getDeviceByPath(descriptor.path);
-                    return (device === null || device === void 0 ? void 0 : device.features) ? [device.toMessageObject()] : [];
-                });
-            }
             const deviceList = [];
             for (const descriptor of devicesDescriptor) {
-                try {
-                    const result = yield DevicePool.getDevices([descriptor], descriptor.path, {
-                        connectProtocol: undefined,
-                        forceProtocolDetection: true,
-                        refreshRuntimeState: true,
-                    });
-                    deviceList.push(...result.deviceList);
+                if (hasActiveWebUsbRequest && isOwnedByActiveWebUsbRequest(descriptor, requestQueue)) {
+                    const cached = DevicePool.getDeviceByPath(descriptor.path);
+                    const message = (cached === null || cached === void 0 ? void 0 : cached.features) ? toSearchDevice(cached) : null;
+                    deviceList.push(message !== null && message !== void 0 ? message : toSearchDeviceFromDescriptor(descriptor));
                 }
-                catch (error) {
-                    const errorCode = error && typeof error === 'object' && 'errorCode' in error
-                        ? error.errorCode
-                        : undefined;
-                    Log$e.debug('Skip unavailable device during search', Object.assign({ path: descriptor.path }, (errorCode !== undefined ? { errorCode } : {})));
+                else {
+                    try {
+                        const result = yield DevicePool.getDevices([descriptor], descriptor.path, {
+                            connectProtocol: undefined,
+                            forceProtocolDetection: true,
+                            refreshRuntimeState: true,
+                        });
+                        for (const device of result.deviceList) {
+                            const message = toSearchDevice(device);
+                            if (message)
+                                deviceList.push(message);
+                        }
+                    }
+                    catch (error) {
+                        const errorCode = error && typeof error === 'object' && 'errorCode' in error
+                            ? error.errorCode
+                            : undefined;
+                        Log$e.debug('Skip unavailable device during search', Object.assign({ path: descriptor.path }, (errorCode !== undefined ? { errorCode } : {})));
+                    }
                 }
             }
-            return deviceList.map(device => device.toMessageObject());
+            return deviceList;
         });
     }
 }
@@ -66033,6 +66082,7 @@ const waitForPendingPromise = (connectId, getPrePendingCallPromise, removePrePen
         Log.debug('pre pending call promise before call method, wait for it');
         let timer;
         let timedOut = false;
+        let completed = false;
         try {
             yield Promise.race([
                 pendingPromise,
@@ -66043,11 +66093,13 @@ const waitForPendingPromise = (connectId, getPrePendingCallPromise, removePrePen
                     }, PRE_PENDING_CALL_TIMEOUT_MS);
                 }),
             ]);
+            completed = !timedOut;
         }
         finally {
             if (timer)
                 clearTimeout(timer);
-            removePrePendingCallPromise === null || removePrePendingCallPromise === void 0 ? void 0 : removePrePendingCallPromise(connectId, pendingPromise);
+            if (timedOut || completed)
+                removePrePendingCallPromise === null || removePrePendingCallPromise === void 0 ? void 0 : removePrePendingCallPromise(connectId, pendingPromise);
         }
         if (timedOut) {
             Log.warn('pre pending call promise timed out before call method', { connectId });
@@ -66100,10 +66152,20 @@ const onCallDevice = (context, message, method) => __awaiter(void 0, void 0, voi
         const pollingId = pollingManager.start(connectId);
         const env = DataManager.getSettings('env');
         const connect = () => ensureConnected(context, method, connectId, pollingId, method.abortSignal);
-        device =
-            DataManager.isBrowserWebUsb(env) || DataManager.isDesktopWebUsb(env)
-                ? yield requestQueue.waitForTask(task, () => context.methodSynchronize(connect, 'webusb-discovery'))
-                : yield connect();
+        if (DataManager.isBrowserWebUsb(env) || DataManager.isDesktopWebUsb(env)) {
+            const connectPromise = context.methodSynchronize(() => __awaiter(void 0, void 0, void 0, function* () {
+                var _k;
+                if ((_k = method.abortSignal) === null || _k === void 0 ? void 0 : _k.aborted) {
+                    throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.CallQueueActionCancelled);
+                }
+                return connect();
+            }), 'webusb-discovery');
+            connectPromise.catch(() => undefined);
+            device = yield requestQueue.waitForTask(task, () => connectPromise);
+        }
+        else {
+            device = yield connect();
+        }
         if ((_e = method.abortSignal) === null || _e === void 0 ? void 0 : _e.aborted) {
             throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.CallQueueActionCancelled);
         }
@@ -66168,12 +66230,12 @@ const onCallDevice = (context, message, method) => __awaiter(void 0, void 0, voi
             return waitForPendingPromise((_a = method.connectId) !== null && _a !== void 0 ? _a : '', getPrePendingCallPromise, removePrePendingCallPromise);
         });
         const inner = () => __awaiter(void 0, void 0, void 0, function* () {
-            var _k, _l;
+            var _l, _m;
             method.assertProtocolSupported(device.getProtocol(), device.getCurrentFirmwareType());
             protocolV2Operation = device.isProtocolV2();
             const versionRange = device.getCurrentMethodVersionRange(type => method.getVersionRange()[type]);
-            const currentFirmwareVersion = (_k = device.getCurrentFirmwareVersionString()) !== null && _k !== void 0 ? _k : '0.0.0';
-            const currentBleVersion = (_l = device.getCurrentBLEFirmwareVersionString()) !== null && _l !== void 0 ? _l : '0.0.0';
+            const currentFirmwareVersion = (_l = device.getCurrentFirmwareVersionString()) !== null && _l !== void 0 ? _l : '0.0.0';
+            const currentBleVersion = (_m = device.getCurrentBLEFirmwareVersionString()) !== null && _m !== void 0 ? _m : '0.0.0';
             const deviceFirmwareType = device.getCurrentFirmwareType();
             let newVersionStatus;
             if (device.features && !device.isProtocolV2()) {
@@ -66251,7 +66313,7 @@ const onCallDevice = (context, message, method) => __awaiter(void 0, void 0, voi
                         }
                     },
                     prepare: () => __awaiter(void 0, void 0, void 0, function* () {
-                        var _m, _o, _p, _q, _r, _s;
+                        var _o, _p, _q, _r, _s, _t;
                         if (method.deviceId && method.checkDeviceId && !deviceIdCheckedDuringUnlockPreflight) {
                             const isSameDeviceID = yield checkLiveDeviceId(device, method.deviceId);
                             if (!isSameDeviceID) {
@@ -66271,7 +66333,7 @@ const onCallDevice = (context, message, method) => __awaiter(void 0, void 0, voi
                                     require: support.require,
                                 });
                             }
-                            const passphraseStateSafety = yield device.checkPassphraseStateSafety((_m = method.payload) === null || _m === void 0 ? void 0 : _m.passphraseState, (_o = method.payload) === null || _o === void 0 ? void 0 : _o.useEmptyPassphrase, (_p = method.payload) === null || _p === void 0 ? void 0 : _p.skipPassphraseCheck, resolveDeriveCardano(method), (_q = method.protocolV2UnlockContext) === null || _q === void 0 ? void 0 : _q.preflightMainPinSelected);
+                            const passphraseStateSafety = yield device.checkPassphraseStateSafety((_o = method.payload) === null || _o === void 0 ? void 0 : _o.passphraseState, (_p = method.payload) === null || _p === void 0 ? void 0 : _p.useEmptyPassphrase, (_q = method.payload) === null || _q === void 0 ? void 0 : _q.skipPassphraseCheck, resolveDeriveCardano(method), (_r = method.protocolV2UnlockContext) === null || _r === void 0 ? void 0 : _r.preflightMainPinSelected);
                             checkPassphraseEnableState(method, device.features);
                             if (!passphraseStateSafety) {
                                 DevicePool.clearDeviceCache(method.payload.connectId);
@@ -66289,7 +66351,7 @@ const onCallDevice = (context, message, method) => __awaiter(void 0, void 0, voi
                                 ? e
                                 : hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.RuntimeError, 'open safety check failed.');
                         }
-                        (_s = (_r = method.device) === null || _r === void 0 ? void 0 : _r.commands) === null || _s === void 0 ? void 0 : _s.checkDisposed();
+                        (_t = (_s = method.device) === null || _s === void 0 ? void 0 : _s.commands) === null || _t === void 0 ? void 0 : _t.checkDisposed();
                     }),
                 });
                 messageResponse = createResponseMessage(method.responseID, true, response);
@@ -66644,10 +66706,11 @@ const ensureConnected = (_context, method, connectId, pollingId, abortSignal) =>
     const POLL_INTERVAL_TIME = (method.payload && method.payload.pollIntervalTime) || 1000;
     const TIME_OUT = (method.payload && method.payload.timeout) || 10000;
     let timer = null;
+    let lastInitializeError;
     Log.debug(`EnsureConnected function start, MAX_RETRY_COUNT=${MAX_RETRY_COUNT}, POLL_INTERVAL_TIME=${POLL_INTERVAL_TIME}  `);
     const poll = (time = POLL_INTERVAL_TIME) => __awaiter(void 0, void 0, void 0, function* () {
         return new Promise((resolve, reject) => __awaiter(void 0, void 0, void 0, function* () {
-            var _t;
+            var _u;
             const abort = () => {
                 if (abortSignal && abortSignal.aborted) {
                     if (timer) {
@@ -66676,8 +66739,10 @@ const ensureConnected = (_context, method, connectId, pollingId, abortSignal) =>
             Log.debug('EnsureConnected function try count: ', tryCount, ' poll interval time: ', time);
             try {
                 yield initDeviceList(method);
+                lastInitializeError = undefined;
             }
             catch (error) {
+                lastInitializeError = error;
                 Log.debug('device list error: ', error);
                 if ([
                     hdShared.HardwareErrorCode.BridgeNotInstalled,
@@ -66690,15 +66755,7 @@ const ensureConnected = (_context, method, connectId, pollingId, abortSignal) =>
                 }
                 if (error.errorCode === hdShared.HardwareErrorCode.TransportNotConfigured) {
                     yield TransportManager.configure();
-                }
-                else {
-                    const env = DataManager.getSettings('env');
-                    if (DataManager.isBrowserWebUsb(env) || DataManager.isDesktopWebUsb(env)) {
-                        if (timer)
-                            clearTimeout(timer);
-                        reject(error);
-                        return;
-                    }
+                    lastInitializeError = undefined;
                 }
             }
             if (abort()) {
@@ -66781,13 +66838,16 @@ const ensureConnected = (_context, method, connectId, pollingId, abortSignal) =>
                     clearTimeout(timer);
                 }
                 Log.debug('EnsureConnected get to max try count, will return: ', tryCount);
-                if (DataManager.isBrowserWebUsb(env) && !((_t = method.payload) === null || _t === void 0 ? void 0 : _t.skipWebDevicePrompt)) {
+                const preserveWebUsbInitError = DataManager.isBrowserWebUsb(env) || DataManager.isDesktopWebUsb(env);
+                const needsPermissionPrompt = DataManager.isBrowserWebUsb(env) && !((_u = method.payload) === null || _u === void 0 ? void 0 : _u.skipWebDevicePrompt);
+                const fallbackError = needsPermissionPrompt
+                    ? hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.WebDeviceNotFoundOrNeedsPermission)
+                    : hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.DeviceNotFound);
+                const errorToReject = preserveWebUsbInitError && lastInitializeError ? lastInitializeError : fallbackError;
+                if (needsPermissionPrompt && errorToReject === fallbackError) {
                     postMessage(createUiMessage(UI_REQUEST.WEB_DEVICE_PROMPT_ACCESS_PERMISSION));
-                    reject(hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.WebDeviceNotFoundOrNeedsPermission));
-                }
-                else {
-                    reject(hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.DeviceNotFound));
                 }
+                reject(errorToReject);
                 return;
             }
             if (abort()) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/hd-core",
-  "version": "1.2.2-alpha.113",
+  "version": "1.2.2-alpha.114",
   "description": "Core processes and APIs for communicating with OneKey hardware devices.",
   "author": "OneKey",
   "homepage": "https://github.com/OneKeyHQ/hardware-js-sdk#readme",
@@ -25,8 +25,8 @@
     "url": "https://github.com/OneKeyHQ/hardware-js-sdk/issues"
   },
   "dependencies": {
-    "@onekeyfe/hd-shared": "1.2.2-alpha.113",
-    "@onekeyfe/hd-transport": "1.2.2-alpha.113",
+    "@onekeyfe/hd-shared": "1.2.2-alpha.114",
+    "@onekeyfe/hd-transport": "1.2.2-alpha.114",
     "axios": "1.15.2",
     "bignumber.js": "^9.0.2",
     "buffer": "^6.0.3",
@@ -46,5 +46,5 @@
     "@types/w3c-web-usb": "^1.0.10",
     "@types/web-bluetooth": "^0.0.21"
   },
-  "gitHead": "32601b82b280b9ec97161cb4206a15cf9cd72881"
+  "gitHead": "6490382eeeb6bda264b71c7e9bf96143840ee1cb"
 }

package/src/api/SearchDevices.ts

@@ -1,4 +1,4 @@
-import { canonicalizePro2BleAdvertisementName } from '@onekeyfe/hd-shared';
+import { EDeviceType, canonicalizePro2BleAdvertisementName } from '@onekeyfe/hd-shared';
 
 import { BaseMethod } from './BaseMethod';
 import TransportManager from '../data-manager/TransportManager';
@@ -6,10 +6,46 @@ import { DataManager } from '../data-manager';
 import { LoggerNames, getDeviceTypeByBleName, getLogger } from '../utils';
 import { DevicePool } from '../device/DevicePool';
 
+import type { SearchDevice } from '../types/device';
 import type DeviceConnector from '../device/DeviceConnector';
+import type { OneKeyDeviceInfo as DeviceDescriptor } from '@onekeyfe/hd-transport';
+import type { Device } from '../device/Device';
 
 const Log = getLogger(LoggerNames.DevicePool);
 
+type RequestQueueLookup = {
+  getRequestTasksIdByConnectId: (connectId: string) => number[];
+};
+
+const isOwnedByActiveWebUsbRequest = (
+  descriptor: DeviceDescriptor,
+  requestQueue?: RequestQueueLookup
+) => {
+  if (!requestQueue) return false;
+  const keys = [descriptor.path, descriptor.id].filter(
+    (key): key is string => typeof key === 'string' && key.length > 0
+  );
+  return keys.some(key => requestQueue.getRequestTasksIdByConnectId(key).length > 0);
+};
+
+const toSearchDeviceFromDescriptor = (descriptor: DeviceDescriptor): SearchDevice => {
+  const connectId = descriptor.path || descriptor.id || null;
+  return {
+    connectId,
+    uuid: connectId ?? '',
+    serialNo: connectId,
+    deviceId: null,
+    deviceType: EDeviceType.Unknown,
+    name: descriptor.name || connectId || '',
+    commType: descriptor.commType,
+  };
+};
+
+const toSearchDevice = (device: Device): SearchDevice | null => {
+  const message = device.toMessageObject();
+  return message ? (message as SearchDevice) : null;
+};
+
 export default class SearchDevices extends BaseMethod {
   connector?: DeviceConnector;
 
@@ -19,14 +55,22 @@ export default class SearchDevices extends BaseMethod {
     this.skipForceUpdateCheck = true;
   }
 
-  async run() {
+  async run(): Promise<SearchDevice[]> {
     const env = DataManager.getSettings('env');
-    const useCachedWebUsbDevices =
-      (env === 'webusb' || env === 'desktop-webusb') &&
-      (this.context?.requestQueue.getRequestTasksId().length ?? 0) > 0;
-    // Core serializes WebUSB discovery with connection setup. A registered
-    // business request owns the connection, including its initialization phase.
-    if (!useCachedWebUsbDevices) await TransportManager.configure();
+    const isWebUsb = env === 'webusb' || env === 'desktop-webusb';
+    const requestQueue = this.context?.requestQueue;
+    const hasActiveWebUsbRequest = isWebUsb && (requestQueue?.getRequestTasksId().length ?? 0) > 0;
+    // Bring up WebUSB even when schema configuration is deferred while a
+    // business request owns the discovery lock. Failures here used to be
+    // swallowed by configure(); keep searchDevices resolving empty.
+    if (isWebUsb) {
+      try {
+        await TransportManager.ensureInitialized();
+      } catch (error) {
+        Log.debug('WebUSB bring-up unavailable', error);
+      }
+    }
+    if (!hasActiveWebUsbRequest) await TransportManager.configure();
     const deviceDiff = await this.connector?.enumerate();
     const devicesDescriptor = deviceDiff?.descriptors ?? [];
 
@@ -35,7 +79,7 @@ export default class SearchDevices extends BaseMethod {
      * to avoid device pairing
      */
     if (DataManager.isBleConnect(env)) {
-      const devices = [];
+      const devices: SearchDevice[] = [];
       const seenIds = new Set<string>();
 
       for (const device of devicesDescriptor) {
@@ -60,37 +104,41 @@ export default class SearchDevices extends BaseMethod {
       return devices;
     }
 
-    if (useCachedWebUsbDevices) {
-      return devicesDescriptor.flatMap(descriptor => {
-        const device = DevicePool.getDeviceByPath(descriptor.path);
-        return device?.features ? [device.toMessageObject()] : [];
-      });
-    }
-
-    const deviceList = [];
+    const deviceList: SearchDevice[] = [];
     for (const descriptor of devicesDescriptor) {
-      try {
-        // Discovery is best effort. Browsers may retain WebUSB grants for devices that
-        // are offline, busy, or not ready, so one descriptor must not abort the scan.
-        const result = await DevicePool.getDevices([descriptor], descriptor.path, {
-          // Discovery must actively identify the protocol instead of trusting a caller hint.
-          connectProtocol: undefined,
-          forceProtocolDetection: true,
-          refreshRuntimeState: true,
-        });
-        deviceList.push(...result.deviceList);
-      } catch (error) {
-        const errorCode =
-          error && typeof error === 'object' && 'errorCode' in error
-            ? (error as { errorCode?: unknown }).errorCode
-            : undefined;
-        Log.debug('Skip unavailable device during search', {
-          path: descriptor.path,
-          ...(errorCode !== undefined ? { errorCode } : {}),
-        });
+      if (hasActiveWebUsbRequest && isOwnedByActiveWebUsbRequest(descriptor, requestQueue)) {
+        const cached = DevicePool.getDeviceByPath(descriptor.path);
+        const message = cached?.features ? toSearchDevice(cached) : null;
+        // Do not probe a path an in-flight request already owns. A cache miss
+        // (passphrase switch / initSession) is still a connected device.
+        deviceList.push(message ?? toSearchDeviceFromDescriptor(descriptor));
+      } else {
+        try {
+          // Discovery is best effort. Browsers may retain WebUSB grants for devices that
+          // are offline, busy, or not ready, so one descriptor must not abort the scan.
+          const result = await DevicePool.getDevices([descriptor], descriptor.path, {
+            // Discovery must actively identify the protocol instead of trusting a caller hint.
+            connectProtocol: undefined,
+            forceProtocolDetection: true,
+            refreshRuntimeState: true,
+          });
+          for (const device of result.deviceList) {
+            const message = toSearchDevice(device);
+            if (message) deviceList.push(message);
+          }
+        } catch (error) {
+          const errorCode =
+            error && typeof error === 'object' && 'errorCode' in error
+              ? (error as { errorCode?: unknown }).errorCode
+              : undefined;
+          Log.debug('Skip unavailable device during search', {
+            path: descriptor.path,
+            ...(errorCode !== undefined ? { errorCode } : {}),
+          });
+        }
       }
     }
 
-    return deviceList.map(device => device.toMessageObject());
+    return deviceList;
   }
 }

package/src/core/index.ts

@@ -322,6 +322,7 @@ const waitForPendingPromise = async (
     Log.debug('pre pending call promise before call method, wait for it');
     let timer: ReturnType<typeof setTimeout> | undefined;
     let timedOut = false;
+    let completed = false;
     try {
       await Promise.race([
         pendingPromise,
@@ -332,11 +333,12 @@ const waitForPendingPromise = async (
           }, PRE_PENDING_CALL_TIMEOUT_MS);
         }),
       ]);
+      completed = !timedOut;
     } finally {
       if (timer) clearTimeout(timer);
-      // Match the legacy behavior: a stuck cleanup must not permanently poison
-      // this connectId. The next request will reacquire the device if needed.
-      removePrePendingCallPromise?.(connectId, pendingPromise);
+      // Keep a rejected cleanup barrier for the next caller's safety check;
+      // only a completed cleanup or a timeout may clear it.
+      if (timedOut || completed) removePrePendingCallPromise?.(connectId, pendingPromise);
     }
     if (timedOut) {
       Log.warn('pre pending call promise timed out before call method', { connectId });
@@ -422,12 +424,21 @@ const onCallDevice = async (
       ensureConnected(context, method, connectId, pollingId, method.abortSignal);
     // Discovery may acquire USB endpoints. Finish it before initializing a public
     // request; once registered, that request makes discovery use cached state only.
-    device =
-      DataManager.isBrowserWebUsb(env) || DataManager.isDesktopWebUsb(env)
-        ? await requestQueue.waitForTask(task, () =>
-            context.methodSynchronize(connect, 'webusb-discovery')
-          )
-        : await connect();
+    if (DataManager.isBrowserWebUsb(env) || DataManager.isDesktopWebUsb(env)) {
+      // Synchronization can keep the connect action queued after the caller is
+      // cancelled. Observe that promise so a late device-not-found error does
+      // not become an unhandled rejection.
+      const connectPromise = context.methodSynchronize(async () => {
+        if (method.abortSignal?.aborted) {
+          throw ERRORS.TypedError(HardwareErrorCode.CallQueueActionCancelled);
+        }
+        return connect();
+      }, 'webusb-discovery');
+      connectPromise.catch(() => undefined);
+      device = await requestQueue.waitForTask(task, () => connectPromise);
+    } else {
+      device = await connect();
+    }
     if (method.abortSignal?.aborted) {
       throw ERRORS.TypedError(HardwareErrorCode.CallQueueActionCancelled);
     }
@@ -1216,6 +1227,7 @@ const ensureConnected = async (
   const POLL_INTERVAL_TIME = (method.payload && method.payload.pollIntervalTime) || 1000;
   const TIME_OUT = (method.payload && method.payload.timeout) || 10000;
   let timer: ReturnType<typeof setTimeout> | null = null;
+  let lastInitializeError: any;
   Log.debug(
     `EnsureConnected function start, MAX_RETRY_COUNT=${MAX_RETRY_COUNT}, POLL_INTERVAL_TIME=${POLL_INTERVAL_TIME}  `
   );
@@ -1256,7 +1268,9 @@ const ensureConnected = async (
       Log.debug('EnsureConnected function try count: ', tryCount, ' poll interval time: ', time);
       try {
         await initDeviceList(method);
+        lastInitializeError = undefined;
       } catch (error) {
+        lastInitializeError = error;
         Log.debug('device list error: ', error);
         if (
           [
@@ -1271,15 +1285,7 @@ const ensureConnected = async (
         }
         if (error.errorCode === HardwareErrorCode.TransportNotConfigured) {
           await TransportManager.configure();
-        } else {
-          const env = DataManager.getSettings('env');
-          if (DataManager.isBrowserWebUsb(env) || DataManager.isDesktopWebUsb(env)) {
-            // Enumeration succeeded far enough to attempt initialization. Do not
-            // replace its failure with a lookup against the now-empty DeviceList.
-            if (timer) clearTimeout(timer);
-            reject(error);
-            return;
-          }
+          lastInitializeError = undefined;
         }
       }
 
@@ -1377,14 +1383,22 @@ const ensureConnected = async (
           clearTimeout(timer);
         }
         Log.debug('EnsureConnected get to max try count, will return: ', tryCount);
-        // Browser WebUSB needs permission prompt, desktop WebUSB doesn't
-        // skipWebDevicePrompt can override this behavior for special cases
-        if (DataManager.isBrowserWebUsb(env) && !method.payload?.skipWebDevicePrompt) {
+        const preserveWebUsbInitError =
+          DataManager.isBrowserWebUsb(env) || DataManager.isDesktopWebUsb(env);
+        const needsPermissionPrompt =
+          DataManager.isBrowserWebUsb(env) && !method.payload?.skipWebDevicePrompt;
+        const fallbackError = needsPermissionPrompt
+          ? ERRORS.TypedError(HardwareErrorCode.WebDeviceNotFoundOrNeedsPermission)
+          : ERRORS.TypedError(HardwareErrorCode.DeviceNotFound);
+        const errorToReject =
+          preserveWebUsbInitError && lastInitializeError ? lastInitializeError : fallbackError;
+        // Only ask the host for a WebUSB grant when the failure is actually
+        // "not found / needs permission". A preserved initialize error must
+        // not fire that prompt with a different public code.
+        if (needsPermissionPrompt && errorToReject === fallbackError) {
           postMessage(createUiMessage(UI_REQUEST.WEB_DEVICE_PROMPT_ACCESS_PERMISSION));
-          reject(ERRORS.TypedError(HardwareErrorCode.WebDeviceNotFoundOrNeedsPermission));
-        } else {
-          reject(ERRORS.TypedError(HardwareErrorCode.DeviceNotFound));
         }
+        reject(errorToReject);
         return;
       }
 

package/src/data-manager/TransportManager.ts

@@ -33,6 +33,8 @@ export default class TransportManager {
 
   static reactNativeInit = false;
 
+  static webUsbInit = false;
+
   static protocolV1MessageSchema: ProtocolV1MessageSchema = 'v1CurrentSchema';
 
   static plugin: LowlevelTransportSharedPlugin | null = null;
@@ -42,6 +44,17 @@ export default class TransportManager {
     this.defaultMessages = DataManager.getProtobufMessages();
     this.currentMessages = this.defaultMessages;
     this.protocolV1MessageSchema = 'v1CurrentSchema';
+    this.webUsbInit = false;
+  }
+
+  static async ensureInitialized() {
+    const env = DataManager.getSettings('env');
+    if (env !== 'webusb' && env !== 'desktop-webusb') return;
+    if (this.webUsbInit) return;
+    // The emitter registers USB disconnect events; this must happen even when
+    // schema configuration is intentionally deferred during discovery.
+    await this.transport.init(WebUsbLogger, DevicePool.emitter);
+    this.webUsbInit = true;
   }
 
   static async configure() {
@@ -69,9 +82,7 @@ export default class TransportManager {
       } else if (env === 'desktop-web-ble') {
         await this.transport.init(WebBleLogger, DevicePool.emitter);
       } else if (env === 'webusb' || env === 'desktop-webusb') {
-        // The emitter is what turns a navigator.usb 'disconnect' into a
-        // DEVICE.DISCONNECT; without it WebUSB never reports device removal.
-        await this.transport.init(WebUsbLogger, DevicePool.emitter);
+        await this.ensureInitialized();
       } else {
         await this.transport.init(HttpLogger);
       }