@hotlap.ai/telemetry 1.3.0 → 1.4.0

package/CONTRIBUTING.md

@@ -1,6 +1,6 @@
-# Contributing to @hotlap/telemetry
+# Contributing to @hotlap.ai/telemetry
 
-Thank you for your interest in contributing to the HotLap.ai telemetry SDK!
+Thank you for your interest in contributing to the HotLap.ai telemetry library!
 
 ## Getting Started
 
@@ -52,7 +52,7 @@ bun run typecheck
 src/
   binary-reader.ts  # Low-level binary parsing utilities
   cli.ts            # Command-line interface
-  constants.ts      # iRacing SDK constants and enums
+  constants.ts      # iRacing telemetry constants and enums
   ibt.ts            # IBT file parser
   index.ts          # Main exports
   live.ts           # Live telemetry via Windows FFI

package/README.md

@@ -7,7 +7,9 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue.svg)](https://www.typescriptlang.org/)
 [![Bun](https://img.shields.io/badge/Bun-%3E%3D1.0.0-black.svg)](https://bun.sh/)
 
-High-performance iRacing telemetry SDK for [Bun](https://bun.sh). Parse IBT telemetry files and stream live data from iRacing via Windows shared memory.
+High-performance iRacing telemetry library for [Bun](https://bun.sh), built by the [HotLap.ai](https://hotlap.ai) team. Parse IBT telemetry files and stream live data from iRacing via Windows shared memory.
+
+> **Note:** This is an unofficial community library, not affiliated with or endorsed by iRacing.com.
 
 ## Features
 
@@ -193,7 +195,7 @@ ir.pitCommand(pitCommandMode, variable);
 | `OilTemp` | float | Oil temperature (C) |
 | `WaterTemp` | float | Water temperature (C) |
 
-See iRacing SDK documentation for the complete list of variables.
+See [iRacing documentation](https://www.iracing.com/) for the complete list of variables.
 
 ## Scripts
 

package/dist/cli.js

@@ -5,7 +5,7 @@ import {
 } from "./index-6wrtvcny.js";
 import {
   createIRSDK
-} from "./index-t4qz2011.js";
+} from "./index-ndbp3f5t.js";
 import"./index-hxw291vy.js";
 import"./index-c5jf6rjt.js";
 import {
@@ -36,7 +36,7 @@ var { values, positionals } = parseArgs({
 });
 function printHelp() {
   console.log(`
-Bun iRacing SDK v${VERSION}
+HotLap.ai Telemetry CLI v${VERSION}
 
 Usage: irsdk [options] [file.ibt]
 
@@ -67,7 +67,7 @@ Examples:
 }
 async function main() {
   if (values.version) {
-    console.log(`Bun iRacing SDK v${VERSION}`);
+    console.log(`HotLap.ai Telemetry CLI v${VERSION}`);
     return;
   }
   if (values.help) {

package/dist/{index-t4qz2011.js → index-ndbp3f5t.js}

@@ -104,6 +104,25 @@ function ensureFFILoaded() {
     return false;
   }
 }
+var YAML_SPECIAL_FIELDS_REGEX = /((?:DriverSetupName|UserName|TeamName|AbbrevName|Initials): )(.*)/g;
+var YAML_COMMA_VALUE_REGEX = /(\w+: )(,.*)/g;
+function cleanYamlFast(yaml) {
+  let cleaned = "";
+  for (let i = 0;i < yaml.length; i++) {
+    const code = yaml.charCodeAt(i);
+    if (code === 129 || code === 141 || code === 143 || code === 144 || code === 157) {
+      cleaned += " ";
+    } else if (code === 9 || code === 10 || code === 13 || code >= 32 && code <= 126 || code >= 160 && code <= 255) {
+      cleaned += yaml[i];
+    }
+  }
+  cleaned = cleaned.replace(YAML_SPECIAL_FIELDS_REGEX, (_, prefix, value) => {
+    const escaped = value.replace(/["\\]/g, "\\$&");
+    return `${prefix}"${escaped}"`;
+  });
+  cleaned = cleaned.replace(YAML_COMMA_VALUE_REGEX, '$1"$2"');
+  return cleaned;
+}
 
 class IRSDK {
   parseYamlAsync;
@@ -116,24 +135,74 @@ class IRSDK {
   varHeaders = null;
   varHeadersNames = null;
   sessionInfoCache = new Map;
+  static sessionRegexCache = new Map;
   broadcastMsgId = null;
   lastSessionInfoUpdate = 0;
   workaroundConnectedState = 0;
   frozenBuffer = null;
   frozenView = null;
   frozenBufOffset = 0;
+  frozenBufferCapacity = 0;
   testMode = false;
   isInitialized = false;
   constructor(options = {}) {
     this.parseYamlAsync = options.parseYamlAsync ?? false;
   }
+  liveHeaderInt(byteOffset, fallback = 0) {
+    if (this.testMode)
+      return fallback;
+    return this.sharedMemView ? this.sharedMemView.getInt32(byteOffset, true) : fallback;
+  }
+  get liveStatus() {
+    return this.liveHeaderInt(4, this.header?.status ?? 0);
+  }
+  liveReadBufOffset() {
+    const varBufs = this.header.varBuf;
+    if (this.testMode || !this.sharedMemView) {
+      return getLatestVarBuffer(varBufs).bufOffset;
+    }
+    let latestTick = -1;
+    let latestOffset = varBufs[0].bufOffset;
+    let secondTick = -1;
+    let secondOffset = varBufs[0].bufOffset;
+    for (let i = 0;i < varBufs.length; i++) {
+      const tick = this.liveHeaderInt(48 + i * 16);
+      const offset = varBufs[i].bufOffset;
+      if (tick > latestTick) {
+        secondTick = latestTick;
+        secondOffset = latestOffset;
+        latestTick = tick;
+        latestOffset = offset;
+      } else if (tick > secondTick) {
+        secondTick = tick;
+        secondOffset = offset;
+      }
+    }
+    return varBufs.length > 1 && secondTick >= 0 ? secondOffset : latestOffset;
+  }
+  liveLatestBufOffset() {
+    const varBufs = this.header.varBuf;
+    if (this.testMode || !this.sharedMemView) {
+      return varBufs.reduce((a, b) => a.tickCount > b.tickCount ? a : b).bufOffset;
+    }
+    let latestTick = -1;
+    let latestOffset = varBufs[0].bufOffset;
+    for (let i = 0;i < varBufs.length; i++) {
+      const tick = this.liveHeaderInt(48 + i * 16);
+      if (tick > latestTick) {
+        latestTick = tick;
+        latestOffset = varBufs[i].bufOffset;
+      }
+    }
+    return latestOffset;
+  }
   get isConnected() {
     if (!this.header)
       return false;
-    if (this.header.status === StatusField.STATUS_CONNECTED) {
+    if (this.liveStatus === StatusField.STATUS_CONNECTED) {
       this.workaroundConnectedState = 0;
     }
-    if (this.workaroundConnectedState === 0 && this.header.status !== StatusField.STATUS_CONNECTED) {
+    if (this.workaroundConnectedState === 0 && this.liveStatus !== StatusField.STATUS_CONNECTED) {
       this.workaroundConnectedState = 1;
     }
     if (this.workaroundConnectedState === 1 && this.get("SessionNum") === null) {
@@ -142,10 +211,10 @@ class IRSDK {
     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);
+    return (this.dataValidEvent !== null || this.testMode) && (this.liveStatus === StatusField.STATUS_CONNECTED || this.workaroundConnectedState === 3);
   }
   get sessionInfoUpdate() {
-    return this.header?.sessionInfoUpdate ?? 0;
+    return this.liveHeaderInt(12, this.header?.sessionInfoUpdate ?? 0);
   }
   get varHeaderNames() {
     if (!this.varHeaders)
@@ -249,27 +318,119 @@ class IRSDK {
     if (!varHeader) {
       return this.getSessionInfo(key);
     }
-    const view = this.frozenView ?? this.sharedMemView;
+    const isFrozen = this.isFrozen;
+    const view = isFrozen ? 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);
+    const bufOffset = isFrozen ? this.frozenBufOffset : this.liveReadBufOffset();
+    return readVarValue(view, bufOffset + varHeader.offset, varHeader.type, varHeader.count);
+  }
+  getMultiple(keys) {
+    const results = new Map;
+    if (!this.header || !this.varHeaders)
+      return results;
+    const isFrozen = this.isFrozen;
+    const view = isFrozen ? this.frozenView : this.sharedMemView;
+    if (!view)
+      return results;
+    const bufOffset = isFrozen ? this.frozenBufOffset : this.liveReadBufOffset();
+    for (let i = 0;i < keys.length; i++) {
+      const key = keys[i];
+      const varHeader = this.varHeaders.get(key);
+      if (varHeader) {
+        results.set(key, readVarValue(view, bufOffset + varHeader.offset, varHeader.type, varHeader.count));
+      }
+    }
+    return results;
+  }
+  getMultipleInto(keys, out) {
+    if (!this.header || !this.varHeaders) {
+      for (let i = 0;i < keys.length; i++) {
+        out[keys[i]] = null;
+      }
+      return out;
+    }
+    const isFrozen = this.isFrozen;
+    const view = isFrozen ? this.frozenView : this.sharedMemView;
+    if (!view)
+      return out;
+    const bufOffset = isFrozen ? this.frozenBufOffset : this.liveReadBufOffset();
+    for (let i = 0;i < keys.length; i++) {
+      const key = keys[i];
+      const varHeader = this.varHeaders.get(key);
+      if (varHeader) {
+        out[key] = readVarValue(view, bufOffset + varHeader.offset, varHeader.type, varHeader.count);
+      } else {
+        out[key] = null;
+      }
+    }
+    return out;
+  }
+  createReader(keys) {
+    if (!this.header || !this.varHeaders) {
+      return {
+        read: () => keys.map(() => null),
+        keys
+      };
+    }
+    const varInfos = new Array(keys.length);
+    for (let i = 0;i < keys.length; i++) {
+      const varHeader = this.varHeaders.get(keys[i]);
+      if (varHeader) {
+        varInfos[i] = { offset: varHeader.offset, type: varHeader.type, count: varHeader.count };
+      } else {
+        varInfos[i] = null;
+      }
+    }
+    const self = this;
+    const results = new Array(keys.length);
+    return {
+      keys,
+      read() {
+        if (!self.header) {
+          for (let i = 0;i < keys.length; i++)
+            results[i] = null;
+          return results;
+        }
+        const isFrozen = self.isFrozen;
+        const view = isFrozen ? self.frozenView : self.sharedMemView;
+        if (!view) {
+          for (let i = 0;i < keys.length; i++)
+            results[i] = null;
+          return results;
+        }
+        const bufOffset = isFrozen ? self.frozenBufOffset : self.liveReadBufOffset();
+        for (let i = 0;i < varInfos.length; i++) {
+          const info = varInfos[i];
+          if (info) {
+            results[i] = readVarValue(view, bufOffset + info.offset, info.type, info.count);
+          } else {
+            results[i] = null;
+          }
+        }
+        return results;
+      }
+    };
   }
   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);
+    const latestBufOffset = this.liveLatestBufOffset();
+    const bufLen = this.header.bufLen;
+    if (!this.frozenBuffer || this.frozenBufferCapacity < bufLen) {
+      this.frozenBuffer = new Uint8Array(bufLen);
+      this.frozenBufferCapacity = bufLen;
+      this.frozenView = new DataView(this.frozenBuffer.buffer);
+    }
+    this.frozenBuffer.set(new Uint8Array(this.sharedMemBuffer.buffer, latestBufOffset, bufLen));
     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;
+    this.frozenBufOffset = -1;
+  }
+  get isFrozen() {
+    return this.frozenBufOffset >= 0 && this.frozenView !== null;
   }
   async checkSimStatus() {
     try {
@@ -288,11 +449,23 @@ class IRSDK {
     }
     return true;
   }
+  static getSectionRegex(key) {
+    let regex = IRSDK.sessionRegexCache.get(key);
+    if (!regex) {
+      regex = new RegExp(`
+${key}:
+([\\s\\S]*?)(?=
+
+|$)`);
+      IRSDK.sessionRegexCache.set(key, regex);
+    }
+    return regex;
+  }
   getSessionInfo(key) {
     if (!this.header || !this.sharedMemBuffer)
       return null;
-    if (this.lastSessionInfoUpdate < this.header.sessionInfoUpdate) {
-      this.lastSessionInfoUpdate = this.header.sessionInfoUpdate;
+    if (this.lastSessionInfoUpdate !== this.sessionInfoUpdate) {
+      this.lastSessionInfoUpdate = this.sessionInfoUpdate;
       for (const [k, v] of this.sessionInfoCache) {
         if (v.data) {
           this.sessionInfoCache.set(k, { ...v, data: null });
@@ -303,20 +476,16 @@ class IRSDK {
     if (cached?.data) {
       return cached.data;
     }
-    const start = this.header.sessionInfoOffset;
-    const len = this.header.sessionInfoLen;
+    const start = this.liveHeaderInt(20, this.header.sessionInfoOffset);
+    const len = this.liveHeaderInt(16, this.header.sessionInfoLen);
     const raw = readString(this.sharedMemBuffer, start, len);
-    const sectionMatch = raw.match(new RegExp(`
-${key}:
-([\\s\\S]*?)(?=
-
-|$)`));
+    const sectionMatch = raw.match(IRSDK.getSectionRegex(key));
     if (!sectionMatch)
       return null;
     try {
       const sectionYaml = `${key}:
 ${sectionMatch[1]}`;
-      const cleaned = this.cleanYaml(sectionYaml);
+      const cleaned = cleanYamlFast(sectionYaml);
       const parsed = $parse(cleaned);
       const result = parsed?.[key] ?? null;
       this.sessionInfoCache.set(key, { data: result, update: this.lastSessionInfoUpdate });
@@ -325,15 +494,6 @@ ${sectionMatch[1]}`;
       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;

package/dist/lap-points.d.ts

@@ -33,6 +33,12 @@ export interface LapPoint {
     lat: number | null;
     lon: number | null;
     altitudeM: number | null;
+    /** Lateral acceleration in m/s² (iRacing LatAccel). Added in 1.4.0. */
+    latAccelMs2: number | null;
+    /** Longitudinal acceleration in m/s² (iRacing LongAccel). Added in 1.4.0. */
+    longAccelMs2: number | null;
+    /** Yaw rate in deg/s (iRacing YawRate rad/s → deg/s). Added in 1.4.0. */
+    yawRateDegS: number | null;
     tireTempLF: number | null;
     tireTempRF: number | null;
     tireTempLR: number | null;

package/dist/lap-points.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lap-points.d.ts","sourceRoot":"","sources":["../src/lap-points.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAM5D,mEAAmE;AACnE,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,2DAA2D;IAC3D,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,wDAAwD;IACxD,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,kEAAkE;IAClE,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA8CD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,aAAa,EAClB,IAAI,CAAC,EAAE,uBAAuB,GAC7B,sBAAsB,CA8IxB"}
+{"version":3,"file":"lap-points.d.ts","sourceRoot":"","sources":["../src/lap-points.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAM5D,mEAAmE;AACnE,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,uEAAuE;IACvE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,6EAA6E;IAC7E,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,yEAAyE;IACzE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,2DAA2D;IAC3D,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,wDAAwD;IACxD,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,kEAAkE;IAClE,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA8CD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,aAAa,EAClB,IAAI,CAAC,EAAE,uBAAuB,GAC7B,sBAAsB,CAqJxB"}

package/dist/live.d.ts

@@ -13,15 +13,23 @@ export declare class IRSDK {
     private varHeaders;
     private varHeadersNames;
     private sessionInfoCache;
+    private static readonly sessionRegexCache;
     private broadcastMsgId;
     private lastSessionInfoUpdate;
     private workaroundConnectedState;
     private frozenBuffer;
     private frozenView;
     private frozenBufOffset;
+    private frozenBufferCapacity;
     private testMode;
     isInitialized: boolean;
     constructor(options?: IRSDKOptions);
+    private liveHeaderInt;
+    private get liveStatus();
+    /** Tear-safe read target: the second-latest buffer by LIVE tick count. */
+    private liveReadBufOffset;
+    /** Freeze target: the newest buffer by LIVE tick count. */
+    private liveLatestBufOffset;
     get isConnected(): boolean;
     get sessionInfoUpdate(): number;
     get varHeaderNames(): string[] | null;
@@ -29,12 +37,37 @@ export declare class IRSDK {
     private startupFromFile;
     shutdown(): void;
     get(key: string): TelemetryValue | null;
+    /**
+     * Batch read multiple telemetry variables in a single pass.
+     * Much more efficient than calling get() multiple times.
+     * @param keys Array of variable names to read
+     * @returns Map of variable names to their values
+     */
+    getMultiple(keys: string[]): Map<string, TelemetryValue>;
+    /**
+     * Batch read multiple telemetry variables into a pre-allocated object.
+     * Zero allocation in the hot path - fastest option for real-time telemetry.
+     * @param keys Array of variable names to read
+     * @param out Pre-allocated object to write values into
+     */
+    getMultipleInto<T extends Record<string, TelemetryValue | null>>(keys: string[], out: T): T;
+    /**
+     * Creates a pre-compiled reader for maximum performance in hot loops.
+     * Pre-computes all offsets at creation time, avoiding Map lookups during reads.
+     * @param keys Array of variable names to read
+     * @returns A reader object with a read() method that returns values as an array
+     */
+    createReader(keys: string[]): {
+        read: () => (TelemetryValue | null)[];
+        keys: string[];
+    };
     freezeVarBufferLatest(): void;
     unfreezeVarBufferLatest(): void;
+    private get isFrozen();
     private checkSimStatus;
     private waitValidDataEvent;
+    private static getSectionRegex;
     getSessionInfo<T = unknown>(key: string): T | null;
-    private cleanYaml;
     private getBroadcastMsgId;
     private broadcastMsg;
     private padCarNum;

package/dist/live.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../src/live.ts"],"names":[],"mappings":"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"}

package/dist/live.js

@@ -2,7 +2,7 @@
 import {
   IRSDK,
   createIRSDK
-} from "./index-t4qz2011.js";
+} from "./index-ndbp3f5t.js";
 import"./index-hxw291vy.js";
 import"./index-c5jf6rjt.js";
 import"./index-wb6ebd0j.js";

package/dist/neutral/lap-points.js

@@ -51,6 +51,9 @@ function extractLapPoints(source, lap, opts) {
   const latArr = channel(source, "Lat");
   const lonArr = channel(source, "Lon");
   const altArr = channel(source, "Alt");
+  const latAccelArr = channel(source, "LatAccel");
+  const longAccelArr = channel(source, "LongAccel");
+  const yawRateArr = channel(source, "YawRate");
   const tempLF = channelWithFallback(source, "LFtempM", "LFtempCM");
   const tempRF = channelWithFallback(source, "RFtempM", "RFtempCM");
   const tempLR = channelWithFallback(source, "LRtempM", "LRtempCM");
@@ -105,6 +108,7 @@ function extractLapPoints(source, lap, opts) {
     const throttle = readNum(throttleArr, i);
     const brake = readNum(brakeArr, i);
     const steerRad = readNum(steerArr, i);
+    const yawRateRad = readNum(yawRateArr, i);
     const wLF = readNum(wearLF, i);
     const wRF = readNum(wearRF, i);
     const wLR = readNum(wearLR, i);
@@ -122,6 +126,9 @@ function extractLapPoints(source, lap, opts) {
       lat: readNum(latArr, i),
       lon: readNum(lonArr, i),
       altitudeM: readNum(altArr, i),
+      latAccelMs2: readNum(latAccelArr, i),
+      longAccelMs2: readNum(longAccelArr, i),
+      yawRateDegS: yawRateRad != null ? yawRateRad * 180 / Math.PI : null,
       tireTempLF: readNum(tempLF, i),
       tireTempRF: readNum(tempRF, i),
       tireTempLR: readNum(tempLR, i),

package/dist/telemetry-server.d.ts

@@ -15,6 +15,10 @@ export interface SessionInfoMessage {
         sessionType: string;
         sessionNum: number;
         tickRate: number;
+        sectors: Array<{
+            sectorNum: number;
+            startPct: number;
+        }>;
     };
 }
 export interface TelemetryMessage {
@@ -58,6 +62,24 @@ export interface TelemetryFrame {
     tireTempRF: number;
     tireTempLR: number;
     tireTempRR: number;
+    tirePressureLF: number | null;
+    tirePressureRF: number | null;
+    tirePressureLR: number | null;
+    tirePressureRR: number | null;
+    tireWearLF: number | null;
+    tireWearRF: number | null;
+    tireWearLR: number | null;
+    tireWearRR: number | null;
+    sessionNum: number;
+    onPitRoad: boolean;
+    playerCarIdx: number;
+    /** All cars' lap-distance pct at this tick (4dp) — head-to-head sector
+     * timing needs the full 60Hz stream, not the 15Hz field snapshot. */
+    carIdxLapDistPct: number[];
+    /** irsdk_Flags bitfield (green/yellow/blue/white/checkered...). */
+    sessionFlags: number;
+    /** irsdk_CarLeftRight spotter enum: 1 clear, 2 left, 3 right, 4 both, 5 two left, 6 two right. */
+    carLeftRight: number;
 }
 export interface LapChangeMessage {
     type: 'lap_change';
@@ -76,5 +98,82 @@ export interface StatusMessage {
         error?: string;
     };
 }
-export type ServerMessage = SessionInfoMessage | TelemetryMessage | LapChangeMessage | StatusMessage;
+export interface FieldMessage {
+    type: 'field';
+    data: FieldData;
+}
+/** Live multi-car snapshot, published at ~15Hz. Parallel arrays indexed by CarIdx. */
+export interface FieldData {
+    tick: number;
+    sessionTime: number;
+    sessionNum: number;
+    sessionState: number;
+    sessionTimeRemain: number;
+    sessionLapsRemain: number;
+    playerCarIdx: number;
+    paceCarIdx: number;
+    position: number[];
+    classPosition: number[];
+    lap: number[];
+    lapCompleted: number[];
+    lapDistPct: number[];
+    estTime: number[];
+    f2Time: number[];
+    onPitRoad: boolean[];
+    trackSurface: number[];
+    lastLapTime: number[];
+    bestLapTime: number[];
+}
+export interface OverlayDriver {
+    carIdx: number;
+    userName: string;
+    teamName?: string;
+    carNumber: string;
+    carClassId: number;
+    carClassShortName: string;
+    carClassColor: number;
+    carClassRelSpeed: number;
+    carClassEstLapTime: number;
+    iRating: number;
+    licString: string;
+    licColor: number;
+    incidentCount: number;
+}
+export interface ClassInfo {
+    classId: number;
+    shortName: string;
+    color: number;
+    sof: number;
+    carCount: number;
+}
+export interface SessionStateMessage {
+    type: 'session_state';
+    data: SessionStateData;
+}
+/** Roster + results snapshot, published when iRacing bumps its session-info counter. */
+export interface SessionStateData {
+    sessionInfoUpdate: number;
+    subSessionId: number;
+    trackId: number;
+    sessionNum: number;
+    sessionType: string;
+    sessionLaps: string | number;
+    sessionTimeTotal: string | number;
+    drivers: OverlayDriver[];
+    classes: ClassInfo[];
+    results: Array<{
+        carIdx: number;
+        position: number;
+        classPosition: number;
+        fastestTime: number;
+        lastTime: number;
+        lapsComplete: number;
+        incidents: number;
+    }>;
+    fastestLap: Array<{
+        carIdx: number;
+        fastestTime: number;
+    }>;
+}
+export type ServerMessage = SessionInfoMessage | TelemetryMessage | LapChangeMessage | StatusMessage | FieldMessage | SessionStateMessage;
 //# sourceMappingURL=telemetry-server.d.ts.map

package/dist/telemetry-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry-server.d.ts","sourceRoot":"","sources":["../src/telemetry-server.ts"],"names":[],"mappings":";AASA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,cAAc,CAAA;IACpB,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAA;QACf,SAAS,EAAE,MAAM,CAAA;QACjB,gBAAgB,EAAE,MAAM,CAAA;QACxB,WAAW,EAAE,MAAM,CAAA;QACnB,WAAW,EAAE,MAAM,CAAA;QACnB,KAAK,EAAE,MAAM,CAAA;QACb,OAAO,EAAE,MAAM,CAAA;QACf,SAAS,EAAE,MAAM,CAAA;QACjB,UAAU,EAAE,MAAM,CAAA;QAClB,QAAQ,EAAE,MAAM,CAAA;QAChB,WAAW,EAAE,MAAM,CAAA;QACnB,UAAU,EAAE,MAAM,CAAA;QAClB,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAA;CACF;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAA;IACjB,IAAI,EAAE,cAAc,CAAA;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,iBAAiB,EAAE,MAAM,CAAA;IACzB,cAAc,EAAE,MAAM,CAAA;IACtB,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,CAAA;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,cAAc,EAAE,OAAO,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,iBAAiB,EAAE,MAAM,CAAA;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,YAAY,CAAA;IAClB,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAA;QACf,KAAK,EAAE,MAAM,CAAA;QACb,OAAO,EAAE,MAAM,CAAA;QACf,UAAU,EAAE,MAAM,CAAA;KACnB,CAAA;CACF;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAA;IACd,IAAI,EAAE;QACJ,SAAS,EAAE,OAAO,CAAA;QAClB,WAAW,EAAE,OAAO,CAAA;QACpB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;CACF;AAED,MAAM,MAAM,aAAa,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,aAAa,CAAA"}
+{"version":3,"file":"telemetry-server.d.ts","sourceRoot":"","sources":["../src/telemetry-server.ts"],"names":[],"mappings":"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"}

package/dist/telemetry-server.js

@@ -2,7 +2,7 @@
 // @bun
 import {
   createIRSDK
-} from "./index-t4qz2011.js";
+} from "./index-ndbp3f5t.js";
 import"./index-hxw291vy.js";
 import"./index-c5jf6rjt.js";
 import"./index-wb6ebd0j.js";
@@ -12,20 +12,98 @@ import"./index-ftpvnye9.js";
 var TELEMETRY_PORT = 32100;
 var TELEMETRY_RATE_HZ = 60;
 var SESSION_INFO_RATE_HZ = 1;
+var FIELD_PUBLISH_EVERY = 4;
+var PROTOCOL_VERSION = 3;
+var CORS_HEADERS = {
+  "Access-Control-Allow-Origin": "*",
+  "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
+  "Access-Control-Allow-Headers": "Content-Type"
+};
 var ir = createIRSDK();
 var tickCount = 0;
 var lastLap = -1;
 var lastSessionNum = -1;
-var sessionInfoSent = false;
-async function connectToIRacing() {
-  console.log("Connecting to iRacing...");
-  const connected = await ir.startup();
-  if (!connected) {
-    console.error("Failed to connect to iRacing. Make sure iRacing is running.");
-    return false;
-  }
-  console.log("Connected to iRacing!");
-  return true;
+var lastSessionInfoFingerprint = "";
+var telemetryKeys = [
+  "SessionTime",
+  "Lap",
+  "LapDistPct",
+  "Speed",
+  "RPM",
+  "Gear",
+  "Throttle",
+  "Brake",
+  "Clutch",
+  "SteeringWheelAngle",
+  "Lat",
+  "Lon",
+  "Alt",
+  "Yaw",
+  "Pitch",
+  "Roll",
+  "LapCurrentLapTime",
+  "LapLastLapTime",
+  "LapBestLapTime",
+  "LapDeltaToBestLap",
+  "FuelLevel",
+  "FuelLevelPct",
+  "OilTemp",
+  "WaterTemp",
+  "IsOnTrack",
+  "PlayerCarPosition",
+  "PlayerCarClassPosition",
+  "BrakeABSactive",
+  "dcBrakeBias",
+  "dcTractionControl",
+  "dcABS",
+  "LFtempCL",
+  "RFtempCL",
+  "LRtempCL",
+  "RRtempCL",
+  "LFpressure",
+  "RFpressure",
+  "LRpressure",
+  "RRpressure",
+  "LFwearM",
+  "RFwearM",
+  "LRwearM",
+  "RRwearM",
+  "SessionNum",
+  "OnPitRoad",
+  "PlayerCarIdx",
+  "CarIdxLapDistPct",
+  "SessionFlags",
+  "CarLeftRight"
+];
+var fieldKeys = [
+  "CarIdxPosition",
+  "CarIdxClassPosition",
+  "CarIdxLap",
+  "CarIdxLapCompleted",
+  "CarIdxEstTime",
+  "CarIdxF2Time",
+  "CarIdxOnPitRoad",
+  "CarIdxTrackSurface",
+  "CarIdxLastLapTime",
+  "CarIdxBestLapTime",
+  "SessionState",
+  "SessionTimeRemain",
+  "SessionLapsRemainEx"
+];
+var telemetryData = {};
+for (const key of telemetryKeys) {
+  telemetryData[key] = null;
+}
+var fieldData = {};
+for (const key of fieldKeys) {
+  fieldData[key] = null;
+}
+var roundedLapDistPct = new Array(64).fill(-1);
+function numArray(value) {
+  return Array.isArray(value) ? value : [];
+}
+function boolArray(value) {
+  return Array.isArray(value) ? value : [];
 }
 function getSessionInfo() {
   const weekendInfo = ir.getSessionInfo("WeekendInfo");
@@ -36,6 +114,7 @@ function getSessionInfo() {
   const sessionNum = ir.get("SessionNum") ?? 0;
   return {
     trackId: weekendInfo.TrackID,
+    sectors: getSectorBoundaries(),
     trackName: weekendInfo.TrackName,
     trackDisplayName: weekendInfo.TrackDisplayName,
     trackLength: weekendInfo.TrackLength,
@@ -50,70 +129,230 @@ function getSessionInfo() {
     tickRate: 60
   };
 }
+function getSectorBoundaries() {
+  const splitTimeInfo = ir.getSessionInfo("SplitTimeInfo");
+  const sectors = splitTimeInfo?.Sectors;
+  if (!Array.isArray(sectors))
+    return [];
+  return sectors.map((s) => ({ sectorNum: s.SectorNum ?? -1, startPct: s.SectorStartPct ?? -1 })).filter((s) => s.sectorNum >= 0 && s.startPct >= 0 && s.startPct < 1).sort((a, b) => a.startPct - b.startPct);
+}
+function readNullableNum(key) {
+  const value = telemetryData[key];
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
 function getTelemetryFrame() {
-  ir.freezeVarBufferLatest();
+  ir.getMultipleInto(telemetryKeys, telemetryData);
   const frame = {
     tick: tickCount++,
-    sessionTime: ir.get("SessionTime") ?? 0,
-    lap: ir.get("Lap") ?? 0,
-    lapDistPct: ir.get("LapDistPct") ?? 0,
-    speed: ir.get("Speed") ?? 0,
-    rpm: ir.get("RPM") ?? 0,
-    gear: ir.get("Gear") ?? 0,
-    throttle: ir.get("Throttle") ?? 0,
-    brake: ir.get("Brake") ?? 0,
-    clutch: ir.get("Clutch") ?? 0,
-    steer: ir.get("SteeringWheelAngle") ?? 0,
-    lat: ir.get("Lat") ?? 0,
-    lon: ir.get("Lon") ?? 0,
-    alt: ir.get("Alt") ?? 0,
-    yaw: ir.get("Yaw") ?? 0,
-    pitch: ir.get("Pitch") ?? 0,
-    roll: ir.get("Roll") ?? 0,
-    lapCurrentLapTime: ir.get("LapCurrentLapTime") ?? 0,
-    lapLastLapTime: ir.get("LapLastLapTime") ?? 0,
-    lapBestLapTime: ir.get("LapBestLapTime") ?? 0,
-    lapDeltaToBestLap: ir.get("LapDeltaToBestLap") ?? 0,
-    fuelLevel: ir.get("FuelLevel") ?? 0,
-    fuelLevelPct: ir.get("FuelLevelPct") ?? 0,
-    oilTemp: ir.get("OilTemp") ?? 0,
-    waterTemp: ir.get("WaterTemp") ?? 0,
-    isOnTrack: ir.get("IsOnTrack") ?? false,
-    playerPosition: ir.get("PlayerCarPosition") ?? 0,
-    playerClassPosition: ir.get("PlayerCarClassPosition") ?? 0,
-    brakeABSactive: ir.get("BrakeABSactive") ?? false,
-    dcBrakeBias: ir.get("dcBrakeBias") ?? 0,
-    dcTractionControl: ir.get("dcTractionControl") ?? 0,
-    dcABS: ir.get("dcABS") ?? 0,
-    tireTempLF: ir.get("LFtempCL") ?? 0,
-    tireTempRF: ir.get("RFtempCL") ?? 0,
-    tireTempLR: ir.get("LRtempCL") ?? 0,
-    tireTempRR: ir.get("RRtempCL") ?? 0
+    sessionTime: telemetryData.SessionTime ?? 0,
+    lap: telemetryData.Lap ?? 0,
+    lapDistPct: telemetryData.LapDistPct ?? 0,
+    speed: telemetryData.Speed ?? 0,
+    rpm: telemetryData.RPM ?? 0,
+    gear: telemetryData.Gear ?? 0,
+    throttle: telemetryData.Throttle ?? 0,
+    brake: telemetryData.Brake ?? 0,
+    clutch: telemetryData.Clutch ?? 0,
+    steer: telemetryData.SteeringWheelAngle ?? 0,
+    lat: telemetryData.Lat ?? 0,
+    lon: telemetryData.Lon ?? 0,
+    alt: telemetryData.Alt ?? 0,
+    yaw: telemetryData.Yaw ?? 0,
+    pitch: telemetryData.Pitch ?? 0,
+    roll: telemetryData.Roll ?? 0,
+    lapCurrentLapTime: telemetryData.LapCurrentLapTime ?? 0,
+    lapLastLapTime: telemetryData.LapLastLapTime ?? 0,
+    lapBestLapTime: telemetryData.LapBestLapTime ?? 0,
+    lapDeltaToBestLap: telemetryData.LapDeltaToBestLap ?? 0,
+    fuelLevel: telemetryData.FuelLevel ?? 0,
+    fuelLevelPct: telemetryData.FuelLevelPct ?? 0,
+    oilTemp: telemetryData.OilTemp ?? 0,
+    waterTemp: telemetryData.WaterTemp ?? 0,
+    isOnTrack: telemetryData.IsOnTrack ?? false,
+    playerPosition: telemetryData.PlayerCarPosition ?? 0,
+    playerClassPosition: telemetryData.PlayerCarClassPosition ?? 0,
+    brakeABSactive: telemetryData.BrakeABSactive ?? false,
+    dcBrakeBias: telemetryData.dcBrakeBias ?? 0,
+    dcTractionControl: telemetryData.dcTractionControl ?? 0,
+    dcABS: telemetryData.dcABS ?? 0,
+    tireTempLF: telemetryData.LFtempCL ?? 0,
+    tireTempRF: telemetryData.RFtempCL ?? 0,
+    tireTempLR: telemetryData.LRtempCL ?? 0,
+    tireTempRR: telemetryData.RRtempCL ?? 0,
+    tirePressureLF: readNullableNum("LFpressure"),
+    tirePressureRF: readNullableNum("RFpressure"),
+    tirePressureLR: readNullableNum("LRpressure"),
+    tirePressureRR: readNullableNum("RRpressure"),
+    tireWearLF: readNullableNum("LFwearM"),
+    tireWearRF: readNullableNum("RFwearM"),
+    tireWearLR: readNullableNum("LRwearM"),
+    tireWearRR: readNullableNum("RRwearM"),
+    sessionNum: telemetryData.SessionNum ?? 0,
+    onPitRoad: telemetryData.OnPitRoad ?? false,
+    playerCarIdx: telemetryData.PlayerCarIdx ?? -1,
+    carIdxLapDistPct: roundCarIdxLapDistPct(numArray(telemetryData.CarIdxLapDistPct)),
+    sessionFlags: (telemetryData.SessionFlags ?? 0) >>> 0,
+    carLeftRight: telemetryData.CarLeftRight ?? 0
   };
-  ir.unfreezeVarBufferLatest();
   return frame;
 }
+function roundCarIdxLapDistPct(raw) {
+  for (let i = 0;i < roundedLapDistPct.length; i++) {
+    const v = raw[i];
+    roundedLapDistPct[i] = v == null || v < 0 ? -1 : Math.round(v * 1e4) / 1e4;
+  }
+  return roundedLapDistPct;
+}
+var cachedPaceCarIdx = -1;
+function getFieldData(frame) {
+  ir.getMultipleInto(fieldKeys, fieldData);
+  const round3 = (v) => Math.round(v * 1000) / 1000;
+  return {
+    tick: frame.tick,
+    sessionTime: frame.sessionTime,
+    sessionNum: frame.sessionNum,
+    sessionState: fieldData.SessionState ?? 0,
+    sessionTimeRemain: fieldData.SessionTimeRemain ?? -1,
+    sessionLapsRemain: fieldData.SessionLapsRemainEx ?? -1,
+    playerCarIdx: frame.playerCarIdx,
+    paceCarIdx: cachedPaceCarIdx,
+    position: numArray(fieldData.CarIdxPosition),
+    classPosition: numArray(fieldData.CarIdxClassPosition),
+    lap: numArray(fieldData.CarIdxLap),
+    lapCompleted: numArray(fieldData.CarIdxLapCompleted),
+    lapDistPct: frame.carIdxLapDistPct,
+    estTime: numArray(fieldData.CarIdxEstTime).map(round3),
+    f2Time: numArray(fieldData.CarIdxF2Time).map(round3),
+    onPitRoad: boolArray(fieldData.CarIdxOnPitRoad),
+    trackSurface: numArray(fieldData.CarIdxTrackSurface),
+    lastLapTime: numArray(fieldData.CarIdxLastLapTime).map(round3),
+    bestLapTime: numArray(fieldData.CarIdxBestLapTime).map(round3)
+  };
+}
+function computeSof(ratings) {
+  if (ratings.length === 0)
+    return 0;
+  const LN2 = Math.log(2);
+  const sum = ratings.reduce((acc, r) => acc + Math.pow(2, -r / 1600), 0);
+  if (sum <= 0)
+    return 0;
+  return Math.round(1600 / LN2 * Math.log(ratings.length / sum));
+}
+function buildSessionState(sessionInfoUpdate) {
+  const weekendInfo = ir.getSessionInfo("WeekendInfo");
+  const driverInfo = ir.getSessionInfo("DriverInfo");
+  if (!weekendInfo || !driverInfo)
+    return null;
+  const sessionNum = ir.get("SessionNum") ?? 0;
+  cachedPaceCarIdx = driverInfo.PaceCarIdx ?? -1;
+  const drivers = [];
+  for (const d of driverInfo.Drivers ?? []) {
+    if (!d || d.CarIdx == null || d.CarIdx < 0)
+      continue;
+    if (d.IsSpectator || d.CarIsPaceCar)
+      continue;
+    drivers.push({
+      carIdx: d.CarIdx,
+      userName: d.UserName ?? "Unknown",
+      teamName: d.TeamName || undefined,
+      carNumber: d.CarNumber ?? "",
+      carClassId: d.CarClassID ?? 0,
+      carClassShortName: d.CarClassShortName ?? "",
+      carClassColor: d.CarClassColor ?? 0,
+      carClassRelSpeed: d.CarClassRelSpeed ?? 0,
+      carClassEstLapTime: d.CarClassEstLapTime ?? 0,
+      iRating: d.IRating ?? 0,
+      licString: d.LicString ?? "",
+      licColor: d.LicColor ?? 0,
+      incidentCount: d.CurDriverIncidentCount ?? 0
+    });
+  }
+  const byClass = new Map;
+  for (const d of drivers) {
+    const list = byClass.get(d.carClassId);
+    if (list)
+      list.push(d);
+    else
+      byClass.set(d.carClassId, [d]);
+  }
+  const classes = [...byClass.entries()].map(([classId, list]) => ({
+    classId,
+    shortName: list[0]?.carClassShortName ?? "",
+    color: list[0]?.carClassColor ?? 0,
+    sof: computeSof(list.map((d) => d.iRating).filter((r) => r > 0)),
+    carCount: list.length
+  }));
+  const sessionsInfo = ir.getSessionInfo("SessionInfo");
+  const session = sessionsInfo?.Sessions?.find((s) => s.SessionNum === sessionNum) ?? sessionsInfo?.Sessions?.[sessionsInfo.Sessions.length - 1];
+  return {
+    sessionInfoUpdate,
+    subSessionId: weekendInfo.SubSessionID ?? 0,
+    trackId: weekendInfo.TrackID,
+    sessionNum,
+    sessionType: session?.SessionType ?? weekendInfo.EventType ?? "Unknown",
+    sessionLaps: session?.SessionLaps ?? "unlimited",
+    sessionTimeTotal: session?.SessionTime ?? "unlimited",
+    drivers,
+    classes,
+    results: (session?.ResultsPositions ?? []).map((r) => ({
+      carIdx: r.CarIdx ?? -1,
+      position: r.Position ?? 0,
+      classPosition: r.ClassPosition ?? 0,
+      fastestTime: r.FastestTime ?? -1,
+      lastTime: r.LastTime ?? -1,
+      lapsComplete: r.LapsComplete ?? 0,
+      incidents: r.Incidents ?? 0
+    })),
+    fastestLap: (session?.ResultsFastestLap ?? []).map((f) => ({
+      carIdx: f.CarIdx ?? -1,
+      fastestTime: f.FastestTime ?? -1
+    }))
+  };
+}
+var LAP_CHANGE_SETTLE_TICKS = 60;
+var pendingLapChange = null;
+function emitLapChange(pending, lapTime, server) {
+  const lapChangeMsg = {
+    type: "lap_change",
+    data: {
+      fromLap: pending.fromLap,
+      toLap: pending.toLap,
+      lapTime,
+      sessionNum: pending.sessionNum
+    }
+  };
+  server.publish("telemetry", JSON.stringify(lapChangeMsg));
+  console.log(`Lap ${pending.fromLap} completed: ${formatLapTime(lapTime)}`);
+}
 function checkLapChange(frame, server) {
   const currentLap = frame.lap;
   const currentSessionNum = ir.get("SessionNum") ?? 0;
   if (currentSessionNum !== lastSessionNum) {
     lastSessionNum = currentSessionNum;
     lastLap = currentLap;
-    sessionInfoSent = false;
+    lastSessionInfoFingerprint = "";
+    pendingLapChange = null;
     return;
   }
+  if (pendingLapChange) {
+    pendingLapChange.ticksWaited++;
+    const settled = frame.lapLastLapTime > 0 && frame.lapLastLapTime !== pendingLapChange.lastLapTimeAtChange;
+    if (settled || pendingLapChange.ticksWaited >= LAP_CHANGE_SETTLE_TICKS) {
+      emitLapChange(pendingLapChange, frame.lapLastLapTime, server);
+      pendingLapChange = null;
+    }
+  }
   if (currentLap !== lastLap && lastLap !== -1) {
-    const lapChangeMsg = {
-      type: "lap_change",
-      data: {
-        fromLap: lastLap,
-        toLap: currentLap,
-        lapTime: frame.lapLastLapTime,
-        sessionNum: currentSessionNum
-      }
+    if (pendingLapChange) {
+      emitLapChange(pendingLapChange, frame.lapLastLapTime, server);
+    }
+    pendingLapChange = {
+      fromLap: lastLap,
+      toLap: currentLap,
+      sessionNum: currentSessionNum,
+      ticksWaited: 0,
+      lastLapTimeAtChange: frame.lapLastLapTime
     };
-    server.publish("telemetry", JSON.stringify(lapChangeMsg));
-    console.log(`Lap ${lastLap} completed: ${formatLapTime(frame.lapLastLapTime)}`);
   }
   lastLap = currentLap;
 }
@@ -124,95 +363,192 @@ function formatLapTime(seconds) {
   const secs = (seconds % 60).toFixed(3).padStart(6, "0");
   return `${mins}:${secs}`;
 }
+var cachedSessionStateJson = null;
 async function main() {
-  const connected = await connectToIRacing();
-  if (!connected) {
-    process.exit(1);
-  }
-  const sessionInfo = getSessionInfo();
-  if (sessionInfo) {
-    console.log(`Track: ${sessionInfo.trackDisplayName}`);
-    console.log(`Driver: ${sessionInfo.driverName}`);
-    console.log(`Car: ${sessionInfo.carName} #${sessionInfo.carNumber}`);
-  }
-  const server = Bun.serve({
-    port: TELEMETRY_PORT,
-    fetch(req, server2) {
-      const url = new URL(req.url);
-      if (url.pathname === "/ws" || req.headers.get("upgrade") === "websocket") {
-        const success = server2.upgrade(req);
-        if (success) {
-          return;
-        }
-        return new Response("WebSocket upgrade failed", { status: 400 });
-      }
-      if (url.pathname === "/status") {
-        return Response.json({
-          connected: ir.isConnected,
-          initialized: ir.isInitialized,
-          sessionInfo: getSessionInfo()
-        });
-      }
-      if (url.pathname === "/health") {
-        return new Response("OK", { status: 200 });
-      }
-      return new Response("Not found", { status: 404 });
-    },
-    websocket: {
-      open(ws) {
-        console.log("Client connected");
-        ws.subscribe("telemetry");
-        const statusMsg = {
-          type: "status",
-          data: {
-            connected: ir.isConnected,
-            initialized: ir.isInitialized
+  const server = (() => {
+    try {
+      return Bun.serve({
+        port: TELEMETRY_PORT,
+        hostname: "127.0.0.1",
+        fetch(req, server2) {
+          const url = new URL(req.url);
+          if (url.pathname === "/ws" || req.headers.get("upgrade") === "websocket") {
+            const success = server2.upgrade(req);
+            if (success) {
+              return;
+            }
+            return new Response("WebSocket upgrade failed", { status: 400, headers: CORS_HEADERS });
+          }
+          if (req.method === "OPTIONS") {
+            return new Response(null, { status: 204, headers: CORS_HEADERS });
+          }
+          if (url.pathname === "/status") {
+            return Response.json({
+              connected: ir.isConnected,
+              initialized: ir.isInitialized,
+              protocol: PROTOCOL_VERSION,
+              sessionInfo: getSessionInfo()
+            }, { headers: CORS_HEADERS });
           }
-        };
-        ws.send(JSON.stringify(statusMsg));
-        const sessionInfo2 = getSessionInfo();
-        if (sessionInfo2) {
-          const sessionMsg = {
-            type: "session_info",
-            data: sessionInfo2
-          };
-          ws.send(JSON.stringify(sessionMsg));
+          if (url.pathname === "/health") {
+            return Response.json({ ok: true, protocol: PROTOCOL_VERSION }, { headers: CORS_HEADERS });
+          }
+          if (url.pathname === "/shutdown" && req.method === "POST") {
+            console.log("Shutdown requested by client");
+            setTimeout(() => {
+              ir.shutdown();
+              process.exit(0);
+            }, 50);
+            return new Response("shutting down", { headers: CORS_HEADERS });
+          }
+          return new Response("Not found", { status: 404, headers: CORS_HEADERS });
+        },
+        websocket: {
+          open(ws) {
+            console.log("Client connected");
+            ws.subscribe("telemetry");
+            const statusMsg = {
+              type: "status",
+              data: {
+                connected: ir.isConnected,
+                initialized: ir.isInitialized
+              }
+            };
+            ws.send(JSON.stringify(statusMsg));
+            const sessionInfo = getSessionInfo();
+            if (sessionInfo) {
+              const sessionMsg = {
+                type: "session_info",
+                data: sessionInfo
+              };
+              ws.send(JSON.stringify(sessionMsg));
+            }
+            if (cachedSessionStateJson) {
+              ws.send(cachedSessionStateJson);
+            }
+          },
+          close(ws) {
+            console.log("Client disconnected");
+          },
+          message(ws, msg) {}
         }
-      },
-      close(ws) {
-        console.log("Client disconnected");
-      },
-      message(ws, msg) {}
+      });
+    } catch (err) {
+      console.error("Could not bind port \u2014 another sidecar instance is likely running:", err);
+      process.exit(0);
     }
-  });
+  })();
   console.log(`
 Telemetry server running at ws://127.0.0.1:${server.port}/ws`);
   console.log(`Status endpoint: http://127.0.0.1:${server.port}/status`);
-  console.log(`Waiting for connections...
+  console.log(`Waiting for iRacing...
 `);
+  const REATTACH_AFTER_MS = 1e4;
+  let startupInFlight = false;
+  let wasConnected = false;
+  let disconnectedSince = null;
+  const ensureIRacing = async () => {
+    if (startupInFlight)
+      return;
+    if (ir.isInitialized) {
+      if (ir.isConnected) {
+        disconnectedSince = null;
+        return;
+      }
+      disconnectedSince ??= Date.now();
+      if (Date.now() - disconnectedSince < REATTACH_AFTER_MS)
+        return;
+      console.log("iRacing gone \u2014 detaching and waiting for a new session");
+      ir.shutdown();
+      lastSessionInfoFingerprint = "";
+      cachedSessionStateJson = null;
+      disconnectedSince = null;
+    }
+    startupInFlight = true;
+    try {
+      const ok = await ir.startup();
+      if (ok) {
+        console.log("Connected to iRacing!");
+        const sessionInfo = getSessionInfo();
+        if (sessionInfo) {
+          console.log(`Track: ${sessionInfo.trackDisplayName}`);
+          console.log(`Driver: ${sessionInfo.driverName}`);
+          console.log(`Car: ${sessionInfo.carName} #${sessionInfo.carNumber}`);
+        }
+      }
+    } catch (err) {
+      console.error("iRacing startup attempt failed:", err);
+    } finally {
+      startupInFlight = false;
+    }
+  };
+  await ensureIRacing();
+  setInterval(ensureIRacing, 2000);
   let lastSessionInfoTime = 0;
+  let fieldTickCounter = 0;
+  let lastSessionStateCheck = 0;
+  let lastSessionStatePublish = 0;
+  let lastPublishedSessionInfoUpdate = -1;
   setInterval(() => {
-    if (!ir.isConnected) {
+    const connected = ir.isConnected && ir.isInitialized;
+    if (connected !== wasConnected) {
+      wasConnected = connected;
+      const statusMsg = {
+        type: "status",
+        data: { connected, initialized: ir.isInitialized }
+      };
+      server.publish("telemetry", JSON.stringify(statusMsg));
+    }
+    if (!connected) {
       return;
     }
+    ir.freezeVarBufferLatest();
     const frame = getTelemetryFrame();
+    fieldTickCounter++;
+    const field = fieldTickCounter % FIELD_PUBLISH_EVERY === 0 ? getFieldData(frame) : null;
+    ir.unfreezeVarBufferLatest();
     checkLapChange(frame, server);
     const telemetryMsg = {
       type: "telemetry",
       data: frame
     };
     server.publish("telemetry", JSON.stringify(telemetryMsg));
+    if (field) {
+      const fieldMsg = { type: "field", data: field };
+      server.publish("telemetry", JSON.stringify(fieldMsg));
+    }
     const now = Date.now();
     if (now - lastSessionInfoTime > 1000 / SESSION_INFO_RATE_HZ) {
       lastSessionInfoTime = now;
-      const sessionInfo2 = getSessionInfo();
-      if (sessionInfo2 && !sessionInfoSent) {
-        const sessionMsg = {
-          type: "session_info",
-          data: sessionInfo2
-        };
-        server.publish("telemetry", JSON.stringify(sessionMsg));
-        sessionInfoSent = true;
+      const weekendInfo = ir.getSessionInfo("WeekendInfo");
+      if (weekendInfo) {
+        const sessionNum = ir.get("SessionNum") ?? 0;
+        const fingerprint = `${weekendInfo.SubSessionID ?? 0}:${sessionNum}:${weekendInfo.TrackID ?? 0}`;
+        if (fingerprint !== lastSessionInfoFingerprint) {
+          const sessionInfo = getSessionInfo();
+          if (sessionInfo) {
+            const sessionMsg = {
+              type: "session_info",
+              data: sessionInfo
+            };
+            server.publish("telemetry", JSON.stringify(sessionMsg));
+            lastSessionInfoFingerprint = fingerprint;
+          }
+        }
+      }
+    }
+    if (now - lastSessionStateCheck > 500) {
+      lastSessionStateCheck = now;
+      const counter = ir.sessionInfoUpdate;
+      if (counter !== lastPublishedSessionInfoUpdate && now - lastSessionStatePublish >= 1000) {
+        const state = buildSessionState(counter);
+        if (state) {
+          const stateMsg = { type: "session_state", data: state };
+          cachedSessionStateJson = JSON.stringify(stateMsg);
+          server.publish("telemetry", cachedSessionStateJson);
+          lastPublishedSessionInfoUpdate = counter;
+          lastSessionStatePublish = now;
+        }
       }
     }
   }, 1000 / TELEMETRY_RATE_HZ);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hotlap.ai/telemetry",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "High-performance iRacing telemetry library for Bun - IBT file parsing and live data streaming",
   "type": "module",
   "main": "./dist/index.js",
@@ -63,10 +63,12 @@
     "build:neutral": "bun build ./src/ibt.ts ./src/normalize.ts ./src/session-yaml.ts ./src/lap-points.ts --outdir ./dist/neutral --target browser --splitting",
     "build:types": "tsc --emitDeclarationOnly --declaration --declarationMap --outDir ./dist",
     "build:server": "bun build ./src/telemetry-server.ts --compile --outfile ./dist/hotlap-telemetry",
+    "build:sidecar": "bun run build:server && bun run scripts/copy-sidecar.ts",
     "clean": "rm -rf dist",
     "dev": "bun --watch src/cli.ts",
     "dashboard": "bun run examples/dashboard-server.ts",
     "server": "bun run src/telemetry-server.ts",
+    "mock:overlays": "bun run scripts/mock-overlay-server.ts",
     "typecheck": "tsc --noEmit",
     "test": "bun test",
     "fixtures:pull": "bun run scripts/fixtures-pull.ts",