@unifold/analytics 0.1.79 → 0.1.81

package/dist/index.d.mts

@@ -55,6 +55,12 @@ declare const AnalyticsEvents: {
     readonly WALLET_CONNECTED: "wallet_connected";
     /** The connection failed, or the user declined it in their wallet. */
     readonly WALLET_CONNECTION_FAILED: "wallet_connection_failed";
+    /**
+     * Injected wallet discovery or event wiring failed before a user interaction.
+     * These failures are recoverable: the SDK hides the browser-wallet option and
+     * leaves the remaining payment methods available.
+     */
+    readonly BROWSER_WALLET_PROVIDER_ERROR: "browser_wallet_provider_error";
     /** User navigated back a step. */
     readonly BACK_CLICKED: "back_clicked";
     /** User started a flow (deposit, checkout, withdraw). */
@@ -121,6 +127,23 @@ interface AnalyticsProperties {
     element?: string;
     /** Error code for flow_failed events. */
     error_code?: string;
+    /** Browser-wallet discovery phase that threw (browser_wallet_provider_error). */
+    error_stage?: string;
+    /** JavaScript error class, normally `TypeError` (browser_wallet_provider_error). */
+    error_name?: string;
+    /** Sanitized and length-limited provider error text (browser_wallet_provider_error). */
+    error_message?: string;
+    /** Injected provider source when known (browser_wallet_provider_error). */
+    provider_source?: string;
+    /** React component stack when a local wallet boundary recovered the failure. */
+    component_stack?: string;
+    /**
+     * True when a provider threw but a usable value was still recovered, so the
+     * wallet remained available to the user (browser_wallet_provider_error).
+     */
+    provider_recovered?: boolean;
+    /** Whether the SDK contained the error and kept the host flow usable. */
+    recoverable?: boolean;
     /** Onramp/exchange provider identifier. */
     provider?: string;
     /**
@@ -168,6 +191,18 @@ interface AnalyticsProperties {
     /** Catch-all for forward-compat. */
     [key: string]: unknown;
 }
+type BrowserWalletProviderErrorStage = 'provider_discovery' | 'provider_event_subscription' | 'provider_event_cleanup' | 'wallet_detection' | 'react_error_boundary';
+/** Required payload for `browser_wallet_provider_error`. */
+interface BrowserWalletProviderErrorProperties extends AnalyticsProperties {
+    error_stage: BrowserWalletProviderErrorStage;
+    error_name: string;
+    error_message: string;
+    recoverable: true;
+    provider_recovered: boolean;
+    chain_type?: 'ethereum' | 'solana';
+    provider_source?: string;
+    component_stack?: string;
+}
 /** Auto-populated SDK/device metadata. Not business data. */
 interface AnalyticsContext {
     library: {
@@ -345,6 +380,6 @@ declare function generateKSUID(): string;
  */
 declare function generatePrefixedKSUID(prefix: string): string;
 
-declare const PACKAGE_VERSION = "0.1.79";
+declare const PACKAGE_VERSION = "0.1.81";
 
-export { type AnalyticsConfig, type AnalyticsContext, type AnalyticsEvent, type AnalyticsEventName, AnalyticsEvents, type AnalyticsProperties, Emitter, EventTracker, PACKAGE_VERSION, createEventTracker, forwardEvent, generateKSUID, generatePrefixedKSUID };
+export { type AnalyticsConfig, type AnalyticsContext, type AnalyticsEvent, type AnalyticsEventName, AnalyticsEvents, type AnalyticsProperties, type BrowserWalletProviderErrorProperties, type BrowserWalletProviderErrorStage, Emitter, EventTracker, PACKAGE_VERSION, createEventTracker, forwardEvent, generateKSUID, generatePrefixedKSUID };

package/dist/index.d.ts

@@ -55,6 +55,12 @@ declare const AnalyticsEvents: {
     readonly WALLET_CONNECTED: "wallet_connected";
     /** The connection failed, or the user declined it in their wallet. */
     readonly WALLET_CONNECTION_FAILED: "wallet_connection_failed";
+    /**
+     * Injected wallet discovery or event wiring failed before a user interaction.
+     * These failures are recoverable: the SDK hides the browser-wallet option and
+     * leaves the remaining payment methods available.
+     */
+    readonly BROWSER_WALLET_PROVIDER_ERROR: "browser_wallet_provider_error";
     /** User navigated back a step. */
     readonly BACK_CLICKED: "back_clicked";
     /** User started a flow (deposit, checkout, withdraw). */
@@ -121,6 +127,23 @@ interface AnalyticsProperties {
     element?: string;
     /** Error code for flow_failed events. */
     error_code?: string;
+    /** Browser-wallet discovery phase that threw (browser_wallet_provider_error). */
+    error_stage?: string;
+    /** JavaScript error class, normally `TypeError` (browser_wallet_provider_error). */
+    error_name?: string;
+    /** Sanitized and length-limited provider error text (browser_wallet_provider_error). */
+    error_message?: string;
+    /** Injected provider source when known (browser_wallet_provider_error). */
+    provider_source?: string;
+    /** React component stack when a local wallet boundary recovered the failure. */
+    component_stack?: string;
+    /**
+     * True when a provider threw but a usable value was still recovered, so the
+     * wallet remained available to the user (browser_wallet_provider_error).
+     */
+    provider_recovered?: boolean;
+    /** Whether the SDK contained the error and kept the host flow usable. */
+    recoverable?: boolean;
     /** Onramp/exchange provider identifier. */
     provider?: string;
     /**
@@ -168,6 +191,18 @@ interface AnalyticsProperties {
     /** Catch-all for forward-compat. */
     [key: string]: unknown;
 }
+type BrowserWalletProviderErrorStage = 'provider_discovery' | 'provider_event_subscription' | 'provider_event_cleanup' | 'wallet_detection' | 'react_error_boundary';
+/** Required payload for `browser_wallet_provider_error`. */
+interface BrowserWalletProviderErrorProperties extends AnalyticsProperties {
+    error_stage: BrowserWalletProviderErrorStage;
+    error_name: string;
+    error_message: string;
+    recoverable: true;
+    provider_recovered: boolean;
+    chain_type?: 'ethereum' | 'solana';
+    provider_source?: string;
+    component_stack?: string;
+}
 /** Auto-populated SDK/device metadata. Not business data. */
 interface AnalyticsContext {
     library: {
@@ -345,6 +380,6 @@ declare function generateKSUID(): string;
  */
 declare function generatePrefixedKSUID(prefix: string): string;
 
-declare const PACKAGE_VERSION = "0.1.79";
+declare const PACKAGE_VERSION = "0.1.81";
 
-export { type AnalyticsConfig, type AnalyticsContext, type AnalyticsEvent, type AnalyticsEventName, AnalyticsEvents, type AnalyticsProperties, Emitter, EventTracker, PACKAGE_VERSION, createEventTracker, forwardEvent, generateKSUID, generatePrefixedKSUID };
+export { type AnalyticsConfig, type AnalyticsContext, type AnalyticsEvent, type AnalyticsEventName, AnalyticsEvents, type AnalyticsProperties, type BrowserWalletProviderErrorProperties, type BrowserWalletProviderErrorStage, Emitter, EventTracker, PACKAGE_VERSION, createEventTracker, forwardEvent, generateKSUID, generatePrefixedKSUID };

package/dist/index.js

@@ -100,7 +100,7 @@ function generatePrefixedKSUID(prefix) {
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.1.79";
+var PACKAGE_VERSION = "0.1.81";
 
 // src/tracker.ts
 var LIBRARY_NAME = "@unifold/analytics";
@@ -304,6 +304,12 @@ var AnalyticsEvents = {
   WALLET_CONNECTED: "wallet_connected",
   /** The connection failed, or the user declined it in their wallet. */
   WALLET_CONNECTION_FAILED: "wallet_connection_failed",
+  /**
+   * Injected wallet discovery or event wiring failed before a user interaction.
+   * These failures are recoverable: the SDK hides the browser-wallet option and
+   * leaves the remaining payment methods available.
+   */
+  BROWSER_WALLET_PROVIDER_ERROR: "browser_wallet_provider_error",
   /** User navigated back a step. */
   BACK_CLICKED: "back_clicked",
   /** User started a flow (deposit, checkout, withdraw). */

package/dist/index.mjs

@@ -98,7 +98,7 @@ function generatePrefixedKSUID(prefix) {
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.1.79";
+var PACKAGE_VERSION = "0.1.81";
 
 // src/tracker.ts
 var LIBRARY_NAME = "@unifold/analytics";
@@ -302,6 +302,12 @@ var AnalyticsEvents = {
   WALLET_CONNECTED: "wallet_connected",
   /** The connection failed, or the user declined it in their wallet. */
   WALLET_CONNECTION_FAILED: "wallet_connection_failed",
+  /**
+   * Injected wallet discovery or event wiring failed before a user interaction.
+   * These failures are recoverable: the SDK hides the browser-wallet option and
+   * leaves the remaining payment methods available.
+   */
+  BROWSER_WALLET_PROVIDER_ERROR: "browser_wallet_provider_error",
   /** User navigated back a step. */
   BACK_CLICKED: "back_clicked",
   /** User started a flow (deposit, checkout, withdraw). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unifold/analytics",
-  "version": "0.1.79",
+  "version": "0.1.81",
   "description": "Lightweight internal analytics for the Unifold SDK — zero external dependencies",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",