@paywithglide/glide-react 0.0.46 → 0.0.47

package/dist/pkg/GlideDeposit.d.ts

@@ -1,5 +1,6 @@
 import { GlideWidgetTheme } from './theme.ts';
 import { CAIP2, Session } from '@paywithglide/glide-js';
+import { GlideAnalyticsCallback } from './analytics.ts';
 export type Hex = `0x${string}`;
 export type EVMTransaction = {
     chainId: number;
@@ -82,11 +83,15 @@ export type GlideLocalStorageProvider = {
     removeItem: (key: string) => Promise<void>;
     getKeys: () => Promise<string[]>;
 };
-export type FundingSource = "transfer" | "coinbase" | "coinbase_app" | "interac" | "fiat" | "wallet" | "debit_card_alias";
+export type FundingSource = "transfer" | "coinbase" | "coinbase_app" | "interac" | "fiat" | "wallet" | "debit_card_alias" | "onramp";
 export type ShowAppLogo = "default" | "always" | "never";
 export type DebitCardAlias = "fiat" | "coinbase";
 export type GlideDepositOptions = {
     app: string;
+    /**
+     * Optional project ID for analytics segmentation
+     */
+    projectId?: string;
     recipient?: string;
     mode?: "deposit" | "withdraw" | "pay" | "call" | "buy";
     amount?: string;
@@ -138,10 +143,24 @@ export type GlideDepositOptions = {
     popupsBlocked?: boolean;
     baseUrl?: string;
     debug?: boolean;
+    /**
+     * Analytics callback for tracking user events and behavior
+     * Called with various events throughout the deposit/payment flow
+     * Use this to integrate with your own analytics platform (e.g., Amplitude, Mixpanel)
+     */
+    onAnalyticsEvent?: GlideAnalyticsCallback;
 };
 export declare class GlideDeposit {
     opts: GlideDepositOptions;
     constructor(opts: GlideDepositOptions);
+    /**
+     * Get analytics context for events tracked directly in SDK
+     */
+    private getAnalyticsContext;
+    /**
+     * Track an analytics event with context
+     */
+    private trackEvent;
     open: () => void;
     get externalUrl(): string;
     private initialize;

package/dist/pkg/analytics.d.ts

@@ -0,0 +1,220 @@
+/**
+ * Analytics Event Types for GLIDE SDK
+ *
+ * These events allow clients to track user behavior and conversions
+ * through their own analytics platforms (e.g., Amplitude, Mixpanel, etc.)
+ */
+/**
+ * Base context included with every analytics event
+ * This allows segmentation by client/project and user identification
+ */
+export type GlideAnalyticsContext = {
+    projectId?: string;
+    appSlug: string;
+    sdkVersion: string;
+    referrerDomain?: string;
+    walletAddress?: string;
+    device: {
+        isMobile: boolean;
+        platform: "ios" | "android" | "windows" | "macos" | "linux" | "unknown";
+        browser: string;
+    };
+};
+/**
+ * Raw event types (without context - used internally in the widget)
+ */
+export type GlideAnalyticsEventType = {
+    type: "modal_opened";
+    timestamp: number;
+} | {
+    type: "modal_closed";
+    timestamp: number;
+    completedTransaction: boolean;
+} | {
+    type: "mode_selected";
+    mode: "deposit" | "withdraw" | "pay" | "call" | "buy";
+    timestamp: number;
+} | {
+    type: "step_viewed";
+    step: string;
+    timestamp: number;
+} | {
+    type: "step_exited";
+    step: string;
+    timestamp: number;
+    direction: "forward" | "back";
+} | {
+    type: "payment_method_selected";
+    paymentMethod: "wallet" | "transfer" | "coinbase" | "coinbase_app" | "fiat" | "interac" | "debit_card_alias";
+    timestamp: number;
+} | {
+    type: "funding_source_viewed";
+    availableOptions: string[];
+    timestamp: number;
+} | {
+    type: "funding_source_selected";
+    fundingSource: "wallet" | "crypto" | "fiat";
+    timestamp: number;
+} | {
+    type: "wallet_connect_started";
+    timestamp: number;
+} | {
+    type: "wallet_connected";
+    address: string;
+    chainId: number;
+    timestamp: number;
+} | {
+    type: "wallet_connection_failed";
+    error: string;
+    timestamp: number;
+} | {
+    type: "wallet_disconnected";
+    timestamp: number;
+} | {
+    type: "chain_selected";
+    chainId: string;
+    chainName: string;
+    timestamp: number;
+} | {
+    type: "currency_selected";
+    currencyId: string;
+    currencySymbol: string;
+    chainId: string;
+    timestamp: number;
+} | {
+    type: "amount_entered";
+    amount: string;
+    currencySymbol: string;
+    amountUSD?: number;
+    timestamp: number;
+} | {
+    type: "session_creation_started";
+    timestamp: number;
+} | {
+    type: "session_created";
+    sessionId: string;
+    paymentMethod: string;
+    estimatedAmountUSD?: number;
+    timestamp: number;
+} | {
+    type: "session_creation_failed";
+    error: string;
+    timestamp: number;
+} | {
+    type: "transaction_started";
+    sessionId: string;
+    paymentMethod: string;
+    fromToken: string;
+    toToken: string;
+    amount: string;
+    estimatedAmountUSD?: number;
+    timestamp: number;
+} | {
+    type: "transaction_signature_requested";
+    sessionId: string;
+    timestamp: number;
+} | {
+    type: "transaction_signed";
+    sessionId: string;
+    txHash: string;
+    timestamp: number;
+} | {
+    type: "transaction_signature_rejected";
+    sessionId: string;
+    timestamp: number;
+} | {
+    type: "transaction_completed";
+    sessionId: string;
+    txHash: string;
+    paymentMethod: string;
+    success: boolean;
+    amountUSD?: number;
+    timestamp: number;
+} | {
+    type: "transaction_failed";
+    sessionId: string;
+    error: string;
+    paymentMethod: string;
+    timestamp: number;
+} | {
+    type: "onramp_window_opened";
+    provider: "coinbase" | "moonpay";
+    timestamp: number;
+} | {
+    type: "onramp_window_closed";
+    provider: "coinbase" | "moonpay";
+    completed: boolean;
+    timestamp: number;
+} | {
+    type: "deposit_address_generated";
+    sessionId: string;
+    chainId: string;
+    currencySymbol: string;
+    timestamp: number;
+} | {
+    type: "deposit_address_copied";
+    sessionId: string;
+    timestamp: number;
+} | {
+    type: "waiting_for_deposit";
+    sessionId: string;
+    chainId: string;
+    currencySymbol: string;
+    timestamp: number;
+} | {
+    type: "deposit_detected";
+    sessionId: string;
+    amount: string;
+    currencySymbol: string;
+    timestamp: number;
+} | {
+    type: "transfer_completed";
+    sessionId: string;
+    txHash: string;
+    chainId: string;
+    currencySymbol: string;
+    amount: string;
+    amountUSD?: number;
+    timestamp: number;
+} | {
+    type: "error_occurred";
+    errorType: string;
+    errorMessage: string;
+    step?: string;
+    timestamp: number;
+} | {
+    type: "conversion_completed";
+    sessionId: string;
+    paymentMethod: string;
+    amountUSD?: number;
+    duration: number;
+    timestamp: number;
+};
+/**
+ * Full analytics event with context
+ * This is what clients receive in their callback
+ */
+export type GlideAnalyticsEvent = GlideAnalyticsEventType & GlideAnalyticsContext;
+/**
+ * Callback function type for analytics events
+ */
+export type GlideAnalyticsCallback = (event: GlideAnalyticsEvent) => void;
+/**
+ * Helper class for emitting analytics events
+ */
+export declare class GlideAnalytics {
+    private callback?;
+    private startTime?;
+    private currentStep?;
+    constructor(callback?: GlideAnalyticsCallback);
+    setCallback(callback: GlideAnalyticsCallback | undefined): void;
+    track(event: GlideAnalyticsEvent): void;
+    modalOpened(): void;
+    modalClosed(completedTransaction: boolean): void;
+    stepViewed(step: string): void;
+    stepExited(step: string, direction: "forward" | "back"): void;
+    paymentMethodSelected(paymentMethod: "wallet" | "transfer" | "coinbase" | "coinbase_app" | "fiat" | "interac" | "debit_card_alias"): void;
+    transactionCompleted(sessionId: string, txHash: string, paymentMethod: string, amountUSD?: number): void;
+    errorOccurred(errorType: string, errorMessage: string, step?: string): void;
+}
+export declare const glideAnalytics: GlideAnalytics;

package/dist/pkg/core.d.ts

@@ -0,0 +1,5 @@
+export * from './GlideDeposit.ts';
+export * from './theme.ts';
+export * from './browserLocalStorageProvider.ts';
+export * from './walletProviderBridge.ts';
+export * from './analytics.ts';

package/dist/pkg/index.d.ts

@@ -6,3 +6,4 @@ export * from './useGlideBuy.ts';
 export * from './theme.ts';
 export * from './browserLocalStorageProvider.ts';
 export * from './walletProviderBridge.ts';
+export * from './analytics.ts';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paywithglide/glide-react",
-  "version": "0.0.46",
+  "version": "0.0.47",
   "type": "module",
   "files": [
     "dist"
@@ -12,6 +12,10 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/glide.js"
     },
+    "./core": {
+      "types": "./dist/core.d.ts",
+      "default": "./dist/core.js"
+    },
     "./package.json": "./package.json"
   },
   "sideEffects": false,
@@ -25,7 +29,7 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@paywithglide/glide-js": "0.13.10"
+    "@paywithglide/glide-js": "0.13.32"
   },
   "devDependencies": {
     "@antiwork/shortest": "^0.2.1",