@hotlap.ai/telemetry 1.1.0 → 1.2.0

package/dist/neutral/session-yaml.js

@@ -0,0 +1,20 @@
+import {
+  cleanYamlFast,
+  decodeSessionYaml,
+  parseSessionYaml,
+  parseTrackLengthKm,
+  readSessionInfoRange,
+  resolveSessionMetadata,
+  sessionMetadataFromYamlBytes,
+  sessionTypeForSessionNum
+} from "./ibt-kagktz7r.js";
+export {
+  sessionTypeForSessionNum,
+  sessionMetadataFromYamlBytes,
+  resolveSessionMetadata,
+  readSessionInfoRange,
+  parseTrackLengthKm,
+  parseSessionYaml,
+  decodeSessionYaml,
+  cleanYamlFast
+};

package/dist/session-yaml.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Fast single-pass YAML cleaning function.
+ * Combines multiple string operations to reduce intermediate allocations.
+ */
+export declare function cleanYamlFast(yaml: string): string;
+/**
+ * Read the session-info byte range from the .ibt fixed header (first 48+
+ * bytes are sufficient). For consumers that range-download instead of
+ * loading the whole file.
+ */
+export declare function readSessionInfoRange(headerBytes: ArrayBuffer | Uint8Array): {
+    sessionInfoLen: number;
+    sessionInfoOffset: number;
+};
+/**
+ * Canonical text decode (RFC C5/D5): UTF-8 first; if replacement characters
+ * appear, fall back to windows-1252 (older iRacing builds and non-ASCII
+ * driver/team names). A plain lossy UTF-8 decode corrupts those names —
+ * that was divergence D5.
+ */
+export declare function decodeSessionYaml(bytes: Uint8Array): string;
+export interface SessionYamlDoc {
+    WeekendInfo?: Record<string, unknown>;
+    DriverInfo?: {
+        DriverCarIdx?: number;
+        Drivers?: Array<Record<string, unknown>>;
+        [key: string]: unknown;
+    };
+    SplitTimeInfo?: {
+        Sectors?: Array<{
+            SectorNum?: number;
+            SectorStartPct?: number;
+        }>;
+    };
+    SessionInfo?: {
+        Sessions?: Array<Record<string, unknown>>;
+    };
+    [key: string]: unknown;
+}
+/** Clean + parse the raw YAML text with a real YAML parser (never regex). */
+export declare function parseSessionYaml(raw: string): SessionYamlDoc | null;
+export interface ResolvedSessionEntry {
+    sessionNum: number | null;
+    /** Full string, e.g. "Offline Testing", "Lone Qualify" — never truncated. */
+    sessionType: string | null;
+    sessionName: string | null;
+    raw: Record<string, unknown>;
+}
+export interface SessionMetadata {
+    trackId: number | null;
+    trackName: string | null;
+    trackConfigName: string | null;
+    trackLengthKm: number | null;
+    trackNumTurns: number | null;
+    eventType: string | null;
+    category: string | null;
+    seriesId: number | null;
+    seasonId: number | null;
+    sessionId: number | null;
+    subSessionId: number | null;
+    raceWeek: number | null;
+    official: boolean | null;
+    driverCarIdx: number;
+    driverName: string | null;
+    driverUserId: number | null;
+    carId: number | null;
+    carScreenName: string | null;
+    carPath: string | null;
+    carClassId: number | null;
+    carNumber: string | null;
+    teamName: string | null;
+    sessions: ResolvedSessionEntry[];
+    /** Raw parsed doc for specialized consumers (results positions, sectors…). */
+    doc: SessionYamlDoc;
+}
+export declare function parseTrackLengthKm(value: unknown): number | null;
+export declare function resolveSessionMetadata(doc: SessionYamlDoc): SessionMetadata;
+/**
+ * Session-type resolution per RFC C5: the type of the session the telemetry
+ * was recorded in is Sessions[n].SessionType where n comes from the
+ * SessionNum CHANNEL — never "the first SessionType in the document" (that
+ * was divergence D4) and never WeekendInfo.EventType (kept separately).
+ */
+export declare function sessionTypeForSessionNum(meta: Pick<SessionMetadata, 'sessions'>, sessionNum: number): string | null;
+/** Convenience: raw YAML byte range → resolved metadata (or null on parse failure). */
+export declare function sessionMetadataFromYamlBytes(bytes: Uint8Array): SessionMetadata | null;
+//# sourceMappingURL=session-yaml.d.ts.map

package/dist/session-yaml.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hotlap.ai/telemetry",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "High-performance iRacing telemetry library for Bun - IBT file parsing and live data streaming",
   "type": "module",
   "main": "./dist/index.js",
@@ -27,6 +27,11 @@
       "import": "./dist/neutral/normalize.js",
       "default": "./dist/neutral/normalize.js"
     },
+    "./session": {
+      "types": "./dist/session-yaml.d.ts",
+      "import": "./dist/neutral/session-yaml.js",
+      "default": "./dist/neutral/session-yaml.js"
+    },
     "./live": {
       "types": "./dist/live.d.ts",
       "import": "./dist/live.js",
@@ -50,7 +55,7 @@
   "scripts": {
     "build": "bun run build:js && bun run build:types",
     "build:js": "bun build ./src/index.ts ./src/ibt.ts ./src/live.ts ./src/constants.ts ./src/cli.ts ./src/telemetry-server.ts ./src/types.ts ./src/binary-reader.ts --outdir ./dist --target bun --splitting && bun run build:neutral",
-    "build:neutral": "bun build ./src/ibt.ts ./src/normalize.ts --outdir ./dist/neutral --target browser --splitting",
+    "build:neutral": "bun build ./src/ibt.ts ./src/normalize.ts ./src/session-yaml.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",
     "clean": "rm -rf dist",