@fboes/aerofly-custom-missions 1.2.2 → 1.3.0

package/src/index.ts

@@ -1,1099 +1,7 @@
-const feetPerMeter = 3.28084;
-const meterPerStatuteMile = 1609.344;
-
-/**
- * Represents origin or destination conditions for flight
- * @property icao uppercase ICAO airport ID
- * @property longitude easting, using the World Geodetic
- *    System 1984 (WGS 84) [WGS84] datum, with longitude and latitude units
- *    of decimal degrees; -180..180
- * @property latitude northing, using the World Geodetic
- *    System 1984 (WGS 84) [WGS84] datum, with longitude and latitude units
- *    of decimal degrees; -90..90
- * @property dir in degree
- * @property alt the height in meters above or below the WGS
- *    84 reference ellipsoid
- */
-export type AeroflyMissionPosition = {
-    icao: string;
-    longitude: number;
-    latitude: number;
-    dir: number;
-    alt: number;
-};
-
-/**
- * State of aircraft systems. Configures power settings, flap positions etc
- */
-export type AeroflyMissionSetting =
-    | "cold_and_dark"
-    | "before_start"
-    | "taxi"
-    | "takeoff"
-    | "cruise"
-    | "approach"
-    | "landing"
-    | "winch_launch"
-    | "aerotow"
-    | "pushback";
-
-/**
- * Types of checkpoints. Required are usually "origin", "departure_runway" at the start and "destination_runway", "destination" at the end.
- */
-export type AeroflyMissionCheckpointType =
-    | "origin"
-    | "departure_runway"
-    | "departure"
-    | "waypoint"
-    | "arrival"
-    | "approach"
-    | "destination_runway"
-    | "destination";
-
-/**
- * Data for the aircraft to use on this mission
- * @property name lowercase Aerofly aircraft ID
- * @property icao ICAO aircraft code
- * @property livery (not used yet)
- */
-export type AeroflyMissionAircraft = {
-    name: string;
-    icao: string;
-    livery: string;
-};
-
-/**
- * Weather data for wind
- * @property direction in degree
- * @property speed in kts
- * @property gusts in kts
- */
-export type AeroflyMissionConditionsWind = {
-    direction: number;
-    speed: number;
-    gusts: number;
-};
-
-/**
- * Cloud coverage codes
- */
-export type AeroflyMissionConditionsCloudCoverCode = "CLR" | "FEW" | "SCT" | "BKN" | "OVC";
-
-export class AeroflyConfigFileSet {
-    #indent: number;
-    elements: string[];
-
-    constructor(indent: number, type: string, name: string, value: string = "") {
-        this.#indent = indent;
-        this.elements = [`${this.indent}<[${type}][${name}][${value}]`];
-    }
-
-    get indent(): string {
-        return "    ".repeat(this.#indent);
-    }
-
-    push(type: string, name: string, value: string | number | string[] | number[] | boolean, comment: string = "") {
-        if (value instanceof Array) {
-            value = value.join(" ");
-        } else if (typeof value === "boolean") {
-            value = value ? "true" : "false";
-        }
-        let tag = `${this.indent}    <[${type}][${name}][${value}]>`;
-        if (comment) {
-            tag += ` // ${comment}`;
-        }
-        return this.pushRaw(tag);
-    }
-
-    pushRaw(s: string) {
-        this.elements.push(s);
-        return this;
-    }
-
-    toString() {
-        return this.elements.join("\n") + "\n" + `${this.indent}>`;
-    }
-}
-
-/**
- * @class
- * A list of flight plans.
- *
- * The purpose of this class is to collect data needed for Aerofly FS4's
- * `custom_missions_user.tmc` flight plan file format, and export the structure
- * for this file via the `toString()` method.
- */
-export class AeroflyMissionsList {
-    /**
-     * @property {AeroflyMission[]} missions in this mission list
-     */
-    missions: AeroflyMission[];
-
-    /**
-     * @param {AeroflyMission[]} missions in this mission list
-     */
-    constructor(missions: AeroflyMission[] = []) {
-        this.missions = missions;
-    }
-
-    /**
-     * @returns {string} to use in Aerofly FS4's `custom_missions_user.tmc`
-     */
-    toString(): string {
-        const separator = "\n// -----------------------------------------------------------------------------\n";
-        return `\
-<[file][][]
-    <[tmmissions_list][][]
-        <[list_tmmission_definition][missions][]${separator + this.missions.join(separator) + separator}        >
-    >
->`;
-    }
-}
-
-/**
- * @class
- * A single flighplan, containing aircraft and weather data as well.
- *
- * The purpose of this class is to collect data needed for Aerofly FS4's
- * `custom_missions_user.tmc` flight plan file format, and export the structure
- * for this file via the `toString()` method.
- */
-export class AeroflyMission {
-    /**
-     * @property {?string} tutorialName will create a link to a tutorial page at https://www.aerofly.com/aircraft-tutorials/
-     */
-    tutorialName: string | null;
-
-    /**
-     * @property {string} title of this flight plan
-     */
-    title: string;
-
-    /**
-     * @property {string} description text, mission briefing, etc
-     */
-    description: string;
-
-    /**
-     * @property {AeroflyLocalizedText[]} localizedTexts for title and description
-     */
-    localizedTexts: AeroflyLocalizedText[];
-
-    /**
-     * @property {string[]} tags
-     */
-    tags: string[];
-
-    /**
-     * @property {?boolean} isFeatured makes this mission pop up in "Challenges"
-     */
-    isFeatured: boolean | null;
-
-    /**
-     * @property {?number} difficulty values between 0.00 and 2.00 have been encountered, but they seem to be without limit
-     */
-    difficulty: number | null;
-
-    /**
-     * @property {"cold_and_dark"|"before_start"|"taxi"|"takeoff"|"cruise"|"approach"|"landing"|"winch_launch"|"aerotow"|"pushback"} flightSetting of aircraft, like "taxi", "cruise"
-     */
-    flightSetting: AeroflyMissionSetting;
-
-    /**
-     * @property {object} aircraft for this mission
-     */
-    aircraft: AeroflyMissionAircraft;
-
-    /**
-     * @property {string} callsign of aircraft, uppercased
-     */
-    callsign: string;
-
-    /**
-     * @property {object} origin position of aircraft, as well as name of starting airport. Position does not have match airport.
-     */
-    origin: AeroflyMissionPosition;
-
-    /**
-     * @property {object} destination position of aircraft, as well as name of destination airport. Position does not have match airport.
-     */
-    destination: AeroflyMissionPosition;
-
-    /**
-     * @property {?number} distance in meters
-     */
-    distance: number | null;
-
-    /**
-     * @property {?number} duration in seconds
-     */
-    duration: number | null;
-
-    /**
-     * @property {?boolean} isScheduled marks this flight as "Scheduled flight".
-     */
-    isScheduled: boolean | null;
-
-    /**
-     * @property {?AeroflyMissionTargetPlane} finish as finish condition
-     */
-    finish: AeroflyMissionTargetPlane | null;
-
-    /**
-     * @property {AeroflyMissionConditions} conditions like time and weather for mission
-     */
-    conditions: AeroflyMissionConditions;
-
-    /**
-     * @property {AeroflyMissionConditions} checkpoints form the actual flight plan
-     */
-    checkpoints: AeroflyMissionCheckpoint[];
-
-    /**
-     * @param {string} title of this flight plan
-     * @param {object} [additionalAttributes] allows to set additional attributes on creation
-     * @param {string} [additionalAttributes.description] text, mission briefing, etc
-     * @param {AeroflyLocalizedText[]} [additionalAttributes.localizedTexts] translations for title and description
-     * @param {?string} [additionalAttributes.tutorialName] will create a link to a tutorial page at https://www.aerofly.com/aircraft-tutorials/
-     * @param {string[]} [additionalAttributes.tags]
-     * @param {?boolean} [additionalAttributes.isFeatured] makes this mission pop up in "Challenges"
-     * @param {?number} [additionalAttributes.difficulty] values between 0.00 and 2.00 have been encountered, but they seem to be without limit
-     * @param {"cold_and_dark"|"before_start"|"taxi"|"takeoff"|"cruise"|"approach"|"landing"|"winch_launch"|"aerotow"|"pushback"} [additionalAttributes.flightSetting] of aircraft, like "taxi", "cruise"
-     * @param {{name:string,livery:string,icao:string}} [additionalAttributes.aircraft] for this mission
-     * @param {string} [additionalAttributes.callsign] of aircraft, uppercased
-     * @param {object} [additionalAttributes.origin] position of aircraft, as well as name of starting airport. Position does not have match airport.
-     * @param {object} [additionalAttributes.destination] position of aircraft, as well as name of destination airport. Position does not have match airport.
-     * @param {?number} [additionalAttributes.distance] in meters
-     * @param {?number} [additionalAttributes.duration] in seconds
-     * @param {?boolean} [additionalAttributes.isScheduled] marks this flight as "Scheduled flight".
-     * @param {?AeroflyMissionTargetPlane} [additionalAttributes.finish] as finish condition
-     * @param {AeroflyMissionConditions} [additionalAttributes.conditions] like time and weather for mission
-     * @param {AeroflyMissionCheckpoint[]} [additionalAttributes.checkpoints] form the actual flight plan
-     */
-    constructor(
-        title: string,
-        {
-            tutorialName = null,
-            description = "",
-            localizedTexts = [],
-            tags = [],
-            isFeatured = null,
-            difficulty = null,
-            flightSetting = "taxi",
-            aircraft = {
-                name: "c172",
-                icao: "",
-                livery: "",
-            },
-            callsign = "",
-            origin = {
-                icao: "",
-                longitude: 0,
-                latitude: 0,
-                dir: 0,
-                alt: 0,
-            },
-            destination = {
-                icao: "",
-                longitude: 0,
-                latitude: 0,
-                dir: 0,
-                alt: 0,
-            },
-            distance = null,
-            duration = null,
-            isScheduled = null,
-            finish = null,
-            conditions = new AeroflyMissionConditions(),
-            checkpoints = [],
-        }: {
-            tutorialName?: string | null;
-            description?: string;
-            localizedTexts?: AeroflyLocalizedText[];
-            tags?: string[];
-            isFeatured?: boolean | null;
-            difficulty?: number | null;
-            flightSetting?: AeroflyMissionSetting;
-            aircraft?: AeroflyMissionAircraft;
-            callsign?: string;
-            origin?: AeroflyMissionPosition;
-            destination?: AeroflyMissionPosition;
-            distance?: number | null;
-            duration?: number | null;
-            isScheduled?: boolean | null;
-            finish?: AeroflyMissionTargetPlane | null;
-            conditions?: AeroflyMissionConditions;
-            checkpoints?: AeroflyMissionCheckpoint[];
-        } = {},
-    ) {
-        this.tutorialName = tutorialName;
-        this.title = title;
-        this.checkpoints = checkpoints;
-        this.description = description;
-        this.localizedTexts = localizedTexts;
-        this.tags = tags;
-        this.isFeatured = isFeatured;
-        this.difficulty = difficulty;
-        this.flightSetting = flightSetting;
-        this.aircraft = aircraft;
-        this.callsign = callsign;
-        this.origin = origin;
-        this.destination = destination;
-        this.distance = distance;
-        this.duration = duration;
-        this.isScheduled = isScheduled;
-        this.finish = finish;
-        this.conditions = conditions;
-    }
-
-    /**
-     * @returns {string} indexed checkpoints
-     */
-    getCheckpointsString(): string {
-        return this.checkpoints
-            .map((c: AeroflyMissionCheckpoint, index: number): string => {
-                return c.toString(index);
-            })
-            .join("\n");
-    }
-
-    /**
-     * @returns {string} indexed checkpoints
-     */
-    getLocalizedTextsString(): string {
-        return this.localizedTexts
-            .map((c: AeroflyLocalizedText, index: number): string => {
-                return c.toString(index);
-            })
-            .join("\n");
-    }
-
-    /**
-     * @throws {Error} on missing waypoints
-     * @returns {string} to use in Aerofly FS4's `custom_missions_user.tmc`
-     */
-    toString(): string {
-        if (!this.origin.icao) {
-            const firstCheckpoint = this.checkpoints[0];
-            this.origin = {
-                icao: firstCheckpoint.name,
-                longitude: firstCheckpoint.longitude,
-                latitude: firstCheckpoint.latitude,
-                dir: this.origin.dir,
-                alt: firstCheckpoint.altitude,
-            };
-        }
-
-        if (!this.destination.icao) {
-            const lastCheckpoint = this.checkpoints[this.checkpoints.length - 1];
-            this.destination = {
-                icao: lastCheckpoint.name,
-                longitude: lastCheckpoint.longitude,
-                latitude: lastCheckpoint.latitude,
-                dir: lastCheckpoint.direction ?? 0,
-                alt: lastCheckpoint.altitude,
-            };
-        }
-
-        const fileSet = new AeroflyConfigFileSet(3, "tmmission_definition", "mission");
-        fileSet.push("string8", "title", this.title);
-        fileSet.push("string8", "description", this.description);
-
-        if (this.tutorialName !== null) {
-            fileSet.push(
-                "string8",
-                "tutorial_name",
-                this.tutorialName,
-                `Opens https://www.aerofly.com/aircraft-tutorials/${this.tutorialName}`,
-            );
-        }
-        if (this.localizedTexts.length > 0) {
-            fileSet.pushRaw(
-                new AeroflyConfigFileSet(4, "list_tmmission_definition_localized", "localized_text")
-                    .pushRaw(this.getLocalizedTextsString())
-                    .toString(),
-            );
-        }
-        if (this.tags.length > 0) {
-            fileSet.push("string8u", "tags", this.tags.join(" "));
-        }
-        if (this.difficulty !== null) {
-            fileSet.push("float64", "difficulty", this.difficulty);
-        }
-        if (this.isFeatured !== null) {
-            fileSet.push("bool", "is_featured", this.isFeatured);
-        }
-
-        fileSet.push("string8", "flight_setting", this.flightSetting);
-        fileSet.push("string8u", "aircraft_name", this.aircraft.name);
-        /*if (this.aircraft.livery) {
-            fileSet.push("string8", "aircraft_livery", this.aircraft.livery);
-        }*/
-        fileSet.push("stringt8c", "aircraft_icao", this.aircraft.icao);
-        fileSet.push("stringt8c", "callsign", this.callsign);
-        fileSet.push("stringt8c", "origin_icao", this.origin.icao);
-        fileSet.push("tmvector2d", "origin_lon_lat", [this.origin.longitude, this.origin.latitude]);
-        fileSet.push("float64", "origin_alt", this.origin.alt, `${Math.ceil(this.origin.alt * feetPerMeter)} ft MSL`);
-        fileSet.push("float64", "origin_dir", this.origin.dir);
-        fileSet.push("stringt8c", "destination_icao", this.destination.icao);
-        fileSet.push("tmvector2d", "destination_lon_lat", [this.destination.longitude, this.destination.latitude]);
-        fileSet.push(
-            "float64",
-            "destination_alt",
-            this.destination.alt,
-            `${Math.ceil(this.destination.alt * feetPerMeter)} ft MSL`,
-        );
-        fileSet.push("float64", "destination_dir", this.destination.dir);
-
-        if (this.distance !== null) {
-            fileSet.push("float64", "distance", this.distance, `${Math.round(this.distance / 1000)} km`);
-        }
-        if (this.duration !== null) {
-            fileSet.push("float64", "duration", this.duration, `${Math.round(this.duration / 60)} min`);
-        }
-        if (this.isScheduled !== null) {
-            fileSet.push("bool", "is_scheduled", this.isScheduled ? "true" : "false");
-        }
-        if (this.finish !== null) {
-            fileSet.pushRaw(this.finish.toString());
-        }
-
-        fileSet.pushRaw(this.conditions.toString());
-        if (this.checkpoints.length > 0) {
-            fileSet.pushRaw(
-                new AeroflyConfigFileSet(4, "list_tmmission_checkpoint", "checkpoints")
-                    .pushRaw(this.getCheckpointsString())
-                    .toString(),
-            );
-        }
-
-        return fileSet.toString();
-    }
-}
-
-/**
- * @class
- * Time and weather data for the given flight plan
- *
- * The purpose of this class is to collect data needed for Aerofly FS4's
- * `custom_missions_user.tmc` flight plan file format, and export the structure
- * for this file via the `toString()` method.
- */
-export class AeroflyMissionConditions {
-    /**
-     * @property {Date} time of flight plan. Relevant is the UTC part, so
-     *    consider setting this date in UTC.
-     */
-    time: Date;
-
-    /**
-     * @property {object} wind state
-     */
-    wind: AeroflyMissionConditionsWind;
-
-    /**
-     * @property {number} 0..1, percentage
-     */
-    turbulenceStrength: number;
-
-    /**
-     * @property {number} 0..1, percentage
-     */
-    thermalStrength: number;
-
-    /**
-     * @property {number} visibility in meters
-     */
-    visibility: number;
-
-    /**
-     * @property {AeroflyMissionConditionsCloud[]} clouds for the whole flight
-     */
-    clouds: AeroflyMissionConditionsCloud[] = [];
-
-    /**
-     * @param {object} additionalAttributes allows to set additional attributes on creation
-     * @param {Date} [additionalAttributes.time]  of flight plan. Relevant is the UTC part, so
-     *    consider setting this date in UTC.
-     * @param {{direction: number, speed: number, gusts: number}} [additionalAttributes.wind] state
-     * @param {number} [additionalAttributes.turbulenceStrength] 0..1, percentage
-     * @param {number} [additionalAttributes.thermalStrength] 0..1, percentage
-     * @param {number} [additionalAttributes.visibility] in meters
-     * @param {?number} [additionalAttributes.visibility_sm] in statute miles, will overwrite visibility
-     * @param {?number} [additionalAttributes.temperature] in °C, will overwrite thermalStrength
-     * @param {AeroflyMissionConditionsCloud[]} [additionalAttributes.clouds] for the whole flight
-     */
-    constructor({
-        time = new Date(),
-        wind = {
-            direction: 0,
-            speed: 0,
-            gusts: 0,
-        },
-        turbulenceStrength = 0,
-        thermalStrength = 0,
-        visibility = 25_000,
-        visibility_sm = null,
-        temperature = null,
-        clouds = [],
-    }: {
-        time?: Date;
-        wind?: {
-            direction: number;
-            speed: number;
-            gusts: number;
-        };
-        turbulenceStrength?: number;
-        thermalStrength?: number;
-        visibility?: number;
-        visibility_sm?: number | null;
-        temperature?: number | null;
-        clouds?: AeroflyMissionConditionsCloud[];
-    } = {}) {
-        this.time = time;
-        this.wind = wind;
-        this.turbulenceStrength = turbulenceStrength;
-        this.thermalStrength = thermalStrength;
-        this.visibility = visibility;
-        this.clouds = clouds;
-
-        if (visibility_sm) {
-            this.visibility_sm = visibility_sm;
-        }
-        if (temperature) {
-            this.temperature = temperature;
-        }
-    }
-
-    /**
-     * @returns {number} the Aerofly value for UTC hours + minutes/60 + seconds/3600. Ignores milliseconds ;)
-     */
-    get time_hours(): number {
-        return this.time.getUTCHours() + this.time.getUTCMinutes() / 60 + this.time.getUTCSeconds() / 3600;
-    }
-
-    /**
-     * @returns {string} Time representation like "20:15:00"
-     */
-    get time_presentational(): string {
-        return [this.time.getUTCHours(), this.time.getUTCMinutes(), this.time.getUTCSeconds()]
-            .map((t) => {
-                return String(t).padStart(2, "0");
-            })
-            .join(":");
-    }
-
-    /**
-     * @param {number} visibility_sm `this.visibility` in statute miles instead of meters
-     */
-    set visibility_sm(visibility_sm: number) {
-        this.visibility = visibility_sm * meterPerStatuteMile;
-    }
-
-    /**
-     * @returns {number} `this.visibility` in statute miles instead of meters
-     */
-    get visibility_sm(): number {
-        return this.visibility / meterPerStatuteMile;
-    }
-
-    /**
-     * Will set `this.thermalStrength`
-     * @param {number} temperature in °C
-     */
-    set temperature(temperature: number) {
-        // Range from -15°C to 35°C
-        this.thermalStrength = Math.max(0, (temperature + 15) / 50) ** 2;
-    }
-
-    /**
-     * @returns {number} in °C
-     */
-    get temperature(): number {
-        return Math.sqrt(this.thermalStrength) * 50 - 15;
-    }
-
-    /**
-     * @returns {string}
-     */
-    getCloudsString(): string {
-        return this.clouds
-            .map((c: AeroflyMissionConditionsCloud, index: number): string => {
-                return c.toString(index);
-            })
-            .join("\n");
-    }
-
-    /**
-     * @returns {string} to use in Aerofly FS4's `custom_missions_user.tmc`
-     */
-    toString(): string {
-        if (this.clouds.length < 1) {
-            this.clouds = [new AeroflyMissionConditionsCloud(0, 0)];
-        }
-
-        return new AeroflyConfigFileSet(4, "tmmission_conditions", "conditions")
-            .pushRaw(
-                new AeroflyConfigFileSet(5, "tm_time_utc", "time")
-                    .push("int32", "time_year", this.time.getUTCFullYear())
-                    .push("int32", "time_month", this.time.getUTCMonth() + 1)
-                    .push("int32", "time_day", this.time.getUTCDate())
-                    .push("float64", "time_hours", this.time_hours, `${this.time_presentational} UTC`)
-                    .toString(),
-            )
-            .push("float64", "wind_direction", this.wind.direction)
-            .push("float64", "wind_speed", this.wind.speed, "kts")
-            .push("float64", "wind_gusts", this.wind.gusts, "kts")
-            .push("float64", "turbulence_strength", this.turbulenceStrength)
-            .push("float64", "thermal_strength", this.thermalStrength, `${this.temperature} °C`)
-            .push("float64", "visibility", this.visibility, `${this.visibility_sm} SM`)
-            .pushRaw(this.getCloudsString())
-            .toString();
-    }
-}
-
-/**
- * @class
- * A cloud layer for the current flight plan's weather data
- *
- * The purpose of this class is to collect data needed for Aerofly FS4's
- * `custom_missions_user.tmc` flight plan file format, and export the structure
- * for this file via the `toString()` method.
- */
-export class AeroflyMissionConditionsCloud {
-    /**
-     * @property {number} cover 0..1, percentage
-     */
-    cover: number;
-
-    /**
-     * @property {number} base altitude in meters AGL
-     */
-    base: number;
-
-    /**
-     * @param {number} cover 0..1, percentage
-     * @param {number} base altitude in meters AGL
-     */
-    constructor(cover: number, base: number) {
-        this.cover = cover;
-        this.base = base;
-    }
-
-    /**
-     * @param {number} cover 0..1, percentage
-     * @param {number} base_feet altitude, but in feet AGL instead of meters AGL
-     * @returns {AeroflyMissionConditionsCloud}
-     */
-    static createInFeet(cover: number, base_feet: number): AeroflyMissionConditionsCloud {
-        return new AeroflyMissionConditionsCloud(cover, base_feet / feetPerMeter);
-    }
-
-    /**
-     * @param {number} base_feet `this.base` in feet instead of meters
-     */
-    set base_feet(base_feet: number) {
-        this.base = base_feet / feetPerMeter;
-    }
-
-    /**
-     * @returns {number} `this.base` in feet instead of meters
-     */
-    get base_feet(): number {
-        return this.base * feetPerMeter;
-    }
-
-    /**
-     * @returns {string} Cloud coverage as text representation like "OVC" for `this.cover`
-     */
-    get cover_code(): AeroflyMissionConditionsCloudCoverCode {
-        if (this.cover < 1 / 8) {
-            return "CLR";
-        } else if (this.cover <= 2 / 8) {
-            return "FEW";
-        } else if (this.cover <= 4 / 8) {
-            return "SCT";
-        } else if (this.cover <= 7 / 8) {
-            return "BKN";
-        }
-        return "OVC";
-    }
-
-    /**
-     * @param {number} index if used in an array will se the array index
-     * @returns {string} to use in Aerofly FS4's `custom_missions_user.tmc`
-     */
-    toString(index: number = 0): string {
-        const getIndexString = (index: number) => {
-            switch (index) {
-                case 0:
-                    return "cloud";
-                case 1:
-                    return "cirrus";
-                case 2:
-                    return "cumulus_mediocris";
-                default:
-                    return "more_clouds";
-            }
-        };
-
-        const indexString = getIndexString(index);
-        const comment = index > 1 ? '//' : '';
-
-        return `\
-                    ${comment}<[float64][${indexString}_cover][${this.cover ?? 0}]> // ${this.cover_code}
-                    ${comment}<[float64][${indexString}_base][${this.base}]> // ${this.base_feet} ft AGL`;
-    }
-}
-
-/**
- * @class
- * A single way point for the given flight plan
- *
- * The purpose of this class is to collect data needed for Aerofly FS4's
- * `custom_missions_user.tmc` flight plan file format, and export the structure
- * for this file via the `toString()` method.
- */
-export class AeroflyMissionCheckpoint {
-    /**
-     * @property {"origin"|"departure_runway"|"departure"|"waypoint"|"arrival"|"approach"|"destination_runway"|"destination"} type of checkpoint, like "departure_runway"
-     */
-    type: AeroflyMissionCheckpointType;
-
-    /**
-     * @property {string} name ICAO code for airport, runway designator, navaid
-     *    designator, fix name, or custom name
-     */
-    name: string;
-
-    /**
-     * @property {number} longitude easting, using the World Geodetic
-     *    System 1984 (WGS 84) [WGS84] datum, with longitude and latitude units
-     *    of decimal degrees; -180..180
-     */
-    longitude: number;
-
-    /**
-     * @property {number} latitude northing, using the World Geodetic
-     *    System 1984 (WGS 84) [WGS84] datum, with longitude and latitude units
-     *    of decimal degrees; -90..90
-     */
-    latitude: number;
-
-    /**
-     * @property {number} altitude The height in meters above or below the WGS
-     *    84 reference ellipsoid
-     */
-    altitude: number;
-
-    /**
-     * @property {?boolean} altitudeConstraint The altitude given in `altitude`
-     *    will be interpreted as mandatory flight plan altitude instead of
-     *    suggestion.
-     */
-    altitudeConstraint: boolean | null;
-
-    /**
-     * @property {?number} direction of runway, in degree
-     */
-    direction: number | null;
-
-    /**
-     * @property {?number} slope of runway
-     */
-    slope: number | null;
-
-    /**
-     * @property {?number} length of runway, in meters
-     */
-    length: number | null;
-
-    /**
-     * @property {?number} frequency of runways or navigational aids, in Hz; multiply by 1000 for kHz, 1_000_000 for MHz
-     */
-    frequency: number | null;
-
-    /**
-     * @property {?boolean} flyOver if waypoint is meant to be flown over
-     */
-    flyOver: boolean | null;
-
-    /**
-     * @param {string} name ICAO code for airport, runway designator, navaid
-     *    designator, fix name, or custom name
-     * @param {"origin"|"departure_runway"|"departure"|"waypoint"|"arrival"|"approach"|"destination_runway"|"destination"} type Type of checkpoint, like "departure_runway"
-     * @param {number} longitude easting, using the World Geodetic
-     *    System 1984 (WGS 84) [WGS84] datum, with longitude and latitude units
-     *    of decimal degrees; -180..180
-     * @param {number} latitude northing, using the World Geodetic
-     *    System 1984 (WGS 84) [WGS84] datum, with longitude and latitude units
-     *    of decimal degrees; -90..90
-     * @param {object} additionalAttributes allows to set additional attributes on creation
-     * @param {number} [additionalAttributes.altitude] The height in meters above or below the WGS
-     *    84 reference ellipsoid
-     * @param {?number} [additionalAttributes.altitude_feet] The height in feet above or below the WGS
-     *    84 reference ellipsoid. Will overwrite altitude
-     * @param {number} [additionalAttributes.altitudeConstraint] The altitude given in `altitude`
-     *    will be interpreted as mandatory flight plan altitude instead of
-     *    suggestion.
-     * @param {boolean} [additionalAttributes.direction] of runway, in degree
-     * @param {?number} [additionalAttributes.slope] of runway
-     * @param {?number} [additionalAttributes.length] of runway, in meters
-     * @param {?number} [additionalAttributes.length_feet] of runway, in feet. Will overwrite length
-     * @param {?number} [additionalAttributes.frequency] of runways or navigational aids, in Hz; multiply by 1000 for kHz, 1_000_000 for MHz
-     * @param {?boolean} [additionalAttributes.flyOver] if waypoint is meant to be flown over
-     */
-    constructor(
-        name: string,
-        type: AeroflyMissionCheckpointType,
-        longitude: number,
-        latitude: number,
-        {
-            altitude = 0,
-            altitude_feet = null,
-            altitudeConstraint = null,
-            direction = null,
-            slope = null,
-            length = null,
-            length_feet = null,
-            frequency = null,
-            flyOver = null,
-        }: {
-            altitude?: number;
-            altitude_feet?: number | null;
-            altitudeConstraint?: boolean | null;
-            direction?: number | null;
-            slope?: number | null;
-            length?: number | null;
-            length_feet?: number | null;
-            frequency?: number | null;
-            flyOver?: boolean | null;
-        } = {},
-    ) {
-        this.type = type;
-        this.name = name;
-        this.longitude = longitude;
-        this.latitude = latitude;
-        this.altitude = altitude;
-        this.altitudeConstraint = altitudeConstraint;
-        this.direction = direction;
-        this.slope = slope;
-        this.length = length;
-        this.frequency = frequency;
-        this.flyOver = flyOver;
-
-        if (altitude_feet) {
-            this.altitude_feet = altitude_feet;
-        }
-        if (length_feet) {
-            this.length_feet = length_feet;
-        }
-    }
-
-    /**
-     * @param {number} altitude_feet
-     */
-    set altitude_feet(altitude_feet: number) {
-        this.altitude = altitude_feet / feetPerMeter;
-    }
-
-    /**
-     * @returns {number} altitude_feet
-     */
-    get altitude_feet(): number {
-        return this.altitude * feetPerMeter;
-    }
-
-    /**
-     * @param {number} length_feet
-     */
-    set length_feet(length_feet: number) {
-        this.length = length_feet / feetPerMeter;
-    }
-
-    /**
-     * @returns {number} length_feet
-     */
-    get length_feet(): number {
-        return (this.length ?? 0) * feetPerMeter;
-    }
-
-    /**
-     * @returns {string}
-     */
-    get frequency_string(): string {
-        if (!this.frequency) {
-            return "None";
-        }
-        if (this.frequency > 1_000_000) {
-            return String(this.frequency / 1_000_000) + " MHz";
-        }
-        if (this.frequency > 1_000) {
-            return String(this.frequency / 1_000) + " kHz";
-        }
-
-        return String(this.frequency) + " Hz";
-    }
-
-    /**
-     * @param {number} index if used in an array will se the array index
-     * @returns {string} to use in Aerofly FS4's `custom_missions_user.tmc`
-     */
-    toString(index: number = 0): string {
-        const fileSet = new AeroflyConfigFileSet(5, "tmmission_checkpoint", "element", String(index))
-            .push("string8u", "type", this.type)
-            .push("string8u", "name", this.name)
-            .push("vector2_float64", "lon_lat", [this.longitude, this.latitude])
-            .push("float64", "altitude", this.altitude, `${Math.ceil(this.altitude_feet)} ft`)
-            .push("float64", "direction", this.direction ?? (index === 0 ? -1 : 0))
-            .push("float64", "slope", this.slope ?? 0);
-
-        if (this.altitudeConstraint !== null) {
-            fileSet.push("bool", "alt_cst", this.altitudeConstraint);
-        }
-        if (this.length) {
-            fileSet.push("float64", "length", this.length ?? 0, `${Math.floor(this.length_feet)} ft`);
-        }
-        if (this.frequency) {
-            fileSet.push("float64", "frequency", this.frequency ?? 0, `${this.frequency_string}`);
-        }
-        if (this.flyOver !== null) {
-            fileSet.push("bool", "fly_over", this.flyOver);
-        }
-
-        return fileSet.toString();
-    }
-}
-
-/**
- * @class
- * A translation for the mission title and description.
- */
-export class AeroflyLocalizedText {
-    /**
-     * @property {string} language ISO 639-1 like
-     * - br
-     * - cn
-     * - de
-     * - es
-     * - fr
-     * - id
-     * - it
-     * - jp
-     * - kr
-     * - pl
-     * - sv
-     * - tr
-     */
-    language: string;
-
-    /**
-     * @property {string} title of this flight plan
-     */
-    title: string;
-
-    /**
-     * @property {string} description text, mission briefing, etc
-     */
-    description: string;
-
-    /**
-     * @param {string} language ISO 639-1 like
-     * - br
-     * - cn
-     * - de
-     * - es
-     * - fr
-     * - id
-     * - it
-     * - jp
-     * - kr
-     * - pl
-     * - sv
-     * - tr
-     * @param {string} title of this flight plan
-     * @param {string} description text, mission briefing, etc
-     */
-    constructor(language: string, title: string, description: string) {
-        this.language = language;
-        this.title = title;
-        this.description = description;
-    }
-
-    /**
-     * @param {number} index if used in an array will se the array index
-     * @returns {string} to use in Aerofly FS4's `custom_missions_user.tmc`
-     */
-    toString(index: number = 0): string {
-        return new AeroflyConfigFileSet(4, "tmmission_definition_localized", "element", String(index))
-            .push("string8u", "language", this.language)
-            .push("string8", "title", this.title)
-            .push("string8", "description", this.description)
-            .toString();
-    }
-}
-
-/**
- * @class
- * A target plane which the aircraft needs to cross.
- */
-export class AeroflyMissionTargetPlane {
-    /**
-     * @property {number} longitude easting, using the World Geodetic
-     *    System 1984 (WGS 84) [WGS84] datum, with longitude and latitude units
-     *    of decimal degrees; -180..180
-     */
-    longitude: number;
-
-    /**
-     * @property {number} latitude northing, using the World Geodetic
-     *    System 1984 (WGS 84) [WGS84] datum, with longitude and latitude units
-     *    of decimal degrees; -90..90
-     */
-    latitude: number;
-
-    /**
-     * @property {number} dir in degree
-     */
-    dir: number;
-
-    /**
-     * @property {string} name of property
-     */
-    name: string;
-
-    /**
-     *
-     * @param {number} longitude easting, using the World Geodetic
-     *    System 1984 (WGS 84) [WGS84] datum, with longitude and latitude units
-     *    of decimal degrees; -180..180
-     * @param {number}latitude northing, using the World Geodetic
-     *    System 1984 (WGS 84) [WGS84] datum, with longitude and latitude units
-     *    of decimal degrees; -90..90
-     * @param {number} dir in degree
-     * @param {string} name of property
-     */
-    constructor(longitude: number, latitude: number, dir: number, name: string = "finish") {
-        this.longitude = longitude;
-        this.latitude = latitude;
-        this.dir = dir;
-        this.name = name;
-    }
-
-    toString(): string {
-        return new AeroflyConfigFileSet(4, "tmmission_target_plane", this.name)
-            .push("vector2_float64", "lon_lat", [this.longitude, this.latitude])
-            .push("float64", "direction", this.dir)
-            .toString();
-    }
-}
-
-export default {
-    AeroflyMissionsList,
-    AeroflyMission,
-    AeroflyMissionConditions,
-    AeroflyMissionConditionsCloud,
-    AeroflyMissionCheckpoint,
-    AeroflyLocalizedText,
-    AeroflyMissionTargetPlane,
-};
+export { AeroflyLocalizedText } from "./dto/AeroflyLocalizedText.js";
+export { AeroflyMission } from "./dto/AeroflyMission.js";
+export { AeroflyMissionCheckpoint } from "./dto/AeroflyMissionCheckpoint.js";
+export { AeroflyMissionConditions } from "./dto/AeroflyMissionConditions.js";
+export { AeroflyMissionConditionsCloud } from "./dto/AeroflyMissionConditionsCloud.js";
+export { AeroflyMissionsList } from "./dto/AeroflyMissionsList.js";
+export { AeroflyMissionTargetPlane } from "./dto/AeroflyMissionTargetPlane.js";