gnss-js 1.55.0 → 1.57.0

package/dist/sbf.d.ts

@@ -1,6 +1,6 @@
 export { S as SbfAlmanac, a as SbfAlmanacResult, b as SbfGlonassAlmanac, c as SbfKeplerAlmanac, d as SbfNavResult, p as parseSbfAlmanac, e as parseSbfNav } from './nav-CN8rxL4h.js';
 import { R as ReceiverPvt } from './receiver-pvt-CVFvi4kT.js';
-import { K as KeplerEphemeris, C as CnavEphemeris, E as Ephemeris, G as GlonassEphemeris } from './nav-DImXUdbp.js';
+import { K as KeplerEphemeris, C as CnavEphemeris, G as GlonassEphemeris, E as Ephemeris } from './nav-DImXUdbp.js';
 
 /**
  * Septentrio SBF framing shared by the measurement and navigation
@@ -213,6 +213,91 @@ interface SbfCnavResult {
  */
 declare function parseSbfCnav(data: Uint8Array): SbfCnavResult;
 
+/** Callback fed every CRC-valid SBAS message (any type), as MSB-first bits. */
+type SbasMessageCb = (msg: Uint8Array, prn: number, week: number, tow: number) => void;
+/** Callback fed every CRC-valid native-DFMC (L5) message, with its type. */
+type DfmcMessageCb = (msg: Uint8Array, prn: number, week: number, tow: number, type: number) => void;
+/**
+ * Process one GEORawL1 block at frame offset `b`: extract the 250-bit
+ * SBAS L1 message, CRC-24Q gate it, and decode a GEO ephemeris if it is
+ * message type 9. Returns the ephemeris, `{ badCrc: true }` on a failed
+ * CRC, or `{}` for any other (non–type-9) message.
+ */
+declare function feedGeoBlock(view: DataView, b: number, onSbasMessage?: SbasMessageCb): {
+    eph?: GlonassEphemeris;
+    badCrc?: boolean;
+};
+/** Result of routing one GEORawL5 (4021) block. */
+interface GeoL5Result {
+    eph?: GlonassEphemeris;
+    badCrc?: boolean;
+    /** 'l1' = DO-229 content relayed on L5 (fed to `onSbasMessage`, decodable by
+     *  the L1 SbasProcessor); 'l5' = a native DFMC message (header only). */
+    kind?: 'l1' | 'l5';
+    /** Native-DFMC message type (Table B-98), when `kind === 'l5'`. */
+    dfmcType?: number;
+}
+/**
+ * Process one GEORawL5 block at frame offset `b`. The L5 signal carries a mix:
+ * GEOs relaying DO-229 (L1-format) content — routed to `onSbasMessage` and
+ * decoded for a GEO ephemeris exactly like {@link feedGeoBlock} — and GEOs
+ * broadcasting native DFMC frames, which are CRC-gated and surfaced via
+ * `onDfmcMessage` with their Table B-98 type but not field-decoded (see
+ * {@link ../navbits/sbas-l5}). Classification is by preamble.
+ */
+declare function feedGeoL5Block(view: DataView, b: number, onSbasMessage?: SbasMessageCb, onDfmcMessage?: DfmcMessageCb): GeoL5Result;
+interface SbfGeoNavResult {
+    /** SBAS GEO ephemerides in stream order, unchanged repeats suppressed. */
+    ephemerides: GlonassEphemeris[];
+    /** GEORawL1 messages whose CRC-24Q check failed (dropped). */
+    badCrc: number;
+    /** Total GEORawL1 blocks seen (with valid SBF framing). */
+    messages: number;
+}
+/**
+ * Decode every GEORawL1 block in an SBF byte stream into SBAS GEO
+ * ephemerides (message type 9), de-duping unchanged rebroadcasts by
+ * (PRN, time-of-clock). The one-pass {@link decodeSbfNavigation} routes
+ * the same blocks through {@link feedGeoBlock}; this standalone parser
+ * mirrors the per-constellation `parseSbf*` helpers.
+ */
+declare function parseSbfGeoNav(data: Uint8Array, opts?: {
+    onSbasMessage?: (msg: Uint8Array, prn: number, week: number, tow: number) => void;
+}): SbfGeoNavResult;
+/** Census of the SBAS L5 (DFMC) frames in a stream. Correction content is not
+ *  field-decoded (see {@link ../navbits/sbas-l5}). */
+interface DfmcCensus {
+    /** Native-DFMC frame count by Table B-98 message type. */
+    byType: Record<number, number>;
+    /** GEO PRNs (e.g. 'S21') broadcasting native DFMC. */
+    prns: string[];
+    /** Total CRC-valid native-DFMC frames. */
+    messages: number;
+}
+interface SbfGeoL5Result {
+    /** GEO ephemerides from DO-229 (L1-format) content relayed on L5 (MT9). */
+    ephemerides: GlonassEphemeris[];
+    /** CRC-valid L5-signal frames carrying DO-229 (L1-format) content. */
+    legacyMessages: number;
+    /** Native-DFMC frame census. */
+    dfmc: DfmcCensus;
+    /** GEORawL5 frames whose CRC-24Q check failed (dropped). */
+    badCrc: number;
+    /** Total GEORawL5 blocks seen (with valid SBF framing). */
+    messages: number;
+}
+/**
+ * Decode every GEORawL5 (4021) block in an SBF byte stream. DO-229 (L1-format)
+ * content relayed on L5 is fed to `onSbasMessage` (usable by the L1
+ * SbasProcessor) and decoded for GEO ephemerides; native DFMC frames are
+ * CRC-gated and counted by message type. The one-pass
+ * {@link ../sbf/navigation.decodeSbfNavigation} performs the same routing.
+ */
+declare function parseSbfGeoL5(data: Uint8Array, opts?: {
+    onSbasMessage?: SbasMessageCb;
+    onDfmcMessage?: DfmcMessageCb;
+}): SbfGeoL5Result;
+
 /**
  * One-pass SBF navigation decoder.
  *
@@ -251,6 +336,8 @@ interface SbfNavCounts {
     bdsRaw: number;
     /** Raw SBAS L1 GEO message blocks (GEORawL1). */
     sbasRaw: number;
+    /** Raw SBAS L5 GEO message blocks (GEORawL5) — DO-229-on-L5 + native DFMC. */
+    sbasL5Raw: number;
     /** Frames dropped by a CRC/parity check across all raw decoders. */
     badFrames: number;
 }
@@ -270,6 +357,9 @@ interface SbfNavigation {
     ionoCorrections: Record<string, number[]>;
     /** GPS-UTC ΔtLS from the last GPSUtc block, if any. */
     leapSeconds: number | null;
+    /** SBAS L5 (DFMC) native-frame census — message-type counts + GEO PRNs. The
+     *  correction content is not field-decoded (see navbits/sbas-l5). */
+    dfmc: DfmcCensus;
     counts: SbfNavCounts;
 }
 /**
@@ -282,6 +372,9 @@ declare function decodeSbfNavigation(data: Uint8Array, opts?: {
     /** Called for every CRC-valid SBAS L1 message (all types) — feed an
      *  {@link ../positioning/sbas.SbasProcessor} to build SBAS corrections. */
     onSbasMessage?: (msg: Uint8Array, prn: number, week: number, tow: number) => void;
+    /** Called for every CRC-valid native-DFMC (L5) message, with its Table
+     *  B-98 type — for inspection; the payload is not field-decoded. */
+    onDfmcMessage?: DfmcMessageCb;
 }): SbfNavigation;
 
 /**
@@ -383,34 +476,25 @@ interface SbfGloNavResult {
 }
 declare function parseSbfGloNav(data: Uint8Array): SbfGloNavResult;
 
+/** DFMC L5 preamble: 24-bit unique word 0x5C693A, distributed 4 bits over six
+ *  successive blocks (Annex 10 §3.5.10.2). */
+declare const SBAS_L5_PREAMBLE_UW = 6056250;
 /**
- * Process one GEORawL1 block at frame offset `b`: extract the 250-bit
- * SBAS L1 message, CRC-24Q gate it, and decode a GEO ephemeris if it is
- * message type 9. Returns the ephemeris, `{ badCrc: true }` on a failed
- * CRC, or `{}` for any other (non–type-9) message.
+ * Classify a CRC-valid GEO message by its preamble. The L5 signal carries a
+ * mix: some GEOs relay DO-229 (L1-format) content on L5 — decodable by the
+ * existing L1 {@link ../positioning/sbas.SbasProcessor} — while others carry
+ * native DFMC frames. The 8-bit L1 preamble is checked first (definitive);
+ * anything else is treated as DFMC.
  */
-declare function feedGeoBlock(view: DataView, b: number, onSbasMessage?: (msg: Uint8Array, prn: number, week: number, tow: number) => void): {
-    eph?: GlonassEphemeris;
-    badCrc?: boolean;
-};
-interface SbfGeoNavResult {
-    /** SBAS GEO ephemerides in stream order, unchanged repeats suppressed. */
-    ephemerides: GlonassEphemeris[];
-    /** GEORawL1 messages whose CRC-24Q check failed (dropped). */
-    badCrc: number;
-    /** Total GEORawL1 blocks seen (with valid SBF framing). */
-    messages: number;
-}
-/**
- * Decode every GEORawL1 block in an SBF byte stream into SBAS GEO
- * ephemerides (message type 9), de-duping unchanged rebroadcasts by
- * (PRN, time-of-clock). The one-pass {@link decodeSbfNavigation} routes
- * the same blocks through {@link feedGeoBlock}; this standalone parser
- * mirrors the per-constellation `parseSbf*` helpers.
- */
-declare function parseSbfGeoNav(data: Uint8Array, opts?: {
-    onSbasMessage?: (msg: Uint8Array, prn: number, week: number, tow: number) => void;
-}): SbfGeoNavResult;
+declare function isSbasL1Preamble(msg: Uint8Array): boolean;
+/** L5 (DFMC) message type — 6 bits after the 4-bit preamble (Table B-98). */
+declare function sbasL5MessageType(msg: Uint8Array): number;
+/** Table B-98 — L5 (DFMC) broadcast message types. */
+declare const SBAS_L5_MT_NAMES: Readonly<Record<number, string>>;
+/** Human-readable name for an L5 (DFMC) message type. */
+declare function sbasL5MessageName(type: number): string;
+/** True for L5 types that carry actual corrections (vs test/null/spare). */
+declare function isSbasL5Correction(type: number): boolean;
 
 /** Constellations HAS corrects: GPS (GNSS ID 0), Galileo (GNSS ID 2). */
 type HasSystem = 'G' | 'E';
@@ -647,4 +731,4 @@ interface SbfParseResult {
  */
 declare function parseSbfMeas(data: Uint8Array): SbfParseResult;
 
-export { CnavEphemeris, type HasMessage, ReceiverPvt, type SbfBdsNavResult, type SbfCnavEphemeris, type SbfCnavResult, type SbfGalEphemeris, type SbfGalNavResult, type SbfGeoNavResult, type SbfGloNavResult, type SbfGpsNavResult, type SbfHasMessage, type SbfHasResult, type SbfIonoUtcResult, type SbfMeasEpoch, type SbfMeasurement, type SbfNavCounts, type SbfNavigation, type SbfParseResult, type SbfPvt, type SbfPvtResult, type SbfReceiverSetup, decodeSbfNavigation, feedGeoBlock, parseSbfBdsNav, parseSbfCnav, parseSbfGalNav, parseSbfGeoNav, parseSbfGloNav, parseSbfGpsNav, parseSbfHas, parseSbfIonoUtc, parseSbfMeas, parseSbfPvt, parseSbfReceiverSetup, crc16 as sbfCrc16, scanSbfFrames };
+export { CnavEphemeris, type DfmcCensus, type DfmcMessageCb, type GeoL5Result, type HasMessage, ReceiverPvt, SBAS_L5_MT_NAMES, SBAS_L5_PREAMBLE_UW, type SbasMessageCb, type SbfBdsNavResult, type SbfCnavEphemeris, type SbfCnavResult, type SbfGalEphemeris, type SbfGalNavResult, type SbfGeoL5Result, type SbfGeoNavResult, type SbfGloNavResult, type SbfGpsNavResult, type SbfHasMessage, type SbfHasResult, type SbfIonoUtcResult, type SbfMeasEpoch, type SbfMeasurement, type SbfNavCounts, type SbfNavigation, type SbfParseResult, type SbfPvt, type SbfPvtResult, type SbfReceiverSetup, decodeSbfNavigation, feedGeoBlock, feedGeoL5Block, isSbasL1Preamble, isSbasL5Correction, parseSbfBdsNav, parseSbfCnav, parseSbfGalNav, parseSbfGeoL5, parseSbfGeoNav, parseSbfGloNav, parseSbfGpsNav, parseSbfHas, parseSbfIonoUtc, parseSbfMeas, parseSbfPvt, parseSbfReceiverSetup, sbasL5MessageName, sbasL5MessageType, crc16 as sbfCrc16, scanSbfFrames };

package/dist/sbf.js

@@ -1,11 +1,17 @@
 import {
+  SBAS_L5_MT_NAMES,
+  SBAS_L5_PREAMBLE_UW,
   crc16,
   decodeSbfNavigation,
   feedGeoBlock,
+  feedGeoL5Block,
+  isSbasL1Preamble,
+  isSbasL5Correction,
   parseSbfAlmanac,
   parseSbfBdsNav,
   parseSbfCnav,
   parseSbfGalNav,
+  parseSbfGeoL5,
   parseSbfGeoNav,
   parseSbfGloNav,
   parseSbfGpsNav,
@@ -15,8 +21,10 @@ import {
   parseSbfNav,
   parseSbfPvt,
   parseSbfReceiverSetup,
+  sbasL5MessageName,
+  sbasL5MessageType,
   scanSbfFrames
-} from "./chunk-ZPNMIUNZ.js";
+} from "./chunk-UHLUAU6H.js";
 import "./chunk-FA2UTLEQ.js";
 import "./chunk-WQX354KD.js";
 import "./chunk-37QNKGTC.js";
@@ -26,12 +34,18 @@ import "./chunk-V2D5KUKH.js";
 import "./chunk-HVXYFUCB.js";
 import "./chunk-LEEU5OIO.js";
 export {
+  SBAS_L5_MT_NAMES,
+  SBAS_L5_PREAMBLE_UW,
   decodeSbfNavigation,
   feedGeoBlock,
+  feedGeoL5Block,
+  isSbasL1Preamble,
+  isSbasL5Correction,
   parseSbfAlmanac,
   parseSbfBdsNav,
   parseSbfCnav,
   parseSbfGalNav,
+  parseSbfGeoL5,
   parseSbfGeoNav,
   parseSbfGloNav,
   parseSbfGpsNav,
@@ -41,6 +55,8 @@ export {
   parseSbfNav,
   parseSbfPvt,
   parseSbfReceiverSetup,
+  sbasL5MessageName,
+  sbasL5MessageType,
   crc16 as sbfCrc16,
   scanSbfFrames
 };

package/package.json

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