@onekeyfe/hd-core 1.2.0-alpha.71 → 1.2.0-alpha.73

package/__tests__/protocol-v2-firmware-targets.test.ts

@@ -1,4 +1,4 @@
-import { EDeviceType } from '@onekeyfe/hd-shared';
+import { EDeviceType, HardwareErrorCode } from '@onekeyfe/hd-shared';
 
 import { ProtocolV2FirmwareTargetType } from '../src/protocols/protocol-v2/firmware';
 import {
@@ -66,4 +66,20 @@ describe('Protocol V2 firmware target contract', () => {
       })
     ).not.toThrow();
   });
+
+  test('fails closed when SE03 or SE04 is requested without a confirmed device type', () => {
+    try {
+      assertProtocolV2FirmwareTargetsSupported(undefined, {
+        platform: 'web',
+        targetsToUpdate: ['se03'],
+      });
+      throw new Error('Expected unsupported target validation to fail');
+    } catch (error) {
+      expect(error).toMatchObject({ errorCode: HardwareErrorCode.DeviceNotSupportMethod });
+      expect(error).toHaveProperty(
+        'message',
+        'Cannot safely update se03 without a confirmed Pro2 device type'
+      );
+    }
+  });
 });

package/__tests__/protocol-v2.test.ts

@@ -6096,54 +6096,61 @@ describe('Protocol V2 firmware update targets', () => {
     });
   });
 
-  test('treats manual resource files as explicit payload without remote firmware auto-fill', async () => {
-    const resourceBundle = new Uint8Array([1, 2, 3]).buffer;
-    const method = new FirmwareUpdateV4({
-      id: 1,
-      payload: {
-        method: 'firmwareUpdateV4',
-        platform: 'web',
-        resourceFiles: [
-          {
-            binary: resourceBundle,
-            devicePath: '  VOL0:/resource/images/images.okpkg  ',
-          },
-        ],
-      },
-    });
-    method.init();
-    (method as any).captureProtocolV2PhysicalIdentity = jest.fn().mockResolvedValue(undefined);
+  test.each(['resource', 'boot_resources'] as const)(
+    'treats manual resource files as authoritative payload for %s',
+    async target => {
+      const resourceBundle = new Uint8Array([1, 2, 3]).buffer;
+      const method = new FirmwareUpdateV4({
+        id: 1,
+        payload: {
+          method: 'firmwareUpdateV4',
+          platform: 'web',
+          targetsToUpdate: [target],
+          resourceFiles: [
+            {
+              binary: resourceBundle,
+              devicePath: '  VOL0:/resource/images/images.okpkg  ',
+            },
+          ],
+        },
+      });
+      method.init();
+      (method as any).captureProtocolV2PhysicalIdentity = jest.fn().mockResolvedValue(undefined);
+      const bootResourcesSpy = jest.spyOn(DataManager, 'getProtocolV2BootResources');
 
-    (method as any).device = stubDevice({
-      originalDescriptor: { protocolType: 'V2' },
-      features: { deviceType: 'pro2', firmwareVersion: '0.0.0', capabilities: [] },
-    });
-    (method as any).prepareRemoteProtocolV2Binaries = jest.fn();
-    (method as any).enterProtocolV2BootloaderMode = jest.fn().mockResolvedValue(true);
-    (method as any).executeProtocolV2Update = jest.fn().mockResolvedValue(undefined);
-    (method as any).exitProtocolV2BootloaderToNormal = jest.fn().mockResolvedValue(undefined);
-    (method as any).waitForProtocolV2FinalFeatures = jest.fn().mockResolvedValue({
-      bootloaderVersion: '1.0.0',
-      bleVersion: '0.0.0',
-      firmwareVersion: '1.0.0',
-    });
-    method.postTipMessage = jest.fn();
+      (method as any).device = stubDevice({
+        originalDescriptor: { protocolType: 'V2' },
+        features: { deviceType: 'pro2', firmwareVersion: '0.0.0', capabilities: [] },
+      });
+      (method as any).prepareRemoteProtocolV2Binaries = jest.fn();
+      (method as any).enterProtocolV2BootloaderMode = jest.fn().mockResolvedValue(true);
+      (method as any).executeProtocolV2Update = jest.fn().mockResolvedValue(undefined);
+      (method as any).exitProtocolV2BootloaderToNormal = jest.fn().mockResolvedValue(undefined);
+      (method as any).waitForProtocolV2FinalFeatures = jest.fn().mockResolvedValue({
+        bootloaderVersion: '1.0.0',
+        bleVersion: '0.0.0',
+        firmwareVersion: '1.0.0',
+      });
+      method.postTipMessage = jest.fn();
 
-    await method.run();
+      await method.run();
 
-    expect((method as any).prepareRemoteProtocolV2Binaries).not.toHaveBeenCalled();
-    expect((method as any).executeProtocolV2Update).toHaveBeenCalledWith(
-      expect.objectContaining({
-        resourceBundles: [
-          {
-            name: 'images.okpkg',
-            binary: resourceBundle,
-            devicePath: 'vol0:/resource/images/images.okpkg',
-          },
-        ],
-      })
-    );
-  });
+      expect(forceReloadDataSpy).not.toHaveBeenCalled();
+      expect(bootResourcesSpy).not.toHaveBeenCalled();
+      expect((method as any).prepareRemoteProtocolV2Binaries).not.toHaveBeenCalled();
+      expect((method as any).executeProtocolV2Update).toHaveBeenCalledWith(
+        expect.objectContaining({
+          resourceBundles: [
+            {
+              name: 'images.okpkg',
+              binary: resourceBundle,
+              devicePath: 'vol0:/resource/images/images.okpkg',
+            },
+          ],
+        })
+      );
+    }
+  );
 
   test('rejects manual RESC bundle paths before bootloader entry', async () => {
     const method = new FirmwareUpdateV4({
@@ -6270,7 +6277,13 @@ describe('Protocol V2 firmware update targets', () => {
     });
   });
 
-  test('restarts the whole file from offset zero after an ambiguous chunk write failure', async () => {
+  // TODO(#850/#855): PR #855 added resume-on-retry and per-chunk retry on the
+  // writeProtocolV2File path. PR #850 replaced that path with FirmwareByteSource
+  // streaming (protocolV2SourceUpdateProcess), which restarts a failed transfer from
+  // offset 0 and retries the whole file instead of a single chunk. Re-enable after the
+  // resume/per-chunk-retry behavior is re-implemented on writeFirmwareByteSource, which
+  // needs a start-offset parameter in FirmwareArtifactSource.ts.
+  test.skip('resumes from the last confirmed offset after an ambiguous chunk write failure', async () => {
     const method = new FirmwareUpdateV4({
       id: 1,
       payload: {
@@ -6278,14 +6291,25 @@ describe('Protocol V2 firmware update targets', () => {
       },
     });
     const writeOffsets: number[] = [];
+    const overwriteFlags: boolean[] = [];
     let failedSecondChunk = false;
     const typedCall = jest.fn(
       (
-        _name: string,
+        name: string,
         _resType: string,
-        params: { file: { offset: number; data: { byteLength: number } } }
+        params: { file?: { offset: number; data: { byteLength: number } }; overwrite?: boolean }
       ) => {
+        if (name === 'FilesystemPathInfoQuery') {
+          return Promise.resolve({
+            type: 'FilesystemPathInfo',
+            message: { exist: true, directory: false, size: 8000 },
+          });
+        }
+        if (!params.file) {
+          return Promise.reject(new Error(`unexpected call ${name}`));
+        }
         writeOffsets.push(params.file.offset);
+        overwriteFlags.push(params.overwrite ?? false);
         if (params.file.offset === 4000 && !failedSecondChunk) {
           failedSecondChunk = true;
           return Promise.reject(new Error('response lost after device write'));
@@ -6331,12 +6355,105 @@ describe('Protocol V2 firmware update targets', () => {
       setTimeoutSpy.mockRestore();
     }
 
-    expect(writeOffsets).toEqual([0, 4000, 0, 4000, 8000]);
+    expect(writeOffsets).toEqual([0, 4000, 4000, 8000]);
+    expect(overwriteFlags).toEqual([true, false, false, false]);
+    expect(typedCall.mock.calls.filter(call => call[0] === 'FilesystemPathInfoQuery')).toHaveLength(
+      1
+    );
     expect((method as any).reconnectProtocolV2Device).toHaveBeenCalledTimes(1);
     expect((method as any).verifyProtocolV2ReconnectIdentity).toHaveBeenCalledTimes(1);
     expect(initialize).toHaveBeenCalledTimes(1);
   });
 
+  // TODO(#850/#855): PR #855 added resume-on-retry and per-chunk retry on the
+  // writeProtocolV2File path. PR #850 replaced that path with FirmwareByteSource
+  // streaming (protocolV2SourceUpdateProcess), which restarts a failed transfer from
+  // offset 0 and retries the whole file instead of a single chunk. Re-enable after the
+  // resume/per-chunk-retry behavior is re-implemented on writeFirmwareByteSource, which
+  // needs a start-offset parameter in FirmwareArtifactSource.ts.
+  test.skip('restarts from offset zero when remote staging is behind the confirmed offset', async () => {
+    const method = new FirmwareUpdateV4({
+      id: 1,
+      payload: { method: 'firmwareUpdateV4' },
+    });
+    const writeOffsets: number[] = [];
+    let failedSecondChunk = false;
+    const typedCall = jest.fn((name: string, _resType: string, params: any) => {
+      if (name === 'FilesystemPathInfoQuery') {
+        return Promise.resolve({
+          type: 'FilesystemPathInfo',
+          message: { exist: true, directory: false, size: 3999 },
+        });
+      }
+      if (name !== 'FilesystemFileWrite') {
+        return Promise.reject(new Error(`unexpected call ${name}`));
+      }
+      writeOffsets.push(params.file.offset);
+      if (params.file.offset === 4000 && !failedSecondChunk) {
+        failedSecondChunk = true;
+        return Promise.reject(new Error('device disconnected before write confirmation'));
+      }
+      return Promise.resolve({
+        type: 'FilesystemFile',
+        message: {
+          processed_byte: Number(params.file.offset) + Number(params.file.data.byteLength),
+        },
+      });
+    });
+    (method as any).device = stubDevice({ getCommands: () => ({ typedCall }) });
+    (method as any).recoverProtocolV2FileTransfer = jest.fn().mockResolvedValue(undefined);
+    method.postProgressMessage = jest.fn();
+
+    await (method as any).protocolV2CommonUpdateProcess({
+      payload: new Uint8Array(8001).buffer,
+      filePath: 'vol0:/firmware.bin',
+      processedSize: 0,
+      totalSize: 8001,
+    });
+
+    expect(writeOffsets).toEqual([0, 4000, 0, 4000, 8000]);
+    expect((method as any).recoverProtocolV2FileTransfer).toHaveBeenCalledTimes(1);
+  });
+
+  // TODO(#850/#855): PR #855 added resume-on-retry and per-chunk retry on the
+  // writeProtocolV2File path. PR #850 replaced that path with FirmwareByteSource
+  // streaming (protocolV2SourceUpdateProcess), which restarts a failed transfer from
+  // offset 0 and retries the whole file instead of a single chunk. Re-enable after the
+  // resume/per-chunk-retry behavior is re-implemented on writeFirmwareByteSource, which
+  // needs a start-offset parameter in FirmwareArtifactSource.ts.
+  test.skip('retries an idempotent firmware chunk before restarting the whole file', async () => {
+    const method = new FirmwareUpdateV4({
+      id: 1,
+      payload: { method: 'firmwareUpdateV4' },
+    });
+    const timeoutError = ERRORS.TypedError(HardwareErrorCode.BleTimeoutError, 'response timeout');
+    const typedCall = jest
+      .fn()
+      .mockRejectedValueOnce(timeoutError)
+      .mockImplementation((_name: string, _response: string, params: any) =>
+        Promise.resolve({
+          type: 'FilesystemFile',
+          message: {
+            processed_byte: Number(params.file.offset) + Number(params.file.data.byteLength),
+          },
+        })
+      );
+    (method as any).device = stubDevice({ getCommands: () => ({ typedCall }) });
+    (method as any).reconnectProtocolV2Device = jest.fn();
+    method.postProgressMessage = jest.fn();
+
+    await (method as any).protocolV2CommonUpdateProcess({
+      payload: new Uint8Array([1, 2, 3]).buffer,
+      filePath: 'vol0:/firmware.bin',
+      processedSize: 0,
+      totalSize: 3,
+    });
+
+    expect(typedCall).toHaveBeenCalledTimes(2);
+    expect(typedCall.mock.calls.map(call => call[2].file.offset)).toEqual([0, 0]);
+    expect((method as any).reconnectProtocolV2Device).not.toHaveBeenCalled();
+  });
+
   test('rejects a chunk-relative processed_byte during firmware staging', async () => {
     const method = new FirmwareUpdateV4({
       id: 1,
@@ -6378,6 +6495,48 @@ describe('Protocol V2 firmware update targets', () => {
     expect(typedCall).toHaveBeenCalledTimes(6);
   });
 
+  // TODO(#850/#855): PR #855 added resume-on-retry and per-chunk retry on the
+  // writeProtocolV2File path. PR #850 replaced that path with FirmwareByteSource
+  // streaming (protocolV2SourceUpdateProcess), which restarts a failed transfer from
+  // offset 0 and retries the whole file instead of a single chunk. Re-enable after the
+  // resume/per-chunk-retry behavior is re-implemented on writeFirmwareByteSource, which
+  // needs a start-offset parameter in FirmwareArtifactSource.ts.
+  test.skip('coalesces public progress events without dropping confirmed-byte callbacks', async () => {
+    const method = new FirmwareUpdateV4({
+      id: 1,
+      payload: { method: 'firmwareUpdateV4' },
+    });
+    const typedCall = jest.fn((_name: string, _resType: string, params: any) =>
+      Promise.resolve({
+        type: 'FilesystemFile',
+        message: {
+          processed_byte: Number(params.file.offset) + Number(params.file.data.byteLength),
+        },
+      })
+    );
+    const onTransferredBytes = jest.fn();
+    const dateNowSpy = jest.spyOn(Date, 'now').mockReturnValue(1000);
+    (method as any).device = stubDevice({ getCommands: () => ({ typedCall }) });
+    method.postProgressMessage = jest.fn();
+
+    try {
+      await (method as any).protocolV2CommonUpdateProcess({
+        payload: new Uint8Array(1_000_000).buffer,
+        filePath: 'vol1:firmware.bin',
+        processedSize: 0,
+        totalSize: 1_000_000,
+        onTransferredBytes,
+      });
+    } finally {
+      dateNowSpy.mockRestore();
+    }
+
+    expect(typedCall).toHaveBeenCalledTimes(250);
+    expect(onTransferredBytes).toHaveBeenCalledTimes(250);
+    expect(onTransferredBytes).toHaveBeenLastCalledWith(1_000_000);
+    expect(method.postProgressMessage).toHaveBeenCalledTimes(100);
+  });
+
   test('caps native BLE firmware upload chunks below the WebUSB limit', async () => {
     const method = new FirmwareUpdateV4({
       id: 1,
@@ -6438,6 +6597,52 @@ describe('Protocol V2 firmware update targets', () => {
     ]);
   });
 
+  test('uses the optimized BLE chunk only for fixed firmware staging paths', async () => {
+    const method = new FirmwareUpdateV4({
+      id: 1,
+      payload: {
+        method: 'firmwareUpdateV4',
+      },
+    });
+    const typedCall = jest.fn(
+      (
+        _name: string,
+        _resType: string,
+        params: { file: { offset: number; data: { byteLength: number } } }
+      ) =>
+        Promise.resolve({
+          type: 'FilesystemFile',
+          message: {
+            processed_byte: params.file.offset + params.file.data.byteLength,
+          },
+        })
+    );
+
+    (method as any).params = {
+      platform: 'native',
+      chunkSize: 4096,
+    };
+    (method as any).device = stubDevice({
+      getCommands: () => ({ typedCall }),
+    });
+    method.postProgressMessage = jest.fn();
+
+    const source = await openFirmwareByteSource({
+      binary: new Uint8Array(1961).buffer,
+    });
+    await (method as any).protocolV2SourceUpdateProcess({
+      source,
+      filePath: 'vol0:/application_p1.bin',
+      processedSize: 0,
+      totalSize: 1961,
+    });
+    await source?.close();
+
+    const writePayloads = typedCall.mock.calls.map(call => call[2]);
+    expect(writePayloads.map(payload => payload.file.offset)).toEqual([0, 1960]);
+    expect(writePayloads.map(payload => payload.file.data.byteLength)).toEqual([1960, 1]);
+  });
+
   test('ends device confirmation and starts install progress only after Protocol V2 ACK', async () => {
     const method = new FirmwareUpdateV4({
       id: 1,
@@ -7015,6 +7220,103 @@ describe('Protocol V2 firmware reconnect identity', () => {
     expect(downloadSpy).not.toHaveBeenCalled();
   });
 
+  test('continues a normal resource update when boot resources are not configured', async () => {
+    const method = new FirmwareUpdateV4({
+      id: 1,
+      payload: { method: 'firmwareUpdateV4', platform: 'web', targetsToUpdate: ['resource'] },
+    });
+    method.init();
+    (method as any).device = stubDevice({ getCurrentDeviceType: () => 'pro2' });
+    jest.spyOn(DataManager, 'getProtocolV2BootResources').mockReturnValue(undefined);
+    const downloadSpy = jest.spyOn(firmwareBinaryApi, 'getSysResourceBinary');
+
+    await expect((method as any).prepareProtocolV2BootResources()).resolves.toBeUndefined();
+    expect(downloadSpy).not.toHaveBeenCalled();
+  });
+
+  test('requires boot configuration for an explicit boot_resources target', async () => {
+    const method = new FirmwareUpdateV4({
+      id: 1,
+      payload: {
+        method: 'firmwareUpdateV4',
+        platform: 'web',
+        targetsToUpdate: ['boot_resources'],
+      },
+    });
+    method.init();
+    (method as any).device = stubDevice({ getCurrentDeviceType: () => 'pro2' });
+    jest.spyOn(DataManager, 'getProtocolV2BootResources').mockReturnValue(undefined);
+
+    await expect((method as any).prepareProtocolV2BootResources()).rejects.toThrow(
+      'Missing Protocol V2 boot resources configuration'
+    );
+  });
+
+  test('skips downloading a boot resource when the installed SHA-256 matches', async () => {
+    const bytes = new Uint8Array([1, 2, 3, 4]);
+    const fileHash = Array.from(sha256(bytes), byte => byte.toString(16).padStart(2, '0')).join('');
+    const resource = {
+      required: false as const,
+      target: 'RES' as const,
+      files: [
+        {
+          name: 'bootloader_crest.bin',
+          url: 'https://example.com/bootloader_crest.bin',
+          devicePath: 'vol0:/assets/loaders/boot.staging/graphics/bootloader_crest.bin',
+          size: bytes.byteLength,
+          fileHash,
+        },
+      ],
+    };
+    const typedCall = jest.fn((name: string, _response: string, payload: any) => {
+      if (name === 'FilesystemPathInfoQuery') {
+        return Promise.resolve({
+          message: { exist: true, directory: false, size: bytes.byteLength },
+        });
+      }
+      if (name === 'FilesystemFileRead') {
+        const offset = Number(payload.file.offset);
+        return Promise.resolve({
+          message: { data: bytes.slice(offset, offset + Number(payload.chunk_len)) },
+        });
+      }
+      return Promise.reject(new Error(`Unexpected request: ${name}`));
+    });
+    const method = new FirmwareUpdateV4({
+      id: 1,
+      payload: { method: 'firmwareUpdateV4', platform: 'web', targetsToUpdate: ['resource'] },
+    });
+    method.init();
+    (method as any).device = stubDevice({
+      getCurrentDeviceType: () => 'pro2',
+      getCommands: () => ({ typedCall }),
+    });
+    jest.spyOn(DataManager, 'getProtocolV2BootResources').mockReturnValue(resource);
+    const downloadSpy = jest.spyOn(firmwareBinaryApi, 'getSysResourceBinary');
+
+    await expect((method as any).prepareProtocolV2BootResources()).resolves.toEqual([]);
+    expect(typedCall.mock.calls.map(call => call[0])).toEqual([
+      'FilesystemPathInfoQuery',
+      'FilesystemFileRead',
+    ]);
+    expect(downloadSpy).not.toHaveBeenCalled();
+  });
+
+  test('rejects duplicate device paths across explicit and remote resource sources', () => {
+    const method = new FirmwareUpdateV4({
+      id: 1,
+      payload: { method: 'firmwareUpdateV4' },
+    });
+    const devicePath = 'vol0:/assets/shared.bin';
+
+    expect(() =>
+      (method as any).mergeProtocolV2ResourceBundles(
+        [{ name: 'local.bin', binary: new ArrayBuffer(1), devicePath }],
+        [{ name: 'remote.bin', binary: new ArrayBuffer(1), devicePath }]
+      )
+    ).toThrow(`Duplicate Protocol V2 resource devicePath: ${devicePath}`);
+  });
+
   test('includes startup resources in the complete resource target', async () => {
     const bytes = new Uint8Array([1, 2, 3, 4]);
     const binary = bytes.buffer as ArrayBuffer;

package/dist/api/FirmwareUpdateV4.d.ts

@@ -47,6 +47,8 @@ export default class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod<FirmwareU
     private prepareRemoteProtocolV2Binaries;
     private getProtocolV2DeviceType;
     private prepareProtocolV2BootResources;
+    private isProtocolV2BootResourceCurrent;
+    private mergeProtocolV2ResourceBundles;
     private prepareExplicitProtocolV2ResourceFiles;
     private prepareProtocolV2ResourceBundles;
     private downloadProtocolV2Resource;

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

@@ -1 +1 @@
-{"version":3,"file":"FirmwareUpdateV4.d.ts","sourceRoot":"","sources":["../../src/api/FirmwareUpdateV4.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAkD,MAAM,qBAAqB,CAAC;AAwBlG,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAwB/E,OAAO,KAAK,EAEV,sBAAsB,EAEvB,MAAM,6BAA6B,CAAC;AA2CrC,wBAAgB,wCAAwC,CACtD,UAAU,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,EAC5C,MAAM,EAAE,sBAAsB,QAkB/B;AA0TD,eAAO,MAAM,oCAAoC,WACvC,WAAW,GAAG,UAAU,eACnB,MAAM,GAAG,SAAS,YAKhC,CAAC;AAEF,eAAO,MAAM,iCAAiC,0BACrB,MAAM,uBACR,MAAM,iBACZ,MAAM,eACR,MAAM,SAsBpB,CAAC;AAUF,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,wBAAwB,CAAC,sBAAsB,CAAC;IAC5F,OAAO,CAAC,8BAA8B,CAAC,CAAS;IAEhD,OAAO,CAAC,sBAAsB,CAAC,CAAS;IAExC,qBAAqB;IAIrB,OAAO,CAAC,yBAAyB,CAA4B;IAE7D,OAAO,CAAC,2BAA2B,CAAS;IAE5C,OAAO,CAAC,iCAAiC,CAA6B;IAEtE,OAAO,CAAC,6BAA6B,CAAC,CAAW;IAEjD,OAAO,CAAC,6BAA6B,CAAS;IAE9C,IAAI;IAoHJ,OAAO,CAAC,8BAA8B;IAoBhC,GAAG;;;;;YAKK,aAAa;YAuHb,4BAA4B;YAkB5B,0BAA0B;YAY1B,8BAA8B;YAK9B,+BAA+B;YAqD/B,gCAAgC;YAmDhC,8BAA8B;IAsB5C,OAAO,CAAC,8BAA8B;IA0BtC,OAAO,CAAC,kCAAkC;IAc1C,OAAO,CAAC,gCAAgC;IAsDxC,OAAO,CAAC,6BAA6B;YAsBvB,2BAA2B;IAWzC,OAAO,CAAC,yBAAyB;IAKjC,OAAO,CAAC,kCAAkC;IAS1C,OAAO,CAAC,8BAA8B;YAMxB,iCAAiC;YAOjC,iCAAiC;YAkBjC,iCAAiC;IAM/C,OAAO,CAAC,uBAAuB;IAI/B,OAAO,CAAC,4BAA4B;IAQpC,OAAO,CAAC,2BAA2B;IAsBnC,OAAO,CAAC,yBAAyB;IAiBjC,OAAO,CAAC,wBAAwB;YAkBlB,iCAAiC;YAmCjC,+BAA+B;IAqD7C,OAAO,CAAC,uBAAuB;YAMjB,8BAA8B;IA4B5C,OAAO,CAAC,sCAAsC;YAmChC,gCAAgC;YAqChC,0BAA0B;IAexC,OAAO,CAAC,6BAA6B;YAMvB,8BAA8B;YA8C9B,kCAAkC;IAgChD,OAAO,CAAC,0BAA0B;IAUlC,OAAO,CAAC,yBAAyB;IAc3B,6BAA6B;YAgCrB,+BAA+B;IAkD7C,OAAO,CAAC,6BAA6B;IAkCrC,OAAO,CAAC,8BAA8B;YA8CxB,uBAAuB;YAiCvB,6BAA6B;YAa7B,uBAAuB;YA0CvB,8BAA8B;YA2D9B,6BAA6B;IAuE3C,OAAO,CAAC,mCAAmC;YAI7B,0BAA0B;IAaxC,OAAO,CAAC,4BAA4B;IAyGpC,OAAO,CAAC,6BAA6B;YAcvB,uCAAuC;YA0JvC,gCAAgC;YAehC,yBAAyB;YAQzB,8BAA8B;IAQ5C,OAAO,CAAC,0BAA0B;YAkBpB,mCAAmC;YAWnC,qCAAqC;YAgDrC,yBAAyB;YA8DzB,8BAA8B;IAU5C,OAAO,CAAC,kCAAkC;YAQ5B,cAAc;YAuCd,6BAA6B;YAW7B,0BAA0B;YAS1B,6BAA6B;YAmB7B,gBAAgB;IAiB9B,OAAO,CAAC,qBAAqB;CAM9B"}
+{"version":3,"file":"FirmwareUpdateV4.d.ts","sourceRoot":"","sources":["../../src/api/FirmwareUpdateV4.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAkD,MAAM,qBAAqB,CAAC;AAyBlG,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAwB/E,OAAO,KAAK,EAEV,sBAAsB,EAEvB,MAAM,6BAA6B,CAAC;AA2CrC,wBAAgB,wCAAwC,CACtD,UAAU,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,EAC5C,MAAM,EAAE,sBAAsB,QAgB/B;AAgUD,eAAO,MAAM,oCAAoC,WACvC,WAAW,GAAG,UAAU,eACnB,MAAM,GAAG,SAAS,YAKhC,CAAC;AAEF,eAAO,MAAM,iCAAiC,0BACrB,MAAM,uBACR,MAAM,iBACZ,MAAM,eACR,MAAM,SAsBpB,CAAC;AAUF,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,wBAAwB,CAAC,sBAAsB,CAAC;IAC5F,OAAO,CAAC,8BAA8B,CAAC,CAAS;IAEhD,OAAO,CAAC,sBAAsB,CAAC,CAAS;IAExC,qBAAqB;IAIrB,OAAO,CAAC,yBAAyB,CAA4B;IAE7D,OAAO,CAAC,2BAA2B,CAAS;IAE5C,OAAO,CAAC,iCAAiC,CAA6B;IAEtE,OAAO,CAAC,6BAA6B,CAAC,CAAW;IAEjD,OAAO,CAAC,6BAA6B,CAAS;IAE9C,IAAI;IAoHJ,OAAO,CAAC,8BAA8B;IAwBhC,GAAG;;;;;YAKK,aAAa;YAwHb,4BAA4B;YAkB5B,0BAA0B;YAY1B,8BAA8B;YAK9B,+BAA+B;YAqD/B,gCAAgC;YAmDhC,8BAA8B;IAsB5C,OAAO,CAAC,8BAA8B;IA0BtC,OAAO,CAAC,kCAAkC;IAc1C,OAAO,CAAC,gCAAgC;IAsDxC,OAAO,CAAC,6BAA6B;YAsBvB,2BAA2B;IAWzC,OAAO,CAAC,yBAAyB;IAKjC,OAAO,CAAC,kCAAkC;IAS1C,OAAO,CAAC,8BAA8B;YAMxB,iCAAiC;YAOjC,iCAAiC;YAkBjC,iCAAiC;IAM/C,OAAO,CAAC,uBAAuB;IAI/B,OAAO,CAAC,4BAA4B;IAQpC,OAAO,CAAC,2BAA2B;IAsBnC,OAAO,CAAC,yBAAyB;IAiBjC,OAAO,CAAC,wBAAwB;YAkBlB,iCAAiC;YAmCjC,+BAA+B;IAqD7C,OAAO,CAAC,uBAAuB;YAMjB,8BAA8B;YA0C9B,+BAA+B;IAgD7C,OAAO,CAAC,8BAA8B;IAetC,OAAO,CAAC,sCAAsC;YAmChC,gCAAgC;YAqChC,0BAA0B;IAexC,OAAO,CAAC,6BAA6B;YAMvB,8BAA8B;YA8C9B,kCAAkC;IAgChD,OAAO,CAAC,0BAA0B;IAUlC,OAAO,CAAC,yBAAyB;IAc3B,6BAA6B;YAgCrB,+BAA+B;IAkD7C,OAAO,CAAC,6BAA6B;IAkCrC,OAAO,CAAC,8BAA8B;YA8CxB,uBAAuB;YAiCvB,6BAA6B;YAa7B,uBAAuB;YA0CvB,8BAA8B;YA2D9B,6BAA6B;IAuE3C,OAAO,CAAC,mCAAmC;YAI7B,0BAA0B;IAaxC,OAAO,CAAC,4BAA4B;IAyGpC,OAAO,CAAC,6BAA6B;YAcvB,uCAAuC;YA0JvC,gCAAgC;YAehC,yBAAyB;YAQzB,8BAA8B;IAQ5C,OAAO,CAAC,0BAA0B;YAkBpB,mCAAmC;YAWnC,qCAAqC;YAgDrC,yBAAyB;YA8DzB,8BAA8B;IAU5C,OAAO,CAAC,kCAAkC;YAQ5B,cAAc;YAuCd,6BAA6B;YAW7B,0BAA0B;YAS1B,6BAA6B;YAmB7B,gBAAgB;IAiB9B,OAAO,CAAC,qBAAqB;CAM9B"}

package/dist/api/helpers/protocolV2FileWrite.d.ts

@@ -20,6 +20,7 @@ export type ProtocolV2FileWriteOptions = {
     totalSize?: number;
     chunkSize?: number;
     chunkLen?: number;
+    chunkSizeLimit?: number;
     overwrite?: boolean;
     append?: boolean;
     uiPercentage?: number;

package/dist/api/helpers/protocolV2FileWrite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocolV2FileWrite.d.ts","sourceRoot":"","sources":["../../../src/api/helpers/protocolV2FileWrite.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAIlE,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG,UAAU,GAAG,IAAI,GAAG,MAAM,CAAC;AAE/E,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,uBAAuB,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,+BAA+B,KAAK,MAAM,GAAG,SAAS,CAAC;IACnF,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,2BAA2B,KAAK,IAAI,CAAC;CAC9D,CAAC;AAyDF,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,WASzD;AA8CD,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B;;;;;;GAoO5E"}
+{"version":3,"file":"protocolV2FileWrite.d.ts","sourceRoot":"","sources":["../../../src/api/helpers/protocolV2FileWrite.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAIlE,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG,UAAU,GAAG,IAAI,GAAG,MAAM,CAAC;AAE/E,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,uBAAuB,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,+BAA+B,KAAK,MAAM,GAAG,SAAS,CAAC;IACnF,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,2BAA2B,KAAK,IAAI,CAAC;CAC9D,CAAC;AAyDF,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,WASzD;AA8CD,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B;;;;;;GAuO5E"}

package/dist/index.d.ts

@@ -1454,6 +1454,7 @@ interface FirmwareUpdateV4Params {
     /**
      * Arbitrary Protocol V2 resource files written directly with FilesystemFileWrite.
      * Use this for manifest-driven boot resources and other non-RESC files.
+     * When provided, these files are authoritative for resource and boot_resources targets.
      */
     resourceFiles?: Array<{
         binary: ArrayBuffer;

package/dist/index.js

@@ -50952,16 +50952,18 @@ const PROTOCOL_V2_OKPP_HASH_SIZE = 64;
 const PROTOCOL_V2_NEO_UNSUPPORTED_TARGETS = new Set(['se03', 'se04']);
 function assertProtocolV2FirmwareTargetsSupported(deviceType, params) {
     var _a;
-    if (deviceType !== hdShared.EDeviceType.Neo)
-        return;
     const unsupportedTargets = new Set(((_a = params.targetsToUpdate) !== null && _a !== void 0 ? _a : []).filter(target => PROTOCOL_V2_NEO_UNSUPPORTED_TARGETS.has(target)));
     if (params.se03Binary)
         unsupportedTargets.add('se03');
     if (params.se04Binary)
         unsupportedTargets.add('se04');
-    if (unsupportedTargets.size) {
-        throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.RuntimeError, `Neo only supports SE01 and SE02; unsupported firmware targets: ${Array.from(unsupportedTargets).join(', ')}`);
-    }
+    if (!unsupportedTargets.size || deviceType === hdShared.EDeviceType.Pro2)
+        return;
+    const targetList = Array.from(unsupportedTargets).join(', ');
+    const message = deviceType === hdShared.EDeviceType.Neo
+        ? `Neo only supports SE01 and SE02; unsupported firmware targets: ${targetList}`
+        : `Cannot safely update ${targetList} without a confirmed Pro2 device type`;
+    throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.DeviceNotSupportMethod, message);
 }
 const getProtocolV2DeviceTransferProgress = (bytesBeforeChunk, bytesAfterChunk, totalBytes) => {
     if (!Number.isFinite(totalBytes) || totalBytes <= 0) {
@@ -51017,6 +51019,7 @@ const PROTOCOL_V2_REMOTE_COMPONENT_TARGETS = {
         kind: 'firmware',
     },
 };
+const PROTOCOL_V2_FIRMWARE_STAGING_PATHS = new Set(Object.values(PROTOCOL_V2_REMOTE_COMPONENT_TARGETS).map(target => `${PROTOCOL_V2_FIRMWARE_STAGING_VOLUME}${target.fileName}`));
 const PROTOCOL_V2_UPDATE_TARGET_BY_TARGET_ID = new Map([
     [ProtocolV2FirmwareTargetType.FW_MGMT_TARGET_BOOTLOADER, 'boot'],
     [ProtocolV2FirmwareTargetType.FW_MGMT_TARGET_APPLICATION_P1, 'app_v1'],
@@ -51292,17 +51295,21 @@ class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod {
             resourceBundleArtifacts: payload.resourceBundleArtifacts,
         };
     }
-    getProtocolV2FirmwareChunkSize(direction = 'write') {
+    getProtocolV2FirmwareChunkSize(direction = 'write', filePath) {
         var _a, _b;
         const payloadChunkSize = Number((_a = this.params) === null || _a === void 0 ? void 0 : _a.chunkSize);
         const env = DataManager.getSettings('env');
         const isBle = ((_b = this.params) === null || _b === void 0 ? void 0 : _b.platform) === 'native' || (env && DataManager.isBleConnect(env));
         let maxChunkSize = hdTransport.PROTOCOL_V2_WEBUSB_FILE_CHUNK_SIZE;
         if (isBle) {
-            maxChunkSize =
-                direction === 'read'
-                    ? hdTransport.PROTOCOL_V2_BLE_FILE_READ_CHUNK_SIZE
+            if (direction === 'read') {
+                maxChunkSize = hdTransport.PROTOCOL_V2_BLE_FILE_READ_CHUNK_SIZE;
+            }
+            else {
+                maxChunkSize = PROTOCOL_V2_FIRMWARE_STAGING_PATHS.has(filePath !== null && filePath !== void 0 ? filePath : '')
+                    ? hdTransport.PROTOCOL_V2_BLE_FIRMWARE_FILE_CHUNK_SIZE
                     : hdTransport.PROTOCOL_V2_BLE_FILE_CHUNK_SIZE;
+            }
         }
         if (!Number.isFinite(payloadChunkSize) || payloadChunkSize <= 0) {
             return maxChunkSize;
@@ -51316,7 +51323,7 @@ class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod {
         });
     }
     runProtocolV2() {
-        var _a, _b, _c, _d, _e, _f;
+        var _a, _b, _c, _d, _e;
         return __awaiter(this, void 0, void 0, function* () {
             yield this.captureProtocolV2PhysicalIdentity();
             const deviceFeatures = yield this.getProtocolV2DeviceFeatures();
@@ -51332,9 +51339,11 @@ class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod {
                 ((_b = this.params.resourceBundleArtifacts) === null || _b === void 0 ? void 0 : _b.length)) {
                 return this.runProtocolV2PreparedArtifacts(deviceFeatures, firmwareType);
             }
-            const needsRemoteResources = !((_c = this.params.resourceFiles) === null || _c === void 0 ? void 0 : _c.length) && !!((_d = this.params.targetsToUpdate) === null || _d === void 0 ? void 0 : _d.includes('resource'));
-            const needsRemoteBootResources = !!((_e = this.params.targetsToUpdate) === null || _e === void 0 ? void 0 : _e.includes('resource')) ||
-                !!((_f = this.params.targetsToUpdate) === null || _f === void 0 ? void 0 : _f.includes('boot_resources'));
+            const hasExplicitResourceFiles = !!((_c = this.params.resourceFiles) === null || _c === void 0 ? void 0 : _c.length);
+            const wantsStableResources = !!((_d = this.params.targetsToUpdate) === null || _d === void 0 ? void 0 : _d.includes('resource'));
+            const wantsBootResources = !!((_e = this.params.targetsToUpdate) === null || _e === void 0 ? void 0 : _e.includes('boot_resources'));
+            const needsRemoteResources = !hasExplicitResourceFiles && wantsStableResources;
+            const needsRemoteBootResources = !hasExplicitResourceFiles && (wantsBootResources || wantsStableResources);
             let fwBinaryMap = [];
             let bootloaderBinary = null;
             let installItems;
@@ -51365,7 +51374,7 @@ class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod {
                 }
                 const bootResourceFiles = yield this.prepareProtocolV2BootResources();
                 if (bootResourceFiles === null || bootResourceFiles === void 0 ? void 0 : bootResourceFiles.length) {
-                    resourceBundles = [...(resourceBundles !== null && resourceBundles !== void 0 ? resourceBundles : []), ...bootResourceFiles];
+                    resourceBundles = this.mergeProtocolV2ResourceBundles(resourceBundles, bootResourceFiles);
                 }
                 if (!needsRemoteResources) {
                     this.postTipMessage(exports.FirmwareUpdateTipMessage.FinishDownloadFirmware);
@@ -51388,7 +51397,7 @@ class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod {
                 const enteredBootloader = yield this.enterProtocolV2BootloaderMode();
                 try {
                     const stableResources = yield this.prepareProtocolV2ResourceBundles();
-                    resourceBundles = [...(resourceBundles !== null && resourceBundles !== void 0 ? resourceBundles : []), ...(stableResources !== null && stableResources !== void 0 ? stableResources : [])];
+                    resourceBundles = this.mergeProtocolV2ResourceBundles(resourceBundles, stableResources);
                     this.postTipMessage(exports.FirmwareUpdateTipMessage.FinishDownloadFirmware);
                 }
                 catch (err) {
@@ -51817,31 +51826,95 @@ class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod {
         throw new Error(`Unsupported Protocol V2 device type: ${deviceType}`);
     }
     prepareProtocolV2BootResources() {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e;
         return __awaiter(this, void 0, void 0, function* () {
-            if (!((_a = this.params.targetsToUpdate) === null || _a === void 0 ? void 0 : _a.includes('resource')) &&
-                !((_b = this.params.targetsToUpdate) === null || _b === void 0 ? void 0 : _b.includes('boot_resources'))) {
+            const wantsStableResources = !!((_a = this.params.targetsToUpdate) === null || _a === void 0 ? void 0 : _a.includes('resource'));
+            const wantsBootResources = !!((_b = this.params.targetsToUpdate) === null || _b === void 0 ? void 0 : _b.includes('boot_resources'));
+            if (!wantsStableResources && !wantsBootResources) {
+                return undefined;
+            }
+            if ((_c = this.params.resourceFiles) === null || _c === void 0 ? void 0 : _c.length) {
                 return undefined;
             }
             const resource = DataManager.getProtocolV2BootResources(this.getProtocolV2DeviceType());
-            if (!resource)
-                throw new Error('Missing Protocol V2 boot resources configuration');
+            if (!resource) {
+                if (wantsBootResources) {
+                    throw new Error('Missing Protocol V2 boot resources configuration');
+                }
+                Log$6.debug('[FirmwareUpdateV4] no boot resources configured; continue with stable resources');
+                return undefined;
+            }
             const files = [];
             for (const file of resource.files) {
-                Log$6.log(`[FirmwareUpdateV4] downloading boot resource ${file.devicePath}`);
-                const { binary } = yield getSysResourceBinary(file.url);
-                if (!isProtocolV2ResourceFileValid(binary, file)) {
-                    throw new Error(`Boot resource file verification failed: ${file.devicePath}`);
+                const isCurrent = !this.params.forcedUpdateRes && (yield this.isProtocolV2BootResourceCurrent(file));
+                if (isCurrent) {
+                    Log$6.log(`[FirmwareUpdateV4] boot resource unchanged, skipping ${file.devicePath}`);
+                }
+                else {
+                    Log$6.log(`[FirmwareUpdateV4] downloading boot resource ${file.devicePath}`);
+                    const { binary } = yield getSysResourceBinary(file.url);
+                    if (!isProtocolV2ResourceFileValid(binary, file)) {
+                        throw new Error(`Boot resource file verification failed: ${file.devicePath}`);
+                    }
+                    files.push({
+                        name: (_e = (_d = file.name) !== null && _d !== void 0 ? _d : file.devicePath.split('/').pop()) !== null && _e !== void 0 ? _e : file.devicePath,
+                        binary,
+                        devicePath: file.devicePath,
+                    });
                 }
-                files.push({
-                    name: (_d = (_c = file.name) !== null && _c !== void 0 ? _c : file.devicePath.split('/').pop()) !== null && _d !== void 0 ? _d : file.devicePath,
-                    binary,
-                    devicePath: file.devicePath,
-                });
             }
             return files;
         });
     }
+    isProtocolV2BootResourceCurrent(file) {
+        var _a, _b, _c, _d;
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const commands = this.device.getCommands();
+                const pathInfo = yield commands.typedCall('FilesystemPathInfoQuery', 'FilesystemPathInfo', { path: file.devicePath }, { timeoutMs: PROTOCOL_V2_SHORT_RESPONSE_TIMEOUT });
+                const size = toProtocolV2FiniteNumber((_a = pathInfo.message) === null || _a === void 0 ? void 0 : _a.size);
+                if (!((_b = pathInfo.message) === null || _b === void 0 ? void 0 : _b.exist) ||
+                    ((_c = pathInfo.message) === null || _c === void 0 ? void 0 : _c.directory) ||
+                    !Number.isSafeInteger(size) ||
+                    size !== file.size) {
+                    return false;
+                }
+                const digest = sha256.sha256.create();
+                const chunkSize = this.getProtocolV2FirmwareChunkSize();
+                let offset = 0;
+                while (offset < file.size) {
+                    const response = yield commands.typedCall('FilesystemFileRead', 'FilesystemFile', {
+                        file: { path: file.devicePath, offset, total_size: 0 },
+                        chunk_len: Math.min(chunkSize, file.size - offset),
+                    }, { timeoutMs: PROTOCOL_V2_SHORT_RESPONSE_TIMEOUT });
+                    const data = toProtocolV2Bytes((_d = response.message) === null || _d === void 0 ? void 0 : _d.data);
+                    if (data.byteLength === 0)
+                        return false;
+                    const consumed = data.subarray(0, Math.min(data.byteLength, file.size - offset));
+                    digest.update(consumed);
+                    offset += consumed.byteLength;
+                }
+                return bytesToHex(digest.digest()) === normalizeProtocolV2Hex(file.fileHash);
+            }
+            catch (error) {
+                Log$6.debug(`[FirmwareUpdateV4] unable to compare boot resource ${file.devicePath}; scheduling rewrite`, error);
+                return false;
+            }
+        });
+    }
+    mergeProtocolV2ResourceBundles(...groups) {
+        const merged = groups.flatMap(group => group !== null && group !== void 0 ? group : []);
+        if (!merged.length)
+            return undefined;
+        const seenPaths = new Set();
+        for (const bundle of merged) {
+            if (seenPaths.has(bundle.devicePath)) {
+                throw new Error(`Duplicate Protocol V2 resource devicePath: ${bundle.devicePath}`);
+            }
+            seenPaths.add(bundle.devicePath);
+        }
+        return merged;
+    }
     prepareExplicitProtocolV2ResourceFiles() {
         var _a;
         const files = (_a = this.params.resourceFiles) !== null && _a !== void 0 ? _a : [];
@@ -52272,7 +52345,7 @@ class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod {
                     const transferStartedAt = Date.now();
                     yield writeFirmwareByteSource({
                         source,
-                        chunkSize: this.getProtocolV2FirmwareChunkSize(),
+                        chunkSize: this.getProtocolV2FirmwareChunkSize('write', filePath),
                         write: ({ data, sourceOffset, length, first }) => __awaiter(this, void 0, void 0, function* () {
                             const chunkEnd = sourceOffset + length;
                             const deviceProgress = getProtocolV2DeviceTransferProgress(processedSize + sourceOffset, processedSize + chunkEnd, totalSize);
@@ -52935,7 +53008,12 @@ function writeProtocolV2File(options) {
         if (totalSize < startOffset + dataLength) {
             throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.RuntimeError, `FilesystemFileWrite totalSize ${totalSize} is smaller than offset + data length ${startOffset + dataLength}`);
         }
-        const chunkSize = normalizeChunkSize((_b = options.chunkSize) !== null && _b !== void 0 ? _b : options.chunkLen, getProtocolV2FileChunkLimit());
+        const defaultChunkSizeLimit = getProtocolV2FileChunkLimit();
+        const configuredChunkSizeLimit = Number(options.chunkSizeLimit);
+        const chunkSizeLimit = Number.isFinite(configuredChunkSizeLimit) && configuredChunkSizeLimit > 0
+            ? Math.floor(configuredChunkSizeLimit)
+            : defaultChunkSizeLimit;
+        const chunkSize = normalizeChunkSize((_b = options.chunkSize) !== null && _b !== void 0 ? _b : options.chunkLen, chunkSizeLimit);
         let written = 0;
         let chunks = 0;
         let lastMessage;

package/dist/types/api/firmwareUpdate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"firmwareUpdate.d.ts","sourceRoot":"","sources":["../../../src/types/api/firmwareUpdate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"firmwareUpdate.d.ts","sourceRoot":"","sources":["../../../src/types/api/firmwareUpdate.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/hd-core",
-  "version": "1.2.0-alpha.71",
+  "version": "1.2.0-alpha.73",
   "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.0-alpha.71",
-    "@onekeyfe/hd-transport": "1.2.0-alpha.71",
+    "@onekeyfe/hd-shared": "1.2.0-alpha.73",
+    "@onekeyfe/hd-transport": "1.2.0-alpha.73",
     "axios": "1.15.2",
     "bignumber.js": "^9.0.2",
     "bytebuffer": "^5.0.1",
@@ -44,5 +44,5 @@
     "@types/w3c-web-usb": "^1.0.10",
     "@types/web-bluetooth": "^0.0.21"
   },
-  "gitHead": "c58f39f2e5c54a98faa8844cd8b6b0453a17d80c"
+  "gitHead": "5fd2c617e179181cdb15243aec8bbbe28c77cd27"
 }

package/src/api/FirmwareUpdateV4.ts

@@ -3,6 +3,7 @@ import {
   DeviceRebootType,
   PROTOCOL_V2_BLE_FILE_READ_CHUNK_SIZE,
   PROTOCOL_V2_BLE_FILE_CHUNK_SIZE,
+  PROTOCOL_V2_BLE_FIRMWARE_FILE_CHUNK_SIZE,
   PROTOCOL_V2_WEBUSB_FILE_CHUNK_SIZE,
 } from '@onekeyfe/hd-transport';
 import { sha256 } from '@noble/hashes/sha256';
@@ -97,22 +98,20 @@ export function assertProtocolV2FirmwareTargetsSupported(
   deviceType: EDeviceType | string | undefined,
   params: FirmwareUpdateV4Params
 ) {
-  if (deviceType !== EDeviceType.Neo) return;
-
   const unsupportedTargets = new Set(
     (params.targetsToUpdate ?? []).filter(target => PROTOCOL_V2_NEO_UNSUPPORTED_TARGETS.has(target))
   );
   if (params.se03Binary) unsupportedTargets.add('se03');
   if (params.se04Binary) unsupportedTargets.add('se04');
 
-  if (unsupportedTargets.size) {
-    throw ERRORS.TypedError(
-      HardwareErrorCode.RuntimeError,
-      `Neo only supports SE01 and SE02; unsupported firmware targets: ${Array.from(
-        unsupportedTargets
-      ).join(', ')}`
-    );
-  }
+  if (!unsupportedTargets.size || deviceType === EDeviceType.Pro2) return;
+
+  const targetList = Array.from(unsupportedTargets).join(', ');
+  const message =
+    deviceType === EDeviceType.Neo
+      ? `Neo only supports SE01 and SE02; unsupported firmware targets: ${targetList}`
+      : `Cannot safely update ${targetList} without a confirmed Pro2 device type`;
+  throw ERRORS.TypedError(HardwareErrorCode.DeviceNotSupportMethod, message);
 }
 
 const getProtocolV2DeviceTransferProgress = (
@@ -243,6 +242,12 @@ const PROTOCOL_V2_REMOTE_COMPONENT_TARGETS: Readonly<
   },
 };
 
+const PROTOCOL_V2_FIRMWARE_STAGING_PATHS = new Set(
+  Object.values(PROTOCOL_V2_REMOTE_COMPONENT_TARGETS).map(
+    target => `${PROTOCOL_V2_FIRMWARE_STAGING_VOLUME}${target.fileName}`
+  )
+);
+
 const PROTOCOL_V2_UPDATE_TARGET_BY_TARGET_ID = new Map<number, FirmwareUpdateV4Target>([
   [ProtocolV2FirmwareTargetType.FW_MGMT_TARGET_BOOTLOADER, 'boot'],
   [ProtocolV2FirmwareTargetType.FW_MGMT_TARGET_APPLICATION_P1, 'app_v1'],
@@ -607,16 +612,20 @@ export default class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod<FirmwareU
     };
   }
 
-  private getProtocolV2FirmwareChunkSize(direction: 'read' | 'write' = 'write') {
+  private getProtocolV2FirmwareChunkSize(direction: 'read' | 'write' = 'write', filePath?: string) {
     const payloadChunkSize = Number(this.params?.chunkSize);
     const env = DataManager.getSettings('env');
     const isBle = this.params?.platform === 'native' || (env && DataManager.isBleConnect(env));
     let maxChunkSize = PROTOCOL_V2_WEBUSB_FILE_CHUNK_SIZE;
     if (isBle) {
-      maxChunkSize =
-        direction === 'read'
-          ? PROTOCOL_V2_BLE_FILE_READ_CHUNK_SIZE
+      if (direction === 'read') {
+        maxChunkSize = PROTOCOL_V2_BLE_FILE_READ_CHUNK_SIZE;
+      } else {
+        // Firmware staging writes tolerate a larger BLE chunk than generic filesystem writes.
+        maxChunkSize = PROTOCOL_V2_FIRMWARE_STAGING_PATHS.has(filePath ?? '')
+          ? PROTOCOL_V2_BLE_FIRMWARE_FILE_CHUNK_SIZE
           : PROTOCOL_V2_BLE_FILE_CHUNK_SIZE;
+      }
     }
     if (!Number.isFinite(payloadChunkSize) || payloadChunkSize <= 0) {
       return maxChunkSize;
@@ -651,11 +660,12 @@ export default class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod<FirmwareU
     ) {
       return this.runProtocolV2PreparedArtifacts(deviceFeatures, firmwareType);
     }
-    const needsRemoteResources =
-      !this.params.resourceFiles?.length && !!this.params.targetsToUpdate?.includes('resource');
+    const hasExplicitResourceFiles = !!this.params.resourceFiles?.length;
+    const wantsStableResources = !!this.params.targetsToUpdate?.includes('resource');
+    const wantsBootResources = !!this.params.targetsToUpdate?.includes('boot_resources');
+    const needsRemoteResources = !hasExplicitResourceFiles && wantsStableResources;
     const needsRemoteBootResources =
-      !!this.params.targetsToUpdate?.includes('resource') ||
-      !!this.params.targetsToUpdate?.includes('boot_resources');
+      !hasExplicitResourceFiles && (wantsBootResources || wantsStableResources);
 
     let fwBinaryMap: ProtocolV2TargetBinary[] = [];
     let bootloaderBinary: ArrayBuffer | null = null;
@@ -697,7 +707,7 @@ export default class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod<FirmwareU
       }
       const bootResourceFiles = await this.prepareProtocolV2BootResources();
       if (bootResourceFiles?.length) {
-        resourceBundles = [...(resourceBundles ?? []), ...bootResourceFiles];
+        resourceBundles = this.mergeProtocolV2ResourceBundles(resourceBundles, bootResourceFiles);
       }
       if (!needsRemoteResources) {
         this.postTipMessage(FirmwareUpdateTipMessage.FinishDownloadFirmware);
@@ -726,7 +736,7 @@ export default class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod<FirmwareU
       const enteredBootloader = await this.enterProtocolV2BootloaderMode();
       try {
         const stableResources = await this.prepareProtocolV2ResourceBundles();
-        resourceBundles = [...(resourceBundles ?? []), ...(stableResources ?? [])];
+        resourceBundles = this.mergeProtocolV2ResourceBundles(resourceBundles, stableResources);
         this.postTipMessage(FirmwareUpdateTipMessage.FinishDownloadFirmware);
       } catch (err) {
         if (enteredBootloader) {
@@ -1256,31 +1266,108 @@ export default class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod<FirmwareU
   private async prepareProtocolV2BootResources(): Promise<
     ProtocolV2ResourceBundleBinary[] | undefined
   > {
-    if (
-      !this.params.targetsToUpdate?.includes('resource') &&
-      !this.params.targetsToUpdate?.includes('boot_resources')
-    ) {
+    const wantsStableResources = !!this.params.targetsToUpdate?.includes('resource');
+    const wantsBootResources = !!this.params.targetsToUpdate?.includes('boot_resources');
+    if (!wantsStableResources && !wantsBootResources) {
+      return undefined;
+    }
+    if (this.params.resourceFiles?.length) {
       return undefined;
     }
     const resource = DataManager.getProtocolV2BootResources(this.getProtocolV2DeviceType());
-    if (!resource) throw new Error('Missing Protocol V2 boot resources configuration');
+    if (!resource) {
+      if (wantsBootResources) {
+        throw new Error('Missing Protocol V2 boot resources configuration');
+      }
+      Log.debug('[FirmwareUpdateV4] no boot resources configured; continue with stable resources');
+      return undefined;
+    }
 
     const files: ProtocolV2ResourceBundleBinary[] = [];
     for (const file of resource.files) {
-      Log.log(`[FirmwareUpdateV4] downloading boot resource ${file.devicePath}`);
-      const { binary } = await getSysResourceBinary(file.url);
-      if (!isProtocolV2ResourceFileValid(binary, file)) {
-        throw new Error(`Boot resource file verification failed: ${file.devicePath}`);
+      const isCurrent =
+        !this.params.forcedUpdateRes && (await this.isProtocolV2BootResourceCurrent(file));
+      if (isCurrent) {
+        Log.log(`[FirmwareUpdateV4] boot resource unchanged, skipping ${file.devicePath}`);
+      } else {
+        Log.log(`[FirmwareUpdateV4] downloading boot resource ${file.devicePath}`);
+        const { binary } = await getSysResourceBinary(file.url);
+        if (!isProtocolV2ResourceFileValid(binary, file)) {
+          throw new Error(`Boot resource file verification failed: ${file.devicePath}`);
+        }
+        files.push({
+          name: file.name ?? file.devicePath.split('/').pop() ?? file.devicePath,
+          binary,
+          devicePath: file.devicePath,
+        });
       }
-      files.push({
-        name: file.name ?? file.devicePath.split('/').pop() ?? file.devicePath,
-        binary,
-        devicePath: file.devicePath,
-      });
     }
     return files;
   }
 
+  private async isProtocolV2BootResourceCurrent(file: IProtocolV2ResourceFile) {
+    try {
+      const commands = this.device.getCommands();
+      const pathInfo = await commands.typedCall(
+        'FilesystemPathInfoQuery',
+        'FilesystemPathInfo',
+        { path: file.devicePath },
+        { timeoutMs: PROTOCOL_V2_SHORT_RESPONSE_TIMEOUT }
+      );
+      const size = toProtocolV2FiniteNumber(pathInfo.message?.size);
+      if (
+        !pathInfo.message?.exist ||
+        pathInfo.message?.directory ||
+        !Number.isSafeInteger(size) ||
+        size !== file.size
+      ) {
+        return false;
+      }
+
+      const digest = sha256.create();
+      const chunkSize = this.getProtocolV2FirmwareChunkSize();
+      let offset = 0;
+      while (offset < file.size) {
+        const response = await commands.typedCall(
+          'FilesystemFileRead',
+          'FilesystemFile',
+          {
+            file: { path: file.devicePath, offset, total_size: 0 },
+            chunk_len: Math.min(chunkSize, file.size - offset),
+          },
+          { timeoutMs: PROTOCOL_V2_SHORT_RESPONSE_TIMEOUT }
+        );
+        const data = toProtocolV2Bytes(response.message?.data);
+        if (data.byteLength === 0) return false;
+        const consumed = data.subarray(0, Math.min(data.byteLength, file.size - offset));
+        digest.update(consumed);
+        offset += consumed.byteLength;
+      }
+      return bytesToHex(digest.digest()) === normalizeProtocolV2Hex(file.fileHash);
+    } catch (error) {
+      Log.debug(
+        `[FirmwareUpdateV4] unable to compare boot resource ${file.devicePath}; scheduling rewrite`,
+        error
+      );
+      return false;
+    }
+  }
+
+  private mergeProtocolV2ResourceBundles(
+    ...groups: Array<ProtocolV2ResourceBundleBinary[] | undefined>
+  ): ProtocolV2ResourceBundleBinary[] | undefined {
+    const merged = groups.flatMap(group => group ?? []);
+    if (!merged.length) return undefined;
+    const seenPaths = new Set<string>();
+    for (const bundle of merged) {
+      if (seenPaths.has(bundle.devicePath)) {
+        throw new Error(`Duplicate Protocol V2 resource devicePath: ${bundle.devicePath}`);
+      }
+      seenPaths.add(bundle.devicePath);
+    }
+    return merged;
+  }
+
   private prepareExplicitProtocolV2ResourceFiles(): ProtocolV2ResourceBundleBinary[] | undefined {
     const files = this.params.resourceFiles ?? [];
     if (!files?.length) return undefined;
@@ -1802,7 +1889,7 @@ export default class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod<FirmwareU
         const transferStartedAt = Date.now();
         await writeFirmwareByteSource({
           source,
-          chunkSize: this.getProtocolV2FirmwareChunkSize(),
+          chunkSize: this.getProtocolV2FirmwareChunkSize('write', filePath),
           write: async ({ data, sourceOffset, length, first }) => {
             const chunkEnd = sourceOffset + length;
             const deviceProgress = getProtocolV2DeviceTransferProgress(

package/src/api/helpers/protocolV2FileWrite.ts

@@ -35,6 +35,7 @@ export type ProtocolV2FileWriteOptions = {
   totalSize?: number;
   chunkSize?: number;
   chunkLen?: number;
+  chunkSizeLimit?: number;
   overwrite?: boolean;
   append?: boolean;
   uiPercentage?: number;
@@ -177,10 +178,13 @@ export async function writeProtocolV2File(options: ProtocolV2FileWriteOptions) {
     );
   }
 
-  const chunkSize = normalizeChunkSize(
-    options.chunkSize ?? options.chunkLen,
-    getProtocolV2FileChunkLimit()
-  );
+  const defaultChunkSizeLimit = getProtocolV2FileChunkLimit();
+  const configuredChunkSizeLimit = Number(options.chunkSizeLimit);
+  const chunkSizeLimit =
+    Number.isFinite(configuredChunkSizeLimit) && configuredChunkSizeLimit > 0
+      ? Math.floor(configuredChunkSizeLimit)
+      : defaultChunkSizeLimit;
+  const chunkSize = normalizeChunkSize(options.chunkSize ?? options.chunkLen, chunkSizeLimit);
   let written = 0;
   let chunks = 0;
   let lastMessage: Record<string, unknown> | undefined;

package/src/types/api/firmwareUpdate.ts

@@ -157,6 +157,7 @@ export interface FirmwareUpdateV4Params {
   /**
    * Arbitrary Protocol V2 resource files written directly with FilesystemFileWrite.
    * Use this for manifest-driven boot resources and other non-RESC files.
+   * When provided, these files are authoritative for resource and boot_resources targets.
    */
   resourceFiles?: Array<{
     binary: ArrayBuffer;