@meshconnect/uwc-core 1.2.2 → 1.2.3-snapshot.bd9aae7

package/src/observability/telemetry.ts

@@ -154,6 +154,14 @@ export interface UWCTelemetryEvent {
    * handoffCovered to avoid double-counting.
    */
   handoffCovered?: boolean | undefined
+  /** `pageVisibleDuringHandoff` only: how long the page was hidden for that segment (ms). */
+  hiddenMs?: number | undefined
+  /** Handoff terminals: cumulative time the page was backgrounded during the handoff (ms). */
+  backgroundedMs?: number | undefined
+  /** Handoff terminals: how many times the page was backgrounded during the handoff. */
+  backgroundCount?: number | undefined
+  /** Handoff terminals, WalletConnect only: relay-socket drops seen while the handoff was pending. */
+  relayDropCount?: number | undefined
 }
 
 /**
@@ -362,7 +370,10 @@ function buildTelemetryEvent<K extends UWCEventName>(
         durationMs: d.durationMs,
         timedOut: d.timedOut,
         timeoutMs: d.timeoutMs,
-        targetAlreadyActive: d.targetAlreadyActive
+        targetAlreadyActive: d.targetAlreadyActive,
+        backgroundedMs: d.backgroundedMs,
+        backgroundCount: d.backgroundCount,
+        relayDropCount: d.relayDropCount
       }
     }
     case 'walletRejected': {
@@ -381,7 +392,10 @@ function buildTelemetryEvent<K extends UWCEventName>(
         targetAlreadyActive: d.targetAlreadyActive,
         errorCode: d.errorCode,
         failureKind: d.failureKind,
-        source: d.source
+        source: d.source,
+        backgroundedMs: d.backgroundedMs,
+        backgroundCount: d.backgroundCount,
+        relayDropCount: d.relayDropCount
       }
     }
     case 'walletTimedOut': {
@@ -396,7 +410,10 @@ function buildTelemetryEvent<K extends UWCEventName>(
         handoffId: d.handoffId,
         durationMs: d.durationMs,
         timeoutMs: d.timeoutMs,
-        targetAlreadyActive: d.targetAlreadyActive
+        targetAlreadyActive: d.targetAlreadyActive,
+        backgroundedMs: d.backgroundedMs,
+        backgroundCount: d.backgroundCount,
+        relayDropCount: d.relayDropCount
       }
     }
     case 'walletFailed': {
@@ -416,7 +433,10 @@ function buildTelemetryEvent<K extends UWCEventName>(
         errorCode: d.errorCode,
         failureKind: d.failureKind,
         source: d.source,
-        error: { type: d.error.type, message: scrubMessage(d.error.message) }
+        error: { type: d.error.type, message: scrubMessage(d.error.message) },
+        backgroundedMs: d.backgroundedMs,
+        backgroundCount: d.backgroundCount,
+        relayDropCount: d.relayDropCount
       }
     }
     case 'capabilitiesUpdated': {
@@ -448,8 +468,15 @@ function buildTelemetryEvent<K extends UWCEventName>(
     }
     case 'pageHiddenDuringHandoff':
     case 'pageVisibleDuringHandoff': {
-      const d = data as UWCEventMap['pageHiddenDuringHandoff']
-      return { ...base, handoffId: d.handoffId, platform: d.platform }
+      // Cast to the visible shape (superset). `hiddenMs` is absent on the hidden
+      // event → undefined → dropped by compactUndefined.
+      const d = data as UWCEventMap['pageVisibleDuringHandoff']
+      return {
+        ...base,
+        handoffId: d.handoffId,
+        platform: d.platform,
+        hiddenMs: d.hiddenMs
+      }
     }
     case 'bridgeError': {
       const d = data as UWCEventMap['bridgeError']
@@ -473,6 +500,31 @@ function buildTelemetryEvent<K extends UWCEventName>(
         error: { type: d.error.type, message: scrubMessage(d.error.message) }
       }
     }
+    case 'relayDisconnected': {
+      const d = data as UWCEventMap['relayDisconnected']
+      // The relay socket dropped. Observational, NOT a failure: a drop only
+      // matters if a round-trip was in flight — deliberately left without a
+      // `failureKind` so it never inflates failure metrics. Pair with
+      // `relayReconnected` (same sdkSessionId) for the dead-window duration.
+      return {
+        ...base,
+        connectionMode: 'walletConnect',
+        source: 'provider',
+        ...(d.error
+          ? {
+              error: {
+                type: d.error.type,
+                message: scrubMessage(d.error.message)
+              }
+            }
+          : {})
+      }
+    }
+    case 'relayReconnected': {
+      // Socket recovered. Name-only + mode; the diagnostic value is the timestamp
+      // relative to the paired `relayDisconnected`.
+      return { ...base, connectionMode: 'walletConnect', source: 'provider' }
+    }
     case 'walletConnectInitError': {
       const d = data as UWCEventMap['walletConnectInitError']
       // SignClient.init failed — the WC client never came up. Distinct from

package/src/universal-wallet-connector.ts

@@ -325,7 +325,17 @@ export class UniversalWalletConnector {
           (error: unknown) =>
             this.eventManager.emit('walletConnectInitError', {
               error: toWalletError(error)
-            })
+            }),
+          // Relay transport dropped — capture the FACT (+ scrubbed reason if any) so a
+          // socket death during a wallet deep-link is visible, not silent (CARE-263).
+          (detail: unknown) =>
+            this.eventManager.emit(
+              'relayDisconnected',
+              detail ? { error: toWalletError(detail) } : {}
+            ),
+          // Relay transport recovered — pair with `relayDisconnected` (same
+          // sdkSessionId) to measure the dead window.
+          () => this.eventManager.emit('relayReconnected', undefined)
         )
       )
     }

package/src/version.ts

@@ -1,2 +1,2 @@
 // Generated from package.json by scripts/generate-version.mjs — do not edit.
-export const UWC_CORE_VERSION = '1.2.2'
+export const UWC_CORE_VERSION = '1.2.3'