gnss-js 0.1.2 → 1.0.0

package/dist/rtcm3.d.cts

@@ -0,0 +1,143 @@
+import { a as Rtcm3Frame, E as EphemerisInfo } from './ephemeris-BUWzfmBy.cjs';
+export { B as BitReader, R as Rtcm3Decoder, d as decodeEphemeris, r as readString } from './ephemeris-BUWzfmBy.cjs';
+
+/**
+ * Full RTCM3 MSM4-7 decoder — extracts pseudorange, carrier phase,
+ * Doppler, and C/N0 for every satellite × signal cell.
+ *
+ * Reference: BNC 2.13.4 RTCM3Decoder.cpp (BKG) and RTCM 10403.3 §3.5.
+ *
+ * Only MSM types 4-7 are decoded (full data). Types 1-3 carry partial
+ * data and are skipped.
+ */
+
+/** Single signal observation for one satellite */
+interface MsmSignal {
+    /** RINEX 2-char obs code, e.g. "1C", "5X" */
+    rinexCode: string;
+    /** Pseudorange in meters (undefined if invalid) */
+    pseudorange?: number;
+    /** Carrier phase in cycles (undefined if invalid) */
+    phase?: number;
+    /** Doppler in Hz (undefined if invalid) */
+    doppler?: number;
+    /** Signal-to-noise ratio in dB-Hz */
+    cn0?: number;
+    /** Lock time in seconds */
+    lockTime?: number;
+    /** Half-cycle ambiguity indicator */
+    halfCycle?: boolean;
+    /** Wavelength used (meters) — needed for RINEX phase */
+    wavelength: number;
+}
+/** All observations for one satellite in one epoch */
+interface MsmSatObs {
+    /** PRN string, e.g. "G01", "R15", "E04" */
+    prn: string;
+    /** System letter: G, R, E, C, J, I, S */
+    system: string;
+    /** Signal observations */
+    signals: MsmSignal[];
+}
+/** One decoded MSM epoch */
+interface MsmEpoch {
+    /** Message type (1074, 1077, etc.) */
+    messageType: number;
+    /** Epoch time as GPS milliseconds of week (or GLONASS day-of-week ms, BDS SOW) */
+    epochMs: number;
+    /** System letter */
+    system: string;
+    /** Observations per satellite */
+    observations: MsmSatObs[];
+}
+/**
+ * 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;
+/**
+ * Convert MSM 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).
+ *
+ * Requires an approximate reference time to resolve the current week.
+ */
+declare function msmEpochToDate(sys: string, epochMs: number, refTime?: Date): Date;
+/**
+ * Reset the GLONASS frequency number cache (e.g., when switching mountpoints).
+ */
+declare function resetGloFreqCache(): void;
+
+/**
+ * RTCM3 station metadata decoders (messages 1005/1006, 1007/1008, 1029, 1033).
+ */
+
+interface StationMeta {
+    stationId: number | null;
+    itrf: number | null;
+    position: [number, number, number] | null;
+    antennaHeight: number | null;
+    antennaType: string | null;
+    antennaSerial: string | null;
+    antennaSetupId: number | null;
+    receiverType: string | null;
+    receiverFirmware: string | null;
+    receiverSerial: string | null;
+    description: string | null;
+}
+declare function createStationMeta(): StationMeta;
+/** Update station metadata from an RTCM3 frame. Returns true if the frame was a metadata message. */
+declare function updateStationMeta(meta: StationMeta, frame: Rtcm3Frame): boolean;
+
+/**
+ * RTCM3 stream statistics — tracks message types, satellite C/N0,
+ * ephemerides, and station metadata from a live NTRIP stream.
+ */
+
+/** Per-signal C/N0 for one satellite */
+interface SignalCn0 {
+    /** RINEX 2-char obs code, e.g. "1C", "5X" */
+    code: string;
+    /** C/N0 in dB-Hz */
+    cn0: number;
+}
+interface SatCn0 {
+    prn: string;
+    system: string;
+    cn0: number;
+    lastSeen: number;
+    /** Per-signal C/N0 values */
+    signals: SignalCn0[];
+}
+interface MessageTypeStats {
+    messageType: number;
+    name: string;
+    count: number;
+    lastSeen: number;
+    constellation: string | null;
+    totalBytes: number;
+}
+interface StreamStats {
+    totalBytes: number;
+    totalFrames: number;
+    startTime: number;
+    messageTypes: Map<number, MessageTypeStats>;
+    bytesPerSecond: number;
+    framesPerSecond: number;
+    /** Per-satellite C/N0 from MSM messages. Key = PRN (e.g. "G01"). */
+    satellites: Map<string, SatCn0>;
+    /** Per-satellite ephemeris data. Key = PRN (e.g. "G01"). */
+    ephemerides: Map<string, EphemerisInfo>;
+    /** Observed RINEX codes per system (e.g. G → ["C1C","L1C","S1C"]). */
+    obsTypes: Record<string, Set<string>>;
+    /** Station metadata from RTCM3 descriptor messages. */
+    stationMeta: StationMeta;
+}
+/** Known RTCM3 message type names. */
+declare const RTCM3_MESSAGE_NAMES: Record<number, string>;
+/** RTCM3 message type to constellation mapping. */
+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, decodeMsmFull, msmEpochToDate, resetGloFreqCache, rtcm3Constellation, updateStationMeta, updateStreamStats };

package/dist/rtcm3.d.ts

@@ -0,0 +1,143 @@
+import { a as Rtcm3Frame, E as EphemerisInfo } from './ephemeris-BUWzfmBy.js';
+export { B as BitReader, R as Rtcm3Decoder, d as decodeEphemeris, r as readString } from './ephemeris-BUWzfmBy.js';
+
+/**
+ * Full RTCM3 MSM4-7 decoder — extracts pseudorange, carrier phase,
+ * Doppler, and C/N0 for every satellite × signal cell.
+ *
+ * Reference: BNC 2.13.4 RTCM3Decoder.cpp (BKG) and RTCM 10403.3 §3.5.
+ *
+ * Only MSM types 4-7 are decoded (full data). Types 1-3 carry partial
+ * data and are skipped.
+ */
+
+/** Single signal observation for one satellite */
+interface MsmSignal {
+    /** RINEX 2-char obs code, e.g. "1C", "5X" */
+    rinexCode: string;
+    /** Pseudorange in meters (undefined if invalid) */
+    pseudorange?: number;
+    /** Carrier phase in cycles (undefined if invalid) */
+    phase?: number;
+    /** Doppler in Hz (undefined if invalid) */
+    doppler?: number;
+    /** Signal-to-noise ratio in dB-Hz */
+    cn0?: number;
+    /** Lock time in seconds */
+    lockTime?: number;
+    /** Half-cycle ambiguity indicator */
+    halfCycle?: boolean;
+    /** Wavelength used (meters) — needed for RINEX phase */
+    wavelength: number;
+}
+/** All observations for one satellite in one epoch */
+interface MsmSatObs {
+    /** PRN string, e.g. "G01", "R15", "E04" */
+    prn: string;
+    /** System letter: G, R, E, C, J, I, S */
+    system: string;
+    /** Signal observations */
+    signals: MsmSignal[];
+}
+/** One decoded MSM epoch */
+interface MsmEpoch {
+    /** Message type (1074, 1077, etc.) */
+    messageType: number;
+    /** Epoch time as GPS milliseconds of week (or GLONASS day-of-week ms, BDS SOW) */
+    epochMs: number;
+    /** System letter */
+    system: string;
+    /** Observations per satellite */
+    observations: MsmSatObs[];
+}
+/**
+ * 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;
+/**
+ * Convert MSM 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).
+ *
+ * Requires an approximate reference time to resolve the current week.
+ */
+declare function msmEpochToDate(sys: string, epochMs: number, refTime?: Date): Date;
+/**
+ * Reset the GLONASS frequency number cache (e.g., when switching mountpoints).
+ */
+declare function resetGloFreqCache(): void;
+
+/**
+ * RTCM3 station metadata decoders (messages 1005/1006, 1007/1008, 1029, 1033).
+ */
+
+interface StationMeta {
+    stationId: number | null;
+    itrf: number | null;
+    position: [number, number, number] | null;
+    antennaHeight: number | null;
+    antennaType: string | null;
+    antennaSerial: string | null;
+    antennaSetupId: number | null;
+    receiverType: string | null;
+    receiverFirmware: string | null;
+    receiverSerial: string | null;
+    description: string | null;
+}
+declare function createStationMeta(): StationMeta;
+/** Update station metadata from an RTCM3 frame. Returns true if the frame was a metadata message. */
+declare function updateStationMeta(meta: StationMeta, frame: Rtcm3Frame): boolean;
+
+/**
+ * RTCM3 stream statistics — tracks message types, satellite C/N0,
+ * ephemerides, and station metadata from a live NTRIP stream.
+ */
+
+/** Per-signal C/N0 for one satellite */
+interface SignalCn0 {
+    /** RINEX 2-char obs code, e.g. "1C", "5X" */
+    code: string;
+    /** C/N0 in dB-Hz */
+    cn0: number;
+}
+interface SatCn0 {
+    prn: string;
+    system: string;
+    cn0: number;
+    lastSeen: number;
+    /** Per-signal C/N0 values */
+    signals: SignalCn0[];
+}
+interface MessageTypeStats {
+    messageType: number;
+    name: string;
+    count: number;
+    lastSeen: number;
+    constellation: string | null;
+    totalBytes: number;
+}
+interface StreamStats {
+    totalBytes: number;
+    totalFrames: number;
+    startTime: number;
+    messageTypes: Map<number, MessageTypeStats>;
+    bytesPerSecond: number;
+    framesPerSecond: number;
+    /** Per-satellite C/N0 from MSM messages. Key = PRN (e.g. "G01"). */
+    satellites: Map<string, SatCn0>;
+    /** Per-satellite ephemeris data. Key = PRN (e.g. "G01"). */
+    ephemerides: Map<string, EphemerisInfo>;
+    /** Observed RINEX codes per system (e.g. G → ["C1C","L1C","S1C"]). */
+    obsTypes: Record<string, Set<string>>;
+    /** Station metadata from RTCM3 descriptor messages. */
+    stationMeta: StationMeta;
+}
+/** Known RTCM3 message type names. */
+declare const RTCM3_MESSAGE_NAMES: Record<number, string>;
+/** RTCM3 message type to constellation mapping. */
+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, decodeMsmFull, msmEpochToDate, resetGloFreqCache, rtcm3Constellation, updateStationMeta, updateStreamStats };

package/dist/rtcm3.js

@@ -0,0 +1,31 @@
+import {
+  BitReader,
+  RTCM3_MESSAGE_NAMES,
+  Rtcm3Decoder,
+  createStationMeta,
+  createStreamStats,
+  decodeEphemeris,
+  decodeMsmFull,
+  msmEpochToDate,
+  readString,
+  resetGloFreqCache,
+  rtcm3Constellation,
+  updateStationMeta,
+  updateStreamStats
+} from "./chunk-PRSZIWKM.js";
+import "./chunk-354IRDOG.js";
+export {
+  BitReader,
+  RTCM3_MESSAGE_NAMES,
+  Rtcm3Decoder,
+  createStationMeta,
+  createStreamStats,
+  decodeEphemeris,
+  decodeMsmFull,
+  msmEpochToDate,
+  readString,
+  resetGloFreqCache,
+  rtcm3Constellation,
+  updateStationMeta,
+  updateStreamStats
+};