@neilberkman/sidereon 0.29.2 → 0.31.2

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;
@@ -3100,6 +3152,7 @@ export class GnssProductIdentity {
     private constructor();
     free(): void;
     [Symbol.dispose](): void;
+    readonly analysisCenter: string;
     /**
      * Stable validated identity key suitable for caller-managed cache paths.
      */
@@ -3109,6 +3162,7 @@ export class GnssProductIdentity {
     readonly family: string;
     readonly filenameVersion: number;
     readonly format: string;
+    readonly formatVersion: string | undefined;
     readonly issue: string | undefined;
     readonly month: number;
     readonly officialFilename: string;
@@ -7387,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.
  */
@@ -9010,6 +9090,14 @@ export function boundedIlsSearch(float_cycles: Float64Array, covariance: any, ra
  */
 export function buildDualFrequencyRinexRtkArc(ephemeris: Sp3, base_obs: RinexObs, rover_obs: RinexObs, options?: RtkRinexDualArcOptions | null): { epochs: RtkDualFrequencyArcEpoch[] };
 
+/**
+ * Build the shared exact-cache commit bytes for a complete immutable candidate.
+ *
+ * Browser hosts should stage product, archive, and provenance under `entry_id`
+ * and make the returned marker visible in the same IndexedDB transaction.
+ */
+export function buildExactCacheCommit(identity: GnssProductIdentity, source: string, entry_id: string, product: Uint8Array, archive: Uint8Array, provenance: Uint8Array): Uint8Array;
+
 /**
  * Build single-frequency RTK arc records from parsed RINEX OBS products.
  *
@@ -11644,6 +11732,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.
@@ -11911,6 +12013,12 @@ export function velocityMatchOutage(states: any, first_good_fix: any, config: an
  */
 export function velocityMidas(series: any, options: any): any;
 
+/**
+ * Verify a shared commit marker against the requested full identity, source,
+ * and all three immutable byte objects. Returns the committed entry id.
+ */
+export function verifyExactCacheCommit(identity: GnssProductIdentity, source: string, marker: Uint8Array, product: Uint8Array, archive: Uint8Array, provenance: Uint8Array): string;
+
 /**
  * Vertical one-dimensional percentile radius from an up variance.
  */

package/pkg-node/sidereon.js

@@ -6446,6 +6446,21 @@ class GnssProductIdentity {
         const ptr = this.__destroy_into_raw();
         wasm.__wbg_gnssproductidentity_free(ptr, 0);
     }
+    /**
+     * @returns {string}
+     */
+    get analysisCenter() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.gnssproductidentity_analysisCenter(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);
+        }
+    }
     /**
      * Stable validated identity key suitable for caller-managed cache paths.
      * @returns {string}
@@ -6527,6 +6542,18 @@ class GnssProductIdentity {
             wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
         }
     }
+    /**
+     * @returns {string | undefined}
+     */
+    get formatVersion() {
+        const ret = wasm.gnssproductidentity_formatVersion(this.__wbg_ptr);
+        let v1;
+        if (ret[0] !== 0) {
+            v1 = getStringFromWasm0(ret[0], ret[1]).slice();
+            wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+        }
+        return v1;
+    }
     /**
      * @returns {string | undefined}
      */
@@ -17633,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.
  */
@@ -21898,6 +21990,41 @@ function buildDualFrequencyRinexRtkArc(ephemeris, base_obs, rover_obs, options)
 }
 exports.buildDualFrequencyRinexRtkArc = buildDualFrequencyRinexRtkArc;
 
+/**
+ * Build the shared exact-cache commit bytes for a complete immutable candidate.
+ *
+ * Browser hosts should stage product, archive, and provenance under `entry_id`
+ * and make the returned marker visible in the same IndexedDB transaction.
+ * @param {GnssProductIdentity} identity
+ * @param {string} source
+ * @param {string} entry_id
+ * @param {Uint8Array} product
+ * @param {Uint8Array} archive
+ * @param {Uint8Array} provenance
+ * @returns {Uint8Array}
+ */
+function buildExactCacheCommit(identity, source, entry_id, product, archive, provenance) {
+    _assertClass(identity, GnssProductIdentity);
+    const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passStringToWasm0(entry_id, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ptr2 = passArray8ToWasm0(product, wasm.__wbindgen_malloc);
+    const len2 = WASM_VECTOR_LEN;
+    const ptr3 = passArray8ToWasm0(archive, wasm.__wbindgen_malloc);
+    const len3 = WASM_VECTOR_LEN;
+    const ptr4 = passArray8ToWasm0(provenance, wasm.__wbindgen_malloc);
+    const len4 = WASM_VECTOR_LEN;
+    const ret = wasm.buildExactCacheCommit(identity.__wbg_ptr, ptr0, len0, ptr1, len1, ptr2, len2, ptr3, len3, ptr4, len4);
+    if (ret[3]) {
+        throw takeFromExternrefTable0(ret[2]);
+    }
+    var v6 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+    wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+    return v6;
+}
+exports.buildExactCacheCommit = buildExactCacheCommit;
+
 /**
  * Build single-frequency RTK arc records from parsed RINEX OBS products.
  *
@@ -29399,6 +29526,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.
@@ -30120,6 +30271,48 @@ function velocityMidas(series, options) {
 }
 exports.velocityMidas = velocityMidas;
 
+/**
+ * Verify a shared commit marker against the requested full identity, source,
+ * and all three immutable byte objects. Returns the committed entry id.
+ * @param {GnssProductIdentity} identity
+ * @param {string} source
+ * @param {Uint8Array} marker
+ * @param {Uint8Array} product
+ * @param {Uint8Array} archive
+ * @param {Uint8Array} provenance
+ * @returns {string}
+ */
+function verifyExactCacheCommit(identity, source, marker, product, archive, provenance) {
+    let deferred7_0;
+    let deferred7_1;
+    try {
+        _assertClass(identity, GnssProductIdentity);
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passArray8ToWasm0(marker, wasm.__wbindgen_malloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ptr2 = passArray8ToWasm0(product, wasm.__wbindgen_malloc);
+        const len2 = WASM_VECTOR_LEN;
+        const ptr3 = passArray8ToWasm0(archive, wasm.__wbindgen_malloc);
+        const len3 = WASM_VECTOR_LEN;
+        const ptr4 = passArray8ToWasm0(provenance, wasm.__wbindgen_malloc);
+        const len4 = WASM_VECTOR_LEN;
+        const ret = wasm.verifyExactCacheCommit(identity.__wbg_ptr, ptr0, len0, ptr1, len1, ptr2, len2, ptr3, len3, ptr4, len4);
+        var ptr6 = ret[0];
+        var len6 = ret[1];
+        if (ret[3]) {
+            ptr6 = 0; len6 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred7_0 = ptr6;
+        deferred7_1 = len6;
+        return getStringFromWasm0(ptr6, len6);
+    } finally {
+        wasm.__wbindgen_free(deferred7_0, deferred7_1, 1);
+    }
+}
+exports.verifyExactCacheCommit = verifyExactCacheCommit;
+
 /**
  * Vertical one-dimensional percentile radius from an up variance.
  * @param {number} sigma_u_m2
@@ -30482,6 +30675,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 {
@@ -30512,6 +30715,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;
@@ -31252,6 +31459,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));