@neilberkman/sidereon 1.1.1 → 1.2.0

package/pkg-node/sidereon.d.ts

@@ -6623,6 +6623,34 @@ export class RinexClock {
     readonly series: ClockSeries[];
 }
 
+/**
+ * Result of lenient RINEX NAV parsing.
+ *
+ * `records` contains the supported records in file order and `skipped`
+ * contains malformed supported blocks reported by the core parser.
+ */
+export class RinexNavParse {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Number of supported records returned by the parser.
+     */
+    readonly recordCount: number;
+    /**
+     * Supported broadcast records in file order.
+     */
+    readonly records: BroadcastRecordJs[];
+    /**
+     * Supported blocks skipped by the lenient core parser, in file order.
+     */
+    readonly skipped: SkippedNavBlock[];
+    /**
+     * Number of supported blocks skipped by the parser.
+     */
+    readonly skippedCount: number;
+}
+
 /**
  * Navigation repair result.
  */
@@ -7019,6 +7047,43 @@ export class SbasKMultipliers {
     readonly kV: number;
 }
 
+/**
+ * One timestamped SBAS message row parsed from an EMS or RTKLIB text log.
+ */
+export class SbasLogBlock {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Decode this raw message using its parsed wire form.
+     */
+    decode(): any;
+    /**
+     * Raw SBAS bytes in the form selected by the core parser.
+     */
+    readonly bytes: Uint8Array;
+    /**
+     * Core-selected wire form: `"framed250"` or `"body226"`.
+     */
+    readonly form: string;
+    /**
+     * SBAS satellite token, such as `"S20"`.
+     */
+    readonly satellite: string;
+    /**
+     * SBAS satellite token, such as `"S20"`.
+     */
+    readonly satelliteId: string;
+    /**
+     * Seconds of GPS week of the parsed message epoch.
+     */
+    readonly towS: number;
+    /**
+     * GPS week of the parsed message epoch.
+     */
+    readonly week: number;
+}
+
 /**
  * SBAS protection-level input or numerical failure.
  */
@@ -7220,6 +7285,26 @@ export class SignalPolicy {
     withSystem(system: GnssSystem, codes: string[]): SignalPolicy;
 }
 
+/**
+ * One supported RINEX NAV block that the core parser could not represent.
+ *
+ * The diagnostic is retained by [`parseRinexNavLenient`] instead of turning a
+ * malformed supported block into a fatal whole-file error.
+ */
+export class SkippedNavBlock {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Core parser diagnostic explaining why the block was skipped.
+     */
+    readonly message: string;
+    /**
+     * Satellite token from the skipped block, such as `"G01"`.
+     */
+    readonly satellite: string;
+}
+
 /**
  * Reason a carrier-phase arc split was flagged.
  */
@@ -9614,6 +9699,18 @@ export function correlateAgainst(iq: Float64Array, code: Int8Array, sample_rate_
  */
 export function correlationAt(code_a: Int8Array, code_b: Int8Array, lag: bigint): number;
 
+/**
+ * Convert a validated flat row-major 6x6 covariance from km²-based state
+ * units to m²-based state units.
+ */
+export function covariance6KmToM(covariance: Float64Array): Float64Array;
+
+/**
+ * Convert a validated flat row-major 6x6 covariance from m²-based state
+ * units to km²-based state units.
+ */
+export function covariance6MToKm(covariance: Float64Array): Float64Array;
+
 /**
  * Fitted parameter covariance from a converged solve, scaling `(J^T J)^-1` by
  * the post-fit reduced chi-square `s_sq = 2 * cost / (m - n)` (the same scale
@@ -9657,6 +9754,16 @@ export function cwPropagate(rel: any, n_rad_s: number, dt_s: number): any;
 
 export function cwStm(n_rad_s: number, dt_s: number): Float64Array;
 
+/**
+ * Integer day-of-year from a validated product date.
+ */
+export function dataDayOfYear(year: number, month: number, day: number): number;
+
+/**
+ * Fractional day-of-year from a civil calendar date and time.
+ */
+export function dayOfYear(year: number, month: number, day: number, hour: number, minute: number, second: number): number;
+
 /**
  * Decode Compact RINEX (Hatanaka) bytes into plain RINEX OBS text. Throws a
  * `TypeError` on non-UTF-8 input and an `Error` on a decode failure.
@@ -9858,6 +9965,12 @@ export function eccentricToTrue(eccentric_anomaly_rad: number, eccentricity: num
  */
 export function ecefToGeodetic(position_km: Float64Array): Float64Array;
 
+/**
+ * Transform a flat row-major 6x6 ECI state covariance into RTN coordinates.
+ * Position is in km and velocity is in km/s.
+ */
+export function eciToRtnCovariance6(covariance: Float64Array, position_km: Float64Array, velocity_km_s: Float64Array): Float64Array;
+
 /**
  * Eclipse status for satellite and Sun position batches, km. Returns a
  * `string[]` of `"sunlit"` / `"penumbra"` / `"umbra"`.
@@ -9935,6 +10048,13 @@ export function emissionMediaStatusLabel(status: EmissionMediaStatus): string;
  */
 export function encodeCrinex(rinex_text: string): string;
 
+/**
+ * Encode an arbitrary caller-supplied list of broadcast records as RINEX NAV
+ * text. The list is consumed by the WASM boundary and the bytes are produced
+ * by the core's deterministic encoder.
+ */
+export function encodeRinexNav(records: BroadcastRecordJs[]): string;
+
 /**
  * Encode a constructed RTCM message into a message body (without the transport
  * frame).
@@ -10531,6 +10651,12 @@ export function hessianTrace(jacobian: Float64Array, m: number, n: number): numb
  */
 export function horizontalRadiusAt(covariance_enu_m2: any, probability: number): PercentileRadius;
 
+/**
+ * Interpolate two validated same-frame flat row-major 6x6 covariances with
+ * the core PSD-preserving interpolation.
+ */
+export function interpolateCovariance6(covariance_a: Float64Array, covariance_b: Float64Array, u: number): Float64Array;
+
 /**
  * Gauss angles-only orbit determination.
  *
@@ -11380,6 +11506,16 @@ export function parseRinexLeapSeconds(bytes: Uint8Array): number | undefined;
  */
 export function parseRinexNav(bytes: Uint8Array): BroadcastEphemeris;
 
+/**
+ * Parse RINEX NAV bytes leniently through the core parser.
+ *
+ * Header failures remain fatal. Malformed supported record blocks are
+ * returned in `skipped` with their satellite token and core diagnostic;
+ * unsupported systems and message rosters retain the core parser's skip
+ * policy. Non-UTF-8 input throws a `TypeError`.
+ */
+export function parseRinexNavLenient(bytes: Uint8Array): RinexNavParse;
+
 /**
  * Parse all supported GPS, Galileo, and BeiDou broadcast records from NAV
  * bytes, before the store's default health and message-policy filter.
@@ -11392,6 +11528,16 @@ export function parseRinexNavRecords(bytes: Uint8Array): BroadcastRecordJs[];
  */
 export function parseRinexObs(bytes: Uint8Array): RinexObs;
 
+/**
+ * Parse timestamped SBAS EMS log lines into raw message blocks.
+ */
+export function parseSbasEmsLines(text: string): SbasLogBlock[];
+
+/**
+ * Parse timestamped RTKLIB SBAS log lines into raw message blocks.
+ */
+export function parseSbasRtklibLines(text: string): SbasLogBlock[];
+
 /**
  * Parse either CSV or fixed-width TXT space-weather bytes.
  */
@@ -11714,6 +11860,25 @@ export function rinexBandFrequencyHz(system: GnssSystem, band: string, glonass_c
  */
 export function rinexBandWavelengthM(system: GnssSystem, band: string, glonass_channel?: number | null): number | undefined;
 
+/**
+ * RINEX observation-code frequency in hertz for a system and full code.
+ *
+ * `rinex_version` is passed to the core policy because some constellation
+ * band meanings depend on the RINEX minor version. GLONASS G1/G2 codes also
+ * require the FDMA channel number. Returns `undefined` when the core has no
+ * mapping for the supplied system/code combination.
+ */
+export function rinexObservationFrequencyHz(system: GnssSystem, code: string, rinex_version: number, glonass_channel?: number | null): number | undefined;
+
+/**
+ * RINEX observation-code wavelength in metres for a system and full code.
+ *
+ * This uses the same version-aware observation-code policy as
+ * [`rinexObservationFrequencyHz`]. Returns `undefined` when no core mapping
+ * exists.
+ */
+export function rinexObservationWavelengthM(system: GnssSystem, code: string, rinex_version: number, glonass_channel?: number | null): number | undefined;
+
 export function rswRotation(position_km: Float64Array, velocity_km_s: Float64Array): Float64Array;
 
 /**
@@ -11765,6 +11930,12 @@ export function rtnRotation(position_km: Float64Array, velocity_km_s: Float64Arr
  */
 export function rtnToEciCovariance(covariance_rtn: Float64Array, position_km: Float64Array, velocity_km_s: Float64Array): Float64Array;
 
+/**
+ * Transform a flat row-major 6x6 RTN state covariance into ECI coordinates.
+ * Position is in km and velocity is in km/s.
+ */
+export function rtnToEciCovariance6(covariance: Float64Array, position_km: Float64Array, velocity_km_s: Float64Array): Float64Array;
+
 /**
  * Convert an inertial Cartesian state to classical orbital elements.
  *
@@ -11865,6 +12036,11 @@ export function seasons(start_unix_us: bigint, end_unix_us: bigint, step_s: numb
 
 export function seasonsSpk(spk: Spk, start_unix_us: bigint, end_unix_us: bigint, step_s: number, tolerance_s: number): any;
 
+/**
+ * Seconds elapsed since the beginning of a civil day.
+ */
+export function secondOfDay(hour: number, minute: number, second: number): number;
+
 /**
  * Select an IONEX product usable at `requestedEpochJ2000S`, degrading to a
  * diurnal-shifted prior product within `policy`.