feat(scenario): write-serial command

Author: urish

src/main.ts

@@ -17,6 +17,7 @@ import { ExpectPinCommand } from './scenario/ExpectPinCommand.js';
 import { SetControlCommand } from './scenario/SetControlCommand.js';
 import { WaitSerialCommand } from './scenario/WaitSerialCommand.js';
 import { uploadFirmware } from './uploadFirmware.js';
+import { WriteSerialCommand } from './scenario/WriteSerialCommand.js';
 
 const millis = 1_000_000;
 
@@ -143,6 +144,7 @@ async function main() {
       'expect-pin': new ExpectPinCommand(),
       'set-control': new SetControlCommand(),
       'wait-serial': new WaitSerialCommand(expectEngine),
+      'write-serial': new WriteSerialCommand(),
     });
     scenario.validate();
   }

src/scenario/WriteSerialCommand.ts

@@ -0,0 +1,27 @@
+import type { APIClient } from '../APIClient.js';
+import type { IScenarioCommand, TestScenario } from '../TestScenario.js';
+
+const encoder = new TextEncoder();
+
+export class WriteSerialCommand implements IScenarioCommand {
+  validate(value: string | number[]) {
+    if (value instanceof Array) {
+      if (value.length === 0) {
+        throw new Error(`Array must contain at least one number`);
+      }
+      if (value.some((v) => typeof v !== 'number')) {
+        throw new Error(`Array must contain only numbers`);
+      }
+      return;
+    }
+    if (typeof value !== 'string') {
+      throw new Error(`Value must be a string or an array of numbers`);
+    }
+  }
+
+  async run(scenario: TestScenario, client: APIClient, text: string | number[]) {
+    const data = text instanceof Array ? new Uint8Array(text) : encoder.encode(text);
+    await client.serialMonitorWrite(data);
+    await scenario.resume();
+  }
+}