@microtronics/studio-cli 1.2.0-alpha.4 → 1.2.0-alpha.7

package/out/studio-cli.d.ts

@@ -2083,6 +2083,22 @@ export declare interface DevBuildState {
     diagnostics?: Package.MergedDiagnostics;
 }
 
+/** `GET /dev/configs` payload — every config-class container, decoded and alias-or-name keyed. */
+declare interface DevConfigs {
+    configs: Record<string, unknown>;
+    /** Keys of {@link DevConfigs.configs}, in DDE declaration order. */
+    order: string[];
+}
+
+/** One entry of the `PUT /dev/configs` response — mirrors the single-container write outcome. */
+declare type DevConfigWriteResult = {
+    ok: true;
+    stale?: true;
+} | {
+    ok: false;
+    err: string;
+};
+
 /**
  * Development installation information
  */
@@ -2126,7 +2142,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;
@@ -2145,11 +2161,12 @@ export declare interface DevLogRecord {
     raw?: string;
 }
 
-/** Where a log record came from. */
-export declare type DevLogSource = 'rm2mlog' | 'at' | 'uto' | 'pov';
+/** Where a log record came from. `state`/`console` are only used by `--replay` (`dev/replay/replaySession.ts`). */
+export declare type DevLogSource = 'rm2mlog' | 'at' | 'uto' | 'pov' | 'state' | 'console';
 
 export declare interface DevOptions {
-    serial: string;
+    /** Required unless {@link DevOptions.replay} is given. */
+    serial?: string;
     host?: string;
     port?: number;
     /** Allow a non-loopback `host` without a bearer token. */
@@ -2175,15 +2192,41 @@ export declare interface DevOptions {
     pov?: string | boolean;
     /** Persist the mirror to `.studio/dev/mirror.json` (default `true`). */
     persistMirror?: boolean;
-    /** Test/replay seams, forwarded to {@link DevSession}. */
+    /** Test seam, forwarded to {@link DevSession}. */
     transportFactory?: TransportFactory;
     createDevice?: DevSessionOptions['createDevice'];
+    /**
+     * Support/forensics mode: replay a companion-app flight-recorder export instead of
+     * opening USB (`cli/src/dev/replay/*`). Mutually exclusive with a live device — no
+     * `build`/`flash`/poller/watch run, and `/api/**` answers empty/`E_EOD`.
+     */
+    replay?: string;
+    /** Explicit recording session id; default = the session with the most records. */
+    session?: string;
+    /** Replay speed; `0`/`'max'` disables recorded delays. Default `1` (real-time). */
+    speed?: number | 'max';
+}
+
+/** Recording metadata reported by a `--replay` session (`dev/replay/replaySession.ts`). */
+declare interface DevReplayStatus {
+    mode: 'replay';
+    /** The cassette file this session was started from. */
+    file: string;
+    session: string;
+    serial: string | null;
+    deviceId: string | null;
+    appVersion: string | null;
+    platform: string | null;
+    recordCount: number;
+    startedTs: number;
+    endedTs: number | null;
+    speed: number | 'max';
 }
 
 export declare interface DevResult {
     url: string;
     port: number;
-    session: DevSession;
+    session: DevServerSession;
     apmId: string;
     close(): Promise<void>;
 }
@@ -2194,6 +2237,38 @@ export declare interface DevServer {
     close(): Promise<void>;
 }
 
+/** The `/dev/logs` ring-buffer surface — shared by {@link DevServerSession} implementations. */
+declare interface DevServerLogStream {
+    readonly lastSeq: number;
+    since(since?: number, limit?: number): DevLogRecord[];
+}
+
+/**
+ * The subset of `DevSession` this server actually calls. A `--replay` session
+ * (`dev/replay/replaySession.ts`'s `ReplayDevSession`) implements this directly instead of
+ * a real `DevSession` — everything below is what `startDevServer` needs and nothing more.
+ */
+export declare interface DevServerSession {
+    readonly serial: string;
+    readonly logStream: DevServerLogStream;
+    on(event: string, listener: (...args: any[]) => void): this;
+    off(event: string, listener: (...args: any[]) => void): this;
+    handleApi(req: LocalApiRequest): Promise<LocalApiResponse>;
+    status(): DevStatus;
+    build(): Promise<DevBuildState>;
+    flash(file?: string): Promise<UploadResult>;
+    sync(tags?: number[]): Promise<{
+        tags: number[];
+        at: number;
+    }>;
+    at(cmd: string): Promise<string>;
+    state(): Promise<unknown>;
+    localDataSnapshot(): unknown;
+    measure(): Promise<unknown>;
+    configs(): Promise<DevConfigs>;
+    applyConfigs(body: Record<string, unknown>): Promise<Record<string, DevConfigWriteResult>>;
+}
+
 /**
  * One `studio dev` session: owns the USB link, the project's DDE model, the `IStorage`
  * mirror and the myDatanet-compatible API handler, and fans device activity out as events.
@@ -2294,6 +2369,22 @@ export declare class DevSession extends EventEmitter {
     /** Trigger a measurement and return its outcome plus the fresh values. */
     measure(): Promise<unknown>;
     status(): DevStatus;
+    /** Config-class containers (`settings`/`config0..9`/`configA..C`) in DDE declaration order. */
+    private configContainers;
+    /**
+     * `GET /dev/configs` — one entry per config-class container, decoded through
+     * {@link handleApi} (the same path `GET /api/1/sites/<uid>/containers/<name>` uses). Keyed
+     * by the container's alias when the DDE declares one, else its raw name.
+     */
+    configs(): Promise<DevConfigs>;
+    /**
+     * `PUT /dev/configs` — applies each entry as a partial write via {@link handleApi}, exactly
+     * like `PUT /api/1/sites/<uid>/containers/<name>`. Accepts an alias or a raw container name
+     * as key; a key that resolves to no container, or to a non-config-class one, fails that
+     * entry alone with the same `{err}` wording the single-container route produces — the rest
+     * of the entries still apply.
+     */
+    applyConfigs(body: Record<string, unknown>): Promise<Record<string, DevConfigWriteResult>>;
     /** Force one poll pass (used by the watcher and by `POST /dev/sync`). */
     tick(): Promise<ContainerChange[]>;
     /** The mirror's current stamp40 for a tag, or 0. */
@@ -2341,7 +2432,7 @@ export declare interface DevSessionOptions {
     lockWaitMs?: number;
 }
 
-/** `GET /dev/status` payload. */
+/** `GET /dev/status` payload — `replay` is only present for a `--replay` session. */
 export declare interface DevStatus {
     serial: string;
     connected: boolean;
@@ -2358,6 +2449,7 @@ export declare interface DevStatus {
     lastSync: number | null;
     buildState: DevBuildState;
     poll: StampPollerStatus;
+    replay?: DevReplayStatus;
 }
 
 export declare namespace DFILES {
@@ -5727,7 +5819,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
@@ -5746,9 +5838,11 @@ declare interface UploadResult {
  * @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, retryMs?: number): 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;
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@microtronics/studio-cli",
-	"version": "1.2.0-alpha.4",
+	"version": "1.2.0-alpha.7",
 	"description": "Microtronics Studio CLI Tool",
 	"main": "./out/api.js",
 	"typings": "./out/studio-cli.d.ts",
@@ -44,6 +44,7 @@
 		"openapi-fetch": "^0.13.0",
 		"pako": "^2.1.0",
 		"semver": "^7.7.2",
+		"sql.js": "^1.14.2",
 		"tinytar-fix": "^0.1.1",
 		"update-notifier": "^7.3.1",
 		"usb": "^2.14.0",
@@ -63,6 +64,7 @@
 		"@types/mocha": "^10.0.9",
 		"@types/node": "^22.9.1",
 		"@types/semver": "^7.5.6",
+		"@types/sql.js": "^1.4.11",
 		"@types/update-notifier": "^6.0.8",
 		"@types/vscode": "^1.86.2",
 		"@yao-pkg/pkg": "^6.22.0",