@hotlap.ai/telemetry 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { IBT, parseIbt, parseIbtBuffer } from './ibt';
+export type { IbtOptions } from './ibt';
+export { IRSDK, createIRSDK } from './live';
+export type { IRSDKOptions } from './live';
+export type { SessionInfoMessage, TelemetryMessage, TelemetryFrame, LapChangeMessage, StatusMessage, ServerMessage, } from './telemetry-server';
+export { VERSION, SIM_STATUS_URL, DATA_VALID_EVENT_NAME, MEMMAPFILE, MEMMAPFILESIZE, BROADCASTMSGNAME, VAR_TYPE_SIZES, HEADER_SIZE, VAR_HEADER_SIZE, VAR_BUFFER_SIZE, DISK_SUB_HEADER_OFFSET, DISK_SUB_HEADER_SIZE, YAML_CODE_PAGE, StatusField, EngineWarnings, Flags, TrkLoc, TrkSurf, SessionState, CameraState, BroadcastMsg, ChatCommandMode, PitCommandMode, TelemCommandMode, RpyStateMode, ReloadTexturesMode, RpySrchMode, RpyPosMode, CsMode, PitSvFlags, PitSvStatus, PaceMode, PaceFlags, CarLeftRight, FFBCommandMode, VideoCaptureMode, TrackWetness, } from './constants';
+export type { VarType } from './constants';
+export type { VarHeader, VarBuffer, Header, DiskSubHeader, SessionInfo, WeekendInfo, DriverInfo, Driver, SessionInfoData, Session, ResultPosition, FastestLap, TelemetryValue, TelemetryData, } from './types';
+export { readInt32LE, readUint32LE, readFloat32LE, readFloat64LE, readBigUint64LE, readBoolLE, readCharLE, readString, readVarValue, readVarValueBatch, parseHeader, parseVarHeader, parseDiskSubHeader, parseVarHeaders, getLatestVarBuffer, } from './binary-reader';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACtD,YAAY,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAExC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC5C,YAAY,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAE3C,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,OAAO,EACP,cAAc,EACd,qBAAqB,EACrB,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,cAAc,EACd,KAAK,EACL,MAAM,EACN,OAAO,EACP,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,MAAM,EACN,UAAU,EACV,WAAW,EACX,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,YAAY,EACV,SAAS,EACT,SAAS,EACT,MAAM,EACN,aAAa,EACb,WAAW,EACX,WAAW,EACX,UAAU,EACV,MAAM,EACN,eAAe,EACf,OAAO,EACP,cAAc,EACd,UAAU,EACV,cAAc,EACd,aAAa,GACd,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,aAAa,EACb,aAAa,EACb,eAAe,EACf,UAAU,EACV,UAAU,EACV,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,126 @@
+// @bun
+import {
+  IBT,
+  parseIbt,
+  parseIbtBuffer
+} from "./ibt.js";
+import {
+  IRSDK,
+  createIRSDK
+} from "./live.js";
+import"./index-k5bgtn4c.js";
+import {
+  getLatestVarBuffer,
+  parseDiskSubHeader,
+  parseHeader,
+  parseVarHeader,
+  parseVarHeaders,
+  readBigUint64LE,
+  readBoolLE,
+  readCharLE,
+  readFloat32LE,
+  readFloat64LE,
+  readInt32LE,
+  readString,
+  readUint32LE,
+  readVarValue,
+  readVarValueBatch
+} from "./binary-reader.js";
+import {
+  BROADCASTMSGNAME,
+  BroadcastMsg,
+  CameraState,
+  CarLeftRight,
+  ChatCommandMode,
+  CsMode,
+  DATA_VALID_EVENT_NAME,
+  DISK_SUB_HEADER_OFFSET,
+  DISK_SUB_HEADER_SIZE,
+  EngineWarnings,
+  FFBCommandMode,
+  Flags,
+  HEADER_SIZE,
+  MEMMAPFILE,
+  MEMMAPFILESIZE,
+  PaceFlags,
+  PaceMode,
+  PitCommandMode,
+  PitSvFlags,
+  PitSvStatus,
+  ReloadTexturesMode,
+  RpyPosMode,
+  RpySrchMode,
+  RpyStateMode,
+  SIM_STATUS_URL,
+  SessionState,
+  StatusField,
+  TelemCommandMode,
+  TrackWetness,
+  TrkLoc,
+  TrkSurf,
+  VAR_BUFFER_SIZE,
+  VAR_HEADER_SIZE,
+  VAR_TYPE_SIZES,
+  VERSION,
+  VideoCaptureMode,
+  YAML_CODE_PAGE
+} from "./constants.js";
+export {
+  readVarValueBatch,
+  readVarValue,
+  readUint32LE,
+  readString,
+  readInt32LE,
+  readFloat64LE,
+  readFloat32LE,
+  readCharLE,
+  readBoolLE,
+  readBigUint64LE,
+  parseVarHeaders,
+  parseVarHeader,
+  parseIbtBuffer,
+  parseIbt,
+  parseHeader,
+  parseDiskSubHeader,
+  getLatestVarBuffer,
+  createIRSDK,
+  YAML_CODE_PAGE,
+  VideoCaptureMode,
+  VERSION,
+  VAR_TYPE_SIZES,
+  VAR_HEADER_SIZE,
+  VAR_BUFFER_SIZE,
+  TrkSurf,
+  TrkLoc,
+  TrackWetness,
+  TelemCommandMode,
+  StatusField,
+  SessionState,
+  SIM_STATUS_URL,
+  RpyStateMode,
+  RpySrchMode,
+  RpyPosMode,
+  ReloadTexturesMode,
+  PitSvStatus,
+  PitSvFlags,
+  PitCommandMode,
+  PaceMode,
+  PaceFlags,
+  MEMMAPFILESIZE,
+  MEMMAPFILE,
+  IRSDK,
+  IBT,
+  HEADER_SIZE,
+  Flags,
+  FFBCommandMode,
+  EngineWarnings,
+  DISK_SUB_HEADER_SIZE,
+  DISK_SUB_HEADER_OFFSET,
+  DATA_VALID_EVENT_NAME,
+  CsMode,
+  ChatCommandMode,
+  CarLeftRight,
+  CameraState,
+  BroadcastMsg,
+  BROADCASTMSGNAME
+};

package/dist/live.d.ts

@@ -0,0 +1,59 @@
+import type { TelemetryValue } from './types';
+export interface IRSDKOptions {
+    parseYamlAsync?: boolean;
+}
+export declare class IRSDK {
+    private parseYamlAsync;
+    private sharedMemPtr;
+    private sharedMemBuffer;
+    private sharedMemView;
+    private fileMappingHandle;
+    private dataValidEvent;
+    private header;
+    private varHeaders;
+    private varHeadersNames;
+    private sessionInfoCache;
+    private broadcastMsgId;
+    private lastSessionInfoUpdate;
+    private workaroundConnectedState;
+    private frozenBuffer;
+    private frozenView;
+    private frozenBufOffset;
+    private testMode;
+    isInitialized: boolean;
+    constructor(options?: IRSDKOptions);
+    get isConnected(): boolean;
+    get sessionInfoUpdate(): number;
+    get varHeaderNames(): string[] | null;
+    startup(testFile?: string, dumpTo?: string): Promise<boolean>;
+    private startupFromFile;
+    shutdown(): void;
+    get(key: string): TelemetryValue | null;
+    freezeVarBufferLatest(): void;
+    unfreezeVarBufferLatest(): void;
+    private checkSimStatus;
+    private waitValidDataEvent;
+    getSessionInfo<T = unknown>(key: string): T | null;
+    private cleanYaml;
+    private getBroadcastMsgId;
+    private broadcastMsg;
+    private padCarNum;
+    camSwitchPos(position?: number, group?: number, camera?: number): boolean;
+    camSwitchNum(carNumber?: string | number, group?: number, camera?: number): boolean;
+    camSetState(cameraState?: 4): boolean;
+    replaySetPlaySpeed(speed?: number, slowMotion?: boolean): boolean;
+    replaySetPlayPosition(posMode?: 0, frameNum?: number): boolean;
+    replaySearch(searchMode?: 0): boolean;
+    replaySetState(stateMode?: 0): boolean;
+    reloadAllTextures(): boolean;
+    reloadTexture(carIdx?: number): boolean;
+    chatCommand(chatCommandMode?: 1): boolean;
+    chatCommandMacro(macroNum?: number): boolean;
+    pitCommand(pitCommandMode?: 0, variable?: number): boolean;
+    telemCommand(telemCommandMode?: 0): boolean;
+    ffbCommand(ffbCommandMode?: 0, value?: number): boolean;
+    replaySearchSessionTime(sessionNum?: number, sessionTimeMs?: number): boolean;
+    videoCapture(videoCaptureMode?: 0): boolean;
+}
+export declare function createIRSDK(options?: IRSDKOptions): IRSDK;
+//# sourceMappingURL=live.d.ts.map

package/dist/live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../src/live.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAqB,cAAc,EAAE,MAAM,SAAS,CAAC;AAuGjE,MAAM,WAAW,YAAY;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,qBAAa,KAAK;IAChB,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,eAAe,CAA2B;IAClD,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,iBAAiB,CAAiB;IAC1C,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,UAAU,CAAuC;IACzD,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,gBAAgB,CAA6D;IACrF,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,qBAAqB,CAAK;IAClC,OAAO,CAAC,wBAAwB,CAAK;IACrC,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,aAAa,UAAS;gBAEV,OAAO,GAAE,YAAiB;IAItC,IAAI,WAAW,IAAI,OAAO,CAoBzB;IAED,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,IAAI,cAAc,IAAI,MAAM,EAAE,GAAG,IAAI,CAMpC;IAEK,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAkErD,eAAe;IAqB7B,QAAQ,IAAI,IAAI;IAiChB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAiBvC,qBAAqB,IAAI,IAAI;IAa7B,uBAAuB,IAAI,IAAI;YAMjB,cAAc;IAU5B,OAAO,CAAC,kBAAkB;IAQ1B,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAoClD,OAAO,CAAC,SAAS;IAkBjB,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,SAAS;IAcjB,YAAY,CAAC,QAAQ,SAAI,EAAE,KAAK,SAAI,EAAE,MAAM,SAAI,GAAG,OAAO;IAI1D,YAAY,CAAC,SAAS,GAAE,MAAM,GAAG,MAAY,EAAE,KAAK,SAAI,EAAE,MAAM,SAAI,GAAG,OAAO;IAI9E,WAAW,CAAC,WAAW,IAA8B,GAAG,OAAO;IAI/D,kBAAkB,CAAC,KAAK,SAAI,EAAE,UAAU,UAAQ,GAAG,OAAO;IAI1D,qBAAqB,CAAC,OAAO,IAAmB,EAAE,QAAQ,SAAI,GAAG,OAAO;IAIxE,YAAY,CAAC,UAAU,IAAuB,GAAG,OAAO;IAIxD,cAAc,CAAC,SAAS,IAA0B,GAAG,OAAO;IAI5D,iBAAiB,IAAI,OAAO;IAI5B,aAAa,CAAC,MAAM,SAAI,GAAG,OAAO;IAIlC,WAAW,CAAC,eAAe,IAA6B,GAAG,OAAO;IAIlE,gBAAgB,CAAC,QAAQ,SAAI,GAAG,OAAO;IAIvC,UAAU,CAAC,cAAc,IAAuB,EAAE,QAAQ,SAAI,GAAG,OAAO;IAIxE,YAAY,CAAC,gBAAgB,IAAwB,GAAG,OAAO;IAI/D,UAAU,CAAC,cAAc,IAAuC,EAAE,KAAK,SAAI,GAAG,OAAO;IAIrF,uBAAuB,CAAC,UAAU,SAAI,EAAE,aAAa,SAAI,GAAG,OAAO;IAInE,YAAY,CAAC,gBAAgB,IAAuC,GAAG,OAAO;CAG/E;AAED,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,KAAK,CAEzD"}

package/dist/live.js

@@ -0,0 +1,420 @@
+// @bun
+import {
+  $parse
+} from "./index-k5bgtn4c.js";
+import {
+  getLatestVarBuffer,
+  parseHeader,
+  parseVarHeaders,
+  readString,
+  readVarValue
+} from "./binary-reader.js";
+import {
+  BroadcastMsg,
+  CameraState,
+  ChatCommandMode,
+  FFBCommandMode,
+  PitCommandMode,
+  ReloadTexturesMode,
+  RpyPosMode,
+  RpySrchMode,
+  RpyStateMode,
+  SIM_STATUS_URL,
+  StatusField,
+  TelemCommandMode,
+  VideoCaptureMode,
+  __require
+} from "./constants.js";
+
+// src/live.ts
+var kernel32 = null;
+var user32 = null;
+function loadKernel32() {
+  const { dlopen, FFIType, suffix } = __require("bun:ffi");
+  return dlopen(`kernel32.${suffix}`, {
+    OpenEventW: {
+      args: [FFIType.u32, FFIType.bool, FFIType.ptr],
+      returns: FFIType.ptr
+    },
+    OpenFileMappingW: {
+      args: [FFIType.u32, FFIType.bool, FFIType.ptr],
+      returns: FFIType.ptr
+    },
+    MapViewOfFile: {
+      args: [FFIType.ptr, FFIType.u32, FFIType.u32, FFIType.u32, FFIType.u32],
+      returns: FFIType.ptr
+    },
+    UnmapViewOfFile: {
+      args: [FFIType.ptr],
+      returns: FFIType.bool
+    },
+    CloseHandle: {
+      args: [FFIType.ptr],
+      returns: FFIType.bool
+    },
+    WaitForSingleObject: {
+      args: [FFIType.ptr, FFIType.u32],
+      returns: FFIType.u32
+    }
+  });
+}
+function loadUser32() {
+  const { dlopen, FFIType, suffix } = __require("bun:ffi");
+  return dlopen(`user32.${suffix}`, {
+    RegisterWindowMessageW: {
+      args: [FFIType.ptr],
+      returns: FFIType.u32
+    },
+    SendNotifyMessageW: {
+      args: [FFIType.ptr, FFIType.u32, FFIType.u32, FFIType.u32],
+      returns: FFIType.bool
+    }
+  });
+}
+var FILE_MAP_READ = 4;
+var SYNCHRONIZE = 1048576;
+var WAIT_OBJECT_0 = 0;
+var HWND_BROADCAST = 65535;
+var DATA_VALID_EVENT_NAME = "Local\\IRSDKDataValidEvent";
+var MEMMAPFILE = "Local\\IRSDKMemMapFileName";
+var MEMMAPFILESIZE = 1164 * 1024;
+var BROADCASTMSGNAME = "IRSDK_BROADCASTMSG";
+function toWideString(str) {
+  const buf = new Uint8Array((str.length + 1) * 2);
+  for (let i = 0;i < str.length; i++) {
+    const code = str.charCodeAt(i);
+    buf[i * 2] = code & 255;
+    buf[i * 2 + 1] = code >> 8 & 255;
+  }
+  return buf;
+}
+function ensureFFILoaded() {
+  if (process.platform !== "win32") {
+    return false;
+  }
+  try {
+    if (!kernel32)
+      kernel32 = loadKernel32();
+    if (!user32)
+      user32 = loadUser32();
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+class IRSDK {
+  parseYamlAsync;
+  sharedMemPtr = null;
+  sharedMemBuffer = null;
+  sharedMemView = null;
+  fileMappingHandle = null;
+  dataValidEvent = null;
+  header = null;
+  varHeaders = null;
+  varHeadersNames = null;
+  sessionInfoCache = new Map;
+  broadcastMsgId = null;
+  lastSessionInfoUpdate = 0;
+  workaroundConnectedState = 0;
+  frozenBuffer = null;
+  frozenView = null;
+  frozenBufOffset = 0;
+  testMode = false;
+  isInitialized = false;
+  constructor(options = {}) {
+    this.parseYamlAsync = options.parseYamlAsync ?? false;
+  }
+  get isConnected() {
+    if (!this.header)
+      return false;
+    if (this.header.status === StatusField.STATUS_CONNECTED) {
+      this.workaroundConnectedState = 0;
+    }
+    if (this.workaroundConnectedState === 0 && this.header.status !== StatusField.STATUS_CONNECTED) {
+      this.workaroundConnectedState = 1;
+    }
+    if (this.workaroundConnectedState === 1 && this.get("SessionNum") === null) {
+      this.workaroundConnectedState = 2;
+    }
+    if (this.workaroundConnectedState === 2 && this.get("SessionNum") !== null) {
+      this.workaroundConnectedState = 3;
+    }
+    return (this.dataValidEvent !== null || this.testMode) && (this.header.status === StatusField.STATUS_CONNECTED || this.workaroundConnectedState === 3);
+  }
+  get sessionInfoUpdate() {
+    return this.header?.sessionInfoUpdate ?? 0;
+  }
+  get varHeaderNames() {
+    if (!this.varHeaders)
+      return null;
+    if (!this.varHeadersNames) {
+      this.varHeadersNames = Array.from(this.varHeaders.keys());
+    }
+    return this.varHeadersNames;
+  }
+  async startup(testFile, dumpTo) {
+    if (testFile) {
+      return this.startupFromFile(testFile, dumpTo);
+    }
+    if (!ensureFFILoaded() || !kernel32) {
+      console.error("FFI not available - live telemetry requires Windows");
+      return false;
+    }
+    const simRunning = await this.checkSimStatus();
+    if (!simRunning)
+      return false;
+    const { ptr, toArrayBuffer } = __require("bun:ffi");
+    const eventNameWide = toWideString(DATA_VALID_EVENT_NAME);
+    this.dataValidEvent = kernel32.symbols.OpenEventW(SYNCHRONIZE, false, ptr(eventNameWide));
+    if (!this.waitValidDataEvent()) {
+      this.dataValidEvent = null;
+      return false;
+    }
+    const fileNameWide = toWideString(MEMMAPFILE);
+    this.fileMappingHandle = kernel32.symbols.OpenFileMappingW(FILE_MAP_READ, false, ptr(fileNameWide));
+    if (!this.fileMappingHandle)
+      return false;
+    this.sharedMemPtr = kernel32.symbols.MapViewOfFile(this.fileMappingHandle, FILE_MAP_READ, 0, 0, MEMMAPFILESIZE);
+    if (!this.sharedMemPtr) {
+      kernel32.symbols.CloseHandle(this.fileMappingHandle);
+      this.fileMappingHandle = null;
+      return false;
+    }
+    const arrayBuffer = toArrayBuffer(this.sharedMemPtr, 0, MEMMAPFILESIZE);
+    this.sharedMemBuffer = new Uint8Array(arrayBuffer);
+    this.sharedMemView = new DataView(arrayBuffer);
+    if (this.sharedMemView) {
+      if (dumpTo) {
+        await Bun.write(dumpTo, this.sharedMemBuffer);
+      }
+      this.header = parseHeader(this.sharedMemView);
+      this.isInitialized = this.header.version >= 1 && this.header.varBuf.length > 0;
+      if (this.isInitialized) {
+        this.varHeaders = parseVarHeaders(this.sharedMemView, this.sharedMemBuffer, this.header);
+      }
+    }
+    return this.isInitialized;
+  }
+  async startupFromFile(testFile, dumpTo) {
+    this.testMode = true;
+    const file = Bun.file(testFile);
+    const arrayBuffer = await file.arrayBuffer();
+    this.sharedMemBuffer = new Uint8Array(arrayBuffer);
+    this.sharedMemView = new DataView(arrayBuffer);
+    if (dumpTo) {
+      await Bun.write(dumpTo, this.sharedMemBuffer);
+    }
+    this.header = parseHeader(this.sharedMemView);
+    this.isInitialized = this.header.version >= 1 && this.header.varBuf.length > 0;
+    if (this.isInitialized) {
+      this.varHeaders = parseVarHeaders(this.sharedMemView, this.sharedMemBuffer, this.header);
+    }
+    return this.isInitialized;
+  }
+  shutdown() {
+    this.isInitialized = false;
+    this.lastSessionInfoUpdate = 0;
+    if (kernel32) {
+      if (this.sharedMemPtr) {
+        kernel32.symbols.UnmapViewOfFile(this.sharedMemPtr);
+        this.sharedMemPtr = null;
+      }
+      if (this.fileMappingHandle) {
+        kernel32.symbols.CloseHandle(this.fileMappingHandle);
+        this.fileMappingHandle = null;
+      }
+      if (this.dataValidEvent) {
+        kernel32.symbols.CloseHandle(this.dataValidEvent);
+        this.dataValidEvent = null;
+      }
+    }
+    this.sharedMemBuffer = null;
+    this.sharedMemView = null;
+    this.header = null;
+    this.varHeaders = null;
+    this.varHeadersNames = null;
+    this.sessionInfoCache.clear();
+    this.broadcastMsgId = null;
+    this.frozenBuffer = null;
+    this.frozenView = null;
+    this.testMode = false;
+  }
+  get(key) {
+    if (!this.header || !this.varHeaders)
+      return null;
+    const varHeader = this.varHeaders.get(key);
+    if (!varHeader) {
+      return this.getSessionInfo(key);
+    }
+    const view = this.frozenView ?? this.sharedMemView;
+    if (!view)
+      return null;
+    const varBuf = this.frozenView ? { bufOffset: this.frozenBufOffset } : getLatestVarBuffer(this.header.varBuf);
+    const offset = varBuf.bufOffset + varHeader.offset;
+    return readVarValue(view, offset, varHeader.type, varHeader.count);
+  }
+  freezeVarBufferLatest() {
+    this.unfreezeVarBufferLatest();
+    if (!this.header || !this.sharedMemBuffer)
+      return;
+    this.waitValidDataEvent();
+    const varBuf = this.header.varBuf.reduce((a, b) => a.tickCount > b.tickCount ? a : b);
+    this.frozenBufOffset = 0;
+    this.frozenBuffer = this.sharedMemBuffer.slice(varBuf.bufOffset, varBuf.bufOffset + this.header.bufLen);
+    this.frozenView = new DataView(this.frozenBuffer.buffer);
+  }
+  unfreezeVarBufferLatest() {
+    this.frozenBuffer = null;
+    this.frozenView = null;
+    this.frozenBufOffset = 0;
+  }
+  async checkSimStatus() {
+    try {
+      const response = await fetch(SIM_STATUS_URL);
+      const text = await response.text();
+      return text.includes("running:1");
+    } catch {
+      return false;
+    }
+  }
+  waitValidDataEvent() {
+    if (!kernel32)
+      return true;
+    if (this.dataValidEvent) {
+      return kernel32.symbols.WaitForSingleObject(this.dataValidEvent, 32) === WAIT_OBJECT_0;
+    }
+    return true;
+  }
+  getSessionInfo(key) {
+    if (!this.header || !this.sharedMemBuffer)
+      return null;
+    if (this.lastSessionInfoUpdate < this.header.sessionInfoUpdate) {
+      this.lastSessionInfoUpdate = this.header.sessionInfoUpdate;
+      for (const [k, v] of this.sessionInfoCache) {
+        if (v.data) {
+          this.sessionInfoCache.set(k, { ...v, data: null });
+        }
+      }
+    }
+    const cached = this.sessionInfoCache.get(key);
+    if (cached?.data) {
+      return cached.data;
+    }
+    const start = this.header.sessionInfoOffset;
+    const len = this.header.sessionInfoLen;
+    const raw = readString(this.sharedMemBuffer, start, len);
+    const sectionMatch = raw.match(new RegExp(`
+${key}:
+([\\s\\S]*?)(?=
+
+|$)`));
+    if (!sectionMatch)
+      return null;
+    try {
+      const sectionYaml = `${key}:
+${sectionMatch[1]}`;
+      const cleaned = this.cleanYaml(sectionYaml);
+      const parsed = $parse(cleaned);
+      const result = parsed?.[key] ?? null;
+      this.sessionInfoCache.set(key, { data: result, update: this.lastSessionInfoUpdate });
+      return result;
+    } catch {
+      return null;
+    }
+  }
+  cleanYaml(yaml) {
+    let cleaned = yaml.replace(/[\x81\x8D\x8F\x90\x9D]/g, " ").replace(/[^\x09\x0A\x0D\x20-\x7E\xA0-\xFF]/g, "");
+    cleaned = cleaned.replace(/((?:DriverSetupName|UserName|TeamName|AbbrevName|Initials): )(.*)/g, (_, prefix, value) => {
+      const escaped = value.replace(/["\\]/g, "\\$&");
+      return `${prefix}"${escaped}"`;
+    });
+    cleaned = cleaned.replace(/(\w+: )(,.*)/g, '$1"$2"');
+    return cleaned;
+  }
+  getBroadcastMsgId() {
+    if (!user32)
+      return 0;
+    if (this.broadcastMsgId === null) {
+      const { ptr } = __require("bun:ffi");
+      const msgNameWide = toWideString(BROADCASTMSGNAME);
+      this.broadcastMsgId = user32.symbols.RegisterWindowMessageW(ptr(msgNameWide));
+    }
+    return this.broadcastMsgId;
+  }
+  broadcastMsg(broadcastType, var1 = 0, var2 = 0, var3 = 0) {
+    if (!user32)
+      return false;
+    return user32.symbols.SendNotifyMessageW(HWND_BROADCAST, this.getBroadcastMsgId(), (broadcastType | var1 << 16) >>> 0, (var2 | var3 << 16) >>> 0);
+  }
+  padCarNum(num) {
+    const numStr = String(num);
+    const numLen = numStr.length;
+    let zero = numLen - numStr.replace(/^0+/, "").length;
+    if (zero > 0 && numLen === zero)
+      zero--;
+    const numVal = parseInt(numStr, 10);
+    if (zero) {
+      const numPlace = numVal > 99 ? 3 : numVal > 9 ? 2 : 1;
+      return numVal + 1000 * (numPlace + zero);
+    }
+    return numVal;
+  }
+  camSwitchPos(position = 0, group = 1, camera = 0) {
+    return this.broadcastMsg(BroadcastMsg.CAM_SWITCH_POS, position, group, camera);
+  }
+  camSwitchNum(carNumber = "1", group = 1, camera = 0) {
+    return this.broadcastMsg(BroadcastMsg.CAM_SWITCH_NUM, this.padCarNum(carNumber), group, camera);
+  }
+  camSetState(cameraState = CameraState.CAM_TOOL_ACTIVE) {
+    return this.broadcastMsg(BroadcastMsg.CAM_SET_STATE, cameraState);
+  }
+  replaySetPlaySpeed(speed = 0, slowMotion = false) {
+    return this.broadcastMsg(BroadcastMsg.REPLAY_SET_PLAY_SPEED, speed, slowMotion ? 1 : 0);
+  }
+  replaySetPlayPosition(posMode = RpyPosMode.BEGIN, frameNum = 0) {
+    return this.broadcastMsg(BroadcastMsg.REPLAY_SET_PLAY_POSITION, posMode, frameNum);
+  }
+  replaySearch(searchMode = RpySrchMode.TO_START) {
+    return this.broadcastMsg(BroadcastMsg.REPLAY_SEARCH, searchMode);
+  }
+  replaySetState(stateMode = RpyStateMode.ERASE_TAPE) {
+    return this.broadcastMsg(BroadcastMsg.REPLAY_SET_STATE, stateMode);
+  }
+  reloadAllTextures() {
+    return this.broadcastMsg(BroadcastMsg.RELOAD_TEXTURES, ReloadTexturesMode.ALL);
+  }
+  reloadTexture(carIdx = 0) {
+    return this.broadcastMsg(BroadcastMsg.RELOAD_TEXTURES, ReloadTexturesMode.CAR_IDX, carIdx);
+  }
+  chatCommand(chatCommandMode = ChatCommandMode.BEGIN_CHAT) {
+    return this.broadcastMsg(BroadcastMsg.CHAT_COMMAND, chatCommandMode);
+  }
+  chatCommandMacro(macroNum = 0) {
+    return this.broadcastMsg(BroadcastMsg.CHAT_COMMAND, ChatCommandMode.MACRO, macroNum);
+  }
+  pitCommand(pitCommandMode = PitCommandMode.CLEAR, variable = 0) {
+    return this.broadcastMsg(BroadcastMsg.PIT_COMMAND, pitCommandMode, variable);
+  }
+  telemCommand(telemCommandMode = TelemCommandMode.STOP) {
+    return this.broadcastMsg(BroadcastMsg.TELEM_COMMAND, telemCommandMode);
+  }
+  ffbCommand(ffbCommandMode = FFBCommandMode.FFB_COMMAND_MAX_FORCE, value = 0) {
+    return this.broadcastMsg(BroadcastMsg.FFB_COMMAND, ffbCommandMode, Math.floor(value * 65536));
+  }
+  replaySearchSessionTime(sessionNum = 0, sessionTimeMs = 0) {
+    return this.broadcastMsg(BroadcastMsg.REPLAY_SEARCH_SESSION_TIME, sessionNum, sessionTimeMs);
+  }
+  videoCapture(videoCaptureMode = VideoCaptureMode.TRIGGER_SCREEN_SHOT) {
+    return this.broadcastMsg(BroadcastMsg.VIDEO_CAPTURE, videoCaptureMode);
+  }
+}
+function createIRSDK(options) {
+  return new IRSDK(options);
+}
+export {
+  createIRSDK,
+  IRSDK
+};
+
+export { IRSDK, createIRSDK };

package/dist/telemetry-server.d.ts

@@ -0,0 +1,80 @@
+#!/usr/bin/env bun
+export interface SessionInfoMessage {
+    type: 'session_info';
+    data: {
+        trackId: number;
+        trackName: string;
+        trackDisplayName: string;
+        trackLength: string;
+        trackConfig: string;
+        carId: number;
+        carName: string;
+        carNumber: string;
+        driverName: string;
+        driverId: number;
+        sessionType: string;
+        sessionNum: number;
+        tickRate: number;
+    };
+}
+export interface TelemetryMessage {
+    type: 'telemetry';
+    data: TelemetryFrame;
+}
+export interface TelemetryFrame {
+    tick: number;
+    sessionTime: number;
+    lap: number;
+    lapDistPct: number;
+    speed: number;
+    rpm: number;
+    gear: number;
+    throttle: number;
+    brake: number;
+    clutch: number;
+    steer: number;
+    lat: number;
+    lon: number;
+    alt: number;
+    yaw: number;
+    pitch: number;
+    roll: number;
+    lapCurrentLapTime: number;
+    lapLastLapTime: number;
+    lapBestLapTime: number;
+    lapDeltaToBestLap: number;
+    fuelLevel: number;
+    fuelLevelPct: number;
+    oilTemp: number;
+    waterTemp: number;
+    isOnTrack: boolean;
+    playerPosition: number;
+    playerClassPosition: number;
+    brakeABSactive: boolean;
+    dcBrakeBias: number;
+    dcTractionControl: number;
+    dcABS: number;
+    tireTempLF: number;
+    tireTempRF: number;
+    tireTempLR: number;
+    tireTempRR: number;
+}
+export interface LapChangeMessage {
+    type: 'lap_change';
+    data: {
+        fromLap: number;
+        toLap: number;
+        lapTime: number;
+        sessionNum: number;
+    };
+}
+export interface StatusMessage {
+    type: 'status';
+    data: {
+        connected: boolean;
+        initialized: boolean;
+        error?: string;
+    };
+}
+export type ServerMessage = SessionInfoMessage | TelemetryMessage | LapChangeMessage | StatusMessage;
+//# sourceMappingURL=telemetry-server.d.ts.map