@saber-usa/node-common 1.7.33 → 1.7.34

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saber-usa/node-common",
-  "version": "1.7.33",
+  "version": "1.7.34",
   "description": "Common node functions for Saber",
   "main": "src/index.js",
   "type": "module",

package/src/tle/TleParseUtils.js

@@ -1,147 +1,168 @@
-/**
- * Utility class for TLE parsing, including Alpha-5 TLE satellite IDs.
- * Ported from org.orekit.propagation.analytical.tle.ParseUtils / TLE.
- *
- * Alpha-5 extends the range of existing 5-digit TLE satellite numbers
- * by allowing the first digit to be an upper case letter, ignoring 'I'
- * and 'O' to avoid confusion with numbers '1' and '0'.
- *
- * @see https://www.space-track.org/documentation#tle-alpha5
- */
-export class TleParseUtils {
-    /** Maximum satellite number representable with 5 numeric digits. */
-    static MAX_NUMERIC_SATNUM = 99999;
-
-    /** Scaling factor for Alpha-5 numbers. */
-    static ALPHA5_SCALING = 10000;
-
-    /** Letter → number map for Alpha-5 satellite numbers. */
-    static ALPHA5_NUMBERS = new Map();
-
-    /** Number → letter map for Alpha-5 satellite numbers. */
-    static ALPHA5_LETTERS = new Map();
-
-    static {
-        const alpha5Letters = [
-            "A", "B", "C", "D", "E", "F", "G", "H", "J",
-            "K", "L", "M", "N", "P", "Q", "R", "S", "T",
-            "U", "V", "W", "X", "Y", "Z",
-        ];
-        for (let i = 0; i < alpha5Letters.length; ++i) {
-            TleParseUtils.ALPHA5_NUMBERS.set(alpha5Letters[i], i + 10);
-            TleParseUtils.ALPHA5_LETTERS.set(i + 10, alpha5Letters[i]);
-        }
-    }
-
-    /** Private constructor for a utility class. */
-    constructor() {
-        throw new Error("TleParseUtils is a utility class and cannot be instantiated");
-    }
-
-    /**
-     * True if token is a valid 5-char TLE catalog field:
-     * five digits, or Alpha-5 letter (no I/O) plus four digits.
-     * @param {string} token
-     * @return {boolean}
-     */
-    static isValidSatelliteNumberField(token) {
-        if (typeof token !== "string" || token.length !== 5) {
-            return false;
-        }
-        if (/^\d{5}$/.test(token)) {
-            return true;
-        }
-        if (!TleParseUtils.ALPHA5_NUMBERS.has(token.charAt(0))) {
-            return false;
-        }
-        return /^\d{4}$/.test(token.substring(1));
-    }
-
-    /**
-     * Stricter int parser: accepts an optional sign plus digits only, else throws.
-     * Unlike Number.parseInt, rejects partial parses (e.g. "12abc").
-     * @param {string} string
-     * @return {number}
-     */
-    static #strictParseInt(string) {
-        if (!/^[+-]?\d+$/.test(string)) {
-            throw new Error(`Invalid integer: "${string}"`);
-        }
-        return Number.parseInt(string, 10);
-    }
-
-    /**
-     * Add padding characters to a string.
-     * Port of ParseUtils.addPadding.
-     * @param {string} name parameter name
-     * @param {string} string string to pad
-     * @param {string} c padding character
-     * @param {number} size desired size
-     * @param {boolean} rightJustified if true, pad on the left
-     * @param {number} satelliteNumber satellite number (for error context)
-     * @return {string} padded string
-     */
-    static addPadding(name, string, c, size, rightJustified, satelliteNumber) {
-        if (string.length > size) {
-            throw new Error(
-                `TLE invalid parameter: satelliteNumber=${satelliteNumber}, name=${name}, value=${string}`,
-            );
-        }
-
-        const padding = c.repeat(size);
-
-        if (rightJustified) {
-            const concatenated = padding + string;
-            const l = concatenated.length;
-            return concatenated.substring(l - size, l);
-        }
-
-        return (string + padding).substring(0, size);
-    }
-
-    /**
-     * Build an Alpha-5 (or numeric) satellite number field.
-     * Port of ParseUtils.buildSatelliteNumber.
-     * @param {number} satelliteNumber satellite number, that may exceed the 99999 limit
-     * @param {string} name parameter name (used in error messages)
-     * @return {string} satellite number in alpha5 / 5-digit representation
-     */
-    static buildSatelliteNumber(satelliteNumber, name) {
-        if (satelliteNumber > TleParseUtils.MAX_NUMERIC_SATNUM) {
-            const highDigits = Math.trunc(satelliteNumber / TleParseUtils.ALPHA5_SCALING);
-            const lowDigits = satelliteNumber - highDigits * TleParseUtils.ALPHA5_SCALING;
-
-            const alpha = TleParseUtils.ALPHA5_LETTERS.get(highDigits);
-            if (alpha === undefined) {
-                throw new Error(
-                    `TLE invalid parameter: satelliteNumber=${satelliteNumber}, name=${name}, value=null`,
-                );
-            }
-            return alpha + TleParseUtils.addPadding(
-                name, String(lowDigits), "0", 4, true, satelliteNumber,
-            );
-        }
-        return TleParseUtils.addPadding(
-            name, String(satelliteNumber), "0", 5, true, satelliteNumber,
-        );
-    }
-
-    /**
-     * Parse a satellite number from a string field (supports Alpha-5).
-     * Port of TLE.parseSatelliteNumber / ParseUtils.parseSatelliteNumber.
-     * @param {string} satNumberString the string to parse (e.g., "25544" or "A0001")
-     * @return {number} the satellite number as an integer
-     */
-    static getSatnoFromTle(satNumberString) {
-        if (!TleParseUtils.isValidSatelliteNumberField(satNumberString)) {
-            throw new Error(`Invalid satellite number field: "${satNumberString}"`);
-        }
-
-        const alpha = TleParseUtils.ALPHA5_NUMBERS.get(satNumberString.charAt(0));
-        if (alpha !== undefined) {
-            return (alpha * TleParseUtils.ALPHA5_SCALING)
-                + TleParseUtils.#strictParseInt(satNumberString.substring(1));
-        }
-        return TleParseUtils.#strictParseInt(satNumberString);
-    }
-}
+import {isDefined} from "../utils.js";
+
+/**
+ * Utility class for TLE parsing, including Alpha-5 TLE satellite IDs.
+ * Ported from org.orekit.propagation.analytical.tle.ParseUtils / TLE.
+ *
+ * Alpha-5 extends the range of existing 5-digit TLE satellite numbers
+ * by allowing the first digit to be an upper case letter, ignoring 'I'
+ * and 'O' to avoid confusion with numbers '1' and '0'.
+ *
+ * @see https://www.space-track.org/documentation#tle-alpha5
+ */
+export class TleParseUtils {
+    /** Maximum satellite number representable with 5 numeric digits. */
+    static MAX_NUMERIC_SATNUM = 99999;
+
+    /** Scaling factor for Alpha-5 numbers. */
+    static ALPHA5_SCALING = 10000;
+
+    /** Letter → number map for Alpha-5 satellite numbers. */
+    static ALPHA5_NUMBERS = new Map();
+
+    /** Number → letter map for Alpha-5 satellite numbers. */
+    static ALPHA5_LETTERS = new Map();
+
+    static {
+        const alpha5Letters = [
+            "A", "B", "C", "D", "E", "F", "G", "H", "J",
+            "K", "L", "M", "N", "P", "Q", "R", "S", "T",
+            "U", "V", "W", "X", "Y", "Z",
+        ];
+        for (let i = 0; i < alpha5Letters.length; ++i) {
+            TleParseUtils.ALPHA5_NUMBERS.set(alpha5Letters[i], i + 10);
+            TleParseUtils.ALPHA5_LETTERS.set(i + 10, alpha5Letters[i]);
+        }
+    }
+
+    /** Private constructor for a utility class. */
+    constructor() {
+        throw new Error("TleParseUtils is a utility class and cannot be instantiated");
+    }
+
+    /**
+     * True if token is a valid 5-char TLE catalog field:
+     * five digits, or Alpha-5 letter (no I/O) plus four digits.
+     * @param {string} token
+     * @return {boolean}
+     */
+    static isValidSatelliteNumberField(token) {
+        if (typeof token !== "string" || token.length !== 5) {
+            return false;
+        }
+        if (/^\d{5}$/.test(token)) {
+            return true;
+        }
+        if (!TleParseUtils.ALPHA5_NUMBERS.has(token.charAt(0))) {
+            return false;
+        }
+        return /^\d{4}$/.test(token.substring(1));
+    }
+
+    /**
+     * Stricter int parser: accepts an optional sign plus digits only, else throws.
+     * Unlike Number.parseInt, rejects partial parses (e.g. "12abc").
+     * @param {string} string
+     * @return {number}
+     */
+    static #strictParseInt(string) {
+        if (!/^[+-]?\d+$/.test(string)) {
+            throw new Error(`Invalid integer: "${string}"`);
+        }
+        return Number.parseInt(string, 10);
+    }
+
+    /**
+     * Add padding characters to a string.
+     * Port of ParseUtils.addPadding.
+     * @param {string} name parameter name
+     * @param {string} string string to pad
+     * @param {string} c padding character
+     * @param {number} size desired size
+     * @param {boolean} rightJustified if true, pad on the left
+     * @param {number} satelliteNumber satellite number (for error context)
+     * @return {string} padded string
+     */
+    static addPadding(name, string, c, size, rightJustified, satelliteNumber) {
+        if (string.length > size) {
+            throw new Error(
+                `TLE invalid parameter: satelliteNumber=${satelliteNumber}, name=${name}, value=${string}`,
+            );
+        }
+
+        const padding = c.repeat(size);
+
+        if (rightJustified) {
+            const concatenated = padding + string;
+            const l = concatenated.length;
+            return concatenated.substring(l - size, l);
+        }
+
+        return (string + padding).substring(0, size);
+    }
+
+    /**
+     * Build an Alpha-5 (or numeric) satellite number field.
+     * Port of ParseUtils.buildSatelliteNumber.
+     * @param {number} satelliteNumber satellite number, that may exceed the 99999 limit
+     * @param {string} name parameter name (used in error messages)
+     * @return {string} satellite number in alpha5 / 5-digit representation
+     */
+    static buildSatelliteNumber(satelliteNumber, name) {
+        if (satelliteNumber > TleParseUtils.MAX_NUMERIC_SATNUM) {
+            const highDigits = Math.trunc(satelliteNumber / TleParseUtils.ALPHA5_SCALING);
+            const lowDigits = satelliteNumber - highDigits * TleParseUtils.ALPHA5_SCALING;
+
+            const alpha = TleParseUtils.ALPHA5_LETTERS.get(highDigits);
+            if (alpha === undefined) {
+                throw new Error(
+                    `TLE invalid parameter: satelliteNumber=${satelliteNumber}, name=${name}, value=null`,
+                );
+            }
+            return alpha + TleParseUtils.addPadding(
+                name, String(lowDigits), "0", 4, true, satelliteNumber,
+            );
+        }
+        return TleParseUtils.addPadding(
+            name, String(satelliteNumber), "0", 5, true, satelliteNumber,
+        );
+    }
+
+    /**
+     * Parse a satellite number from a string field (supports Alpha-5).
+     * Port of TLE.parseSatelliteNumber / ParseUtils.parseSatelliteNumber.
+     * @param {string} satNumberString the string to parse (e.g., "25544" or "A0001")
+     * @return {number} the satellite number as an integer
+     */
+    static getSatnoFromTle(satNumberString) {
+        if (!TleParseUtils.isValidSatelliteNumberField(satNumberString)) {
+            throw new Error(`Invalid satellite number field: "${satNumberString}"`);
+        }
+
+        const alpha = TleParseUtils.ALPHA5_NUMBERS.get(satNumberString.charAt(0));
+        if (alpha !== undefined) {
+            return (alpha * TleParseUtils.ALPHA5_SCALING)
+                + TleParseUtils.#strictParseInt(satNumberString.substring(1));
+        }
+        return TleParseUtils.#strictParseInt(satNumberString);
+    }
+
+    /**
+     * Lenient catalog NORAD ID decode: 5-char TLE field (digits or Alpha-5),
+     * or an unpadded plain integer string (e.g. "16", "900").
+     * Returns null for nullish / empty / non-numeric values instead of throwing.
+     * @param {string|number|null|undefined} value
+     * @return {number|null}
+     */
+    static parseCatalogSatno(value) {
+        if (!isDefined(value) || value === "") {
+            return null;
+        }
+        const token = String(value).trim();
+        if (TleParseUtils.isValidSatelliteNumberField(token)) {
+            return TleParseUtils.getSatnoFromTle(token);
+        }
+        const n = Number.parseInt(token, 10);
+        return Number.isNaN(n) ? null : n;
+    }
+}