gnss-js 1.63.0 → 1.65.0

package/dist/rtcm3.d.ts

@@ -1,6 +1,121 @@
 import { b as Rtcm3Frame, E as EphemerisInfo } from './ephemeris-Ohl6NAfw.js';
 export { B as BitReader, R as Rtcm3DebugHandler, a as Rtcm3Decoder, d as decodeEphemeris, r as readString, c as reportDecodeError, s as setRtcm3DebugHandler } from './ephemeris-Ohl6NAfw.js';
 
+/** One code bias for a specific signal (DF380/DF381 + DF383). */
+interface SsrCodeBias {
+    /** Signal & tracking-mode indicator (DF380 GPS / DF381 GLONASS). */
+    signal: number;
+    /** Human-readable signal name. */
+    signalName: string;
+    /** Code bias (metres). */
+    biasM: number;
+}
+/** One phase bias for a signal — IGS-SSR (4076 IGM06) only. */
+interface SsrPhaseBias {
+    signal: number;
+    /** Bias is a fixable integer number of cycles. */
+    integer: boolean;
+    /** Wide-lane integer group indicator (0–3). */
+    wideLaneGroup: number;
+    /** Discontinuity counter — increments on a phase-bias reset/slip. */
+    discontinuity: number;
+    /** Phase bias (metres). */
+    biasM: number;
+}
+/** Per-satellite SSR correction (fields present depend on the message kind). */
+interface SsrSatCorrection {
+    prn: string;
+    /** Issue of data ephemeris this correction refers to (orbit/combined msgs). */
+    iode?: number;
+    /** Orbit correction in the radial/along/cross frame (metres). */
+    deltaRadial?: number;
+    deltaAlongTrack?: number;
+    deltaCrossTrack?: number;
+    /** Orbit correction rate (m/s). */
+    dotRadial?: number;
+    dotAlongTrack?: number;
+    dotCrossTrack?: number;
+    /** Clock correction polynomial: c0 (m), c1 (m/s), c2 (m/s²). */
+    c0?: number;
+    c1?: number;
+    c2?: number;
+    /** High-rate clock correction (metres), added to the c0/c1/c2 polynomial. */
+    highRateClock?: number;
+    /** User range accuracy, 1σ (mm); null when undefined/unknown. */
+    uraMm?: number | null;
+    /** Per-signal code biases. */
+    codeBiases?: SsrCodeBias[];
+    /** Per-signal phase biases (IGS-SSR 4076 only). */
+    phaseBiases?: SsrPhaseBias[];
+}
+type SsrKind = 'orbit' | 'clock' | 'codeBias' | 'combined' | 'ura' | 'highRateClock';
+/** A decoded SSR message (one of 1057–1068). */
+interface SsrMessage {
+    messageType: number;
+    /** System letter: 'G' (GPS) or 'R' (GLONASS). */
+    system: 'G' | 'R';
+    kind: SsrKind;
+    /** Epoch time: seconds of GPS week (GPS) or seconds of GLONASS day (GLONASS). */
+    epochS: number;
+    /** SSR update interval (seconds) decoded from DF391. */
+    updateIntervalS: number;
+    /** True when more SSR messages for this epoch follow (DF388). */
+    multipleMessage: boolean;
+    /** Satellite reference datum (orbit/combined only): 0 = ITRF, 1 = regional. */
+    referenceDatum?: number;
+    iodSsr: number;
+    providerId: number;
+    solutionId: number;
+    satellites: SsrSatCorrection[];
+}
+/**
+ * Decode an RTCM3 SSR message (1057–1068) into an {@link SsrMessage}, or null
+ * for any other message type.
+ */
+declare function decodeSsr(frame: Rtcm3Frame): SsrMessage | null;
+/** True if the message type is an RTCM3 SSR correction (1057–1068). */
+declare function isSsrMessage(messageType: number): boolean;
+
+/** A decoded IGS-SSR (4076) message. */
+interface IgsSsrMessage {
+    messageType: 4076;
+    /** IGS SSR format version (IDF001). */
+    version: number;
+    /** IGS Message Number / subtype (IDF002). */
+    igsMessageNumber: number;
+    /** System letter, or 'I' for the ionosphere (VTEC) message. */
+    system: 'G' | 'R' | 'E' | 'J' | 'C' | 'S' | 'I';
+    kind: SsrKind | 'phaseBias' | 'ionosphere';
+    epochS: number;
+    updateIntervalS: number;
+    multipleMessage: boolean;
+    referenceDatum?: number;
+    iodSsr: number;
+    providerId: number;
+    solutionId: number;
+    /** Phase-bias header consistency indicators (phaseBias only). */
+    dispersiveConsistency?: boolean;
+    mwConsistency?: boolean;
+    satellites: SsrSatCorrection[];
+    /** Ionosphere summary (IM201 only). */
+    iono?: {
+        qualityTecu: number;
+        layers: IgsSsrIonoLayer[];
+    };
+}
+/** One ionospheric layer header (IM201). */
+interface IgsSsrIonoLayer {
+    heightKm: number;
+    degree: number;
+    order: number;
+    coefficientCount: number;
+}
+/**
+ * Decode an RTCM3 IGS-SSR message (4076) into an {@link IgsSsrMessage}, or null
+ * if the frame is not 4076 or carries an unrecognised subtype.
+ */
+declare function decodeIgsSsr(frame: Rtcm3Frame): IgsSsrMessage | null;
+
 /**
  * Full RTCM3 MSM4-7 decoder — extracts pseudorange, carrier phase,
  * Doppler, and C/N0 for every satellite × signal cell.
@@ -88,6 +203,33 @@ declare function resetGloFreqCache(): void;
  */
 declare function decodeLegacyObs(frame: Rtcm3Frame): MsmEpoch | null;
 
+/** One announced message in the station's schedule (DF055/DF056/DF057). */
+interface SystemParamsMessage {
+    /** RTCM message type the station broadcasts. */
+    messageId: number;
+    /** Synchronous flag. */
+    sync: boolean;
+    /** Transmission interval (seconds; 0.1 s resolution per DF057). */
+    intervalS: number;
+}
+/** Decoded RTCM3 System Parameters (message 1013). */
+interface SystemParams {
+    referenceStationId: number;
+    /** Modified Julian Day number of the reference epoch. */
+    mjd: number;
+    /** Seconds of day (UTC) of the reference epoch. */
+    secondsOfDay: number;
+    /** Current GPS−UTC leap seconds. */
+    leapSeconds: number;
+    /** The message types this station announces it transmits. */
+    messages: SystemParamsMessage[];
+}
+/**
+ * Decode an RTCM3 System Parameters message (1013), or null for any other type
+ * or a short/corrupt frame.
+ */
+declare function decodeSystemParams(frame: Rtcm3Frame): SystemParams | null;
+
 /**
  * RTCM3 station metadata decoders (messages 1005/1006, 1007/1008, 1029, 1033).
  */
@@ -104,6 +246,7 @@ interface StationMeta {
     receiverFirmware: string | null;
     receiverSerial: string | null;
     description: string | null;
+    physicalRefStationId: number | null;
 }
 declare function createStationMeta(): StationMeta;
 /** Update station metadata from an RTCM3 frame. Returns true if the frame was a metadata message. */
@@ -160,4 +303,4 @@ declare function rtcm3Constellation(msgType: number): string | null;
 declare function createStreamStats(): StreamStats;
 declare function updateStreamStats(stats: StreamStats, frames: Rtcm3Frame[], rawBytes: number): void;
 
-export { EphemerisInfo, type MessageTypeStats, type MsmEpoch, type MsmSatObs, type MsmSignal, RTCM3_MESSAGE_NAMES, Rtcm3Frame, type SatCn0, type SignalCn0, type StationMeta, type StreamStats, createStationMeta, createStreamStats, decodeLegacyObs, decodeMsmFull, msmEpochToDate, resetGloFreqCache, rtcm3Constellation, setGloFreqNumber, updateStationMeta, updateStreamStats };
+export { EphemerisInfo, type IgsSsrIonoLayer, type IgsSsrMessage, type MessageTypeStats, type MsmEpoch, type MsmSatObs, type MsmSignal, RTCM3_MESSAGE_NAMES, Rtcm3Frame, type SatCn0, type SignalCn0, type SsrCodeBias, type SsrKind, type SsrMessage, type SsrPhaseBias, type SsrSatCorrection, type StationMeta, type StreamStats, type SystemParams, type SystemParamsMessage, createStationMeta, createStreamStats, decodeIgsSsr, decodeLegacyObs, decodeMsmFull, decodeSsr, decodeSystemParams, isSsrMessage, msmEpochToDate, resetGloFreqCache, rtcm3Constellation, setGloFreqNumber, updateStationMeta, updateStreamStats };

package/dist/rtcm3.js

@@ -5,8 +5,12 @@ import {
   createStationMeta,
   createStreamStats,
   decodeEphemeris,
+  decodeIgsSsr,
   decodeLegacyObs,
   decodeMsmFull,
+  decodeSsr,
+  decodeSystemParams,
+  isSsrMessage,
   msmEpochToDate,
   readString,
   reportDecodeError,
@@ -16,7 +20,7 @@ import {
   setRtcm3DebugHandler,
   updateStationMeta,
   updateStreamStats
-} from "./chunk-QN7Q2ALS.js";
+} from "./chunk-REULRNJ5.js";
 import "./chunk-HVXYFUCB.js";
 import "./chunk-LEEU5OIO.js";
 import "./chunk-FIEWO4J4.js";
@@ -27,8 +31,12 @@ export {
   createStationMeta,
   createStreamStats,
   decodeEphemeris,
+  decodeIgsSsr,
   decodeLegacyObs,
   decodeMsmFull,
+  decodeSsr,
+  decodeSystemParams,
+  isSsrMessage,
   msmEpochToDate,
   readString,
   reportDecodeError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gnss-js",
-  "version": "1.63.0",
+  "version": "1.65.0",
   "description": "Comprehensive GNSS library for JavaScript — time scales, coordinates, RINEX parsing, RTCM3 decoding, orbit computation, and signal analysis",
   "type": "module",
   "sideEffects": false,