@meshconnect/uwc-wallet-connect-connector 0.8.2 → 0.9.0

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export * from './wallet-connect-connector';
+export type { WalletConnectTelemetryObserver } from './services/walletconnect-client';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,YAAY,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAA"}

package/dist/services/walletconnect-client.d.ts

@@ -6,25 +6,86 @@ import type { WalletConnectConfig } from '@meshconnect/uwc-types';
  * session even if messages are high-cardinality (timestamps / urls).
  */
 export declare const MAX_REPORTED_RELAY_ERRORS = 100;
+/**
+ * Cap on relay transport-lifecycle emissions PER EVENT TYPE (disconnect and
+ * reconnect budgeted independently) per client. A flapping socket IS the signal
+ * we want, but bounding emissions keeps a pathological relay from flooding
+ * telemetry on a long-lived session. Independent budgets so a drop-heavy flap
+ * that exhausts the disconnect cap can never silently swallow the paired
+ * reconnect — otherwise telemetry would show drops with no recovery for a socket
+ * that did recover.
+ */
+export declare const MAX_REPORTED_RELAY_LIFECYCLE = 50;
+/**
+ * Optional telemetry sinks for the WalletConnect client. Covers both the relay
+ * transport (error / disconnect / reconnect) AND `SignClient.init` failures.
+ * Every field is opt-in — an empty observer leaves behaviour unchanged. All
+ * sinks are telemetry-only: they never alter connection behaviour, and a
+ * throwing sink is swallowed so it can't break the SDK's relayer dispatch (or,
+ * for `onInitError`, mask the always-rethrown init rejection).
+ */
+export interface WalletConnectTelemetryObserver {
+    /**
+     * Relay-socket failure: the relayer re-emits an abnormal WebSocket close under
+     * `RELAYER_EVENTS.error` (e.g. code 3000 "JWT Token is not yet valid" on clock
+     * skew), detached from the connect() promise. Deduped per message.
+     */
+    onRelayError?: (error: unknown) => void;
+    /**
+     * `SignClient.init` failure (storage/crypto, NOT relay). Telemetry-only — the
+     * init rejection is always rethrown so `getClient()` callers see it unchanged.
+     */
+    onInitError?: (error: unknown) => void;
+    /**
+     * Relay transport socket dropped (relayer `disconnect`), emitted once per
+     * outage. The lifecycle FACT — distinct from `onRelayError` (a close WITH an
+     * error). This is the CARE-263 signal a suspended WebView produces silently.
+     */
+    onRelayDisconnect?: () => void;
+    /**
+     * Relay socket recovered (relayer `connect` after a drop). Pair with
+     * `onRelayDisconnect` to measure the dead window.
+     */
+    onRelayReconnect?: () => void;
+}
+/**
+ * Normalize the telemetry constructor slots into a `WalletConnectTelemetryObserver`.
+ *
+ * BACKWARD COMPATIBILITY: the published 0.8.x signature was positional —
+ * `(…, onRelayError?, onInitError?)`. This PR moved to a single observer object;
+ * the positional form is retained so external JS/TS consumers on 0.8.x don't
+ * break at runtime. Disambiguate on the first telemetry slot: a FUNCTION is the
+ * legacy `onRelayError` (the new form always passes an object). The legacy form
+ * predates `onRelayDisconnect`/`onRelayReconnect`, so those are simply absent.
+ */
+export declare function toTelemetryObserver(observerOrOnRelayError?: WalletConnectTelemetryObserver | ((error: unknown) => void), onInitError?: (error: unknown) => void): WalletConnectTelemetryObserver;
 /**
  * Service for managing WalletConnect client instance
  */
 export declare class WalletConnectClient {
-    private config;
-    private onRelayError?;
-    private onInitError?;
     private client;
     private initPromise;
     /** Dedupe relay-error reports so a reconnect storm surfaces once, not per tick. */
     private readonly relayErrorDedup;
+    /** Independent bounded counters so drop/recover telemetry can never starve each other. */
+    private relayDisconnectCount;
+    private relayReconnectCount;
+    /** True once the socket has dropped — gates `relayReconnected` to real recoveries. */
+    private relayHasDisconnected;
+    private readonly config;
+    private readonly telemetryObserver;
     /**
-     * @param onRelayError - optional telemetry sink for relay-socket failures (see
-     *   `attachRelayErrorListener`). Opt-in: with nothing wired, behaviour is unchanged.
-     * @param onInitError - optional telemetry sink for a failed `SignClient.init`.
-     *   Opt-in: with nothing wired, behaviour is unchanged. Telemetry-only — the init
-     *   rejection is always rethrown so `getClient()` callers see it exactly as before.
+     * @param telemetryObserver - optional telemetry sinks (see
+     *   `WalletConnectTelemetryObserver`). Every field is opt-in; an empty/omitted
+     *   observer leaves behaviour unchanged.
      */
-    constructor(config: WalletConnectConfig, onRelayError?: ((error: unknown) => void) | undefined, onInitError?: ((error: unknown) => void) | undefined);
+    constructor(config: WalletConnectConfig, telemetryObserver?: WalletConnectTelemetryObserver);
+    /**
+     * @deprecated Pass a {@link WalletConnectTelemetryObserver}. The positional
+     * `(onRelayError, onInitError)` form is retained for backward compatibility
+     * with the published 0.8.x signature and will be removed in a future major.
+     */
+    constructor(config: WalletConnectConfig, onRelayError?: (error: unknown) => void, onInitError?: (error: unknown) => void);
     /**
      * Initialize or get the WalletConnect client
      */
@@ -39,11 +100,27 @@ export declare class WalletConnectClient {
      * "JWT Token is not yet valid" when the device clock is skewed past the relay's
      * 120s leeway. That error is otherwise detached from the connect() promise, so it
      * escapes the connect handoff and lands as an unhandled error. Forward it (deduped
-     * per message) so it becomes a classified signal instead. `error` only —
-     * `connection_stalled` / `transport_closed` fire on transient blips and would add
-     * noise. Telemetry-only; it never changes connection behaviour.
+     * per message) so it becomes a classified signal instead. This listener handles the
+     * relayer ERROR stream only; the socket's clean up/down lifecycle is captured
+     * separately by `attachRelayLifecycleListeners` (CARE-263 — a suspended WebView
+     * drops the socket without emitting an `error`). Telemetry-only; never changes behaviour.
      */
     private attachRelayErrorListener;
+    /**
+     * Surface the relay transport socket's up/down lifecycle as telemetry. This is
+     * the signal `attachRelayErrorListener` misses: when iOS suspends the WebView
+     * during a wallet deep-link the socket drops with no `error` event, WC core only
+     * reconnects on its slow internal heartbeat, and any in-flight sign/connect
+     * response strands in the meantime (CARE-263). Emitting `disconnect` + the
+     * subsequent `connect` lets us see the drop and measure the dead window.
+     *
+     * Emitted at most once per outage: WC core re-emits `disconnect` on every failed
+     * reconnect attempt, so a transition flag gates the emit to keep drop/recover 1:1
+     * (and bounds emissions); a counter cap backstops many distinct outages. Both
+     * sinks are guarded so a throwing observer can never break the SDK's relayer
+     * dispatch. Telemetry-only; it never changes connection behaviour.
+     */
+    private attachRelayLifecycleListeners;
     /**
      * The initialized client if `connect()` already ran, else null. Synchronous —
      * lets callers attach lifecycle listeners post-connect without forcing a

package/dist/services/walletconnect-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"walletconnect-client.d.ts","sourceRoot":"","sources":["../../src/services/walletconnect-client.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,4BAA4B,CAAA;AAGnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAEjE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,MAAM,CAAA;AAE5C;;GAEG;AACH,qBAAa,mBAAmB;IAgB5B,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,YAAY,CAAC;IACrB,OAAO,CAAC,WAAW,CAAC;IAjBtB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,WAAW,CAAmC;IACtD,mFAAmF;IACnF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAE/B;IAED;;;;;;OAMG;gBAEO,MAAM,EAAE,mBAAmB,EAC3B,YAAY,CAAC,GAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,aAAA,EACvC,WAAW,CAAC,GAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,aAAA;IAGhD;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC;IAmBtC;;OAEG;YACW,UAAU;IAgDxB;;;;;;;;;OASG;IACH,OAAO,CAAC,wBAAwB;IAkBhC;;;;OAIG;IACH,iBAAiB,IAAI,UAAU,GAAG,IAAI;IAItC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBpC;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAW/C"}
+{"version":3,"file":"walletconnect-client.d.ts","sourceRoot":"","sources":["../../src/services/walletconnect-client.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,4BAA4B,CAAA;AAGnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAEjE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,MAAM,CAAA;AAE5C;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,KAAK,CAAA;AAE9C;;;;;;;GAOG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IACvC;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IACtC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAA;IAC9B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAA;CAC9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,sBAAsB,CAAC,EACnB,8BAA8B,GAC9B,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,EAC9B,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GACrC,8BAA8B,CAsBhC;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,WAAW,CAAmC;IACtD,mFAAmF;IACnF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAE/B;IACD,0FAA0F;IAC1F,OAAO,CAAC,oBAAoB,CAAI;IAChC,OAAO,CAAC,mBAAmB,CAAI;IAC/B,sFAAsF;IACtF,OAAO,CAAC,oBAAoB,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAgC;IAElE;;;;OAIG;gBAED,MAAM,EAAE,mBAAmB,EAC3B,iBAAiB,CAAC,EAAE,8BAA8B;IAEpD;;;;OAIG;gBAED,MAAM,EAAE,mBAAmB,EAC3B,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,EACvC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI;IAgBxC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC;IAmBtC;;OAEG;YACW,UAAU;IAiDxB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,wBAAwB;IAkBhC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,6BAA6B;IA6CrC;;;;OAIG;IACH,iBAAiB,IAAI,UAAU,GAAG,IAAI;IAItC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBpC;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAW/C"}

package/dist/services/walletconnect-client.js

@@ -7,28 +7,64 @@ import { createBoundedDedup, safeErrorMessage } from '@meshconnect/uwc-types';
  * session even if messages are high-cardinality (timestamps / urls).
  */
 export const MAX_REPORTED_RELAY_ERRORS = 100;
+/**
+ * Cap on relay transport-lifecycle emissions PER EVENT TYPE (disconnect and
+ * reconnect budgeted independently) per client. A flapping socket IS the signal
+ * we want, but bounding emissions keeps a pathological relay from flooding
+ * telemetry on a long-lived session. Independent budgets so a drop-heavy flap
+ * that exhausts the disconnect cap can never silently swallow the paired
+ * reconnect — otherwise telemetry would show drops with no recovery for a socket
+ * that did recover.
+ */
+export const MAX_REPORTED_RELAY_LIFECYCLE = 50;
+/**
+ * Normalize the telemetry constructor slots into a `WalletConnectTelemetryObserver`.
+ *
+ * BACKWARD COMPATIBILITY: the published 0.8.x signature was positional —
+ * `(…, onRelayError?, onInitError?)`. This PR moved to a single observer object;
+ * the positional form is retained so external JS/TS consumers on 0.8.x don't
+ * break at runtime. Disambiguate on the first telemetry slot: a FUNCTION is the
+ * legacy `onRelayError` (the new form always passes an object). The legacy form
+ * predates `onRelayDisconnect`/`onRelayReconnect`, so those are simply absent.
+ */
+export function toTelemetryObserver(observerOrOnRelayError, onInitError) {
+    const onRelayError = typeof observerOrOnRelayError === 'function'
+        ? observerOrOnRelayError
+        : undefined;
+    // Legacy positional form when EITHER positional callback is present — this
+    // includes the `(undefined, onInitError)` "init-only" call pattern, so that
+    // sink is never silently dropped. Keys are added conditionally because
+    // `exactOptionalPropertyTypes` forbids an explicit `undefined` on an optional.
+    if (onRelayError || onInitError) {
+        return {
+            ...(onRelayError ? { onRelayError } : {}),
+            ...(onInitError ? { onInitError } : {})
+        };
+    }
+    // New form: an observer object (or nothing).
+    return typeof observerOrOnRelayError === 'object' &&
+        observerOrOnRelayError !== null
+        ? observerOrOnRelayError
+        : {};
+}
 /**
  * Service for managing WalletConnect client instance
  */
 export class WalletConnectClient {
-    config;
-    onRelayError;
-    onInitError;
     client = null;
     initPromise = null;
     /** Dedupe relay-error reports so a reconnect storm surfaces once, not per tick. */
     relayErrorDedup = createBoundedDedup(MAX_REPORTED_RELAY_ERRORS);
-    /**
-     * @param onRelayError - optional telemetry sink for relay-socket failures (see
-     *   `attachRelayErrorListener`). Opt-in: with nothing wired, behaviour is unchanged.
-     * @param onInitError - optional telemetry sink for a failed `SignClient.init`.
-     *   Opt-in: with nothing wired, behaviour is unchanged. Telemetry-only — the init
-     *   rejection is always rethrown so `getClient()` callers see it exactly as before.
-     */
-    constructor(config, onRelayError, onInitError) {
+    /** Independent bounded counters so drop/recover telemetry can never starve each other. */
+    relayDisconnectCount = 0;
+    relayReconnectCount = 0;
+    /** True once the socket has dropped — gates `relayReconnected` to real recoveries. */
+    relayHasDisconnected = false;
+    config;
+    telemetryObserver;
+    constructor(config, observerOrOnRelayError, onInitError) {
         this.config = config;
-        this.onRelayError = onRelayError;
-        this.onInitError = onInitError;
+        this.telemetryObserver = toTelemetryObserver(observerOrOnRelayError, onInitError);
     }
     /**
      * Initialize or get the WalletConnect client
@@ -85,7 +121,7 @@ export class WalletConnectClient {
             // instead of a generic connect failure. The sink is guarded so a throwing observer
             // can't mask the real rejection, which is always rethrown.
             try {
-                this.onInitError?.(error);
+                this.telemetryObserver.onInitError?.(error);
             }
             catch {
                 // Telemetry must never replace the init rejection.
@@ -93,6 +129,7 @@ export class WalletConnectClient {
             throw error;
         }
         this.attachRelayErrorListener(client);
+        this.attachRelayLifecycleListeners(client);
         return client;
     }
     /**
@@ -101,12 +138,13 @@ export class WalletConnectClient {
      * "JWT Token is not yet valid" when the device clock is skewed past the relay's
      * 120s leeway. That error is otherwise detached from the connect() promise, so it
      * escapes the connect handoff and lands as an unhandled error. Forward it (deduped
-     * per message) so it becomes a classified signal instead. `error` only —
-     * `connection_stalled` / `transport_closed` fire on transient blips and would add
-     * noise. Telemetry-only; it never changes connection behaviour.
+     * per message) so it becomes a classified signal instead. This listener handles the
+     * relayer ERROR stream only; the socket's clean up/down lifecycle is captured
+     * separately by `attachRelayLifecycleListeners` (CARE-263 — a suspended WebView
+     * drops the socket without emitting an `error`). Telemetry-only; never changes behaviour.
      */
     attachRelayErrorListener(client) {
-        if (!this.onRelayError)
+        if (!this.telemetryObserver.onRelayError)
             return;
         client.core?.relayer?.on(RELAYER_EVENTS.error, (error) => {
             // safeErrorMessage: this runs INSIDE the SDK's relayer dispatch, before
@@ -116,7 +154,7 @@ export class WalletConnectClient {
             if (!this.relayErrorDedup.firstSeen(message))
                 return;
             try {
-                this.onRelayError?.(error);
+                this.telemetryObserver.onRelayError?.(error);
             }
             catch {
                 // A throwing sink would propagate synchronously out of the WC SDK's
@@ -125,6 +163,63 @@ export class WalletConnectClient {
             }
         });
     }
+    /**
+     * Surface the relay transport socket's up/down lifecycle as telemetry. This is
+     * the signal `attachRelayErrorListener` misses: when iOS suspends the WebView
+     * during a wallet deep-link the socket drops with no `error` event, WC core only
+     * reconnects on its slow internal heartbeat, and any in-flight sign/connect
+     * response strands in the meantime (CARE-263). Emitting `disconnect` + the
+     * subsequent `connect` lets us see the drop and measure the dead window.
+     *
+     * Emitted at most once per outage: WC core re-emits `disconnect` on every failed
+     * reconnect attempt, so a transition flag gates the emit to keep drop/recover 1:1
+     * (and bounds emissions); a counter cap backstops many distinct outages. Both
+     * sinks are guarded so a throwing observer can never break the SDK's relayer
+     * dispatch. Telemetry-only; it never changes connection behaviour.
+     */
+    attachRelayLifecycleListeners(client) {
+        if (!this.telemetryObserver.onRelayDisconnect &&
+            !this.telemetryObserver.onRelayReconnect)
+            return;
+        const relayer = client.core?.relayer;
+        if (!relayer)
+            return;
+        // Guarded + capped emit with an INDEPENDENT budget per event type. Cap is only
+        // consumed when a sink is wired; the guard keeps a throwing observer from
+        // breaking the relayer's own dispatch. Separate budgets ensure a drop-heavy
+        // flap can never exhaust the shared pool and silently drop the paired recovery.
+        const report = (sink, counter) => {
+            if (!sink)
+                return;
+            if (this[counter] >= MAX_REPORTED_RELAY_LIFECYCLE)
+                return;
+            this[counter]++;
+            try {
+                sink();
+            }
+            catch {
+                // Telemetry must never break the relayer's lifecycle handling.
+            }
+        };
+        relayer.on(RELAYER_EVENTS.disconnect, () => {
+            // WC core re-emits `disconnect` on each failed reconnect during one outage —
+            // emit only on the transition INTO disconnected so drop/recover stay 1:1 (and
+            // relayDropCount counts outages, not re-emits). The relayer passes no payload
+            // (socket errors arrive via RELAYER_EVENTS.error / onRelayError).
+            if (this.relayHasDisconnected)
+                return;
+            this.relayHasDisconnected = true;
+            report(this.telemetryObserver.onRelayDisconnect, 'relayDisconnectCount');
+        });
+        relayer.on(RELAYER_EVENTS.connect, () => {
+            // `connect` also fires on the FIRST socket open — only a connect that follows
+            // a disconnect is a genuine recovery and pairs 1:1 with the dead window.
+            if (!this.relayHasDisconnected)
+                return;
+            this.relayHasDisconnected = false;
+            report(this.telemetryObserver.onRelayReconnect, 'relayReconnectCount');
+        });
+    }
     /**
      * The initialized client if `connect()` already ran, else null. Synchronous —
      * lets callers attach lifecycle listeners post-connect without forcing a

package/dist/services/walletconnect-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"walletconnect-client.js","sourceRoot":"","sources":["../../src/services/walletconnect-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"walletconnect-client.js","sourceRoot":"","sources":["../../src/services/walletconnect-client.ts"],"names":[],"mappings":"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"}

package/dist/wallet-connect-connector.d.ts

@@ -1,4 +1,5 @@
 import type { Network, Connector, ConnectorResult, SwitchNetworkResult, WalletConnectConfig, WalletConnectProvider, TransactionRequest, TransactionResult, NetworkRpcMap, SignatureType, EIP712TypedData, WalletLifecycleEvent, WalletLifecycleContext } from '@meshconnect/uwc-types';
+import { type WalletConnectTelemetryObserver } from './services/walletconnect-client';
 export declare class WalletConnectConnector implements Connector {
     private walletConnectClient;
     private connectionService;
@@ -6,6 +7,12 @@ export declare class WalletConnectConnector implements Connector {
     private signatureService;
     private transactionService;
     private networkRpcMap;
+    constructor(config: WalletConnectConfig, networkRpcMap?: NetworkRpcMap, telemetryObserver?: WalletConnectTelemetryObserver);
+    /**
+     * @deprecated Pass a {@link WalletConnectTelemetryObserver}. The positional
+     * `(onRelayError, onInitError)` form is retained for backward compatibility
+     * with the published 0.8.x signature and will be removed in a future major.
+     */
     constructor(config: WalletConnectConfig, networkRpcMap?: NetworkRpcMap, onRelayError?: (error: unknown) => void, onInitError?: (error: unknown) => void);
     connect(network: Network, provider?: WalletConnectProvider): Promise<ConnectorResult>;
     getConnectionURI(): string;

package/dist/wallet-connect-connector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wallet-connect-connector.d.ts","sourceRoot":"","sources":["../src/wallet-connect-connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAEP,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,wBAAwB,CAAA;AAsG/B,qBAAa,sBAAuB,YAAW,SAAS;IACtD,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,iBAAiB,CAAmB;IAC5C,OAAO,CAAC,oBAAoB,CAAsB;IAClD,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,kBAAkB,CAAoB;IAC9C,OAAO,CAAC,aAAa,CAAe;gBAGlC,MAAM,EAAE,mBAAmB,EAC3B,aAAa,GAAE,aAAkB,EACjC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,EACvC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI;IAwBlC,OAAO,CACX,OAAO,EAAE,OAAO,EAChB,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,OAAO,CAAC,eAAe,CAAC;IAU3B,gBAAgB,IAAI,MAAM;IAQpB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAI7D,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIpD,aAAa,CAAC,SAAS,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAI1D,eAAe,CACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;IAI7B;;;;;;OAMG;IACG,0BAA0B,CAC9B,YAAY,EAAE,UAAU,GACvB,OAAO,CAAC,UAAU,CAAC;IAItB;;;;;;;;;;;;;;;;;OAiBG;IACH,gBAAgB,CACd,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,EAI/C,QAAQ,EAAE,sBAAsB,GAC/B,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS;CA8C5B"}
+{"version":3,"file":"wallet-connect-connector.d.ts","sourceRoot":"","sources":["../src/wallet-connect-connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAEP,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAGL,KAAK,8BAA8B,EACpC,MAAM,iCAAiC,CAAA;AAqGxC,qBAAa,sBAAuB,YAAW,SAAS;IACtD,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,iBAAiB,CAAmB;IAC5C,OAAO,CAAC,oBAAoB,CAAsB;IAClD,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,kBAAkB,CAAoB;IAC9C,OAAO,CAAC,aAAa,CAAe;gBAGlC,MAAM,EAAE,mBAAmB,EAC3B,aAAa,CAAC,EAAE,aAAa,EAC7B,iBAAiB,CAAC,EAAE,8BAA8B;IAEpD;;;;OAIG;gBAED,MAAM,EAAE,mBAAmB,EAC3B,aAAa,CAAC,EAAE,aAAa,EAC7B,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,EACvC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI;IA+BlC,OAAO,CACX,OAAO,EAAE,OAAO,EAChB,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,OAAO,CAAC,eAAe,CAAC;IAU3B,gBAAgB,IAAI,MAAM;IAQpB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAI7D,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIpD,aAAa,CAAC,SAAS,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAI1D,eAAe,CACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;IAI7B;;;;;;OAMG;IACG,0BAA0B,CAC9B,YAAY,EAAE,UAAU,GACvB,OAAO,CAAC,UAAU,CAAC;IAItB;;;;;;;;;;;;;;;;;OAiBG;IACH,gBAAgB,CACd,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,EAI/C,QAAQ,EAAE,sBAAsB,GAC/B,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS;CA8C5B"}

package/dist/wallet-connect-connector.js

@@ -1,4 +1,4 @@
-import { WalletConnectClient } from './services/walletconnect-client';
+import { WalletConnectClient, toTelemetryObserver } from './services/walletconnect-client';
 import { ConnectionService } from './services/connection-service';
 import { NetworkSwitchService } from './services/network-switch-service';
 import { SignatureService } from './services/signature-service';
@@ -108,8 +108,8 @@ export class WalletConnectConnector {
     signatureService;
     transactionService;
     networkRpcMap;
-    constructor(config, networkRpcMap = {}, onRelayError, onInitError) {
-        this.walletConnectClient = new WalletConnectClient(config, onRelayError, onInitError);
+    constructor(config, networkRpcMap = {}, observerOrOnRelayError, onInitError) {
+        this.walletConnectClient = new WalletConnectClient(config, toTelemetryObserver(observerOrOnRelayError, onInitError));
         this.networkRpcMap = networkRpcMap;
         this.connectionService = new ConnectionService(this.walletConnectClient);
         this.networkSwitchService = new NetworkSwitchService(this.walletConnectClient, this.connectionService);

package/dist/wallet-connect-connector.js.map

@@ -1 +1 @@
-{"version":3,"file":"wallet-connect-connector.js","sourceRoot":"","sources":["../src/wallet-connect-connector.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"wallet-connect-connector.js","sourceRoot":"","sources":["../src/wallet-connect-connector.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meshconnect/uwc-wallet-connect-connector",
-  "version": "0.8.2",
+  "version": "0.9.0",
   "description": "WalletConnect connector for Universal Wallet Connector",
   "type": "module",
   "main": "dist/index.js",

package/src/index.ts

@@ -1 +1,2 @@
 export * from './wallet-connect-connector'
+export type { WalletConnectTelemetryObserver } from './services/walletconnect-client'

package/src/services/walletconnect-client.test.ts

@@ -21,7 +21,9 @@ vi.mock('@walletconnect/sign-client', () => ({
 import SignClient from '@walletconnect/sign-client'
 import {
   WalletConnectClient,
-  MAX_REPORTED_RELAY_ERRORS
+  toTelemetryObserver,
+  MAX_REPORTED_RELAY_ERRORS,
+  MAX_REPORTED_RELAY_LIFECYCLE
 } from './walletconnect-client'
 
 const CONFIG = { projectId: 'p' } as WalletConnectConfig
@@ -38,7 +40,9 @@ describe('WalletConnectClient relay-error surfacing', () => {
 
   it('forwards a relayer error to onRelayError', async () => {
     const errors: unknown[] = []
-    const client = new WalletConnectClient(CONFIG, e => errors.push(e))
+    const client = new WalletConnectClient(CONFIG, {
+      onRelayError: e => errors.push(e)
+    })
     await client.getClient()
 
     relayerHandlers[RELAYER_EVENTS.error]?.(
@@ -53,7 +57,9 @@ describe('WalletConnectClient relay-error surfacing', () => {
 
   it('dedupes repeated identical relay errors (reconnect storm → one report)', async () => {
     const errors: unknown[] = []
-    const client = new WalletConnectClient(CONFIG, e => errors.push(e))
+    const client = new WalletConnectClient(CONFIG, {
+      onRelayError: e => errors.push(e)
+    })
     await client.getClient()
 
     const fire = () =>
@@ -66,8 +72,10 @@ describe('WalletConnectClient relay-error surfacing', () => {
   })
 
   it('swallows a throwing onRelayError sink — must not break the relayer emitter', async () => {
-    const client = new WalletConnectClient(CONFIG, () => {
-      throw new Error('sink exploded')
+    const client = new WalletConnectClient(CONFIG, {
+      onRelayError: () => {
+        throw new Error('sink exploded')
+      }
     })
     await client.getClient()
 
@@ -80,7 +88,9 @@ describe('WalletConnectClient relay-error surfacing', () => {
 
   it('never throws when the relayer emits a value with a throwing toString()', async () => {
     const errors: unknown[] = []
-    const client = new WalletConnectClient(CONFIG, e => errors.push(e))
+    const client = new WalletConnectClient(CONFIG, {
+      onRelayError: e => errors.push(e)
+    })
     await client.getClient()
 
     const evil = {
@@ -102,7 +112,9 @@ describe('WalletConnectClient relay-error surfacing', () => {
 
   it('bounds the dedup set — an evicted message can report again past the cap', async () => {
     const errors: unknown[] = []
-    const client = new WalletConnectClient(CONFIG, e => errors.push(e))
+    const client = new WalletConnectClient(CONFIG, {
+      onRelayError: e => errors.push(e)
+    })
     await client.getClient()
     const fire = (m: string) =>
       relayerHandlers[RELAYER_EVENTS.error]?.(new Error(m))
@@ -125,14 +137,135 @@ describe('WalletConnectClient relay-error surfacing', () => {
   })
 })
 
+describe('WalletConnectClient relay-lifecycle surfacing', () => {
+  beforeEach(() => {
+    for (const key of Object.keys(relayerHandlers)) delete relayerHandlers[key]
+  })
+
+  it('emits disconnect once per outage — ignores WC-core re-emits during the outage', async () => {
+    let drops = 0
+    const client = new WalletConnectClient(CONFIG, {
+      onRelayDisconnect: () => {
+        drops++
+      }
+    })
+    await client.getClient()
+
+    // WC core re-emits `disconnect` on each failed reconnect attempt; only the
+    // transition INTO disconnected counts.
+    relayerHandlers[RELAYER_EVENTS.disconnect]?.()
+    relayerHandlers[RELAYER_EVENTS.disconnect]?.()
+    relayerHandlers[RELAYER_EVENTS.disconnect]?.()
+    expect(drops).toBe(1)
+
+    // A reconnect closes the outage; the next disconnect is a NEW outage.
+    relayerHandlers[RELAYER_EVENTS.connect]?.()
+    relayerHandlers[RELAYER_EVENTS.disconnect]?.()
+    expect(drops).toBe(2)
+  })
+
+  it('emits reconnect only for a connect that follows a disconnect (not the initial connect)', async () => {
+    let reconnects = 0
+    const client = new WalletConnectClient(CONFIG, {
+      onRelayReconnect: () => {
+        reconnects++
+      }
+    })
+    await client.getClient()
+
+    // Initial / spurious connect with no prior drop → not a recovery.
+    relayerHandlers[RELAYER_EVENTS.connect]?.()
+    expect(reconnects).toBe(0)
+
+    // A drop then a connect → exactly one genuine recovery.
+    relayerHandlers[RELAYER_EVENTS.disconnect]?.({})
+    relayerHandlers[RELAYER_EVENTS.connect]?.()
+    expect(reconnects).toBe(1)
+
+    // Another connect with no new drop → not counted again.
+    relayerHandlers[RELAYER_EVENTS.connect]?.()
+    expect(reconnects).toBe(1)
+  })
+
+  it('does not attach lifecycle listeners when neither sink is wired', async () => {
+    const client = new WalletConnectClient(CONFIG)
+    await client.getClient()
+    expect(relayerHandlers[RELAYER_EVENTS.disconnect]).toBeUndefined()
+    expect(relayerHandlers[RELAYER_EVENTS.connect]).toBeUndefined()
+  })
+
+  it('swallows a throwing lifecycle sink — must not break the relayer emitter', async () => {
+    const client = new WalletConnectClient(CONFIG, {
+      onRelayDisconnect: () => {
+        throw new Error('sink exploded')
+      }
+    })
+    await client.getClient()
+
+    // Runs inside the WC SDK's relayer disconnect dispatch — a propagating throw
+    // would prevent the SDK's own transport teardown from running.
+    expect(() => relayerHandlers[RELAYER_EVENTS.disconnect]?.({})).not.toThrow()
+  })
+
+  it('caps disconnect and reconnect INDEPENDENTLY past the cap (recovery never starved by drops)', async () => {
+    let drops = 0
+    let recoveries = 0
+    const client = new WalletConnectClient(CONFIG, {
+      onRelayDisconnect: () => {
+        drops++
+      },
+      onRelayReconnect: () => {
+        recoveries++
+      }
+    })
+    await client.getClient()
+
+    // Each outage is a disconnect→connect cycle. Fire well past the cap; each
+    // event type has its OWN budget, so BOTH reach MAX — a drop-heavy flap can
+    // never exhaust a shared pool and silently swallow the paired recovery.
+    for (let i = 0; i < MAX_REPORTED_RELAY_LIFECYCLE + 20; i++) {
+      relayerHandlers[RELAYER_EVENTS.disconnect]?.()
+      relayerHandlers[RELAYER_EVENTS.connect]?.()
+    }
+    expect(drops).toBe(MAX_REPORTED_RELAY_LIFECYCLE)
+    expect(recoveries).toBe(MAX_REPORTED_RELAY_LIFECYCLE)
+  })
+
+  it('still reports a recovery after the DISCONNECT budget alone is exhausted', async () => {
+    // Szymon's scenario: a socket that drops many times, then finally recovers.
+    // With a shared budget the recovery could be dropped; with independent
+    // budgets the reconnect must still surface.
+    let drops = 0
+    let recoveries = 0
+    const client = new WalletConnectClient(CONFIG, {
+      onRelayDisconnect: () => {
+        drops++
+      },
+      onRelayReconnect: () => {
+        recoveries++
+      }
+    })
+    await client.getClient()
+
+    // Exhaust the disconnect budget across many full outages...
+    for (let i = 0; i < MAX_REPORTED_RELAY_LIFECYCLE + 5; i++) {
+      relayerHandlers[RELAYER_EVENTS.disconnect]?.()
+      relayerHandlers[RELAYER_EVENTS.connect]?.()
+    }
+    expect(drops).toBe(MAX_REPORTED_RELAY_LIFECYCLE)
+    // ...the reconnect budget is its own, so recoveries kept surfacing throughout.
+    expect(recoveries).toBe(MAX_REPORTED_RELAY_LIFECYCLE)
+  })
+})
+
 describe('WalletConnectClient init-error surfacing', () => {
   it('forwards a failed SignClient.init to onInitError and rethrows unchanged', async () => {
     const initErr = new Error('IndexedDB unavailable at init')
     initMock.mockRejectedValueOnce(initErr)
     const errors: unknown[] = []
-    const client = new WalletConnectClient(CONFIG, undefined, e =>
-      errors.push(e)
-    )
+    const client = new WalletConnectClient(CONFIG, {
+      onInitError: e => errors.push(e)
+    })
 
     await expect(client.getClient()).rejects.toBe(initErr)
     expect(errors).toEqual([initErr])
@@ -141,8 +274,10 @@ describe('WalletConnectClient init-error surfacing', () => {
   it('rethrows the init rejection even when the onInitError sink throws', async () => {
     const initErr = new Error('init boom')
     initMock.mockRejectedValueOnce(initErr)
-    const client = new WalletConnectClient(CONFIG, undefined, () => {
-      throw new Error('sink exploded')
+    const client = new WalletConnectClient(CONFIG, {
+      onInitError: () => {
+        throw new Error('sink exploded')
+      }
     })
 
     await expect(client.getClient()).rejects.toBe(initErr)
@@ -156,3 +291,126 @@ describe('WalletConnectClient init-error surfacing', () => {
     await expect(client.getClient()).rejects.toBe(initErr)
   })
 })
+
+describe('toTelemetryObserver (positional back-compat normalizer)', () => {
+  it('maps a legacy (onRelayError, onInitError) function pair to the observer shape', () => {
+    const onRelayError = () => {}
+    const onInitError = () => {}
+    expect(toTelemetryObserver(onRelayError, onInitError)).toEqual({
+      onRelayError,
+      onInitError
+    })
+  })
+
+  it('maps a lone legacy onRelayError with no init sink (onInitError key omitted)', () => {
+    const onRelayError = () => {}
+    expect(toTelemetryObserver(onRelayError)).toEqual({ onRelayError })
+    expect('onInitError' in toTelemetryObserver(onRelayError)).toBe(false)
+  })
+
+  it('keeps a legacy init-only call — (undefined, onInitError) — without dropping the sink', () => {
+    // 0.8.x callers could skip onRelayError: `new WalletConnectClient(config, undefined, onInitError)`.
+    const onInitError = () => {}
+    expect(toTelemetryObserver(undefined, onInitError)).toEqual({ onInitError })
+    expect('onRelayError' in toTelemetryObserver(undefined, onInitError)).toBe(
+      false
+    )
+  })
+
+  it('passes a new-form observer object through untouched', () => {
+    const observer = { onRelayDisconnect: () => {}, onRelayReconnect: () => {} }
+    expect(toTelemetryObserver(observer)).toBe(observer)
+  })
+
+  it('returns an empty observer for an omitted argument', () => {
+    expect(toTelemetryObserver(undefined)).toEqual({})
+  })
+})
+
+describe('WalletConnectClient legacy positional constructor (0.8.x back-compat)', () => {
+  beforeEach(() => {
+    for (const key of Object.keys(relayerHandlers)) delete relayerHandlers[key]
+  })
+
+  it('forwards a relayer error when onRelayError is passed positionally', async () => {
+    const errors: unknown[] = []
+    // Legacy 0.8.x call site: (config, onRelayError) — a bare function, not an observer.
+    const client = new WalletConnectClient(CONFIG, e => errors.push(e))
+    await client.getClient()
+
+    relayerHandlers[RELAYER_EVENTS.error]?.(new Error('code: 3000'))
+    expect(errors).toHaveLength(1)
+    expect((errors[0] as Error).message).toContain('3000')
+  })
+
+  it('forwards a failed init when onInitError is passed as the 3rd positional arg', async () => {
+    const initErr = new Error('IndexedDB unavailable at init')
+    initMock.mockRejectedValueOnce(initErr)
+    const errors: unknown[] = []
+    // Legacy 0.8.x call site: (config, onRelayError, onInitError).
+    const client = new WalletConnectClient(
+      CONFIG,
+      () => {},
+      e => errors.push(e)
+    )
+
+    await expect(client.getClient()).rejects.toBe(initErr)
+    expect(errors).toEqual([initErr])
+  })
+
+  it('does NOT attach lifecycle listeners for the legacy form (it predates them)', async () => {
+    // The legacy signature never carried onRelayDisconnect/onRelayReconnect, so
+    // the lifecycle listeners must stay unattached — no phantom drop/reconnect.
+    const client = new WalletConnectClient(CONFIG, () => {})
+    await client.getClient()
+
+    expect(relayerHandlers[RELAYER_EVENTS.error]).toBeDefined()
+    expect(relayerHandlers[RELAYER_EVENTS.disconnect]).toBeUndefined()
+    expect(relayerHandlers[RELAYER_EVENTS.connect]).toBeUndefined()
+  })
+})
+
+describe('WalletConnectTelemetryObserver wiring (single options object)', () => {
+  beforeEach(() => {
+    for (const key of Object.keys(relayerHandlers)) delete relayerHandlers[key]
+  })
+
+  it('routes each relayer signal to its own sink with no cross-wiring', async () => {
+    // One observer wiring all three relayer sinks — each must fire only for its
+    // own event. Regression guard against the object mis-mapping a field.
+    const seen: string[] = []
+    const client = new WalletConnectClient(CONFIG, {
+      onRelayError: () => seen.push('error'),
+      onRelayDisconnect: () => seen.push('disconnect'),
+      onRelayReconnect: () => seen.push('reconnect')
+    })
+    await client.getClient()
+
+    relayerHandlers[RELAYER_EVENTS.error]?.(new Error('boom'))
+    relayerHandlers[RELAYER_EVENTS.disconnect]?.()
+    relayerHandlers[RELAYER_EVENTS.connect]?.() // recovery after the drop above
+
+    expect(seen).toEqual(['error', 'disconnect', 'reconnect'])
+  })
+
+  it('attaches only the listeners for the sinks that are provided', async () => {
+    // Error sink only → the error listener attaches, lifecycle listeners do not.
+    const client = new WalletConnectClient(CONFIG, {
+      onRelayError: () => {}
+    })
+    await client.getClient()
+
+    expect(relayerHandlers[RELAYER_EVENTS.error]).toBeDefined()
+    expect(relayerHandlers[RELAYER_EVENTS.disconnect]).toBeUndefined()
+    expect(relayerHandlers[RELAYER_EVENTS.connect]).toBeUndefined()
+  })
+
+  it('attaches nothing for an empty observer (default) — behaviour unchanged', async () => {
+    const client = new WalletConnectClient(CONFIG, {})
+    await client.getClient()
+
+    expect(relayerHandlers[RELAYER_EVENTS.error]).toBeUndefined()
+    expect(relayerHandlers[RELAYER_EVENTS.disconnect]).toBeUndefined()
+    expect(relayerHandlers[RELAYER_EVENTS.connect]).toBeUndefined()
+  })
+})

package/src/services/walletconnect-client.ts

@@ -10,6 +10,89 @@ import type { WalletConnectConfig } from '@meshconnect/uwc-types'
  */
 export const MAX_REPORTED_RELAY_ERRORS = 100
 
+/**
+ * Cap on relay transport-lifecycle emissions PER EVENT TYPE (disconnect and
+ * reconnect budgeted independently) per client. A flapping socket IS the signal
+ * we want, but bounding emissions keeps a pathological relay from flooding
+ * telemetry on a long-lived session. Independent budgets so a drop-heavy flap
+ * that exhausts the disconnect cap can never silently swallow the paired
+ * reconnect — otherwise telemetry would show drops with no recovery for a socket
+ * that did recover.
+ */
+export const MAX_REPORTED_RELAY_LIFECYCLE = 50
+
+/**
+ * Optional telemetry sinks for the WalletConnect client. Covers both the relay
+ * transport (error / disconnect / reconnect) AND `SignClient.init` failures.
+ * Every field is opt-in — an empty observer leaves behaviour unchanged. All
+ * sinks are telemetry-only: they never alter connection behaviour, and a
+ * throwing sink is swallowed so it can't break the SDK's relayer dispatch (or,
+ * for `onInitError`, mask the always-rethrown init rejection).
+ */
+export interface WalletConnectTelemetryObserver {
+  /**
+   * Relay-socket failure: the relayer re-emits an abnormal WebSocket close under
+   * `RELAYER_EVENTS.error` (e.g. code 3000 "JWT Token is not yet valid" on clock
+   * skew), detached from the connect() promise. Deduped per message.
+   */
+  onRelayError?: (error: unknown) => void
+  /**
+   * `SignClient.init` failure (storage/crypto, NOT relay). Telemetry-only — the
+   * init rejection is always rethrown so `getClient()` callers see it unchanged.
+   */
+  onInitError?: (error: unknown) => void
+  /**
+   * Relay transport socket dropped (relayer `disconnect`), emitted once per
+   * outage. The lifecycle FACT — distinct from `onRelayError` (a close WITH an
+   * error). This is the CARE-263 signal a suspended WebView produces silently.
+   */
+  onRelayDisconnect?: () => void
+  /**
+   * Relay socket recovered (relayer `connect` after a drop). Pair with
+   * `onRelayDisconnect` to measure the dead window.
+   */
+  onRelayReconnect?: () => void
+}
+
+/**
+ * Normalize the telemetry constructor slots into a `WalletConnectTelemetryObserver`.
+ *
+ * BACKWARD COMPATIBILITY: the published 0.8.x signature was positional —
+ * `(…, onRelayError?, onInitError?)`. This PR moved to a single observer object;
+ * the positional form is retained so external JS/TS consumers on 0.8.x don't
+ * break at runtime. Disambiguate on the first telemetry slot: a FUNCTION is the
+ * legacy `onRelayError` (the new form always passes an object). The legacy form
+ * predates `onRelayDisconnect`/`onRelayReconnect`, so those are simply absent.
+ */
+export function toTelemetryObserver(
+  observerOrOnRelayError?:
+    | WalletConnectTelemetryObserver
+    | ((error: unknown) => void),
+  onInitError?: (error: unknown) => void
+): WalletConnectTelemetryObserver {
+  const onRelayError =
+    typeof observerOrOnRelayError === 'function'
+      ? observerOrOnRelayError
+      : undefined
+
+  // Legacy positional form when EITHER positional callback is present — this
+  // includes the `(undefined, onInitError)` "init-only" call pattern, so that
+  // sink is never silently dropped. Keys are added conditionally because
+  // `exactOptionalPropertyTypes` forbids an explicit `undefined` on an optional.
+  if (onRelayError || onInitError) {
+    return {
+      ...(onRelayError ? { onRelayError } : {}),
+      ...(onInitError ? { onInitError } : {})
+    }
+  }
+
+  // New form: an observer object (or nothing).
+  return typeof observerOrOnRelayError === 'object' &&
+    observerOrOnRelayError !== null
+    ? observerOrOnRelayError
+    : {}
+}
+
 /**
  * Service for managing WalletConnect client instance
  */
@@ -20,19 +103,46 @@ export class WalletConnectClient {
   private readonly relayErrorDedup = createBoundedDedup(
     MAX_REPORTED_RELAY_ERRORS
   )
+  /** Independent bounded counters so drop/recover telemetry can never starve each other. */
+  private relayDisconnectCount = 0
+  private relayReconnectCount = 0
+  /** True once the socket has dropped — gates `relayReconnected` to real recoveries. */
+  private relayHasDisconnected = false
+  private readonly config: WalletConnectConfig
+  private readonly telemetryObserver: WalletConnectTelemetryObserver
 
   /**
-   * @param onRelayError - optional telemetry sink for relay-socket failures (see
-   *   `attachRelayErrorListener`). Opt-in: with nothing wired, behaviour is unchanged.
-   * @param onInitError - optional telemetry sink for a failed `SignClient.init`.
-   *   Opt-in: with nothing wired, behaviour is unchanged. Telemetry-only — the init
-   *   rejection is always rethrown so `getClient()` callers see it exactly as before.
+   * @param telemetryObserver - optional telemetry sinks (see
+   *   `WalletConnectTelemetryObserver`). Every field is opt-in; an empty/omitted
+   *   observer leaves behaviour unchanged.
+   */
+  constructor(
+    config: WalletConnectConfig,
+    telemetryObserver?: WalletConnectTelemetryObserver
+  )
+  /**
+   * @deprecated Pass a {@link WalletConnectTelemetryObserver}. The positional
+   * `(onRelayError, onInitError)` form is retained for backward compatibility
+   * with the published 0.8.x signature and will be removed in a future major.
    */
   constructor(
-    private config: WalletConnectConfig,
-    private onRelayError?: (error: unknown) => void,
-    private onInitError?: (error: unknown) => void
-  ) {}
+    config: WalletConnectConfig,
+    onRelayError?: (error: unknown) => void,
+    onInitError?: (error: unknown) => void
+  )
+  constructor(
+    config: WalletConnectConfig,
+    observerOrOnRelayError?:
+      | WalletConnectTelemetryObserver
+      | ((error: unknown) => void),
+    onInitError?: (error: unknown) => void
+  ) {
+    this.config = config
+    this.telemetryObserver = toTelemetryObserver(
+      observerOrOnRelayError,
+      onInitError
+    )
+  }
 
   /**
    * Initialize or get the WalletConnect client
@@ -95,7 +205,7 @@ export class WalletConnectClient {
       // instead of a generic connect failure. The sink is guarded so a throwing observer
       // can't mask the real rejection, which is always rethrown.
       try {
-        this.onInitError?.(error)
+        this.telemetryObserver.onInitError?.(error)
       } catch {
         // Telemetry must never replace the init rejection.
       }
@@ -103,6 +213,7 @@ export class WalletConnectClient {
     }
 
     this.attachRelayErrorListener(client)
+    this.attachRelayLifecycleListeners(client)
 
     return client
   }
@@ -113,12 +224,13 @@ export class WalletConnectClient {
    * "JWT Token is not yet valid" when the device clock is skewed past the relay's
    * 120s leeway. That error is otherwise detached from the connect() promise, so it
    * escapes the connect handoff and lands as an unhandled error. Forward it (deduped
-   * per message) so it becomes a classified signal instead. `error` only —
-   * `connection_stalled` / `transport_closed` fire on transient blips and would add
-   * noise. Telemetry-only; it never changes connection behaviour.
+   * per message) so it becomes a classified signal instead. This listener handles the
+   * relayer ERROR stream only; the socket's clean up/down lifecycle is captured
+   * separately by `attachRelayLifecycleListeners` (CARE-263 — a suspended WebView
+   * drops the socket without emitting an `error`). Telemetry-only; never changes behaviour.
    */
   private attachRelayErrorListener(client: SignClient): void {
-    if (!this.onRelayError) return
+    if (!this.telemetryObserver.onRelayError) return
     client.core?.relayer?.on(RELAYER_EVENTS.error, (error: unknown) => {
       // safeErrorMessage: this runs INSIDE the SDK's relayer dispatch, before
       // the sink guard below — a throwing toString() here would break the
@@ -126,7 +238,7 @@ export class WalletConnectClient {
       const message = safeErrorMessage(error)
       if (!this.relayErrorDedup.firstSeen(message)) return
       try {
-        this.onRelayError?.(error)
+        this.telemetryObserver.onRelayError?.(error)
       } catch {
         // A throwing sink would propagate synchronously out of the WC SDK's
         // relayer emitter and prevent its own error handling (transportClose)
@@ -135,6 +247,65 @@ export class WalletConnectClient {
     })
   }
 
+  /**
+   * Surface the relay transport socket's up/down lifecycle as telemetry. This is
+   * the signal `attachRelayErrorListener` misses: when iOS suspends the WebView
+   * during a wallet deep-link the socket drops with no `error` event, WC core only
+   * reconnects on its slow internal heartbeat, and any in-flight sign/connect
+   * response strands in the meantime (CARE-263). Emitting `disconnect` + the
+   * subsequent `connect` lets us see the drop and measure the dead window.
+   *
+   * Emitted at most once per outage: WC core re-emits `disconnect` on every failed
+   * reconnect attempt, so a transition flag gates the emit to keep drop/recover 1:1
+   * (and bounds emissions); a counter cap backstops many distinct outages. Both
+   * sinks are guarded so a throwing observer can never break the SDK's relayer
+   * dispatch. Telemetry-only; it never changes connection behaviour.
+   */
+  private attachRelayLifecycleListeners(client: SignClient): void {
+    if (
+      !this.telemetryObserver.onRelayDisconnect &&
+      !this.telemetryObserver.onRelayReconnect
+    )
+      return
+    const relayer = client.core?.relayer
+    if (!relayer) return
+
+    // Guarded + capped emit with an INDEPENDENT budget per event type. Cap is only
+    // consumed when a sink is wired; the guard keeps a throwing observer from
+    // breaking the relayer's own dispatch. Separate budgets ensure a drop-heavy
+    // flap can never exhaust the shared pool and silently drop the paired recovery.
+    const report = (
+      sink: (() => void) | undefined,
+      counter: 'relayDisconnectCount' | 'relayReconnectCount'
+    ): void => {
+      if (!sink) return
+      if (this[counter] >= MAX_REPORTED_RELAY_LIFECYCLE) return
+      this[counter]++
+      try {
+        sink()
+      } catch {
+        // Telemetry must never break the relayer's lifecycle handling.
+      }
+    }
+
+    relayer.on(RELAYER_EVENTS.disconnect, () => {
+      // WC core re-emits `disconnect` on each failed reconnect during one outage —
+      // emit only on the transition INTO disconnected so drop/recover stay 1:1 (and
+      // relayDropCount counts outages, not re-emits). The relayer passes no payload
+      // (socket errors arrive via RELAYER_EVENTS.error / onRelayError).
+      if (this.relayHasDisconnected) return
+      this.relayHasDisconnected = true
+      report(this.telemetryObserver.onRelayDisconnect, 'relayDisconnectCount')
+    })
+    relayer.on(RELAYER_EVENTS.connect, () => {
+      // `connect` also fires on the FIRST socket open — only a connect that follows
+      // a disconnect is a genuine recovery and pairs 1:1 with the dead window.
+      if (!this.relayHasDisconnected) return
+      this.relayHasDisconnected = false
+      report(this.telemetryObserver.onRelayReconnect, 'relayReconnectCount')
+    })
+  }
+
   /**
    * The initialized client if `connect()` already ran, else null. Synchronous —
    * lets callers attach lifecycle listeners post-connect without forcing a

package/src/wallet-connect-connector.test.ts

@@ -199,3 +199,40 @@ describe('WalletConnectConnector.onLifecycleEvent', () => {
     ])
   })
 })
+
+describe('WalletConnectConnector telemetry constructor (0.8.x back-compat)', () => {
+  // Reach into the private client to prove the constructor normalized whatever
+  // form it received into a single telemetryObserver (no relay contact here).
+  const observerOf = (c: WalletConnectConnector) =>
+    (
+      c as unknown as {
+        walletConnectClient: { telemetryObserver: Record<string, unknown> }
+      }
+    ).walletConnectClient.telemetryObserver
+
+  it('forwards the new observer object form', () => {
+    const onRelayDisconnect = () => {}
+    const c = new WalletConnectConnector(
+      { projectId: 'p' } as WalletConnectConfig,
+      {},
+      {
+        onRelayDisconnect
+      }
+    )
+    expect(observerOf(c).onRelayDisconnect).toBe(onRelayDisconnect)
+  })
+
+  it('forwards the legacy positional (onRelayError, onInitError) form', () => {
+    const onRelayError = () => {}
+    const onInitError = () => {}
+    // Legacy 0.8.x call site: (config, networkRpcMap, onRelayError, onInitError).
+    const c = new WalletConnectConnector(
+      { projectId: 'p' } as WalletConnectConfig,
+      {},
+      onRelayError,
+      onInitError
+    )
+    expect(observerOf(c).onRelayError).toBe(onRelayError)
+    expect(observerOf(c).onInitError).toBe(onInitError)
+  })
+})

package/src/wallet-connect-connector.ts

@@ -14,7 +14,11 @@ import type {
   WalletLifecycleEvent,
   WalletLifecycleContext
 } from '@meshconnect/uwc-types'
-import { WalletConnectClient } from './services/walletconnect-client'
+import {
+  WalletConnectClient,
+  toTelemetryObserver,
+  type WalletConnectTelemetryObserver
+} from './services/walletconnect-client'
 import { ConnectionService } from './services/connection-service'
 import { NetworkSwitchService } from './services/network-switch-service'
 import { SignatureService } from './services/signature-service'
@@ -125,14 +129,31 @@ export class WalletConnectConnector implements Connector {
 
   constructor(
     config: WalletConnectConfig,
-    networkRpcMap: NetworkRpcMap = {},
+    networkRpcMap?: NetworkRpcMap,
+    telemetryObserver?: WalletConnectTelemetryObserver
+  )
+  /**
+   * @deprecated Pass a {@link WalletConnectTelemetryObserver}. The positional
+   * `(onRelayError, onInitError)` form is retained for backward compatibility
+   * with the published 0.8.x signature and will be removed in a future major.
+   */
+  constructor(
+    config: WalletConnectConfig,
+    networkRpcMap?: NetworkRpcMap,
     onRelayError?: (error: unknown) => void,
     onInitError?: (error: unknown) => void
+  )
+  constructor(
+    config: WalletConnectConfig,
+    networkRpcMap: NetworkRpcMap = {},
+    observerOrOnRelayError?:
+      | WalletConnectTelemetryObserver
+      | ((error: unknown) => void),
+    onInitError?: (error: unknown) => void
   ) {
     this.walletConnectClient = new WalletConnectClient(
       config,
-      onRelayError,
-      onInitError
+      toTelemetryObserver(observerOrOnRelayError, onInitError)
     )
     this.networkRpcMap = networkRpcMap
     this.connectionService = new ConnectionService(this.walletConnectClient)