On this page
Contract lifecycle
Upgrade without losing event meaning
Track the SDK version separately from the stable event envelope and treat new probes and fields as additive input.
Current release: v0.8.1
The current event envelope is schema_version: 1. The typed catalog format is catalog_version: 2 because it includes field types and JSON Schema fragments.
Versioning rules
Package version
Tracks implementation, documentation, probes, fixes, and native behavior.
Event schema version
Changes only when the RawSignalEvent envelope changes incompatibly.
Additive fields
New probe IDs and success-data fields may appear without an event schema bump.
Breaking probe data
An incompatible probe payload should use a new probe ID so old and new meanings cannot collide.
Upgrade checklist
- Read release notes and compare the typed probe catalog.
- Run native builds for each supported React Native version.
- Review new permissions, sensitive fields, default states, and privacy implications.
- Update backend allowlists without rejecting unknown additive fields.
- Collect in shadow mode and monitor missingness, errors, latency, and distribution drift.
- Promote new fields into feature logic only after representative physical-device calibration.
Release history
| Release | Main change | Notes |
|---|---|---|
0.8.1 | Honest unreadable-state handling and Required-Reason API cleanup | Release |
0.8.0 | Broader root, Frida, emulator, and iOS reverse-engineering evidence | Release |
0.7.0 | Hook stack frames and wider integrity artifacts | Release |
0.6.0 | Install provenance and transaction-time observations | Release |
0.5.x | Hardware, network, app metadata, documentation, and compatibility | All releases |
0.4.0 | Initial OSS gap signal package | Release |