@neilberkman/sidereon 0.30.0 → 0.32.0

package/pkg-node/sidereon.d.ts

@@ -6,6 +6,58 @@ export type Vec3 = [number, number, number] | Float64Array;
 export type Vec4 = [number, number, number, number] | Float64Array;
 export type Matrix3 = number[] | Float64Array;
 
+export interface ExactProductIdentityInput {
+    family: "sp3" | "ionex" | "clk" | "nav";
+    analysisCenter: string;
+    publisher: "IGS" | "COD" | "ESA" | "GFZ";
+    solutionClass: "final" | "rapid" | "ultra_rapid" | "predicted" | "broadcast";
+    campaign: "OPS" | "MGN" | "MGX" | "BRD";
+    filenameVersion: number;
+    year: number;
+    month: number;
+    day: number;
+    issue?: string | null;
+    span: string;
+    sample: string;
+    officialFilename: string;
+    format: "SP3" | "IONEX" | "RINEX_CLK" | "RINEX_NAV";
+    formatVersion?: string | null;
+    predictionHorizonDays?: number | null;
+}
+
+export interface Sp3ArtifactIdentityInput {
+    requestedIdentity: ExactProductIdentityInput;
+    resolvedIdentity: ExactProductIdentityInput;
+    distributionSource: "direct" | "nasa_cddis" | "local_file" | "in_memory";
+    officialFilename: string;
+    productSha256: string;
+    /** Positive integer no greater than Number.MAX_SAFE_INTEGER. */
+    productByteLength: number;
+    archiveSha256: string;
+    /** Positive integer no greater than Number.MAX_SAFE_INTEGER. */
+    archiveByteLength: number;
+    compression: "none" | "gzip";
+}
+
+/** Validated canonical artifact record returned by merged-SP3 identity APIs. */
+export type Sp3ArtifactIdentity = Sp3ArtifactIdentityInput;
+
+export interface Sp3MergeIdentityOptions {
+    /** Finite, non-negative position agreement tolerance in meters. */
+    positionToleranceM?: number;
+    /** Finite, non-negative clock agreement tolerance in seconds. */
+    clockToleranceS?: number;
+    minAgree?: number;
+    clockMinCommon?: number;
+    combine?: "mean" | "median" | "precedence";
+    precedenceScope?: "cell" | "satellite_arc";
+    outlierReject?: { positionToleranceM: number; clockToleranceS: number };
+    targetEpochIntervalS?: number;
+    systems?: string[];
+    assertedFrameLabelSets?: string[][];
+    helmert?: boolean;
+}
+
 export interface SurfaceMetInput {
     pressureHpa: number;
     temperatureK: number;
@@ -7389,6 +7441,32 @@ export class Sp3MergeFlag {
     readonly sources: Uint32Array;
 }
 
+/**
+ * Canonical identity of a complete exact SP3 input set and full merge policy.
+ */
+export class Sp3MergeInputIdentity {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Contributors in distributor-independent canonical order.
+     */
+    readonly contributors: Sp3ArtifactIdentity[];
+    /**
+     * Contributors in semantic source-priority order for precedence merges;
+     * undefined for mean and median.
+     */
+    readonly precedenceContributors: Sp3ArtifactIdentity[] | undefined;
+    /**
+     * Canonical encoding version.
+     */
+    readonly schemaVersion: number;
+    /**
+     * Versioned stable identity of every artifact and effective merge control.
+     */
+    readonly stableId: string;
+}
+
 /**
  * Audit report returned with a merged SP3 product.
  */
@@ -10455,6 +10533,11 @@ export function melbourneWubbena(phi1_cycles: number, phi2_cycles: number, p1_m:
  */
 export function mergeNavcen(records: any, statuses: any): any;
 
+/**
+ * Merge time-aware NAVCEN assessments into records by PRN.
+ */
+export function mergeNavcenAt(records: any, assessments: any): any;
+
 /**
  * Merge SP3 products with the core consensus merge path.
  *
@@ -10792,6 +10875,13 @@ export function parseCdmXml(text: string): Cdm;
  */
 export function parseNavcen(html: string): any;
 
+/**
+ * Parse NAVCEN status HTML and evaluate usability at explicit UTC Unix
+ * microseconds. Parsed intervals are half-open; ambiguous forecasts are
+ * retained without disabling the satellite.
+ */
+export function parseNavcenAt(html: string, evaluated_at_unix_us: bigint): any;
+
 /**
  * Parse NMEA sentences from bytes.
  */
@@ -11654,6 +11744,20 @@ export function sourceSolveModeTdoa(reference_sensor: number): any;
  */
 export function sourceSolveModeToa(): string;
 
+/**
+ * Validate complete exact artifact records and return their canonical merge
+ * input identity.
+ *
+ * `contributors` must be an array of complete `Sp3ArtifactIdentityInput`
+ * objects. Contributor enumeration order does not affect mean or median
+ * identities. Precedence identities bind the original order because it
+ * determines source priority. Unordered policy fields are canonicalized.
+ * Empty, duplicate, incomplete, malformed, non-SP3, or mismatched records fail
+ * closed. Acquisition timestamps, URLs, HTTP metadata, credentials, cache
+ * paths, and retry history are not accepted input fields.
+ */
+export function sp3MergeInputIdentity(contributors: Sp3ArtifactIdentityInput[], options?: Sp3MergeIdentityOptions | null): Sp3MergeInputIdentity;
+
 /**
  * Extract a parsed SP3 product as the canonical precise-ephemeris samples, one
  * per real position record in ascending epoch order.

package/pkg-node/sidereon.js

@@ -17660,6 +17660,71 @@ class Sp3MergeFlag {
 if (Symbol.dispose) Sp3MergeFlag.prototype[Symbol.dispose] = Sp3MergeFlag.prototype.free;
 exports.Sp3MergeFlag = Sp3MergeFlag;
 
+/**
+ * Canonical identity of a complete exact SP3 input set and full merge policy.
+ */
+class Sp3MergeInputIdentity {
+    static __wrap(ptr) {
+        const obj = Object.create(Sp3MergeInputIdentity.prototype);
+        obj.__wbg_ptr = ptr;
+        Sp3MergeInputIdentityFinalization.register(obj, obj.__wbg_ptr, obj);
+        return obj;
+    }
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        Sp3MergeInputIdentityFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_sp3mergeinputidentity_free(ptr, 0);
+    }
+    /**
+     * Contributors in distributor-independent canonical order.
+     * @returns {any}
+     */
+    get contributors() {
+        const ret = wasm.sp3mergeinputidentity_contributors(this.__wbg_ptr);
+        return ret;
+    }
+    /**
+     * Contributors in semantic source-priority order for precedence merges;
+     * undefined for mean and median.
+     * @returns {any}
+     */
+    get precedenceContributors() {
+        const ret = wasm.sp3mergeinputidentity_precedenceContributors(this.__wbg_ptr);
+        return ret;
+    }
+    /**
+     * Canonical encoding version.
+     * @returns {number}
+     */
+    get schemaVersion() {
+        const ret = wasm.sp3mergeinputidentity_schemaVersion(this.__wbg_ptr);
+        return ret;
+    }
+    /**
+     * Versioned stable identity of every artifact and effective merge control.
+     * @returns {string}
+     */
+    get stableId() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.sp3mergeinputidentity_stableId(this.__wbg_ptr);
+            deferred1_0 = ret[0];
+            deferred1_1 = ret[1];
+            return getStringFromWasm0(ret[0], ret[1]);
+        } finally {
+            wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+        }
+    }
+}
+if (Symbol.dispose) Sp3MergeInputIdentity.prototype[Symbol.dispose] = Sp3MergeInputIdentity.prototype.free;
+exports.Sp3MergeInputIdentity = Sp3MergeInputIdentity;
+
 /**
  * Audit report returned with a merged SP3 product.
  */
@@ -26001,6 +26066,21 @@ function mergeNavcen(records, statuses) {
 }
 exports.mergeNavcen = mergeNavcen;
 
+/**
+ * Merge time-aware NAVCEN assessments into records by PRN.
+ * @param {any} records
+ * @param {any} assessments
+ * @returns {any}
+ */
+function mergeNavcenAt(records, assessments) {
+    const ret = wasm.mergeNavcenAt(records, assessments);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+exports.mergeNavcenAt = mergeNavcenAt;
+
 /**
  * Merge SP3 products with the core consensus merge path.
  *
@@ -26950,6 +27030,25 @@ function parseNavcen(html) {
 }
 exports.parseNavcen = parseNavcen;
 
+/**
+ * Parse NAVCEN status HTML and evaluate usability at explicit UTC Unix
+ * microseconds. Parsed intervals are half-open; ambiguous forecasts are
+ * retained without disabling the satellite.
+ * @param {string} html
+ * @param {bigint} evaluated_at_unix_us
+ * @returns {any}
+ */
+function parseNavcenAt(html, evaluated_at_unix_us) {
+    const ptr0 = passStringToWasm0(html, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.parseNavcenAt(ptr0, len0, evaluated_at_unix_us);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+exports.parseNavcenAt = parseNavcenAt;
+
 /**
  * Parse NMEA sentences from bytes.
  * @param {Uint8Array} bytes
@@ -29461,6 +29560,30 @@ function sourceSolveModeToa() {
 }
 exports.sourceSolveModeToa = sourceSolveModeToa;
 
+/**
+ * Validate complete exact artifact records and return their canonical merge
+ * input identity.
+ *
+ * `contributors` must be an array of complete `Sp3ArtifactIdentityInput`
+ * objects. Contributor enumeration order does not affect mean or median
+ * identities. Precedence identities bind the original order because it
+ * determines source priority. Unordered policy fields are canonicalized.
+ * Empty, duplicate, incomplete, malformed, non-SP3, or mismatched records fail
+ * closed. Acquisition timestamps, URLs, HTTP metadata, credentials, cache
+ * paths, and retry history are not accepted input fields.
+ * @param {any} contributors
+ * @param {any} options
+ * @returns {Sp3MergeInputIdentity}
+ */
+function sp3MergeInputIdentity(contributors, options) {
+    const ret = wasm.sp3MergeInputIdentity(contributors, options);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return Sp3MergeInputIdentity.__wrap(ret[0]);
+}
+exports.sp3MergeInputIdentity = sp3MergeInputIdentity;
+
 /**
  * Extract a parsed SP3 product as the canonical precise-ephemeris samples, one
  * per real position record in ascending epoch order.
@@ -30586,6 +30709,16 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
+        __wbg_instanceof_Object_33f20e6f12439f3e: function(arg0) {
+            let result;
+            try {
+                result = arg0 instanceof Object;
+            } catch (_) {
+                result = false;
+            }
+            const ret = result;
+            return ret;
+        },
         __wbg_instanceof_Uint8Array_309b927aaf7a3fc7: function(arg0) {
             let result;
             try {
@@ -30616,6 +30749,10 @@ function __wbg_get_imports() {
             const ret = Symbol.iterator;
             return ret;
         },
+        __wbg_keys_58421f8f96795607: function(arg0) {
+            const ret = Object.keys(arg0);
+            return ret;
+        },
         __wbg_length_1f0964f4a5e2c6d8: function(arg0) {
             const ret = arg0.length;
             return ret;
@@ -31356,6 +31493,9 @@ const Sp3InterpolationFinalization = (typeof FinalizationRegistry === 'undefined
 const Sp3MergeFlagFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_sp3mergeflag_free(ptr, 1));
+const Sp3MergeInputIdentityFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_sp3mergeinputidentity_free(ptr, 1));
 const Sp3MergeReportFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_sp3mergereport_free(ptr, 1));