@derec-alliance/react-native 0.0.1 → 0.0.2

package/README.md

@@ -184,8 +184,8 @@ awaiting them additionally lets a failure surface instead of vanishing.
 
 **The `DeRecErrorCategory` union differs from nodejs's.** This SDK's union
 omits `"wasm"`, which a C-ABI binding can never emit, and adds `"ok"`,
-`"ffi"` and `"state_store"`, which it can. A test pins the union to
-`bindings/test_fixture/enums.json` so it stays in step with the Rust enum.
+`"ffi"` and `"state_store"`, which it can. A test pins the union to the crate's shared enum fixture so it stays in step
+with the Rust enum.
 
 **Ids are decimal strings in stores, `bigint | number` on `DeRecProtocol`.**
 Store interfaces (`ChannelStore`, `ShareStore`, event fields such as

package/cpp/derec_ffi.h

@@ -267,9 +267,8 @@
  * Discriminants selecting which message [`derec_decode_message_json`] and
  * [`derec_encode_message_json`] operate on.
  *
- * Mirrored in `bindings/test_fixture/enums.json`, which every SDK asserts
- * against, so a message added here cannot reach a binding as a silently
- * unhandled value.
+ * Mirrored in the shared enum fixture, which every SDK asserts against, so a
+ * message added here cannot reach a binding as a silently unhandled value.
  */
 #define DEREC_MESSAGE_KIND_PAIR_REQUEST 0
 

package/ios/DeRecFFI.xcframework/ios-arm64/Headers/derec_ffi.h

@@ -267,9 +267,8 @@
  * Discriminants selecting which message [`derec_decode_message_json`] and
  * [`derec_encode_message_json`] operate on.
  *
- * Mirrored in `bindings/test_fixture/enums.json`, which every SDK asserts
- * against, so a message added here cannot reach a binding as a silently
- * unhandled value.
+ * Mirrored in the shared enum fixture, which every SDK asserts against, so a
+ * message added here cannot reach a binding as a silently unhandled value.
  */
 #define DEREC_MESSAGE_KIND_PAIR_REQUEST 0
 

package/ios/DeRecFFI.xcframework/ios-arm64_x86_64-simulator/Headers/derec_ffi.h

@@ -267,9 +267,8 @@
  * Discriminants selecting which message [`derec_decode_message_json`] and
  * [`derec_encode_message_json`] operate on.
  *
- * Mirrored in `bindings/test_fixture/enums.json`, which every SDK asserts
- * against, so a message added here cannot reach a binding as a silently
- * unhandled value.
+ * Mirrored in the shared enum fixture, which every SDK asserts against, so a
+ * message added here cannot reach a binding as a silently unhandled value.
  */
 #define DEREC_MESSAGE_KIND_PAIR_REQUEST 0
 

package/lib/errors.d.ts

@@ -1,8 +1,8 @@
 /**
  * Every category name `derec_error_category_name` can return, and no others.
  *
- * This is the authoritative list for this SDK, mirrored by a test against
- * `bindings/test_fixture/enums.json` so it cannot drift from the Rust enum.
+ * This is the authoritative list for this SDK, held to the Rust enum by a
+ * test against the shared enum fixture so the two cannot drift.
  * It deliberately differs from `@derec-alliance/nodejs`'s union, which was
  * the original source of this file: that union lists `"wasm"`, a category no
  * C-ABI binding can ever emit, and omits `"ok"`, `"ffi"` and `"state_store"`,

package/lib/errors.js

@@ -6,8 +6,8 @@ exports.DEREC_ERROR_CATEGORIES = void 0;
 /**
  * Every category name `derec_error_category_name` can return, and no others.
  *
- * This is the authoritative list for this SDK, mirrored by a test against
- * `bindings/test_fixture/enums.json` so it cannot drift from the Rust enum.
+ * This is the authoritative list for this SDK, held to the Rust enum by a
+ * test against the shared enum fixture so the two cannot drift.
  * It deliberately differs from `@derec-alliance/nodejs`'s union, which was
  * the original source of this file: that union lists `"wasm"`, a category no
  * C-ABI binding can ever emit, and omits `"ok"`, `"ffi"` and `"state_store"`,

package/lib/messages.d.ts

@@ -1,8 +1,8 @@
 /**
  * Selects which message the JSON codec operates on.
  *
- * Mirrors `MessageKind` in `bindings/test_fixture/enums.json`, which
- * `library/src/interop/ffi/message_json.rs` asserts against — so a message
+ * Mirrors the crate's `MessageKind`, which the shared enum fixture holds
+ * both sides to — so a message
  * added in Rust cannot reach this SDK as a silently unhandled value.
  */
 export declare enum MessageKind {

package/lib/messages.js

@@ -42,8 +42,8 @@ const native_1 = require("./native");
 /**
  * Selects which message the JSON codec operates on.
  *
- * Mirrors `MessageKind` in `bindings/test_fixture/enums.json`, which
- * `library/src/interop/ffi/message_json.rs` asserts against — so a message
+ * Mirrors the crate's `MessageKind`, which the shared enum fixture holds
+ * both sides to — so a message
  * added in Rust cannot reach this SDK as a silently unhandled value.
  */
 var MessageKind;

package/lib/protocol.d.ts

@@ -7,8 +7,8 @@ import type { AutoAcceptPolicy, ChannelStore, ContactMessage, ContactMode, DeRec
 type NativeHost = Record<string, (...args: any[]) => any>;
 /**
  * Maps a transport protocol name to the `derec_proto::Protocol` discriminant.
- * `bindings/test_fixture/enums.json` — the shared enum fixture every other
- * numeric mapping in this SDK is read from — does not carry this enum (it
+ * The shared enum fixture every other numeric mapping in this SDK is checked
+ * against does not carry this enum (it
  * only covers the Rust-internal serde enums listed under its `"enums"` key);
  * the transport `Protocol` enum lives in `protobufs/transportprotocol.proto`
  * instead, where only `HTTPS = 0` is currently defined.
@@ -20,8 +20,8 @@ export declare function protocolDiscriminant(protocol: string): number;
  * byte values, matching `UserSecretJson`'s plain `Vec<u8>` fields — no
  * base64, no wrapping.
  *
- * Exported so it can be golden-tested against
- * `bindings/test_fixture/wire_golden.json` without a native module.
+ * Exported so it can be golden-tested against the shared wire fixture
+ * without a native module.
  */
 export declare function buildProtectSecretParams(params: ProtectSecretParams): Record<string, unknown>;
 /**
@@ -33,8 +33,8 @@ export declare function buildProtectSecretParams(params: ProtectSecretParams): R
  * the shared golden fixture byte-for-byte; `replicas` is omitted entirely
  * when the recovered secret has no replica group.
  *
- * Exported so it can be golden-tested against
- * `bindings/test_fixture/wire_golden.json` without a native module.
+ * Exported so it can be golden-tested against the shared wire fixture
+ * without a native module.
  */
 export declare function buildRestoreParams(recoveredSecret: Extract<DeRecEvent, {
     type: 'SecretRecovered';

package/lib/protocol.js

@@ -52,8 +52,8 @@ function decodeEvents(buffer) {
 }
 /**
  * Maps a transport protocol name to the `derec_proto::Protocol` discriminant.
- * `bindings/test_fixture/enums.json` — the shared enum fixture every other
- * numeric mapping in this SDK is read from — does not carry this enum (it
+ * The shared enum fixture every other numeric mapping in this SDK is checked
+ * against does not carry this enum (it
  * only covers the Rust-internal serde enums listed under its `"enums"` key);
  * the transport `Protocol` enum lives in `protobufs/transportprotocol.proto`
  * instead, where only `HTTPS = 0` is currently defined.
@@ -81,8 +81,8 @@ function encodeTarget(target) {
  * byte values, matching `UserSecretJson`'s plain `Vec<u8>` fields — no
  * base64, no wrapping.
  *
- * Exported so it can be golden-tested against
- * `bindings/test_fixture/wire_golden.json` without a native module.
+ * Exported so it can be golden-tested against the shared wire fixture
+ * without a native module.
  */
 function buildProtectSecretParams(params) {
     const out = {
@@ -109,8 +109,8 @@ function communicationInfoOrOmit(info) {
  * the shared golden fixture byte-for-byte; `replicas` is omitted entirely
  * when the recovered secret has no replica group.
  *
- * Exported so it can be golden-tested against
- * `bindings/test_fixture/wire_golden.json` without a native module.
+ * Exported so it can be golden-tested against the shared wire fixture
+ * without a native module.
  */
 function buildRestoreParams(recoveredSecret, version) {
     const recovered = {

package/lib/types.d.ts

@@ -44,7 +44,7 @@ export interface SecretStore {
  *
  * Do not `JSON.parse` and re-serialise. Every id in these records is a `u64`,
  * and `JSON.parse` silently rounds anything above 2^53 — the corruption only
- * appears once a real id happens to be large. `bindings/web` implements this.
+ * appears once a real id happens to be large.
  */
 export interface ChannelStore {
     load(secretId: string, channelId: string, replicaId: string): Promise<Uint8Array | null | undefined>;
@@ -788,6 +788,8 @@ export interface GetSecretIdsVersionsRequestMessage {
     /** Ephemeral endpoint where the requester wants the response routed.
      *  Absent means "use the channel's stored peer endpoint". */
     reply_to?: TransportProtocol;
+    /** Replica-group member that sent this; see `replicaId` semantics. */
+    replica_id?: bigint;
 }
 export interface VersionList {
     secret_id: bigint;
@@ -801,6 +803,8 @@ export interface GetSecretIdsVersionsResponseMessage {
     result?: DeRecResult;
     secret_list: VersionList[];
     timestamp?: Timestamp;
+    /** Replica-group member that sent this; see `replicaId` semantics. */
+    replica_id?: bigint;
 }
 export interface VersionEntry {
     version: number;
@@ -879,6 +883,8 @@ export interface GetShareRequestMessage {
     timestamp?: Timestamp;
     /** Ephemeral response endpoint; see `replyTo` semantics. */
     reply_to?: TransportProtocol;
+    /** Replica-group member that sent this; see `replicaId` semantics. */
+    replica_id?: bigint;
 }
 export interface GetShareResponseMessage {
     share_algorithm: number;
@@ -890,6 +896,8 @@ export interface GetShareResponseMessage {
     secret_id: bigint;
     /** Echoed from the request for the same correlation reasons as `secret_id`. */
     version: number;
+    /** Replica-group member that sent this; see `replicaId` semantics. */
+    replica_id?: bigint;
 }
 export interface SiblingHash {
     is_left: boolean;
@@ -910,18 +918,24 @@ export interface StoreShareRequestMessage {
     secret_id: bigint;
     /** Ephemeral response endpoint; see `replyTo` semantics. */
     reply_to?: TransportProtocol;
+    /** Replica-group member that sent this; see `replicaId` semantics. */
+    replica_id?: bigint;
 }
 export interface StoreShareResponseMessage {
     result?: DeRecResult;
     version: number;
     timestamp?: Timestamp;
     secret_id: bigint;
+    /** Replica-group member that sent this; see `replicaId` semantics. */
+    replica_id?: bigint;
 }
 export interface UnpairRequestMessage {
     memo: string;
     timestamp?: Timestamp;
     /** Ephemeral response endpoint; see `replyTo` semantics. */
     reply_to?: TransportProtocol;
+    /** Replica-group member that sent this; see `replicaId` semantics. */
+    replica_id?: bigint;
 }
 export interface UnpairResponseMessage {
     result?: DeRecResult;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@derec-alliance/react-native",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "React Native bindings for derec-library, the Rust SDK for the DeRec protocol.",
   "license": "Apache-2.0",
   "repository": {

package/src/errors.ts

@@ -4,8 +4,8 @@
 /**
  * Every category name `derec_error_category_name` can return, and no others.
  *
- * This is the authoritative list for this SDK, mirrored by a test against
- * `bindings/test_fixture/enums.json` so it cannot drift from the Rust enum.
+ * This is the authoritative list for this SDK, held to the Rust enum by a
+ * test against the shared enum fixture so the two cannot drift.
  * It deliberately differs from `@derec-alliance/nodejs`'s union, which was
  * the original source of this file: that union lists `"wasm"`, a category no
  * C-ABI binding can ever emit, and omits `"ok"`, `"ffi"` and `"state_store"`,

package/src/messages.ts

@@ -37,8 +37,8 @@ import { getNative } from './native';
 /**
  * Selects which message the JSON codec operates on.
  *
- * Mirrors `MessageKind` in `bindings/test_fixture/enums.json`, which
- * `library/src/interop/ffi/message_json.rs` asserts against — so a message
+ * Mirrors the crate's `MessageKind`, which the shared enum fixture holds
+ * both sides to — so a message
  * added in Rust cannot reach this SDK as a silently unhandled value.
  */
 export enum MessageKind {

package/src/protocol.ts

@@ -82,8 +82,8 @@ function decodeEvents(buffer: ArrayBuffer): DeRecEvent[] {
 
 /**
  * Maps a transport protocol name to the `derec_proto::Protocol` discriminant.
- * `bindings/test_fixture/enums.json` — the shared enum fixture every other
- * numeric mapping in this SDK is read from — does not carry this enum (it
+ * The shared enum fixture every other numeric mapping in this SDK is checked
+ * against does not carry this enum (it
  * only covers the Rust-internal serde enums listed under its `"enums"` key);
  * the transport `Protocol` enum lives in `protobufs/transportprotocol.proto`
  * instead, where only `HTTPS = 0` is currently defined.
@@ -113,8 +113,8 @@ function encodeTarget(target: Target): unknown {
  * byte values, matching `UserSecretJson`'s plain `Vec<u8>` fields — no
  * base64, no wrapping.
  *
- * Exported so it can be golden-tested against
- * `bindings/test_fixture/wire_golden.json` without a native module.
+ * Exported so it can be golden-tested against the shared wire fixture
+ * without a native module.
  */
 export function buildProtectSecretParams(params: ProtectSecretParams): Record<string, unknown> {
   const out: Record<string, unknown> = {
@@ -145,8 +145,8 @@ function communicationInfoOrOmit(
  * the shared golden fixture byte-for-byte; `replicas` is omitted entirely
  * when the recovered secret has no replica group.
  *
- * Exported so it can be golden-tested against
- * `bindings/test_fixture/wire_golden.json` without a native module.
+ * Exported so it can be golden-tested against the shared wire fixture
+ * without a native module.
  */
 export function buildRestoreParams(
   recoveredSecret: Extract<DeRecEvent, { type: 'SecretRecovered' }>['secret'],

package/src/types.ts

@@ -62,7 +62,7 @@ export interface SecretStore {
  *
  * Do not `JSON.parse` and re-serialise. Every id in these records is a `u64`,
  * and `JSON.parse` silently rounds anything above 2^53 — the corruption only
- * appears once a real id happens to be large. `bindings/web` implements this.
+ * appears once a real id happens to be large.
  */
 export interface ChannelStore {
   load(
@@ -757,6 +757,8 @@ export interface GetSecretIdsVersionsRequestMessage {
   /** Ephemeral endpoint where the requester wants the response routed.
    *  Absent means "use the channel's stored peer endpoint". */
   reply_to?: TransportProtocol;
+  /** Replica-group member that sent this; see `replicaId` semantics. */
+  replica_id?: bigint;
 }
 
 export interface VersionList {
@@ -773,6 +775,8 @@ export interface GetSecretIdsVersionsResponseMessage {
   result?: DeRecResult;
   secret_list: VersionList[];
   timestamp?: Timestamp;
+  /** Replica-group member that sent this; see `replicaId` semantics. */
+  replica_id?: bigint;
 }
 
 export interface VersionEntry {
@@ -866,6 +870,8 @@ export interface GetShareRequestMessage {
   timestamp?: Timestamp;
   /** Ephemeral response endpoint; see `replyTo` semantics. */
   reply_to?: TransportProtocol;
+  /** Replica-group member that sent this; see `replicaId` semantics. */
+  replica_id?: bigint;
 }
 
 export interface GetShareResponseMessage {
@@ -879,6 +885,8 @@ export interface GetShareResponseMessage {
   secret_id: bigint;
   /** Echoed from the request for the same correlation reasons as `secret_id`. */
   version: number;
+  /** Replica-group member that sent this; see `replicaId` semantics. */
+  replica_id?: bigint;
 }
 
 export interface SiblingHash {
@@ -904,6 +912,8 @@ export interface StoreShareRequestMessage {
   secret_id: bigint;
   /** Ephemeral response endpoint; see `replyTo` semantics. */
   reply_to?: TransportProtocol;
+  /** Replica-group member that sent this; see `replicaId` semantics. */
+  replica_id?: bigint;
 }
 
 export interface StoreShareResponseMessage {
@@ -911,6 +921,8 @@ export interface StoreShareResponseMessage {
   version: number;
   timestamp?: Timestamp;
   secret_id: bigint;
+  /** Replica-group member that sent this; see `replicaId` semantics. */
+  replica_id?: bigint;
 }
 
 export interface UnpairRequestMessage {
@@ -918,6 +930,8 @@ export interface UnpairRequestMessage {
   timestamp?: Timestamp;
   /** Ephemeral response endpoint; see `replyTo` semantics. */
   reply_to?: TransportProtocol;
+  /** Replica-group member that sent this; see `replicaId` semantics. */
+  replica_id?: bigint;
 }
 
 export interface UnpairResponseMessage {