@meshconnect/uwc-types 0.20.0-snapshot.aac13dd → 0.20.0-snapshot.b4e39d1

package/dist/observability.d.ts

@@ -17,9 +17,16 @@ export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
  * drive a reuse-outcome dashboard without high cardinality. Emitted via
  * `WalletConnectConfig.onSessionReuseSkipped`.
  *
+ * - `unscoped`    — reuse is on but no `sessionReuseScopeId` was supplied (e.g. the
+ *                   link token carries no end-user id), so reuse is disabled by
+ *                   the user-binding rule. Split from `no_record` so the funnel
+ *                   separates "first connect" from "this consumer/user can never
+ *                   reuse" — the latter sizes the traffic where the integration
+ *                   (not the user) blocks adoption.
  * - `no_record`   — no topic recorded for the selected wallet (e.g. first connect),
  *                   or the recorded session is no longer in storage.
- * - `expired`     — the recorded session exists but is past its expiry.
+ * - `expired`     — the recorded session exists but is past its expiry, or expires
+ *                   too soon to survive the signing flow (min-remaining-TTL guard).
  * - `no_address`  — the session carries no account for the requested network.
  * - `ping_timeout`— the liveness ping got NO ack within the bounded window (peer
  *                   slow/suspended or the relay socket is dead — CARE-263). Split
@@ -30,7 +37,7 @@ export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
  *                   unknown liveness state rather than a confirmed no-ack.
  * - `superseded`  — a disconnect()/newer connect() invalidated the attempt mid-ping.
  */
-export type WalletConnectSessionReuseSkipReason = 'no_record' | 'expired' | 'no_address' | 'ping_timeout' | 'ping_error' | 'superseded';
+export type WalletConnectSessionReuseSkipReason = 'unscoped' | 'no_record' | 'expired' | 'no_address' | 'ping_timeout' | 'ping_error' | 'superseded';
 /**
  * Payload for `WalletConnectConfig.onSessionReuseSkipped`. Carries the coarse
  * reason plus, for the two ping outcomes, the ping round-trip in ms — so a
@@ -43,6 +50,28 @@ export interface WalletConnectSessionReuseSkip {
     /** Ping round-trip in ms; present only for `ping_timeout` / `ping_error`. */
     pingMs?: number;
 }
+/**
+ * Payload for `WalletConnectConfig.onSessionRestored` — context about the
+ * adopted session, for triaging reused-session failures per wallet (e.g. "does
+ * wallet X only fail when the session is close to expiry / was adopted stale?").
+ * Telemetry-only; adoption itself is decided before this fires.
+ */
+export interface WalletConnectSessionRestored {
+    /**
+     * Seconds until the adopted session's WC expiry. WC v2 extends expiry on
+     * activity, so LOW values mean the session sat unused — the stale-session
+     * facet to correlate with a subsequent sign timeout on the same session.
+     */
+    expiresInSeconds: number;
+    /**
+     * The peer's self-reported wallet name (`session.peer.metadata.name`).
+     * UNAUTHENTICATED — never a trust input (adoption is keyed by the app-recorded
+     * topic, see the connector's reuse trust anchor); carried only so telemetry can
+     * facet reused-session outcomes by what the wallet claims to be, e.g. to isolate
+     * a wallet-specific reuse quirk (Rainbow, CARE-263).
+     */
+    peerName?: string;
+}
 /**
  * Pluggable logger. The default implementation (`createLogger`) is console-backed
  * and level-gated; inject your own to redirect UWC's internal logging into your

package/dist/observability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../src/observability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAE1D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,mCAAmC,GAC3C,WAAW,GACX,SAAS,GACT,YAAY,GACZ,cAAc,GACd,YAAY,GACZ,YAAY,CAAA;AAEhB;;;;;;GAMG;AACH,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,mCAAmC,CAAA;IAC3C,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CACjD;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,cAAc,GACtB,wBAAwB,GACxB,+BAA+B,GAC/B,wBAAwB,GACxB,qBAAqB,GACrB,cAAc,GACd,qBAAqB,GACrB,4BAA4B,GAC5B,wBAAwB,GACxB,SAAS,CAAA;AAEb;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;AAEnE;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GACnB,eAAe,GACf,gBAAgB,GAChB,cAAc,GACd,eAAe;AACjB,iFAAiF;GAC/E,mBAAmB,GACnB,oBAAoB,GACpB,gBAAgB,GAChB,SAAS;AACX,gFAAgF;GAC9E,oBAAoB,GACpB,SAAS,CAAA;AAEb;;;;GAIG;AACH,MAAM,MAAM,WAAW,GACnB,UAAU,GACV,WAAW,GACX,QAAQ,GACR,KAAK,GACL,SAAS,CAAA;AAEb;;;;GAIG;AACH,MAAM,MAAM,0BAA0B;AACpC,gGAAgG;AAC9F,mCAAmC;AACrC,uFAAuF;GACrF,iCAAiC;AACnC,oEAAoE;GAClE,uBAAuB;AACzB;;;;GAIG;GACD,mBAAmB;AACrB;;;GAGG;GACD,cAAc,CAAA"}
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../src/observability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,MAAM,mCAAmC,GAC3C,UAAU,GACV,WAAW,GACX,SAAS,GACT,YAAY,GACZ,cAAc,GACd,YAAY,GACZ,YAAY,CAAA;AAEhB;;;;;;GAMG;AACH,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,mCAAmC,CAAA;IAC3C,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,CAAA;IACxB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CACjD;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,cAAc,GACtB,wBAAwB,GACxB,+BAA+B,GAC/B,wBAAwB,GACxB,qBAAqB,GACrB,cAAc,GACd,qBAAqB,GACrB,4BAA4B,GAC5B,wBAAwB,GACxB,SAAS,CAAA;AAEb;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;AAEnE;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GACnB,eAAe,GACf,gBAAgB,GAChB,cAAc,GACd,eAAe;AACjB,iFAAiF;GAC/E,mBAAmB,GACnB,oBAAoB,GACpB,gBAAgB,GAChB,SAAS;AACX,gFAAgF;GAC9E,oBAAoB,GACpB,SAAS,CAAA;AAEb;;;;GAIG;AACH,MAAM,MAAM,WAAW,GACnB,UAAU,GACV,WAAW,GACX,QAAQ,GACR,KAAK,GACL,SAAS,CAAA;AAEb;;;;GAIG;AACH,MAAM,MAAM,0BAA0B;AACpC,gGAAgG;AAC9F,mCAAmC;AACrC,uFAAuF;GACrF,iCAAiC;AACnC,oEAAoE;GAClE,uBAAuB;AACzB;;;;GAIG;GACD,mBAAmB;AACrB;;;GAGG;GACD,cAAc,CAAA"}

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

@@ -1,4 +1,4 @@
-import type { WalletConnectSessionReuseSkip } from './observability';
+import type { WalletConnectSessionRestored, WalletConnectSessionReuseSkip } from './observability';
 /**
  * Configuration for WalletConnect connector
  */
@@ -29,12 +29,13 @@ export interface WalletConnectConfig {
     enableSessionReuse?: boolean;
     /**
      * Fired once when connect() resolves from a reused stored session instead of a
-     * fresh pairing handshake. Intended for a single telemetry tag (e.g.
-     * restored: true). Optional — omitting it keeps reuse working, only the signal
-     * is dropped. No-op unless enableSessionReuse is on. Mirrors
-     * TonConnectConfig.onSessionRestored.
+     * fresh pairing handshake, with context about the adopted session — time to WC
+     * expiry and the peer's (unauthenticated) self-reported name — so reused-session
+     * failures can be triaged per wallet and correlated with session staleness.
+     * Optional — omitting it keeps reuse working, only the signal is dropped.
+     * No-op unless enableSessionReuse is on. Mirrors TonConnectConfig.onSessionRestored.
      */
-    onSessionRestored?: () => void;
+    onSessionRestored?: (restored: WalletConnectSessionRestored) => void;
     /**
      * Fired when reuse was attempted (enableSessionReuse on + wallet known) but fell
      * back to a fresh pairing. Carries the coarse `reason` plus, for the ping
@@ -50,8 +51,10 @@ export interface WalletConnectConfig {
      * bound to the authenticated Link user — otherwise a later user on the same
      * device could silently adopt an earlier user's live session without a fresh
      * approval. Pass a stable per-user id (the Link user id). Reuse is DISABLED when
-     * this is empty/absent, regardless of `enableSessionReuse` — origin persistence
-     * alone is never sufficient. No-op unless enableSessionReuse is on.
+     * this is empty/absent, regardless of `enableSessionReuse` (skips report as
+     * `unscoped`) — origin persistence alone is never sufficient. The id is hashed
+     * before it is persisted, so a PII-bearing id (merchants sometimes use emails as
+     * user ids) never lands in storage verbatim. No-op unless enableSessionReuse is on.
      */
     sessionReuseScopeId?: 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,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAA;AAEpE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,EAAE,MAAM,CAAA;QACnB,GAAG,EAAE,MAAM,CAAA;QACX,KAAK,EAAE,MAAM,EAAE,CAAA;KAChB,CAAA;IACD;;;;;;;;;;;;;;;OAeG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAA;IAC9B;;;;;;;OAOG;IACH,qBAAqB,CAAC,EAAE,CAAC,IAAI,EAAE,6BAA6B,KAAK,IAAI,CAAA;IACrE;;;;;;;;OAQG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B;;;;;;;;;;;OAWG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAA;CACnC"}
+{"version":3,"file":"wallet-connect-connector.d.ts","sourceRoot":"","sources":["../src/wallet-connect-connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAC5B,6BAA6B,EAC9B,MAAM,iBAAiB,CAAA;AAExB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,EAAE,MAAM,CAAA;QACnB,GAAG,EAAE,MAAM,CAAA;QACX,KAAK,EAAE,MAAM,EAAE,CAAA;KAChB,CAAA;IACD;;;;;;;;;;;;;;;OAeG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,4BAA4B,KAAK,IAAI,CAAA;IACpE;;;;;;;OAOG;IACH,qBAAqB,CAAC,EAAE,CAAC,IAAI,EAAE,6BAA6B,KAAK,IAAI,CAAA;IACrE;;;;;;;;;;OAUG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B;;;;;;;;;;;OAWG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAA;CACnC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meshconnect/uwc-types",
-  "version": "0.20.0-snapshot.aac13dd",
+  "version": "0.20.0-snapshot.b4e39d1",
   "description": "TypeScript types for Universal Wallet Connector",
   "type": "module",
   "main": "dist/index.js",

package/src/observability.ts

@@ -19,9 +19,16 @@ export type LogLevel = 'debug' | 'info' | 'warn' | 'error'
  * drive a reuse-outcome dashboard without high cardinality. Emitted via
  * `WalletConnectConfig.onSessionReuseSkipped`.
  *
+ * - `unscoped`    — reuse is on but no `sessionReuseScopeId` was supplied (e.g. the
+ *                   link token carries no end-user id), so reuse is disabled by
+ *                   the user-binding rule. Split from `no_record` so the funnel
+ *                   separates "first connect" from "this consumer/user can never
+ *                   reuse" — the latter sizes the traffic where the integration
+ *                   (not the user) blocks adoption.
  * - `no_record`   — no topic recorded for the selected wallet (e.g. first connect),
  *                   or the recorded session is no longer in storage.
- * - `expired`     — the recorded session exists but is past its expiry.
+ * - `expired`     — the recorded session exists but is past its expiry, or expires
+ *                   too soon to survive the signing flow (min-remaining-TTL guard).
  * - `no_address`  — the session carries no account for the requested network.
  * - `ping_timeout`— the liveness ping got NO ack within the bounded window (peer
  *                   slow/suspended or the relay socket is dead — CARE-263). Split
@@ -33,6 +40,7 @@ export type LogLevel = 'debug' | 'info' | 'warn' | 'error'
  * - `superseded`  — a disconnect()/newer connect() invalidated the attempt mid-ping.
  */
 export type WalletConnectSessionReuseSkipReason =
+  | 'unscoped'
   | 'no_record'
   | 'expired'
   | 'no_address'
@@ -53,6 +61,29 @@ export interface WalletConnectSessionReuseSkip {
   pingMs?: number
 }
 
+/**
+ * Payload for `WalletConnectConfig.onSessionRestored` — context about the
+ * adopted session, for triaging reused-session failures per wallet (e.g. "does
+ * wallet X only fail when the session is close to expiry / was adopted stale?").
+ * Telemetry-only; adoption itself is decided before this fires.
+ */
+export interface WalletConnectSessionRestored {
+  /**
+   * Seconds until the adopted session's WC expiry. WC v2 extends expiry on
+   * activity, so LOW values mean the session sat unused — the stale-session
+   * facet to correlate with a subsequent sign timeout on the same session.
+   */
+  expiresInSeconds: number
+  /**
+   * The peer's self-reported wallet name (`session.peer.metadata.name`).
+   * UNAUTHENTICATED — never a trust input (adoption is keyed by the app-recorded
+   * topic, see the connector's reuse trust anchor); carried only so telemetry can
+   * facet reused-session outcomes by what the wallet claims to be, e.g. to isolate
+   * a wallet-specific reuse quirk (Rainbow, CARE-263).
+   */
+  peerName?: string
+}
+
 /**
  * Pluggable logger. The default implementation (`createLogger`) is console-backed
  * and level-gated; inject your own to redirect UWC's internal logging into your

package/src/wallet-connect-connector.ts

@@ -1,4 +1,7 @@
-import type { WalletConnectSessionReuseSkip } from './observability'
+import type {
+  WalletConnectSessionRestored,
+  WalletConnectSessionReuseSkip
+} from './observability'
 
 /**
  * Configuration for WalletConnect connector
@@ -30,12 +33,13 @@ export interface WalletConnectConfig {
   enableSessionReuse?: boolean
   /**
    * Fired once when connect() resolves from a reused stored session instead of a
-   * fresh pairing handshake. Intended for a single telemetry tag (e.g.
-   * restored: true). Optional — omitting it keeps reuse working, only the signal
-   * is dropped. No-op unless enableSessionReuse is on. Mirrors
-   * TonConnectConfig.onSessionRestored.
+   * fresh pairing handshake, with context about the adopted session — time to WC
+   * expiry and the peer's (unauthenticated) self-reported name — so reused-session
+   * failures can be triaged per wallet and correlated with session staleness.
+   * Optional — omitting it keeps reuse working, only the signal is dropped.
+   * No-op unless enableSessionReuse is on. Mirrors TonConnectConfig.onSessionRestored.
    */
-  onSessionRestored?: () => void
+  onSessionRestored?: (restored: WalletConnectSessionRestored) => void
   /**
    * Fired when reuse was attempted (enableSessionReuse on + wallet known) but fell
    * back to a fresh pairing. Carries the coarse `reason` plus, for the ping
@@ -51,8 +55,10 @@ export interface WalletConnectConfig {
    * bound to the authenticated Link user — otherwise a later user on the same
    * device could silently adopt an earlier user's live session without a fresh
    * approval. Pass a stable per-user id (the Link user id). Reuse is DISABLED when
-   * this is empty/absent, regardless of `enableSessionReuse` — origin persistence
-   * alone is never sufficient. No-op unless enableSessionReuse is on.
+   * this is empty/absent, regardless of `enableSessionReuse` (skips report as
+   * `unscoped`) — origin persistence alone is never sufficient. The id is hashed
+   * before it is persisted, so a PII-bearing id (merchants sometimes use emails as
+   * user ids) never lands in storage verbatim. No-op unless enableSessionReuse is on.
    */
   sessionReuseScopeId?: string
   /**