@neilberkman/sidereon 0.30.0 → 0.31.2

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.31.2 - 2026-07-16
+
+- Returns canonical contributors and ordered precedence contributors alongside
+  the merged-SP3 stable ID.
+- Rejects artifact byte lengths that are not positive exact JavaScript safe
+  integers and enforces whole-second target epoch intervals.
+- Adds the shared literal provenance fixture and builds against `sidereon` and
+  `sidereon-core` 0.31.2.
+
+## 0.31.0 - 2026-07-16
+
+- Adds `sp3MergeInputIdentity`, which validates complete exact SP3 artifact
+  records plus the full merge policy and returns the shared versioned stable
+  identity. Incomplete, malformed, mismatched, duplicate, non-SP3, and unknown
+  fields fail closed.
+- Builds against `sidereon` and `sidereon-core` 0.31.0.
+
 ## 0.30.0 - 2026-07-16
 
 - Exposes analysis center, parsed format version, and the canonical all-field

package/README.md

@@ -112,12 +112,23 @@ import {
   distributionLocation,
   GnssExactProductSet,
   productIdentity,
+  sp3MergeInputIdentity,
 } from "@neilberkman/sidereon";
 
 const identity = productIdentity("cod", "sp3", 2026, 7, 12);
 console.log(identity.officialFilename);
 // COD0MGXFIN_20261930000_01D_05M_ORB.SP3
 
+// Once every input has been acquired and validated, bind its complete exact
+// artifact record and the full merge policy to one canonical stable ID.
+const mergeInput = sp3MergeInputIdentity([artifactRecord], {
+  combine: "mean",
+  systems: ["G", "E"],
+});
+console.log(mergeInput.schemaVersion, mergeInput.stableId);
+console.log(mergeInput.contributors); // distributor-independent canonical order
+// precedenceContributors is defined only when combine is "precedence".
+
 const cddis = distributionLocation(
   "cod",
   "sp3",
@@ -137,6 +148,17 @@ exactSet.addAvailable(identity); // add only after content validation
 exactSet.validate();
 ```
 
+`artifactRecord` contains the requested and parsed/resolved product identities,
+explicit distributor, official filename, decompressed and archive SHA-256/length
+pairs, and archive compression. Contributor enumeration does not affect mean or
+median IDs. Precedence IDs bind the original order because it determines source
+priority. Object-property ordering does not affect any ID; changing an artifact
+or effective merge control does. Incomplete, mismatched, duplicate, non-SP3,
+and unknown fields are rejected. Byte lengths must be positive integers no
+greater than `Number.MAX_SAFE_INTEGER`. Retrieval timestamps, URLs, HTTP metadata,
+credentials, cache paths, and retry history are intentionally not accepted as
+canonical inputs.
+
 `productIdentity` returns publisher, solution class, campaign, date, issue,
 coverage span, cadence, official filename, format, and a validated cache key.
 `distributionLocation` accepts `direct`, `nasa_cddis`, `local_file`, or

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neilberkman/sidereon",
-  "version": "0.30.0",
+  "version": "0.31.2",
   "description": "WebAssembly / JavaScript interface over the sidereon GNSS + astrodynamics engine: SP3 loading and multi-product merge, SPP / RTK (float + fixed) / PPP (float + fixed) positioning, IONEX slant delay, SGP4 and numerical orbit propagation, RINEX observation/navigation/clock parsing, CRINEX (Hatanaka) decoding, observable-domain math (carrier combinations, cycle slips, Hatch smoothing, weighting, velocity, GPS C/A signal), and the astro domain (scale-tagged time, frame transforms, Sun/Moon ephemerides, eclipse / body angles, DOP, passes / visibility, conjunction + collision probability, CDM / OMM / ANTEX parsing, RF link budget)",
   "type": "module",
   "license": "MIT",