RoROdometer.as

// Base implementation of RoROdometer.
// This file is under the MIT License. See LICENSE for details.
// Copyright (C) 2026 Ezequiel M.

namespace RoROdometer
{
    const string OdometerScriptIDCVarName = "app_odometer_script_id";

    shared abstract class Odometer
    {
        double GetMainOdometer() { return 0; }
        double GetTripOdometer() { return 0; }
        void ResetTripOdometer() {}

        string GetVehicleName() { return ""; }
        string GetVehicleTruckfile() { return ""; }
        string GetVehicleConfigName() { return ""; }
    }

    shared abstract class OdometerHelper
    {
        array<string>@ GetOdometerKeys() { return null; }

        Odometer@ TryGetOdometerByKey(string odometerKey) { return null; }
        Odometer@ TryGetOdometerByActor(BeamClass@ vehicle) { return null; }

        bool TryRemoveOdometerByKey(string odometerKey) { return false; }
        bool TryRemoveOdometerByActor(BeamClass@ vehicle) { return false; }
    }

    string ValidateVariableName(string varName)
    {
        for (uint i = 0; i < varName.length(); i++)
        {
            uint8 character = varName[i];
            bool isNumeric = character >= 48 && character <= 57;
            bool isAlpha = (character >= 65 && character <= 90) || (character >= 97 && character <= 122);
            if (!isNumeric && !isAlpha)
                varName[i] = 95; // _ char
        }
        
        return varName;
    }

    string GetVehicleID(BeamClass@ vehicle)
    {
        string vehicleID = vehicle.getTruckFileName();
        if (vehicle.getSectionConfig() != "")
            vehicleID += "_" + vehicle.getSectionConfig();

        return ValidateVariableName(vehicleID);
    }

    OdometerHelper@ GetOdometerHelper()
    {
        OdometerHelper@ reader = null;
        CVarClass@ odometerScriptIDCVar = console.cVarFind(OdometerScriptIDCVarName);
        if (@odometerScriptIDCVar != null && odometerScriptIDCVar.getStr() != "")
        {
            int odometerScriptID = parseInt(odometerScriptIDCVar.getStr());
            ScriptRetCode result = game.getScriptVariable("OdometerHelper", @reader, odometerScriptID);
            if (result != 0)
                @reader = null;
        }
        
        return reader;
    }
}