@onekeyfe/hardware-cli 1.2.0-alpha.14 → 1.2.0-alpha.141

package/dist/cli.d.ts

@@ -1,3 +1,83 @@
 import { Command } from 'commander';
+import { createSDK } from './sdk';
 declare const program: Command;
+export declare function getLegacyFirmwareConnectTimeout(transport: 'usb' | 'ble'): 90000 | undefined;
+/**
+ * Prepare passphrase session before SDK calls.
+ *
+ * 1. If --use-empty-passphrase or --passphrase-state provided → use as-is
+ * 2. Try a legacy keychain entry → preloadSessionCache → use cached session
+ * 3. Keychain miss → openWalletSession (triggers 1/2/3 prompt)
+ *
+ * After this, globalOpts.passphraseState is set and getCommonParams will include it.
+ */
+export declare function prepareSession(sdk: typeof import('@onekeyfe/hd-common-connect-sdk').default, globalOpts: Record<string, any>): Promise<string | undefined>;
+/**
+ * Unified command runner. All `.action(...)` handlers should wrap their body
+ * in this helper so every command goes through the same lifecycle:
+ *
+ *   1. (optional) create SDK
+ *   2. (optional) prepareSession — unlock + keychain preload + passphraseState
+ *   3. run the handler (which calls outputResult on success)
+ *   4. report uncaught errors as a structured failure result
+ *   5. dispose SDK
+ *   6. let Node exit naturally after all SDK resources are released
+ *
+ * This fixes three previous bugs:
+ *   - Most signing commands skipped prepareSession, so keychain sessions
+ *     were never actually reused.
+ *   - outputResult scheduled process.exit(200ms) before dispose completed,
+ *     racing USB release on slower transports.
+ *   - Errors thrown from SDK calls leaked as stack traces instead of the
+ *     CLI's structured `{ success: false, payload: { error } }` shape.
+ */
+type AnySdk = Awaited<ReturnType<typeof createSDK>>;
+export declare function buildWallpaperUploadMetrics({ totalBytes, transferredBytes, startedAt, endedAt, lastProgress, }: {
+    totalBytes: number;
+    transferredBytes: number;
+    startedAt: number;
+    endedAt: number;
+    lastProgress: number;
+}): {
+    totalBytes: number;
+    transferredBytes: number;
+    totalSeconds: number;
+    transferKiBPerSecond: number | null;
+    lastProgress: number;
+};
+export declare function runFirmwareUpdateV4WithRetry({ sdk, globalOpts, params, retries, }: {
+    sdk: AnySdk;
+    globalOpts: Record<string, any>;
+    params: ReturnType<typeof buildFirmwareUpdateV4Params>;
+    retries?: number;
+}): Promise<unknown>;
+declare function buildFirmwareUpdateV4Params(opts: {
+    chunkSize?: string;
+    romloader?: string;
+    bootloader?: string;
+    applicationP1?: string;
+    applicationP2?: string;
+    coprocessor?: string;
+    se01?: string;
+    se02?: string;
+    se03?: string;
+    se04?: string;
+    resourceArchive?: string;
+    forcedUpdateRes?: boolean;
+}): {
+    platform: "desktop";
+    connectProtocol: "V2";
+    chunkSize: number | undefined;
+    forcedUpdateRes: boolean | undefined;
+    romloaderBinary: ArrayBuffer | undefined;
+    bootloaderBinary: ArrayBuffer | undefined;
+    applicationP1Binary: ArrayBuffer | undefined;
+    applicationP2Binary: ArrayBuffer | undefined;
+    coprocessorBinary: ArrayBuffer | undefined;
+    se01Binary: ArrayBuffer | undefined;
+    se02Binary: ArrayBuffer | undefined;
+    se03Binary: ArrayBuffer | undefined;
+    se04Binary: ArrayBuffer | undefined;
+    resourceArchiveBinary: ArrayBuffer | undefined;
+};
 export { program };