{
    path: "/path/to/file.osu", // the only mandatory field, everything else can be omitted
    mods: integer,             // bit value for mods, defaults to 0 (NM) see https://github.com/ppy/osu-api/wiki#mods
    acc: double,               // if neither acc nor hitresults are specified, acc defaults to 100.0
    n300: integer,             // defaults to value based on acc
    n100: integer,             // defaults to value based on acc
    n50: integer,              // defaults to value based on acc
    nMisses: integer,          // defaults to 0
    nKatu: integer,            // only relevant for osu!ctb
    combo: integer,            // defaults to full combo
    score: integer,            // only relevant for osu!mania
    passedObjects: integer,    // only consider this many hit objects; useful for failed scores; defaults to all objects
}

{
    path: "/path/to/file.osu",
    params: [
        { // everything in here is optional
            mods: integer,
            acc: double,
            n300: integer,
            n100: integer,
            n50: integer,
            nMisses: integer,
            nKatu: integer,
            combo: integer,
            score: integer,
            passedObjects: integer,
        }, ...
    ]
}

const rosu = require('rosu-pp')

let arg = {
    path: "./maps/1980365.osu",
    params: [
        {
            mods: 8 + 16, // HDHR
        }, // everything else is put on default i.e. the best possible score on HDHR
        {
            mods: 24,
            acc: 97.89,
            nMisses: 13,
            combo: 1388,
        }
    ]
}

let results = rosu.calculate(arg)

{
    mode: integer,            // O/T/C/M (0=O, 1=T, 2=C, 3=M)
    stars: double,            // O/T/C/M
    pp: double,               // O/T/C/M
    ppAcc: double,            // O/T/M
    ppAim: double,            // O
    ppFlashlight: double,     // O
    ppSpeed: double,          // O
    ppStrain: double,         // T/M
    nFruits: integer,         // C
    nDroplets: integer,       // C
    nTinyDroplets: integer,   // C
    aimStrain: double,        // O
    speedStrain: double,      // O
    flashlightRating: double, // O
    sliderFactor: double,     // O
    ar: double,               // O/T/C/M
    cs: double,               // O/T/C/M
    hp: double,               // O/T/C/M
    od: double,               // O/T/C/M
    bpm: double,              // O/T/C/M
    nCircles: integer,        // O/T/M
    nSliders: integer,        // O/T/M
    nSpinners: integer,       // O/T/C
    maxCombo: integer,        // O/T/C
}

$ npm install rosu-pp

$ npm install https://github.com/MaxOhn/rosu-pp-js