@neilberkman/sidereon 2.0.0 → 2.1.0

package/pkg-node/sidereon.d.ts

@@ -160,6 +160,7 @@ export type Sp3MergeOptions = Sp3MergeIdentityOptions;
 export interface Sp3ContinuityOptions {
     orbitClass?: "meo_gnss" | "geosynchronous" | "leo" | null;
     residualToleranceM?: number | null;
+    gapThresholdFactor?: number | null;
 }
 
 export interface ContinuityDefect {
@@ -6049,7 +6050,7 @@ export class PreciseEphemerisInterpolant {
     /**
      * Build a cached interpolant from an existing sample-backed precise source.
      */
-    static fromPreciseEphemerisSamples(source: PreciseEphemerisSampleSource): PreciseEphemerisInterpolant;
+    static fromPreciseEphemerisSamples(source: PreciseEphemerisSampleSource, gapThresholdFactor?: number | null): PreciseEphemerisInterpolant;
     /**
      * Build a cached interpolant directly from precise samples.
      *
@@ -6059,14 +6060,14 @@ export class PreciseEphemerisInterpolant {
      * J2000 and positions in ECEF metres. Throws a `TypeError` for malformed
      * JS input and a `RangeError` for sample validation failures.
      */
-    static fromSamples(samples: any): PreciseEphemerisInterpolant;
+    static fromSamples(samples: any, gapThresholdFactor?: number | null): PreciseEphemerisInterpolant;
     /**
      * Build a cached interpolant from a parsed SP3 precise product.
      *
      * Nodes are copied from the product's native SP3 records. Query epochs are
      * seconds since J2000 in the SP3 product time scale.
      */
-    static fromSp3(sp3: Sp3): PreciseEphemerisInterpolant;
+    static fromSp3(sp3: Sp3, gapThresholdFactor?: number | null): PreciseEphemerisInterpolant;
     /**
      * Query ECEF position and optional clock for parallel satellite and epoch
      * arrays using this cached interpolant.
@@ -6095,6 +6096,14 @@ export class PreciseEphemerisInterpolant {
      * handle's time scale. The output matches [`Sp3.predictRanges`].
      */
     predictRanges(requests: any, options: any): any;
+    /**
+     * Return a copy of this interpolant with an explicit gap threshold factor.
+     */
+    withInterpolationOptions(gapThresholdFactor: number): PreciseEphemerisInterpolant;
+    /**
+     * SP3 interpolation gap threshold factor carried by this interpolant.
+     */
+    readonly gapThresholdFactor: number;
     /**
      * Satellite tokens this handle can interpolate, ascending.
      */
@@ -6143,6 +6152,14 @@ export class PreciseEphemerisSampleSource {
      * this is the sample-source entry point.
      */
     predictRanges(requests: any, options: any): any;
+    /**
+     * Return a copy of these samples with an explicit gap threshold factor.
+     */
+    withInterpolationOptions(gapThresholdFactor: number): PreciseEphemerisSampleSource;
+    /**
+     * SP3 interpolation gap threshold factor carried by this source.
+     */
+    readonly gapThresholdFactor: number;
     /**
      * The satellites this source can interpolate (e.g. `"G01"`), ascending.
      */
@@ -6199,6 +6216,10 @@ export class PreciseInterpolantArtifact {
      * Checksum provenance: `"verified"` or `"attested"`.
      */
     readonly digestProvenance: "verified" | "attested";
+    /**
+     * SP3 interpolation gap threshold factor read from the artifact header.
+     */
+    readonly gapThresholdFactor: number;
     /**
      * Satellite tokens present in the artifact, ascending.
      */
@@ -7456,13 +7477,14 @@ export class Sp3 {
      *
      * `orbitClass` is `"meo_gnss"` (default), `"geosynchronous"`, `"leo"`, or
      * `null` to disable the speed gate. `residualToleranceM` enables the
-     * residual check; `null` disables it.
+     * residual check; `null` disables it. `gapThresholdFactor` configures the
+     * hold-out interpolation policy; `null` leaves the core default (1.5).
      *
      * Returns `{ attested, defects, pairsChecked, residualsChecked,
      * residualsSkipped }`. Reports rather than refuses: whether a product with
      * defects is acceptable is the caller's decision.
      */
-    checkContinuity(orbitClass?: string | null, residualToleranceM?: number | null): ContinuityReport;
+    checkContinuity(orbitClass?: string | null, residualToleranceM?: number | null, gapThresholdFactor?: number | null): ContinuityReport;
     /**
      * Estimate `other`'s per-epoch common clock offset relative to this product.
      *
@@ -7481,7 +7503,7 @@ export class Sp3 {
      * Passing `null` disables the corresponding check. The returned object
      * retains both the influencing findings and the complete report.
      */
-    continuityVerdict(fromJ2000S: number, throughJ2000S: number, orbitClass?: string | null, residualToleranceM?: number | null): WindowContinuityVerdict;
+    continuityVerdict(fromJ2000S: number, throughJ2000S: number, orbitClass?: string | null, residualToleranceM?: number | null, gapThresholdFactor?: number | null): WindowContinuityVerdict;
     /**
      * Compute DGNSS pseudorange corrections from a surveyed base station.
      *
@@ -7558,8 +7580,11 @@ export class Sp3 {
     observableStatesAtSharedJ2000S(satellites: any, epoch_j2000_s: number): any;
     /**
      * Build deterministic precise-interpolant artifact bytes from this SP3 product.
+     *
+     * `gapThresholdFactor` optionally overrides the product's interpolation policy;
+     * `null` or omitted retains this product's active policy.
      */
-    preciseInterpolantArtifactBytes(): Uint8Array;
+    preciseInterpolantArtifactBytes(gapThresholdFactor?: number | null): Uint8Array;
     /**
      * Predict geometric ranges for many `(satellite, receiver, epoch)` requests
      * against this ephemeris in one call. `requests` is an array of
@@ -7633,6 +7658,10 @@ export class Sp3 {
      * `d`). Deterministic: the same product always produces byte-identical text.
      */
     toSp3String(): string;
+    /**
+     * Return a copy of this product with an explicit gap threshold factor.
+     */
+    withInterpolationOptions(gapThresholdFactor: number): Sp3;
     /**
      * Epoch count declared by SP3 header line 1, independent of the parsed
      * body count used by [`Sp3::epochCount`].
@@ -7647,6 +7676,10 @@ export class Sp3 {
      * Number of epochs in the product.
      */
     readonly epochCount: number;
+    /**
+     * SP3 interpolation gap threshold factor carried by this product.
+     */
+    readonly gapThresholdFactor: number;
     /**
      * Satellite tokens present in the product (e.g. `"G01"`), ascending.
      */
@@ -10977,8 +11010,11 @@ export function loadRinexObs(bytes: Uint8Array): RinexObs;
 /**
  * Parse an SP3-c or SP3-d byte buffer (the full, already-decompressed file)
  * into a precise-ephemeris product. Throws an `Error` on malformed input.
+ *
+ * `gapThresholdFactor` optionally configures the product-carried SP3 coverage-gap
+ * interpolation policy; omitted or `null` leaves the core default (1.5).
  */
-export function loadSp3(bytes: Uint8Array): Sp3;
+export function loadSp3(bytes: Uint8Array, gapThresholdFactor?: number | null): Sp3;
 
 /**
  * Locate a source from sensor arrival times.
@@ -11621,7 +11657,7 @@ export function pppCorrectionsWithCodeBias(sp3: Sp3, epochs: any, receiver_ecef_
  * (empty input, a single-sample satellite, non-monotonic epochs, a non-finite
  * sample). Delegates to `sidereon_core::sp3::PreciseEphemerisSamples::from_samples`.
  */
-export function preciseEphemerisSamplesFromSamples(samples: any): PreciseEphemerisSampleSource;
+export function preciseEphemerisSamplesFromSamples(samples: any, gapThresholdFactor?: number | null): PreciseEphemerisSampleSource;
 
 /**
  * Compute the precise-interpolant artifact file-level checksum for byte content.

package/pkg-node/sidereon.js

@@ -14018,12 +14018,16 @@ class PreciseEphemerisInterpolant {
     /**
      * Build a cached interpolant from an existing sample-backed precise source.
      * @param {PreciseEphemerisSampleSource} source
+     * @param {number | null} [gap_threshold_factor]
      * @returns {PreciseEphemerisInterpolant}
      */
-    static fromPreciseEphemerisSamples(source) {
+    static fromPreciseEphemerisSamples(source, gap_threshold_factor) {
         _assertClass(source, PreciseEphemerisSampleSource);
-        const ret = wasm.preciseephemerisinterpolant_fromPreciseEphemerisSamples(source.__wbg_ptr);
-        return PreciseEphemerisInterpolant.__wrap(ret);
+        const ret = wasm.preciseephemerisinterpolant_fromPreciseEphemerisSamples(source.__wbg_ptr, !isLikeNone(gap_threshold_factor), isLikeNone(gap_threshold_factor) ? 0 : gap_threshold_factor);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return PreciseEphemerisInterpolant.__wrap(ret[0]);
     }
     /**
      * Build a cached interpolant directly from precise samples.
@@ -14034,10 +14038,11 @@ class PreciseEphemerisInterpolant {
      * J2000 and positions in ECEF metres. Throws a `TypeError` for malformed
      * JS input and a `RangeError` for sample validation failures.
      * @param {any} samples
+     * @param {number | null} [gap_threshold_factor]
      * @returns {PreciseEphemerisInterpolant}
      */
-    static fromSamples(samples) {
-        const ret = wasm.preciseephemerisinterpolant_fromSamples(samples);
+    static fromSamples(samples, gap_threshold_factor) {
+        const ret = wasm.preciseephemerisinterpolant_fromSamples(samples, !isLikeNone(gap_threshold_factor), isLikeNone(gap_threshold_factor) ? 0 : gap_threshold_factor);
         if (ret[2]) {
             throw takeFromExternrefTable0(ret[1]);
         }
@@ -14049,12 +14054,24 @@ class PreciseEphemerisInterpolant {
      * Nodes are copied from the product's native SP3 records. Query epochs are
      * seconds since J2000 in the SP3 product time scale.
      * @param {Sp3} sp3
+     * @param {number | null} [gap_threshold_factor]
      * @returns {PreciseEphemerisInterpolant}
      */
-    static fromSp3(sp3) {
+    static fromSp3(sp3, gap_threshold_factor) {
         _assertClass(sp3, Sp3);
-        const ret = wasm.preciseephemerisinterpolant_fromSp3(sp3.__wbg_ptr);
-        return PreciseEphemerisInterpolant.__wrap(ret);
+        const ret = wasm.preciseephemerisinterpolant_fromSp3(sp3.__wbg_ptr, !isLikeNone(gap_threshold_factor), isLikeNone(gap_threshold_factor) ? 0 : gap_threshold_factor);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return PreciseEphemerisInterpolant.__wrap(ret[0]);
+    }
+    /**
+     * SP3 interpolation gap threshold factor carried by this interpolant.
+     * @returns {number}
+     */
+    get gapThresholdFactor() {
+        const ret = wasm.preciseephemerisinterpolant_gapThresholdFactor(this.__wbg_ptr);
+        return ret;
     }
     /**
      * Query ECEF position and optional clock for parallel satellite and epoch
@@ -14138,6 +14155,18 @@ class PreciseEphemerisInterpolant {
             wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
         }
     }
+    /**
+     * Return a copy of this interpolant with an explicit gap threshold factor.
+     * @param {number} gap_threshold_factor
+     * @returns {PreciseEphemerisInterpolant}
+     */
+    withInterpolationOptions(gap_threshold_factor) {
+        const ret = wasm.preciseephemerisinterpolant_withInterpolationOptions(this.__wbg_ptr, gap_threshold_factor);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return PreciseEphemerisInterpolant.__wrap(ret[0]);
+    }
 }
 if (Symbol.dispose) PreciseEphemerisInterpolant.prototype[Symbol.dispose] = PreciseEphemerisInterpolant.prototype.free;
 exports.PreciseEphemerisInterpolant = PreciseEphemerisInterpolant;
@@ -14166,6 +14195,14 @@ class PreciseEphemerisSampleSource {
         const ptr = this.__destroy_into_raw();
         wasm.__wbg_preciseephemerissamplesource_free(ptr, 0);
     }
+    /**
+     * SP3 interpolation gap threshold factor carried by this source.
+     * @returns {number}
+     */
+    get gapThresholdFactor() {
+        const ret = wasm.preciseephemerissamplesource_gapThresholdFactor(this.__wbg_ptr);
+        return ret;
+    }
     /**
      * Query ECEF position and optional clock for parallel satellite and epoch
      * arrays against this sample-backed precise source.
@@ -14229,6 +14266,18 @@ class PreciseEphemerisSampleSource {
         wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
         return v1;
     }
+    /**
+     * Return a copy of these samples with an explicit gap threshold factor.
+     * @param {number} gap_threshold_factor
+     * @returns {PreciseEphemerisSampleSource}
+     */
+    withInterpolationOptions(gap_threshold_factor) {
+        const ret = wasm.preciseephemerissamplesource_withInterpolationOptions(this.__wbg_ptr, gap_threshold_factor);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return PreciseEphemerisSampleSource.__wrap(ret[0]);
+    }
 }
 if (Symbol.dispose) PreciseEphemerisSampleSource.prototype[Symbol.dispose] = PreciseEphemerisSampleSource.prototype.free;
 exports.PreciseEphemerisSampleSource = PreciseEphemerisSampleSource;
@@ -14352,6 +14401,14 @@ class PreciseInterpolantArtifact {
         }
         return PreciseInterpolantArtifact.__wrap(ret[0]);
     }
+    /**
+     * SP3 interpolation gap threshold factor read from the artifact header.
+     * @returns {number}
+     */
+    get gapThresholdFactor() {
+        const ret = wasm.preciseinterpolantartifact_gapThresholdFactor(this.__wbg_ptr);
+        return ret;
+    }
     /**
      * Satellite tokens present in the artifact, ascending.
      * @returns {string[]}
@@ -17499,19 +17556,21 @@ class Sp3 {
      *
      * `orbitClass` is `"meo_gnss"` (default), `"geosynchronous"`, `"leo"`, or
      * `null` to disable the speed gate. `residualToleranceM` enables the
-     * residual check; `null` disables it.
+     * residual check; `null` disables it. `gapThresholdFactor` configures the
+     * hold-out interpolation policy; `null` leaves the core default (1.5).
      *
      * Returns `{ attested, defects, pairsChecked, residualsChecked,
      * residualsSkipped }`. Reports rather than refuses: whether a product with
      * defects is acceptable is the caller's decision.
      * @param {string | null} [orbit_class]
      * @param {number | null} [residual_tolerance_m]
+     * @param {number | null} [gap_threshold_factor]
      * @returns {any}
      */
-    checkContinuity(orbit_class, residual_tolerance_m) {
+    checkContinuity(orbit_class, residual_tolerance_m, gap_threshold_factor) {
         var ptr0 = isLikeNone(orbit_class) ? 0 : passStringToWasm0(orbit_class, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         var len0 = WASM_VECTOR_LEN;
-        const ret = wasm.sp3_checkContinuity(this.__wbg_ptr, ptr0, len0, !isLikeNone(residual_tolerance_m), isLikeNone(residual_tolerance_m) ? 0 : residual_tolerance_m);
+        const ret = wasm.sp3_checkContinuity(this.__wbg_ptr, ptr0, len0, !isLikeNone(residual_tolerance_m), isLikeNone(residual_tolerance_m) ? 0 : residual_tolerance_m, !isLikeNone(gap_threshold_factor), isLikeNone(gap_threshold_factor) ? 0 : gap_threshold_factor);
         if (ret[2]) {
             throw takeFromExternrefTable0(ret[1]);
         }
@@ -17550,10 +17609,11 @@ class Sp3 {
      * @param {number} through_j2000_s
      * @param {any} orbit_class
      * @param {any} residual_tolerance_m
+     * @param {any} gap_threshold_factor
      * @returns {any}
      */
-    continuityVerdict(from_j2000_s, through_j2000_s, orbit_class, residual_tolerance_m) {
-        const ret = wasm.sp3_continuityVerdict(this.__wbg_ptr, from_j2000_s, through_j2000_s, orbit_class, residual_tolerance_m);
+    continuityVerdict(from_j2000_s, through_j2000_s, orbit_class, residual_tolerance_m, gap_threshold_factor) {
+        const ret = wasm.sp3_continuityVerdict(this.__wbg_ptr, from_j2000_s, through_j2000_s, orbit_class, residual_tolerance_m, gap_threshold_factor);
         if (ret[2]) {
             throw takeFromExternrefTable0(ret[1]);
         }
@@ -17696,6 +17756,14 @@ class Sp3 {
         }
         return FdeSolution.__wrap(ret[0]);
     }
+    /**
+     * SP3 interpolation gap threshold factor carried by this product.
+     * @returns {number}
+     */
+    get gapThresholdFactor() {
+        const ret = wasm.sp3_gapThresholdFactor(this.__wbg_ptr);
+        return ret;
+    }
     /**
      * Interpolate `satellite`'s position and clock at each query epoch.
      *
@@ -17758,10 +17826,14 @@ class Sp3 {
     }
     /**
      * Build deterministic precise-interpolant artifact bytes from this SP3 product.
+     *
+     * `gapThresholdFactor` optionally overrides the product's interpolation policy;
+     * `null` or omitted retains this product's active policy.
+     * @param {number | null} [gap_threshold_factor]
      * @returns {Uint8Array}
      */
-    preciseInterpolantArtifactBytes() {
-        const ret = wasm.sp3_preciseInterpolantArtifactBytes(this.__wbg_ptr);
+    preciseInterpolantArtifactBytes(gap_threshold_factor) {
+        const ret = wasm.sp3_preciseInterpolantArtifactBytes(this.__wbg_ptr, !isLikeNone(gap_threshold_factor), isLikeNone(gap_threshold_factor) ? 0 : gap_threshold_factor);
         if (ret[3]) {
             throw takeFromExternrefTable0(ret[2]);
         }
@@ -17941,6 +18013,18 @@ class Sp3 {
             wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
         }
     }
+    /**
+     * Return a copy of this product with an explicit gap threshold factor.
+     * @param {number} gap_threshold_factor
+     * @returns {Sp3}
+     */
+    withInterpolationOptions(gap_threshold_factor) {
+        const ret = wasm.sp3_withInterpolationOptions(this.__wbg_ptr, gap_threshold_factor);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return Sp3.__wrap(ret[0]);
+    }
 }
 if (Symbol.dispose) Sp3.prototype[Symbol.dispose] = Sp3.prototype.free;
 exports.Sp3 = Sp3;
@@ -26862,13 +26946,17 @@ exports.loadRinexObs = loadRinexObs;
 /**
  * Parse an SP3-c or SP3-d byte buffer (the full, already-decompressed file)
  * into a precise-ephemeris product. Throws an `Error` on malformed input.
+ *
+ * `gapThresholdFactor` optionally configures the product-carried SP3 coverage-gap
+ * interpolation policy; omitted or `null` leaves the core default (1.5).
  * @param {Uint8Array} bytes
+ * @param {number | null} [gap_threshold_factor]
  * @returns {Sp3}
  */
-function loadSp3(bytes) {
+function loadSp3(bytes, gap_threshold_factor) {
     const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_malloc);
     const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.loadSp3(ptr0, len0);
+    const ret = wasm.loadSp3(ptr0, len0, !isLikeNone(gap_threshold_factor), isLikeNone(gap_threshold_factor) ? 0 : gap_threshold_factor);
     if (ret[2]) {
         throw takeFromExternrefTable0(ret[1]);
     }
@@ -28772,10 +28860,11 @@ exports.pppCorrectionsWithCodeBias = pppCorrectionsWithCodeBias;
  * (empty input, a single-sample satellite, non-monotonic epochs, a non-finite
  * sample). Delegates to `sidereon_core::sp3::PreciseEphemerisSamples::from_samples`.
  * @param {any} samples
+ * @param {number | null} [gap_threshold_factor]
  * @returns {PreciseEphemerisSampleSource}
  */
-function preciseEphemerisSamplesFromSamples(samples) {
-    const ret = wasm.preciseEphemerisSamplesFromSamples(samples);
+function preciseEphemerisSamplesFromSamples(samples, gap_threshold_factor) {
+    const ret = wasm.preciseEphemerisSamplesFromSamples(samples, !isLikeNone(gap_threshold_factor), isLikeNone(gap_threshold_factor) ? 0 : gap_threshold_factor);
     if (ret[2]) {
         throw takeFromExternrefTable0(ret[1]);
     }