feat: add support for ecosystem query for wallet user

Author: ElasticBottle

packages/thirdweb/src/wallets/in-app/core/users/getUser.ts

@@ -3,6 +3,7 @@ import { getThirdwebBaseUrl } from "../../../../utils/domains.js";
 import { getClientFetch } from "../../../../utils/fetch.js";
 import type { OneOf, Prettify } from "../../../../utils/type-utils.js";
 import type { Profile } from "../authentication/types.js";
+import type { Ecosystem } from "../wallet/types.js";
 
 export type GetUserResult = {
   userId: string;
@@ -17,24 +18,23 @@ export type GetUserResult = {
  * Gets user based on the provided query parameters.
  * @note This function is only available on the server (a secret key is required in the client).
  *
- * @param options - The options for the find users function.
+ * @param options - The options for the get user function.
  * @param options.client - The Thirdweb client with a secret key included.
- * @param [options.walletAddress] - The wallet address to query by.
+ * @param [options.walletAddress] - The wallet address generated by thirdweb to query by.
  * @param [options.email] - The email to query by.
  * @param [options.phone] - The phone number to query by.
  * @param [options.id] - The user ID to query by.
+ * @param [options.externalWalletAddress] - The external wallet address used to login via SIWE.
  *
- * @returns An array of user objects.
+ * @returns A user object or null if not found.
  *
  * @example
- * ```ts
  * import { getUser } from "thirdweb/wallets";
  *
  * const user = await getUser({
  *   client,
  *   walletAddress: "0x123...",
  * });
- * ```
  *
  * @wallet
  */
@@ -44,14 +44,18 @@ export async function getUser({
   email,
   phone,
   id,
+  externalWalletAddress,
+  ecosystem,
 }: Prettify<
   {
     client: ThirdwebClient;
+    ecosystem?: Ecosystem;
   } & OneOf<{
     walletAddress?: string;
     email?: string;
     phone?: string;
     id?: string;
+    externalWalletAddress?: string;
   }>
 >): Promise<GetUserResult | null> {
   if (!client.secretKey) {
@@ -76,15 +80,27 @@ export async function getUser({
   } else if (id) {
     url.searchParams.set("queryBy", "id");
     url.searchParams.set("id", id);
+  } else if (externalWalletAddress) {
+    url.searchParams.set("queryBy", "externalWalletAddress");
+    url.searchParams.set("externalWalletAddress", externalWalletAddress);
   } else {
     throw new Error(
-      "Please provide a walletAddress, email, phone, or id to query for users.",
+      "Please provide a walletAddress, email, phone, id, or externalWalletAddress to query for users.",
     );
   }
 
   const clientFetch = getClientFetch(client);
 
-  const res = await clientFetch(url.toString());
+  const res = await clientFetch(url.toString(), {
+    headers: {
+      ...(ecosystem?.id
+        ? { "x-ecosystem-id": `ecosystem.${ecosystem.id}` }
+        : {}),
+      ...(ecosystem?.partnerId
+        ? { "x-ecosystem-partner-id": ecosystem.partnerId }
+        : {}),
+    },
+  });
 
   if (!res.ok) {
     throw new Error("Failed to get profiles");