@metamask/connect-multichain 0.4.0 → 0.5.1

package/CHANGELOG.md

@@ -7,6 +7,36 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.1]
+
+### Fixed
+
+- fix: Resolve Buffer polyfill requirement for browser/React Native consumers ([#121](https://github.com/MetaMask/connect-monorepo/pull/121))
+
+## [0.5.0]
+
+### Added
+
+- Add `display_uri` event emission for QR code links to support custom UI implementations ([#130](https://github.com/MetaMask/connect-monorepo/pull/130))
+  - Emitted when QR code link is generated during connection
+  - Emitted when QR code is regenerated on expiration
+  - Emitted for deeplink connections on mobile web
+- Add `onDisplayUri` callback to `InstallWidgetProps` for notifying when QR codes are generated/regenerated ([#130](https://github.com/MetaMask/connect-monorepo/pull/130))
+- Add headless mode support that emits `display_uri` without rendering modal UI ([#130](https://github.com/MetaMask/connect-monorepo/pull/130))
+- Add `sessionProperties` parameter to `connect()` method for passing custom session configuration to wallets([#80](https://github.com/MetaMask/connect-monorepo/pull/80))
+- Introduce `MultichainApiClientWrapperTransport` to provide the provider interface before connection is established([#80](https://github.com/MetaMask/connect-monorepo/pull/80))
+
+### Changed
+
+- **BREAKING** Rename `state` property to `status` on `MultichainCore` for improved clarity ([#125](https://github.com/MetaMask/connect-monorepo/pull/125))
+- **BREAKING** Rename `createMetamaskConnect` to `createMultichainClient` for a cleaner naming convention ([#114](https://github.com/MetaMask/connect-monorepo/pull/114))
+- Provider is now always available via `sdk.provider` regardless of connection state (wrapper handles disconnected state internally)([#80](https://github.com/MetaMask/connect-monorepo/pull/80))
+
+### Fixed
+
+- Fix `wallet_sessionChanged` events subsequent to the initial connection not being persisted ([#100](https://github.com/MetaMask/connect-monorepo/pull/100))
+- Fix hanging when attempting to resume a previous connection initialization in which the wallet does not send any response at all ([#103](https://github.com/MetaMask/connect-monorepo/pull/103))
+
 ## [0.4.0]
 
 ### Changed
@@ -86,7 +116,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.4.0...HEAD
+[Unreleased]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-multichain@0.5.1...HEAD
+[0.5.1]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-multichain@0.5.0...@metamask/connect-multichain@0.5.1
+[0.5.0]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-multichain@0.4.0...@metamask/connect-multichain@0.5.0
 [0.4.0]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-multichain@0.3.2...@metamask/connect-multichain@0.4.0
 [0.3.2]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-multichain@0.3.1...@metamask/connect-multichain@0.3.2
 [0.3.1]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-multichain@0.3.0...@metamask/connect-multichain@0.3.1

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

@@ -1,5 +1,5 @@
 import debug from 'debug';
-import { SessionData, Transport, TransportRequest, TransportResponse, MultichainApiClient } from '@metamask/multichain-api-client';
+import { SessionData, Transport, SessionProperties, TransportRequest, TransportResponse, MultichainApiClient } from '@metamask/multichain-api-client';
 export { SessionData } from '@metamask/multichain-api-client';
 import { CaipAccountId, Json } from '@metamask/utils';
 import { SessionRequest, Session } from '@metamask/mobile-wallet-protocol-core';
@@ -296,17 +296,26 @@ type FactoryModals = {
     OTPCodeModal: new (options: OTPCodeWidgetProps) => AbstractOTPCodeModal;
 };
 
-declare class ModalFactory<T extends FactoryModals = FactoryModals> {
+/**
+ * Base ModalFactory class that accepts a preload function.
+ * Platform-specific implementations should extend this class.
+ */
+declare abstract class BaseModalFactory<T extends FactoryModals = FactoryModals> {
     protected readonly options: T;
     modal: Modal<any>;
     private readonly platform;
     private successCallback;
+    private displayUriCallback?;
     /**
      * Creates a new modal factory instance.
      *
      * @param options - The modals configuration object
      */
     constructor(options: T);
+    /**
+     * Platform-specific preload function to be implemented by subclasses.
+     */
+    protected abstract preload(): Promise<void>;
     private validateModals;
     unload(error?: Error): Promise<void>;
     /**
@@ -330,7 +339,7 @@ declare class ModalFactory<T extends FactoryModals = FactoryModals> {
     createConnectionUniversalLink(connectionRequest?: ConnectionRequest): string;
     private onCloseModal;
     private onStartDesktopOnboarding;
-    renderInstallModal(showInstallModal: boolean, createConnectionRequest: () => Promise<ConnectionRequest>, successCallback: (error?: Error) => Promise<void>): Promise<void>;
+    renderInstallModal(showInstallModal: boolean, createConnectionRequest: () => Promise<ConnectionRequest>, successCallback: (error?: Error) => Promise<void>, onDisplayUri?: (uri: string) => void): Promise<void>;
     renderOTPCodeModal(createOTPCode: () => Promise<OTPCode>, successCallback: (error?: Error) => Promise<void>, updateOTPCode: (otpCode: OTPCode, modal: AbstractOTPCodeModal) => void): Promise<void>;
 }
 
@@ -399,7 +408,7 @@ type MultichainOptions = {
     storage: StoreClient;
     /** UI configuration options */
     ui: {
-        factory: ModalFactory;
+        factory: BaseModalFactory;
         headless?: boolean;
         preferExtension?: boolean;
         showInstallModal?: boolean;
@@ -436,6 +445,7 @@ type ExtendedTransport = Omit<Transport, 'connect'> & {
     connect: (props?: {
         scopes: Scope[];
         caipAccountIds: CaipAccountId[];
+        sessionProperties?: SessionProperties;
         forceRequest?: boolean;
     }) => Promise<void>;
     sendEip1193Message: <TRequest extends TransportRequest, TResponse extends TransportResponse>(request: TRequest, options?: {
@@ -450,7 +460,7 @@ declare const SDK_HANDLED_METHODS: Set<string>;
 
 declare function getInfuraRpcUrls(infuraAPIKey: string): RpcUrlsMap;
 
-type SDKState = 'pending' | 'loaded' | 'disconnected' | 'connected' | 'connecting';
+type ConnectionStatus = 'pending' | 'loaded' | 'disconnected' | 'connected' | 'connecting';
 declare enum TransportType {
     Browser = "browser",
     MWP = "mwp",
@@ -465,7 +475,7 @@ declare enum TransportType {
 declare abstract class MultichainCore extends EventEmitter<SDKEvents> {
     protected readonly options: MultichainOptions;
     abstract storage: StoreClient;
-    abstract state: SDKState;
+    abstract status: ConnectionStatus;
     abstract provider: MultichainApiClient<RPCAPI>;
     abstract transport: ExtendedTransport;
     abstract transportType: TransportType;
@@ -474,7 +484,7 @@ declare abstract class MultichainCore extends EventEmitter<SDKEvents> {
      *
      * @returns Promise that resolves to the session data
      */
-    abstract connect(scopes: Scope[], caipAccountIds: CaipAccountId[], forceRequest?: boolean): Promise<void>;
+    abstract connect(scopes: Scope[], caipAccountIds: CaipAccountId[], sessionProperties?: SessionProperties, forceRequest?: boolean): Promise<void>;
     /**
      * Disconnects from the multichain provider.
      *
@@ -578,6 +588,13 @@ type InstallWidgetProps = Components.MmInstallModal & {
     startDesktopOnboarding: () => void;
     createConnectionRequest: () => Promise<ConnectionRequest>;
     generateQRCode: (connectionRequest: ConnectionRequest) => Promise<QRLink>;
+    /**
+     * Callback invoked when a QR code link is generated or regenerated.
+     * This allows consumers to display their own custom QR code UI.
+     *
+     * @param uri - The deeplink URI to be displayed as a QR code
+     */
+    onDisplayUri?: (uri: QRLink) => void;
 };
 type OTPCodeWidgetProps = Components.MmOtpModal & {
     parentElement?: Element;
@@ -632,6 +649,6 @@ declare function getWalletActionAnalyticsProperties(options: MultichainOptions,
  */
 declare function getVersion(): string;
 
-declare const createMetamaskConnect: CreateMultichainFN;
+declare const createMultichainClient: CreateMultichainFN;
 
-export { type ConnectionRequest, type CreateMultichainFN, type DappSettings, type DataType, type DomainErrorCodes, type Enumerate, type ErrorCodeRange, type ErrorCodes, EventEmitter, type EventTypes, type ExtendedTransport, type InstallWidgetProps, type InvokeMethodOptions, type LoggerNameSpaces, Modal, type ModalFactoryConnectOptions, type ModalFactoryOptions, MultichainCore, type MultichainOptions, type NotificationCallback, type OTPCode, type OTPCodeWidgetProps, PlatformType, type QRLink, type RPCAPI, type RPCErrorCodes, RPCHttpErr, RPCInvokeMethodErr, RPCReadonlyRequestErr, RPCReadonlyResponseErr, type RPCResponse, RPC_HANDLED_METHODS, type RpcMethod, type RpcUrlsMap, type SDKEvents, type SDKState, SDK_HANDLED_METHODS, type Scope, type StorageErrorCodes, StoreAdapter, StoreClient, type StoreOptions, TransportType, createLogger, createMetamaskConnect, enableDebug, getInfuraRpcUrls, getPlatformType, getTransportType, getVersion, getWalletActionAnalyticsProperties, hasExtension, infuraRpcUrls, isEnabled, isMetamaskExtensionInstalled, isRejectionError, isSecure };
+export { type ConnectionRequest, type ConnectionStatus, type CreateMultichainFN, type DappSettings, type DataType, type DomainErrorCodes, type Enumerate, type ErrorCodeRange, type ErrorCodes, EventEmitter, type EventTypes, type ExtendedTransport, type InstallWidgetProps, type InvokeMethodOptions, type LoggerNameSpaces, Modal, type ModalFactoryConnectOptions, type ModalFactoryOptions, MultichainCore, type MultichainOptions, type NotificationCallback, type OTPCode, type OTPCodeWidgetProps, PlatformType, type QRLink, type RPCAPI, type RPCErrorCodes, RPCHttpErr, RPCInvokeMethodErr, RPCReadonlyRequestErr, RPCReadonlyResponseErr, type RPCResponse, RPC_HANDLED_METHODS, type RpcMethod, type RpcUrlsMap, type SDKEvents, SDK_HANDLED_METHODS, type Scope, type StorageErrorCodes, StoreAdapter, StoreClient, type StoreOptions, TransportType, createLogger, createMultichainClient, enableDebug, getInfuraRpcUrls, getPlatformType, getTransportType, getVersion, getWalletActionAnalyticsProperties, hasExtension, infuraRpcUrls, isEnabled, isMetamaskExtensionInstalled, isRejectionError, isSecure };