@dynamic-labs-sdk/wallet-connect 1.17.1 → 1.19.0

package/dist/{SessionClosedUnexpectedlyError-hEoXu8Ul.esm.js → SessionClosedUnexpectedlyError-BlM2BV_T.esm.js}

@@ -2,7 +2,7 @@ import { BaseError } from "@dynamic-labs-sdk/client";
 
 //#region package.json
 var name = "@dynamic-labs-sdk/wallet-connect";
-var version = "1.17.1";
+var version = "1.19.0";
 
 //#endregion
 //#region src/errors/SessionClosedUnexpectedlyError.ts
@@ -20,4 +20,4 @@ var SessionClosedUnexpectedlyError = class extends BaseError {
 
 //#endregion
 export { name as n, version as r, SessionClosedUnexpectedlyError as t };
-//# sourceMappingURL=SessionClosedUnexpectedlyError-hEoXu8Ul.esm.js.map
+//# sourceMappingURL=SessionClosedUnexpectedlyError-BlM2BV_T.esm.js.map

package/dist/{SessionClosedUnexpectedlyError-hEoXu8Ul.esm.js.map → SessionClosedUnexpectedlyError-BlM2BV_T.esm.js.map}

@@ -1 +1 @@
-{"version":3,"file":"SessionClosedUnexpectedlyError-hEoXu8Ul.esm.js","names":[],"sources":["../package.json","../src/errors/SessionClosedUnexpectedlyError.ts"],"sourcesContent":["","import { BaseError } from '@dynamic-labs-sdk/client';\n\ntype SessionClosedUnexpectedlyErrorParams = {\n  /**\n   * The topic of the session that closed unexpectedly.\n   */\n  sessionTopic: string;\n\n  /**\n   * The display name of the wallet that was associated with the session that closed unexpectedly.\n   */\n  walletDisplayName: string | null | undefined;\n};\n\nexport class SessionClosedUnexpectedlyError extends BaseError {\n  constructor({\n    sessionTopic,\n    walletDisplayName,\n  }: SessionClosedUnexpectedlyErrorParams) {\n    super({\n      cause: null,\n      code: 'session_closed_unexpectedly_error',\n      docsUrl: null,\n      name: 'SessionClosedUnexpectedlyError',\n      shortMessage: walletDisplayName\n        ? `WalletConnect session ${sessionTopic} closed unexpectedly. Associated wallet was ${walletDisplayName}`\n        : `WalletConnect session ${sessionTopic} closed unexpectedly`,\n    });\n  }\n}\n"],"mappings":";;;;;;;;ACcA,IAAa,iCAAb,cAAoD,UAAU;CAC5D,YAAY,EACV,cACA,qBACuC;AACvC,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cAAc,oBACV,yBAAyB,aAAa,8CAA8C,sBACpF,yBAAyB,aAAa;GAC3C,CAAC"}
+{"version":3,"file":"SessionClosedUnexpectedlyError-BlM2BV_T.esm.js","names":[],"sources":["../package.json","../src/errors/SessionClosedUnexpectedlyError.ts"],"sourcesContent":["","import { BaseError } from '@dynamic-labs-sdk/client';\n\ntype SessionClosedUnexpectedlyErrorParams = {\n  /**\n   * The topic of the session that closed unexpectedly.\n   */\n  sessionTopic: string;\n\n  /**\n   * The display name of the wallet that was associated with the session that closed unexpectedly.\n   */\n  walletDisplayName: string | null | undefined;\n};\n\nexport class SessionClosedUnexpectedlyError extends BaseError {\n  constructor({\n    sessionTopic,\n    walletDisplayName,\n  }: SessionClosedUnexpectedlyErrorParams) {\n    super({\n      cause: null,\n      code: 'session_closed_unexpectedly_error',\n      docsUrl: null,\n      name: 'SessionClosedUnexpectedlyError',\n      shortMessage: walletDisplayName\n        ? `WalletConnect session ${sessionTopic} closed unexpectedly. Associated wallet was ${walletDisplayName}`\n        : `WalletConnect session ${sessionTopic} closed unexpectedly`,\n    });\n  }\n}\n"],"mappings":";;;;;;;;ACcA,IAAa,iCAAb,cAAoD,UAAU;CAC5D,YAAY,EACV,cACA,qBACuC;AACvC,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cAAc,oBACV,yBAAyB,aAAa,8CAA8C,sBACpF,yBAAyB,aAAa;GAC3C,CAAC"}

package/dist/{SessionClosedUnexpectedlyError-bhOw-Gya.cjs → SessionClosedUnexpectedlyError-C2E2eW0s.cjs}

@@ -3,7 +3,7 @@ let _dynamic_labs_sdk_client = require("@dynamic-labs-sdk/client");
 
 //#region package.json
 var name = "@dynamic-labs-sdk/wallet-connect";
-var version = "1.17.1";
+var version = "1.19.0";
 
 //#endregion
 //#region src/errors/SessionClosedUnexpectedlyError.ts
@@ -38,4 +38,4 @@ Object.defineProperty(exports, 'version', {
     return version;
   }
 });
-//# sourceMappingURL=SessionClosedUnexpectedlyError-bhOw-Gya.cjs.map
+//# sourceMappingURL=SessionClosedUnexpectedlyError-C2E2eW0s.cjs.map

package/dist/{SessionClosedUnexpectedlyError-bhOw-Gya.cjs.map → SessionClosedUnexpectedlyError-C2E2eW0s.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"SessionClosedUnexpectedlyError-bhOw-Gya.cjs","names":["BaseError"],"sources":["../package.json","../src/errors/SessionClosedUnexpectedlyError.ts"],"sourcesContent":["","import { BaseError } from '@dynamic-labs-sdk/client';\n\ntype SessionClosedUnexpectedlyErrorParams = {\n  /**\n   * The topic of the session that closed unexpectedly.\n   */\n  sessionTopic: string;\n\n  /**\n   * The display name of the wallet that was associated with the session that closed unexpectedly.\n   */\n  walletDisplayName: string | null | undefined;\n};\n\nexport class SessionClosedUnexpectedlyError extends BaseError {\n  constructor({\n    sessionTopic,\n    walletDisplayName,\n  }: SessionClosedUnexpectedlyErrorParams) {\n    super({\n      cause: null,\n      code: 'session_closed_unexpectedly_error',\n      docsUrl: null,\n      name: 'SessionClosedUnexpectedlyError',\n      shortMessage: walletDisplayName\n        ? `WalletConnect session ${sessionTopic} closed unexpectedly. Associated wallet was ${walletDisplayName}`\n        : `WalletConnect session ${sessionTopic} closed unexpectedly`,\n    });\n  }\n}\n"],"mappings":";;;;;;;;;ACcA,IAAa,iCAAb,cAAoDA,mCAAU;CAC5D,YAAY,EACV,cACA,qBACuC;AACvC,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cAAc,oBACV,yBAAyB,aAAa,8CAA8C,sBACpF,yBAAyB,aAAa;GAC3C,CAAC"}
+{"version":3,"file":"SessionClosedUnexpectedlyError-C2E2eW0s.cjs","names":["BaseError"],"sources":["../package.json","../src/errors/SessionClosedUnexpectedlyError.ts"],"sourcesContent":["","import { BaseError } from '@dynamic-labs-sdk/client';\n\ntype SessionClosedUnexpectedlyErrorParams = {\n  /**\n   * The topic of the session that closed unexpectedly.\n   */\n  sessionTopic: string;\n\n  /**\n   * The display name of the wallet that was associated with the session that closed unexpectedly.\n   */\n  walletDisplayName: string | null | undefined;\n};\n\nexport class SessionClosedUnexpectedlyError extends BaseError {\n  constructor({\n    sessionTopic,\n    walletDisplayName,\n  }: SessionClosedUnexpectedlyErrorParams) {\n    super({\n      cause: null,\n      code: 'session_closed_unexpectedly_error',\n      docsUrl: null,\n      name: 'SessionClosedUnexpectedlyError',\n      shortMessage: walletDisplayName\n        ? `WalletConnect session ${sessionTopic} closed unexpectedly. Associated wallet was ${walletDisplayName}`\n        : `WalletConnect session ${sessionTopic} closed unexpectedly`,\n    });\n  }\n}\n"],"mappings":";;;;;;;;;ACcA,IAAa,iCAAb,cAAoDA,mCAAU;CAC5D,YAAY,EACV,cACA,qBACuC;AACvC,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cAAc,oBACV,yBAAyB,aAAa,8CAA8C,sBACpF,yBAAyB,aAAa;GAC3C,CAAC"}

package/dist/appendWalletConnectUriToDeepLink/appendWalletConnectUriToDeepLink.d.ts

@@ -9,9 +9,19 @@ type AppendWalletConnectUriToDeepLinkParams = {
  * was renamed to be generic across all URI-deeplink connection options
  * (WalletConnect, MetaMask SDK URI, …).
  *
+ * @example
+ * ```ts
+ * const deepLink = appendWalletConnectUriToDeepLink({
+ *   deepLinkUrl: 'https://metamask.app.link/wc',
+ *   walletConnectUri: 'wc:abc123@2?relay-protocol=irn&symKey=xyz',
+ * });
+ * ```
+ *
  * @param params.deepLinkUrl - The base deeplink URL.
  * @param params.walletConnectUri - The WalletConnect pairing URI to append.
  * @returns The deeplink URL with the WalletConnect URI appended as a query parameter.
+ * @see getPreferredWalletDeepLink
+ * @see isWalletConnectWalletProvider
  * @notInstrumented
  */
 export declare const appendWalletConnectUriToDeepLink: ({ deepLinkUrl, walletConnectUri, }: AppendWalletConnectUriToDeepLinkParams) => string;

package/dist/appendWalletConnectUriToDeepLink/appendWalletConnectUriToDeepLink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"appendWalletConnectUriToDeepLink.d.ts","sourceRoot":"","sources":["../../src/appendWalletConnectUriToDeepLink/appendWalletConnectUriToDeepLink.ts"],"names":[],"mappings":"AAEA,KAAK,sCAAsC,GAAG;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gCAAgC,uCAG1C,sCAAsC,KAAG,MAIxC,CAAC"}
+{"version":3,"file":"appendWalletConnectUriToDeepLink.d.ts","sourceRoot":"","sources":["../../src/appendWalletConnectUriToDeepLink/appendWalletConnectUriToDeepLink.ts"],"names":[],"mappings":"AAEA,KAAK,sCAAsC,GAAG;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,gCAAgC,uCAG1C,sCAAsC,KAAG,MAIxC,CAAC"}

package/dist/core.cjs

@@ -25,7 +25,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 
 //#endregion
-const require_SessionClosedUnexpectedlyError = require('./SessionClosedUnexpectedlyError-bhOw-Gya.cjs');
+const require_SessionClosedUnexpectedlyError = require('./SessionClosedUnexpectedlyError-C2E2eW0s.cjs');
 let _dynamic_labs_sdk_assert_package_version = require("@dynamic-labs-sdk/assert-package-version");
 let _walletconnect_utils = require("@walletconnect/utils");
 let _dynamic_labs_sdk_client = require("@dynamic-labs-sdk/client");

package/dist/core.esm.js

@@ -1,4 +1,4 @@
-import { n as name, r as version, t as SessionClosedUnexpectedlyError } from "./SessionClosedUnexpectedlyError-hEoXu8Ul.esm.js";
+import { n as name, r as version, t as SessionClosedUnexpectedlyError } from "./SessionClosedUnexpectedlyError-BlM2BV_T.esm.js";
 import { assertPackageVersion } from "@dynamic-labs-sdk/assert-package-version";
 import { formatMessage } from "@walletconnect/utils";
 import { verifyWalletAccount } from "@dynamic-labs-sdk/client";

package/dist/getPreferredWalletDeepLink/getPreferredWalletDeepLink.d.ts

@@ -15,8 +15,17 @@ type GetPreferredWalletDeepLinkParams = {
  * variant is missing. Returns `undefined` only when both variants are
  * absent.
  *
+ * @example
+ * ```ts
+ * const deepLink = getPreferredWalletDeepLink({
+ *   deeplinks: wallet.deeplinks,
+ * });
+ * ```
+ *
  * @param params.deeplinks - The deep link variants for a wallet (typically `WalletConnectCatalogWallet.deeplinks`).
  * @returns The preferred deep link URL, or `undefined` if neither variant is available.
+ * @see appendConnectionUriToDeeplink
+ * @see isWalletConnectWalletProvider
  * @notInstrumented
  */
 export declare const getPreferredWalletDeepLink: ({ deeplinks, }: GetPreferredWalletDeepLinkParams) => string | undefined;

package/dist/getPreferredWalletDeepLink/getPreferredWalletDeepLink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getPreferredWalletDeepLink.d.ts","sourceRoot":"","sources":["../../src/getPreferredWalletDeepLink/getPreferredWalletDeepLink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAG9E,KAAK,gCAAgC,GAAG;IACtC,SAAS,EAAE,6BAA6B,CAAC;CAC1C,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,0BAA0B,mBAEpC,gCAAgC,KAAG,MAAM,GAAG,SAQ9C,CAAC"}
+{"version":3,"file":"getPreferredWalletDeepLink.d.ts","sourceRoot":"","sources":["../../src/getPreferredWalletDeepLink/getPreferredWalletDeepLink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAG9E,KAAK,gCAAgC,GAAG;IACtC,SAAS,EAAE,6BAA6B,CAAC;CAC1C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,0BAA0B,mBAEpC,gCAAgC,KAAG,MAAM,GAAG,SAQ9C,CAAC"}

package/dist/index.cjs

@@ -1,4 +1,4 @@
-const require_SessionClosedUnexpectedlyError = require('./SessionClosedUnexpectedlyError-bhOw-Gya.cjs');
+const require_SessionClosedUnexpectedlyError = require('./SessionClosedUnexpectedlyError-C2E2eW0s.cjs');
 const require_core = require('./core.cjs');
 let _dynamic_labs_sdk_assert_package_version = require("@dynamic-labs-sdk/assert-package-version");
 let _walletconnect_utils = require("@walletconnect/utils");
@@ -13,9 +13,19 @@ let _dynamic_labs_sdk_api_core = require("@dynamic-labs/sdk-api-core");
 * was renamed to be generic across all URI-deeplink connection options
 * (WalletConnect, MetaMask SDK URI, …).
 *
+* @example
+* ```ts
+* const deepLink = appendWalletConnectUriToDeepLink({
+*   deepLinkUrl: 'https://metamask.app.link/wc',
+*   walletConnectUri: 'wc:abc123@2?relay-protocol=irn&symKey=xyz',
+* });
+* ```
+*
 * @param params.deepLinkUrl - The base deeplink URL.
 * @param params.walletConnectUri - The WalletConnect pairing URI to append.
 * @returns The deeplink URL with the WalletConnect URI appended as a query parameter.
+* @see getPreferredWalletDeepLink
+* @see isWalletConnectWalletProvider
 * @notInstrumented
 */
 const appendWalletConnectUriToDeepLink = ({ deepLinkUrl, walletConnectUri }) => (0, _dynamic_labs_sdk_client.appendConnectionUriToDeeplink)({
@@ -38,8 +48,17 @@ const appendWalletConnectUriToDeepLink = ({ deepLinkUrl, walletConnectUri }) =>
 * variant is missing. Returns `undefined` only when both variants are
 * absent.
 *
+* @example
+* ```ts
+* const deepLink = getPreferredWalletDeepLink({
+*   deeplinks: wallet.deeplinks,
+* });
+* ```
+*
 * @param params.deeplinks - The deep link variants for a wallet (typically `WalletConnectCatalogWallet.deeplinks`).
 * @returns The preferred deep link URL, or `undefined` if neither variant is available.
+* @see appendConnectionUriToDeeplink
+* @see isWalletConnectWalletProvider
 * @notInstrumented
 */
 const getPreferredWalletDeepLink = ({ deeplinks }) => {
@@ -50,7 +69,22 @@ const getPreferredWalletDeepLink = ({ deeplinks }) => {
 
 //#endregion
 //#region src/isWalletConnectWalletProvider/isWalletConnectWalletProvider.ts
-/** @notInstrumented */
+/**
+* Type guard function to check if a wallet provider is a WalletConnect wallet provider.
+*
+* @example
+* ```ts
+* if (isWalletConnectWalletProvider(provider)) {
+*   const session = provider.getSession();
+* }
+* ```
+*
+* @param walletProvider - The wallet provider to check.
+* @returns True if the wallet provider is a WalletConnect wallet provider, false otherwise.
+* @see getPreferredWalletDeepLink
+* @see appendConnectionUriToDeeplink
+* @notInstrumented
+*/
 const isWalletConnectWalletProvider = (walletProvider) => {
 	return walletProvider.walletProviderType === _dynamic_labs_sdk_api_core.WalletProviderEnum.WalletConnect;
 };

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["WalletProviderEnum","name","version"],"sources":["../src/appendWalletConnectUriToDeepLink/appendWalletConnectUriToDeepLink.ts","../src/getPreferredWalletDeepLink/getPreferredWalletDeepLink.ts","../src/isWalletConnectWalletProvider/isWalletConnectWalletProvider.ts","../src/exports/index.ts"],"sourcesContent":["import { appendConnectionUriToDeeplink } from '@dynamic-labs-sdk/client';\n\ntype AppendWalletConnectUriToDeepLinkParams = {\n  deepLinkUrl: string;\n  walletConnectUri: string;\n};\n\n/**\n * Appends a WalletConnect URI to a deeplink URL.\n *\n * @deprecated Use {@link appendConnectionUriToDeeplink} instead. This helper\n * was renamed to be generic across all URI-deeplink connection options\n * (WalletConnect, MetaMask SDK URI, …).\n *\n * @param params.deepLinkUrl - The base deeplink URL.\n * @param params.walletConnectUri - The WalletConnect pairing URI to append.\n * @returns The deeplink URL with the WalletConnect URI appended as a query parameter.\n * @notInstrumented\n */\nexport const appendWalletConnectUriToDeepLink = ({\n  deepLinkUrl,\n  walletConnectUri,\n}: AppendWalletConnectUriToDeepLinkParams): string =>\n  appendConnectionUriToDeeplink({\n    connectionUri: walletConnectUri,\n    deeplinkUrl: deepLinkUrl,\n  });\n","import type { WalletConnectCatalogDeepLinks } from '@dynamic-labs-sdk/client';\nimport { isMobile } from '@dynamic-labs-sdk/client';\n\ntype GetPreferredWalletDeepLinkParams = {\n  deeplinks: WalletConnectCatalogDeepLinks;\n};\n\n/**\n * Picks the most appropriate deep link variant for the current platform.\n *\n * Mobile (Android, iOS, tablets) prefers `native` because the OS treats\n * custom URL schemes as first-class app links and gives the wallet a faster\n * round-trip back to the dApp. Desktop prefers `universal` because browsers\n * cannot resolve mobile-only custom schemes and need an `https://` link\n * that opens the wallet's web flow.\n *\n * In either case, the alternative is used as a fallback when the preferred\n * variant is missing. Returns `undefined` only when both variants are\n * absent.\n *\n * @param params.deeplinks - The deep link variants for a wallet (typically `WalletConnectCatalogWallet.deeplinks`).\n * @returns The preferred deep link URL, or `undefined` if neither variant is available.\n * @notInstrumented\n */\nexport const getPreferredWalletDeepLink = ({\n  deeplinks,\n}: GetPreferredWalletDeepLinkParams): string | undefined => {\n  const { native, universal } = deeplinks;\n\n  if (isMobile()) {\n    return native ?? universal;\n  }\n\n  return universal ?? native;\n};\n","import type { WalletProvider } from '@dynamic-labs-sdk/client/core';\nimport { WalletProviderEnum } from '@dynamic-labs/sdk-api-core';\n\nimport type { WalletConnectWalletProvider } from '../walletConnectWalletProvider.types';\n\n/** @notInstrumented */\nexport const isWalletConnectWalletProvider = (\n  walletProvider: WalletProvider\n): walletProvider is WalletConnectWalletProvider => {\n  return walletProvider.walletProviderType === WalletProviderEnum.WalletConnect;\n};\n","/* eslint-disable import/no-unassigned-import */\nimport { assertPackageVersion } from '@dynamic-labs-sdk/assert-package-version';\n\nimport { name, version } from '../../package.json';\n\nassertPackageVersion(name, version);\n\nimport '../events';\n\nexport { SDK_ERRORS as WC_ERRORS } from '@walletconnect/utils';\n\nexport { appendWalletConnectUriToDeepLink } from '../appendWalletConnectUriToDeepLink';\nexport { SessionClosedUnexpectedlyError } from '../errors/SessionClosedUnexpectedlyError';\nexport { getPreferredWalletDeepLink } from '../getPreferredWalletDeepLink';\nexport { isWalletConnectWalletProvider } from '../isWalletConnectWalletProvider';\nexport type {\n  WalletConnectConnectionResult,\n  WalletConnectWalletProvider,\n} from '../walletConnectWalletProvider.types';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAmBA,MAAa,oCAAoC,EAC/C,aACA,mFAE8B;CAC5B,eAAe;CACf,aAAa;CACd,CAAC;;;;;;;;;;;;;;;;;;;;;ACFJ,MAAa,8BAA8B,EACzC,gBAC0D;CAC1D,MAAM,EAAE,QAAQ,cAAc;AAE9B,6CAAc,CACZ,QAAO,UAAU;AAGnB,QAAO,aAAa;;;;;;AC3BtB,MAAa,iCACX,mBACkD;AAClD,QAAO,eAAe,uBAAuBA,8CAAmB;;;;;mECJ7CC,6CAAMC,+CAAQ"}
+{"version":3,"file":"index.cjs","names":["WalletProviderEnum","name","version"],"sources":["../src/appendWalletConnectUriToDeepLink/appendWalletConnectUriToDeepLink.ts","../src/getPreferredWalletDeepLink/getPreferredWalletDeepLink.ts","../src/isWalletConnectWalletProvider/isWalletConnectWalletProvider.ts","../src/exports/index.ts"],"sourcesContent":["import { appendConnectionUriToDeeplink } from '@dynamic-labs-sdk/client';\n\ntype AppendWalletConnectUriToDeepLinkParams = {\n  deepLinkUrl: string;\n  walletConnectUri: string;\n};\n\n/**\n * Appends a WalletConnect URI to a deeplink URL.\n *\n * @deprecated Use {@link appendConnectionUriToDeeplink} instead. This helper\n * was renamed to be generic across all URI-deeplink connection options\n * (WalletConnect, MetaMask SDK URI, …).\n *\n * @example\n * ```ts\n * const deepLink = appendWalletConnectUriToDeepLink({\n *   deepLinkUrl: 'https://metamask.app.link/wc',\n *   walletConnectUri: 'wc:abc123@2?relay-protocol=irn&symKey=xyz',\n * });\n * ```\n *\n * @param params.deepLinkUrl - The base deeplink URL.\n * @param params.walletConnectUri - The WalletConnect pairing URI to append.\n * @returns The deeplink URL with the WalletConnect URI appended as a query parameter.\n * @see getPreferredWalletDeepLink\n * @see isWalletConnectWalletProvider\n * @notInstrumented\n */\nexport const appendWalletConnectUriToDeepLink = ({\n  deepLinkUrl,\n  walletConnectUri,\n}: AppendWalletConnectUriToDeepLinkParams): string =>\n  appendConnectionUriToDeeplink({\n    connectionUri: walletConnectUri,\n    deeplinkUrl: deepLinkUrl,\n  });\n","import type { WalletConnectCatalogDeepLinks } from '@dynamic-labs-sdk/client';\nimport { isMobile } from '@dynamic-labs-sdk/client';\n\ntype GetPreferredWalletDeepLinkParams = {\n  deeplinks: WalletConnectCatalogDeepLinks;\n};\n\n/**\n * Picks the most appropriate deep link variant for the current platform.\n *\n * Mobile (Android, iOS, tablets) prefers `native` because the OS treats\n * custom URL schemes as first-class app links and gives the wallet a faster\n * round-trip back to the dApp. Desktop prefers `universal` because browsers\n * cannot resolve mobile-only custom schemes and need an `https://` link\n * that opens the wallet's web flow.\n *\n * In either case, the alternative is used as a fallback when the preferred\n * variant is missing. Returns `undefined` only when both variants are\n * absent.\n *\n * @example\n * ```ts\n * const deepLink = getPreferredWalletDeepLink({\n *   deeplinks: wallet.deeplinks,\n * });\n * ```\n *\n * @param params.deeplinks - The deep link variants for a wallet (typically `WalletConnectCatalogWallet.deeplinks`).\n * @returns The preferred deep link URL, or `undefined` if neither variant is available.\n * @see appendConnectionUriToDeeplink\n * @see isWalletConnectWalletProvider\n * @notInstrumented\n */\nexport const getPreferredWalletDeepLink = ({\n  deeplinks,\n}: GetPreferredWalletDeepLinkParams): string | undefined => {\n  const { native, universal } = deeplinks;\n\n  if (isMobile()) {\n    return native ?? universal;\n  }\n\n  return universal ?? native;\n};\n","import type { WalletProvider } from '@dynamic-labs-sdk/client/core';\nimport { WalletProviderEnum } from '@dynamic-labs/sdk-api-core';\n\nimport type { WalletConnectWalletProvider } from '../walletConnectWalletProvider.types';\n\n/**\n * Type guard function to check if a wallet provider is a WalletConnect wallet provider.\n *\n * @example\n * ```ts\n * if (isWalletConnectWalletProvider(provider)) {\n *   const session = provider.getSession();\n * }\n * ```\n *\n * @param walletProvider - The wallet provider to check.\n * @returns True if the wallet provider is a WalletConnect wallet provider, false otherwise.\n * @see getPreferredWalletDeepLink\n * @see appendConnectionUriToDeeplink\n * @notInstrumented\n */\nexport const isWalletConnectWalletProvider = (\n  walletProvider: WalletProvider\n): walletProvider is WalletConnectWalletProvider => {\n  return walletProvider.walletProviderType === WalletProviderEnum.WalletConnect;\n};\n","/* eslint-disable import/no-unassigned-import */\nimport { assertPackageVersion } from '@dynamic-labs-sdk/assert-package-version';\n\nimport { name, version } from '../../package.json';\n\nassertPackageVersion(name, version);\n\nimport '../events';\n\nexport { SDK_ERRORS as WC_ERRORS } from '@walletconnect/utils';\n\nexport { appendWalletConnectUriToDeepLink } from '../appendWalletConnectUriToDeepLink';\nexport { SessionClosedUnexpectedlyError } from '../errors/SessionClosedUnexpectedlyError';\nexport { getPreferredWalletDeepLink } from '../getPreferredWalletDeepLink';\nexport { isWalletConnectWalletProvider } from '../isWalletConnectWalletProvider';\nexport type {\n  WalletConnectConnectionResult,\n  WalletConnectWalletProvider,\n} from '../walletConnectWalletProvider.types';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,MAAa,oCAAoC,EAC/C,aACA,mFAE8B;CAC5B,eAAe;CACf,aAAa;CACd,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACHJ,MAAa,8BAA8B,EACzC,gBAC0D;CAC1D,MAAM,EAAE,QAAQ,cAAc;AAE9B,6CAAc,CACZ,QAAO,UAAU;AAGnB,QAAO,aAAa;;;;;;;;;;;;;;;;;;;;;ACrBtB,MAAa,iCACX,mBACkD;AAClD,QAAO,eAAe,uBAAuBA,8CAAmB;;;;;mECnB7CC,6CAAMC,+CAAQ"}

package/dist/index.esm.js

@@ -1,4 +1,4 @@
-import { n as name, r as version, t as SessionClosedUnexpectedlyError } from "./SessionClosedUnexpectedlyError-hEoXu8Ul.esm.js";
+import { n as name, r as version, t as SessionClosedUnexpectedlyError } from "./SessionClosedUnexpectedlyError-BlM2BV_T.esm.js";
 import { assertPackageVersion } from "@dynamic-labs-sdk/assert-package-version";
 import { SDK_ERRORS as WC_ERRORS } from "@walletconnect/utils";
 import { appendConnectionUriToDeeplink, isMobile } from "@dynamic-labs-sdk/client";
@@ -12,9 +12,19 @@ import { WalletProviderEnum } from "@dynamic-labs/sdk-api-core";
 * was renamed to be generic across all URI-deeplink connection options
 * (WalletConnect, MetaMask SDK URI, …).
 *
+* @example
+* ```ts
+* const deepLink = appendWalletConnectUriToDeepLink({
+*   deepLinkUrl: 'https://metamask.app.link/wc',
+*   walletConnectUri: 'wc:abc123@2?relay-protocol=irn&symKey=xyz',
+* });
+* ```
+*
 * @param params.deepLinkUrl - The base deeplink URL.
 * @param params.walletConnectUri - The WalletConnect pairing URI to append.
 * @returns The deeplink URL with the WalletConnect URI appended as a query parameter.
+* @see getPreferredWalletDeepLink
+* @see isWalletConnectWalletProvider
 * @notInstrumented
 */
 const appendWalletConnectUriToDeepLink = ({ deepLinkUrl, walletConnectUri }) => appendConnectionUriToDeeplink({
@@ -37,8 +47,17 @@ const appendWalletConnectUriToDeepLink = ({ deepLinkUrl, walletConnectUri }) =>
 * variant is missing. Returns `undefined` only when both variants are
 * absent.
 *
+* @example
+* ```ts
+* const deepLink = getPreferredWalletDeepLink({
+*   deeplinks: wallet.deeplinks,
+* });
+* ```
+*
 * @param params.deeplinks - The deep link variants for a wallet (typically `WalletConnectCatalogWallet.deeplinks`).
 * @returns The preferred deep link URL, or `undefined` if neither variant is available.
+* @see appendConnectionUriToDeeplink
+* @see isWalletConnectWalletProvider
 * @notInstrumented
 */
 const getPreferredWalletDeepLink = ({ deeplinks }) => {
@@ -49,7 +68,22 @@ const getPreferredWalletDeepLink = ({ deeplinks }) => {
 
 //#endregion
 //#region src/isWalletConnectWalletProvider/isWalletConnectWalletProvider.ts
-/** @notInstrumented */
+/**
+* Type guard function to check if a wallet provider is a WalletConnect wallet provider.
+*
+* @example
+* ```ts
+* if (isWalletConnectWalletProvider(provider)) {
+*   const session = provider.getSession();
+* }
+* ```
+*
+* @param walletProvider - The wallet provider to check.
+* @returns True if the wallet provider is a WalletConnect wallet provider, false otherwise.
+* @see getPreferredWalletDeepLink
+* @see appendConnectionUriToDeeplink
+* @notInstrumented
+*/
 const isWalletConnectWalletProvider = (walletProvider) => {
 	return walletProvider.walletProviderType === WalletProviderEnum.WalletConnect;
 };

package/dist/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","names":[],"sources":["../src/appendWalletConnectUriToDeepLink/appendWalletConnectUriToDeepLink.ts","../src/getPreferredWalletDeepLink/getPreferredWalletDeepLink.ts","../src/isWalletConnectWalletProvider/isWalletConnectWalletProvider.ts","../src/exports/index.ts"],"sourcesContent":["import { appendConnectionUriToDeeplink } from '@dynamic-labs-sdk/client';\n\ntype AppendWalletConnectUriToDeepLinkParams = {\n  deepLinkUrl: string;\n  walletConnectUri: string;\n};\n\n/**\n * Appends a WalletConnect URI to a deeplink URL.\n *\n * @deprecated Use {@link appendConnectionUriToDeeplink} instead. This helper\n * was renamed to be generic across all URI-deeplink connection options\n * (WalletConnect, MetaMask SDK URI, …).\n *\n * @param params.deepLinkUrl - The base deeplink URL.\n * @param params.walletConnectUri - The WalletConnect pairing URI to append.\n * @returns The deeplink URL with the WalletConnect URI appended as a query parameter.\n * @notInstrumented\n */\nexport const appendWalletConnectUriToDeepLink = ({\n  deepLinkUrl,\n  walletConnectUri,\n}: AppendWalletConnectUriToDeepLinkParams): string =>\n  appendConnectionUriToDeeplink({\n    connectionUri: walletConnectUri,\n    deeplinkUrl: deepLinkUrl,\n  });\n","import type { WalletConnectCatalogDeepLinks } from '@dynamic-labs-sdk/client';\nimport { isMobile } from '@dynamic-labs-sdk/client';\n\ntype GetPreferredWalletDeepLinkParams = {\n  deeplinks: WalletConnectCatalogDeepLinks;\n};\n\n/**\n * Picks the most appropriate deep link variant for the current platform.\n *\n * Mobile (Android, iOS, tablets) prefers `native` because the OS treats\n * custom URL schemes as first-class app links and gives the wallet a faster\n * round-trip back to the dApp. Desktop prefers `universal` because browsers\n * cannot resolve mobile-only custom schemes and need an `https://` link\n * that opens the wallet's web flow.\n *\n * In either case, the alternative is used as a fallback when the preferred\n * variant is missing. Returns `undefined` only when both variants are\n * absent.\n *\n * @param params.deeplinks - The deep link variants for a wallet (typically `WalletConnectCatalogWallet.deeplinks`).\n * @returns The preferred deep link URL, or `undefined` if neither variant is available.\n * @notInstrumented\n */\nexport const getPreferredWalletDeepLink = ({\n  deeplinks,\n}: GetPreferredWalletDeepLinkParams): string | undefined => {\n  const { native, universal } = deeplinks;\n\n  if (isMobile()) {\n    return native ?? universal;\n  }\n\n  return universal ?? native;\n};\n","import type { WalletProvider } from '@dynamic-labs-sdk/client/core';\nimport { WalletProviderEnum } from '@dynamic-labs/sdk-api-core';\n\nimport type { WalletConnectWalletProvider } from '../walletConnectWalletProvider.types';\n\n/** @notInstrumented */\nexport const isWalletConnectWalletProvider = (\n  walletProvider: WalletProvider\n): walletProvider is WalletConnectWalletProvider => {\n  return walletProvider.walletProviderType === WalletProviderEnum.WalletConnect;\n};\n","/* eslint-disable import/no-unassigned-import */\nimport { assertPackageVersion } from '@dynamic-labs-sdk/assert-package-version';\n\nimport { name, version } from '../../package.json';\n\nassertPackageVersion(name, version);\n\nimport '../events';\n\nexport { SDK_ERRORS as WC_ERRORS } from '@walletconnect/utils';\n\nexport { appendWalletConnectUriToDeepLink } from '../appendWalletConnectUriToDeepLink';\nexport { SessionClosedUnexpectedlyError } from '../errors/SessionClosedUnexpectedlyError';\nexport { getPreferredWalletDeepLink } from '../getPreferredWalletDeepLink';\nexport { isWalletConnectWalletProvider } from '../isWalletConnectWalletProvider';\nexport type {\n  WalletConnectConnectionResult,\n  WalletConnectWalletProvider,\n} from '../walletConnectWalletProvider.types';\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,MAAa,oCAAoC,EAC/C,aACA,uBAEA,8BAA8B;CAC5B,eAAe;CACf,aAAa;CACd,CAAC;;;;;;;;;;;;;;;;;;;;;ACFJ,MAAa,8BAA8B,EACzC,gBAC0D;CAC1D,MAAM,EAAE,QAAQ,cAAc;AAE9B,KAAI,UAAU,CACZ,QAAO,UAAU;AAGnB,QAAO,aAAa;;;;;;AC3BtB,MAAa,iCACX,mBACkD;AAClD,QAAO,eAAe,uBAAuB,mBAAmB;;;;;ACJlE,qBAAqB,MAAM,QAAQ"}
+{"version":3,"file":"index.esm.js","names":[],"sources":["../src/appendWalletConnectUriToDeepLink/appendWalletConnectUriToDeepLink.ts","../src/getPreferredWalletDeepLink/getPreferredWalletDeepLink.ts","../src/isWalletConnectWalletProvider/isWalletConnectWalletProvider.ts","../src/exports/index.ts"],"sourcesContent":["import { appendConnectionUriToDeeplink } from '@dynamic-labs-sdk/client';\n\ntype AppendWalletConnectUriToDeepLinkParams = {\n  deepLinkUrl: string;\n  walletConnectUri: string;\n};\n\n/**\n * Appends a WalletConnect URI to a deeplink URL.\n *\n * @deprecated Use {@link appendConnectionUriToDeeplink} instead. This helper\n * was renamed to be generic across all URI-deeplink connection options\n * (WalletConnect, MetaMask SDK URI, …).\n *\n * @example\n * ```ts\n * const deepLink = appendWalletConnectUriToDeepLink({\n *   deepLinkUrl: 'https://metamask.app.link/wc',\n *   walletConnectUri: 'wc:abc123@2?relay-protocol=irn&symKey=xyz',\n * });\n * ```\n *\n * @param params.deepLinkUrl - The base deeplink URL.\n * @param params.walletConnectUri - The WalletConnect pairing URI to append.\n * @returns The deeplink URL with the WalletConnect URI appended as a query parameter.\n * @see getPreferredWalletDeepLink\n * @see isWalletConnectWalletProvider\n * @notInstrumented\n */\nexport const appendWalletConnectUriToDeepLink = ({\n  deepLinkUrl,\n  walletConnectUri,\n}: AppendWalletConnectUriToDeepLinkParams): string =>\n  appendConnectionUriToDeeplink({\n    connectionUri: walletConnectUri,\n    deeplinkUrl: deepLinkUrl,\n  });\n","import type { WalletConnectCatalogDeepLinks } from '@dynamic-labs-sdk/client';\nimport { isMobile } from '@dynamic-labs-sdk/client';\n\ntype GetPreferredWalletDeepLinkParams = {\n  deeplinks: WalletConnectCatalogDeepLinks;\n};\n\n/**\n * Picks the most appropriate deep link variant for the current platform.\n *\n * Mobile (Android, iOS, tablets) prefers `native` because the OS treats\n * custom URL schemes as first-class app links and gives the wallet a faster\n * round-trip back to the dApp. Desktop prefers `universal` because browsers\n * cannot resolve mobile-only custom schemes and need an `https://` link\n * that opens the wallet's web flow.\n *\n * In either case, the alternative is used as a fallback when the preferred\n * variant is missing. Returns `undefined` only when both variants are\n * absent.\n *\n * @example\n * ```ts\n * const deepLink = getPreferredWalletDeepLink({\n *   deeplinks: wallet.deeplinks,\n * });\n * ```\n *\n * @param params.deeplinks - The deep link variants for a wallet (typically `WalletConnectCatalogWallet.deeplinks`).\n * @returns The preferred deep link URL, or `undefined` if neither variant is available.\n * @see appendConnectionUriToDeeplink\n * @see isWalletConnectWalletProvider\n * @notInstrumented\n */\nexport const getPreferredWalletDeepLink = ({\n  deeplinks,\n}: GetPreferredWalletDeepLinkParams): string | undefined => {\n  const { native, universal } = deeplinks;\n\n  if (isMobile()) {\n    return native ?? universal;\n  }\n\n  return universal ?? native;\n};\n","import type { WalletProvider } from '@dynamic-labs-sdk/client/core';\nimport { WalletProviderEnum } from '@dynamic-labs/sdk-api-core';\n\nimport type { WalletConnectWalletProvider } from '../walletConnectWalletProvider.types';\n\n/**\n * Type guard function to check if a wallet provider is a WalletConnect wallet provider.\n *\n * @example\n * ```ts\n * if (isWalletConnectWalletProvider(provider)) {\n *   const session = provider.getSession();\n * }\n * ```\n *\n * @param walletProvider - The wallet provider to check.\n * @returns True if the wallet provider is a WalletConnect wallet provider, false otherwise.\n * @see getPreferredWalletDeepLink\n * @see appendConnectionUriToDeeplink\n * @notInstrumented\n */\nexport const isWalletConnectWalletProvider = (\n  walletProvider: WalletProvider\n): walletProvider is WalletConnectWalletProvider => {\n  return walletProvider.walletProviderType === WalletProviderEnum.WalletConnect;\n};\n","/* eslint-disable import/no-unassigned-import */\nimport { assertPackageVersion } from '@dynamic-labs-sdk/assert-package-version';\n\nimport { name, version } from '../../package.json';\n\nassertPackageVersion(name, version);\n\nimport '../events';\n\nexport { SDK_ERRORS as WC_ERRORS } from '@walletconnect/utils';\n\nexport { appendWalletConnectUriToDeepLink } from '../appendWalletConnectUriToDeepLink';\nexport { SessionClosedUnexpectedlyError } from '../errors/SessionClosedUnexpectedlyError';\nexport { getPreferredWalletDeepLink } from '../getPreferredWalletDeepLink';\nexport { isWalletConnectWalletProvider } from '../isWalletConnectWalletProvider';\nexport type {\n  WalletConnectConnectionResult,\n  WalletConnectWalletProvider,\n} from '../walletConnectWalletProvider.types';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,MAAa,oCAAoC,EAC/C,aACA,uBAEA,8BAA8B;CAC5B,eAAe;CACf,aAAa;CACd,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACHJ,MAAa,8BAA8B,EACzC,gBAC0D;CAC1D,MAAM,EAAE,QAAQ,cAAc;AAE9B,KAAI,UAAU,CACZ,QAAO,UAAU;AAGnB,QAAO,aAAa;;;;;;;;;;;;;;;;;;;;;ACrBtB,MAAa,iCACX,mBACkD;AAClD,QAAO,eAAe,uBAAuB,mBAAmB;;;;;ACnBlE,qBAAqB,MAAM,QAAQ"}

package/dist/isWalletConnectWalletProvider/isWalletConnectWalletProvider.d.ts

@@ -1,5 +1,20 @@
 import type { WalletProvider } from '@dynamic-labs-sdk/client/core';
 import type { WalletConnectWalletProvider } from '../walletConnectWalletProvider.types';
-/** @notInstrumented */
+/**
+ * Type guard function to check if a wallet provider is a WalletConnect wallet provider.
+ *
+ * @example
+ * ```ts
+ * if (isWalletConnectWalletProvider(provider)) {
+ *   const session = provider.getSession();
+ * }
+ * ```
+ *
+ * @param walletProvider - The wallet provider to check.
+ * @returns True if the wallet provider is a WalletConnect wallet provider, false otherwise.
+ * @see getPreferredWalletDeepLink
+ * @see appendConnectionUriToDeeplink
+ * @notInstrumented
+ */
 export declare const isWalletConnectWalletProvider: (walletProvider: WalletProvider) => walletProvider is WalletConnectWalletProvider;
 //# sourceMappingURL=isWalletConnectWalletProvider.d.ts.map

package/dist/isWalletConnectWalletProvider/isWalletConnectWalletProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"isWalletConnectWalletProvider.d.ts","sourceRoot":"","sources":["../../src/isWalletConnectWalletProvider/isWalletConnectWalletProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGpE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AAExF,uBAAuB;AACvB,eAAO,MAAM,6BAA6B,mBACxB,cAAc,KAC7B,cAAc,IAAI,2BAEpB,CAAC"}
+{"version":3,"file":"isWalletConnectWalletProvider.d.ts","sourceRoot":"","sources":["../../src/isWalletConnectWalletProvider/isWalletConnectWalletProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGpE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AAExF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,6BAA6B,mBACxB,cAAc,KAC7B,cAAc,IAAI,2BAEpB,CAAC"}