@tonconnect/ui 0.0.14 → 0.0.16

package/lib/index.d.ts

@@ -111,6 +111,12 @@ declare type WalletsListConfigurationImplicit = {
     includeWalletsOrder?: 'start' | 'end';
 };
 
+/**
+ * Specifies return strategy for the deeplink when user signs/declines the request.
+ * [See details]{@link https://github.com/ton-connect/docs/blob/main/bridge.md#universal-link}.
+ */
+declare type ReturnStrategy = 'back' | 'none' | `${string}://${string}`;
+
 interface ActionConfiguration {
     /**
      * Configure action modals behavior.
@@ -122,6 +128,11 @@ interface ActionConfiguration {
      * @default 'all'
      */
     notifications?: ('before' | 'success' | 'error')[] | 'all';
+    /**
+     * Specifies return strategy for the deeplink when user signs/declines the request.
+     * @default 'back'
+     */
+    returnStrategy?: ReturnStrategy;
 }
 
 interface TonConnectUiOptions {
@@ -144,7 +155,7 @@ interface TonConnectUiOptions {
      */
     walletsList?: WalletsListConfiguration;
     /**
-     * Configuration for action-period (e.g. sendTransaction) UI elements: modals and notifications.
+     * Configuration for action-period (e.g. sendTransaction) UI elements: modals and notifications and wallet behaviour (return strategy).
      */
     actionsConfiguration?: ActionConfiguration;
 }
@@ -265,4 +276,4 @@ declare class TonConnectUIError extends TonConnectError {
     constructor(...args: ConstructorParameters<typeof Error>);
 }
 
-export { ActionConfiguration, BorderRadius, Color, ColorsSet, ConnectedWallet, Locales, PartialColorsSet, THEME, Theme, TonConnectUI, TonConnectUIError, TonConnectUiCreateOptions, TonConnectUiCreateOptionsBase, TonConnectUiOptions, TonConnectUiOptionsWithConnector, TonConnectUiOptionsWithManifest, UIPreferences, UIWallet, WalletInfoRemoteWithOpenMethod, WalletInfoWithOpenMethod, WalletOpenMethod, WalletsListConfiguration, WalletsListConfigurationExplicit, WalletsListConfigurationImplicit, TonConnectUI as default };
+export { ActionConfiguration, BorderRadius, Color, ColorsSet, ConnectedWallet, Locales, PartialColorsSet, ReturnStrategy, THEME, Theme, TonConnectUI, TonConnectUIError, TonConnectUiCreateOptions, TonConnectUiCreateOptionsBase, TonConnectUiOptions, TonConnectUiOptionsWithConnector, TonConnectUiOptionsWithManifest, UIPreferences, UIWallet, WalletInfoRemoteWithOpenMethod, WalletInfoWithOpenMethod, WalletOpenMethod, WalletsListConfiguration, WalletsListConfigurationExplicit, WalletsListConfigurationImplicit, TonConnectUI as default };

package/lib/index.js

@@ -3076,10 +3076,12 @@ class BridgeProvider {
     this.storage = storage;
     this.walletConnectionSource = walletConnectionSource;
     this.type = "http";
+    this.standardUniversalLink = "https://connect.ton.org";
     this.pendingRequests = /* @__PURE__ */ new Map();
     this.nextRequestId = 0;
     this.session = null;
     this.bridge = null;
+    this.pendingBridges = [];
     this.listeners = [];
     this.connectionStorage = new BridgeConnectionStorage(storage);
   }
@@ -3091,21 +3093,32 @@ class BridgeProvider {
     });
   }
   connect(message) {
-    var _a;
-    (_a = this.bridge) === null || _a === void 0 ? void 0 : _a.close();
+    this.closeBridges();
     const sessionCrypto = new SessionCrypto();
+    let walletConnectionSource = {
+      universalLink: this.standardUniversalLink,
+      bridgeUrl: ""
+    };
+    if (Array.isArray(this.walletConnectionSource)) {
+      this.pendingBridges = this.walletConnectionSource.map((source) => new BridgeGateway(this.storage, source, sessionCrypto.sessionId, this.gatewayListener.bind(this), this.gatewayErrorsListener.bind(this)));
+      this.pendingBridges.forEach((bridge) => bridge.registerSession());
+    } else {
+      walletConnectionSource = this.walletConnectionSource;
+      this.bridge = new BridgeGateway(this.storage, this.walletConnectionSource.bridgeUrl, sessionCrypto.sessionId, this.gatewayListener.bind(this), this.gatewayErrorsListener.bind(this));
+      this.bridge.registerSession();
+    }
     this.session = {
       sessionCrypto,
-      walletConnectionSource: this.walletConnectionSource
+      walletConnectionSource
     };
-    this.bridge = new BridgeGateway(this.storage, this.walletConnectionSource.bridgeUrl, sessionCrypto.sessionId, this.gatewayListener.bind(this), this.gatewayErrorsListener.bind(this));
-    this.bridge.registerSession();
-    return this.generateUniversalLink(message);
+    return this.generateUniversalLink(walletConnectionSource.universalLink, message);
   }
   restoreConnection() {
-    var _a;
     return __awaiter$4(this, void 0, void 0, function* () {
-      (_a = this.bridge) === null || _a === void 0 ? void 0 : _a.close();
+      if (Array.isArray(this.walletConnectionSource)) {
+        throw new TonConnectError("Internal error. Connection source is array while WalletConnectionSourceHTTP was expected.");
+      }
+      this.closeBridges();
       const storedConnection = yield this.connectionStorage.getHttpConnection();
       if (!storedConnection) {
         return;
@@ -3129,15 +3142,13 @@ class BridgeProvider {
     });
   }
   closeConnection() {
-    var _a;
-    (_a = this.bridge) === null || _a === void 0 ? void 0 : _a.close();
+    this.closeBridges();
     this.listeners = [];
     this.session = null;
     this.bridge = null;
   }
   disconnect() {
-    var _a;
-    (_a = this.bridge) === null || _a === void 0 ? void 0 : _a.close();
+    this.closeBridges();
     this.listeners = [];
     return this.removeBridgeAndSession();
   }
@@ -3145,6 +3156,18 @@ class BridgeProvider {
     this.listeners.push(callback);
     return () => this.listeners = this.listeners.filter((listener) => listener !== callback);
   }
+  pendingGatewaysListener(gateway, bridgeIncomingMessage) {
+    return __awaiter$4(this, void 0, void 0, function* () {
+      if (!this.pendingBridges.includes(gateway)) {
+        gateway.close();
+        return;
+      }
+      this.closeBridges();
+      this.session.walletConnectionSource.bridgeUrl = gateway.bridgeUrl;
+      this.bridge = gateway;
+      return this.gatewayListener(bridgeIncomingMessage);
+    });
+  }
   gatewayListener(bridgeIncomingMessage) {
     return __awaiter$4(this, void 0, void 0, function* () {
       const walletMessage = JSON.parse(this.session.sessionCrypto.decrypt(Base64.decode(bridgeIncomingMessage.message).toUint8Array(), hexToByteArray(bridgeIncomingMessage.from)));
@@ -3191,13 +3214,19 @@ class BridgeProvider {
       yield this.connectionStorage.removeConnection();
     });
   }
-  generateUniversalLink(message) {
-    const url = new URL(this.walletConnectionSource.universalLink);
+  generateUniversalLink(universalLink, message) {
+    const url = new URL(universalLink);
     url.searchParams.append("v", PROTOCOL_VERSION.toString());
     url.searchParams.append("id", this.session.sessionCrypto.sessionId);
     url.searchParams.append("r", JSON.stringify(message));
     return url.toString();
   }
+  closeBridges(except) {
+    var _a;
+    (_a = this.bridge) === null || _a === void 0 ? void 0 : _a.close();
+    this.pendingBridges.filter((item) => item !== except).forEach((bridge) => bridge.close());
+    this.pendingBridges = [];
+  }
 }
 function getWindow$1() {
   if (typeof window === "undefined") {
@@ -3681,7 +3710,7 @@ class TonConnect {
   }
   createProvider(wallet) {
     let provider;
-    if (isWalletConnectionSourceJS(wallet)) {
+    if (!Array.isArray(wallet) && isWalletConnectionSourceJS(wallet)) {
       provider = new InjectedProvider(this.dappSettings.storage, wallet.jsBridgeKey);
     } else {
       provider = new BridgeProvider(this.dappSettings.storage, wallet);
@@ -4876,6 +4905,10 @@ function render(code, element, init, options = {}) {
   };
 }
 function template$1(html, check, isSVG) {
+  if (typeof window === 'undefined') {
+    return null;
+  }
+
   const t2 = document.createElement("template");
   t2.innerHTML = html;
   let node = t2.content.firstChild;
@@ -10158,6 +10191,20 @@ function subscribeToThemeChange(callback) {
   window.matchMedia("(prefers-color-scheme: dark)").addEventListener("change", handler);
   return () => window.matchMedia("(prefers-color-scheme: dark)").removeEventListener("change", handler);
 }
+function addQueryParameter(url, key, value) {
+  const parsed = new URL(url);
+  parsed.searchParams.append(key, value);
+  return parsed.toString();
+}
+function addReturnStrategy(url, returnStrategy) {
+  return addQueryParameter(url, "ret", returnStrategy);
+}
+const [appState, setAppState] = createStore({
+  buttonRootId: null,
+  language: "en",
+  returnStrategy: "back",
+  walletsList: {}
+});
 const QrCodeModal = (props) => {
   const connector = useContext(ConnectorContext);
   const universalLink = connector.connect({
@@ -10208,7 +10255,7 @@ const QrCodeModal = (props) => {
               setLastSelectedWalletInfo(__spreadProps(__spreadValues({}, props.wallet), {
                 openMethod: "universal-link"
               }));
-              openLink(universalLink);
+              openLink(addReturnStrategy(universalLink, appState.returnStrategy));
             },
             get children() {
               return createComponent(Translation, {
@@ -10448,11 +10495,6 @@ const LoaderContainerStyled = styled.div`
         align-items: center;
     }
 `;
-const [appState, setAppState] = createStore({
-  buttonRootId: null,
-  language: "en",
-  walletsList: {}
-});
 function uiWalletToWalletInfo(uiWallet) {
   if ("jsBridgeKey" in uiWallet) {
     return __spreadProps(__spreadValues({}, uiWallet), {
@@ -10556,14 +10598,14 @@ const WalletsModal = () => {
       setSelectedWalletInfo(walletInfo);
       return;
     }
-    openLink(walletInfo.aboutUrl, "_blank");
+    openLinkBlank(walletInfo.aboutUrl);
   };
   const onSelectIfMobile = (walletInfo) => {
     const universalLink = connector.connect({
       universalLink: walletInfo.universalLink,
       bridgeUrl: walletInfo.bridgeUrl
     }, additionalRequest());
-    openLink(universalLink);
+    openLink(addReturnStrategy(universalLink, appState.returnStrategy));
   };
   const onSelectIfInjected = (walletInfo) => {
     connector.connect({
@@ -10855,7 +10897,7 @@ class WalletInfoStorage {
   constructor() {
     __publicField(this, "localStorage");
     __publicField(this, "storageKey", "ton-connect-ui_wallet-info");
-    if (!localStorage) {
+    if (typeof localStorage === "undefined") {
       throw new TonConnectUIError(
         "window.localStorage is undefined. localStorage is required for TonConnectUI"
       );
@@ -10953,8 +10995,11 @@ class TonConnectUI {
       setBorderRadius(options.uiPreferences.borderRadius);
     }
     setAppState((state) => {
+      var _a2;
       const merged = mergeOptions(
-        __spreadValues(__spreadValues({}, options.language && { language: options.language }), !!options.walletsList && { walletsList: options.walletsList }),
+        __spreadValues(__spreadValues(__spreadValues({}, options.language && { language: options.language }), !!((_a2 = options.actionsConfiguration) == null ? void 0 : _a2.returnStrategy) && {
+          returnStrategy: options.actionsConfiguration.returnStrategy
+        }), !!options.walletsList && { walletsList: options.walletsList }),
         unwrap(state)
       );
       if (options.buttonRootId !== void 0) {
@@ -11014,10 +11059,10 @@ class TonConnectUI {
       if (!this.connected || !this.walletInfo) {
         throw new TonConnectUIError("Connect wallet to send a transaction.");
       }
+      const { notifications: notifications2, modals, returnStrategy } = this.getModalsAndNotificationsConfiguration(options);
       if ("universalLink" in this.walletInfo && this.walletInfo.openMethod === "universal-link") {
-        openLink(this.walletInfo.universalLink);
+        openLink(addReturnStrategy(this.walletInfo.universalLink, returnStrategy));
       }
-      const { notifications: notifications2, modals } = this.getModalsAndNotificationsConfiguration(options);
       widgetController.setAction({
         name: "confirm-transaction",
         showNotification: notifications2.includes("before"),
@@ -11116,7 +11161,8 @@ class TonConnectUI {
     }
     return {
       notifications: notifications2,
-      modals
+      modals,
+      returnStrategy: (options == null ? void 0 : options.returnStrategy) || "back"
     };
   }
 }