@onekeyfe/hd-core 1.2.0-alpha.20 → 1.2.0-alpha.22

package/src/types/api/index.ts

@@ -1,27 +1,7 @@
 import type {
-  deviceFactoryInfoGet,
-  deviceFactoryInfoSet,
-  deviceFirmwareUpdate,
-  deviceGetFirmwareUpdateStatus,
   deviceGetOnboardingStatus,
-  deviceInfoGet,
   deviceReboot,
-  deviceSettingsGet,
-  deviceSettingsPageShow,
-  deviceSettingsSet,
-  deviceStatusGet,
   deviceUploadWallpaper,
-  dirList,
-  dirMake,
-  dirRemove,
-  fileDelete,
-  fileRead,
-  fileWrite,
-  filesystemFormat,
-  filesystemPermissionFix,
-  pathInfo,
-  ping,
-  protocolInfoRequest,
   uploadPortfolio,
 } from './protocolV2';
 import type { off, on, removeAllListeners } from './event';
@@ -49,7 +29,15 @@ import type {
   firmwareUpdateV2,
   firmwareUpdateV3,
   firmwareUpdateV4,
+  getFirmwareUpdateHostBindingGeneration,
+  registerFirmwareUpdateHostBinding,
+  unregisterFirmwareUpdateHostBinding,
 } from './firmwareUpdate';
+import type { getFirmwareUpdateCapabilities } from './firmwareUpdateCapabilities';
+import type {
+  prepareFirmwareUpdatePlan,
+  validateFirmwareUpdatePreparedPlan,
+} from './firmwareUpdatePreparedPlan';
 import type { promptWebDeviceAccess } from './promptWebDeviceAccess';
 import type { deviceReset } from './deviceReset';
 import type { deviceRecovery } from './deviceRecovery';
@@ -183,7 +171,6 @@ export type CoreApi = {
   call: (params: any) => Promise<any>;
   uiResponse: typeof uiResponse;
   cancel: (connectId?: string) => void;
-  cancelOperation: (operationId: string) => void;
   updateSettings: typeof updateSettings;
   switchTransport: (env: ConnectSettings['env']) => Promise<{ success: boolean }>;
   getLogs: typeof getLogs;
@@ -240,6 +227,12 @@ export type CoreApi = {
   firmwareUpdateV2: typeof firmwareUpdateV2;
   firmwareUpdateV3: typeof firmwareUpdateV3;
   firmwareUpdateV4: typeof firmwareUpdateV4;
+  registerFirmwareUpdateHostBinding: typeof registerFirmwareUpdateHostBinding;
+  unregisterFirmwareUpdateHostBinding: typeof unregisterFirmwareUpdateHostBinding;
+  getFirmwareUpdateHostBindingGeneration: typeof getFirmwareUpdateHostBindingGeneration;
+  getFirmwareUpdateCapabilities: typeof getFirmwareUpdateCapabilities;
+  prepareFirmwareUpdatePlan: typeof prepareFirmwareUpdatePlan;
+  validateFirmwareUpdatePreparedPlan: typeof validateFirmwareUpdatePreparedPlan;
   cipherKeyValue: typeof cipherKeyValue;
 
   /**
@@ -248,27 +241,7 @@ export type CoreApi = {
   deviceReboot: typeof deviceReboot;
   deviceGetOnboardingStatus: typeof deviceGetOnboardingStatus;
   deviceUploadWallpaper: typeof deviceUploadWallpaper;
-  deviceInfoGet: typeof deviceInfoGet;
-  deviceStatusGet: typeof deviceStatusGet;
-  deviceSettingsGet: typeof deviceSettingsGet;
-  protocolInfoRequest: typeof protocolInfoRequest;
-  ping: typeof ping;
-  deviceFirmwareUpdate: typeof deviceFirmwareUpdate;
-  deviceGetFirmwareUpdateStatus: typeof deviceGetFirmwareUpdateStatus;
-  deviceFactoryInfoSet: typeof deviceFactoryInfoSet;
-  deviceFactoryInfoGet: typeof deviceFactoryInfoGet;
-  deviceSettingsSet: typeof deviceSettingsSet;
-  deviceSettingsPageShow: typeof deviceSettingsPageShow;
-  filesystemPermissionFix: typeof filesystemPermissionFix;
-  filesystemFormat: typeof filesystemFormat;
   uploadPortfolio: typeof uploadPortfolio;
-  fileRead: typeof fileRead;
-  fileWrite: typeof fileWrite;
-  fileDelete: typeof fileDelete;
-  dirList: typeof dirList;
-  dirMake: typeof dirMake;
-  dirRemove: typeof dirRemove;
-  pathInfo: typeof pathInfo;
 
   /**
    * All network function

package/src/types/api/openWalletSession.ts

@@ -40,6 +40,8 @@ type OpenWalletSessionPayloadBase = {
   protocol: 'V1' | 'V2';
   deviceId: string;
   resumed: boolean;
+  /** Forwarded only when the firmware response contains a wallet session id. */
+  sessionId?: string;
 };
 
 export type OpenWalletSessionPayload = OpenWalletSessionPayloadBase &

package/src/types/api/protocolV2.ts

@@ -1,47 +1,13 @@
 import type { CommonParams, Response } from '../params';
-import type {
-  DevOnboardingStatus,
-  DeviceFactoryInfo,
-  DeviceFirmwareUpdateStatus,
-  DeviceSettings,
-  DeviceStatus,
-  ProtocolInfo,
-  ProtocolV2DeviceInfo,
-  Success,
-} from '@onekeyfe/hd-transport';
-import type {
-  DeviceFactoryInfoSetParams,
-  DeviceFirmwareUpdateParams,
-  DeviceFirmwareUpdateStatusGetParams,
-  DeviceRebootParams,
-} from '../../api/protocol-v2/helpers';
-import type { DeviceInfoGetParams } from '../../api/protocol-v2/DeviceInfoGet';
-import type { DeviceSettingsSetParams } from '../../api/protocol-v2/DeviceSettingsSet';
-import type { DeviceSettingsPageShowParams } from '../../api/protocol-v2/DeviceSettingsPageShow';
+import type { DevOnboardingStatus, Success } from '@onekeyfe/hd-transport';
+import type { DeviceRebootParams } from '../../api/protocol-v2/helpers';
 import type {
   DeviceUploadWallpaperParams,
   DeviceUploadWallpaperResponse,
 } from '../../api/protocol-v2/DeviceUploadWallpaper';
 
 // Re-export implementation parameter types as the single source of truth.
-export type {
-  DeviceFirmwareTargetInput,
-  DeviceFirmwareUpdateParams,
-  DeviceFirmwareUpdateStatusGetParams,
-  DeviceRebootParams,
-  DeviceFactoryInfoSetParams,
-  RebootTypeInput,
-} from '../../api/protocol-v2/helpers';
-export type {
-  DeviceInfoGetParams,
-  DeviceInfoGetTargets,
-  DeviceInfoGetTypes,
-} from '../../api/protocol-v2/DeviceInfoGet';
-export type { DeviceSettingsSetParams } from '../../api/protocol-v2/DeviceSettingsSet';
-export type {
-  DeviceSettingsPageShowParams,
-  SupportedDeviceSettingsPage,
-} from '../../api/protocol-v2/DeviceSettingsPageShow';
+export type { DeviceRebootParams, RebootTypeInput } from '../../api/protocol-v2/helpers';
 export type {
   DeviceUploadWallpaperParams,
   DeviceUploadWallpaperResponse,
@@ -49,8 +15,6 @@ export type {
 
 // ── Shared response shapes (Protocol V2 file system) ────────────────────
 
-export type FileOpSuccess = { message?: string };
-
 export type FileInfo = {
   path: string;
   offset: number;
@@ -61,60 +25,8 @@ export type FileInfo = {
   chunks?: number;
 };
 
-export type DirInfo = {
-  path: string;
-  child_dirs?: string;
-  child_files?: string;
-};
-
-// All FilesystemPathInfo proto fields are required; keep this type aligned.
-export type PathInfoResult = {
-  exist: boolean;
-  size: number;
-  year: number;
-  month: number;
-  day: number;
-  hour: number;
-  minute: number;
-  second: number;
-  readonly: boolean;
-  hidden: boolean;
-  system: boolean;
-  archive: boolean;
-  directory: boolean;
-};
-
 // ── Method signatures ─────────────────────────────────────────────────────
 
-/** @deprecated Development-only raw Protocol V2 command. Use `getDeviceState`. */
-export declare function deviceInfoGet(
-  connectId: string,
-  params?: CommonParams & DeviceInfoGetParams
-): Response<ProtocolV2DeviceInfo>;
-
-/** @deprecated Development-only raw Protocol V2 command. Use `getDeviceState`. */
-export declare function deviceStatusGet(
-  connectId: string,
-  params?: CommonParams
-): Response<DeviceStatus>;
-
-/** @deprecated Development-only raw Protocol V2 command. Use `getDeviceState`. */
-export declare function deviceSettingsGet(
-  connectId: string,
-  params?: CommonParams
-): Response<DeviceSettings>;
-
-/** @deprecated Development-only raw Protocol V2 command. */
-export declare function protocolInfoRequest(
-  connectId: string,
-  params?: CommonParams
-): Response<ProtocolInfo>;
-
-export declare function ping(
-  connectId: string,
-  params?: CommonParams & { message?: string }
-): Response<Success>;
-
 export declare function deviceReboot(
   connectId: string,
   params: CommonParams & DeviceRebootParams
@@ -125,111 +37,15 @@ export declare function deviceGetOnboardingStatus(
   params?: CommonParams
 ): Response<DevOnboardingStatus>;
 
-export declare function deviceFirmwareUpdate(
-  connectId: string,
-  params: CommonParams & DeviceFirmwareUpdateParams
-): Response<Success | DeviceFirmwareUpdateStatus>;
-
-export declare function deviceGetFirmwareUpdateStatus(
-  connectId: string,
-  params?: CommonParams & DeviceFirmwareUpdateStatusGetParams
-): Response<DeviceFirmwareUpdateStatus>;
-
-export declare function deviceFactoryInfoSet(
-  connectId: string,
-  params: CommonParams & DeviceFactoryInfoSetParams
-): Response<Success>;
-
-export declare function deviceFactoryInfoGet(
-  connectId: string,
-  params?: CommonParams
-): Response<DeviceFactoryInfo>;
-
-/**
- * @deprecated Use the protocol-independent `deviceSettings`.
- */
-export declare function deviceSettingsSet(
-  connectId: string,
-  params: CommonParams & DeviceSettingsSetParams
-): Response<Success>;
-
-/**
- * @deprecated Use `deviceSettings`, `deviceChangePin`, or `deviceWipe`.
- */
-export declare function deviceSettingsPageShow(
-  connectId: string,
-  params: CommonParams & DeviceSettingsPageShowParams
-): Response<Success>;
-
 export declare function deviceUploadWallpaper(
   connectId: string,
   params: CommonParams & DeviceUploadWallpaperParams
 ): Response<DeviceUploadWallpaperResponse>;
 
-export declare function filesystemPermissionFix(
-  connectId: string,
-  params?: CommonParams
-): Response<Success>;
-
-export declare function fileRead(
-  connectId: string,
-  params: {
-    path: string;
-    offset?: number;
-    totalSize?: number;
-    chunkLen?: number;
-    uiPercentage?: number;
-  }
-): Response<FileInfo>;
-
-export declare function fileWrite(
-  connectId: string,
-  params: {
-    path: string;
-    offset?: number;
-    totalSize?: number;
-    chunkSize?: number;
-    chunkLen?: number;
-    data: ArrayBuffer | Uint8Array | Blob | string;
-    overwrite?: boolean;
-    append?: boolean;
-    uiPercentage?: number;
-    timeoutMs?: number | string;
-  }
-): Response<FileInfo>;
-
-export declare function fileDelete(
-  connectId: string,
-  params: { path: string }
-): Response<FileOpSuccess>;
-
-export declare function dirList(
-  connectId: string,
-  params: { path: string; depth?: number }
-): Response<DirInfo>;
-
-export declare function dirMake(
-  connectId: string,
-  params: { path: string }
-): Response<FileOpSuccess>;
-
-export declare function dirRemove(
-  connectId: string,
-  params: { path: string }
-): Response<FileOpSuccess>;
-
-export declare function pathInfo(
-  connectId: string,
-  params: { path: string; timeoutMs?: number | string }
-): Response<PathInfoResult>;
-
 export declare function uploadPortfolio(
   connectId: string,
   params: {
-    operationId?: string;
     packageBytes: ArrayBuffer | Uint8Array | Blob;
     timeoutMs?: number | string;
   }
 ): Response<FileInfo & { portfolioUpdated: true }>;
-
-export declare function filesystemFormat(connectId: string): Response<Success>;

package/src/types/api/sessionCache.ts

@@ -1,9 +1,14 @@
 import type { Response } from '../params';
 
-export type ClearSessionCacheParams = {
-  deviceId?: string;
-  passphraseState?: string;
-};
+export type ClearSessionCacheParams =
+  | {
+      deviceId?: never;
+      passphraseState?: never;
+    }
+  | {
+      deviceId: string;
+      passphraseState?: string;
+    };
 
 export type ClearSessionCachePayload = {
   cleared: true;

package/src/types/device.ts

@@ -3,6 +3,7 @@ import { EDeviceType, type EFirmwareType } from '@onekeyfe/hd-shared';
 import type { IVersionArray } from './settings';
 import type { PROTO } from '../constants';
 import type {
+  Enum_SafetyCheckLevel,
   OneKeyDeviceCommType,
   ProtocolV2DeviceInfo,
   DeviceStatus as ProtocolV2DeviceStatus,
@@ -164,7 +165,8 @@ export type DeviceStateUpdateSource =
   | 'initialize'
   | 'device-info'
   | 'device-status'
-  | 'apply-settings'
+  | 'settings-read'
+  | 'settings-write'
   | 'change-pin'
   | 'lock'
   | 'unlock'
@@ -207,7 +209,7 @@ export type DeviceStateSettings = {
   sdProtection: boolean | null;
   wipeCodeProtection: boolean | null;
   passphraseAlwaysOnDevice: boolean | null;
-  safetyChecks: string | null;
+  safetyChecks: Enum_SafetyCheckLevel | null;
   autoLockDelayMs: number | null;
   autoShutdownDelayMs: number | null;
   displayRotation: number | null;
@@ -306,7 +308,7 @@ export type NormalizedFeatures = {
   wipeCodeProtection: boolean | null;
   passphraseAlwaysOnDevice: boolean | null;
   attachToPinEnabled?: boolean | null;
-  safetyChecks: string | null;
+  safetyChecks: Enum_SafetyCheckLevel | null;
   autoLockDelayMs: number | null;
   autoShutdownDelayMs: number | null;
   displayRotation: number | null;

package/src/types/settings.ts

@@ -31,6 +31,8 @@ export type ConnectSettings = {
   timestamp: number;
   isFrame?: boolean;
   preRelease?: boolean;
+  firmwareManifestMode?: 'sdk-managed' | 'external-only';
+  preloadedConfig?: RemoteConfigResponse;
   fetchConfig?: boolean;
   extension?: string;
   configFetcher?: (url: string) => Promise<RemoteConfigResponse | null>;
@@ -55,6 +57,7 @@ export type IProtocolV2FirmwareComponent = {
   target: IProtocolV2FirmwareComponentTarget;
   url: string;
   fingerprint?: string;
+  expectedSize?: number;
   version?: IVersionArray;
 };
 
@@ -64,6 +67,8 @@ export type IProtocolV2ResourceBundle = {
   name: string;
   /** Download URL. */
   url: string;
+  fingerprint?: string;
+  expectedSize?: number;
   /** Device target path, such as vol0:/bundles/images/images.okpkg. */
   devicePath: string;
   /** okpkg payload_version used to skip matching content after FileRead. */
@@ -85,10 +90,16 @@ export type IFirmwareReleaseInfo = {
   firmwareType?: EFirmwareType;
   /** Firmware UI resource */
   resource?: string;
+  resourceFingerprint?: string;
+  resourceExpectedSize?: number;
   /** Firmware full UI resource */
   fullResource?: string;
+  fullResourceFingerprint?: string;
+  fullResourceExpectedSize?: number;
   fullResourceRange?: string[];
   bootloaderResource?: string;
+  bootloaderFingerprint?: string;
+  bootloaderExpectedSize?: number;
   bootloaderVersion?: IVersionArray;
   displayBootloaderVersion?: IVersionArray;
   bootloaderRelatedFirmwareVersion?: IVersionArray;
@@ -101,6 +112,7 @@ export type IFirmwareReleaseInfo = {
     [k in ILocale]: string;
   };
   fingerprint: string;
+  expectedSize?: number;
   version: IVersionArray;
   changelog: {
     [k in ILocale]: string;
@@ -116,6 +128,7 @@ export type IBLEFirmwareReleaseInfo = {
   webUpdate: string;
   fingerprint: string;
   fingerprintWeb: string;
+  expectedSize?: number;
   version: IVersionArray;
   changelog: {
     [k in ILocale]: string;

package/src/utils/deviceFeaturesUtils.ts

@@ -156,12 +156,16 @@ export const getPassphraseStateWithRefreshDeviceInfo = async (
 
   // Attach to pin try to fix internal state
   const deviceId = device.getCurrentDeviceId();
+  let existingSessionId: string | null | undefined;
+  if (!options?.initSession && typeof device.getInternalState === 'function') {
+    existingSessionId = device.getInternalState();
+  }
   device.updateInternalState(
     device.getCurrentPassphraseProtection() ?? false,
     passphraseState,
     deviceId,
     newSession,
-    options?.initSession ? null : device.features?.sessionId
+    options?.initSession ? null : existingSessionId
   );
 
   return {

package/src/utils/deviceSettings.ts

@@ -1,6 +1,52 @@
 import { EDeviceType } from '@onekeyfe/hd-shared';
+import { Enum_SafetyCheckLevel } from '@onekeyfe/hd-transport';
 
 import type { IDeviceType } from '../types';
+import type { DeviceSettingsParams } from '../types/api/deviceSettings';
+import type { SafetyCheckLevel } from '@onekeyfe/hd-transport';
+
+export type DeviceSettingsProtocol = 'V1' | 'V2';
+export type DeviceSettingsField = keyof DeviceSettingsParams;
+
+export const DEVICE_SETTINGS_SHARED_FIELDS = [
+  'language',
+  'label',
+  'usePassphrase',
+  'autoLockDelayMs',
+  'autoShutdownDelayMs',
+  'hapticFeedback',
+  'bluetoothEnabled',
+] as const satisfies readonly DeviceSettingsField[];
+
+export const DEVICE_SETTINGS_V1_ONLY_FIELDS = [
+  'homescreen',
+  'passphraseSource',
+  'displayRotation',
+  'passphraseAlwaysOnDevice',
+  'safetyChecks',
+  'experimentalFeatures',
+  'changeBrightness',
+] as const satisfies readonly DeviceSettingsField[];
+
+export const DEVICE_SETTINGS_V2_ONLY_FIELDS = [
+  'brightness',
+  'airgapMode',
+  'animationEnabled',
+  'tapToWake',
+  'deviceNameDisplayEnabled',
+  'fidoEnabled',
+  'usbLockEnabled',
+  'randomKeypad',
+] as const satisfies readonly DeviceSettingsField[];
+
+export const PROTOCOL_V2_NEVER_TIMEOUT_MS = 0x10000000;
+
+export const normalizeSafetyCheckLevel = (
+  value: SafetyCheckLevel | null | undefined
+): Enum_SafetyCheckLevel | null | undefined => {
+  if (typeof value === 'number' || value === null || value === undefined) return value;
+  return Enum_SafetyCheckLevel[value];
+};
 
 export const LANGUAGE_LABELS = {
   en: 'English',
@@ -36,6 +82,13 @@ export const PROTOCOL_V2_LANGUAGE_BY_KEY: Record<LanguageKey, string> = {
 export const mapLanguageToProtocolV2 = (language?: string) =>
   language ? PROTOCOL_V2_LANGUAGE_BY_KEY[language as LanguageKey] ?? language : undefined;
 
+const PROTOCOL_V2_LANGUAGE_KEY_BY_TAG = Object.fromEntries(
+  Object.entries(PROTOCOL_V2_LANGUAGE_BY_KEY).map(([key, tag]) => [tag, key])
+) as Record<string, LanguageKey>;
+
+export const mapLanguageFromProtocolV2 = (language?: string) =>
+  language ? PROTOCOL_V2_LANGUAGE_KEY_BY_TAG[language] ?? language : undefined;
+
 const PRO2_LANGUAGE_OPTIONS = [
   ...Object.entries(LANGUAGE_LABELS).map(([code, label]) => ({ code, label })),
   { code: 'zh-Hant-TW', label: '繁體中文（台灣）' },
@@ -73,85 +126,106 @@ export const getLanguageConfig = (deviceType: IDeviceType): Record<string, strin
   return keys.map(key => ({ code: key, label: LANGUAGE_LABELS[key] }));
 };
 
-export type DurationParts = {
-  seconds: number;
-  minute: number;
-  hour: number;
-  day: number;
+export type DeviceSettingsDurationOption = {
+  label: string;
+  valueMs: number;
+};
+
+export type DeviceSettingsValueOption<T> = {
+  label: string;
+  value: T;
 };
 
-export const getAutoLockOptions = (_deviceType: IDeviceType): DurationParts[] => {
-  switch (_deviceType) {
+const durationOption = (valueMs: number): DeviceSettingsDurationOption => {
+  if (valueMs === 0 || valueMs === PROTOCOL_V2_NEVER_TIMEOUT_MS) {
+    return { label: 'Never', valueMs };
+  }
+  if (valueMs < 60_000) {
+    return { label: `${valueMs / 1000} seconds`, valueMs };
+  }
+  const minutes = valueMs / 60_000;
+  return { label: `${minutes} ${minutes === 1 ? 'minute' : 'minutes'}`, valueMs };
+};
+
+const withNever = (
+  values: readonly number[],
+  protocol: DeviceSettingsProtocol
+): DeviceSettingsDurationOption[] =>
+  [...values, protocol === 'V2' ? PROTOCOL_V2_NEVER_TIMEOUT_MS : 0].map(durationOption);
+
+export const getAutoLockOptions = (
+  deviceType: IDeviceType,
+  protocol: DeviceSettingsProtocol
+): DeviceSettingsDurationOption[] => {
+  switch (deviceType) {
     case EDeviceType.Mini:
     case EDeviceType.Classic:
     case EDeviceType.Classic1s:
     case EDeviceType.ClassicPure:
-      return [
-        { seconds: 0, minute: 1, hour: 0, day: 0 },
-        { seconds: 0, minute: 2, hour: 0, day: 0 },
-        { seconds: 0, minute: 5, hour: 0, day: 0 },
-        { seconds: 0, minute: 10, hour: 0, day: 0 },
-        { seconds: 0, minute: 0, hour: 0, day: 0 },
-      ];
+      return withNever([60_000, 120_000, 300_000, 600_000], protocol);
     case EDeviceType.Touch:
     case EDeviceType.Pro:
-      return [
-        { seconds: 30, minute: 0, hour: 0, day: 0 },
-        { seconds: 0, minute: 1, hour: 0, day: 0 },
-        { seconds: 0, minute: 2, hour: 0, day: 0 },
-        { seconds: 0, minute: 5, hour: 0, day: 0 },
-        { seconds: 0, minute: 10, hour: 0, day: 0 },
-        { seconds: 0, minute: 30, hour: 0, day: 0 },
-        { seconds: 0, minute: 0, hour: 0, day: 0 },
-      ];
     case EDeviceType.Pro2:
-      return [
-        { seconds: 30, minute: 0, hour: 0, day: 0 },
-        { seconds: 0, minute: 1, hour: 0, day: 0 },
-        { seconds: 0, minute: 2, hour: 0, day: 0 },
-        { seconds: 0, minute: 5, hour: 0, day: 0 },
-        { seconds: 0, minute: 10, hour: 0, day: 0 },
-        { seconds: 0, minute: 30, hour: 0, day: 0 },
-        { seconds: 0, minute: 0, hour: 0, day: 0 },
-      ];
+      return withNever([30_000, 60_000, 120_000, 300_000, 600_000, 1_800_000], protocol);
     default:
       return [];
   }
 };
 
-export const getAutoShutDownOptions = (_deviceType: IDeviceType): DurationParts[] => {
-  switch (_deviceType) {
+export const getAutoShutDownOptions = (
+  deviceType: IDeviceType,
+  protocol: DeviceSettingsProtocol
+): DeviceSettingsDurationOption[] => {
+  switch (deviceType) {
     case EDeviceType.Mini:
       return [];
     case EDeviceType.Classic:
     case EDeviceType.Classic1s:
     case EDeviceType.ClassicPure:
-      return [
-        { seconds: 0, minute: 1, hour: 0, day: 0 },
-        { seconds: 0, minute: 3, hour: 0, day: 0 },
-        { seconds: 0, minute: 5, hour: 0, day: 0 },
-        { seconds: 0, minute: 10, hour: 0, day: 0 },
-        { seconds: 0, minute: 0, hour: 0, day: 0 },
-      ];
+      return withNever([60_000, 180_000, 300_000, 600_000], protocol);
     case EDeviceType.Touch:
     case EDeviceType.Pro:
-      return [
-        { seconds: 0, minute: 1, hour: 0, day: 0 },
-        { seconds: 0, minute: 2, hour: 0, day: 0 },
-        { seconds: 0, minute: 5, hour: 0, day: 0 },
-        { seconds: 0, minute: 10, hour: 0, day: 0 },
-        { seconds: 0, minute: 0, hour: 0, day: 0 },
-      ];
+      return withNever([60_000, 120_000, 300_000, 600_000], protocol);
     case EDeviceType.Pro2:
-      return [
-        { seconds: 0, minute: 1, hour: 0, day: 0 },
-        { seconds: 0, minute: 2, hour: 0, day: 0 },
-        { seconds: 0, minute: 5, hour: 0, day: 0 },
-        { seconds: 0, minute: 10, hour: 0, day: 0 },
-        { seconds: 0, minute: 30, hour: 0, day: 0 },
-        { seconds: 0, minute: 0, hour: 0, day: 0 },
-      ];
+      return withNever([60_000, 120_000, 300_000, 600_000, 1_800_000], protocol);
     default:
       return [];
   }
 };
+
+export type DeviceSettingsCapabilities = {
+  protocol: DeviceSettingsProtocol;
+  supportedFields: readonly DeviceSettingsField[];
+  languageOptions: ReadonlyArray<Record<string, string>>;
+  autoLockDelayOptions: readonly DeviceSettingsDurationOption[];
+  autoShutdownDelayOptions: readonly DeviceSettingsDurationOption[];
+  ranges: {
+    brightness?: { min: number; max: number };
+  };
+  safetyCheckOptions: ReadonlyArray<DeviceSettingsValueOption<Enum_SafetyCheckLevel>>;
+  onDeviceConfirmationFields: readonly DeviceSettingsField[];
+};
+
+export const getDeviceSettingsCapabilities = (
+  deviceType: IDeviceType,
+  protocol: DeviceSettingsProtocol
+): DeviceSettingsCapabilities => ({
+  protocol,
+  supportedFields:
+    protocol === 'V2'
+      ? [...DEVICE_SETTINGS_SHARED_FIELDS, ...DEVICE_SETTINGS_V2_ONLY_FIELDS]
+      : [...DEVICE_SETTINGS_SHARED_FIELDS, ...DEVICE_SETTINGS_V1_ONLY_FIELDS],
+  languageOptions: getLanguageConfig(deviceType),
+  autoLockDelayOptions: getAutoLockOptions(deviceType, protocol),
+  autoShutdownDelayOptions: getAutoShutDownOptions(deviceType, protocol),
+  ranges: protocol === 'V2' ? { brightness: { min: 10, max: 100 } } : {},
+  safetyCheckOptions:
+    protocol === 'V1'
+      ? [
+          { label: 'Strict', value: Enum_SafetyCheckLevel.Strict },
+          { label: 'Prompt Always', value: Enum_SafetyCheckLevel.PromptAlways },
+          { label: 'Prompt Temporarily', value: Enum_SafetyCheckLevel.PromptTemporarily },
+        ]
+      : [],
+  onDeviceConfirmationFields: protocol === 'V2' ? ['usePassphrase', 'airgapMode'] : [],
+});