@paywithglide/glide-react 0.0.46 → 0.0.48

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;
@@ -76,17 +77,27 @@ export type GlideDepositWalletProvider = {
     sendTransactionAsync: (tx: EVMTransaction) => Promise<Hex>;
     signTypedDataAsync?: (args: PermitTypedData<bigint>) => Promise<Hex>;
 };
+export type GlideSolanaWalletProvider = {
+    address: string | undefined;
+    currentChainId: "solana:101" | "solana:103";
+    signMessageAsync: (message: Uint8Array) => Promise<Uint8Array>;
+    sendTransactionAsync: (transaction: Uint8Array) => Promise<Uint8Array>;
+};
 export type GlideLocalStorageProvider = {
     getItem: (key: string) => Promise<string | null>;
     setItem: (key: string, value: string) => Promise<void>;
     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;
@@ -120,6 +131,7 @@ export type GlideDepositOptions = {
     enableRefundEmails?: boolean;
     payerEmail?: string;
     walletProvider?: GlideDepositWalletProvider;
+    solanaWalletProvider?: GlideSolanaWalletProvider;
     localStorageProvider?: GlideLocalStorageProvider;
     onOpen?: () => void;
     onSuccess?: (fulfillmentTxHash: Hex, session: Session) => void;
@@ -138,10 +150,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/dist/pkg/useGlideBuy.d.ts

@@ -1,4 +1,4 @@
-import { FundingSource, GlideDepositWalletProvider, GlideLocalStorageProvider, Hex, ShowAppLogo, DebitCardAlias } from './GlideDeposit.ts';
+import { FundingSource, GlideDepositWalletProvider, GlideSolanaWalletProvider, GlideLocalStorageProvider, Hex, ShowAppLogo, DebitCardAlias } from './GlideDeposit.ts';
 import { GlideWidgetTheme } from './theme.ts';
 import { CAIP2, Session } from '@paywithglide/glide-js';
 interface UseGlideBuyProps {
@@ -18,6 +18,7 @@ interface UseGlideBuyProps {
     copyOverrides?: Record<string, string>;
     theme?: GlideWidgetTheme;
     walletProvider?: GlideDepositWalletProvider;
+    solanaWalletProvider?: GlideSolanaWalletProvider;
     localStorageProvider?: GlideLocalStorageProvider;
     onOpen?: () => void;
     onSuccess?: (hash: Hex, session: Session) => void;
@@ -25,7 +26,7 @@ interface UseGlideBuyProps {
     autoCloseOnSuccess?: boolean;
     baseUrl?: string;
 }
-export declare const useGlideBuy: ({ app, recipient, chainId, currencyId, preferGaslessPayment, chainIds, excludeChainIds, excludeCurrencyTiers, excludeFundingSources, sessionMetadata, showAppLogo, showOnrampFirst, debitCardAlias, copyOverrides, theme, walletProvider, localStorageProvider, onOpen, onSuccess, onClose, autoCloseOnSuccess, baseUrl, }: UseGlideBuyProps) => {
+export declare const useGlideBuy: ({ app, recipient, chainId, currencyId, preferGaslessPayment, chainIds, excludeChainIds, excludeCurrencyTiers, excludeFundingSources, sessionMetadata, showAppLogo, showOnrampFirst, debitCardAlias, copyOverrides, theme, walletProvider, solanaWalletProvider, localStorageProvider, onOpen, onSuccess, onClose, autoCloseOnSuccess, baseUrl, }: UseGlideBuyProps) => {
     openGlideBuy: () => void;
     externalUrl: string;
     opts: import('./GlideDeposit.ts').GlideDepositOptions;

package/dist/pkg/useGlideCall.d.ts

@@ -1,4 +1,4 @@
-import { FundingSource, GlideDepositWalletProvider, GlideLocalStorageProvider, Hex, ShowAppLogo, DebitCardAlias } from './GlideDeposit.ts';
+import { FundingSource, GlideDepositWalletProvider, GlideSolanaWalletProvider, GlideLocalStorageProvider, Hex, ShowAppLogo, DebitCardAlias } from './GlideDeposit.ts';
 import { GlideWidgetTheme } from './theme.ts';
 import { CAIP2, Session } from '@paywithglide/glide-js';
 interface UseGlideCallProps {
@@ -25,6 +25,7 @@ interface UseGlideCallProps {
     copyOverrides?: Record<string, string>;
     theme?: GlideWidgetTheme;
     walletProvider?: GlideDepositWalletProvider;
+    solanaWalletProvider?: GlideSolanaWalletProvider;
     localStorageProvider?: GlideLocalStorageProvider;
     onOpen?: () => void;
     onSuccess?: (hash: Hex, session: Session) => void;
@@ -34,7 +35,7 @@ interface UseGlideCallProps {
     baseUrl?: string;
     debug?: boolean;
 }
-export declare const useGlideCall: ({ app, evm, approval, preferGaslessPayment, chainIds, excludeChainIds, excludeCurrencyTiers, excludeFundingSources, sessionMetadata, showAppLogo, showOnrampFirst, debitCardAlias, copyOverrides, theme, walletProvider, localStorageProvider, onOpen, onSuccess, onClose, autoCloseOnSuccess, popupsBlocked, baseUrl, debug, }: UseGlideCallProps) => {
+export declare const useGlideCall: ({ app, evm, approval, preferGaslessPayment, chainIds, excludeChainIds, excludeCurrencyTiers, excludeFundingSources, sessionMetadata, showAppLogo, showOnrampFirst, debitCardAlias, copyOverrides, theme, walletProvider, solanaWalletProvider, localStorageProvider, onOpen, onSuccess, onClose, autoCloseOnSuccess, popupsBlocked, baseUrl, debug, }: UseGlideCallProps) => {
     openGlideCall: () => void;
     externalUrl: string;
     opts: import('./GlideDeposit.ts').GlideDepositOptions;

package/dist/pkg/useGlideDeposit.d.ts

@@ -1,4 +1,4 @@
-import { FundingSource, GlideDepositWalletProvider, GlideLocalStorageProvider, ShowAppLogo, DebitCardAlias } from './GlideDeposit.ts';
+import { FundingSource, GlideDepositWalletProvider, GlideSolanaWalletProvider, GlideLocalStorageProvider, ShowAppLogo, DebitCardAlias } from './GlideDeposit.ts';
 import { GlideWidgetTheme } from './theme.ts';
 import { CAIP2, Hex, Session } from '@paywithglide/glide-js';
 interface UseGlideDepositProps {
@@ -34,6 +34,7 @@ interface UseGlideDepositProps {
     disableWithdrawToSelfSuggestion?: boolean;
     theme?: GlideWidgetTheme;
     walletProvider?: GlideDepositWalletProvider;
+    solanaWalletProvider?: GlideSolanaWalletProvider;
     localStorageProvider?: GlideLocalStorageProvider;
     onOpen?: () => void;
     onSuccess?: (hash: Hex, session: Session) => void;
@@ -43,7 +44,7 @@ interface UseGlideDepositProps {
     baseUrl?: string;
     debug?: boolean;
 }
-export declare const useGlideDeposit: ({ app, recipient, chainId, currencyId, amount, gasRefuelAmountPerChain, preferGaslessPayment, chainIds, excludeChainIds, excludeCurrencyTiers, excludeFundingSources, fundingSources, appMetadata, enableRefundEmails, payerEmail, mode, hideSettlementCopy, showAppLogo, showOnrampFirst, debitCardAlias, copyOverrides, stableDepositAddressKey, sessionId, sessionMetadata, disableWithdrawToSelfSuggestion, theme, walletProvider, localStorageProvider, onOpen, onSuccess, onClose, autoCloseOnSuccess, popupsBlocked, baseUrl, debug, }: UseGlideDepositProps) => {
+export declare const useGlideDeposit: ({ app, recipient, chainId, currencyId, amount, gasRefuelAmountPerChain, preferGaslessPayment, chainIds, excludeChainIds, excludeCurrencyTiers, excludeFundingSources, fundingSources, appMetadata, enableRefundEmails, payerEmail, mode, hideSettlementCopy, showAppLogo, showOnrampFirst, debitCardAlias, copyOverrides, stableDepositAddressKey, sessionId, sessionMetadata, disableWithdrawToSelfSuggestion, theme, walletProvider, solanaWalletProvider, localStorageProvider, onOpen, onSuccess, onClose, autoCloseOnSuccess, popupsBlocked, baseUrl, debug, }: UseGlideDepositProps) => {
     openGlideDeposit: () => void;
     externalUrl: string;
     opts: import('./GlideDeposit.ts').GlideDepositOptions;

package/dist/pkg/useGlidePay.d.ts

@@ -1,4 +1,4 @@
-import { FundingSource, GlideDepositWalletProvider, GlideLocalStorageProvider, ShowAppLogo, DebitCardAlias } from './GlideDeposit.ts';
+import { FundingSource, GlideDepositWalletProvider, GlideSolanaWalletProvider, GlideLocalStorageProvider, ShowAppLogo, DebitCardAlias } from './GlideDeposit.ts';
 import { GlideWidgetTheme } from './theme.ts';
 import { CAIP2, Hex, Session } from '@paywithglide/glide-js';
 type UseGlidePayProps = {
@@ -27,6 +27,7 @@ type UseGlidePayProps = {
     sessionMetadata?: string;
     theme?: GlideWidgetTheme;
     walletProvider?: GlideDepositWalletProvider;
+    solanaWalletProvider?: GlideSolanaWalletProvider;
     localStorageProvider?: GlideLocalStorageProvider;
     onOpen?: () => void;
     onSuccess?: (hash: Hex, session: Session) => void;
@@ -36,7 +37,7 @@ type UseGlidePayProps = {
     baseUrl?: string;
     debug?: boolean;
 };
-export declare const useGlidePay: ({ app, preferGaslessPayment, chainIds, excludeChainIds, excludeCurrencyTiers, excludeFundingSources, fundingSources, allowedPaymentCurrencies, appMetadata, enableRefundEmails, payerEmail, hideSettlementCopy, showAppLogo, showOnrampFirst, debitCardAlias, copyOverrides, amount, sessionId, sessionMetadata, theme, walletProvider, localStorageProvider, onOpen, onSuccess, onClose, autoCloseOnSuccess, popupsBlocked, baseUrl, debug, }: UseGlidePayProps) => {
+export declare const useGlidePay: ({ app, preferGaslessPayment, chainIds, excludeChainIds, excludeCurrencyTiers, excludeFundingSources, fundingSources, allowedPaymentCurrencies, appMetadata, enableRefundEmails, payerEmail, hideSettlementCopy, showAppLogo, showOnrampFirst, debitCardAlias, copyOverrides, amount, sessionId, sessionMetadata, theme, walletProvider, solanaWalletProvider, localStorageProvider, onOpen, onSuccess, onClose, autoCloseOnSuccess, popupsBlocked, baseUrl, debug, }: UseGlidePayProps) => {
     openGlidePay: () => void;
     externalUrl: string;
     opts: import('./GlideDeposit.ts').GlideDepositOptions;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paywithglide/glide-react",
-  "version": "0.0.46",
+  "version": "0.0.48",
   "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,11 +29,16 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@paywithglide/glide-js": "0.13.10"
+    "@paywithglide/glide-js": "0.13.32"
   },
   "devDependencies": {
     "@antiwork/shortest": "^0.2.1",
     "@eslint/js": "^9.15.0",
+    "@privy-io/react-auth": "^3.10.1",
+    "@solana-program/memo": "^0.10.0",
+    "@solana-program/system": "^0.10.0",
+    "@solana-program/token": "^0.9.0",
+    "@solana/kit": "^5.1.0",
     "@tanstack/react-query": "^5.61.5",
     "@types/chrome": "^0.0.299",
     "@types/react": "^18.3.12",