@hotlap.ai/telemetry 1.1.0 → 1.3.0

package/dist/cli.js

@@ -2,7 +2,7 @@
 // @bun
 import {
   parseIbt
-} from "./index-tz5ph8p3.js";
+} from "./index-6wrtvcny.js";
 import {
   createIRSDK
 } from "./index-t4qz2011.js";

package/dist/ibt.d.ts

@@ -10,8 +10,10 @@ export declare class IBT {
     private diskHeader;
     private varHeaders;
     private sessionInfoCache;
+    private static readonly sessionRegexCache;
     private rawSessionInfo;
     private filePath;
+    private static getSectionRegex;
     get fileName(): string | null;
     get varHeaderBufferTick(): number | null;
     get varHeaderNames(): string[] | null;
@@ -33,7 +35,6 @@ export declare class IBT {
     iterate(keys: string[]): Generator<Map<string, TelemetryValue>, void, unknown>;
     getRawSessionInfo(): string | null;
     getSessionInfo<T = unknown>(key?: string): T | null;
-    private cleanYaml;
 }
 export declare function parseIbt(filePath: string): Promise<IBT>;
 export declare function parseIbtBuffer(buffer: ArrayBuffer | Uint8Array): Promise<IBT>;

package/dist/ibt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ibt.d.ts","sourceRoot":"","sources":["../src/ibt.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAU,SAAS,EAAiB,cAAc,EAAe,MAAM,SAAS,CAAC;AAY7F,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,qBAAa,GAAG;IACd,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,IAAI,CAAyB;IACrC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,UAAU,CAAuC;IACzD,OAAO,CAAC,gBAAgB,CAAmC;IAC3D,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAuB;IAEvC,IAAI,QAAQ,IAAI,MAAM,GAAG,IAAI,CAE5B;IAED,IAAI,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAEvC;IAED,IAAI,cAAc,IAAI,MAAM,EAAE,GAAG,IAAI,CAGpC;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAEK,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;WAgBnB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC;IAUvE,KAAK,IAAI,IAAI;IAWb,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIjD,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAatD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,EAAE,GAAG,IAAI;IAuB5C,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,IAAI;IAmCvF,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IAgC5D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC;IA8B/E,iBAAiB,IAAI,MAAM,GAAG,IAAI;IAYlC,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAmCnD,OAAO,CAAC,SAAS;CAiBlB;AAED,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAI7D;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAEnF"}
+{"version":3,"file":"ibt.d.ts","sourceRoot":"","sources":["../src/ibt.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAU,SAAS,EAAiB,cAAc,EAAe,MAAM,SAAS,CAAC;AAc7F,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,qBAAa,GAAG;IACd,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,IAAI,CAAyB;IACrC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,UAAU,CAAuC;IACzD,OAAO,CAAC,gBAAgB,CAAmC;IAC3D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAA6B;IACtE,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAuB;IAEvC,OAAO,CAAC,MAAM,CAAC,eAAe;IAS9B,IAAI,QAAQ,IAAI,MAAM,GAAG,IAAI,CAE5B;IAED,IAAI,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAEvC;IAED,IAAI,cAAc,IAAI,MAAM,EAAE,GAAG,IAAI,CAGpC;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAEK,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;WAgBnB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC;IAUvE,KAAK,IAAI,IAAI;IAWb,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIjD,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAatD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,EAAE,GAAG,IAAI;IAuB5C,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,IAAI;IAmCvF,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IAgC5D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC;IA8B/E,iBAAiB,IAAI,MAAM,GAAG,IAAI;IAYlC,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;CAkCpD;AAED,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAI7D;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAEnF"}

package/dist/ibt.js

@@ -3,7 +3,7 @@ import {
   IBT,
   parseIbt,
   parseIbtBuffer
-} from "./index-tz5ph8p3.js";
+} from "./index-6wrtvcny.js";
 import"./index-hxw291vy.js";
 import"./index-c5jf6rjt.js";
 import"./index-wb6ebd0j.js";

package/dist/{index-tz5ph8p3.js → index-6wrtvcny.js}

@@ -14,6 +14,28 @@ import {
   DISK_SUB_HEADER_OFFSET
 } from "./index-wb6ebd0j.js";
 
+// src/session-yaml.ts
+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}"`;
+  });
+  return cleaned.replace(YAML_COMMA_VALUE_REGEX, '$1"$2"');
+}
+var utf8Decoder = new TextDecoder("utf-8", { fatal: false });
+var win1252Decoder = new TextDecoder("windows-1252");
+
 // src/ibt.ts
 class IBT {
   buffer = null;
@@ -22,8 +44,21 @@ class IBT {
   diskHeader = null;
   varHeaders = null;
   sessionInfoCache = new Map;
+  static sessionRegexCache = new Map;
   rawSessionInfo = null;
   filePath = null;
+  static getSectionRegex(key) {
+    let regex = IBT.sessionRegexCache.get(key);
+    if (!regex) {
+      regex = new RegExp(`
+${key}:
+([\\s\\S]*?)(?=
+
+|$)`);
+      IBT.sessionRegexCache.set(key, regex);
+    }
+    return regex;
+  }
   get fileName() {
     return this.filePath;
   }
@@ -241,7 +276,7 @@ class IBT {
     if (!key) {
       if (!this.sessionInfoCache.has("__full__")) {
         try {
-          const cleaned = this.cleanYaml(raw);
+          const cleaned = cleanYamlFast(raw);
           this.sessionInfoCache.set("__full__", $parse(cleaned));
         } catch {
           return null;
@@ -252,17 +287,13 @@ class IBT {
     if (this.sessionInfoCache.has(key)) {
       return this.sessionInfoCache.get(key);
     }
-    const sectionMatch = raw.match(new RegExp(`
-${key}:
-([\\s\\S]*?)(?=
-
-|$)`));
+    const sectionMatch = raw.match(IBT.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, result);
@@ -271,15 +302,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;
-  }
 }
 async function parseIbt(filePath) {
   const ibt = new IBT;

package/dist/lap-points.d.ts

@@ -0,0 +1,70 @@
+/**
+ * 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;
+    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,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"}