@blazium/ton-connect-mobile 1.0.0 → 1.0.1

package/README.md

@@ -10,6 +10,7 @@ Production-ready TON Connect Mobile SDK for React Native and Expo. This SDK impl
 - ✅ **Transaction Signing** - Send and sign transactions
 - ✅ **Signature Verification** - Verifies wallet signatures
 - ✅ **Cross-Platform** - Works with Expo Managed, Expo Bare, and React Native CLI
+- ⚠️ **Web Limitation** - Deep links (`tonconnect://`) only work on mobile devices (Android/iOS), not in web browsers
 - ✅ **TypeScript** - Fully typed with TypeScript
 - ✅ **Production Ready** - No placeholders, no mocks, ready for production use
 
@@ -125,6 +126,21 @@ try {
 }
 ```
 
+### Platform Support
+
+**⚠️ Important**: TON Connect deep links (`tonconnect://`) only work on **mobile devices** (Android/iOS). They do not work in web browsers.
+
+- ✅ **Android**: Full support via Expo or React Native CLI
+- ✅ **iOS**: Full support via Expo or React Native CLI  
+- ⚠️ **Web**: Deep links are not supported. The SDK will throw a clear error message if you try to use it in a web browser.
+
+**Why?** The `tonconnect://` protocol is a custom URI scheme that requires a mobile app handler. Web browsers cannot handle these custom protocols.
+
+**Testing**: To test wallet connections, use:
+- Android device or emulator
+- iOS device or simulator
+- Not web browsers
+
 ### Disconnect
 
 ```typescript

package/dist/adapters/web.js

@@ -45,18 +45,26 @@ class WebAdapter {
     async openURL(url) {
         try {
             if (typeof window !== 'undefined') {
-                // For web, we can use window.open or window.location
-                // For deep links to mobile wallets, we'll use window.location
+                // For web, tonconnect:// deep links don't work
+                // They only work on mobile devices (Android/iOS)
                 if (url.startsWith('tonconnect://')) {
-                    // Try to open in new window/tab, fallback to current window
-                    const opened = window.open(url, '_blank');
-                    if (!opened) {
-                        // Popup blocked, try current window
-                        window.location.href = url;
+                    // Show user-friendly error message
+                    const errorMessage = 'TON Connect deep links only work on mobile devices (Android/iOS).\n\n' +
+                        'Please test this on a mobile device or use the mobile app.\n\n' +
+                        'Deep link: ' + url.substring(0, 100) + '...';
+                    // Try to show alert (if available)
+                    if (typeof window.alert !== 'undefined') {
+                        window.alert(errorMessage);
                     }
-                    return true;
+                    else {
+                        console.error('TON Connect Web Error:', errorMessage);
+                    }
+                    // Throw error so SDK can handle it properly
+                    throw new Error('TON Connect deep links are not supported in web browsers. ' +
+                        'Please use this SDK on a mobile device (Android/iOS) or test with a mobile app.');
                 }
                 else {
+                    // Regular HTTP/HTTPS URLs work fine
                     window.location.href = url;
                     return true;
                 }
@@ -64,7 +72,8 @@ class WebAdapter {
             return false;
         }
         catch (error) {
-            return false;
+            // Re-throw the error so SDK can handle it
+            throw error;
         }
     }
     async getInitialURL() {

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@blazium/ton-connect-mobile",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Production-ready TON Connect Mobile SDK for React Native and Expo. Implements the real TonConnect protocol for mobile applications using deep links and callbacks.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "repository": {
     "type": "git",
-    "url": "https://github.com/blaziumdev/ton-connect-mobile.git"
+    "url": "git+https://github.com/blaziumdev/ton-connect-mobile.git"
   },
   "scripts": {
     "build": "tsc",

package/src/adapters/web.ts

@@ -11,6 +11,7 @@ declare const window: {
   open(url: string, target?: string): any;
   addEventListener(type: string, listener: () => void): void;
   removeEventListener(type: string, listener: () => void): void;
+  alert(message: string): void;
   localStorage: {
     setItem(key: string, value: string): void;
     getItem(key: string): string | null;
@@ -68,24 +69,37 @@ export class WebAdapter implements PlatformAdapter {
   async openURL(url: string): Promise<boolean> {
     try {
       if (typeof window !== 'undefined') {
-        // For web, we can use window.open or window.location
-        // For deep links to mobile wallets, we'll use window.location
+        // For web, tonconnect:// deep links don't work
+        // They only work on mobile devices (Android/iOS)
         if (url.startsWith('tonconnect://')) {
-          // Try to open in new window/tab, fallback to current window
-          const opened = window.open(url, '_blank');
-          if (!opened) {
-            // Popup blocked, try current window
-            window.location.href = url;
+          // Show user-friendly error message
+          const errorMessage = 
+            'TON Connect deep links only work on mobile devices (Android/iOS).\n\n' +
+            'Please test this on a mobile device or use the mobile app.\n\n' +
+            'Deep link: ' + url.substring(0, 100) + '...';
+          
+          // Try to show alert (if available)
+          if (typeof window.alert !== 'undefined') {
+            window.alert(errorMessage);
+          } else {
+            console.error('TON Connect Web Error:', errorMessage);
           }
-          return true;
+          
+          // Throw error so SDK can handle it properly
+          throw new Error(
+            'TON Connect deep links are not supported in web browsers. ' +
+            'Please use this SDK on a mobile device (Android/iOS) or test with a mobile app.'
+          );
         } else {
+          // Regular HTTP/HTTPS URLs work fine
           window.location.href = url;
           return true;
         }
       }
       return false;
     } catch (error) {
-      return false;
+      // Re-throw the error so SDK can handle it
+      throw error;
     }
   }