@meshconnect/uwc-core 1.0.3 → 1.1.0

package/dist/events.d.ts

@@ -1,8 +1,12 @@
-import type { Session, Network, WalletMetadata, ConnectionMode, WalletError, EVMCapabilities } from '@meshconnect/uwc-types';
+import type { Session, Network, WalletMetadata, ConnectionMode, WalletError, EVMCapabilities, LogLevel, WalletFlowType, Platform, Namespace, NetworkId, FailureKind, ErrorSource, LifecycleUnavailableReason } from '@meshconnect/uwc-types';
 /**
- * User-initiated operations that can surface through the `error` event.
+ * User-initiated operations that can surface through the `error` event. The
+ * runtime tuple is the single source of truth; the type is derived from it so a
+ * guard test can enumerate every op — and catch a new one added without handoff
+ * instrumentation — instead of relying on a hand-maintained list.
  */
-export type UWCOperation = 'connect' | 'disconnect' | 'switchNetwork' | 'signMessage' | 'sendTransaction' | 'getWalletCapabilities' | 'initialize';
+export declare const UWC_OPERATIONS: readonly ["connect", "disconnect", "switchNetwork", "signMessage", "signTypedData", "sendTransaction", "signSolanaTransaction", "getWalletCapabilities", "initialize"];
+export type UWCOperation = (typeof UWC_OPERATIONS)[number];
 /**
  * Typed event map emitted by UniversalWalletConnector.
  *
@@ -15,9 +19,51 @@ export type UWCOperation = 'connect' | 'disconnect' | 'switchNetwork' | 'signMes
 export interface UWCEventMap {
     /** Wallet detection finished; `getWallets()` now reflects which are installed. */
     ready: void;
-    /** Emitted once detection finishes, with the final wallet list. */
+    /**
+     * Emitted once detection finishes, with the final wallet list. `discovery` is a
+     * per-namespace requested-vs-matched summary (telemetry-only, non-PII counts) so
+     * "we asked for N solana wallets, matched 0" is distinguishable from "asked for
+     * none" — answers "why didn't wallet X appear?".
+     */
     walletsDetected: {
         wallets: WalletMetadata[];
+        discovery?: Record<string, {
+            requested: number;
+            matched: number;
+        }> | undefined;
+    };
+    /**
+     * A single namespace × connector discovery task threw. Telemetry-only — replaces
+     * the historical silent catch so a discovery failure is observable rather than
+     * vanishing. Carries the namespace + connection mode + scrubbed error; never an
+     * address or payload.
+     */
+    walletDiscoveryFailed: {
+        namespace: Namespace;
+        connectionMode: ConnectionMode;
+        error: WalletError;
+    };
+    /**
+     * A bridge operation failed — e.g. wallet-discovery marshaling across the iframe
+     * Comlink boundary timed out or threw. Telemetry-only; replaces silent catches in
+     * `BridgeChild` so "the wallet never showed up via the bridge" (the Bitstarz
+     * class) is observable. Carries the namespace + scrubbed error; no address /
+     * payload. Deduped + benign poll-misses excluded at the source.
+     */
+    bridgeError: {
+        namespace?: Namespace | undefined;
+        error: WalletError;
+    };
+    /**
+     * The WalletConnect relay socket surfaced a transport/provider error — e.g. an
+     * abnormal close (code 3000 "JWT Token is not yet valid" when the device clock is
+     * skewed past the relay's 120s leeway). Emitted from the relayer's error event,
+     * deduped at the connector. This failure is detached from the connect() promise,
+     * so without it the error escapes the handoff funnel entirely. Telemetry-only;
+     * carries only a scrubbed message (no address / payload).
+     */
+    relayError: {
+        error: WalletError;
     };
     /** `connect()` has started. */
     connecting: {
@@ -55,10 +101,193 @@ export interface UWCEventMap {
     capabilitiesUpdated: {
         capabilities: Record<string, EVMCapabilities>;
     };
-    /** A user-initiated operation failed. */
+    /**
+     * A user-initiated operation failed. Carries optional, telemetry-only
+     * classification (`errorCode` / `failureKind` / `source`) and, for a
+     * no-common-network connect failure, the two CAIP-2 id lists — so a PRE-wallet
+     * validation failure (which never enters the handoff funnel) is still
+     * diagnosable. The React-facing payload is still `{ error, operation }`; the
+     * rest is `undefined` for ordinary errors.
+     */
     error: {
         error: WalletError;
         operation: UWCOperation;
+        errorCode?: string | undefined;
+        failureKind?: FailureKind | undefined;
+        source?: ErrorSource | undefined;
+        networkMismatch?: {
+            walletNetworkIds: string[];
+            configuredNetworkIds: string[];
+        } | undefined;
+        /**
+         * `true` when a handoff terminal (`walletRejected`/`walletFailed`) already
+         * reported this same failure — this record is the back-compat duplicate.
+         * For failure metrics: count terminals + `error` where NOT handoffCovered;
+         * absent on pre-wallet validation failures (which have no terminal).
+         */
+        handoffCovered?: boolean | undefined;
+    };
+    /**
+     * A line emitted through the internal `Logger`. Fires for ALL levels regardless
+     * of the console threshold so an observer can capture `debug`/`info` even when
+     * the console is quiet. `args` is scrubbed before reaching `observer.onLog`.
+     */
+    log: {
+        level: LogLevel;
+        message: string;
+        args: unknown[];
+    };
+    /**
+     * Emitted immediately BEFORE control is handed to the wallet for a boundary op
+     * (the moment the blind window opens). Pair with exactly one terminal event via
+     * `handoffId`. Carries no signing payload and no address — only routing facets.
+     */
+    awaitingWallet: {
+        operation: UWCOperation;
+        connectionMode: ConnectionMode;
+        walletId?: string | undefined;
+        /** CAIP namespace (eip155 | solana | tron | tvm …) — not an address. */
+        namespace?: Namespace | undefined;
+        /** CAIP chain id (e.g. `eip155:1`) — not an address. */
+        chainId?: NetworkId | undefined;
+        handoffId: string;
+        /** Derived, best-effort flow taxonomy (heuristic — see deriveWalletFlowType). */
+        walletFlowType: WalletFlowType;
+        /** Coarse runtime surface (heuristic — see derivePlatform). */
+        platform: Platform;
+        /** switchNetwork only: target chain already the active one (no-op switch). */
+        targetAlreadyActive?: boolean | undefined;
+    };
+    /** The wallet resolved the op successfully. Closes a handoff. */
+    walletSucceeded: {
+        handoffId: string;
+        operation: UWCOperation;
+        durationMs: number;
+        connectionMode: ConnectionMode;
+        walletId?: string | undefined;
+        namespace?: Namespace | undefined;
+        chainId?: NetworkId | undefined;
+        /** A `walletTimedOut` marker fired before this terminal (late completion). */
+        timedOut: boolean;
+        /** The deadline that elapsed, present only when `timedOut`. */
+        timeoutMs?: number | undefined;
+        /** switchNetwork only: target chain already the active one (no-op switch). */
+        targetAlreadyActive?: boolean | undefined;
+    };
+    /** The user explicitly rejected (4001 / WalletError.type === 'rejected'). Closes a handoff. */
+    walletRejected: {
+        handoffId: string;
+        operation: UWCOperation;
+        durationMs: number;
+        connectionMode: ConnectionMode;
+        walletId?: string | undefined;
+        namespace?: Namespace | undefined;
+        chainId?: NetworkId | undefined;
+        timedOut: boolean;
+        timeoutMs?: number | undefined;
+        targetAlreadyActive?: boolean | undefined;
+        /** Stringified error code (EIP-1193 numeric / string), when present. */
+        errorCode?: string | undefined;
+        failureKind?: FailureKind | undefined;
+        source?: ErrorSource | undefined;
+    };
+    /** The op failed for any non-rejection reason. Closes a handoff. */
+    walletFailed: {
+        handoffId: string;
+        operation: UWCOperation;
+        durationMs: number;
+        error: WalletError;
+        connectionMode: ConnectionMode;
+        walletId?: string | undefined;
+        namespace?: Namespace | undefined;
+        chainId?: NetworkId | undefined;
+        timedOut: boolean;
+        timeoutMs?: number | undefined;
+        targetAlreadyActive?: boolean | undefined;
+        /** Stringified error code (EIP-1193 numeric / string), when present. */
+        errorCode?: string | undefined;
+        failureKind?: FailureKind | undefined;
+        source?: ErrorSource | undefined;
+    };
+    /**
+     * Side marker: the deadline passed with the op still pending. OBSERVATIONAL —
+     * it does NOT reject, abort, or mutate state; the wallet may still complete and
+     * produce the real terminal. Never fires for an op that settled before the
+     * deadline. Not itself a terminal.
+     */
+    walletTimedOut: {
+        handoffId: string;
+        operation: UWCOperation;
+        durationMs: number;
+        connectionMode: ConnectionMode;
+        walletId?: string | undefined;
+        namespace?: Namespace | undefined;
+        chainId?: NetworkId | undefined;
+        /** The deadline that elapsed (the configured marker timeout). */
+        timeoutMs: number;
+        /** switchNetwork only: target chain already the active one (no-op switch). */
+        targetAlreadyActive?: boolean | undefined;
+    };
+    /** The wallet's active account/list changed. Signals THAT it changed, not which. */
+    walletAccountChanged: {
+        connectionMode: ConnectionMode;
+        walletId?: string | undefined;
+        namespace?: Namespace | undefined;
+    };
+    /**
+     * The wallet switched chain on its own. Deduped against the echo of a
+     * UWC-initiated `switchNetwork` (which already surfaces via `networkSwitched`).
+     */
+    walletChainChanged: {
+        connectionMode: ConnectionMode;
+        walletId?: string | undefined;
+        namespace?: Namespace | undefined;
+        chainId?: NetworkId | undefined;
+    };
+    /** The wallet disconnected the session from its side. */
+    walletDisconnected: {
+        connectionMode: ConnectionMode;
+        walletId?: string | undefined;
+        namespace?: Namespace | undefined;
+    };
+    /** A WalletConnect / TON session expired. */
+    walletSessionExpired: {
+        connectionMode: ConnectionMode;
+        walletId?: string | undefined;
+        namespace?: Namespace | undefined;
+    };
+    /**
+     * Lifecycle telemetry could not be attached for this connection — emitted once
+     * so analytics can tell "genuinely silent" from "never wired". Carries WHY +
+     * whether the runtime is the direct page or the production iframe.
+     */
+    lifecycleTelemetryUnavailable: {
+        reason: LifecycleUnavailableReason;
+        connectionMode: ConnectionMode;
+        walletId?: string | undefined;
+        namespace?: Namespace | undefined;
+        runtime: 'direct' | 'iframe';
+    };
+    /**
+     * The page was backgrounded (tab hidden / app-switched) while a wallet handoff
+     * was still pending. Telemetry-only. On mobile this usually means the user
+     * left for the wallet app — a deep-link round-trip in progress, not an
+     * abandonment. UWC emits the raw FACT only; never an interpreted "abandoned".
+     */
+    pageHiddenDuringHandoff: {
+        handoffId: string;
+        platform: Platform;
+    };
+    /**
+     * The page became visible again (returned from the wallet / bfcache restore)
+     * while a handoff was still pending. Pairs with `pageHiddenDuringHandoff` to
+     * bracket an app-switch — consecutive same-state transitions are deduped per
+     * handoff (a bfcache restore can fire both `pageshow` and `visibilitychange`
+     * for one physical return). Telemetry-only.
+     */
+    pageVisibleDuringHandoff: {
+        handoffId: string;
+        platform: Platform;
     };
     /**
      * Back-compat catch-all. Fires after every other event above.
@@ -66,6 +295,13 @@ export interface UWCEventMap {
      */
     change: void;
 }
+/**
+ * Events that describe telemetry rather than a state change. `EventManager.emit`
+ * skips the legacy `change` cascade for these so high-frequency logging / handoff
+ * instrumentation can't trigger React re-renders through `subscribe()`.
+ */
+export declare const TELEMETRY_ONLY_EVENTS: ReadonlySet<UWCEventName>;
 export type UWCEventName = keyof UWCEventMap;
 export type UWCEventListener<K extends UWCEventName> = (data: UWCEventMap[K]) => void;
+export declare const UWC_EVENT_NAMES: UWCEventName[];
 //# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,OAAO,EACP,cAAc,EACd,cAAc,EACd,WAAW,EACX,eAAe,EAChB,MAAM,wBAAwB,CAAA;AAE/B;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,YAAY,GACZ,eAAe,GACf,aAAa,GACb,iBAAiB,GACjB,uBAAuB,GACvB,YAAY,CAAA;AAEhB;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,kFAAkF;IAClF,KAAK,EAAE,IAAI,CAAA;IACX,mEAAmE;IACnE,eAAe,EAAE;QAAE,OAAO,EAAE,cAAc,EAAE,CAAA;KAAE,CAAA;IAE9C,+BAA+B;IAC/B,UAAU,EAAE;QAAE,cAAc,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;IAChE,0CAA0C;IAC1C,SAAS,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAA;IAC/B,4DAA4D;IAC5D,YAAY,EAAE,IAAI,CAAA;IAClB;;;OAGG;IACH,aAAa,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,cAAc,CAAA;KAAE,CAAA;IAE9D,sEAAsE;IACtE,cAAc,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAA;IAEpC,gEAAgE;IAChE,gBAAgB,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,wBAAwB,EAAE,OAAO,CAAA;KAAE,CAAA;IAC3E,gCAAgC;IAChC,eAAe,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAA;IAErC,0CAA0C;IAC1C,mBAAmB,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;KAAE,CAAA;IAEtE,yCAAyC;IACzC,KAAK,EAAE;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,SAAS,EAAE,YAAY,CAAA;KAAE,CAAA;IAEtD;;;OAGG;IACH,MAAM,EAAE,IAAI,CAAA;CACb;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,WAAW,CAAA;AAC5C,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,YAAY,IAAI,CACrD,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,KACjB,IAAI,CAAA"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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"}

package/dist/events.js

@@ -1,2 +1,78 @@
-export {};
+/**
+ * User-initiated operations that can surface through the `error` event. The
+ * runtime tuple is the single source of truth; the type is derived from it so a
+ * guard test can enumerate every op — and catch a new one added without handoff
+ * instrumentation — instead of relying on a hand-maintained list.
+ */
+export const UWC_OPERATIONS = [
+    'connect',
+    'disconnect',
+    'switchNetwork',
+    'signMessage',
+    'signTypedData',
+    'sendTransaction',
+    'signSolanaTransaction',
+    'getWalletCapabilities',
+    'initialize'
+];
+/**
+ * Events that describe telemetry rather than a state change. `EventManager.emit`
+ * skips the legacy `change` cascade for these so high-frequency logging / handoff
+ * instrumentation can't trigger React re-renders through `subscribe()`.
+ */
+export const TELEMETRY_ONLY_EVENTS = new Set([
+    'log',
+    'awaitingWallet',
+    'walletSucceeded',
+    'walletRejected',
+    'walletFailed',
+    'walletTimedOut',
+    'walletDiscoveryFailed',
+    'bridgeError',
+    'relayError',
+    'walletAccountChanged',
+    'walletChainChanged',
+    'walletDisconnected',
+    'walletSessionExpired',
+    'lifecycleTelemetryUnavailable',
+    'pageHiddenDuringHandoff',
+    'pageVisibleDuringHandoff'
+]);
+/**
+ * Runtime list of every event name. The `Record<UWCEventName, true>` literal
+ * forces this to stay exhaustive — adding an event to `UWCEventMap` without
+ * listing it here is a compile error — so the observer bridge can never silently
+ * drop a new event.
+ */
+const EVENT_NAME_FLAGS = {
+    ready: true,
+    walletsDetected: true,
+    walletDiscoveryFailed: true,
+    bridgeError: true,
+    relayError: true,
+    connecting: true,
+    connected: true,
+    disconnected: true,
+    connectionUri: true,
+    sessionChanged: true,
+    networkSwitching: true,
+    networkSwitched: true,
+    capabilitiesUpdated: true,
+    error: true,
+    log: true,
+    awaitingWallet: true,
+    walletSucceeded: true,
+    walletRejected: true,
+    walletFailed: true,
+    walletTimedOut: true,
+    walletAccountChanged: true,
+    walletChainChanged: true,
+    walletDisconnected: true,
+    walletSessionExpired: true,
+    lifecycleTelemetryUnavailable: true,
+    pageHiddenDuringHandoff: true,
+    pageVisibleDuringHandoff: true,
+    change: true
+};
+export const UWC_EVENT_NAMES = Object.keys(EVENT_NAME_FLAGS);
 //# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":""}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAiBA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,SAAS;IACT,YAAY;IACZ,eAAe;IACf,aAAa;IACb,eAAe;IACf,iBAAiB;IACjB,uBAAuB;IACvB,uBAAuB;IACvB,YAAY;CACJ,CAAA;AA6RV;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA8B,IAAI,GAAG,CAAC;IACtE,KAAK;IACL,gBAAgB;IAChB,iBAAiB;IACjB,gBAAgB;IAChB,cAAc;IACd,gBAAgB;IAChB,uBAAuB;IACvB,aAAa;IACb,YAAY;IACZ,sBAAsB;IACtB,oBAAoB;IACpB,oBAAoB;IACpB,sBAAsB;IACtB,+BAA+B;IAC/B,yBAAyB;IACzB,0BAA0B;CAC3B,CAAC,CAAA;AAOF;;;;;GAKG;AACH,MAAM,gBAAgB,GAA+B;IACnD,KAAK,EAAE,IAAI;IACX,eAAe,EAAE,IAAI;IACrB,qBAAqB,EAAE,IAAI;IAC3B,WAAW,EAAE,IAAI;IACjB,UAAU,EAAE,IAAI;IAChB,UAAU,EAAE,IAAI;IAChB,SAAS,EAAE,IAAI;IACf,YAAY,EAAE,IAAI;IAClB,aAAa,EAAE,IAAI;IACnB,cAAc,EAAE,IAAI;IACpB,gBAAgB,EAAE,IAAI;IACtB,eAAe,EAAE,IAAI;IACrB,mBAAmB,EAAE,IAAI;IACzB,KAAK,EAAE,IAAI;IACX,GAAG,EAAE,IAAI;IACT,cAAc,EAAE,IAAI;IACpB,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,IAAI;IACpB,YAAY,EAAE,IAAI;IAClB,cAAc,EAAE,IAAI;IACpB,oBAAoB,EAAE,IAAI;IAC1B,kBAAkB,EAAE,IAAI;IACxB,kBAAkB,EAAE,IAAI;IACxB,oBAAoB,EAAE,IAAI;IAC1B,6BAA6B,EAAE,IAAI;IACnC,uBAAuB,EAAE,IAAI;IAC7B,wBAAwB,EAAE,IAAI;IAC9B,MAAM,EAAE,IAAI;CACb,CAAA;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAmB,CAAA"}

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export { UniversalWalletConnector, type UWCConfig, type OperationOptions } from './universal-wallet-connector';
 export type { UWCEventMap, UWCEventName, UWCEventListener, UWCOperation } from './events';
+export { createLogger, type ManagedLogger, type CreateLoggerOptions } from './logger/create-logger';
+export { TELEMETRY_SCHEMA_VERSION, type UWCObserver, type UWCTelemetryEvent } from './observability/telemetry';
 export { toBaseUnits } from './utils/to-base-units';
 //# 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,OAAO,EACL,wBAAwB,EACxB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACtB,MAAM,8BAA8B,CAAA;AACrC,YAAY,EACV,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACb,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACtB,MAAM,8BAA8B,CAAA;AACrC,YAAY,EACV,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACb,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACzB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,wBAAwB,EACxB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACvB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/index.js

@@ -1,3 +1,5 @@
 export { UniversalWalletConnector } from './universal-wallet-connector';
+export { createLogger } from './logger/create-logger';
+export { TELEMETRY_SCHEMA_VERSION } from './observability/telemetry';
 export { toBaseUnits } from './utils/to-base-units';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EAGzB,MAAM,8BAA8B,CAAA;AAOrC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EAGzB,MAAM,8BAA8B,CAAA;AAOrC,OAAO,EACL,YAAY,EAGb,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,wBAAwB,EAGzB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/logger/create-logger.d.ts

@@ -0,0 +1,32 @@
+import type { LogLevel, Logger } from '@meshconnect/uwc-types';
+/** The logger returned by `createLogger`, with runtime-tunable level controls. */
+export interface ManagedLogger extends Logger {
+    /** Lower/raise the console threshold at runtime (e.g. from a support toggle). */
+    setLevel(level: LogLevel): void;
+    /** The currently configured threshold (ignores the global override). */
+    getLevel(): LogLevel;
+}
+export interface CreateLoggerOptions {
+    /** Console threshold. Default `'warn'` — UWC stays quiet unless asked. */
+    level?: LogLevel | undefined;
+    /**
+     * Pre-gate tap: invoked for EVERY log line regardless of the console threshold.
+     * The observer bridge subscribes here so `debug`/`info` reach remote telemetry
+     * even when the console is silent. Throws are swallowed — a bad sink must not
+     * break a log call.
+     */
+    onLog?: ((level: LogLevel, message: string, args: unknown[]) => void) | undefined;
+    /**
+     * Output sink for gated lines. When provided (e.g. a consumer's own logger), it
+     * receives the RAW `(message, ...args)` so it can apply its own formatting. When
+     * omitted, the default `console` sink is used with an ISO/level prefix.
+     */
+    sink?: Logger | undefined;
+}
+/**
+ * Console-backed, level-gated logger. ~zero-dep. Two seams:
+ *  - `onLog` fires pre-gate (all levels) → drives the observer.
+ *  - the console sink fires only at/above the threshold.
+ */
+export declare function createLogger(options?: CreateLoggerOptions): ManagedLogger;
+//# sourceMappingURL=create-logger.d.ts.map

package/dist/logger/create-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-logger.d.ts","sourceRoot":"","sources":["../../src/logger/create-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAS9D,kFAAkF;AAClF,MAAM,WAAW,aAAc,SAAQ,MAAM;IAC3C,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC/B,wEAAwE;IACxE,QAAQ,IAAI,QAAQ,CAAA;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,0EAA0E;IAC1E,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;IAC5B;;;;;OAKG;IACH,KAAK,CAAC,EACF,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC,GAC7D,SAAS,CAAA;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC1B;AAgCD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,aAAa,CAuC7E"}

package/dist/logger/create-logger.js

@@ -0,0 +1,79 @@
+const LEVEL_WEIGHT = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3
+};
+/**
+ * Resolve the effective console threshold, honouring a runtime global override so
+ * an issue can be triaged in a wallet's in-app browser WITHOUT a redeploy:
+ *
+ *   window.UWC_DEBUG = true        // surface everything (debug)
+ *   window.UWC_DEBUG = 'info'      // surface info and above
+ *
+ * The override only ever LOWERS the threshold (shows more) — it can't hide logs a
+ * consumer explicitly opted into. Re-read on every call so toggling it mid-session
+ * takes effect immediately. SSR/Node-safe via the `globalThis` guard.
+ */
+function resolveWeight(configured) {
+    if (typeof globalThis !== 'undefined') {
+        const override = globalThis.UWC_DEBUG;
+        if (override === true)
+            return LEVEL_WEIGHT.debug;
+        // Own-property check, not `in`: the prototype chain would accept keys like
+        // 'toString', whose "weight" is a function → NaN → the gate never closes.
+        if (typeof override === 'string' &&
+            Object.prototype.hasOwnProperty.call(LEVEL_WEIGHT, override)) {
+            return Math.min(LEVEL_WEIGHT[override], LEVEL_WEIGHT[configured]);
+        }
+    }
+    return LEVEL_WEIGHT[configured];
+}
+/**
+ * Console-backed, level-gated logger. ~zero-dep. Two seams:
+ *  - `onLog` fires pre-gate (all levels) → drives the observer.
+ *  - the console sink fires only at/above the threshold.
+ */
+export function createLogger(options = {}) {
+    let configured = options.level ?? 'warn';
+    const customSink = options.sink;
+    const emit = (level, message, args) => {
+        // Pre-gate tap first — observability must not depend on the console threshold.
+        if (options.onLog) {
+            try {
+                options.onLog(level, message, args);
+            }
+            catch {
+                // A failing sink must never break the caller's log statement.
+            }
+        }
+        if (LEVEL_WEIGHT[level] < resolveWeight(configured))
+            return;
+        // Same contract as the `onLog` tap above: the sink (a consumer logger or the
+        // console) must never break the caller's log statement if it throws.
+        try {
+            if (customSink) {
+                customSink[level](message, ...args);
+            }
+            else {
+                const line = `[${new Date().toISOString()}] ${level.toUpperCase()}: ${message}`;
+                // eslint-disable-next-line no-console -- this IS the default console sink
+                console[level](line, ...args);
+            }
+        }
+        catch {
+            // Swallowed by design — a broken sink is not the caller's problem.
+        }
+    };
+    return {
+        debug: (message, ...args) => emit('debug', message, args),
+        info: (message, ...args) => emit('info', message, args),
+        warn: (message, ...args) => emit('warn', message, args),
+        error: (message, ...args) => emit('error', message, args),
+        setLevel: level => {
+            configured = level;
+        },
+        getLevel: () => configured
+    };
+}
+//# sourceMappingURL=create-logger.js.map

package/dist/logger/create-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-logger.js","sourceRoot":"","sources":["../../src/logger/create-logger.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAA6B;IAC7C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAA;AA8BD;;;;;;;;;;GAUG;AACH,SAAS,aAAa,CAAC,UAAoB;IACzC,IAAI,OAAO,UAAU,KAAK,WAAW,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAI,UAAsC,CAAC,SAAS,CAAA;QAClE,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,YAAY,CAAC,KAAK,CAAA;QAChD,2EAA2E;QAC3E,0EAA0E;QAC1E,IACE,OAAO,QAAQ,KAAK,QAAQ;YAC5B,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,EAC5D,CAAC;YACD,OAAO,IAAI,CAAC,GAAG,CACb,YAAY,CAAC,QAAoB,CAAC,EAClC,YAAY,CAAC,UAAU,CAAC,CACzB,CAAA;QACH,CAAC;IACH,CAAC;IACD,OAAO,YAAY,CAAC,UAAU,CAAC,CAAA;AACjC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,UAA+B,EAAE;IAC5D,IAAI,UAAU,GAAa,OAAO,CAAC,KAAK,IAAI,MAAM,CAAA;IAClD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAA;IAE/B,MAAM,IAAI,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,IAAe,EAAQ,EAAE;QACvE,+EAA+E;QAC/E,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,IAAI,CAAC;gBACH,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;YACrC,CAAC;YAAC,MAAM,CAAC;gBACP,8DAA8D;YAChE,CAAC;QACH,CAAC;QACD,IAAI,YAAY,CAAC,KAAK,CAAC,GAAG,aAAa,CAAC,UAAU,CAAC;YAAE,OAAM;QAC3D,6EAA6E;QAC7E,qEAAqE;QACrE,IAAI,CAAC;YACH,IAAI,UAAU,EAAE,CAAC;gBACf,UAAU,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;YACrC,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE,KAAK,OAAO,EAAE,CAAA;gBAC/E,0EAA0E;gBAC1E,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAA;YAC/B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,mEAAmE;QACrE,CAAC;IACH,CAAC,CAAA;IAED,OAAO;QACL,KAAK,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;QACzD,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;QACvD,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;QACvD,KAAK,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;QACzD,QAAQ,EAAE,KAAK,CAAC,EAAE;YAChB,UAAU,GAAG,KAAK,CAAA;QACpB,CAAC;QACD,QAAQ,EAAE,GAAG,EAAE,CAAC,UAAU;KAC3B,CAAA;AACH,CAAC"}

package/dist/managers/event-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-manager.d.ts","sourceRoot":"","sources":["../../src/managers/event-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAE5E,KAAK,cAAc,GAAG,MAAM,IAAI,CAAA;AAGhC;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAqD;IAEtE,mEAAmE;IACnE,EAAE,CAAC,CAAC,SAAS,YAAY,EACvB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC5B,MAAM,IAAI;IAUb,wEAAwE;IACxE,IAAI,CAAC,CAAC,SAAS,YAAY,EACzB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC5B,MAAM,IAAI;IAQb,GAAG,CAAC,CAAC,SAAS,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI;IAK1E,IAAI,CAAC,CAAC,SAAS,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IAOlE,OAAO,CAAC,QAAQ;IAkBhB;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI;IAI/C,kFAAkF;IAClF,MAAM,IAAI,IAAI;IAId,gBAAgB,IAAI,MAAM;IAQ1B,iBAAiB,IAAI,IAAI;CAG1B"}
+{"version":3,"file":"event-manager.d.ts","sourceRoot":"","sources":["../../src/managers/event-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAG5E,KAAK,cAAc,GAAG,MAAM,IAAI,CAAA;AAGhC;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAqD;IAEtE,mEAAmE;IACnE,EAAE,CAAC,CAAC,SAAS,YAAY,EACvB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC5B,MAAM,IAAI;IAUb,wEAAwE;IACxE,IAAI,CAAC,CAAC,SAAS,YAAY,EACzB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC5B,MAAM,IAAI;IAQb,GAAG,CAAC,CAAC,SAAS,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI;IAK1E,IAAI,CAAC,CAAC,SAAS,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IAUlE,OAAO,CAAC,QAAQ;IAkBhB;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI;IAI/C,kFAAkF;IAClF,MAAM,IAAI,IAAI;IAId,gBAAgB,IAAI,MAAM;IAQ1B,iBAAiB,IAAI,IAAI;CAG1B"}

package/dist/managers/event-manager.js

@@ -1,3 +1,4 @@
+import { TELEMETRY_ONLY_EVENTS } from '../events';
 /**
  * Typed event emitter used by UniversalWalletConnector.
  *
@@ -31,7 +32,10 @@ export class EventManager {
     }
     emit(event, data) {
         this.dispatch(event, data);
-        if (event !== 'change') {
+        // Telemetry-only events (logs, handoff instrumentation) describe what
+        // happened, not a state change — don't cascade them to `change`, or every
+        // log line would trigger a React re-render via legacy `subscribe()`.
+        if (event !== 'change' && !TELEMETRY_ONLY_EVENTS.has(event)) {
             this.dispatch('change', undefined);
         }
     }

package/dist/managers/event-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-manager.js","sourceRoot":"","sources":["../../src/managers/event-manager.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IACf,SAAS,GAA4C,IAAI,GAAG,EAAE,CAAA;IAEtE,mEAAmE;IACnE,EAAE,CACA,KAAQ,EACR,QAA6B;QAE7B,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACnC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAA;YACf,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;QAChC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,QAA2B,CAAC,CAAA;QACpC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;IACxC,CAAC;IAED,wEAAwE;IACxE,IAAI,CACF,KAAQ,EACR,QAA6B;QAE7B,MAAM,OAAO,GAAwB,IAAI,CAAC,EAAE;YAC1C,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;YACxB,QAAQ,CAAC,IAAI,CAAC,CAAA;QAChB,CAAC,CAAA;QACD,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IAChC,CAAC;IAED,GAAG,CAAyB,KAAQ,EAAE,QAA6B;QACjE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACrC,GAAG,EAAE,MAAM,CAAC,QAA2B,CAAC,CAAA;IAC1C,CAAC;IAED,IAAI,CAAyB,KAAQ,EAAE,IAAoB;QACzD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QAC1B,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvB,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAkC,CAAC,CAAA;QAC7D,CAAC;IACH,CAAC;IAEO,QAAQ,CACd,KAAQ,EACR,IAAoB;QAEpB,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACrC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;YAAE,OAAM;QAClC,mDAAmD;QACnD,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,QAAQ,CAAC,IAAI,CAAC,CAAA;YAChB,CAAC;YAAC,MAAM,CAAC;gBACP,iEAAiE;YACnE,CAAC;QACH,CAAC;IACH,CAAC;IAED,oEAAoE;IAEpE;;;OAGG;IACH,SAAS,CAAC,QAAwB;QAChC,OAAO,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IACpC,CAAC;IAED,kFAAkF;IAClF,MAAM;QACJ,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAkC,CAAC,CAAA;IAC7D,CAAC;IAED,gBAAgB;QACd,IAAI,KAAK,GAAG,CAAC,CAAA;QACb,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1C,KAAK,IAAI,GAAG,CAAC,IAAI,CAAA;QACnB,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IAED,iBAAiB;QACf,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAA;IACxB,CAAC;CACF"}
+{"version":3,"file":"event-manager.js","sourceRoot":"","sources":["../../src/managers/event-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAA;AAKjD;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IACf,SAAS,GAA4C,IAAI,GAAG,EAAE,CAAA;IAEtE,mEAAmE;IACnE,EAAE,CACA,KAAQ,EACR,QAA6B;QAE7B,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACnC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAA;YACf,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;QAChC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,QAA2B,CAAC,CAAA;QACpC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;IACxC,CAAC;IAED,wEAAwE;IACxE,IAAI,CACF,KAAQ,EACR,QAA6B;QAE7B,MAAM,OAAO,GAAwB,IAAI,CAAC,EAAE;YAC1C,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;YACxB,QAAQ,CAAC,IAAI,CAAC,CAAA;QAChB,CAAC,CAAA;QACD,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IAChC,CAAC;IAED,GAAG,CAAyB,KAAQ,EAAE,QAA6B;QACjE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACrC,GAAG,EAAE,MAAM,CAAC,QAA2B,CAAC,CAAA;IAC1C,CAAC;IAED,IAAI,CAAyB,KAAQ,EAAE,IAAoB;QACzD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QAC1B,sEAAsE;QACtE,0EAA0E;QAC1E,qEAAqE;QACrE,IAAI,KAAK,KAAK,QAAQ,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5D,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAkC,CAAC,CAAA;QAC7D,CAAC;IACH,CAAC;IAEO,QAAQ,CACd,KAAQ,EACR,IAAoB;QAEpB,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACrC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;YAAE,OAAM;QAClC,mDAAmD;QACnD,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,QAAQ,CAAC,IAAI,CAAC,CAAA;YAChB,CAAC;YAAC,MAAM,CAAC;gBACP,iEAAiE;YACnE,CAAC;QACH,CAAC;IACH,CAAC;IAED,oEAAoE;IAEpE;;;OAGG;IACH,SAAS,CAAC,QAAwB;QAChC,OAAO,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IACpC,CAAC;IAED,kFAAkF;IAClF,MAAM;QACJ,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAkC,CAAC,CAAA;IAC7D,CAAC;IAED,gBAAgB;QACd,IAAI,KAAK,GAAG,CAAC,CAAA;QACb,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1C,KAAK,IAAI,GAAG,CAAC,IAAI,CAAA;QACnB,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IAED,iBAAiB;QACf,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAA;IACxB,CAAC;CACF"}

package/dist/observability/connect-observer.d.ts

@@ -0,0 +1,33 @@
+import type { Logger } from '@meshconnect/uwc-types';
+import type { EventManager } from '../managers/event-manager';
+import { type UWCObserver } from './telemetry';
+/**
+ * Bridge the internal event bus to a consumer-supplied `UWCObserver`.
+ *
+ * Subscribes to every `UWCEventMap` event, normalizes each to a PII-safe
+ * `UWCTelemetryEvent`, and forwards it to `observer.onEvent`. The `log` event is
+ * routed to `observer.onLog` instead (with scrubbed args) — it's the logging
+ * channel, not a telemetry record. `change` is skipped: it's the legacy
+ * re-render cascade and carries no payload.
+ *
+ * Returns a teardown function that removes every subscription. The caller MUST
+ * invoke it on connector teardown — leaving these attached is the same listener-
+ * leak class as the historical `BridgeParent.destroy()` zombie bug.
+ *
+ * @param sdkSessionId - per-connector-instance id stamped on every record.
+ * @param getCorrelationId - resolves the optional consumer correlation id,
+ *   called per-event so an id that arrives/changes after construction is
+ *   honoured. Must not throw (the caller pre-wraps it). Defaults to `undefined`.
+ * @param now - clock injectable for deterministic tests; defaults to `Date.now`.
+ * @param logger - optional; a throwing observer is reported via `logger.debug`.
+ *   When omitted the throw is swallowed silently (the historical behaviour).
+ */
+/**
+ * Cap on distinct observer-error messages remembered for dedup. Same storm-guard
+ * contract as the relay/bridge dedup sets: bounding keeps memory flat on a
+ * long-lived instance even when a broken observer throws high-cardinality
+ * messages (e.g. embedding event data or timestamps).
+ */
+export declare const MAX_REPORTED_OBSERVER_ERRORS = 100;
+export declare function connectObserver(eventManager: EventManager, observer: UWCObserver, sdkSessionId: string, getCorrelationId?: () => string | undefined, now?: () => number, logger?: Logger): () => void;
+//# sourceMappingURL=connect-observer.d.ts.map

package/dist/observability/connect-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-observer.d.ts","sourceRoot":"","sources":["../../src/observability/connect-observer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAG7D,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAA;AAG9D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,MAAM,CAAA;AAE/C,wBAAgB,eAAe,CAC7B,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,WAAW,EACrB,YAAY,EAAE,MAAM,EACpB,gBAAgB,GAAE,MAAM,MAAM,GAAG,SAA2B,EAC5D,GAAG,GAAE,MAAM,MAAiB,EAC5B,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,IAAI,CAmFZ"}