@neilberkman/sidereon 2.0.0 → 2.1.1

package/pkg/sidereon.js

@@ -13865,12 +13865,16 @@ export 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.
@@ -13881,10 +13885,11 @@ export 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]);
         }
@@ -13896,12 +13901,24 @@ export 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
@@ -13985,6 +14002,18 @@ export 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;
 
@@ -14012,6 +14041,14 @@ export 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.
@@ -14075,6 +14112,18 @@ export 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;
 
@@ -14197,6 +14246,14 @@ export 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[]}
@@ -17303,19 +17360,21 @@ 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.
      * @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]);
         }
@@ -17354,10 +17413,11 @@ export 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]);
         }
@@ -17500,6 +17560,14 @@ export 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.
      *
@@ -17562,10 +17630,14 @@ export 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]);
         }
@@ -17745,6 +17817,18 @@ export 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;
 
@@ -26394,13 +26478,17 @@ export function loadRinexObs(bytes) {
 /**
  * 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}
  */
-export function loadSp3(bytes) {
+export 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]);
     }
@@ -28202,10 +28290,11 @@ export function pppCorrectionsWithCodeBias(sp3, epochs, receiver_ecef_m, options
  * (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}
  */
-export function preciseEphemerisSamplesFromSamples(samples) {
-    const ret = wasm.preciseEphemerisSamplesFromSamples(samples);
+export 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]);
     }
@@ -28304,13 +28393,15 @@ export function predictBatchSp3(sp3, satellites, receivers_ecef_m, epochs_j2000_
 /**
  * Ordered cross-line candidates for one predicted IONEX map date.
  *
- * Both CODE predicted lines publish the same official filename for a map
- * date, but the two-day line is produced a day earlier, so `cod_prd2` is
- * routinely published while `cod_prd1` is still absent when CODE runs
- * behind. Candidates are ordered `cod_prd1` first, all cover the SAME map
- * date (never a neighboring day's map), and each keeps its own line
- * identity so resolved provenance names the line actually served. The walk
- * is opt-in; single-line requests keep their fail-closed behavior.
+ * CODE archives both predicted lines under `CODE/IONO/PRD/`, the one-day
+ * line as `COD0OPSP0D_*` and the two-day line as `COD0OPSP1D_*`, with the
+ * map date in both filenames. The two-day line is produced a day earlier,
+ * so `cod_prd2` is routinely published while `cod_prd1` is still absent
+ * when CODE runs behind. Candidates are ordered `cod_prd1` first, all
+ * cover the SAME map date (never a neighboring day's map), and each keeps
+ * its own line identity so resolved provenance names the line actually
+ * served. The walk is opt-in; single-line requests keep their fail-closed
+ * behavior.
  *
  * Returns an array of `{center, date, sample, issue, filename, url}`.
  * @param {number} year