@microtronics/studio-cli 1.2.0-alpha.3 → 1.2.0-alpha.5

package/dist/studio-cli.d.ts

@@ -2126,7 +2126,7 @@ export declare const DeviceProfiles: any;
  * The pair of transports (UTO data + AT debug) needed to talk to a connected device,
  * plus a way to release the underlying link.
  */
-declare interface DeviceTransports {
+export declare interface DeviceTransports {
     uto: ITransport;
     /** Absent when the caller asked for the UTO interface only (`needDebug: false`). */
     debug?: ITransport;
@@ -2273,8 +2273,13 @@ export declare class DevSession extends EventEmitter {
      * can change with a new app, so DEVINFO is re-read before the poller resumes.
      */
     flash(file?: string): Promise<UploadResult>;
-    /** Reopen the USB link after a flash; a failure is logged and leaves `connected: false`. */
+    /**
+     * Reopen the USB link after a flash. The device is rebooting — and some devices don't even
+     * drop the USB connection — so a failure here is expected and retried for a while rather
+     * than reported immediately; a final failure is logged and leaves `connected: false`.
+     */
     private reconnect;
+    private reportReconnectFailure;
     /** Full `OfflineSyncManager` sync, or a targeted pull of the given tags. */
     sync(tags?: number[]): Promise<{
         tags: number[];
@@ -2897,7 +2902,8 @@ export declare namespace Log {
         done = 1,
         info = 2,
         warning = 3,
-        error = 4
+        error = 4,
+        debug = 5
     }
     export const LOG_PREFIX: {
         1: string;
@@ -2905,17 +2911,25 @@ export declare namespace Log {
         2: string;
         3: string;
         4: string;
+        5: string;
     };
     export class Logger {
         private _logHandler;
         private _silent;
+        private _debugEnabled;
         constructor(logOutput?: {
             log: (...args: any[]) => void;
         });
         _log(type: LogMessageType, msg: any, ...args: any[]): void;
         set silent(value: boolean);
+        /** Redirect where log lines go (e.g. stderr while stdout carries machine-readable output). */
+        set output(logOutput: {
+            log: (...args: any[]) => void;
+        });
         log(msg: any, ...args: any[]): void;
+        /** Only prints when {@link debugEnabled} is set (the `--debug` flag). */
         debug(msg: any, ...args: any[]): void;
+        set debugEnabled(value: boolean);
         error(msg: any, ...args: any[]): void;
         info(msg: any, ...args: any[]): void;
         warn(msg: any, ...args: any[]): void;
@@ -2962,7 +2976,12 @@ declare class LogStream extends EventEmitter {
     get lastSeq(): number;
     /** Tap rm2mlog frames off the UTO channel. */
     attachUtoMaster(utoMaster: UtoMaster): void;
-    /** Tap the AT/debug channel RX, where a DLO's live `printf` output arrives. */
+    /**
+     * Tap the AT/debug channel RX, where a DLO's live `printf` output arrives.
+     *
+     * A `DebugMaster` parses the raw byte stream (console frames, the `!`/`?`/`~`/`$`
+     * level prefixes and the DLO file/line tags) instead of dumping unformatted chunks.
+     */
     attachAtHandler(atHandler: AtCommandHandler): void;
     /** Decode a device payload best-effort; keep the bytes when it is not text. */
     private pushDecoded;
@@ -5708,7 +5727,7 @@ export declare interface StampPollerStatus {
  * Opens the transports for a device given its serial number. The default (WebUSB) factory
  * is used by {@link openDevice} unless a test/consumer supplies its own.
  */
-declare type TransportFactory = (serial: string, needDebug?: boolean) => Promise<DeviceTransports>;
+export declare type TransportFactory = (serial: string, needDebug?: boolean) => Promise<DeviceTransports>;
 
 /**
  * Upload result interface
@@ -5725,9 +5744,13 @@ declare interface UploadResult {
  * @param fs - The filesystem interface for file operations
  * @param logger - The logger instance for output
  * @param debugLog - Enable debug logging
+ * @param retryMs - Total ms budget to retry a transient device-open failure (see
+ *   {@link isTransientUsbOpenError}); `0` (the default) attempts once.
+ * @param transportFactory - Overrides how the transports are obtained (used by tests and by
+ *   consumers, e.g. the VS Code extension, running on their own injected transport).
  * @returns Promise resolving to an UploadResult
  */
-declare function uploadToDevice(serialNumber: string, fileUri: URI, fs: LocalFS, logger: Log.Logger, debugLog?: boolean): Promise<UploadResult>;
+declare function uploadToDevice(serialNumber: string, fileUri: URI, fs: LocalFS, logger: Log.Logger, debugLog?: boolean, retryMs?: number, transportFactory?: TransportFactory): Promise<UploadResult>;
 
 declare function uriToMemFsPath(path: URI): string;