@derec-alliance/nodejs 0.0.6 → 0.0.7

package/README.md

@@ -317,8 +317,15 @@ const recovered = primitives.recovery.response.recover(
 // `recovered` is a Uint8Array carrying the reconstructed secret payload.
 ```
 
-When driving the protocol layer instead of the primitives, the recovering
-device receives a `SecretRecovered` event carrying the typed `secret`. Pass it
+When driving the protocol layer instead of the primitives, a helper that
+answers with a share that cannot be part of the secret is reported as a
+`RecoveryShareCorrupted` event (`reason`: `"Malformed"`, `"InvalidProof"` or
+`"Inconsistent"`); the share is set aside and never blocks the recovery from
+the others. An honest helper never sends one, so treat it as a sign of a
+damaged or compromised helper — for example, offer to unpair it.
+
+The recovering device receives a `SecretRecovered` event carrying the typed
+`secret`. Pass it
 to `protocol.restore(secret, version)` on a fresh `DeRecProtocol` instance to
 commit canonical helper / replica state and wipe the throwaway recovery-mode
 channels — at that point the device resumes normal operation as if the secret
@@ -404,14 +411,18 @@ side runs as `SenderKind.ReplicaSource` (owns the secret), the other as
 with a stable `replicaId`:
 
 ```ts
-const owner = new DeRecProtocol(
-  channelStore, shareStore, secretStore, transport,
-  "https://owner.example.com", "https",
-  /* threshold */ 2, /* keepVersionsCount */ 3,
-  { name: "Owner" },
-  null, null, null, null,
-  /* replicaId */ 0xAAAA_AAAA_AAAA_AAAAn,
-);
+const owner = new DeRecProtocolBuilder(secretId)
+  .withChannelStore(channelStore)
+  .withShareStore(shareStore)
+  .withSecretStore(secretStore)
+  .withUserSecretStore(userSecretStore)
+  .withStateStore(stateStore)
+  .withTransport(transport)
+  .withOwnTransports([{ uri: "https://owner.example.com", protocol: "https" }])
+  .withThreshold(2)
+  .withCommunicationInfo({ name: "Owner" })
+  .withReplicaId(0xAAAA_AAAA_AAAA_AAAAn)
+  .build();
 ```
 
 A typical Source↔Destination handshake:
@@ -464,6 +475,27 @@ End-to-end coverage lives in the repository's tests — see
 
 ---
 
+## When `process()` fails
+
+`process()` settles expired deadlines (sharing-round and unpair timeouts)
+before it handles the message, and those are never reported again. So when
+the message then fails, the thrown `DeRecError` carries them: `events` holds
+every event produced before the failure, and `channel_id` names the channel
+the message came from (absent when the bytes were not a decodable envelope).
+Handle the events as you would a successful call's, then the error:
+
+```ts
+try {
+  handle(await protocol.process(bytes));
+} catch (error) {
+  const failure = error as DeRecError;
+  handle(failure.events ?? []);
+  report(failure.channel_id, failure);
+}
+```
+
+---
+
 ## Correlation and routing
 
 Two cross-cutting metadata fields appear on every channel-mode exchange:
@@ -572,6 +604,10 @@ the peer acknowledges, retire the ephemeral URI. This keeps the
 plaintext PrePair window tight while letting subsequent traffic ride
 on the long-lived endpoint.
 
+`UpdateChannelInfo` reaches helper channels only. A replica member that
+changes its endpoint or `communication_info` publishes a new version first,
+then updates its helpers; see [On a replica member](https://github.com/derecalliance/lib-derec/tree/main/library#on-a-replica-member).
+
 ### Replica fingerprint verification is mandatory
 
 Replica channels are created with `status: "Pending"` and remain there

package/derec_library.d.ts

@@ -58,11 +58,6 @@ export class DeRecProtocolBuilder {
      * `info` shape: `Record<string, string>`. Default: empty.
      */
     withCommunicationInfo(info: any): DeRecProtocolBuilder;
-    /**
-     * Number of recent versions each helper must retain.
-     * Default: [`crate::protocol::DEFAULT_KEEP_VERSIONS_COUNT`].
-     */
-    withKeepVersionsCount(count: number): DeRecProtocolBuilder;
     /**
      * Every transport endpoint this application serves, in preference
      * order. `transports` is an array of `{ uri: string, protocol: string

package/derec_library.js

@@ -126,17 +126,6 @@ class DeRecProtocolBuilder {
         }
         return DeRecProtocolBuilder.__wrap(ret[0]);
     }
-    /**
-     * Number of recent versions each helper must retain.
-     * Default: [`crate::protocol::DEFAULT_KEEP_VERSIONS_COUNT`].
-     * @param {number} count
-     * @returns {DeRecProtocolBuilder}
-     */
-    withKeepVersionsCount(count) {
-        const ptr = this.__destroy_into_raw();
-        const ret = wasm.derecprotocolbuilder_withKeepVersionsCount(ptr, count);
-        return DeRecProtocolBuilder.__wrap(ret);
-    }
     /**
      * Every transport endpoint this application serves, in preference
      * order. `transports` is an array of `{ uri: string, protocol: string
@@ -1824,7 +1813,7 @@ function __wbg_get_imports() {
             return ret;
         },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 395, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 404, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h379e0770a020d351);
             return ret;
         },

package/derec_library_bg.wasm.d.ts

@@ -1,30 +1,6 @@
 /* tslint:disable */
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
-export const verification_response_extract: (a: number, b: number, c: number, d: number) => [number, number, number];
-export const verification_response_process: (a: any, b: any, c: number, d: number) => [number, number, number];
-export const verification_response_produce: (a: bigint, b: any, c: number, d: number, e: number, f: number) => [number, number, number];
-export const discovery_response_extract: (a: number, b: number, c: number, d: number) => [number, number, number];
-export const discovery_response_process: (a: any) => [number, number, number];
-export const discovery_response_produce: (a: bigint, b: any, c: number, d: number) => [number, number, number];
-export const envelope_apply_trace_id: (a: number, b: number, c: bigint) => [number, number, number, number];
-export const envelope_read_trace_id: (a: number, b: number) => [bigint, number, number];
-export const sharing_response_extract: (a: number, b: number, c: number, d: number) => [number, number, number];
-export const sharing_response_process: (a: number, b: any) => [number, number];
-export const sharing_response_produce: (a: bigint, b: any, c: number, d: number) => [number, number, number];
-export const wasm_start: () => void;
-export const sharing_request_extract: (a: number, b: number, c: number, d: number) => [number, number, number];
-export const sharing_request_produce: (a: bigint, b: number, c: bigint, d: any, e: any, f: number, g: number, h: number, i: number, j: any) => [number, number, number];
-export const sharing_request_split: (a: any, b: bigint, c: number, d: number, e: number, f: number) => [number, number, number];
-export const pairing_fingerprint: (a: number, b: number) => [number, number, number, number];
-export const pairing_response_extract: (a: number, b: number, c: number, d: number) => [number, number, number];
-export const pairing_response_extract_pre_pair: (a: number, b: number) => [number, number, number];
-export const pairing_response_process: (a: any, b: any, c: number, d: number, e: any) => [number, number, number];
-export const pairing_response_process_pre_pair: (a: any, b: any) => [number, number, number];
-export const pairing_response_process_pre_pair_no_keys: (a: any, b: any) => [number, number, number];
-export const pairing_response_produce: (a: bigint, b: any, c: number, d: number, e: any, f: any, g: number) => [number, number, number];
-export const pairing_response_produce_pre_pair: (a: bigint, b: any, c: number, d: number) => [number, number, number];
-export const pairing_response_produce_pre_pair_no_keys: (a: bigint, b: any) => [number, number, number];
 export const __wbg_derecprotocolbuilder_free: (a: number, b: number) => void;
 export const __wbg_derecprotocolwasm_free: (a: number, b: number) => void;
 export const derecprotocolbuilder_build: (a: number) => [number, number, number];
@@ -34,7 +10,6 @@ export const derecprotocolbuilder_withAutoReplyTo: (a: number, b: number) => num
 export const derecprotocolbuilder_withAutoRespondOnFailure: (a: number, b: number) => number;
 export const derecprotocolbuilder_withChannelStore: (a: number, b: any) => number;
 export const derecprotocolbuilder_withCommunicationInfo: (a: number, b: any) => [number, number, number];
-export const derecprotocolbuilder_withKeepVersionsCount: (a: number, b: number) => number;
 export const derecprotocolbuilder_withOwnTransports: (a: number, b: number, c: number) => [number, number, number];
 export const derecprotocolbuilder_withParameterRange: (a: number, b: any) => [number, number, number];
 export const derecprotocolbuilder_withReplicaId: (a: number, b: any) => [number, number, number];
@@ -60,8 +35,11 @@ export const derecprotocolwasm_setOwnTransports: (a: number, b: number, c: numbe
 export const derecprotocolwasm_start: (a: number, b: number, c: any) => any;
 export const derecprotocolwasm_tick: (a: number) => any;
 export const derecprotocolwasm_verifyFingerprint: (a: number, b: any, c: number, d: number) => any;
-export const discovery_request_extract: (a: number, b: number, c: number, d: number) => [number, number, number];
-export const discovery_request_produce: (a: bigint, b: number, c: number, d: any) => [number, number, number];
+export const envelope_apply_trace_id: (a: number, b: number, c: bigint) => [number, number, number, number];
+export const envelope_read_trace_id: (a: number, b: number) => [bigint, number, number];
+export const recovery_response_extract: (a: number, b: number, c: number, d: number) => [number, number, number];
+export const recovery_response_produce: (a: bigint, b: any, c: any, d: number, e: number) => [number, number, number];
+export const recovery_response_recover: (a: bigint, b: number, c: any) => [number, number, number];
 export const pairing_request_create_contact: (a: bigint, b: number, c: any, d: any) => [number, number, number];
 export const pairing_request_decode_contact: (a: number, b: number) => [number, number, number];
 export const pairing_request_encode_contact: (a: any) => [number, number, number, number];
@@ -69,20 +47,41 @@ export const pairing_request_extract: (a: number, b: number, c: number, d: numbe
 export const pairing_request_extract_pre_pair: (a: number, b: number) => [number, number, number];
 export const pairing_request_produce: (a: number, b: any, c: any, d: any, e: any) => [number, number, number];
 export const pairing_request_produce_pre_pair: (a: any, b: any) => [number, number, number];
+export const unpairing_response_extract: (a: number, b: number, c: number, d: number) => [number, number, number];
+export const unpairing_response_process: (a: any) => [number, number, number];
+export const unpairing_response_produce: (a: bigint, b: number, c: number) => [number, number, number];
+export const discovery_response_extract: (a: number, b: number, c: number, d: number) => [number, number, number];
+export const discovery_response_process: (a: any) => [number, number, number];
+export const discovery_response_produce: (a: bigint, b: any, c: number, d: number) => [number, number, number];
 export const protocol_version: () => [number, number, number];
+export const sharing_response_extract: (a: number, b: number, c: number, d: number) => [number, number, number];
+export const sharing_response_process: (a: number, b: any) => [number, number];
+export const sharing_response_produce: (a: bigint, b: any, c: number, d: number) => [number, number, number];
+export const wasm_start: () => void;
+export const discovery_request_extract: (a: number, b: number, c: number, d: number) => [number, number, number];
+export const discovery_request_produce: (a: bigint, b: number, c: number, d: any) => [number, number, number];
+export const sharing_request_extract: (a: number, b: number, c: number, d: number) => [number, number, number];
+export const sharing_request_produce: (a: bigint, b: number, c: bigint, d: any, e: any, f: number, g: number, h: number, i: number, j: any) => [number, number, number];
+export const sharing_request_split: (a: any, b: bigint, c: number, d: number, e: number, f: number) => [number, number, number];
+export const recovery_request_extract: (a: number, b: number, c: number, d: number) => [number, number, number];
+export const recovery_request_produce: (a: bigint, b: bigint, c: number, d: number, e: number, f: any) => [number, number, number];
 export const unpairing_request_extract: (a: number, b: number, c: number, d: number) => [number, number, number];
 export const unpairing_request_produce: (a: bigint, b: number, c: number, d: number, e: number, f: any) => [number, number, number];
 export const verification_request_extract: (a: number, b: number, c: number, d: number) => [number, number, number];
 export const verification_request_produce: (a: bigint, b: bigint, c: number, d: number, e: number, f: any) => [number, number, number];
 export const generate_replica_id: () => bigint;
-export const recovery_response_extract: (a: number, b: number, c: number, d: number) => [number, number, number];
-export const recovery_response_produce: (a: bigint, b: any, c: any, d: number, e: number) => [number, number, number];
-export const recovery_response_recover: (a: bigint, b: number, c: any) => [number, number, number];
-export const unpairing_response_extract: (a: number, b: number, c: number, d: number) => [number, number, number];
-export const unpairing_response_process: (a: any) => [number, number, number];
-export const unpairing_response_produce: (a: bigint, b: number, c: number) => [number, number, number];
-export const recovery_request_extract: (a: number, b: number, c: number, d: number) => [number, number, number];
-export const recovery_request_produce: (a: bigint, b: bigint, c: number, d: number, e: number, f: any) => [number, number, number];
+export const pairing_fingerprint: (a: number, b: number) => [number, number, number, number];
+export const pairing_response_extract: (a: number, b: number, c: number, d: number) => [number, number, number];
+export const pairing_response_extract_pre_pair: (a: number, b: number) => [number, number, number];
+export const pairing_response_process: (a: any, b: any, c: number, d: number, e: any) => [number, number, number];
+export const pairing_response_process_pre_pair: (a: any, b: any) => [number, number, number];
+export const pairing_response_process_pre_pair_no_keys: (a: any, b: any) => [number, number, number];
+export const pairing_response_produce: (a: bigint, b: any, c: number, d: number, e: any, f: any, g: number) => [number, number, number];
+export const pairing_response_produce_pre_pair: (a: bigint, b: any, c: number, d: number) => [number, number, number];
+export const pairing_response_produce_pre_pair_no_keys: (a: bigint, b: any) => [number, number, number];
+export const verification_response_extract: (a: number, b: number, c: number, d: number) => [number, number, number];
+export const verification_response_process: (a: any, b: any, c: number, d: number) => [number, number, number];
+export const verification_response_produce: (a: bigint, b: any, c: number, d: number, e: number, f: number) => [number, number, number];
 export const wasm_bindgen__convert__closures_____invoke__h379e0770a020d351: (a: number, b: number, c: any) => [number, number];
 export const wasm_bindgen__convert__closures_____invoke__h037700d3f721a480: (a: number, b: number, c: any, d: any) => void;
 export const __wbindgen_malloc: (a: number, b: number) => number;

package/index.d.ts

@@ -253,6 +253,35 @@ export interface ShareStore {
   save(secretId: string, channelId: string, share: Share): Promise<void>;
   latestVersion(secretId: string): Promise<number | null>;
   removeChannel(secretId: string, channelId: string): Promise<void>;
+  /**
+   * Drop the shares stored under `(secretId, channelId)` at each of
+   * `versions`. Idempotent: a version that is not stored is skipped, and
+   * an empty array is a no-op.
+   *
+   * A helper calls this to apply `StoreShareRequestMessage.keepList`, the
+   * complete set of versions the owner wants retained: every stored
+   * version outside it is removed once the incoming share is persisted.
+   * Shares under other channels or partitions must be left untouched.
+   */
+  removeVersions(secretId: string, channelId: string, versions: number[]): Promise<void>;
+  /**
+   * Owner only: the versions every helper keeps after the owner distributes
+   * `version`. Asked once per sharing round, before anything is sent,
+   * including the rounds the library starts itself; the answer becomes
+   * `keepList` for every helper.
+   *
+   * Return `null` or `undefined` to send no `keepList` (it goes out empty):
+   * helpers then keep every version they hold. An app that wants to cap how
+   * many versions helpers retain returns that cap here. A returned list is
+   * used as is, plus `version`, which the library always adds. Helpers
+   * delete every version that is not listed, so list every version that
+   * could still become the latest: those that committed (for example, whose
+   * `SharingComplete` reported `threshold_met`) and those whose round is
+   * still open. Leave out only versions whose round failed or that the user
+   * rolled back; a list that leaves out too much can make the secret
+   * unrecoverable.
+   */
+  keepList(secretId: string, version: number): Promise<number[] | null | undefined>;
 }
 
 export interface UserSecretEntry {
@@ -615,6 +644,15 @@ export interface Timeouts {
  *  are both read from the stores. The argument may be omitted entirely. */
 export type ReplicaDiscoveryParams = Record<string, never>;
 
+/** Any member may remove any member, the source included: a lost or stolen
+ *  source must be removable by the devices that remain, and the library
+ *  checks no role. Ask the user before starting this flow, above all when it
+ *  names the source. Removing the source promotes the first remaining member
+ *  in the order the channel store's `listReplicas` returns. The removed
+ *  member is not asked and gets no event when told to leave: when a roster
+ *  excluding it arrives it drops its whole `secret_id` partition and emits
+ *  `SelfRemovedFromGroup`. The secret survives on the remaining members and
+ *  the helpers. */
 export interface UnpairReplicaParams {
   /** The member to remove, as a **decimal** `u64` string — the same form
    *  `ReplicaPaired.peer_replica_id` hands back. A value naming no current
@@ -686,8 +724,11 @@ export type DeRecEvent =
   | { type: "SharingComplete"; version: number; confirmed_count: number; failed_count: number; threshold_met: boolean }
   /** A group member refused a secret sync. Keyed by `replica_id`, not
    *  `channel_id`: every member answers on the one group channel. A
-   *  `VERSION_CONFLICT` status means the round must be resolved and
-   *  republished at a new version. */
+   *  `VERSION_CONFLICT` status means another member holds a different copy
+   *  of this version: do not publish from this device again until the
+   *  conflict is resolved. Run `start(FlowKind.ReplicaDiscovery)` to receive
+   *  the group's copy as `ReplicaVersionConflict`, merge, and publish the
+   *  result once with `start(FlowKind.ProtectSecret)`. */
   | {
       type: "ReplicaSyncRejected";
       replica_id: string;
@@ -710,7 +751,8 @@ export type DeRecEvent =
   /** This device left the group and dropped its whole `secret_id` partition —
    *  group channel, helper channels, shares, secrets and the snapshot. Fires
    *  only once it was told to leave *and* has since seen a roster excluding
-   *  it; absence alone never destroys a copy of the secret. */
+   *  it; absence alone never destroys a copy of the secret. The teardown is
+   *  automatic: this device is not asked first and gets no earlier event. */
   | { type: "SelfRemovedFromGroup"; version: number }
   /** A replica catch-up finished. `fetched_from` is absent when this device
    *  was already current, in which case no hydration event follows. */
@@ -726,6 +768,10 @@ export type DeRecEvent =
    *  library keeps no durable per-member sync state. */
   | { type: "ReplicaSyncComplete"; version: number; synced: string[]; behind: string[] }
   | { type: "ShareVerified"; channel_id: string; version: number }
+  /** A helper refused a verification challenge: its response carried a
+   *  non-OK `status` instead of a proof. The challenge is spent; a new
+   *  `VerifyShares` round challenges the helper again. */
+  | { type: "ShareVerifyRejected"; channel_id: string; version: number; status: StatusEnum; memo: string }
   | {
       type: "SecretsDiscovered";
       channel_id: string;
@@ -734,6 +780,22 @@ export type DeRecEvent =
     }
   | { type: "RecoveryShareReceived"; channel_id: string; shares_received: number }
   | { type: "RecoveryShareError"; channel_id: string; shares_received: number; error: string }
+  /** A helper refused a recovery share request: its response carried a
+   *  non-OK `status` (e.g. `UNKNOWN_SHARE_VERSION`) instead of a share. The
+   *  refusal is not collected — it does not count towards `shares_received`
+   *  and the recovery stays open for the other helpers' shares — but it does
+   *  answer that helper's `RecoverSecretStarted`. */
+  | { type: "RecoveryShareRefused"; channel_id: string; version: number; status: StatusEnum; memo: string }
+  /** A helper answered with a share that cannot be part of the secret;
+   *  `reason` says how it failed. `Malformed` and `InvalidProof` are judged
+   *  on arrival; `Inconsistent` (valid on its own but disagreeing with the
+   *  shares the secret was rebuilt from) is reported alongside
+   *  `SecretRecovered`, once per helper. The share is set aside — it does
+   *  not count towards `shares_received` and never blocks the recovery. An
+   *  honest helper never sends one, so the app may treat it as a sign of a
+   *  damaged or compromised helper, e.g. offer to unpair it. It also
+   *  answers that helper's `RecoverSecretStarted`. */
+  | { type: "RecoveryShareCorrupted"; channel_id: string; version: number; reason: CorruptionReason }
   /** Recovery completed — the typed `Secret` snapshot the owner
    *  originally protected. Mirrors `ReplicaSecretReceived.secret`:
    *  `secrets` is the user-facing `Vec<UserSecret>` the application
@@ -911,7 +973,10 @@ export type DeRecEvent =
    *  `ReplicaSyncRejected`. Both copies are complete states — the held one
    *  is in the local stores, the incoming one is `secret`. Resolve by
    *  publishing the chosen state with `start(FlowKind.ProtectSecret)`; the
-   *  next version supersedes both on every member and helper.
+   *  next version supersedes both on every member and helper. Until then,
+   *  do not publish from this device: any further `ProtectSecret` is a
+   *  higher version that every other member applies over its own copy,
+   *  losing the change it never merged.
    *
    *  `held_author_replica_id` / `incoming_author_replica_id` are the
    *  decimal `replica_id` of each copy's publisher, or `null` when that
@@ -1167,8 +1232,6 @@ export declare class DeRecProtocolBuilder {
 
   /** Minimum number of shares required to reconstruct the secret. Default: 3. */
   withThreshold(threshold: number): DeRecProtocolBuilder;
-  /** Number of recent versions each helper must retain. Default: 3. */
-  withKeepVersionsCount(count: number): DeRecProtocolBuilder;
   /**
    * Configure how long the protocol waits on each thing that can keep it
    * waiting. Every field is optional and **absent means "keep the library
@@ -1388,6 +1451,11 @@ export declare class DeRecProtocol {
    * Verify `fingerprint` against the channel's locally-derived one. On
    * match, the channel transitions from `Pending` to `Paired`. Returns
    * `true` on confirmation, `false` on mismatch.
+   *
+   * On a replica destination, confirming is also the decision to adopt the
+   * group's vault: the source's publish is then installed as it arrives,
+   * with no further prompt. Ask the user before calling this; to decline,
+   * never confirm.
    */
   verifyFingerprint(channelId: bigint | number, fingerprint: string): Promise<boolean>;
   /**
@@ -1409,6 +1477,10 @@ export declare class DeRecProtocol {
    * `Secret`. Mirrors the Rust `DeRecProtocol::restore` — pass the
    * typed `secret` carried by the `SecretRecovered` event verbatim.
    *
+   * Recovery and restore are separate steps on purpose: `SecretRecovered`
+   * writes nothing. Show the user what was recovered, or ask them, before
+   * calling `restore`, which commits it to this device.
+   *
    * A helper or member whose `transports` is empty gets no channel: it is
    * reported as a `PeerNotRestored` event in the returned array and the rest
    * of the roster is restored.
@@ -1538,6 +1610,14 @@ export type IgnoreReason = "PendingVerification" | "Expired";
  *  Matches the Rust `NotRestoredReason` discriminants one-for-one. */
 export type NotRestoredReason = "NoTransports";
 
+/** Why a `RecoveryShareCorrupted` event set a helper's share aside.
+ *  Matches the Rust `CorruptionReason` discriminants one-for-one:
+ *  `Malformed` — no decodable share for the requested secret and version;
+ *  `InvalidProof` — the share fails its own Merkle proof;
+ *  `Inconsistent` — valid on its own, but its commitment root or ciphertext
+ *  disagrees with the shares the secret was rebuilt from. */
+export type CorruptionReason = "Malformed" | "InvalidProof" | "Inconsistent";
+
 export type PendingActionKind =
   | "Pairing"
   | "PrePair"
@@ -1860,6 +1940,12 @@ export interface DeRecError {
   got?: number;
   /** The channel the failing inbound message arrived on, when `process()` could tell. */
   channel_id?: string;
+  /**
+   * On a failed `process()`: the events it produced before failing, such as
+   * sharing-round and unpair timeouts. They are not reported again, so
+   * handle them as you would a successful call's events.
+   */
+  events?: DeRecEvent[];
   /** On a `restore` `CONFLICT`: the pre-existing channels at canonical ids. */
   channel_ids?: string[];
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@derec-alliance/nodejs",
   "description": "Node.js WebAssembly bindings for derec-library, the Rust SDK for the DeRec protocol.",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",