@metamask/connect-multichain 0.4.0 → 0.5.1

package/dist/browser/umd/connect-multichain.d.ts

@@ -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 };