@hotlap.ai/telemetry 1.0.0

package/dist/cli.js

@@ -0,0 +1,261 @@
+#!/usr/bin/env bun
+// @bun
+import {
+  parseIbt
+} from "./ibt.js";
+import {
+  createIRSDK
+} from "./live.js";
+import"./index-k5bgtn4c.js";
+import"./binary-reader.js";
+import {
+  VERSION
+} from "./constants.js";
+
+// src/cli.ts
+import { parseArgs } from "util";
+var { values, positionals } = parseArgs({
+  args: Bun.argv.slice(2),
+  options: {
+    version: { type: "boolean", short: "v" },
+    help: { type: "boolean", short: "h" },
+    test: { type: "string", short: "t" },
+    dump: { type: "string", short: "d" },
+    parse: { type: "string", short: "p" },
+    info: { type: "boolean", short: "i" },
+    vars: { type: "boolean" },
+    get: { type: "string", short: "g" },
+    "get-all": { type: "string" },
+    session: { type: "string", short: "s" },
+    output: { type: "string", short: "o" },
+    format: { type: "string", short: "f" },
+    live: { type: "boolean", short: "l" }
+  },
+  allowPositionals: true
+});
+function printHelp() {
+  console.log(`
+Bun iRacing SDK v${VERSION}
+
+Usage: irsdk [options] [file.ibt]
+
+Options:
+  -v, --version        Show version
+  -h, --help           Show help
+  -t, --test <file>    Use test file as IRSDK memory map
+  -d, --dump <file>    Dump IRSDK memory map to file
+  -p, --parse <file>   Parse IBT file and output to file
+  -i, --info           Show file/session info
+  --vars               List all available variables
+  -g, --get <var>      Get a single variable value
+  --get-all <var>      Get all values of a variable (IBT only)
+  -s, --session <key>  Get session info by key
+  -o, --output <file>  Output file for export
+  -f, --format <fmt>   Output format: json, csv, ndjson (default: json)
+  -l, --live           Connect to live iRacing session
+
+Examples:
+  irsdk mytelemetry.ibt --info
+  irsdk mytelemetry.ibt --vars
+  irsdk mytelemetry.ibt -g Speed
+  irsdk mytelemetry.ibt --get-all Speed -o speed.json
+  irsdk mytelemetry.ibt -s WeekendInfo
+  irsdk --live -g Speed
+  irsdk --test dump.bin -g Throttle
+`);
+}
+async function main() {
+  if (values.version) {
+    console.log(`Bun iRacing SDK v${VERSION}`);
+    return;
+  }
+  if (values.help) {
+    printHelp();
+    return;
+  }
+  const ibtFile = positionals[0];
+  if (values.live) {
+    await runLive();
+    return;
+  }
+  if (ibtFile) {
+    await processIbtFile(ibtFile);
+    return;
+  }
+  if (values.test || values.dump) {
+    await runWithTestFile();
+    return;
+  }
+  printHelp();
+}
+async function runLive() {
+  const ir = createIRSDK();
+  const connected = await ir.startup(values.test, values.dump);
+  if (!connected) {
+    console.error("Failed to connect to iRacing");
+    process.exit(1);
+  }
+  console.log("Connected to iRacing");
+  if (values.vars) {
+    const names = ir.varHeaderNames;
+    if (names) {
+      console.log(`
+Available variables:`);
+      for (const name of names.sort()) {
+        console.log(`  ${name}`);
+      }
+    }
+    ir.shutdown();
+    return;
+  }
+  if (values.get) {
+    const value = ir.get(values.get);
+    console.log(`${values.get}: ${JSON.stringify(value)}`);
+    ir.shutdown();
+    return;
+  }
+  if (values.session) {
+    const info = ir.getSessionInfo(values.session);
+    console.log(JSON.stringify(info, null, 2));
+    ir.shutdown();
+    return;
+  }
+  console.log(`
+Basic telemetry:`);
+  const vars = ["Speed", "RPM", "Gear", "Throttle", "Brake", "Lap", "LapDistPct"];
+  for (const v of vars) {
+    const value = ir.get(v);
+    if (value !== null) {
+      console.log(`  ${v}: ${value}`);
+    }
+  }
+  ir.shutdown();
+}
+async function processIbtFile(filePath) {
+  console.log(`Opening ${filePath}...`);
+  const ibt = await parseIbt(filePath);
+  if (values.info) {
+    console.log(`
+File Info:`);
+    console.log(`  Records: ${ibt.recordCount}`);
+    console.log(`  Laps: ${ibt.sessionLapCount}`);
+    console.log(`  Tick Rate: ${ibt.tickRate} Hz`);
+    console.log(`  Duration: ${((ibt.sessionEndTime - ibt.sessionStartTime) / 60).toFixed(2)} minutes`);
+    console.log(`  Buffer Length: ${ibt.bufLen} bytes`);
+    const weekendInfo = ibt.getSessionInfo("WeekendInfo");
+    if (weekendInfo) {
+      console.log(`  Track: ${weekendInfo.TrackDisplayName || weekendInfo.TrackName || "Unknown"}`);
+    }
+    const driverInfo = ibt.getSessionInfo("DriverInfo");
+    if (driverInfo?.Drivers?.[0]) {
+      console.log(`  Driver: ${driverInfo.Drivers[0].UserName || "Unknown"}`);
+      console.log(`  Car: ${driverInfo.Drivers[0].CarScreenName || "Unknown"}`);
+    }
+    ibt.close();
+    return;
+  }
+  if (values.vars) {
+    const names = ibt.varHeaderNames;
+    if (names) {
+      console.log(`
+Available variables:`);
+      for (const name of names.sort()) {
+        const header = ibt.getVarHeader(name);
+        console.log(`  ${name.padEnd(30)} ${header?.unit || ""} (${header?.desc || ""})`);
+      }
+    }
+    ibt.close();
+    return;
+  }
+  if (values.get) {
+    const value = ibt.get(ibt.recordCount - 1, values.get);
+    console.log(`${values.get} (last record): ${JSON.stringify(value)}`);
+    ibt.close();
+    return;
+  }
+  if (values["get-all"]) {
+    const varName = values["get-all"];
+    console.log(`Getting all values for ${varName}...`);
+    const data = ibt.getAllTyped(varName) ?? ibt.getAll(varName);
+    if (!data) {
+      console.error(`Variable ${varName} not found`);
+      ibt.close();
+      process.exit(1);
+    }
+    const format = values.format || "json";
+    const output = values.output;
+    let content;
+    if (format === "csv") {
+      content = `index,${varName}
+` + Array.from(data).map((v, i) => `${i},${v}`).join(`
+`);
+    } else if (format === "ndjson") {
+      content = Array.from(data).map((v, i) => JSON.stringify({ index: i, [varName]: v })).join(`
+`);
+    } else {
+      content = JSON.stringify({ variable: varName, count: data.length, data: Array.from(data) }, null, 2);
+    }
+    if (output) {
+      await Bun.write(output, content);
+      console.log(`Written to ${output}`);
+    } else {
+      console.log(content);
+    }
+    ibt.close();
+    return;
+  }
+  if (values.session) {
+    const info = ibt.getSessionInfo(values.session);
+    if (info) {
+      console.log(JSON.stringify(info, null, 2));
+    } else {
+      console.error(`Session key ${values.session} not found`);
+    }
+    ibt.close();
+    return;
+  }
+  if (values.parse) {
+    console.log(`Parsing to ${values.parse}...`);
+    const output = [];
+    const rawSession = ibt.getRawSessionInfo();
+    if (rawSession) {
+      output.push(rawSession);
+      output.push(`
+--- Variables ---
+`);
+    }
+    const names = ibt.varHeaderNames?.sort() ?? [];
+    for (const name of names) {
+      const value = ibt.get(ibt.recordCount - 1, name);
+      output.push(`${name.padEnd(32)}${JSON.stringify(value)}`);
+    }
+    await Bun.write(values.parse, output.join(`
+`));
+    console.log("Done");
+    ibt.close();
+    return;
+  }
+  console.log(`
+Use --info, --vars, --get, --get-all, or --session to explore the file`);
+  ibt.close();
+}
+async function runWithTestFile() {
+  const ir = createIRSDK();
+  const connected = await ir.startup(values.test, values.dump);
+  if (!connected) {
+    console.error("Failed to initialize from test file");
+    process.exit(1);
+  }
+  if (values.dump) {
+    console.log(`Dumped to ${values.dump}`);
+  }
+  if (values.get) {
+    const value = ir.get(values.get);
+    console.log(`${values.get}: ${JSON.stringify(value)}`);
+  }
+  ir.shutdown();
+}
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/dist/constants.d.ts

@@ -0,0 +1,244 @@
+export declare const VERSION = "1.0.0";
+export declare const SIM_STATUS_URL = "http://127.0.0.1:32034/get_sim_status?object=simStatus";
+export declare const DATA_VALID_EVENT_NAME = "LocalIRSDKDataValidEvent";
+export declare const MEMMAPFILE = "LocalIRSDKMemMapFileName";
+export declare const MEMMAPFILESIZE: number;
+export declare const BROADCASTMSGNAME = "IRSDK_BROADCASTMSG";
+export declare const VAR_TYPE_SIZES: readonly [1, 1, 4, 4, 4, 8];
+export type VarType = 0 | 1 | 2 | 3 | 4 | 5;
+export declare const HEADER_SIZE = 112;
+export declare const VAR_HEADER_SIZE = 144;
+export declare const VAR_BUFFER_SIZE = 16;
+export declare const DISK_SUB_HEADER_OFFSET = 112;
+export declare const DISK_SUB_HEADER_SIZE = 32;
+export declare const YAML_CODE_PAGE = "windows-1252";
+export declare const StatusField: {
+    readonly STATUS_CONNECTED: 1;
+};
+export declare const EngineWarnings: {
+    readonly WATER_TEMP_WARNING: 1;
+    readonly FUEL_PRESSURE_WARNING: 2;
+    readonly OIL_PRESSURE_WARNING: 4;
+    readonly ENGINE_STALLED: 8;
+    readonly PIT_SPEED_LIMITER: 16;
+    readonly REV_LIMITER_ACTIVE: 32;
+    readonly OIL_TEMP_WARNING: 64;
+};
+export declare const Flags: {
+    readonly CHECKERED: 1;
+    readonly WHITE: 2;
+    readonly GREEN: 4;
+    readonly YELLOW: 8;
+    readonly RED: 16;
+    readonly BLUE: 32;
+    readonly DEBRIS: 64;
+    readonly CROSSED: 128;
+    readonly YELLOW_WAVING: 256;
+    readonly ONE_LAP_TO_GREEN: 512;
+    readonly GREEN_HELD: 1024;
+    readonly TEN_TO_GO: 2048;
+    readonly FIVE_TO_GO: 4096;
+    readonly RANDOM_WAVING: 8192;
+    readonly CAUTION: 16384;
+    readonly CAUTION_WAVING: 32768;
+    readonly BLACK: 65536;
+    readonly DISQUALIFY: 131072;
+    readonly SERVICIBLE: 262144;
+    readonly FURLED: 524288;
+    readonly REPAIR: 1048576;
+    readonly START_HIDDEN: 268435456;
+    readonly START_READY: 536870912;
+    readonly START_SET: 1073741824;
+    readonly START_GO: 2147483648;
+};
+export declare const TrkLoc: {
+    readonly NOT_IN_WORLD: -1;
+    readonly OFF_TRACK: 0;
+    readonly IN_PIT_STALL: 1;
+    readonly APPROACHING_PITS: 2;
+    readonly ON_TRACK: 3;
+};
+export declare const TrkSurf: {
+    readonly NOT_IN_WORLD: -1;
+    readonly UNDEFINED: 0;
+    readonly ASPHALT_1: 1;
+    readonly ASPHALT_2: 2;
+    readonly ASPHALT_3: 3;
+    readonly ASPHALT_4: 4;
+    readonly CONCRETE_1: 5;
+    readonly CONCRETE_2: 6;
+    readonly RACING_DIRT_1: 7;
+    readonly RACING_DIRT_2: 8;
+    readonly PAINT_1: 9;
+    readonly PAINT_2: 10;
+    readonly RUMBLE_1: 11;
+    readonly RUMBLE_2: 12;
+    readonly RUMBLE_3: 13;
+    readonly RUMBLE_4: 14;
+    readonly GRASS_1: 15;
+    readonly GRASS_2: 16;
+    readonly GRASS_3: 17;
+    readonly GRASS_4: 18;
+    readonly DIRT_1: 19;
+    readonly DIRT_2: 20;
+    readonly DIRT_3: 21;
+    readonly DIRT_4: 22;
+    readonly SAND: 23;
+    readonly GRAVEL_1: 24;
+    readonly GRAVEL_2: 25;
+    readonly GRASSCRETE: 26;
+    readonly ASTROTURF: 27;
+};
+export declare const SessionState: {
+    readonly INVALID: 0;
+    readonly GET_IN_CAR: 1;
+    readonly WARMUP: 2;
+    readonly PARADE_LAPS: 3;
+    readonly RACING: 4;
+    readonly CHECKERED: 5;
+    readonly COOL_DOWN: 6;
+};
+export declare const CameraState: {
+    readonly IS_SESSION_SCREEN: 1;
+    readonly IS_SCENIC_ACTIVE: 2;
+    readonly CAM_TOOL_ACTIVE: 4;
+    readonly UI_HIDDEN: 8;
+    readonly USE_AUTO_SHOT_SELECTION: 16;
+    readonly USE_TEMPORARY_EDITS: 32;
+    readonly USE_KEY_ACCELERATION: 64;
+    readonly USE_KEY10X_ACCELERATION: 128;
+    readonly USE_MOUSE_AIM_MODE: 256;
+};
+export declare const BroadcastMsg: {
+    readonly CAM_SWITCH_POS: 0;
+    readonly CAM_SWITCH_NUM: 1;
+    readonly CAM_SET_STATE: 2;
+    readonly REPLAY_SET_PLAY_SPEED: 3;
+    readonly REPLAY_SET_PLAY_POSITION: 4;
+    readonly REPLAY_SEARCH: 5;
+    readonly REPLAY_SET_STATE: 6;
+    readonly RELOAD_TEXTURES: 7;
+    readonly CHAT_COMMAND: 8;
+    readonly PIT_COMMAND: 9;
+    readonly TELEM_COMMAND: 10;
+    readonly FFB_COMMAND: 11;
+    readonly REPLAY_SEARCH_SESSION_TIME: 12;
+    readonly VIDEO_CAPTURE: 13;
+};
+export declare const ChatCommandMode: {
+    readonly MACRO: 0;
+    readonly BEGIN_CHAT: 1;
+    readonly REPLY: 2;
+    readonly CANCEL: 3;
+};
+export declare const PitCommandMode: {
+    readonly CLEAR: 0;
+    readonly WS: 1;
+    readonly FUEL: 2;
+    readonly LF: 3;
+    readonly RF: 4;
+    readonly LR: 5;
+    readonly RR: 6;
+    readonly CLEAR_TIRES: 7;
+    readonly FR: 8;
+    readonly CLEAR_WS: 9;
+    readonly CLEAR_FR: 10;
+    readonly CLEAR_FUEL: 11;
+};
+export declare const TelemCommandMode: {
+    readonly STOP: 0;
+    readonly START: 1;
+    readonly RESTART: 2;
+};
+export declare const RpyStateMode: {
+    readonly ERASE_TAPE: 0;
+};
+export declare const ReloadTexturesMode: {
+    readonly ALL: 0;
+    readonly CAR_IDX: 1;
+};
+export declare const RpySrchMode: {
+    readonly TO_START: 0;
+    readonly TO_END: 1;
+    readonly PREV_SESSION: 2;
+    readonly NEXT_SESSION: 3;
+    readonly PREV_LAP: 4;
+    readonly NEXT_LAP: 5;
+    readonly PREV_FRAME: 6;
+    readonly NEXT_FRAME: 7;
+    readonly PREV_INCIDENT: 8;
+    readonly NEXT_INCIDENT: 9;
+};
+export declare const RpyPosMode: {
+    readonly BEGIN: 0;
+    readonly CURRENT: 1;
+    readonly END: 2;
+};
+export declare const CsMode: {
+    readonly AT_INCIDENT: -3;
+    readonly AT_LEADER: -2;
+    readonly AT_EXCITING: -1;
+};
+export declare const PitSvFlags: {
+    readonly LF_TIRE_CHANGE: 1;
+    readonly RF_TIRE_CHANGE: 2;
+    readonly LR_TIRE_CHANGE: 4;
+    readonly RR_TIRE_CHANGE: 8;
+    readonly FUEL_FILL: 16;
+    readonly WINDSHIELD_TEAROFF: 32;
+    readonly FAST_REPAIR: 64;
+};
+export declare const PitSvStatus: {
+    readonly NONE: 0;
+    readonly IN_PROGRESS: 1;
+    readonly COMPLETE: 2;
+    readonly TOO_FAR_LEFT: 100;
+    readonly TOO_FAR_RIGHT: 101;
+    readonly TOO_FAR_FORWARD: 102;
+    readonly TOO_FAR_BACK: 103;
+    readonly BAD_ANGLE: 104;
+    readonly CANT_FIX_THAT: 105;
+};
+export declare const PaceMode: {
+    readonly SINGLE_FILE_START: 0;
+    readonly DOUBLE_FILE_START: 1;
+    readonly SINGLE_FILE_RESTART: 2;
+    readonly DOUBLE_FILE_RESTART: 3;
+    readonly NOT_PACING: 4;
+};
+export declare const PaceFlags: {
+    readonly END_OF_LINE: 1;
+    readonly FREE_PASS: 2;
+    readonly WAVED_AROUND: 4;
+};
+export declare const CarLeftRight: {
+    readonly OFF: 0;
+    readonly CLEAR: 1;
+    readonly CAR_LEFT: 2;
+    readonly CAR_RIGHT: 3;
+    readonly CAR_LEFT_RIGHT: 4;
+    readonly TWO_CARS_LEFT: 5;
+    readonly TWO_CARS_RIGHT: 6;
+};
+export declare const FFBCommandMode: {
+    readonly FFB_COMMAND_MAX_FORCE: 0;
+};
+export declare const VideoCaptureMode: {
+    readonly TRIGGER_SCREEN_SHOT: 0;
+    readonly START_VIDEO_CAPTURE: 1;
+    readonly END_VIDEO_CAPTURE: 2;
+    readonly TOGGLE_VIDEO_CAPTURE: 3;
+    readonly SHOW_VIDEO_TIMER: 4;
+    readonly HIDE_VIDEO_TIMER: 5;
+};
+export declare const TrackWetness: {
+    readonly UNKNOWN: 0;
+    readonly DRY: 1;
+    readonly MOSTLY_DRY: 2;
+    readonly VERY_LIGHTLY_WET: 3;
+    readonly LIGHTLY_WET: 4;
+    readonly MODERATELY_WET: 5;
+    readonly VERY_WET: 6;
+    readonly EXTREMELY_WET: 7;
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,eAAO,MAAM,cAAc,2DAA2D,CAAC;AACvF,eAAO,MAAM,qBAAqB,6BAA8B,CAAC;AACjE,eAAO,MAAM,UAAU,6BAA8B,CAAC;AACtD,eAAO,MAAM,cAAc,QAAc,CAAC;AAC1C,eAAO,MAAM,gBAAgB,uBAAuB,CAAC;AAErD,eAAO,MAAM,cAAc,6BAA8B,CAAC;AAC1D,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAE5C,eAAO,MAAM,WAAW,MAAM,CAAC;AAC/B,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAE7C,eAAO,MAAM,WAAW;;CAEd,CAAC;AAEX,eAAO,MAAM,cAAc;;;;;;;;CAQjB,CAAC;AAEX,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BR,CAAC;AAEX,eAAO,MAAM,MAAM;;;;;;CAMT,CAAC;AAEX,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BV,CAAC;AAEX,eAAO,MAAM,YAAY;;;;;;;;CAQf,CAAC;AAEX,eAAO,MAAM,WAAW;;;;;;;;;;CAUd,CAAC;AAEX,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;CAef,CAAC;AAEX,eAAO,MAAM,eAAe;;;;;CAKlB,CAAC;AAEX,eAAO,MAAM,cAAc;;;;;;;;;;;;;CAajB,CAAC;AAEX,eAAO,MAAM,gBAAgB;;;;CAInB,CAAC;AAEX,eAAO,MAAM,YAAY;;CAEf,CAAC;AAEX,eAAO,MAAM,kBAAkB;;;CAGrB,CAAC;AAEX,eAAO,MAAM,WAAW;;;;;;;;;;;CAWd,CAAC;AAEX,eAAO,MAAM,UAAU;;;;CAIb,CAAC;AAEX,eAAO,MAAM,MAAM;;;;CAIT,CAAC;AAEX,eAAO,MAAM,UAAU;;;;;;;;CAQb,CAAC;AAEX,eAAO,MAAM,WAAW;;;;;;;;;;CAUd,CAAC;AAEX,eAAO,MAAM,QAAQ;;;;;;CAMX,CAAC;AAEX,eAAO,MAAM,SAAS;;;;CAIZ,CAAC;AAEX,eAAO,MAAM,YAAY;;;;;;;;CAQf,CAAC;AAEX,eAAO,MAAM,cAAc;;CAEjB,CAAC;AAEX,eAAO,MAAM,gBAAgB;;;;;;;CAOnB,CAAC;AAEX,eAAO,MAAM,YAAY;;;;;;;;;CASf,CAAC"}