chore: update changelog

feat: expose autoConnect function

Author: ElasticBottle

.changeset/green-rockets-lie.md

@@ -2,4 +2,15 @@
 "thirdweb": minor
 ---
 
-expose autoConnect as a standalone function for use outside of react
+Exposes autoConnect as a standalone function for use outside of react.
+
+```tsx
+import { autoConnect } from "thirdweb/wallets";
+ 
+const walletManager = createConnectionManager();
+const isAutoConnected = await autoConnect({
+ client,
+ walletManager,
+});
+console.log('isAutoConnected', isAutoConnected) // true or false
+```

packages/thirdweb/src/exports/wallets.ts

@@ -160,3 +160,6 @@ export * as EIP1193 from "../adapters/eip1193/index.js";
 export { injectedProvider } from "../wallets/injected/mipdStore.js";
 
 export type { ConnectionManager } from "../wallets/manager/index.js";
+
+export type { AutoConnectProps } from "../wallets/connection/types.js";
+export { autoConnect } from "../wallets/connection/autoConnect.js";

packages/thirdweb/src/wallets/connection/autoConnect.ts

@@ -0,0 +1,58 @@
+import type { Wallet } from "ethers5";
+import { getDefaultWallets } from "src/react/native/wallets/defaultWallets.js";
+import { webLocalStorage } from "src/utils/storage/webStorage.js";
+import { createWallet } from "../create-wallet.js";
+import { getInstalledWalletProviders } from "../injected/mipdStore.js";
+import type { ConnectionManager } from "../manager/index.js";
+import { autoConnectCore } from "./autoConnectCore.js";
+import type { AutoConnectProps } from "./types.js";
+
+/**
+ * Attempts to automatically connect to a wallet based on the provided configuration.
+ * It combines both specified wallets and installed wallet providers that aren't already specified.
+ *
+ * @example
+ *
+ * ```tsx
+ * import { autoConnect } from "thirdweb/wallets";
+ *
+ * const walletManager = createConnectionManager();
+ * const autoConnected = await autoConnect({
+ *  client,
+ *  walletManager,
+ * });
+ * ```
+ *
+ *
+ * @param props - The auto-connect configuration properties
+ * @param props.wallets - Array of wallet instances to consider for auto-connection
+ * @param walletManager - The connection manager instance handling wallet connections
+ * @returns {boolean} a promise resolving to true or false depending on whether the auto connect function connected to a wallet or not
+ */
+export const autoConnect = async (
+  props: AutoConnectProps & {
+    wallets: Wallet[];
+    walletManager: ConnectionManager;
+  },
+) => {
+  const wallets = props.wallets || getDefaultWallets(props);
+  return autoConnectCore({
+    storage: webLocalStorage,
+    props: {
+      ...props,
+      wallets,
+    },
+    createWalletFn: createWallet,
+    getInstalledWallets: () => {
+      const specifiedWalletIds = new Set(wallets.map((x) => x.id));
+
+      // pass the wallets that are not already specified but are installed by the user
+      const installedWallets = getInstalledWalletProviders()
+        .filter((x) => !specifiedWalletIds.has(x.info.rdns))
+        .map((x) => createWallet(x.info.rdns));
+
+      return installedWallets;
+    },
+    manager: props.walletManager,
+  });
+};