@neilberkman/sidereon 0.32.0 → 0.34.0

package/pkg-node/sidereon.d.ts

@@ -36,7 +36,7 @@ export interface Sp3ArtifactIdentityInput {
     archiveSha256: string;
     /** Positive integer no greater than Number.MAX_SAFE_INTEGER. */
     archiveByteLength: number;
-    compression: "none" | "gzip";
+    compression: "none" | "gzip" | "unix_compress";
 }
 
 /** Validated canonical artifact record returned by merged-SP3 identity APIs. */
@@ -505,68 +505,44 @@ export interface PppTemporalCorrelation {
 
 export type PppScalarMap = Record<string, number>;
 
+/**
+ * Fusion serde contracts are intentionally unrefined until their complete
+ * current input and serialized-output surfaces are audited together.
+ */
 export interface FusionConfig {
-    filterKind?: "ekf" | "ukf";
-    initialState?: Record<string, number | number[]>;
-    processNoise?: Record<string, number>;
-    leverArmBodyM?: Vec3;
-    timeSync?: FusionTimeSyncConfig;
+    [key: string]: any;
 }
 
 export interface FusionTimeSyncConfig {
-    maxRetainedSamples?: number;
-    maxRetainedEpochs?: number;
+    [key: string]: any;
 }
 
 export interface ImuSampleInput {
-    dtS: number;
-    accelMps2?: Vec3;
-    gyroRadS?: Vec3;
-    deltaVelocityMps?: Vec3;
-    deltaAngleRad?: Vec3;
+    [key: string]: any;
 }
 
 export interface FusionLooseMeasurement {
-    epochJ2000S?: number;
-    positionM: Vec3;
-    velocityMps?: Vec3;
-    positionCovarianceM2?: Matrix3;
-    velocityCovarianceM2?: Matrix3;
+    [key: string]: any;
 }
 
 export interface FusionTightEpoch {
-    observations: SppObservation[];
-    tRxJ2000S: number;
-    tRxSecondOfDayS: number;
-    dayOfYear: number;
-    corrections?: SppCorrections;
-    met?: SurfaceMetInput;
+    [key: string]: any;
 }
 
 export interface FusionUpdate {
-    accepted: boolean;
-    normalizedInnovationSquared?: number;
-    reason?: string;
+    [key: string]: any;
 }
 
 export interface FusionState {
-    epochJ2000S?: number;
-    positionM: [number, number, number];
-    velocityMps: [number, number, number];
-    attitudeQuaternion?: [number, number, number, number];
-    covariance?: number[];
+    [key: string]: any;
 }
 
 export interface FusionTimeSyncStatus {
-    retainedSamples: number;
-    retainedEpochs: number;
-    maxRetainedSamples: number;
-    maxRetainedEpochs: number;
+    [key: string]: any;
 }
 
 export interface FusionRtsEpoch {
-    epochJ2000S: number;
-    state: FusionState;
+    [key: string]: any;
 }
 
 export interface DllJitterOptions {
@@ -2500,6 +2476,62 @@ export class ErrorEllipse2 {
     readonly semiMinor: number;
 }
 
+/**
+ * Accepted boundary convention for a validated exact SP3 product.
+ */
+export enum ExactSp3Coverage {
+    /**
+     * The declared boundary is excluded (288 five-minute epochs in one day).
+     */
+    HalfOpen = 0,
+    /**
+     * The declared boundary epoch is present (289 five-minute epochs).
+     */
+    Inclusive = 1,
+}
+
+/**
+ * Result of parsing and validating exact SP3 bytes in one core call.
+ */
+export class ExactSp3ParseResult {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    readonly coverage: ExactSp3Coverage;
+    /**
+     * Return the validated parsed product.
+     */
+    readonly product: Sp3;
+}
+
+/**
+ * Source-independent exact SP3 content request.
+ */
+export class ExactSp3Request {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Construct an exact request from a complete catalog product identity.
+     */
+    static fromIdentity(identity: GnssProductIdentity): ExactSp3Request;
+    /**
+     * Construct an exact request from explicit catalog identity fields.
+     */
+    constructor(year: number, month: number, day: number, span: string, sample: string, issue?: string | null);
+    /**
+     * Require a particular SP3 line-1 producing-agency code.
+     */
+    requireAgency(agency: string): void;
+    readonly day: number;
+    readonly expectedAgency: string | undefined;
+    readonly formatVersion: string | undefined;
+    readonly issue: string | undefined;
+    readonly month: number;
+    readonly sample: string;
+    readonly span: string;
+    readonly year: number;
+}
+
 /**
  * A fault-detection-and-exclusion result: the surviving solution, the excluded
  * satellites in exclusion order, and the number of exclusions performed.
@@ -2665,7 +2697,7 @@ export class FusionRtsHistory {
     /**
      * Recorded epochs in forward time order.
      */
-    readonly epochs: FusionRtsEpoch[];
+    readonly epochs: any;
 }
 
 /**
@@ -3021,7 +3053,7 @@ export class GnssInsFilter {
     /**
      * Replace retained-history capacities for later time-sync replay.
      */
-    configureTimeSync(config: FusionTimeSyncConfig): void;
+    configureTimeSync(config: any): void;
     /**
      * Encode the current fusion state with the core versioned binary codec.
      */
@@ -3029,23 +3061,23 @@ export class GnssInsFilter {
     /**
      * Build a filter, then restore its state from versioned fusion-state bytes.
      */
-    static fromStateBytes(config: FusionConfig, bytes: Uint8Array): GnssInsFilter;
+    static fromStateBytes(config: any, bytes: Uint8Array): GnssInsFilter;
     /**
      * Build a filter from a JS configuration object.
      */
-    constructor(config: FusionConfig);
+    constructor(config: any);
     /**
      * Propagate the filter with one IMU rate or increment sample.
      */
-    propagate(sample: ImuSampleInput): FusionState;
+    propagate(sample: any): any;
     /**
      * Propagate the filter with a JS array of IMU samples.
      */
-    propagateBatch(samples: ImuSampleInput[]): FusionState[];
+    propagateBatch(samples: any): any;
     /**
      * Propagate and record the transition for later fusion RTS smoothing.
      */
-    propagateRecorded(sample: ImuSampleInput, history: FusionRtsHistoryBuilder): FusionState;
+    propagateRecorded(sample: any, history: FusionRtsHistoryBuilder): any;
     /**
      * Restore this filter from versioned fusion-state bytes.
      */
@@ -3053,67 +3085,67 @@ export class GnssInsFilter {
     /**
      * Current INS state, covariance, and last body-rate diagnostic.
      */
-    state(): FusionState;
+    state(): any;
     /**
      * Current tight-coupling receiver-clock state.
      */
-    tightClockState(): Record<string, number>;
+    tightClockState(): any;
     /**
      * Current retained-history capacity and occupancy.
      */
-    timeSyncStatus(): FusionTimeSyncStatus;
+    timeSyncStatus(): any;
     /**
      * Apply a loose position or position-velocity GNSS fix at the current epoch.
      */
-    updateLoose(measurement: FusionLooseMeasurement): FusionUpdate;
+    updateLoose(measurement: any): any;
     /**
      * Apply a loose GNSS fix and record checkpoints for fusion RTS smoothing.
      */
-    updateLooseRecorded(measurement: FusionLooseMeasurement, history: FusionRtsHistoryBuilder): FusionUpdate;
+    updateLooseRecorded(measurement: any, history: FusionRtsHistoryBuilder): any;
     /**
      * Apply a loose GNSS fix, replaying retained IMU checkpoints when it is late.
      */
-    updateLooseTimeSync(measurement: FusionLooseMeasurement): FusionUpdate;
+    updateLooseTimeSync(measurement: any): any;
     /**
      * Apply a gated wheeled-vehicle non-holonomic constraint update.
      */
-    updateNonHolonomic(): FusionUpdate;
+    updateNonHolonomic(): any;
     /**
      * Apply a non-holonomic constraint and record checkpoints when an update applies.
      */
-    updateNonHolonomicRecorded(history: FusionRtsHistoryBuilder): FusionUpdate;
+    updateNonHolonomicRecorded(history: FusionRtsHistoryBuilder): any;
     /**
      * Apply a gated zero-velocity and zero-angular-rate update.
      */
-    updateStationary(): FusionUpdate;
+    updateStationary(): any;
     /**
      * Apply a stationary update and record checkpoints when an update applies.
      */
-    updateStationaryRecorded(history: FusionRtsHistoryBuilder): FusionUpdate;
+    updateStationaryRecorded(history: FusionRtsHistoryBuilder): any;
     /**
      * Apply a tight raw-observation epoch against a broadcast ephemeris source.
      */
-    updateTightBroadcast(broadcast: BroadcastEphemeris, epoch: FusionTightEpoch): FusionUpdate;
+    updateTightBroadcast(broadcast: BroadcastEphemeris, epoch: any): any;
     /**
      * Apply a tight broadcast update and record checkpoints for fusion RTS smoothing.
      */
-    updateTightBroadcastRecorded(broadcast: BroadcastEphemeris, epoch: FusionTightEpoch, history: FusionRtsHistoryBuilder): FusionUpdate;
+    updateTightBroadcastRecorded(broadcast: BroadcastEphemeris, epoch: any, history: FusionRtsHistoryBuilder): any;
     /**
      * Apply a tight broadcast update, replaying retained IMU checkpoints when it is late.
      */
-    updateTightBroadcastTimeSync(broadcast: BroadcastEphemeris, epoch: FusionTightEpoch): FusionUpdate;
+    updateTightBroadcastTimeSync(broadcast: BroadcastEphemeris, epoch: any): any;
     /**
      * Apply a tight raw-observation epoch against an SP3 source.
      */
-    updateTightSp3(sp3: Sp3, epoch: FusionTightEpoch): FusionUpdate;
+    updateTightSp3(sp3: Sp3, epoch: any): any;
     /**
      * Apply a tight SP3 update and record checkpoints for fusion RTS smoothing.
      */
-    updateTightSp3Recorded(sp3: Sp3, epoch: FusionTightEpoch, history: FusionRtsHistoryBuilder): FusionUpdate;
+    updateTightSp3Recorded(sp3: Sp3, epoch: any, history: FusionRtsHistoryBuilder): any;
     /**
      * Apply a tight SP3 update, replaying retained IMU checkpoints when it is late.
      */
-    updateTightSp3TimeSync(sp3: Sp3, epoch: FusionTightEpoch): FusionUpdate;
+    updateTightSp3TimeSync(sp3: Sp3, epoch: any): any;
 }
 
 /**
@@ -4431,7 +4463,7 @@ export class NmeaParseResult {
     [Symbol.dispose](): void;
     readonly diagnostics: any;
     readonly epochCount: number;
-    readonly epochs: FusionRtsEpoch[];
+    readonly epochs: any;
     readonly sentenceCount: number;
     readonly sentences: any;
 }
@@ -4445,7 +4477,7 @@ export class NtripClientMachine {
     connectionRequest(): Uint8Array;
     finish(): any;
     ggaMessage(now_s: number, position: any, utc_seconds_of_day: number): any;
-    constructor(config: FusionConfig);
+    constructor(config: any);
     push(bytes: Uint8Array): any;
     reset(): void;
     readonly state: NtripState;
@@ -6520,7 +6552,7 @@ export class RtkFloatSolution {
     /**
      * Float single-difference ambiguities, metres, as an id-keyed object.
      */
-    readonly ambiguitiesM: PppScalarMap;
+    readonly ambiguitiesM: any;
     /**
      * Baseline (rover minus base) as a `Float64Array` `[dx, dy, dz]`, metres.
      */
@@ -7025,7 +7057,7 @@ export class SmoothedFusionTrajectory {
     /**
      * Smoothed epochs in the same order as the recorded history.
      */
-    readonly epochs: FusionRtsEpoch[];
+    readonly epochs: any;
 }
 
 export class SmoothedTrack {
@@ -7033,7 +7065,7 @@ export class SmoothedTrack {
     free(): void;
     [Symbol.dispose](): void;
     readonly epochCount: number;
-    readonly epochs: FusionRtsEpoch[];
+    readonly epochs: any;
 }
 
 /**
@@ -7226,6 +7258,16 @@ export class Sp3 {
      * `d`). Deterministic: the same product always produces byte-identical text.
      */
     toSp3String(): string;
+    /**
+     * Epoch count declared by SP3 header line 1, independent of the parsed
+     * body count used by [`Sp3::epochCount`].
+     */
+    readonly declaredEpochCount: number;
+    /**
+     * Start epoch declared by SP3 header line 1, in product-scale seconds
+     * since J2000. Missing or malformed legacy header fields return undefined.
+     */
+    readonly declaredStartJ2000Seconds: number | undefined;
     /**
      * Number of epochs in the product.
      */
@@ -7304,6 +7346,23 @@ export class Sp3ClockReferenceOffset {
     readonly satellites: number;
 }
 
+/**
+ * Cataloged relationship between an SP3 filename epoch and its first content
+ * epoch.
+ *
+ * New values may be appended in later interface releases.
+ */
+export enum Sp3ContentStartConvention {
+    /**
+     * The first content epoch equals the filename epoch.
+     */
+    FilenameEpoch = 0,
+    /**
+     * The first content epoch is exactly 24 hours before the filename epoch.
+     */
+    FilenameEpochMinusOneDay = 1,
+}
+
 /**
  * One coordinate-label reconciliation applied before SP3 merge consensus.
  */
@@ -8007,7 +8066,7 @@ export class StaticSolution {
     /**
      * Post-fit residuals as `{ epochIndex, satelliteId, residualM, ... }[]`.
      */
-    readonly residuals: PppResidual[];
+    readonly residuals: any;
     /**
      * Full state covariance, flat row-major square matrix in square metres.
      */
@@ -8709,7 +8768,7 @@ export class TrackFilterConfig {
     /**
      * Build a no-IMU track filter config from a JS object.
      */
-    constructor(config: FusionConfig);
+    constructor(config: any);
     toObject(): any;
     readonly dimension: number;
     readonly frame: string;
@@ -8721,7 +8780,7 @@ export class TrackRtsHistory {
     free(): void;
     [Symbol.dispose](): void;
     readonly epochCount: number;
-    readonly epochs: FusionRtsEpoch[];
+    readonly epochs: any;
 }
 
 export class TrackRtsHistoryBuilder {
@@ -9361,6 +9420,17 @@ export function decodeSsr(bytes: Uint8Array, framed?: boolean | null): any;
  */
 export function defaultPair(system: GnssSystem): CarrierPair | undefined;
 
+/**
+ * Return the officially cataloged default sampling token for a product date.
+ *
+ * Unlike the legacy date-free default, this preserves historical cadence
+ * changes such as the GFZ rapid and ultra-rapid transitions. On ESA
+ * ultra-rapid's issue-level transition date this reports the `0000`/
+ * start-of-day default; [`productIdentity`](product_identity) also considers
+ * the requested issue.
+ */
+export function defaultSampleForDate(center: string, family: string, year: number, month: number, day: number): string;
+
 /**
  * Default scenario seed as a hexadecimal string.
  */
@@ -10867,6 +10937,11 @@ export function parseCdmKvn(text: string): Cdm;
  */
 export function parseCdmXml(text: string): Cdm;
 
+/**
+ * Parse and exact-validate SP3 bytes, returning both product and coverage.
+ */
+export function parseExactSp3(bytes: Uint8Array, request: ExactSp3Request): ExactSp3ParseResult;
+
 /**
  * Parse NAVCEN's GPS constellation status HTML into status rows.
  *
@@ -11102,10 +11177,19 @@ export function predictBatchSp3(sp3: Sp3, satellites: string[], receivers_ecef_m
 export function prepareIonosphereFreeRtkArc(epochs: RtkDualFrequencyArcEpoch[], wide_lane_cycles: Record<string, number>, config: RtkIonosphereFreeArcConfig): RtkIonosphereFreeArcResult;
 
 /**
- * Resolve an exact catalog product independently from distributor.
+ * Resolve an exact catalog product independently from distributor. When the
+ * sample is omitted, ultra-rapid issue-level cadence transitions are applied.
  */
 export function productIdentity(center: string, family: string, year: number, month: number, day: number, sample?: string | null, issue?: string | null): GnssProductIdentity;
 
+/**
+ * Return the catalog solution class for one center/product family.
+ *
+ * This product-aware query distinguishes IGS combined final SP3 (`final`)
+ * from IGS broadcast navigation (`broadcast`).
+ */
+export function productSolutionClass(center: string, family: string): string;
+
 /**
  * Propagate a fleet of already-initialized [`Tle`]s over a shared epoch grid in
  * a single call: the batched form of [`Tle.propagate`].
@@ -11744,6 +11828,25 @@ export function sourceSolveModeTdoa(reference_sensor: number): any;
  */
 export function sourceSolveModeToa(): string;
 
+/**
+ * Return the cataloged relationship between an SP3 filename epoch and its
+ * first content epoch.
+ *
+ * `issue` is required for ultra-rapid centers, must name a published issue,
+ * and must be omitted for product lines without issue times. Exact requests
+ * built with `ExactSp3Request.fromIdentity` apply this same catalog fact.
+ */
+export function sp3ContentStartConvention(center: string, year: number, month: number, day: number, issue?: string | null): Sp3ContentStartConvention;
+
+/**
+ * Return the signed whole seconds added to the filename epoch for a public
+ * content-start convention.
+ *
+ * JavaScript receives the `i64` result as a `bigint`, consistent with other
+ * exact integral values in this interface.
+ */
+export function sp3ContentStartOffsetSeconds(convention: Sp3ContentStartConvention): bigint;
+
 /**
  * Validate complete exact artifact records and return their canonical merge
  * input identity.
@@ -11867,6 +11970,18 @@ export function sunMoonEcef(epochs_unix_us: BigInt64Array): SunMoon;
  */
 export function sunMoonEci(epochs_unix_us: BigInt64Array): SunMoon;
 
+/**
+ * Return every officially cataloged sampling token for a product date and
+ * issue.
+ *
+ * Syntax alone is not publication evidence: this is the complete catalog set
+ * enforced by [`productIdentity`](product_identity). For issue-based product
+ * lines, omitting `issue` selects `0000`, matching
+ * [`defaultSampleForDate`](default_sample_for_date). Product construction
+ * itself still requires an explicit issue.
+ */
+export function supportedSamples(center: string, family: string, year: number, month: number, day: number, issue?: string | null): string[];
+
 /**
  * TAI-UTC (cumulative leap seconds) in effect on a UTC calendar date.
  *
@@ -12011,6 +12126,11 @@ export function validate(records: any): any;
  */
 export function validateAgainstSp3Ids(records: any, ids: any): any;
 
+/**
+ * Validate an already parsed SP3 product against an exact request.
+ */
+export function validateExactSp3(product: Sp3, request: ExactSp3Request): ExactSp3Coverage;
+
 /**
  * Blend a first good post-outage fix back over an outage span.
  */