gnss-js 1.66.0 → 2.0.0

package/dist/rtcm3.cjs

@@ -29,10 +29,11 @@ __export(rtcm3_exports, {
   decodeIgsSsr: () => decodeIgsSsr,
   decodeLegacyObs: () => decodeLegacyObs,
   decodeMsmFull: () => decodeMsmFull,
+  decodeObs: () => decodeObs,
   decodeSsr: () => decodeSsr,
   decodeSystemParams: () => decodeSystemParams,
   isSsrMessage: () => isSsrMessage,
-  msmEpochToDate: () => msmEpochToDate,
+  obsEpochToDate: () => obsEpochToDate,
   readString: () => readString,
   reportDecodeError: () => reportDecodeError,
   resetGloFreqCache: () => resetGloFreqCache,
@@ -88,9 +89,6 @@ var BitReader = class {
   skip(n) {
     this.bitPos += n;
   }
-  get bitsLeft() {
-    return this.data.length * 8 - this.bitPos;
-  }
 };
 function crc24q(data, length) {
   let crc = 0;
@@ -592,7 +590,7 @@ function decodeEphemeris(frame) {
   }
 }
 
-// src/rtcm3/igs-ssr.ts
+// src/rtcm3/ssr-common.ts
 var UPDATE_INTERVAL_S = [
   1,
   2,
@@ -611,6 +609,28 @@ var UPDATE_INTERVAL_S = [
   7200,
   10800
 ];
+function ssrUraMm(v) {
+  if (v === 0) return null;
+  const cls = v >> 3 & 7;
+  const val = v & 7;
+  return 3 ** cls * (1 + val / 4) - 1;
+}
+function readSsrOrbit(r, sat) {
+  sat.iode = r.readU(8);
+  sat.deltaRadial = r.readS(22) * 1e-4;
+  sat.deltaAlongTrack = r.readS(20) * 4e-4;
+  sat.deltaCrossTrack = r.readS(20) * 4e-4;
+  sat.dotRadial = r.readS(21) * 1e-6;
+  sat.dotAlongTrack = r.readS(19) * 4e-6;
+  sat.dotCrossTrack = r.readS(19) * 4e-6;
+}
+function readSsrClock(r, sat) {
+  sat.c0 = r.readS(22) * 1e-4;
+  sat.c1 = r.readS(21) * 1e-6;
+  sat.c2 = r.readS(27) * 2e-8;
+}
+
+// src/rtcm3/igs-ssr.ts
 var SYSTEM_BY_BASE = {
   20: "G",
   40: "R",
@@ -634,12 +654,6 @@ function prnFor(system, id) {
   if (system === "S") return `S${two(19 + id)}`;
   return `${system}${two(id)}`;
 }
-function ssrUraMm(v) {
-  if (v === 0) return null;
-  const cls = v >> 3 & 7;
-  const val = v & 7;
-  return 3 ** cls * (1 + val / 4) - 1;
-}
 function decodeIgsSsr(frame) {
   if (frame.messageType !== 4076) return null;
   const r = new BitReader(frame.payload);
@@ -666,26 +680,12 @@ function decodeIgsSsr(frame) {
     mwConsistency = r.readU(1) === 1;
   }
   const nsat = r.readU(6);
-  const readOrbit = (s) => {
-    s.iode = r.readU(8);
-    s.deltaRadial = r.readS(22) * 1e-4;
-    s.deltaAlongTrack = r.readS(20) * 4e-4;
-    s.deltaCrossTrack = r.readS(20) * 4e-4;
-    s.dotRadial = r.readS(21) * 1e-6;
-    s.dotAlongTrack = r.readS(19) * 4e-6;
-    s.dotCrossTrack = r.readS(19) * 4e-6;
-  };
-  const readClock = (s) => {
-    s.c0 = r.readS(22) * 1e-4;
-    s.c1 = r.readS(21) * 1e-6;
-    s.c2 = r.readS(27) * 2e-8;
-  };
   const satellites = [];
   for (let i = 0; i < nsat; i++) {
     const id = r.readU(6);
     const sat = { prn: prnFor(system, id) };
-    if (kind === "orbit" || kind === "combined") readOrbit(sat);
-    if (kind === "clock" || kind === "combined") readClock(sat);
+    if (kind === "orbit" || kind === "combined") readSsrOrbit(r, sat);
+    if (kind === "clock" || kind === "combined") readSsrClock(r, sat);
     else if (kind === "ura")
       sat.uraMm = ssrUraMm(r.readU(6));
     else if (kind === "highRateClock")
@@ -778,145 +778,6 @@ function decodeIono(r, version, im) {
   };
 }
 
-// src/constants/gnss.ts
-var C_LIGHT = 299792458;
-var FREQ = {
-  G: { "1": 157542e4, "2": 12276e5, "5": 117645e4 },
-  // R bands 4/6 are the CDMA L1OC/L2OC center frequencies
-  R: { "3": 1202025e3, "4": 1600995e3, "6": 124806e4 },
-  E: {
-    "1": 157542e4,
-    "5": 117645e4,
-    "6": 127875e4,
-    "7": 120714e4,
-    "8": 1191795e3
-  },
-  C: {
-    "1": 157542e4,
-    "2": 1561098e3,
-    "5": 117645e4,
-    "6": 126852e4,
-    "7": 120714e4
-  },
-  J: { "1": 157542e4, "2": 12276e5, "5": 117645e4, "6": 127875e4 },
-  I: { "5": 117645e4, "9": 2492028e3 },
-  S: { "1": 157542e4, "5": 117645e4 }
-};
-var GLO_F1_BASE = 1602e6;
-var GLO_F1_STEP = 562500;
-var GLO_F2_BASE = 1246e6;
-var GLO_F2_STEP = 437500;
-
-// src/rtcm3/legacy-obs.ts
-var PRUNIT_GPS = 299792.458;
-var PRUNIT_GLO = 599584.916;
-var LAM_GPS_L1 = C_LIGHT / 157542e4;
-var LAM_GPS_L2 = C_LIGHT / 12276e5;
-var PPR_INVALID = -(2 ** 19);
-var PR21_INVALID = -(2 ** 13);
-function legacyLockSec(i) {
-  if (i < 24) return i;
-  if (i < 48) return 2 * i - 24;
-  if (i < 72) return 4 * i - 120;
-  if (i < 96) return 8 * i - 408;
-  if (i < 120) return 16 * i - 1176;
-  if (i < 127) return 32 * i - 3096;
-  return 937;
-}
-var two2 = (n) => n.toString().padStart(2, "0");
-function decodeLegacyObs(frame) {
-  const type = frame.messageType;
-  const gps = type >= 1001 && type <= 1004;
-  const glo = type >= 1009 && type <= 1012;
-  if (!gps && !glo) return null;
-  const ext = type === 1002 || type === 1004 || type === 1010 || type === 1012;
-  const dual = type === 1003 || type === 1004 || type === 1011 || type === 1012;
-  const system = gps ? "G" : "R";
-  const r = new BitReader(frame.payload);
-  r.readU(12);
-  r.readU(12);
-  let epochMs;
-  let nsat;
-  if (gps) {
-    epochMs = r.readU(30);
-    r.readU(1);
-    nsat = r.readU(5);
-    r.readU(1);
-    r.readU(3);
-  } else {
-    const tk = r.readU(27);
-    r.readU(1);
-    nsat = r.readU(5);
-    r.readU(1);
-    r.readU(3);
-    const gloDow = new Date(Date.now() + 3 * 36e5).getUTCDay();
-    epochMs = (gloDow << 27 | tk) >>> 0;
-  }
-  const observations = [];
-  for (let s = 0; s < nsat; s++) {
-    const satId = r.readU(6);
-    const code1 = r.readU(1);
-    const freqCh = glo ? r.readU(5) : 0;
-    const pr1raw = r.readU(gps ? 24 : 25);
-    const ppr1 = r.readS(20);
-    const lock1 = r.readU(7);
-    let amb = 0;
-    let cnr1 = 0;
-    if (ext) {
-      amb = r.readU(gps ? 8 : 7);
-      cnr1 = r.readU(8);
-    }
-    let code2 = 0;
-    let pr21 = 0;
-    let ppr2 = 0;
-    let lock2 = 0;
-    let cnr2 = 0;
-    if (dual) {
-      code2 = r.readU(2);
-      pr21 = r.readS(14);
-      ppr2 = r.readS(20);
-      lock2 = r.readU(7);
-      if (ext) cnr2 = r.readU(8);
-    }
-    if (gps && (satId < 1 || satId > 32)) continue;
-    if (glo && (satId < 1 || satId > 24)) continue;
-    const prunit = gps ? PRUNIT_GPS : PRUNIT_GLO;
-    const pr1 = pr1raw * 0.02 + amb * prunit;
-    const k = freqCh - 7;
-    const lamL1 = gps ? LAM_GPS_L1 : C_LIGHT / (GLO_F1_BASE + k * GLO_F1_STEP);
-    const lamL2 = gps ? LAM_GPS_L2 : C_LIGHT / (GLO_F2_BASE + k * GLO_F2_STEP);
-    const signals = [];
-    {
-      const sig = {
-        rinexCode: gps ? code1 ? "1W" : "1C" : code1 ? "1P" : "1C",
-        pseudorange: pr1,
-        wavelength: lamL1,
-        lockTime: legacyLockSec(lock1)
-      };
-      if (ppr1 !== PPR_INVALID) sig.phase = (pr1 + ppr1 * 5e-4) / lamL1;
-      if (ext && cnr1 > 0) sig.cn0 = cnr1 * 0.25;
-      signals.push(sig);
-    }
-    if (dual) {
-      const sig = {
-        rinexCode: gps ? code2 === 0 ? "2X" : "2W" : code2 === 0 ? "2C" : "2P",
-        wavelength: lamL2,
-        lockTime: legacyLockSec(lock2)
-      };
-      if (pr21 !== PR21_INVALID) sig.pseudorange = pr1 + pr21 * 0.02;
-      if (ppr2 !== PPR_INVALID) sig.phase = (pr1 + ppr2 * 5e-4) / lamL2;
-      if (ext && cnr2 > 0) sig.cn0 = cnr2 * 0.25;
-      signals.push(sig);
-    }
-    observations.push({
-      prn: `${system}${two2(satId)}`,
-      system,
-      signals
-    });
-  }
-  return { messageType: type, epochMs, system, observations };
-}
-
 // src/constants/time.ts
 var MILLISECONDS_IN_WEEK = 6048e5;
 var MILLISECONDS_IN_SECOND = 1e3;
@@ -1007,6 +868,35 @@ function getGpsLeap(date) {
   return leap_seconds - 19;
 }
 
+// src/constants/gnss.ts
+var C_LIGHT = 299792458;
+var FREQ = {
+  G: { "1": 157542e4, "2": 12276e5, "5": 117645e4 },
+  // R bands 4/6 are the CDMA L1OC/L2OC center frequencies
+  R: { "3": 1202025e3, "4": 1600995e3, "6": 124806e4 },
+  E: {
+    "1": 157542e4,
+    "5": 117645e4,
+    "6": 127875e4,
+    "7": 120714e4,
+    "8": 1191795e3
+  },
+  C: {
+    "1": 157542e4,
+    "2": 1561098e3,
+    "5": 117645e4,
+    "6": 126852e4,
+    "7": 120714e4
+  },
+  J: { "1": 157542e4, "2": 12276e5, "5": 117645e4, "6": 127875e4 },
+  I: { "5": 117645e4, "9": 2492028e3 },
+  S: { "1": 157542e4, "5": 117645e4 }
+};
+var GLO_F1_BASE = 1602e6;
+var GLO_F1_STEP = 562500;
+var GLO_F2_BASE = 1246e6;
+var GLO_F2_STEP = 437500;
+
 // src/rtcm3/msm.ts
 var GPS_L1 = FREQ.G["1"];
 var GPS_L2 = FREQ.G["2"];
@@ -1505,7 +1395,7 @@ function decodeMsmFull(frame) {
 }
 var GPS_EPOCH = START_GPS_TIME.getTime();
 var MS_PER_WEEK = MILLISECONDS_IN_WEEK;
-function msmEpochToDate(sys, epochMs, refTime = /* @__PURE__ */ new Date()) {
+function obsEpochToDate(sys, epochMs, refTime = /* @__PURE__ */ new Date()) {
   const refMs = refTime.getTime();
   if (sys === "R") {
     const dayOfWeek = epochMs >>> 27 & 7;
@@ -1541,25 +1431,120 @@ function resetGloFreqCache() {
   gloFreqNum.fill(-128);
 }
 
+// src/rtcm3/legacy-obs.ts
+var PRUNIT_GPS = 299792.458;
+var PRUNIT_GLO = 599584.916;
+var LAM_GPS_L1 = C_LIGHT / 157542e4;
+var LAM_GPS_L2 = C_LIGHT / 12276e5;
+var PPR_INVALID = -(2 ** 19);
+var PR21_INVALID = -(2 ** 13);
+function legacyLockSec(i) {
+  if (i < 24) return i;
+  if (i < 48) return 2 * i - 24;
+  if (i < 72) return 4 * i - 120;
+  if (i < 96) return 8 * i - 408;
+  if (i < 120) return 16 * i - 1176;
+  if (i < 127) return 32 * i - 3096;
+  return 937;
+}
+var two2 = (n) => n.toString().padStart(2, "0");
+function decodeLegacyObs(frame) {
+  const type = frame.messageType;
+  const gps = type >= 1001 && type <= 1004;
+  const glo = type >= 1009 && type <= 1012;
+  if (!gps && !glo) return null;
+  const ext = type === 1002 || type === 1004 || type === 1010 || type === 1012;
+  const dual = type === 1003 || type === 1004 || type === 1011 || type === 1012;
+  const system = gps ? "G" : "R";
+  const r = new BitReader(frame.payload);
+  r.readU(12);
+  r.readU(12);
+  let epochMs;
+  let nsat;
+  if (gps) {
+    epochMs = r.readU(30);
+    r.readU(1);
+    nsat = r.readU(5);
+    r.readU(1);
+    r.readU(3);
+  } else {
+    const tk = r.readU(27);
+    r.readU(1);
+    nsat = r.readU(5);
+    r.readU(1);
+    r.readU(3);
+    const gloDow = new Date(Date.now() + 3 * 36e5).getUTCDay();
+    epochMs = (gloDow << 27 | tk) >>> 0;
+  }
+  const observations = [];
+  for (let s = 0; s < nsat; s++) {
+    const satId = r.readU(6);
+    const code1 = r.readU(1);
+    const freqCh = glo ? r.readU(5) : 0;
+    const pr1raw = r.readU(gps ? 24 : 25);
+    const ppr1 = r.readS(20);
+    const lock1 = r.readU(7);
+    let amb = 0;
+    let cnr1 = 0;
+    if (ext) {
+      amb = r.readU(gps ? 8 : 7);
+      cnr1 = r.readU(8);
+    }
+    let code2 = 0;
+    let pr21 = 0;
+    let ppr2 = 0;
+    let lock2 = 0;
+    let cnr2 = 0;
+    if (dual) {
+      code2 = r.readU(2);
+      pr21 = r.readS(14);
+      ppr2 = r.readS(20);
+      lock2 = r.readU(7);
+      if (ext) cnr2 = r.readU(8);
+    }
+    if (gps && (satId < 1 || satId > 32)) continue;
+    if (glo && (satId < 1 || satId > 24)) continue;
+    const prunit = gps ? PRUNIT_GPS : PRUNIT_GLO;
+    const pr1 = pr1raw * 0.02 + amb * prunit;
+    const k = freqCh - 7;
+    const lamL1 = gps ? LAM_GPS_L1 : C_LIGHT / (GLO_F1_BASE + k * GLO_F1_STEP);
+    const lamL2 = gps ? LAM_GPS_L2 : C_LIGHT / (GLO_F2_BASE + k * GLO_F2_STEP);
+    const signals = [];
+    {
+      const sig = {
+        rinexCode: gps ? code1 ? "1W" : "1C" : code1 ? "1P" : "1C",
+        pseudorange: pr1,
+        wavelength: lamL1,
+        lockTime: legacyLockSec(lock1)
+      };
+      if (ppr1 !== PPR_INVALID) sig.phase = (pr1 + ppr1 * 5e-4) / lamL1;
+      if (ext && cnr1 > 0) sig.cn0 = cnr1 * 0.25;
+      signals.push(sig);
+    }
+    if (dual) {
+      const sig = {
+        rinexCode: gps ? code2 === 0 ? "2X" : "2W" : code2 === 0 ? "2C" : "2P",
+        wavelength: lamL2,
+        lockTime: legacyLockSec(lock2)
+      };
+      if (pr21 !== PR21_INVALID) sig.pseudorange = pr1 + pr21 * 0.02;
+      if (ppr2 !== PPR_INVALID) sig.phase = (pr1 + ppr2 * 5e-4) / lamL2;
+      if (ext && cnr2 > 0) sig.cn0 = cnr2 * 0.25;
+      signals.push(sig);
+    }
+    observations.push({
+      prn: `${system}${two2(satId)}`,
+      system,
+      signals
+    });
+  }
+  return { messageType: type, epochMs, system, observations };
+}
+function decodeObs(frame) {
+  return decodeMsmFull(frame) ?? decodeLegacyObs(frame);
+}
+
 // src/rtcm3/ssr.ts
-var UPDATE_INTERVAL_S2 = [
-  1,
-  2,
-  5,
-  10,
-  15,
-  30,
-  60,
-  120,
-  240,
-  300,
-  600,
-  900,
-  1800,
-  3600,
-  7200,
-  10800
-];
 var GPS_SIGNAL = {
   0: "L1 C/A",
   1: "L1 P",
@@ -1594,12 +1579,6 @@ var SSR_KIND = {
   1067: { system: "R", kind: "ura" },
   1068: { system: "R", kind: "highRateClock" }
 };
-function ssrUraMm2(v) {
-  if (v === 0) return null;
-  const cls = v >> 3 & 7;
-  const val = v & 7;
-  return 3 ** cls * (1 + val / 4) - 1;
-}
 var two3 = (n) => n.toString().padStart(2, "0");
 function decodeSsr(frame) {
   const spec = SSR_KIND[frame.messageType];
@@ -1609,7 +1588,7 @@ function decodeSsr(frame) {
   const r = new BitReader(frame.payload);
   r.readU(12);
   const epochS = r.readU(gps ? 20 : 17);
-  const updateIntervalS = UPDATE_INTERVAL_S2[r.readU(4)];
+  const updateIntervalS = UPDATE_INTERVAL_S[r.readU(4)];
   const multipleMessage = r.readU(1) === 1;
   const hasDatum = kind === "orbit" || kind === "combined";
   const referenceDatum = hasDatum ? r.readU(1) : void 0;
@@ -1619,30 +1598,14 @@ function decodeSsr(frame) {
   const nsat = r.readU(6);
   const sigName = gps ? GPS_SIGNAL : GLO_SIGNAL;
   const satellites = [];
-  const readOrbit = (sat) => {
-    sat.deltaRadial = r.readS(22) * 1e-4;
-    sat.deltaAlongTrack = r.readS(20) * 4e-4;
-    sat.deltaCrossTrack = r.readS(20) * 4e-4;
-    sat.dotRadial = r.readS(21) * 1e-6;
-    sat.dotAlongTrack = r.readS(19) * 4e-6;
-    sat.dotCrossTrack = r.readS(19) * 4e-6;
-  };
-  const readClock = (sat) => {
-    sat.c0 = r.readS(22) * 1e-4;
-    sat.c1 = r.readS(21) * 1e-6;
-    sat.c2 = r.readS(27) * 2e-8;
-  };
   for (let i = 0; i < nsat; i++) {
     const satId = gps ? r.readU(6) : r.readU(5);
     const sat = { prn: `${system}${two3(satId)}` };
-    if (kind === "orbit" || kind === "combined") {
-      sat.iode = r.readU(8);
-      readOrbit(sat);
-    }
-    if (kind === "combined") readClock(sat);
-    else if (kind === "clock") readClock(sat);
+    if (kind === "orbit" || kind === "combined") readSsrOrbit(r, sat);
+    if (kind === "combined") readSsrClock(r, sat);
+    else if (kind === "clock") readSsrClock(r, sat);
     else if (kind === "ura")
-      sat.uraMm = ssrUraMm2(r.readU(6));
+      sat.uraMm = ssrUraMm(r.readU(6));
     else if (kind === "highRateClock")
       sat.highRateClock = r.readS(22) * 1e-4;
     else if (kind === "codeBias") {
@@ -2010,9 +1973,9 @@ function updateStreamStats(stats, frames, rawBytes) {
     entry.count++;
     entry.lastSeen = now;
     entry.totalBytes += frame.length + 6;
-    const msmEpoch = decodeMsmFull(frame);
-    if (msmEpoch) {
-      for (const obs of msmEpoch.observations) {
+    const obsEpoch = decodeObs(frame);
+    if (obsEpoch) {
+      for (const obs of obsEpoch.observations) {
         const signals = [];
         let bestCn0 = 0;
         for (const sig of obs.signals) {
@@ -2021,7 +1984,7 @@ function updateStreamStats(stats, frames, rawBytes) {
             if (sig.cn0 > bestCn0) bestCn0 = sig.cn0;
           }
         }
-        if (signals.length > 0) {
+        if (obs.signals.length > 0) {
           stats.satellites.set(obs.prn, {
             prn: obs.prn,
             system: obs.system,
@@ -2072,10 +2035,11 @@ function updateStreamStats(stats, frames, rawBytes) {
   decodeIgsSsr,
   decodeLegacyObs,
   decodeMsmFull,
+  decodeObs,
   decodeSsr,
   decodeSystemParams,
   isSsrMessage,
-  msmEpochToDate,
+  obsEpochToDate,
   readString,
   reportDecodeError,
   resetGloFreqCache,

package/dist/rtcm3.d.cts

@@ -1,5 +1,5 @@
-import { b as Rtcm3Frame, E as EphemerisInfo } from './ephemeris-Ohl6NAfw.cjs';
-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.cjs';
+import { b as Rtcm3Frame, E as EphemerisInfo } from './ephemeris-BAnBLLB9.cjs';
+export { B as BitReader, R as Rtcm3DebugHandler, a as Rtcm3Decoder, d as decodeEphemeris, r as readString, c as reportDecodeError, s as setRtcm3DebugHandler } from './ephemeris-BAnBLLB9.cjs';
 
 /** One code bias for a specific signal (DF380/DF381 + DF383). */
 interface SsrCodeBias {
@@ -127,7 +127,7 @@ declare function decodeIgsSsr(frame: Rtcm3Frame): IgsSsrMessage | null;
  */
 
 /** Single signal observation for one satellite */
-interface MsmSignal {
+interface ObsSignal {
     /** RINEX 2-char obs code, e.g. "1C", "5X" */
     rinexCode: string;
     /** Pseudorange in meters (undefined if invalid) */
@@ -146,16 +146,20 @@ interface MsmSignal {
     wavelength: number;
 }
 /** All observations for one satellite in one epoch */
-interface MsmSatObs {
+interface ObsSatObs {
     /** PRN string, e.g. "G01", "R15", "E04" */
     prn: string;
     /** System letter: G, R, E, C, J, I, S */
     system: string;
     /** Signal observations */
-    signals: MsmSignal[];
+    signals: ObsSignal[];
 }
-/** One decoded MSM epoch */
-interface MsmEpoch {
+/**
+ * One decoded observation epoch. Originally the MSM4–7 output shape, now the
+ * neutral shape every RTCM3 obs source fills: MSM (`decodeMsmFull`), legacy
+ * 1001–1012 (`decodeLegacyObs`), via the `decodeObs` dispatcher.
+ */
+interface ObsEpoch {
     /** Message type (1074, 1077, etc.) */
     messageType: number;
     /** Epoch time as GPS milliseconds of week (or GLONASS day-of-week ms, BDS SOW) */
@@ -163,15 +167,15 @@ interface MsmEpoch {
     /** System letter */
     system: string;
     /** Observations per satellite */
-    observations: MsmSatObs[];
+    observations: ObsSatObs[];
 }
 /**
  * Decode a single RTCM3 MSM4-7 frame into full observations.
  * Returns null for non-MSM or MSM1-3 frames.
  */
-declare function decodeMsmFull(frame: Rtcm3Frame): MsmEpoch | null;
+declare function decodeMsmFull(frame: Rtcm3Frame): ObsEpoch | null;
 /**
- * Convert MSM epoch timestamp to a Date.
+ * Convert an observation epoch timestamp to a Date.
  * For GPS/Galileo/BDS/QZSS: epochMs is ms of GPS week.
  * For GLONASS: epochMs is day-of-week × 86400000 + ms of day (UTC+3).
  *
@@ -185,7 +189,7 @@ declare function decodeMsmFull(frame: Rtcm3Frame): MsmEpoch | null;
  * 18 s (the current leap-second count) off — a ±14 km per-satellite
  * range error that scattered live SPP solutions by kilometres.
  */
-declare function msmEpochToDate(sys: string, epochMs: number, refTime?: Date): Date;
+declare function obsEpochToDate(sys: string, epochMs: number, refTime?: Date): Date;
 /**
  * Set a GLONASS FDMA frequency number (k = -7..+13) for a slot (1-24),
  * e.g. from a decoded 1020 ephemeris. MSM4/6 carry no DF419, so without
@@ -199,9 +203,18 @@ declare function resetGloFreqCache(): void;
 
 /**
  * Decode a legacy RTCM3 observation frame (1001–1004 GPS, 1009–1012 GLONASS)
- * into an {@link MsmEpoch}, or null for any other message type.
+ * into an {@link ObsEpoch}, or null for any other message type.
+ */
+declare function decodeLegacyObs(frame: Rtcm3Frame): ObsEpoch | null;
+/**
+ * Decode any RTCM3 observation frame into an {@link ObsEpoch}: MSM4–7 first
+ * ({@link decodeMsmFull}), then the legacy fixed-layout obs (1001–1004 GPS,
+ * 1009–1012 GLONASS) via {@link decodeLegacyObs}. Returns null for any
+ * non-observation message. This is the single obs entry point every consumer
+ * (stream stats, live SPP/QC/RTK, station monitor) should call, so a new obs
+ * source is added here once rather than at every call site.
  */
-declare function decodeLegacyObs(frame: Rtcm3Frame): MsmEpoch | null;
+declare function decodeObs(frame: Rtcm3Frame): ObsEpoch | null;
 
 /** One announced message in the station's schedule (DF055/DF056/DF057). */
 interface SystemParamsMessage {
@@ -287,7 +300,7 @@ interface StreamStats {
     messageTypes: Map<number, MessageTypeStats>;
     bytesPerSecond: number;
     framesPerSecond: number;
-    /** Per-satellite C/N0 from MSM messages. Key = PRN (e.g. "G01"). */
+    /** Per-satellite C/N0 from observation messages. Key = PRN (e.g. "G01"). */
     satellites: Map<string, SatCn0>;
     /** Per-satellite ephemeris data. Key = PRN (e.g. "G01"). */
     ephemerides: Map<string, EphemerisInfo>;
@@ -303,4 +316,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 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 };
+export { EphemerisInfo, type IgsSsrIonoLayer, type IgsSsrMessage, type MessageTypeStats, type ObsEpoch, type ObsSatObs, type ObsSignal, 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, decodeObs, decodeSsr, decodeSystemParams, isSsrMessage, obsEpochToDate, resetGloFreqCache, rtcm3Constellation, setGloFreqNumber, updateStationMeta, updateStreamStats };