@v5x/serial 0.5.6 → 0.5.7

package/dist/index.js

@@ -1,17 +1,3 @@
-var __defProp = Object.defineProperty;
-var __returnValue = (v) => v;
-function __exportSetter(name, newValue) {
-  this[name] = __returnValue.bind(null, newValue);
-}
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: __exportSetter.bind(all, name)
-    });
-};
 var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
   get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
 }) : x)(function(x) {
@@ -105,6 +91,7 @@ var AckType;
   AckType2[AckType2["CDC2_NACK_FILE_SYS_FULL"] = 220] = "CDC2_NACK_FILE_SYS_FULL";
   AckType2[AckType2["TIMEOUT"] = 256] = "TIMEOUT";
   AckType2[AckType2["WRITE_ERROR"] = 257] = "WRITE_ERROR";
+  AckType2[AckType2["NOT_CONNECTED"] = 258] = "NOT_CONNECTED";
 })(AckType ||= {});
 var SmartDeviceType;
 ((SmartDeviceType2) => {
@@ -287,8 +274,15 @@ class VexEventEmitter {
     this.handlerMap.set(eventName, listeners);
   }
   emit(eventName, data) {
+    const listeners = this.handlerMap.get(eventName);
+    if (listeners === undefined || listeners.length === 0)
+      return;
+    if (listeners.length === 1) {
+      listeners[0](data);
+      return;
+    }
     const errors = [];
-    for (const callback of [...this.handlerMap.get(eventName) ?? []]) {
+    for (const callback of [...listeners]) {
       try {
         callback(data);
       } catch (error) {
@@ -312,472 +306,21 @@ class VexEventTarget {
     this.emitter = new VexEventEmitter;
   }
   emit(eventName, data) {
-    this.emitter.emit(this.normalizeEventName(eventName), data);
+    this.emitter.emit(eventName, data);
   }
   on(eventName, listener) {
-    this.emitter.on(this.normalizeEventName(eventName), listener);
+    this.emitter.on(eventName, listener);
   }
   remove(eventName, listener) {
-    this.emitter.remove(this.normalizeEventName(eventName), listener);
+    this.emitter.remove(eventName, listener);
   }
   clearListeners() {
     this.emitter.clearListeners();
   }
-  normalizeEventName(eventName) {
-    return String(eventName);
-  }
-}
-
-// ../../node_modules/.bun/neverthrow@8.2.0/node_modules/neverthrow/dist/index.es.js
-var defaultErrorConfig = {
-  withStackTrace: false
-};
-var createNeverThrowError = (message, result, config = defaultErrorConfig) => {
-  const data = result.isOk() ? { type: "Ok", value: result.value } : { type: "Err", value: result.error };
-  const maybeStack = config.withStackTrace ? new Error().stack : undefined;
-  return {
-    data,
-    message,
-    stack: maybeStack
-  };
-};
-function __awaiter(thisArg, _arguments, P, generator) {
-  function adopt(value) {
-    return value instanceof P ? value : new P(function(resolve) {
-      resolve(value);
-    });
-  }
-  return new (P || (P = Promise))(function(resolve, reject) {
-    function fulfilled(value) {
-      try {
-        step(generator.next(value));
-      } catch (e) {
-        reject(e);
-      }
-    }
-    function rejected(value) {
-      try {
-        step(generator["throw"](value));
-      } catch (e) {
-        reject(e);
-      }
-    }
-    function step(result) {
-      result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected);
-    }
-    step((generator = generator.apply(thisArg, _arguments || [])).next());
-  });
-}
-function __values(o) {
-  var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
-  if (m)
-    return m.call(o);
-  if (o && typeof o.length === "number")
-    return {
-      next: function() {
-        if (o && i >= o.length)
-          o = undefined;
-        return { value: o && o[i++], done: !o };
-      }
-    };
-  throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
-}
-function __await(v) {
-  return this instanceof __await ? (this.v = v, this) : new __await(v);
-}
-function __asyncGenerator(thisArg, _arguments, generator) {
-  if (!Symbol.asyncIterator)
-    throw new TypeError("Symbol.asyncIterator is not defined.");
-  var g = generator.apply(thisArg, _arguments || []), i, q = [];
-  return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb("next"), verb("throw"), verb("return", awaitReturn), i[Symbol.asyncIterator] = function() {
-    return this;
-  }, i;
-  function awaitReturn(f) {
-    return function(v) {
-      return Promise.resolve(v).then(f, reject);
-    };
-  }
-  function verb(n, f) {
-    if (g[n]) {
-      i[n] = function(v) {
-        return new Promise(function(a, b) {
-          q.push([n, v, a, b]) > 1 || resume(n, v);
-        });
-      };
-      if (f)
-        i[n] = f(i[n]);
-    }
-  }
-  function resume(n, v) {
-    try {
-      step(g[n](v));
-    } catch (e) {
-      settle(q[0][3], e);
-    }
-  }
-  function step(r) {
-    r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r);
-  }
-  function fulfill(value) {
-    resume("next", value);
-  }
-  function reject(value) {
-    resume("throw", value);
-  }
-  function settle(f, v) {
-    if (f(v), q.shift(), q.length)
-      resume(q[0][0], q[0][1]);
-  }
-}
-function __asyncDelegator(o) {
-  var i, p;
-  return i = {}, verb("next"), verb("throw", function(e) {
-    throw e;
-  }), verb("return"), i[Symbol.iterator] = function() {
-    return this;
-  }, i;
-  function verb(n, f) {
-    i[n] = o[n] ? function(v) {
-      return (p = !p) ? { value: __await(o[n](v)), done: false } : f ? f(v) : v;
-    } : f;
-  }
-}
-function __asyncValues(o) {
-  if (!Symbol.asyncIterator)
-    throw new TypeError("Symbol.asyncIterator is not defined.");
-  var m = o[Symbol.asyncIterator], i;
-  return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function() {
-    return this;
-  }, i);
-  function verb(n) {
-    i[n] = o[n] && function(v) {
-      return new Promise(function(resolve, reject) {
-        v = o[n](v), settle(resolve, reject, v.done, v.value);
-      });
-    };
-  }
-  function settle(resolve, reject, d, v) {
-    Promise.resolve(v).then(function(v2) {
-      resolve({ value: v2, done: d });
-    }, reject);
-  }
-}
-class ResultAsync {
-  constructor(res) {
-    this._promise = res;
-  }
-  static fromSafePromise(promise) {
-    const newPromise = promise.then((value) => new Ok(value));
-    return new ResultAsync(newPromise);
-  }
-  static fromPromise(promise, errorFn) {
-    const newPromise = promise.then((value) => new Ok(value)).catch((e) => new Err(errorFn(e)));
-    return new ResultAsync(newPromise);
-  }
-  static fromThrowable(fn, errorFn) {
-    return (...args) => {
-      return new ResultAsync((() => __awaiter(this, undefined, undefined, function* () {
-        try {
-          return new Ok(yield fn(...args));
-        } catch (error) {
-          return new Err(errorFn ? errorFn(error) : error);
-        }
-      }))());
-    };
-  }
-  static combine(asyncResultList) {
-    return combineResultAsyncList(asyncResultList);
-  }
-  static combineWithAllErrors(asyncResultList) {
-    return combineResultAsyncListWithAllErrors(asyncResultList);
-  }
-  map(f) {
-    return new ResultAsync(this._promise.then((res) => __awaiter(this, undefined, undefined, function* () {
-      if (res.isErr()) {
-        return new Err(res.error);
-      }
-      return new Ok(yield f(res.value));
-    })));
-  }
-  andThrough(f) {
-    return new ResultAsync(this._promise.then((res) => __awaiter(this, undefined, undefined, function* () {
-      if (res.isErr()) {
-        return new Err(res.error);
-      }
-      const newRes = yield f(res.value);
-      if (newRes.isErr()) {
-        return new Err(newRes.error);
-      }
-      return new Ok(res.value);
-    })));
-  }
-  andTee(f) {
-    return new ResultAsync(this._promise.then((res) => __awaiter(this, undefined, undefined, function* () {
-      if (res.isErr()) {
-        return new Err(res.error);
-      }
-      try {
-        yield f(res.value);
-      } catch (e) {}
-      return new Ok(res.value);
-    })));
-  }
-  orTee(f) {
-    return new ResultAsync(this._promise.then((res) => __awaiter(this, undefined, undefined, function* () {
-      if (res.isOk()) {
-        return new Ok(res.value);
-      }
-      try {
-        yield f(res.error);
-      } catch (e) {}
-      return new Err(res.error);
-    })));
-  }
-  mapErr(f) {
-    return new ResultAsync(this._promise.then((res) => __awaiter(this, undefined, undefined, function* () {
-      if (res.isOk()) {
-        return new Ok(res.value);
-      }
-      return new Err(yield f(res.error));
-    })));
-  }
-  andThen(f) {
-    return new ResultAsync(this._promise.then((res) => {
-      if (res.isErr()) {
-        return new Err(res.error);
-      }
-      const newValue = f(res.value);
-      return newValue instanceof ResultAsync ? newValue._promise : newValue;
-    }));
-  }
-  orElse(f) {
-    return new ResultAsync(this._promise.then((res) => __awaiter(this, undefined, undefined, function* () {
-      if (res.isErr()) {
-        return f(res.error);
-      }
-      return new Ok(res.value);
-    })));
-  }
-  match(ok, _err) {
-    return this._promise.then((res) => res.match(ok, _err));
-  }
-  unwrapOr(t) {
-    return this._promise.then((res) => res.unwrapOr(t));
-  }
-  safeUnwrap() {
-    return __asyncGenerator(this, arguments, function* safeUnwrap_1() {
-      return yield __await(yield __await(yield* __asyncDelegator(__asyncValues(yield __await(this._promise.then((res) => res.safeUnwrap()))))));
-    });
-  }
-  then(successCallback, failureCallback) {
-    return this._promise.then(successCallback, failureCallback);
-  }
-  [Symbol.asyncIterator]() {
-    return __asyncGenerator(this, arguments, function* _a() {
-      const result = yield __await(this._promise);
-      if (result.isErr()) {
-        yield yield __await(errAsync(result.error));
-      }
-      return yield __await(result.value);
-    });
-  }
-}
-function errAsync(err) {
-  return new ResultAsync(Promise.resolve(new Err(err)));
-}
-var fromPromise = ResultAsync.fromPromise;
-var fromSafePromise = ResultAsync.fromSafePromise;
-var fromAsyncThrowable = ResultAsync.fromThrowable;
-var combineResultList = (resultList) => {
-  let acc = ok([]);
-  for (const result of resultList) {
-    if (result.isErr()) {
-      acc = err(result.error);
-      break;
-    } else {
-      acc.map((list) => list.push(result.value));
-    }
-  }
-  return acc;
-};
-var combineResultAsyncList = (asyncResultList) => ResultAsync.fromSafePromise(Promise.all(asyncResultList)).andThen(combineResultList);
-var combineResultListWithAllErrors = (resultList) => {
-  let acc = ok([]);
-  for (const result of resultList) {
-    if (result.isErr() && acc.isErr()) {
-      acc.error.push(result.error);
-    } else if (result.isErr() && acc.isOk()) {
-      acc = err([result.error]);
-    } else if (result.isOk() && acc.isOk()) {
-      acc.value.push(result.value);
-    }
-  }
-  return acc;
-};
-var combineResultAsyncListWithAllErrors = (asyncResultList) => ResultAsync.fromSafePromise(Promise.all(asyncResultList)).andThen(combineResultListWithAllErrors);
-var Result;
-(function(Result2) {
-  function fromThrowable(fn, errorFn) {
-    return (...args) => {
-      try {
-        const result = fn(...args);
-        return ok(result);
-      } catch (e) {
-        return err(errorFn ? errorFn(e) : e);
-      }
-    };
-  }
-  Result2.fromThrowable = fromThrowable;
-  function combine(resultList) {
-    return combineResultList(resultList);
-  }
-  Result2.combine = combine;
-  function combineWithAllErrors(resultList) {
-    return combineResultListWithAllErrors(resultList);
-  }
-  Result2.combineWithAllErrors = combineWithAllErrors;
-})(Result || (Result = {}));
-function ok(value) {
-  return new Ok(value);
-}
-function err(err2) {
-  return new Err(err2);
-}
-class Ok {
-  constructor(value) {
-    this.value = value;
-  }
-  isOk() {
-    return true;
-  }
-  isErr() {
-    return !this.isOk();
-  }
-  map(f) {
-    return ok(f(this.value));
-  }
-  mapErr(_f) {
-    return ok(this.value);
-  }
-  andThen(f) {
-    return f(this.value);
-  }
-  andThrough(f) {
-    return f(this.value).map((_value) => this.value);
-  }
-  andTee(f) {
-    try {
-      f(this.value);
-    } catch (e) {}
-    return ok(this.value);
-  }
-  orTee(_f) {
-    return ok(this.value);
-  }
-  orElse(_f) {
-    return ok(this.value);
-  }
-  asyncAndThen(f) {
-    return f(this.value);
-  }
-  asyncAndThrough(f) {
-    return f(this.value).map(() => this.value);
-  }
-  asyncMap(f) {
-    return ResultAsync.fromSafePromise(f(this.value));
-  }
-  unwrapOr(_v) {
-    return this.value;
-  }
-  match(ok2, _err) {
-    return ok2(this.value);
-  }
-  safeUnwrap() {
-    const value = this.value;
-    return function* () {
-      return value;
-    }();
-  }
-  _unsafeUnwrap(_) {
-    return this.value;
-  }
-  _unsafeUnwrapErr(config) {
-    throw createNeverThrowError("Called `_unsafeUnwrapErr` on an Ok", this, config);
-  }
-  *[Symbol.iterator]() {
-    return this.value;
-  }
 }
 
-class Err {
-  constructor(error) {
-    this.error = error;
-  }
-  isOk() {
-    return false;
-  }
-  isErr() {
-    return !this.isOk();
-  }
-  map(_f) {
-    return err(this.error);
-  }
-  mapErr(f) {
-    return err(f(this.error));
-  }
-  andThrough(_f) {
-    return err(this.error);
-  }
-  andTee(_f) {
-    return err(this.error);
-  }
-  orTee(f) {
-    try {
-      f(this.error);
-    } catch (e) {}
-    return err(this.error);
-  }
-  andThen(_f) {
-    return err(this.error);
-  }
-  orElse(f) {
-    return f(this.error);
-  }
-  asyncAndThen(_f) {
-    return errAsync(this.error);
-  }
-  asyncAndThrough(_f) {
-    return errAsync(this.error);
-  }
-  asyncMap(_f) {
-    return errAsync(this.error);
-  }
-  unwrapOr(v) {
-    return v;
-  }
-  match(_ok, err2) {
-    return err2(this.error);
-  }
-  safeUnwrap() {
-    const error = this.error;
-    return function* () {
-      yield err(error);
-      throw new Error("Do not use this generator out of `safeTry`");
-    }();
-  }
-  _unsafeUnwrap(config) {
-    throw createNeverThrowError("Called `_unsafeUnwrap` on an Err", this, config);
-  }
-  _unsafeUnwrapErr(_) {
-    return this.error;
-  }
-  *[Symbol.iterator]() {
-    const self = this;
-    yield self;
-    return self;
-  }
-}
-var fromThrowable = Result.fromThrowable;
+// src/VexConnection.ts
+import { err, ok, ResultAsync } from "neverthrow";
 
 // src/VexPacketBase.ts
 var MATCH_STATUS_ALT_ACK = 167;
@@ -872,79 +415,115 @@ class CrcGenerator {
   }
 }
 
-// src/VexPacketModels.ts
-var exports_VexPacketModels = {};
-__export(exports_VexPacketModels, {
-  WriteKeyValueReplyD2HPacket: () => WriteKeyValueReplyD2HPacket,
-  WriteKeyValueH2DPacket: () => WriteKeyValueH2DPacket,
-  WriteFileReplyD2HPacket: () => WriteFileReplyD2HPacket,
-  WriteFileH2DPacket: () => WriteFileH2DPacket,
-  UpdateMatchModeH2DPacket: () => UpdateMatchModeH2DPacket,
-  SystemVersionReplyD2HPacket: () => SystemVersionReplyD2HPacket,
-  SystemVersionH2DPacket: () => SystemVersionH2DPacket,
-  SendDashTouchReplyD2HPacket: () => SendDashTouchReplyD2HPacket,
-  SendDashTouchH2DPacket: () => SendDashTouchH2DPacket,
-  SelectDashReplyD2HPacket: () => SelectDashReplyD2HPacket,
-  SelectDashH2DPacket: () => SelectDashH2DPacket,
-  ScreenCaptureReplyD2HPacket: () => ScreenCaptureReplyD2HPacket,
-  ScreenCaptureH2DPacket: () => ScreenCaptureH2DPacket,
-  ReadLogPageReplyD2HPacket: () => ReadLogPageReplyD2HPacket,
-  ReadLogPageH2DPacket: () => ReadLogPageH2DPacket,
-  ReadKeyValueReplyD2HPacket: () => ReadKeyValueReplyD2HPacket,
-  ReadKeyValueH2DPacket: () => ReadKeyValueH2DPacket,
-  ReadFileReplyD2HPacket: () => ReadFileReplyD2HPacket,
-  ReadFileH2DPacket: () => ReadFileH2DPacket,
-  Query1ReplyD2HPacket: () => Query1ReplyD2HPacket,
-  Query1H2DPacket: () => Query1H2DPacket,
-  MatchStatusReplyD2HPacket: () => MatchStatusReplyD2HPacket,
-  MatchModeReplyD2HPacket: () => MatchModeReplyD2HPacket,
-  LoadFileActionReplyD2HPacket: () => LoadFileActionReplyD2HPacket,
-  LoadFileActionH2DPacket: () => LoadFileActionH2DPacket,
-  LinkFileReplyD2HPacket: () => LinkFileReplyD2HPacket,
-  LinkFileH2DPacket: () => LinkFileH2DPacket,
-  InitFileTransferReplyD2HPacket: () => InitFileTransferReplyD2HPacket,
-  InitFileTransferH2DPacket: () => InitFileTransferH2DPacket,
-  GetSystemStatusReplyD2HPacket: () => GetSystemStatusReplyD2HPacket,
-  GetSystemStatusH2DPacket: () => GetSystemStatusH2DPacket,
-  GetSystemFlagsReplyD2HPacket: () => GetSystemFlagsReplyD2HPacket,
-  GetSystemFlagsH2DPacket: () => GetSystemFlagsH2DPacket,
-  GetSlot5to8InfoReplyD2HPacket: () => GetSlot5to8InfoReplyD2HPacket,
-  GetSlot5to8InfoH2DPacket: () => GetSlot5to8InfoH2DPacket,
-  GetSlot1to4InfoReplyD2HPacket: () => GetSlot1to4InfoReplyD2HPacket,
-  GetSlot1to4InfoH2DPacket: () => GetSlot1to4InfoH2DPacket,
-  GetRadioStatusReplyD2HPacket: () => GetRadioStatusReplyD2HPacket,
-  GetRadioStatusH2DPacket: () => GetRadioStatusH2DPacket,
-  GetRadioModeH2DPacket: () => GetRadioModeH2DPacket,
-  GetProgramSlotInfoReplyD2HPacket: () => GetProgramSlotInfoReplyD2HPacket,
-  GetProgramSlotInfoH2DPacket: () => GetProgramSlotInfoH2DPacket,
-  GetMatchStatusH2DPacket: () => GetMatchStatusH2DPacket,
-  GetLogCountReplyD2HPacket: () => GetLogCountReplyD2HPacket,
-  GetLogCountH2DPacket: () => GetLogCountH2DPacket,
-  GetFileMetadataReplyD2HPacket: () => GetFileMetadataReplyD2HPacket,
-  GetFileMetadataH2DPacket: () => GetFileMetadataH2DPacket,
-  GetFdtStatusReplyD2HPacket: () => GetFdtStatusReplyD2HPacket,
-  GetFdtStatusH2DPacket: () => GetFdtStatusH2DPacket,
-  GetDirectoryFileCountReplyD2HPacket: () => GetDirectoryFileCountReplyD2HPacket,
-  GetDirectoryFileCountH2DPacket: () => GetDirectoryFileCountH2DPacket,
-  GetDirectoryEntryReplyD2HPacket: () => GetDirectoryEntryReplyD2HPacket,
-  GetDirectoryEntryH2DPacket: () => GetDirectoryEntryH2DPacket,
-  GetDeviceStatusReplyD2HPacket: () => GetDeviceStatusReplyD2HPacket,
-  GetDeviceStatusH2DPacket: () => GetDeviceStatusH2DPacket,
-  FileFormatReplyD2HPacket: () => FileFormatReplyD2HPacket,
-  FileFormatH2DPacket: () => FileFormatH2DPacket,
-  FileControlReplyD2HPacket: () => FileControlReplyD2HPacket,
-  FileControlH2DPacket: () => FileControlH2DPacket,
-  FileClearUpReplyD2HPacket: () => FileClearUpReplyD2HPacket,
-  FileClearUpH2DPacket: () => FileClearUpH2DPacket,
-  FactoryStatusReplyD2HPacket: () => FactoryStatusReplyD2HPacket,
-  FactoryStatusH2DPacket: () => FactoryStatusH2DPacket,
-  FactoryEnableReplyD2HPacket: () => FactoryEnableReplyD2HPacket,
-  FactoryEnableH2DPacket: () => FactoryEnableH2DPacket,
-  ExitFileTransferReplyD2HPacket: () => ExitFileTransferReplyD2HPacket,
-  ExitFileTransferH2DPacket: () => ExitFileTransferH2DPacket,
-  EraseFileReplyD2HPacket: () => EraseFileReplyD2HPacket,
-  EraseFileH2DPacket: () => EraseFileH2DPacket
-});
+// src/VexPacketEncoder.ts
+var textEncoder = new TextEncoder;
+var HEADER_TO_DEVICE = Uint8Array.of(201, 54, 184, 71);
+function encodeFixedText(value, field, maxBytes) {
+  const encoded = textEncoder.encode(value);
+  if (encoded.byteLength > maxBytes) {
+    throw new RangeError(`${field} must be at most ${maxBytes} UTF-8 bytes`);
+  }
+  return encoded;
+}
+
+class PacketEncoder {
+  static HEADERS_LENGTH = 4;
+  static HEADER_TO_DEVICE = [201, 54, 184, 71];
+  static HEADER_TO_HOST = [170, 85];
+  static J2000_EPOCH = 946684800;
+  vexVersion = 0;
+  crcgen = new CrcGenerator;
+  allPacketsTable = new Map;
+  static getInstance() {
+    Packet.ENCODER ??= new PacketEncoder;
+    return Packet.ENCODER;
+  }
+  constructor() {}
+  registerPacketTypes(types) {
+    for (const type of types) {
+      let byExtendedId = this.allPacketsTable.get(type.COMMAND_ID);
+      if (byExtendedId === undefined) {
+        byExtendedId = new Map;
+        this.allPacketsTable.set(type.COMMAND_ID, byExtendedId);
+      }
+      byExtendedId.set(type.COMMAND_EXTENDED_ID, type);
+    }
+  }
+  getPacketType(commandId, commandExtendedId) {
+    if (commandId === undefined)
+      return;
+    return this.allPacketsTable.get(commandId)?.get(commandExtendedId);
+  }
+  createHeader(buf) {
+    if (buf === undefined || buf.byteLength < PacketEncoder.HEADERS_LENGTH) {
+      buf = new ArrayBuffer(PacketEncoder.HEADERS_LENGTH);
+    }
+    const h = new Uint8Array(buf);
+    h.set(HEADER_TO_DEVICE);
+    return h;
+  }
+  cdcCommand(cmd) {
+    const h = new Uint8Array(5);
+    h.set(HEADER_TO_DEVICE);
+    h[4] = cmd;
+    return h;
+  }
+  cdcCommandWithData(cmd, data) {
+    const h = new Uint8Array(6 + data.length);
+    h.set(HEADER_TO_DEVICE);
+    h[4] = cmd;
+    h[5] = data.length;
+    h.set(data, 6);
+    return h;
+  }
+  cdc2Command(cmd, ext) {
+    const h = new Uint8Array(9);
+    h.set(HEADER_TO_DEVICE);
+    h[4] = cmd;
+    h[5] = ext;
+    h[6] = 0;
+    this.appendCrc16(h);
+    return h;
+  }
+  cdc2CommandBufferLength(data) {
+    return PacketEncoder.HEADERS_LENGTH + data.length + 5 + (data.length > 127 ? 1 : 0);
+  }
+  cdc2CommandWithData(cmd, ext, data) {
+    const h = new Uint8Array(this.cdc2CommandBufferLength(data));
+    h.set(HEADER_TO_DEVICE);
+    h[4] = cmd;
+    h[5] = ext;
+    if (data.length < 128) {
+      h[6] = data.length;
+      h.set(data, 7);
+    } else {
+      h[6] = data.length >>> 8 | 128;
+      h[7] = data.length & 255;
+      h.set(data, 8);
+    }
+    this.appendCrc16(h);
+    return h;
+  }
+  appendCrc16(h) {
+    const crc = this.crcgen.crc16(h.subarray(0, h.length - 2), 0);
+    h[h.length - 2] = crc >>> 8;
+    h[h.length - 1] = crc & 255;
+  }
+  validateHeader(data) {
+    return data[0] === PacketEncoder.HEADER_TO_HOST[0] && data[1] === PacketEncoder.HEADER_TO_HOST[1];
+  }
+  validateMessageCdc(data) {
+    const crc = (data[data.byteLength - 2] << 8) + data[data.byteLength - 1];
+    return this.crcgen.crc16(data.subarray(0, data.byteLength - 2), 0) === crc;
+  }
+  getPayloadSize(data) {
+    const a = data[3];
+    return (a & 128) === 0 ? a : ((a & 127) << 8) + data[4];
+  }
+  getHostHeaderLength(data) {
+    return (data[3] & 128) === 0 ? 4 : 5;
+  }
+}
 
 // src/VexFirmwareVersion.ts
 class VexFirmwareVersion {
@@ -1015,7 +594,7 @@ class PacketView extends DataView {
     super(buffer, offset, length);
   }
   static fromPacket(packet) {
-    const view = new PacketView(packet.data.buffer, packet.data.byteOffset);
+    const view = new PacketView(packet.data.buffer, packet.data.byteOffset, packet.data.byteLength);
     view.position = packet.ackIndex + 1;
     return view;
   }
@@ -1077,12 +656,12 @@ class PacketView extends DataView {
 }
 
 // src/VexPacketModels.ts
-var textEncoder = new TextEncoder;
+var textEncoder2 = new TextEncoder;
 function filePayload(a, b, fileName) {
   const payload = new Uint8Array(26);
   payload[0] = a;
   payload[1] = b;
-  payload.set(encodeFixedText(fileName, "Filename", 23), 2);
+  payload.set(encodeFixedText(fileName, "Filename", 24), 2);
   return payload;
 }
 var clamp100 = (value) => value !== undefined && value > 100 ? 100 : value;
@@ -1150,7 +729,7 @@ class InitFileTransferH2DPacket extends DeviceBoundPacket {
     const timestamp = (Date.now() / 1000 >>> 0) - PacketEncoder.J2000_EPOCH;
     view.setUint32(20, timestamp, true);
     payload.set(version.toUint8Array(), 24);
-    payload.set(encodeFixedText(name, "Filename", 23), 28);
+    payload.set(encodeFixedText(name, "Filename", 24), 28);
     super(payload);
   }
 }
@@ -1345,7 +924,7 @@ class WriteKeyValueH2DPacket extends DeviceBoundPacket {
   static COMMAND_EXTENDED_ID = 47;
   constructor(key, value) {
     const strk = encodeFixedText(key, "Key", 31);
-    const strv = textEncoder.encode(value);
+    const strv = textEncoder2.encode(value);
     if (strk.byteLength + strv.byteLength + 20 > 32767) {
       throw new RangeError("Key and value are too large for a protocol packet");
     }
@@ -1508,7 +1087,7 @@ class ReadFileReplyD2HPacket extends HostBoundPacket {
     const view = PacketView.fromPacket(this);
     this.addr = view.nextUint32();
     this.length = this.payloadSize - 8;
-    this.buf = this.data.slice(view.position, view.position + this.length).buffer;
+    this.buf = this.data.subarray(view.position, view.position + this.length);
   }
 }
 
@@ -1808,185 +1387,95 @@ class ReadKeyValueReplyD2HPacket extends HostBoundPacket {
   value;
   constructor(data) {
     super(data);
-    this.value = PacketView.fromPacket(this).nextVarNTBS(255);
-  }
-}
-
-class WriteKeyValueReplyD2HPacket extends HostBoundPacket {
-  static COMMAND_ID = 86;
-  static COMMAND_EXTENDED_ID = 47;
-}
-
-class GetSlot1to4InfoReplyD2HPacket extends HostBoundPacket {
-  static COMMAND_ID = 86;
-  static COMMAND_EXTENDED_ID = 49;
-  slotFlags;
-  slots;
-  constructor(data, start = 1) {
-    super(data);
-    const view = PacketView.fromPacket(this);
-    this.slotFlags = view.nextUint8();
-    this.slots = [];
-    for (let i = 0;i < 4; i++) {
-      if ((this.slotFlags & 1 << start - 1 + i) === 0)
-        continue;
-      const icon = view.nextUint16();
-      const nameLen = view.nextUint8();
-      this.slots.push({
-        slot: start + i,
-        icon,
-        name: view.nextString(nameLen)
-      });
-    }
-  }
-}
-
-class GetSlot5to8InfoReplyD2HPacket extends GetSlot1to4InfoReplyD2HPacket {
-  static COMMAND_ID = 86;
-  static COMMAND_EXTENDED_ID = 50;
-  slotStartIndex = 5;
-  constructor(data) {
-    super(data, 5);
-  }
-}
-
-class FactoryStatusReplyD2HPacket extends HostBoundPacket {
-  static COMMAND_ID = 86;
-  static COMMAND_EXTENDED_ID = 241;
-  status;
-  percent;
-  constructor(data) {
-    super(data);
-    const view = PacketView.fromPacket(this);
-    this.status = view.nextUint8();
-    this.percent = view.nextUint8();
-  }
-}
-
-class FactoryEnableReplyD2HPacket extends HostBoundPacket {
-  static COMMAND_ID = 86;
-  static COMMAND_EXTENDED_ID = 255;
-}
-
-// src/VexPacketEncoder.ts
-var textEncoder2 = new TextEncoder;
-var HEADER_TO_DEVICE = Uint8Array.of(201, 54, 184, 71);
-function encodeFixedText(value, field, maxBytes) {
-  const encoded = textEncoder2.encode(value);
-  if (encoded.byteLength > maxBytes) {
-    throw new RangeError(`${field} must be at most ${maxBytes} UTF-8 bytes`);
-  }
-  return encoded;
-}
-
-class PacketEncoder {
-  static HEADERS_LENGTH = 4;
-  static HEADER_TO_DEVICE = [201, 54, 184, 71];
-  static HEADER_TO_HOST = [170, 85];
-  static J2000_EPOCH = 946684800;
-  vexVersion = 0;
-  crcgen = new CrcGenerator;
-  allPacketsTable = new Map;
-  static getInstance() {
-    Packet.ENCODER ??= new PacketEncoder;
-    return Packet.ENCODER;
-  }
-  constructor() {
-    for (const packet of Object.values(exports_VexPacketModels)) {
-      if (typeof packet === "function" && packet.prototype instanceof HostBoundPacket) {
-        const type = packet;
-        let byExtendedId = this.allPacketsTable.get(type.COMMAND_ID);
-        if (byExtendedId === undefined) {
-          byExtendedId = new Map;
-          this.allPacketsTable.set(type.COMMAND_ID, byExtendedId);
-        }
-        byExtendedId.set(type.COMMAND_EXTENDED_ID, type);
-      }
-    }
-  }
-  getPacketType(commandId, commandExtendedId) {
-    if (commandId === undefined)
-      return;
-    return this.allPacketsTable.get(commandId)?.get(commandExtendedId);
-  }
-  createHeader(buf) {
-    if (buf === undefined || buf.byteLength < PacketEncoder.HEADERS_LENGTH) {
-      buf = new ArrayBuffer(PacketEncoder.HEADERS_LENGTH);
-    }
-    const h = new Uint8Array(buf);
-    h.set(HEADER_TO_DEVICE);
-    return h;
-  }
-  cdcCommand(cmd) {
-    const h = new Uint8Array(5);
-    h.set(HEADER_TO_DEVICE);
-    h[4] = cmd;
-    return h;
-  }
-  cdcCommandWithData(cmd, data) {
-    const h = new Uint8Array(6 + data.length);
-    h.set(HEADER_TO_DEVICE);
-    h[4] = cmd;
-    h[5] = data.length;
-    h.set(data, 6);
-    return h;
-  }
-  cdc2Command(cmd, ext) {
-    const h = new Uint8Array(9);
-    h.set(HEADER_TO_DEVICE);
-    h[4] = cmd;
-    h[5] = ext;
-    h[6] = 0;
-    this.appendCrc16(h);
-    return h;
-  }
-  cdc2CommandBufferLength(data) {
-    return PacketEncoder.HEADERS_LENGTH + data.length + 5 + (data.length > 127 ? 1 : 0);
-  }
-  cdc2CommandWithData(cmd, ext, data) {
-    const h = new Uint8Array(this.cdc2CommandBufferLength(data));
-    h.set(HEADER_TO_DEVICE);
-    h[4] = cmd;
-    h[5] = ext;
-    if (data.length < 128) {
-      h[6] = data.length;
-      h.set(data, 7);
-    } else {
-      h[6] = data.length >>> 8 | 128;
-      h[7] = data.length & 255;
-      h.set(data, 8);
-    }
-    this.appendCrc16(h);
-    return h;
-  }
-  appendCrc16(h) {
-    const crc = this.crcgen.crc16(h.subarray(0, h.length - 2), 0);
-    h[h.length - 2] = crc >>> 8;
-    h[h.length - 1] = crc & 255;
-  }
-  validateHeader(data) {
-    return data[0] === PacketEncoder.HEADER_TO_HOST[0] && data[1] === PacketEncoder.HEADER_TO_HOST[1];
+    this.value = PacketView.fromPacket(this).nextVarNTBS(255);
   }
-  validateMessageCdc(data) {
-    const crc = (data[data.byteLength - 2] << 8) + data[data.byteLength - 1];
-    return this.crcgen.crc16(data.subarray(0, data.byteLength - 2), 0) === crc;
+}
+
+class WriteKeyValueReplyD2HPacket extends HostBoundPacket {
+  static COMMAND_ID = 86;
+  static COMMAND_EXTENDED_ID = 47;
+}
+
+class GetSlot1to4InfoReplyD2HPacket extends HostBoundPacket {
+  static COMMAND_ID = 86;
+  static COMMAND_EXTENDED_ID = 49;
+  slotFlags;
+  slots;
+  constructor(data, start = 1) {
+    super(data);
+    const view = PacketView.fromPacket(this);
+    this.slotFlags = view.nextUint8();
+    this.slots = [];
+    for (let i = 0;i < 4; i++) {
+      if ((this.slotFlags & 1 << start - 1 + i) === 0)
+        continue;
+      const icon = view.nextUint16();
+      const nameLen = view.nextUint8();
+      this.slots.push({
+        slot: start + i,
+        icon,
+        name: view.nextString(nameLen)
+      });
+    }
   }
-  getPayloadSize(data) {
-    const a = data[3];
-    return (a & 128) === 0 ? a : ((a & 127) << 8) + data[4];
+}
+
+class GetSlot5to8InfoReplyD2HPacket extends GetSlot1to4InfoReplyD2HPacket {
+  static COMMAND_ID = 86;
+  static COMMAND_EXTENDED_ID = 50;
+  slotStartIndex = 5;
+  constructor(data) {
+    super(data, 5);
   }
-  getHostHeaderLength(data) {
-    return (data[3] & 128) === 0 ? 4 : 5;
+}
+
+class FactoryStatusReplyD2HPacket extends HostBoundPacket {
+  static COMMAND_ID = 86;
+  static COMMAND_EXTENDED_ID = 241;
+  status;
+  percent;
+  constructor(data) {
+    super(data);
+    const view = PacketView.fromPacket(this);
+    this.status = view.nextUint8();
+    this.percent = view.nextUint8();
   }
 }
 
-// src/VexConnection.ts
-var thePacketEncoder = PacketEncoder.getInstance();
+class FactoryEnableReplyD2HPacket extends HostBoundPacket {
+  static COMMAND_ID = 86;
+  static COMMAND_EXTENDED_ID = 255;
+}
+
+// src/VexScreenCapture.ts
 var SCREEN_CAPTURE_HEIGHT = 272;
 var SCREEN_CAPTURE_WIDTH = 480;
 var SCREEN_CAPTURE_CHANNELS = 3;
 var SCREEN_CAPTURE_MESSAGE_WIDTH = 512;
 var SCREEN_CAPTURE_MESSAGE_CHANNELS = 4;
+var SCREEN_CAPTURE_FRAMEBUFFER_SIZE = SCREEN_CAPTURE_MESSAGE_WIDTH * SCREEN_CAPTURE_HEIGHT * SCREEN_CAPTURE_MESSAGE_CHANNELS;
+function convertScreenCapture(framebuffer) {
+  if (framebuffer.length !== SCREEN_CAPTURE_FRAMEBUFFER_SIZE) {
+    throw new Error(`bad screen capture framebuffer size: ${framebuffer.length}; expected ${SCREEN_CAPTURE_FRAMEBUFFER_SIZE}`);
+  }
+  const pixels = new Uint8Array(SCREEN_CAPTURE_WIDTH * SCREEN_CAPTURE_HEIGHT * SCREEN_CAPTURE_CHANNELS);
+  let source = 0;
+  let target = 0;
+  for (let row = 0;row < SCREEN_CAPTURE_HEIGHT; row++) {
+    for (let column = 0;column < SCREEN_CAPTURE_WIDTH; column++) {
+      pixels[target] = framebuffer[source + 2];
+      pixels[target + 1] = framebuffer[source + 1];
+      pixels[target + 2] = framebuffer[source];
+      source += SCREEN_CAPTURE_MESSAGE_CHANNELS;
+      target += SCREEN_CAPTURE_CHANNELS;
+    }
+    source += (SCREEN_CAPTURE_MESSAGE_WIDTH - SCREEN_CAPTURE_WIDTH) * SCREEN_CAPTURE_MESSAGE_CHANNELS;
+  }
+  return pixels;
+}
+
+// src/VexConnection.ts
+var thePacketEncoder = PacketEncoder.getInstance();
 
 class VexSerialConnection extends VexEventTarget {
   filters = [{ usbVendorId: 10376 }];
@@ -1994,12 +1483,31 @@ class VexSerialConnection extends VexEventTarget {
   reader;
   port;
   serial;
-  callbacksQueue = [];
+  pendingCallbacks = new Map;
+  rawCallbacks = {
+    head: undefined,
+    tail: undefined
+  };
+  pendingCommandTails = new Map;
   _onPortDisconnect = null;
   _closePromise = null;
+  _openPromise = null;
+  _isClosing = false;
   _wasConnected = false;
   fileTransferTail = Promise.resolve();
   fileTransferDepth = 0;
+  get callbacksQueue() {
+    const callbacks = [];
+    for (const queue of this.pendingCallbacks.values()) {
+      for (let callback = queue.head;callback; callback = callback.next) {
+        callbacks.push(callback);
+      }
+    }
+    for (let callback = this.rawCallbacks.head;callback; callback = callback.next) {
+      callbacks.push(callback);
+    }
+    return callbacks;
+  }
   get isConnected() {
     return this.port !== undefined && this.reader !== undefined && this.writer !== undefined;
   }
@@ -2011,27 +1519,45 @@ class VexSerialConnection extends VexEventTarget {
     this.serial = serial;
   }
   reportWarning(message, details) {
-    this.emit("warning", { message, details });
+    this.emitSafely("warning", {
+      message,
+      details
+    });
+  }
+  emitSafely(eventName, data) {
+    try {
+      this.emit(eventName, data);
+    } catch {}
   }
   async close() {
     if (this._closePromise)
       return this._closePromise;
-    if (!this._hasOpenResources())
-      return;
-    this._closePromise = this._doClose();
+    this._isClosing = true;
+    const closing = this._closeAfterOpen();
+    this._closePromise = closing;
     try {
-      await this._closePromise;
+      await closing;
     } finally {
-      this._closePromise = null;
+      if (this._closePromise === closing)
+        this._closePromise = null;
+      this._isClosing = false;
     }
   }
+  async _closeAfterOpen() {
+    const opening = this._openPromise;
+    if (opening !== null)
+      await opening;
+    if (!this._hasOpenResources())
+      return;
+    await this._doClose();
+  }
   _hasOpenResources() {
-    return this.port !== undefined || this.reader !== undefined || this.writer !== undefined || this._onPortDisconnect !== null || this.callbacksQueue.length > 0;
+    return this.port !== undefined || this.reader !== undefined || this.writer !== undefined || this._onPortDisconnect !== null || this.hasPendingCallbacks();
   }
   async _doClose() {
-    for (const callback of this.callbacksQueue.splice(0)) {
+    for (const callback of this.drainPendingCallbacks()) {
       clearTimeout(callback.timeout);
-      callback.callback(255 /* CDC2_NACK */);
+      callback.callback(258 /* NOT_CONNECTED */);
     }
     const onDisconnect = this._onPortDisconnect;
     this._onPortDisconnect = null;
@@ -2080,11 +1606,22 @@ class VexSerialConnection extends VexEventTarget {
     }
     if (this._wasConnected) {
       this._wasConnected = false;
-      this.emit("disconnected", undefined);
+      this.emitSafely("disconnected", undefined);
     }
   }
   open(use = 0, askUser = true) {
-    return new ResultAsync(this._open(use, askUser));
+    if (this._openPromise !== null)
+      return new ResultAsync(this._openPromise);
+    const opening = this._open(use, askUser);
+    this._openPromise = opening;
+    opening.then(() => {
+      if (this._openPromise === opening)
+        this._openPromise = null;
+    }, () => {
+      if (this._openPromise === opening)
+        this._openPromise = null;
+    });
+    return new ResultAsync(opening);
   }
   async _open(use, askUser) {
     if (this._closePromise !== null)
@@ -2117,38 +1654,63 @@ class VexSerialConnection extends VexEventTarget {
       this.reader = this.port.readable.getReader();
       this.startReader();
       this._wasConnected = true;
-      this.emit("connected", undefined);
+      this.emitSafely("connected", undefined);
       return ok("opened");
     } catch (e) {
-      await this.close();
+      await this._doClose();
       return err(toVexSerialError(e, "io"));
     }
   }
   async writeDataAsync(rawData, timeout = 1000) {
+    if (rawData instanceof DeviceBoundPacket) {
+      return this.serializeCommand(rawData.commandId, rawData.commandExtendedId, () => this.writeDataAsyncUnserialized(rawData, timeout));
+    }
+    return this.writeDataAsyncUnserialized(rawData, timeout);
+  }
+  async serializeCommand(commandId, commandExtendedId, operation) {
+    const key = `${commandId}:${commandExtendedId ?? ""}`;
+    const previous = this.pendingCommandTails.get(key) ?? Promise.resolve();
+    let release = () => {};
+    const current = new Promise((resolve) => {
+      release = resolve;
+    });
+    this.pendingCommandTails.set(key, current);
+    await previous;
+    try {
+      return await operation();
+    } finally {
+      release();
+      if (this.pendingCommandTails.get(key) === current) {
+        this.pendingCommandTails.delete(key);
+      }
+    }
+  }
+  async writeDataAsyncUnserialized(rawData, timeout) {
     return new Promise((resolve) => {
-      if (this.writer === undefined) {
-        resolve(255 /* CDC2_NACK */);
+      if (this.writer === undefined || this._isClosing) {
+        resolve(258 /* NOT_CONNECTED */);
         return;
       }
       const data = rawData instanceof DeviceBoundPacket ? rawData.data : rawData;
+      const queue = rawData instanceof DeviceBoundPacket ? this.getPendingQueue(rawData.commandId, rawData.commandExtendedId, true) : this.rawCallbacks;
       const cb = {
+        active: true,
         callback: resolve,
         timeout: setTimeout(() => {
-          const index = this.callbacksQueue.indexOf(cb);
-          if (index === -1)
+          if (!this.removePendingCallback(cb))
             return;
-          this.callbacksQueue.splice(index, 1);
           cb.callback(256 /* TIMEOUT */);
         }, timeout),
+        next: undefined,
+        previous: undefined,
+        queue,
         wantedCommandId: rawData instanceof DeviceBoundPacket ? rawData.commandId : undefined,
         wantedCommandExId: rawData instanceof DeviceBoundPacket ? rawData.commandExtendedId : undefined
       };
-      this.callbacksQueue.push(cb);
+      this.enqueuePendingCallback(cb);
       this.writer.write(data).catch(() => {
-        const index = this.callbacksQueue.indexOf(cb);
-        if (index === -1)
+        if (!this.removePendingCallback(cb))
           return;
-        this.callbacksQueue.splice(index, 1);
         clearTimeout(cb.timeout);
         resolve(257 /* WRITE_ERROR */);
       });
@@ -2159,6 +1721,9 @@ class VexSerialConnection extends VexEventTarget {
       const result = await this.writeDataAsync(packet, timeout);
       if (result instanceof ReplyType)
         return ok(result);
+      if (result === 258 /* NOT_CONNECTED */) {
+        return err(new VexNotConnectedError);
+      }
       return err(new VexProtocolError(expectedReplyMessage(packet, ReplyType, result), typeof result === "number" ? result : undefined));
     })());
   }
@@ -2169,56 +1734,48 @@ class VexSerialConnection extends VexEventTarget {
       const { value: readData, done: isDone } = await this.reader.read();
       if (isDone)
         throw new Error("No data");
-      cache = binaryArrayJoin(cache, readData);
+      cache.append(readData);
     }
-    return cache;
   }
   async startReader() {
-    let cache = new Uint8Array([]);
+    const cache = new ReceiveBuffer;
     let sliceIdx = 0;
     for (;; )
       try {
-        cache = await this.readData(cache, 5);
+        await this.readData(cache, 5);
         sliceIdx = 0;
-        while (!thePacketEncoder.validateHeader(cache)) {
-          const nextHeader = cache.findIndex((byte, index) => index > 0 && byte === PacketEncoder.HEADER_TO_HOST[0] && cache[index + 1] === PacketEncoder.HEADER_TO_HOST[1]);
+        while (!thePacketEncoder.validateHeader(cache.bytes)) {
+          const bytes = cache.bytes;
+          const nextHeader = bytes.findIndex((byte, index) => index > 0 && byte === PacketEncoder.HEADER_TO_HOST[0] && bytes[index + 1] === PacketEncoder.HEADER_TO_HOST[1]);
           if (nextHeader >= 0) {
-            cache = cache.slice(nextHeader);
+            cache.discard(nextHeader);
           } else {
-            cache = cache.slice(cache.at(-1) === PacketEncoder.HEADER_TO_HOST[0] ? -1 : cache.length);
+            cache.discard(bytes.at(-1) === PacketEncoder.HEADER_TO_HOST[0] ? -1 : bytes.length);
           }
-          cache = await this.readData(cache, 5);
+          await this.readData(cache, 5);
         }
-        const payloadExpectedSize = thePacketEncoder.getPayloadSize(cache);
-        const n = thePacketEncoder.getHostHeaderLength(cache);
+        const payloadExpectedSize = thePacketEncoder.getPayloadSize(cache.bytes);
+        const n = thePacketEncoder.getHostHeaderLength(cache.bytes);
         const totalSize = n + payloadExpectedSize;
-        cache = await this.readData(cache, totalSize);
+        await this.readData(cache, totalSize);
         sliceIdx = totalSize;
-        const cmdId = cache[2];
+        const packet = cache.copy(totalSize);
+        const cmdId = packet[2];
         const hasExtId = cmdId === 88 || cmdId === 86;
-        const cmdExId = hasExtId ? cache[n] : undefined;
-        const ack = cache[n + 1];
+        const cmdExId = hasExtId ? packet[n] : undefined;
+        const ack = packet[n + 1];
         if (hasExtId) {
-          if (!thePacketEncoder.validateMessageCdc(cache))
-            throw new Error("Invalid message CDC");
-        }
-        let matchIdx = -1;
-        let untypedIdx = -1;
-        for (let i = 0;i < this.callbacksQueue.length; i++) {
-          const candidate = this.callbacksQueue[i];
-          if (candidate.wantedCommandId === undefined && candidate.wantedCommandExId === undefined) {
-            if (untypedIdx === -1)
-              untypedIdx = i;
+          if (!thePacketEncoder.validateMessageCdc(packet)) {
+            this.reportWarning("discarding a reply with an invalid CDC CRC", {
+              commandId: cmdId,
+              commandExtendedId: cmdExId,
+              ack
+            });
             continue;
           }
-          if ((candidate.wantedCommandId === undefined || candidate.wantedCommandId === cmdId) && (candidate.wantedCommandExId === undefined || candidate.wantedCommandExId === cmdExId)) {
-            matchIdx = i;
-            break;
-          }
         }
-        if (matchIdx === -1)
-          matchIdx = untypedIdx;
-        if (matchIdx === -1) {
+        const callbackInfo = this.shiftPendingCallback(cmdId, cmdExId) ?? this.shiftRawCallback();
+        if (callbackInfo === undefined) {
           this.reportWarning("received a reply with no matching request", {
             commandId: cmdId,
             commandExtendedId: cmdExId,
@@ -2226,38 +1783,117 @@ class VexSerialConnection extends VexEventTarget {
           });
           continue;
         }
-        const callbackInfo = this.callbacksQueue[matchIdx];
         const wantedCmdId = callbackInfo.wantedCommandId;
         const wantedCmdExId = callbackInfo.wantedCommandExId;
-        const data = cache.slice(0, sliceIdx);
         const PackageType = thePacketEncoder.getPacketType(wantedCmdId, wantedCmdExId);
         if (wantedCmdId === undefined || PackageType === undefined) {
           if (wantedCmdId !== undefined) {
             this.reportWarning("no packet class is registered for the wanted command", { commandId: wantedCmdId, commandExtendedId: wantedCmdExId });
           }
-          callbackInfo.callback(data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength));
+          callbackInfo.callback(packet.buffer);
         } else {
-          if (!hasExtId || PackageType.isValidPacket(data, n)) {
-            callbackInfo.callback(new PackageType(data));
+          if (PackageType.isValidPacket(packet, n)) {
+            callbackInfo.callback(new PackageType(packet));
           } else {
             this.reportWarning("reply failed packet validation; delivering its ack instead", { commandId: cmdId, commandExtendedId: cmdExId, ack });
             callbackInfo.callback(ack);
           }
         }
         clearTimeout(callbackInfo.timeout);
-        this.callbacksQueue.splice(matchIdx, 1);
       } catch (e) {
         if (!(e instanceof Error && e.message === "No data")) {
           this.reportWarning("reader loop stopped by a read error", {
             error: e,
-            pendingBytes: cache
+            pendingBytes: cache.bytes
           });
         }
         await this.close();
         break;
       } finally {
-        cache = cache.slice(sliceIdx);
+        cache.discard(sliceIdx);
+      }
+  }
+  pendingKey(commandId, commandExtendedId) {
+    return `${commandId}:${commandExtendedId ?? ""}`;
+  }
+  getPendingQueue(commandId, commandExtendedId, create) {
+    const key = this.pendingKey(commandId, commandExtendedId);
+    let queue = this.pendingCallbacks.get(key);
+    if (queue === undefined && create) {
+      const created = { head: undefined, tail: undefined };
+      this.pendingCallbacks.set(key, created);
+      queue = created;
+    }
+    return queue ?? { head: undefined, tail: undefined };
+  }
+  enqueuePendingCallback(callback) {
+    const tail = callback.queue.tail;
+    callback.previous = tail;
+    if (tail === undefined)
+      callback.queue.head = callback;
+    else
+      tail.next = callback;
+    callback.queue.tail = callback;
+  }
+  removePendingCallback(callback) {
+    if (!callback.active)
+      return false;
+    callback.active = false;
+    const { queue, previous, next } = callback;
+    if (previous === undefined)
+      queue.head = next;
+    else
+      previous.next = next;
+    if (next === undefined)
+      queue.tail = previous;
+    else
+      next.previous = previous;
+    callback.previous = undefined;
+    callback.next = undefined;
+    if (queue !== this.rawCallbacks && queue.head === undefined && callback.wantedCommandId !== undefined) {
+      this.pendingCallbacks.delete(this.pendingKey(callback.wantedCommandId, callback.wantedCommandExId));
+    }
+    return true;
+  }
+  shiftPendingCallback(commandId, commandExtendedId) {
+    const queue = this.getPendingQueue(commandId, commandExtendedId, false);
+    const callback = queue.head;
+    if (callback !== undefined)
+      this.removePendingCallback(callback);
+    return callback;
+  }
+  shiftRawCallback() {
+    const callback = this.rawCallbacks.head;
+    if (callback !== undefined)
+      this.removePendingCallback(callback);
+    return callback;
+  }
+  hasPendingCallbacks() {
+    return this.pendingCallbacks.size > 0 || this.rawCallbacks.head !== undefined;
+  }
+  drainPendingCallbacks() {
+    const callbacks = [];
+    for (const queue of this.pendingCallbacks.values()) {
+      for (let callback = queue.head;callback; ) {
+        const next = callback.next;
+        callback.active = false;
+        callback.previous = undefined;
+        callback.next = undefined;
+        callbacks.push(callback);
+        callback = next;
       }
+    }
+    for (let callback = this.rawCallbacks.head;callback; ) {
+      const next = callback.next;
+      callback.active = false;
+      callback.previous = undefined;
+      callback.next = undefined;
+      callbacks.push(callback);
+      callback = next;
+    }
+    this.pendingCallbacks.clear();
+    this.rawCallbacks = { head: undefined, tail: undefined };
+    return callbacks;
   }
   query1() {
     return this.request(new Query1H2DPacket, Query1ReplyD2HPacket, 100);
@@ -2375,7 +2011,9 @@ class V5SerialConnection extends VexSerialConnection {
       let bufferOffset = 0;
       const fileBuf = new Uint8Array(fileSize);
       while (bufferOffset < fileSize) {
-        const requestedSize = Math.min(bufferChunkSize, fileSize - bufferOffset);
+        const remainingSize = fileSize - bufferOffset;
+        const chunkSize = Math.min(bufferChunkSize, remainingSize);
+        const requestedSize = chunkSize + 3 & ~3;
         const p2Result = await this.request(new ReadFileH2DPacket(nextAddress, requestedSize), ReadFileReplyD2HPacket, 3000);
         if (p2Result.isErr())
           throw p2Result.error;
@@ -2386,9 +2024,10 @@ class V5SerialConnection extends VexSerialConnection {
         if (p2.length <= 0 || p2.length > requestedSize || p2.buf.byteLength !== p2.length) {
           throw new VexTransferError(`ReadFileReplyD2HPacket returned invalid length ${p2.length}`);
         }
-        fileBuf.set(new Uint8Array(p2.buf), bufferOffset);
-        bufferOffset += p2.length;
-        nextAddress += p2.length;
+        const receivedSize = Math.min(p2.length, remainingSize);
+        fileBuf.set(p2.buf.subarray(0, receivedSize), bufferOffset);
+        bufferOffset += receivedSize;
+        nextAddress += receivedSize;
         progressCallback?.(bufferOffset, fileSize);
       }
       transferFailed = false;
@@ -2543,7 +2182,7 @@ class V5SerialConnection extends VexSerialConnection {
       filename: "screen",
       vendor: 15 /* SYS */,
       loadAddress: 0,
-      size: SCREEN_CAPTURE_MESSAGE_WIDTH * SCREEN_CAPTURE_HEIGHT * SCREEN_CAPTURE_MESSAGE_CHANNELS
+      size: SCREEN_CAPTURE_FRAMEBUFFER_SIZE
     }, 2 /* FILE_TARGET_CBUF */, progressCallback);
     if (framebuffer.isErr())
       return err(framebuffer.error);
@@ -2568,34 +2207,60 @@ class V5SerialConnection extends VexSerialConnection {
     return this.request(new SelectDashH2DPacket(screen, port), SelectDashReplyD2HPacket);
   }
 }
-function binaryArrayJoin(left, right) {
-  const leftSize = left != null ? left.byteLength : 0;
-  const rightSize = right != null ? right.byteLength : 0;
-  const all = new Uint8Array(leftSize + rightSize);
-  if (all.length === 0)
-    return new Uint8Array;
-  if (left != null)
-    all.set(new Uint8Array(left), 0);
-  if (right != null)
-    all.set(new Uint8Array(right), leftSize);
-  return all;
+
+class ReceiveBuffer {
+  storage = new Uint8Array(0);
+  start = 0;
+  end = 0;
+  get byteLength() {
+    return this.end - this.start;
+  }
+  get bytes() {
+    return this.storage.subarray(this.start, this.end);
+  }
+  append(chunk) {
+    this.reserve(chunk.byteLength);
+    this.storage.set(chunk, this.end);
+    this.end += chunk.byteLength;
+  }
+  copy(length) {
+    return this.bytes.slice(0, length);
+  }
+  discard(length) {
+    this.start += length < 0 ? this.byteLength + length : length;
+    if (this.start < 0)
+      this.start = 0;
+    if (this.start > this.end)
+      this.start = this.end;
+    if (this.start === this.end) {
+      this.start = 0;
+      this.end = 0;
+    } else if (this.start >= 4096 && this.start * 2 >= this.storage.length) {
+      this.storage.copyWithin(0, this.start, this.end);
+      this.end -= this.start;
+      this.start = 0;
+    }
+  }
+  reserve(additional) {
+    const required = this.byteLength + additional;
+    if (this.storage.length - this.end >= additional)
+      return;
+    if (this.storage.length >= required) {
+      this.storage.copyWithin(0, this.start, this.end);
+      this.end = this.byteLength;
+      this.start = 0;
+      return;
+    }
+    const storage = new Uint8Array(Math.max(required, Math.max(64, this.storage.length * 2)));
+    storage.set(this.bytes);
+    this.end = this.byteLength;
+    this.start = 0;
+    this.storage = storage;
+  }
 }
 function getTransferChunkSize(windowSize) {
   return windowSize > 0 && windowSize <= USER_PROG_CHUNK_SIZE ? windowSize : USER_PROG_CHUNK_SIZE;
 }
-function convertScreenCapture(framebuffer) {
-  const pixels = new Uint8Array(SCREEN_CAPTURE_WIDTH * SCREEN_CAPTURE_HEIGHT * SCREEN_CAPTURE_CHANNELS);
-  for (let row = 0;row < SCREEN_CAPTURE_HEIGHT; row++) {
-    for (let column = 0;column < SCREEN_CAPTURE_WIDTH; column++) {
-      const source = (row * SCREEN_CAPTURE_MESSAGE_WIDTH + column) * SCREEN_CAPTURE_MESSAGE_CHANNELS;
-      const target = (row * SCREEN_CAPTURE_WIDTH + column) * SCREEN_CAPTURE_CHANNELS;
-      pixels[target] = framebuffer[source + 2] ?? 0;
-      pixels[target + 1] = framebuffer[source + 1] ?? 0;
-      pixels[target + 2] = framebuffer[source] ?? 0;
-    }
-  }
-  return pixels;
-}
 function wrapTransfer(conn, operation) {
   return new ResultAsync(conn.withFileTransfer(async () => {
     try {
@@ -2618,7 +2283,11 @@ function expectedReplyMessage(packet, ReplyType, reply) {
 function ackTypeName(ackType) {
   return `AckType.${AckType[ackType] ?? "UNKNOWN"} (${ackType})`;
 }
+// src/VexDeviceState.ts
+import { err as err4, ok as ok4, ResultAsync as ResultAsync4 } from "neverthrow";
+
 // src/VexFirmware.ts
+import { err as err2, errAsync, ok as ok2, ResultAsync as ResultAsync2 } from "neverthrow";
 var MAX_CATALOG_BYTES = 4 * 1024;
 var MAX_VEXOS_BYTES = 64 * 1024 * 1024;
 var MAX_FIRMWARE_IMAGE_BYTES = 32 * 1024 * 1024;
@@ -2631,7 +2300,7 @@ function downloadFileFromInternet(link, options = {}) {
   if (timeout < 0) {
     return errAsync(new VexInvalidArgumentError("timeout must be non-negative"));
   }
-  return new ResultAsync(runDownload(link, maxBytes, timeout));
+  return new ResultAsync2(runDownload(link, maxBytes, timeout));
 }
 async function runDownload(link, maxBytes, timeout) {
   const controller = new AbortController;
@@ -2641,20 +2310,20 @@ async function runDownload(link, maxBytes, timeout) {
     try {
       response = await fetch(link, { signal: controller.signal });
     } catch (e) {
-      return err(new VexDownloadError(`failed to download ${link} (${e instanceof Error ? e.message : String(e)})`));
+      return err2(new VexDownloadError(`failed to download ${link} (${e instanceof Error ? e.message : String(e)})`));
     }
     if (!response.ok) {
-      return err(new VexDownloadError(`failed to download ${link} (${response.status})`));
+      return err2(new VexDownloadError(`failed to download ${link} (${response.status})`));
     }
     const declaredLength = response.headers.get("content-length");
     if (declaredLength !== null) {
       const declared = Number.parseInt(declaredLength, 10);
       if (!Number.isNaN(declared) && declared > 0 && declared > maxBytes) {
-        return err(new VexDownloadError(`declared content length ${declared} exceeds limit ${maxBytes} for ${link}`));
+        return err2(new VexDownloadError(`declared content length ${declared} exceeds limit ${maxBytes} for ${link}`));
       }
     }
     if (response.body == null) {
-      return err(new VexDownloadError(`no response body for ${link}`));
+      return err2(new VexDownloadError(`no response body for ${link}`));
     }
     const reader = response.body.getReader();
     const chunks = [];
@@ -2671,7 +2340,7 @@ async function runDownload(link, maxBytes, timeout) {
           try {
             await reader.cancel();
           } catch {}
-          return err(new VexDownloadError(`downloaded body exceeds limit ${maxBytes} for ${link}`));
+          return err2(new VexDownloadError(`downloaded body exceeds limit ${maxBytes} for ${link}`));
         }
         chunks.push(value);
       }
@@ -2686,7 +2355,7 @@ async function runDownload(link, maxBytes, timeout) {
       result.set(chunk, offset);
       offset += chunk.byteLength;
     }
-    return ok(result.buffer);
+    return ok2(result.buffer);
   } finally {
     clearTimeout(timer);
   }
@@ -2698,23 +2367,23 @@ function sleepUntilAsync(f, timeout, interval = 20) {
   if (interval <= 0) {
     return errAsync(new VexInvalidArgumentError("interval must be positive"));
   }
-  return new ResultAsync(runSleepUntilAsync(f, timeout, interval));
+  return new ResultAsync2(runSleepUntilAsync(f, timeout, interval));
 }
 async function runSleepUntilAsync(f, timeout, interval) {
   const deadline = Date.now() + timeout;
   while (Date.now() <= deadline) {
     try {
       if (await f())
-        return ok(true);
+        return ok2(true);
     } catch (e) {
-      return err(toVexSerialError(e, "io"));
+      return err2(toVexSerialError(e, "io"));
     }
     const remaining = deadline - Date.now();
     if (remaining <= 0)
       break;
     await sleepInner(Math.min(interval, remaining));
   }
-  return ok(false);
+  return ok2(false);
 }
 function sleepUntil(f, timeout, interval = 20) {
   if (timeout < 0) {
@@ -2723,29 +2392,29 @@ function sleepUntil(f, timeout, interval = 20) {
   if (interval <= 0) {
     return errAsync(new VexInvalidArgumentError("interval must be positive"));
   }
-  return new ResultAsync(runSleepUntil(f, timeout, interval));
+  return new ResultAsync2(runSleepUntil(f, timeout, interval));
 }
 async function runSleepUntil(f, timeout, interval) {
   const deadline = Date.now() + timeout;
   while (Date.now() <= deadline) {
     try {
       if (f())
-        return ok(true);
+        return ok2(true);
     } catch (e) {
-      return err(toVexSerialError(e, "io"));
+      return err2(toVexSerialError(e, "io"));
     }
     const remaining = deadline - Date.now();
     if (remaining <= 0)
       break;
     await sleepInner(Math.min(interval, remaining));
   }
-  return ok(false);
+  return ok2(false);
 }
 function sleep(ms) {
   if (ms < 0) {
     return errAsync(new VexInvalidArgumentError("ms must be non-negative"));
   }
-  return ResultAsync.fromSafePromise(sleepInner(ms));
+  return ResultAsync2.fromSafePromise(sleepInner(ms));
 }
 async function sleepInner(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
@@ -2755,7 +2424,7 @@ async function flashFactoryImage(conn, options, pcb) {
   pcb(`FACTORY ENB ${label}`, 0, 0);
   const enableReply = await conn.request(new FactoryEnableH2DPacket, FactoryEnableReplyD2HPacket);
   if (enableReply.isErr())
-    return err(enableReply.error);
+    return err2(enableReply.error);
   const writeRequest = {
     filename: "null.bin",
     vendor: 1 /* USER */,
@@ -2766,26 +2435,26 @@ async function flashFactoryImage(conn, options, pcb) {
     autoRun: true,
     linkedFile: undefined
   };
-  const upload = await conn.uploadFileToDevice(writeRequest, (c, t) => {
+  const upload = await conn.uploadFileToDeviceUnlocked(writeRequest, (c, t) => {
     pcb(`UPLOAD ${label}`, c, t);
   });
   if (upload.isErr())
-    return err(upload.error);
+    return err2(upload.error);
   if (!upload.value) {
-    return err(new VexFirmwareError(`${label} upload was rejected by device`));
+    return err2(new VexFirmwareError(`${label} upload was rejected by device`));
   }
   const deadline = Date.now() + 120000;
   while (Date.now() < deadline) {
     const statusReply = await conn.request(new FactoryStatusH2DPacket, FactoryStatusReplyD2HPacket, 1e4);
     if (statusReply.isErr())
-      return err(statusReply.error);
+      return err2(statusReply.error);
     reportFactoryStatus(label, statusReply.value, pcb);
     if (statusReply.value.status === 0 && statusReply.value.percent === 100) {
-      return ok(undefined);
+      return ok2(undefined);
     }
     await sleepInner(500);
   }
-  return err(new VexFirmwareError(`${label} factory status timed out`));
+  return err2(new VexFirmwareError(`${label} factory status timed out`));
 }
 function reportFactoryStatus(label, reply, pcb) {
   switch (reply.status) {
@@ -2850,13 +2519,13 @@ async function extractFirmwareImages(usingVersion, vexos) {
   return ordered;
 }
 function uploadFirmware(state, publicUrl = "https://content.vexrobotics.com/vexos/public/V5/", usingVersion, progressCallback) {
-  return new ResultAsync(runUploadFirmware(state, publicUrl, usingVersion, progressCallback));
+  return new ResultAsync2(runUploadFirmware(state, publicUrl, usingVersion, progressCallback));
 }
 async function runUploadFirmware(state, publicUrl, usingVersion, progressCallback) {
   const device = state._instance;
   const conn = device.connection;
   if (conn == null || !conn.isConnected) {
-    return err(new VexNotConnectedError);
+    return err2(new VexNotConnectedError);
   }
   const pcb = progressCallback ?? (() => {});
   let version = usingVersion;
@@ -2866,20 +2535,20 @@ async function runUploadFirmware(state, publicUrl, usingVersion, progressCallbac
       maxBytes: MAX_CATALOG_BYTES
     });
     if (catalog.isErr())
-      return err(catalog.error);
+      return err2(catalog.error);
     version = new TextDecoder().decode(catalog.value).trim();
     pcb("FETCH CATALOG", 1, 1);
   }
   if (!/^[A-Za-z0-9._-]+$/.test(version)) {
-    return err(new VexFirmwareError(`invalid VEXos version: ${version}`));
+    return err2(new VexFirmwareError(`invalid VEXos version: ${version}`));
   }
   pcb("FETCH VEXOS", 0, 1);
   const vexosResult = await downloadFileFromInternet(publicUrl + version + ".vexos", { maxBytes: MAX_VEXOS_BYTES });
   if (vexosResult.isErr())
-    return err(vexosResult.error);
+    return err2(vexosResult.error);
   const vexos = vexosResult.value;
   if (vexos.byteLength === 0) {
-    return err(new VexFirmwareError("VEXos archive is empty"));
+    return err2(new VexFirmwareError("VEXos archive is empty"));
   }
   pcb("FETCH VEXOS", 1, 1);
   pcb("UNZIP VEXOS", 0, 1);
@@ -2888,52 +2557,59 @@ async function runUploadFirmware(state, publicUrl, usingVersion, progressCallbac
     images = await extractFirmwareImages(version, vexos);
   } catch (e) {
     if (e instanceof VexSerialError)
-      return err(e);
-    return err(toVexSerialError(e, "firmware"));
+      return err2(e);
+    return err2(toVexSerialError(e, "firmware"));
   }
   pcb("UNZIP VEXOS", 1, 1);
   return state.withRefreshPaused(async () => {
-    const boot = images.find((image) => image.name.endsWith("BOOT.bin"));
-    if (boot === undefined) {
-      return err(new VexFirmwareError("VEXos archive is missing BOOT.bin"));
-    }
-    const assertImage = images.find((image) => image.name.endsWith("assets.bin"));
-    if (assertImage === undefined) {
-      return err(new VexFirmwareError("VEXos archive is missing assets.bin"));
-    }
-    const bootFlash = await flashFactoryImage(conn, {
-      image: boot,
-      label: "BOOT",
-      downloadTarget: 14 /* FILE_TARGET_B1 */
-    }, pcb);
-    if (bootFlash.isErr())
-      return err(bootFlash.error);
-    const assetsFlash = await flashFactoryImage(conn, {
-      image: assertImage,
-      label: "ASSETS",
-      downloadTarget: 13 /* FILE_TARGET_A1 */
-    }, pcb);
-    if (assetsFlash.isErr())
-      return err(assetsFlash.error);
-    return ok(true);
+    try {
+      return await conn.withFileTransfer(async () => {
+        const boot = images.find((image) => image.name.endsWith("BOOT.bin"));
+        if (boot === undefined) {
+          return err2(new VexFirmwareError("VEXos archive is missing BOOT.bin"));
+        }
+        const assertImage = images.find((image) => image.name.endsWith("assets.bin"));
+        if (assertImage === undefined) {
+          return err2(new VexFirmwareError("VEXos archive is missing assets.bin"));
+        }
+        const bootFlash = await flashFactoryImage(conn, {
+          image: boot,
+          label: "BOOT",
+          downloadTarget: 14 /* FILE_TARGET_B1 */
+        }, pcb);
+        if (bootFlash.isErr())
+          return err2(bootFlash.error);
+        const assetsFlash = await flashFactoryImage(conn, {
+          image: assertImage,
+          label: "ASSETS",
+          downloadTarget: 13 /* FILE_TARGET_A1 */
+        }, pcb);
+        if (assetsFlash.isErr())
+          return err2(assetsFlash.error);
+        return ok2(true);
+      });
+    } catch (e) {
+      return err2(toVexSerialError(e, "firmware"));
+    }
   });
 }
 
 // src/VexTransfers.ts
+import { err as err3, ok as ok3, ResultAsync as ResultAsync3 } from "neverthrow";
 function getValue(state, key) {
-  return new ResultAsync((async () => {
+  return new ResultAsync3((async () => {
     const conn = state._instance.connection;
     if (conn == null || !conn.isConnected) {
-      return err(new VexNotConnectedError);
+      return err3(new VexNotConnectedError);
     }
     return conn.request(new ReadKeyValueH2DPacket(key), ReadKeyValueReplyD2HPacket).map((result) => result.value);
   })());
 }
 function setValue(state, key, value) {
-  return new ResultAsync((async () => {
+  return new ResultAsync3((async () => {
     const conn = state._instance.connection;
     if (conn == null || !conn.isConnected) {
-      return err(new VexNotConnectedError);
+      return err3(new VexNotConnectedError);
     }
     return conn.request(new WriteKeyValueH2DPacket(key, value), WriteKeyValueReplyD2HPacket).map(() => {
       return;
@@ -2941,19 +2617,19 @@ function setValue(state, key, value) {
   })());
 }
 function listFiles(state, vendor = 1 /* USER */) {
-  return new ResultAsync((async () => {
+  return new ResultAsync3((async () => {
     const conn = state._instance.connection;
     if (conn == null || !conn.isConnected) {
-      return err(new VexNotConnectedError);
+      return err3(new VexNotConnectedError);
     }
     const countResult = await conn.request(new GetDirectoryFileCountH2DPacket(vendor), GetDirectoryFileCountReplyD2HPacket);
     if (countResult.isErr())
-      return err(countResult.error);
+      return err3(countResult.error);
     const files = [];
     for (let i = 0;i < countResult.value.count; i++) {
       const entryResult = await conn.request(new GetDirectoryEntryH2DPacket(i), GetDirectoryEntryReplyD2HPacket);
       if (entryResult.isErr())
-        return err(entryResult.error);
+        return err3(entryResult.error);
       if (entryResult.value.file != null) {
         files.push({
           filename: entryResult.value.file.filename,
@@ -2967,18 +2643,18 @@ function listFiles(state, vendor = 1 /* USER */) {
         });
       }
     }
-    return ok(files);
+    return ok3(files);
   })());
 }
 function listProgram(state) {
-  return new ResultAsync((async () => {
+  return new ResultAsync3((async () => {
     const conn = state._instance.connection;
     if (conn == null || !conn.isConnected) {
-      return err(new VexNotConnectedError);
+      return err3(new VexNotConnectedError);
     }
     const files = await listFiles(state, 1 /* USER */);
     if (files.isErr())
-      return err(files.error);
+      return err3(files.error);
     const programList = [];
     const iniFiles = files.value.filter((file) => file.filename.endsWith(".ini"));
     for (let i = 0;i < iniFiles.length; i++) {
@@ -3006,14 +2682,14 @@ function listProgram(state) {
       }
       programList.push(program);
     }
-    return ok(programList);
+    return ok3(programList);
   })());
 }
 function readFile(state, request, downloadTarget = 1 /* FILE_TARGET_QSPI */, progressCallback) {
-  return new ResultAsync((async () => {
+  return new ResultAsync3((async () => {
     const conn = state._instance.connection;
     if (conn == null || !conn.isConnected) {
-      return err(new VexNotConnectedError);
+      return err3(new VexNotConnectedError);
     }
     let handle;
     if (typeof request === "string") {
@@ -3025,31 +2701,31 @@ function readFile(state, request, downloadTarget = 1 /* FILE_TARGET_QSPI */, pro
   })());
 }
 function removeFile(state, request) {
-  return new ResultAsync((async () => {
+  return new ResultAsync3((async () => {
     const conn = state._instance.connection;
     if (conn == null || !conn.isConnected) {
-      return err(new VexNotConnectedError);
+      return err3(new VexNotConnectedError);
     }
     return state.withRefreshPaused(() => conn.removeFile(request));
   })());
 }
 function removeAllFiles(state) {
-  return new ResultAsync((async () => {
+  return new ResultAsync3((async () => {
     const conn = state._instance.connection;
     if (conn == null || !conn.isConnected) {
-      return err(new VexNotConnectedError);
+      return err3(new VexNotConnectedError);
     }
     return state.withRefreshPaused(() => conn.removeAllFiles());
   })());
 }
 function uploadProgram(state, iniConfig, binFileBuf, coldFileBuf, progressCallback) {
-  return new ResultAsync(runUploadProgram(state, iniConfig, binFileBuf, coldFileBuf, progressCallback));
+  return new ResultAsync3(runUploadProgram(state, iniConfig, binFileBuf, coldFileBuf, progressCallback));
 }
 async function runUploadProgram(state, iniConfig, binFileBuf, coldFileBuf, progressCallback) {
   const device = state._instance;
   const conn = device.connection;
   if (conn == null || !conn.isConnected) {
-    return err(new VexNotConnectedError);
+    return err3(new VexNotConnectedError);
   }
   let switchedToDownload = false;
   return state.withRefreshPaused(async () => {
@@ -3058,46 +2734,46 @@ async function runUploadProgram(state, iniConfig, binFileBuf, coldFileBuf, progr
         await sleep(250);
         const refreshed = await device.refresh();
         if (refreshed.isErr() || !refreshed.value) {
-          return err(new VexProtocolError("device is unavailable"));
+          return err3(new VexProtocolError("device is unavailable"));
         }
         progressCallback("CHANNEL", 0, 1);
         const p1 = await device.radio.changeChannel(1 /* DOWNLOAD */);
         if (p1.isErr())
-          return err(p1.error);
+          return err3(p1.error);
         switchedToDownload = true;
         await sleep(250);
         const transferred = await sleepUntilAsync(async () => (await conn?.getSystemStatus(150))?.isOk() ?? false, 1e4, 200);
         if (transferred.isErr())
-          return err(transferred.error);
+          return err3(transferred.error);
         if (!transferred.value) {
-          return err(new VexProtocolError("channel switch timed out"));
+          return err3(new VexProtocolError("channel switch timed out"));
         }
         progressCallback("CHANNEL", 1, 1);
       }
       const p2 = await conn.uploadProgramToDevice(iniConfig, binFileBuf, coldFileBuf, progressCallback);
       if (p2.isErr())
-        return err(p2.error);
+        return err3(p2.error);
       if (!p2.value)
-        return err(new VexProtocolError("program upload rejected"));
+        return err3(new VexProtocolError("program upload rejected"));
       if (device.isV5Controller) {
         if (!device.brain.isAvailable) {
-          return err(new VexProtocolError("brain unavailable after upload"));
+          return err3(new VexProtocolError("brain unavailable after upload"));
         }
         progressCallback("CHANNEL", 0, 1);
         const p3 = await device.radio.changeChannel(0 /* PIT */);
         if (p3.isErr())
-          return err(p3.error);
+          return err3(p3.error);
         switchedToDownload = false;
         await sleep(250);
         const transferred = await sleepUntilAsync(async () => (await conn?.getSystemStatus(150))?.isOk() ?? false, 1e4, 200);
         if (transferred.isErr())
-          return err(transferred.error);
+          return err3(transferred.error);
         if (!transferred.value) {
-          return err(new VexProtocolError("channel switch timed out"));
+          return err3(new VexProtocolError("channel switch timed out"));
         }
         progressCallback("CHANNEL", 1, 1);
       }
-      return ok(true);
+      return ok3(true);
     } finally {
       if (switchedToDownload) {
         await device.radio.changeChannel(0 /* PIT */);
@@ -3106,19 +2782,19 @@ async function runUploadProgram(state, iniConfig, binFileBuf, coldFileBuf, progr
   });
 }
 function writeFile(state, request, progressCallback) {
-  return new ResultAsync((async () => {
+  return new ResultAsync3((async () => {
     const conn = state._instance.connection;
     if (conn == null || !conn.isConnected) {
-      return err(new VexNotConnectedError);
+      return err3(new VexNotConnectedError);
     }
     return state.withRefreshPaused(() => conn.uploadFileToDevice(request, progressCallback));
   })());
 }
 function captureScreen(state, progressCallback) {
-  return new ResultAsync((async () => {
+  return new ResultAsync3((async () => {
     const conn = state._instance.connection;
     if (conn == null || !conn.isConnected) {
-      return err(new VexNotConnectedError);
+      return err3(new VexNotConnectedError);
     }
     return state.withRefreshPaused(() => conn.captureScreen(progressCallback));
   })());
@@ -3232,42 +2908,42 @@ class V5Brain {
     this.setActiveProgram(value).mapErr(() => {});
   }
   setActiveProgram(value) {
-    return new ResultAsync((async () => {
+    return new ResultAsync4((async () => {
       if (this.state.brain.activeProgram === value)
-        return ok(undefined);
+        return ok4(undefined);
       const conn = this.state._instance.connection;
       if (conn == null)
-        return err(new VexNotConnectedError);
+        return err4(new VexNotConnectedError);
       const result = value === 0 ? await conn.stopProgram() : await conn.loadProgram(value);
       if (result.isErr())
-        return err(result.error);
+        return err4(result.error);
       this.state.brain.activeProgram = value;
-      return ok(undefined);
+      return ok4(undefined);
     })());
   }
   runProgram(slot) {
-    return new ResultAsync((async () => {
+    return new ResultAsync4((async () => {
       const conn = this.state._instance.connection;
       if (conn == null)
-        return err(new VexNotConnectedError);
+        return err4(new VexNotConnectedError);
       const reply = await conn.runProgram(slot);
       if (reply.isErr())
-        return err(reply.error);
+        return err4(reply.error);
       if (typeof slot === "number")
         this.state.brain.activeProgram = slot;
-      return ok(undefined);
+      return ok4(undefined);
     })());
   }
   stopProgram() {
-    return new ResultAsync((async () => {
+    return new ResultAsync4((async () => {
       const conn = this.state._instance.connection;
       if (conn == null)
-        return err(new VexNotConnectedError);
+        return err4(new VexNotConnectedError);
       const reply = await conn.stopProgram();
       if (reply.isErr())
-        return err(reply.error);
+        return err4(reply.error);
       this.state.brain.activeProgram = 0;
-      return ok(undefined);
+      return ok4(undefined);
     })());
   }
   get battery() {
@@ -3440,10 +3116,10 @@ class V5Radio {
     return this.state.radio.latency;
   }
   changeChannel(channel) {
-    return new ResultAsync((async () => {
+    return new ResultAsync4((async () => {
       const conn = this.state._instance.connection;
       if (conn == null || !conn.isConnected) {
-        return err(new VexNotConnectedError);
+        return err4(new VexNotConnectedError);
       }
       return conn.request(new FileControlH2DPacket(1, channel), FileControlReplyD2HPacket).map(() => {
         return;
@@ -3453,6 +3129,7 @@ class V5Radio {
 }
 
 // src/VexDevice.ts
+import { err as err5, ok as ok5, ResultAsync as ResultAsync5 } from "neverthrow";
 function unrefTimerIfPossible(timer) {
   if (typeof timer !== "object" || timer === null || !("unref" in timer))
     return;
@@ -3460,6 +3137,11 @@ function unrefTimerIfPossible(timer) {
   if (typeof unref === "function")
     unref.call(timer);
 }
+function describePort(port) {
+  const info = port.getInfo();
+  const identifier = info.path ?? info.id ?? info.serialNumber;
+  return typeof identifier === "string" ? identifier : undefined;
+}
 
 class V5SerialDevice extends VexSerialDevice {
   autoReconnect = true;
@@ -3469,8 +3151,11 @@ class V5SerialDevice extends VexSerialDevice {
   _refreshInterval;
   state = new V5SerialDeviceState(this);
   _disposed = false;
+  _lifecycleGeneration = 0;
+  _disconnectListener;
   _refreshGeneration = 0;
   _autoRefresh = false;
+  _refreshIntervalMs = 200;
   _isLastRefreshComplete = true;
   _brain = new V5Brain(this.state);
   _controllers = [
@@ -3479,8 +3164,15 @@ class V5SerialDevice extends VexSerialDevice {
   ];
   _radio = new V5Radio(this.state);
   _deviceFacades = [];
-  constructor(defaultSerial, autoRefresh = false) {
+  _emitSafely(eventName, data) {
+    try {
+      this.emit(eventName, data);
+    } catch {}
+  }
+  constructor(defaultSerial, options = false) {
     super(defaultSerial);
+    const autoRefresh = typeof options === "boolean" ? options : options.autoRefresh ?? false;
+    this.refreshIntervalMs = typeof options === "boolean" ? 200 : options.refreshIntervalMs ?? 200;
     this.autoRefresh = autoRefresh;
   }
   get autoRefresh() {
@@ -3496,6 +3188,21 @@ class V5SerialDevice extends VexSerialDevice {
       this._stopRefreshInterval();
     }
   }
+  get refreshIntervalMs() {
+    return this._refreshIntervalMs;
+  }
+  set refreshIntervalMs(value) {
+    if (!Number.isFinite(value) || value <= 0) {
+      throw new VexInvalidArgumentError("refreshIntervalMs must be a positive finite number");
+    }
+    if (this._refreshIntervalMs === value)
+      return;
+    this._refreshIntervalMs = value;
+    if (this._refreshInterval !== undefined) {
+      this._stopRefreshInterval();
+      this._startRefreshInterval();
+    }
+  }
   _startRefreshInterval() {
     if (this._refreshInterval !== undefined || this._disposed)
       return;
@@ -3513,16 +3220,16 @@ class V5SerialDevice extends VexSerialDevice {
             try {
               const r = await this.refresh();
               if (r.isErr())
-                this.emit("error", r.error);
+                this._emitSafely("error", r.error);
             } catch (error) {
-              this.emit("error", error);
+              this._emitSafely("error", error);
             } finally {
               this._isLastRefreshComplete = true;
             }
           })();
         }
       }
-    }, 200);
+    }, this._refreshIntervalMs);
     unrefTimerIfPossible(this._refreshInterval);
   }
   _stopRefreshInterval() {
@@ -3561,82 +3268,149 @@ class V5SerialDevice extends VexSerialDevice {
     this.setMatchMode(value).mapErr(() => {});
   }
   setMatchMode(mode) {
-    return new ResultAsync((async () => {
+    return new ResultAsync5((async () => {
       const reply = await this.connection?.setMatchMode(mode);
       if (reply === undefined)
-        return err(new VexNotConnectedError);
+        return err5(new VexNotConnectedError);
       if (reply.isErr())
-        return err(reply.error);
+        return err5(reply.error);
       this.state.matchMode = mode;
-      return ok(undefined);
+      return ok5(undefined);
     })());
   }
   get radio() {
     return this._radio;
   }
   mockTouch(x, y, press) {
-    return new ResultAsync((async () => {
+    return new ResultAsync5((async () => {
       const reply = await this.connection?.mockTouch(x, y, press);
       if (reply === undefined)
-        return err(new VexNotConnectedError);
+        return err5(new VexNotConnectedError);
       if (reply.isErr())
-        return err(reply.error);
-      return ok(undefined);
+        return err5(reply.error);
+      return ok5(undefined);
     })());
   }
   connect(conn) {
-    return new ResultAsync(this._connect(conn));
+    if (this._disposed) {
+      return new ResultAsync5(Promise.resolve(this._staleLifecycleResult()));
+    }
+    if (this.isConnected)
+      return new ResultAsync5(Promise.resolve(ok5(undefined)));
+    const generation = ++this._lifecycleGeneration;
+    return new ResultAsync5(this._connect(conn, generation));
   }
-  async _connect(conn) {
+  async _connect(conn, generation = this._lifecycleGeneration) {
+    if (!this._isLifecycleCurrent(generation)) {
+      return this._staleLifecycleResult();
+    }
     if (this.isConnected)
-      return ok(undefined);
+      return ok5(undefined);
     if (conn != null) {
       if (!conn.isConnected) {
         const opened = await conn.open();
+        if (!this._isLifecycleCurrent(generation)) {
+          await conn.close();
+          return this._staleLifecycleResult();
+        }
         if (opened.isErr() || opened.value !== "opened") {
-          return err(new VexIoError("failed to open the supplied connection"));
+          return err5(new VexIoError("failed to open the supplied connection"));
         }
       }
       const q = await conn.query1();
+      if (!this._isLifecycleCurrent(generation)) {
+        await conn.close();
+        return this._staleLifecycleResult();
+      }
       if (q.isErr()) {
         await conn.close();
-        return err(q.error);
+        return err5(q.error);
+      }
+      if (!this._commitConnection(conn, generation)) {
+        await conn.close();
+        return this._staleLifecycleResult();
       }
-      this.connection = conn;
     } else {
       let tryIdx = 0;
+      let canRequestPort = true;
+      const attemptedPorts = new Set;
+      const attemptedPortNames = [];
       while (true) {
-        const c = new V5SerialConnection(this.defaultSerial);
-        const result = await c.open(tryIdx++, true);
+        if (!this._isLifecycleCurrent(generation)) {
+          return this._staleLifecycleResult();
+        }
+        const c = this.createConnection();
+        let result = await c.open(tryIdx++, false);
+        if (!this._isLifecycleCurrent(generation)) {
+          await c.close();
+          return this._staleLifecycleResult();
+        }
+        if (result.isOk() && result.value === "no-port" && canRequestPort) {
+          canRequestPort = false;
+          result = await c.open(tryIdx, true);
+          if (!this._isLifecycleCurrent(generation)) {
+            await c.close();
+            return this._staleLifecycleResult();
+          }
+        }
         if (result.isErr()) {
           await c.close();
-          return err(result.error);
+          return err5(result.error);
         }
         if (result.value === "no-port") {
-          return err(new VexNotConnectedError("no V5 device was found"));
+          const attempted = attemptedPortNames.length ? `; attempted ${attemptedPortNames.join(", ")}` : "";
+          return err5(new VexNotConnectedError(`no responsive V5 device was found${attempted}`));
         }
         if (result.value === "busy") {
           await c.close();
-          continue;
+          return err5(new VexNotConnectedError("the selected V5 serial port is busy"));
+        }
+        const port = c.port;
+        if (port !== undefined && attemptedPorts.has(port)) {
+          await c.close();
+          const portName = describePort(port);
+          return err5(new VexNotConnectedError(portName === undefined ? "the selected serial port did not respond as a V5 device" : `serial port ${portName} did not respond as a V5 device`));
+        }
+        if (port !== undefined) {
+          attemptedPorts.add(port);
+          const portName = describePort(port);
+          if (portName !== undefined)
+            attemptedPortNames.push(portName);
         }
         const q = await c.query1();
+        if (!this._isLifecycleCurrent(generation)) {
+          await c.close();
+          return this._staleLifecycleResult();
+        }
         if (q.isErr()) {
           await c.close();
           continue;
         }
-        this.connection = c;
+        if (!this._commitConnection(c, generation)) {
+          await c.close();
+          return this._staleLifecycleResult();
+        }
         break;
       }
     }
-    if (!this.isConnected)
-      return err(new VexNotConnectedError);
-    await this.doAfterConnect();
-    return ok(undefined);
+    const connection = this.connection;
+    if (!this._isLifecycleCurrent(generation) || connection == null) {
+      return this._staleLifecycleResult();
+    }
+    if (!connection.isConnected)
+      return err5(new VexNotConnectedError);
+    const initialized = await this.doAfterConnect(connection, generation);
+    if (initialized.isErr())
+      return initialized;
+    return ok5(undefined);
   }
   async disconnect() {
+    this._lifecycleGeneration++;
+    this._refreshGeneration++;
     this._isDisconnecting = true;
     const connection = this.connection;
     this.connection = undefined;
+    this._detachDisconnectListener();
     try {
       await connection?.close();
     } finally {
@@ -3650,13 +3424,25 @@ class V5SerialDevice extends VexSerialDevice {
     await this.disconnect();
   }
   reconnect(timeout = 0) {
-    return new ResultAsync(this._reconnect(timeout));
+    if (this._disposed) {
+      return new ResultAsync5(Promise.resolve(this._staleLifecycleResult()));
+    }
+    if (timeout < 0) {
+      return new ResultAsync5(Promise.resolve(err5(new VexInvalidArgumentError("timeout must be non-negative"))));
+    }
+    if (this.isConnected)
+      return new ResultAsync5(Promise.resolve(ok5(undefined)));
+    const generation = this._isReconnecting ? this._lifecycleGeneration : ++this._lifecycleGeneration;
+    return new ResultAsync5(this._reconnect(timeout, generation));
   }
-  async _reconnect(timeout) {
+  async _reconnect(timeout, generation = this._lifecycleGeneration) {
+    if (!this._isLifecycleCurrent(generation)) {
+      return this._staleLifecycleResult();
+    }
     if (this.isConnected)
-      return ok(undefined);
+      return ok5(undefined);
     if (timeout < 0) {
-      return err(new VexInvalidArgumentError("timeout must be non-negative"));
+      return err5(new VexInvalidArgumentError("timeout must be non-negative"));
     }
     const endTime = Date.now() + timeout;
     if (this._isReconnecting) {
@@ -3665,22 +3451,32 @@ class V5SerialDevice extends VexSerialDevice {
       } else {
         const waited = await sleepUntil(() => !this._isReconnecting, timeout);
         if (waited.isErr() || !waited.value) {
-          return err(new VexNotConnectedError);
+          return err5(new VexNotConnectedError);
         }
       }
+      if (!this._isLifecycleCurrent(generation)) {
+        return this._staleLifecycleResult();
+      }
       if (this.isConnected)
-        return ok(undefined);
+        return ok5(undefined);
     }
     this._isReconnecting = true;
     try {
       while (timeout === 0 || Date.now() < endTime) {
         let tryIdx = 0;
         while (true) {
-          const c = new V5SerialConnection(this.defaultSerial);
+          if (!this._isLifecycleCurrent(generation)) {
+            return this._staleLifecycleResult();
+          }
+          const c = this.createConnection();
           const result = await c.open(tryIdx++, false);
+          if (!this._isLifecycleCurrent(generation)) {
+            await c.close();
+            return this._staleLifecycleResult();
+          }
           if (result.isErr()) {
             await c.close();
-            return err(result.error);
+            return err5(result.error);
           }
           if (result.value === "no-port")
             break;
@@ -3689,6 +3485,10 @@ class V5SerialDevice extends VexSerialDevice {
             continue;
           }
           const status = await c.getSystemStatus(200);
+          if (!this._isLifecycleCurrent(generation)) {
+            await c.close();
+            return this._staleLifecycleResult();
+          }
           if (status.isErr()) {
             await c.close();
             continue;
@@ -3697,24 +3497,39 @@ class V5SerialDevice extends VexSerialDevice {
             await c.close();
             continue;
           }
-          this.connection = c;
+          if (!this._commitConnection(c, generation)) {
+            await c.close();
+            return this._staleLifecycleResult();
+          }
           break;
         }
         if (this.isConnected)
           break;
         const getPortCount = async () => (await this.defaultSerial.getPorts()).length;
         const portsCount = await getPortCount();
+        if (!this._isLifecycleCurrent(generation)) {
+          return this._staleLifecycleResult();
+        }
         await sleepUntilAsync(async () => await getPortCount() !== portsCount, 1000);
+        if (!this._isLifecycleCurrent(generation)) {
+          return this._staleLifecycleResult();
+        }
       }
     } catch (e) {
-      return err(toVexSerialError(e));
+      return err5(toVexSerialError(e));
     } finally {
       this._isReconnecting = false;
     }
-    if (!this.isConnected)
-      return err(new VexNotConnectedError);
-    await this.doAfterConnect();
-    return ok(undefined);
+    const connection = this.connection;
+    if (!this._isLifecycleCurrent(generation) || connection == null) {
+      return this._staleLifecycleResult();
+    }
+    if (!connection.isConnected)
+      return err5(new VexNotConnectedError);
+    const initialized = await this.doAfterConnect(connection, generation);
+    if (initialized.isErr())
+      return initialized;
+    return ok5(undefined);
   }
   async waitForReconnectToFinish() {
     while (this._isReconnecting) {
@@ -3723,61 +3538,96 @@ class V5SerialDevice extends VexSerialDevice {
         return;
     }
   }
-  async doAfterConnect() {
-    if (this.connection == null)
-      return;
-    this.connection.on("disconnected", (_data) => {
-      if (this._isDisconnecting)
+  createConnection() {
+    return new V5SerialConnection(this.defaultSerial);
+  }
+  _isLifecycleCurrent(generation) {
+    return generation === this._lifecycleGeneration && !this._disposed;
+  }
+  _staleLifecycleResult() {
+    return err5(new VexNotConnectedError("connection attempt was superseded"));
+  }
+  _commitConnection(connection, generation) {
+    if (!this._isLifecycleCurrent(generation))
+      return false;
+    this._detachDisconnectListener();
+    this.connection = connection;
+    return true;
+  }
+  _detachDisconnectListener() {
+    const subscription = this._disconnectListener;
+    this._disconnectListener = undefined;
+    subscription?.connection.remove("disconnected", subscription.listener);
+  }
+  async doAfterConnect(connection, generation) {
+    if (!this._isLifecycleCurrent(generation) || this.connection !== connection) {
+      return this._staleLifecycleResult();
+    }
+    const listener = () => {
+      if (this._isDisconnecting || !this._isLifecycleCurrent(generation) || this.connection !== connection) {
         return;
-      this.emit("disconnected", undefined);
-      if (this.autoReconnect) {
-        this.reconnect().mapErr((e) => this.emit("error", e));
       }
-    });
-    await this.refresh();
+      this._lifecycleGeneration++;
+      this._refreshGeneration++;
+      this.connection = undefined;
+      this._detachDisconnectListener();
+      this._emitSafely("disconnected", undefined);
+      if (this.autoReconnect && !this._disposed) {
+        this.reconnect().mapErr((error) => this._emitSafely("error", error));
+      }
+    };
+    connection.on("disconnected", listener);
+    this._disconnectListener = { connection, listener };
+    const refreshed = await this.refresh();
+    if (!this._isLifecycleCurrent(generation) || this.connection !== connection || !connection.isConnected) {
+      return this._staleLifecycleResult();
+    }
+    if (refreshed.isErr()) {
+      await this._discardConnection(connection, generation);
+      return err5(refreshed.error);
+    }
+    if (!refreshed.value) {
+      await this._discardConnection(connection, generation);
+      return err5(new VexNotConnectedError("initial device refresh did not produce a current snapshot"));
+    }
+    return ok5(undefined);
+  }
+  async _discardConnection(connection, generation) {
+    if (!this._isLifecycleCurrent(generation) || this.connection !== connection) {
+      return;
+    }
+    this._lifecycleGeneration++;
+    this._refreshGeneration++;
+    this.connection = undefined;
+    this._detachDisconnectListener();
+    await connection.close();
   }
   refresh() {
-    return new ResultAsync(this._refresh());
+    return new ResultAsync5(this._refresh());
   }
   async _refresh() {
     if (this._disposed)
-      return ok(false);
+      return ok5(false);
     const generation = ++this._refreshGeneration;
     const conn = this.connection;
     if (conn == null || !conn.isConnected) {
       this._applySnapshotIfCurrent(generation, { isAvailable: false });
-      return ok(false);
-    }
-    const ssPacket = await conn.getSystemStatus();
-    if (generation !== this._refreshGeneration || this._disposed)
-      return ok(false);
-    if (ssPacket.isErr()) {
-      this._applySnapshotIfCurrent(generation, { isAvailable: false });
-      return ok(false);
-    }
-    const sfPacket = await conn.getSystemFlags();
-    if (generation !== this._refreshGeneration || this._disposed)
-      return ok(false);
-    if (sfPacket.isErr()) {
-      this._applySnapshotIfCurrent(generation, { isAvailable: false });
-      return ok(false);
-    }
-    const rdPacket = await conn.getRadioStatus();
-    if (generation !== this._refreshGeneration || this._disposed)
-      return ok(false);
-    if (rdPacket.isErr()) {
-      this._applySnapshotIfCurrent(generation, { isAvailable: false });
-      return ok(false);
-    }
-    const dsPacket = await conn.getDeviceStatus();
+      return ok5(false);
+    }
+    const [ssPacket, sfPacket, rdPacket, dsPacket] = await Promise.all([
+      conn.getSystemStatus(),
+      conn.getSystemFlags(),
+      conn.getRadioStatus(),
+      conn.getDeviceStatus()
+    ]);
     if (generation !== this._refreshGeneration || this._disposed)
-      return ok(false);
-    if (dsPacket.isErr()) {
+      return ok5(false);
+    if (ssPacket.isErr() || sfPacket.isErr() || rdPacket.isErr() || dsPacket.isErr()) {
       this._applySnapshotIfCurrent(generation, { isAvailable: false });
-      return ok(false);
+      return ok5(false);
     }
     const snapshot = this._buildSnapshot(ssPacket.value, sfPacket.value, rdPacket.value, dsPacket.value);
-    return ok(this._applySnapshotIfCurrent(generation, snapshot));
+    return ok5(this._applySnapshotIfCurrent(generation, snapshot));
   }
   _buildSnapshot(ssPacket, sfPacket, rdPacket, dsPacket) {
     const flags2 = ssPacket.sysflags[2];
@@ -3829,7 +3679,7 @@ class V5SerialDevice extends VexSerialDevice {
         {
           battery: controller1Battery,
           isAvailable: controller1Available,
-          isCharging: (flags2 & 128) !== 0
+          isCharging: undefined
         }
       ],
       radio: {
@@ -3856,7 +3706,26 @@ class V5SerialDevice extends VexSerialDevice {
     }
     this.state.matchMode = snapshot.matchMode;
     this.state.isFieldControllerConnected = snapshot.isFieldControllerConnected;
-    Object.assign(this.state.brain, snapshot.brain);
+    const brain = this.state.brain;
+    brain.activeProgram = snapshot.brain.activeProgram;
+    brain.battery.batteryPercent = snapshot.brain.battery.batteryPercent;
+    brain.battery.isCharging = snapshot.brain.battery.isCharging;
+    brain.button.isPressed = snapshot.brain.button.isPressed;
+    brain.button.isDoublePressed = snapshot.brain.button.isDoublePressed;
+    if (brain.cpu0Version.compare(snapshot.brain.cpu0Version) !== 0) {
+      brain.cpu0Version = snapshot.brain.cpu0Version;
+    }
+    if (brain.cpu1Version.compare(snapshot.brain.cpu1Version) !== 0) {
+      brain.cpu1Version = snapshot.brain.cpu1Version;
+    }
+    brain.isAvailable = snapshot.brain.isAvailable;
+    brain.settings.isScreenReversed = snapshot.brain.settings.isScreenReversed;
+    brain.settings.isWhiteTheme = snapshot.brain.settings.isWhiteTheme;
+    brain.settings.usingLanguage = snapshot.brain.settings.usingLanguage;
+    if (brain.systemVersion.compare(snapshot.brain.systemVersion) !== 0) {
+      brain.systemVersion = snapshot.brain.systemVersion;
+    }
+    brain.uniqueId = snapshot.brain.uniqueId;
     Object.assign(this.state.controllers[0], snapshot.controllers[0]);
     Object.assign(this.state.controllers[1], snapshot.controllers[1]);
     Object.assign(this.state.radio, snapshot.radio);
@@ -3865,10 +3734,18 @@ class V5SerialDevice extends VexSerialDevice {
       if (device != null)
         next[device.port] = device;
     }
-    this.state.devices = next;
+    if (!sameSmartDeviceSlots(this.state.devices, next)) {
+      this.state.devices = next;
+    }
     return true;
   }
 }
+function sameSmartDeviceSlots(left, right) {
+  return left.length === right.length && left.every((device, index) => {
+    const next = right[index];
+    return device === next || device !== undefined && next !== undefined && device.port === next.port && device.type === next.type && device.status === next.status && device.betaversion === next.betaversion && device.version === next.version && device.bootversion === next.bootversion;
+  });
+}
 // src/VexIniConfig.ts
 class BaseIniBuilder {
   str = "";
@@ -3877,7 +3754,7 @@ class BaseIniBuilder {
 `;
   }
   addComment(comment) {
-    this.addLine("; " + comment);
+    this.addLine(comment.length === 0 ? ";" : "; " + comment);
     return this;
   }
   getContent() {
@@ -3895,18 +3772,23 @@ class IniSectionBuilder extends BaseIniBuilder {
     this.object = object;
     this.keyTransform = keyTransform;
   }
-  addSingleObjProperty(key, maxValueLength) {
-    const value = this.object[key];
-    if (value == null || value.toString().length === 0)
+  addSingleObjProperty(key, maxValueLength, omitIfEmpty = false) {
+    const rawValue = this.object[key];
+    if (rawValue == null)
       return;
+    const value = rawValue.toString();
+    if (omitIfEmpty && value.length === 0)
+      return;
+    if (/["\u0000-\u001f\u007f]/.test(value)) {
+      throw new Error(`INI value for ${this.name}.${String(key)} contains an unsupported character`);
+    }
     const formattedKey = this.keyTransform(key).padEnd(12).slice(0, 12);
-    const trimmedVal = value.toString().slice(0, maxValueLength);
-    const escapedVal = trimmedVal.replace(/["\\\u0000-\u001f\u007f]/g, (character) => `\\x${character.charCodeAt(0).toString(16).padStart(2, "0")}`);
-    this.addLine(`${formattedKey} = "${escapedVal}"`);
+    const trimmedValue = value.slice(0, maxValueLength);
+    this.addLine(`${formattedKey} = "${trimmedValue}"`);
   }
-  addObjProperty(key, maxValueLength) {
+  addObjProperty(key, maxValueLength, omitIfEmpty = false) {
     for (const k of Array.isArray(key) ? key : [key]) {
-      this.addSingleObjProperty(k, maxValueLength);
+      this.addSingleObjProperty(k, maxValueLength, omitIfEmpty);
     }
     return this;
   }
@@ -3924,6 +3806,11 @@ class IniFileBuilder extends BaseIniBuilder {
     this.str += section.getContent();
     return this;
   }
+  addOptionalSection(section) {
+    if (section.getContent().length === 0)
+      return this;
+    return this.addComment("").addSection(section);
+  }
 }
 
 class ProgramIniConfig {
@@ -3954,7 +3841,7 @@ class ProgramIniConfig {
     if (this.program.date.length === 0) {
       this.setProgramDate(new Date);
     }
-    return new IniFileBuilder().addComment("").addComment("VEX program ini file").addComment("Generated by Vex V5 Serial Protocol Library").addComment("").addSection(new IniSectionBuilder("project", this.project).addObjProperty("ide", 16)).addComment("").addSection(new IniSectionBuilder("program", this.program).addObjProperty("name", 32).addObjProperty("description", 256).addObjProperty("icon", 16).addObjProperty("iconalt", 16).addObjProperty("slot", 16)).addComment("").addSection(new IniSectionBuilder("config", this.config, (k) => "port_" + this.dec2(k)).addAllObjProps()).addComment("").addSection(new IniSectionBuilder("controller_1", this.controller1).addAllObjProps()).addComment("").addSection(new IniSectionBuilder("controller_2", this.controller2).addAllObjProps()).getContent();
+    return new IniFileBuilder().addComment("").addComment("VEX program ini file").addComment("Generated by Vex V5 Serial Protocol Library").addComment("").addSection(new IniSectionBuilder("project", this.project).addObjProperty("version").addObjProperty("ide", 16).addObjProperty("file")).addComment("").addSection(new IniSectionBuilder("program", this.program).addObjProperty("version").addObjProperty("name", 32).addObjProperty("slot").addObjProperty("icon", 16).addObjProperty("iconalt", 16, true).addObjProperty("description", 256).addObjProperty("date").addObjProperty("timezone")).addComment("").addSection(new IniSectionBuilder("config", this.config, (k) => "port_" + this.dec2(k)).addAllObjProps()).addOptionalSection(new IniSectionBuilder("controller_1", this.controller1).addAllObjProps()).addOptionalSection(new IniSectionBuilder("controller_2", this.controller2).addAllObjProps()).getContent();
   }
   dec2(value) {
     return (value % 100).toString(10).padStart(2, "0").toUpperCase();
@@ -4089,5 +3976,5 @@ export {
   AckType
 };
 
-//# debugId=658BAE3B57868EE064756E2164756E21
+//# debugId=048E789F43ADDE3C64756E2164756E21
 //# sourceMappingURL=index.js.map