@metamask/connect-multichain 0.11.0 → 0.12.0

package/CHANGELOG.md

@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.12.0]
+
+### Added
+
+- Include `analytics.remote_session_id` in V2 connection metadata so the wallet can correlate dapp-side and wallet-side analytics events ([#256](https://github.com/MetaMask/connect-monorepo/pull/256))
+
+## [0.11.1]
+
+### Changed
+
+- chore: align sub-package licenses with root ConsenSys 2022 license ([#241](https://github.com/MetaMask/connect-monorepo/pull/241))
+- chore: turborepo ([#239](https://github.com/MetaMask/connect-monorepo/pull/239))
+
+### Fixed
+
+- `MWPTransport.connect()` now accepts and forwards a `forceRequest` option. When `true`, `onResumeSuccess` skips the `isSameScopesAndAccounts` check and unconditionally sends `wallet_createSession`, allowing consumers to re-prompt account selection on an existing MWP session. Previously `forceRequest` was silently ignored, causing `wallet_requestPermissions` to no-op on mobile. ([#243](https://github.com/MetaMask/connect-monorepo/pull/243))
+- Fix platform detection for Hermes-based React Native apps: `isReactNative()` now checks `global.navigator.product` before `window.navigator.product`, so modern RN environments where `window` is undefined correctly resolve to `PlatformType.ReactNative` instead of `PlatformType.NonBrowser`. This restores analytics for all React Native consumers — analytics were silently disabled because `#setupAnalytics()` only calls `analytics.enable()` for browser and `ReactNative` platforms ([#238](https://github.com/MetaMask/connect-monorepo/pull/238))
+
 ## [0.11.0]
 
 ### Changed
@@ -227,7 +245,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Initial release
 
-[Unreleased]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-multichain@0.11.0...HEAD
+[Unreleased]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-multichain@0.12.0...HEAD
+[0.12.0]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-multichain@0.11.1...@metamask/connect-multichain@0.12.0
+[0.11.1]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-multichain@0.11.0...@metamask/connect-multichain@0.11.1
 [0.11.0]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-multichain@0.10.0...@metamask/connect-multichain@0.11.0
 [0.10.0]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-multichain@0.9.0...@metamask/connect-multichain@0.10.0
 [0.9.0]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-multichain@0.8.0...@metamask/connect-multichain@0.9.0

package/LICENSE

@@ -1,20 +1,18 @@
-MIT License
-
-Copyright (c) 2025 MetaMask
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+Copyright ConsenSys Software Inc. 2022. All rights reserved.
+ 
+You acknowledge and agree that ConsenSys Software Inc. ("ConsenSys") (or ConsenSys's licensors) own all legal right, title and interest in and to the work, software, application, source code, documentation and any other documents in this repository (collectively, the "Program"), including any intellectual property rights which subsist in the Program (whether those rights happen to be registered or not, and wherever in the world those rights may exist), whether in source code or any other form.
+ 
+Subject to the limited license below, you may not (and you may not permit anyone else to) distribute, publish, copy, modify, merge, combine with another program, create derivative works of, reverse engineer, decompile or otherwise attempt to extract the source code of, the Program or any part thereof, except that you may contribute to this repository.
+ 
+You are granted a non-exclusive, non-transferable, non-sublicensable license to distribute, publish, copy, modify, merge, combine with another program or create derivative works of the Program (such resulting program, collectively, the "Resulting Program") solely for Non-Commercial Use as long as you:
+ 1. give prominent notice ("Notice") with each copy of the Resulting Program that the Program is used in the Resulting Program and that the Program is the copyright of ConsenSys; and
+ 2. subject the Resulting Program and any distribution, publication, copy, modification, merger therewith, combination with another program or derivative works thereof to the same Notice requirement and Non-Commercial Use restriction set forth herein.
+ 
+"Non-Commercial Use" means each use as described in clauses (1)-(3) below, as reasonably determined by ConsenSys in its sole discretion: 
+ 1. personal use for research, personal study, private entertainment, hobby projects or amateur pursuits, in each case without any anticipated commercial application;
+ 2. use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization or government institution; or
+ 3. the number of monthly active users of the Resulting Program across all versions thereof and platforms globally do not exceed 10,000 at any time.
+ 
+You will not use any trade mark, service mark, trade name, logo of ConsenSys or any other company or organization in a way that is likely or intended to cause confusion about the owner or authorized user of such marks, names or logos.
+ 
+If you have any questions, comments or interest in pursuing any other use cases, please reach out to us at metamask.license@consensys.net.

package/dist/browser/es/connect-multichain.d.mts

@@ -393,6 +393,9 @@ type ConnectionRequest = {
             version: string;
             platform: PlatformType;
         };
+        analytics?: {
+            remote_session_id: string;
+        };
     };
 };
 /**

package/dist/browser/es/connect-multichain.mjs

@@ -506,26 +506,21 @@ var init_multichain = __esm({
 // src/domain/platform/index.ts
 import Bowser from "bowser";
 function isNotBrowser() {
-  var _a3;
   if (typeof window === "undefined") {
     return true;
   }
   if (!(window == null ? void 0 : window.navigator)) {
     return true;
   }
-  if (typeof global !== "undefined" && ((_a3 = global == null ? void 0 : global.navigator) == null ? void 0 : _a3.product) === "ReactNative") {
-    return true;
-  }
   return (navigator == null ? void 0 : navigator.product) === "ReactNative";
 }
 function isReactNative() {
-  var _a3;
-  const hasWindowNavigator = typeof window !== "undefined" && window.navigator !== void 0;
-  const nav = hasWindowNavigator ? window.navigator : void 0;
-  if (!nav) {
-    return false;
+  var _a3, _b;
+  if (typeof global !== "undefined" && ((_a3 = global == null ? void 0 : global.navigator) == null ? void 0 : _a3.product) === "ReactNative") {
+    return true;
   }
-  return hasWindowNavigator && ((_a3 = window.navigator) == null ? void 0 : _a3.product) === "ReactNative";
+  const hasWindowNavigator = typeof window !== "undefined" && window.navigator !== void 0;
+  return hasWindowNavigator && ((_b = window.navigator) == null ? void 0 : _b.product) === "ReactNative";
 }
 function isMetaMaskMobileWebView() {
   return typeof window !== "undefined" && // @ts-expect-error ReactNativeWebView should be defined
@@ -2262,7 +2257,7 @@ var MWPTransport = class {
             walletSession,
             proposedCaipAccountIds
           );
-          if (!hasSameScopesAndAccounts) {
+          if (options.forceRequest || !hasSameScopesAndAccounts) {
             const optionalScopes = addValidAccounts(
               getOptionalScopes((_d = options == null ? void 0 : options.scopes) != null ? _d : []),
               getValidAccounts((_e = options == null ? void 0 : options.caipAccountIds) != null ? _e : [])
@@ -2745,7 +2740,7 @@ var keymanager = new KeyManager();
 init_utils2();
 var logger2 = createLogger("metamask-sdk:core");
 var SINGLETON_KEY = "__METAMASK_CONNECT_MULTICHAIN_SINGLETON__";
-var _a2, _provider, _providerTransportWrapper, _transport2, _dappClient, _beforeUnloadListener, _listener, _sdkInfo, _MetaMaskConnectMultichain_instances, setupAnalytics_fn, onTransportNotification_fn, getStoredTransport_fn, setupTransport_fn, init_fn2, createDappClient_fn, setupMWP_fn, onBeforeUnload_fn, createBeforeUnloadListener_fn, renderInstallModalAsync_fn, showInstallModal_fn, headlessConnect_fn, setupDefaultTransport_fn, deeplinkConnect_fn, handleConnection_fn, getCaipSession_fn, openConnectDeeplinkIfNeeded_fn;
+var _a2, _provider, _providerTransportWrapper, _transport2, _dappClient, _beforeUnloadListener, _listener, _anonId, _sdkInfo, _MetaMaskConnectMultichain_instances, setupAnalytics_fn, onTransportNotification_fn, getStoredTransport_fn, setupTransport_fn, buildConnectionMetadata_fn, init_fn2, createDappClient_fn, setupMWP_fn, onBeforeUnload_fn, createBeforeUnloadListener_fn, renderInstallModalAsync_fn, showInstallModal_fn, headlessConnect_fn, setupDefaultTransport_fn, deeplinkConnect_fn, handleConnection_fn, getCaipSession_fn, openConnectDeeplinkIfNeeded_fn;
 var _MetaMaskConnectMultichain = class _MetaMaskConnectMultichain extends MultichainCore {
   constructor(options) {
     var _a3, _b, _c, _d, _e, _f;
@@ -2763,7 +2758,7 @@ var _MetaMaskConnectMultichain = class _MetaMaskConnectMultichain extends Multic
       versions: __spreadValues({
         // typeof guard needed: Metro (React Native) bundles TS source directly,
         // bypassing the tsup build that substitutes __PACKAGE_VERSION__.
-        "connect-multichain": false ? "unknown" : "0.11.0"
+        "connect-multichain": false ? "unknown" : "0.12.0"
       }, (_f = options.versions) != null ? _f : {})
     });
     super(allOptions);
@@ -2775,6 +2770,7 @@ var _MetaMaskConnectMultichain = class _MetaMaskConnectMultichain extends Multic
     __privateAdd(this, _beforeUnloadListener);
     this._status = "pending";
     __privateAdd(this, _listener);
+    __privateAdd(this, _anonId);
     __privateAdd(this, _sdkInfo, `Sdk/Javascript SdkVersion/${getVersion()} Platform/${getPlatformType()} dApp/${(_a2 = this.options.dapp.url) != null ? _a2 : this.options.dapp.name} dAppTitle/${this.options.dapp.name}`);
     __privateSet(this, _providerTransportWrapper, new MultichainApiClientWrapperTransport(
       this
@@ -3034,6 +3030,7 @@ _transport2 = new WeakMap();
 _dappClient = new WeakMap();
 _beforeUnloadListener = new WeakMap();
 _listener = new WeakMap();
+_anonId = new WeakMap();
 _sdkInfo = new WeakMap();
 _MetaMaskConnectMultichain_instances = new WeakSet();
 setupAnalytics_fn = function() {
@@ -3047,6 +3044,7 @@ setupAnalytics_fn = function() {
     }
     const dappId = getDappId(this.options.dapp);
     const anonId = yield this.storage.getAnonId();
+    __privateSet(this, _anonId, anonId);
     const { integrationType } = (_a3 = this.options.analytics) != null ? _a3 : {
       integrationType: ""
     };
@@ -3141,6 +3139,16 @@ setupTransport_fn = function() {
     }
   });
 };
+buildConnectionMetadata_fn = function() {
+  const metadata = {
+    dapp: this.options.dapp,
+    sdk: { version: getVersion(), platform: getPlatformType() }
+  };
+  if (__privateGet(this, _anonId)) {
+    metadata.analytics = { remote_session_id: __privateGet(this, _anonId) };
+  }
+  return metadata;
+};
 init_fn2 = function() {
   return __async(this, null, function* () {
     try {
@@ -3221,13 +3229,7 @@ renderInstallModalAsync_fn = function(desktopPreferred, scopes, caipAccountIds,
               (sessionRequest) => {
                 _resolve({
                   sessionRequest,
-                  metadata: {
-                    dapp: this.options.dapp,
-                    sdk: {
-                      version: getVersion(),
-                      platform: getPlatformType()
-                    }
-                  }
+                  metadata: __privateMethod(this, _MetaMaskConnectMultichain_instances, buildConnectionMetadata_fn).call(this)
                 });
               }
             );
@@ -3302,13 +3304,7 @@ headlessConnect_fn = function(scopes, caipAccountIds, sessionProperties) {
         (sessionRequest) => {
           const connectionRequest = {
             sessionRequest,
-            metadata: {
-              dapp: this.options.dapp,
-              sdk: {
-                version: getVersion(),
-                platform: getPlatformType()
-              }
-            }
+            metadata: __privateMethod(this, _MetaMaskConnectMultichain_instances, buildConnectionMetadata_fn).call(this)
           };
           const deeplink = this.options.ui.factory.createConnectionDeeplink(connectionRequest);
           this.emit("display_uri", deeplink);
@@ -3381,10 +3377,7 @@ deeplinkConnect_fn = function(scopes, caipAccountIds, sessionProperties) {
             var _a3;
             const connectionRequest = {
               sessionRequest,
-              metadata: {
-                dapp: this.options.dapp,
-                sdk: { version: getVersion(), platform: getPlatformType() }
-              }
+              metadata: __privateMethod(this, _MetaMaskConnectMultichain_instances, buildConnectionMetadata_fn).call(this)
             };
             const deeplink = this.options.ui.factory.createConnectionDeeplink(
               connectionRequest
@@ -3492,10 +3485,7 @@ openConnectDeeplinkIfNeeded_fn = function() {
     }
     const connectionRequest = {
       sessionRequest: storedSessionRequest,
-      metadata: {
-        dapp: this.options.dapp,
-        sdk: { version: getVersion(), platform: getPlatformType() }
-      }
+      metadata: __privateMethod(this, _MetaMaskConnectMultichain_instances, buildConnectionMetadata_fn).call(this)
     };
     const deeplink = this.options.ui.factory.createConnectionDeeplink(connectionRequest);
     const universalLink = this.options.ui.factory.createConnectionUniversalLink(connectionRequest);