@hotlap.ai/telemetry 1.2.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

@@ -0,0 +1,76 @@
+/**
+ * Canonical lap point extraction — produces the per-sample telemetry series
+ * (byDist / byTime) that the UI charts and the backend lap_bundles store.
+ *
+ * Output shape matches the deployed IbtLapPoint contract exactly
+ * (UI/src/lib/ibt-extract.ts and BACKEND process-job convertToIbtLapData):
+ *  - Speed m/s → km/h, Throttle/Brake 0–1 → 0–100 %, SteeringWheelAngle rad → deg
+ *  - distanceKm normalized per lap: (LapDist − min LapDist) / 1000
+ *  - timeSec normalized per lap: SessionTime − min SessionTime
+ *  - tire temps LFtempM.. with LFtempCM.. carcass fallback (process-job behavior)
+ *
+ * CANONICAL DECISION — tire wear is percent 0–100 (×100 from the raw 0–1
+ * channel), matching process-job and therefore every stored lap bundle. The
+ * UI's ibt-extract.ts left wear at raw 0–1; that was the divergent one.
+ *
+ * RFC-0001 C8: extraction runs at FULL resolution; downsampling to maxPoints
+ * happens last and is presentation-only — never an input to metrics.
+ *
+ * RUNTIME NEUTRALITY: this module must not import Bun/Deno/Node APIs.
+ */
+import type { IbtSource, NormalizedLap } from './normalize';
+/** Matches the UI/backend IbtLapPoint contract field-for-field. */
+export interface LapPoint {
+    distanceKm: number;
+    timeSec: number;
+    speedKmh: number | null;
+    throttlePct: number | null;
+    brakePct: number | null;
+    brakeABSactive: boolean | null;
+    gear: number | null;
+    rpm: number | null;
+    steeringDeg: number | null;
+    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;
+    tireTempRR: number | null;
+    tirePressureLF: number | null;
+    tirePressureRF: number | null;
+    tirePressureLR: number | null;
+    tirePressureRR: number | null;
+    tireWearLF: number | null;
+    tireWearRF: number | null;
+    tireWearLR: number | null;
+    tireWearRR: number | null;
+}
+export interface ExtractLapPointsResult {
+    /** Points sorted ascending by distanceKm (downsampled). */
+    byDist: LapPoint[];
+    /** Points sorted ascending by timeSec (downsampled). */
+    byTime: LapPoint[];
+    /** Number of valid full-resolution points before downsampling. */
+    downsampledFrom: number;
+}
+export interface ExtractLapPointsOptions {
+    /** Maximum points per series after downsampling. Default 500. */
+    maxPoints?: number;
+}
+/**
+ * Extract the telemetry point series for one normalized lap.
+ *
+ * Iterates lap.firstSampleIndex..lastSampleIndex; when the Lap / SessionNum
+ * channels are available, only indices whose Lap equals lap.lapNumber (and
+ * whose SessionNum matches the lap's own session, read at firstSampleIndex)
+ * are honored. Without those channels the whole contiguous range is accepted.
+ */
+export declare function extractLapPoints(source: IbtSource, lap: NormalizedLap, opts?: ExtractLapPointsOptions): ExtractLapPointsResult;
+//# sourceMappingURL=lap-points.d.ts.map

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

@@ -0,0 +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,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";