@domino-sdk/relay 0.23.1 → 0.25.0

package/dist/react/index.js

@@ -1,12 +1,19 @@
 import {
-  createBrowserRelayClient
-} from "../chunk-ND3CVNIW.js";
+  createBrowserRelayClient,
+  discoverCosmosWallets,
+  discoverEvmWallets,
+  discoverSolanaWallets
+} from "../chunk-MZFUQQDP.js";
 import {
-  RelayError
-} from "../chunk-RTBIXGMH.js";
-import "../chunk-ZOL7RYHW.js";
-import "../chunk-57TGYC5Y.js";
-import "../chunk-UYS522ER.js";
+  RelayError,
+  avatarSrc,
+  defaultAvatar,
+  walletAvatarSeed
+} from "../chunk-S44XSDW2.js";
+import "../chunk-AKB266O5.js";
+import "../chunk-7QICEKC2.js";
+import "../chunk-D6BX627V.js";
+import "../chunk-IXLY3A7B.js";
 
 // src/react/provider.tsx
 import { useState as useState3 } from "react";
@@ -531,11 +538,126 @@ function useQuest(observed) {
 }
 
 // src/react/auth.ts
-import { useEffect as useEffect4, useState as useState5 } from "react";
-function useSignInMethods() {
+import { useEffect as useEffect5, useState as useState6 } from "react";
+
+// src/react/wallets.ts
+import { useCallback as useCallback2, useEffect as useEffect4, useState as useState5 } from "react";
+var WALLETS_CHANGED = "relay-wallets-changed";
+function useWallets() {
   const relay = useRelay();
-  const [methods, setMethods] = useState5(null);
+  const { member } = useExperience();
+  const [wallets, setWallets] = useState5(null);
+  const [error, setError] = useState5(null);
+  const [busy, setBusy] = useState5(false);
+  const refresh = useCallback2(async () => {
+    try {
+      setWallets(await relay.wallets.list());
+      setError(null);
+    } catch (cause) {
+      setError(
+        cause instanceof Error && cause.message ? cause.message : "Could not load linked wallets."
+      );
+    }
+  }, [relay]);
   useEffect4(() => {
+    if (!member) {
+      setWallets(null);
+      return;
+    }
+    const update = () => void refresh();
+    update();
+    window.addEventListener("focus", update);
+    window.addEventListener(WALLETS_CHANGED, update);
+    return () => {
+      window.removeEventListener("focus", update);
+      window.removeEventListener(WALLETS_CHANGED, update);
+    };
+  }, [member, refresh]);
+  async function run(task, fallback) {
+    setBusy(true);
+    setError(null);
+    try {
+      await task();
+    } catch (cause) {
+      setError(
+        cause instanceof Error && cause.message ? cause.message : fallback
+      );
+    } finally {
+      setBusy(false);
+    }
+  }
+  return {
+    /** Null until read, and while nobody is signed in. */
+    wallets,
+    error,
+    busy,
+    refresh,
+    link: (signer) => run(async () => {
+      await relay.wallets.link(signer);
+      window.dispatchEvent(new Event(WALLETS_CHANGED));
+    }, "Couldn't link this wallet. Try again."),
+    unlink: (wallet) => run(async () => {
+      await relay.wallets.unlink({
+        chain: wallet.chain,
+        address: wallet.address
+      });
+      window.dispatchEvent(new Event(WALLETS_CHANGED));
+    }, "Couldn't unlink this wallet. Try again.")
+  };
+}
+function useWalletDiscovery(options = {}) {
+  const networks = (options.cosmos ?? ["cosmos:pio-mainnet-1"]).join(" ");
+  const [found, setFound] = useState5({ evm: [], solana: [], cosmos: [] });
+  useEffect4(() => {
+    let active = true;
+    const solana = discoverSolanaWallets();
+    const cosmos = networks.split(" ").filter(Boolean).flatMap((network) => discoverCosmosWallets(network));
+    setFound((current) => ({ ...current, solana, cosmos }));
+    void discoverEvmWallets().then((evm) => {
+      if (active) {
+        setFound((current) => ({ ...current, evm }));
+      }
+    });
+    return () => {
+      active = false;
+    };
+  }, [networks]);
+  return found;
+}
+function useSignInWallets(networks) {
+  const key = networks ? networks.join(" ") : null;
+  const [found, setFound] = useState5(null);
+  useEffect4(() => {
+    if (key === null) {
+      return;
+    }
+    let active = true;
+    const enabled = key.split(" ").filter(Boolean);
+    const tagged = (network, wallets) => wallets.map((wallet) => ({ ...wallet, network }));
+    const immediate = [
+      ...enabled.includes("solana") ? tagged("solana", discoverSolanaWallets()) : [],
+      ...enabled.filter(
+        (network) => network.startsWith("cosmos:")
+      ).flatMap((network) => tagged(network, discoverCosmosWallets(network)))
+    ];
+    const evm = enabled.includes("eip155") ? discoverEvmWallets() : Promise.resolve([]);
+    void evm.then((wallets) => {
+      if (active) {
+        setFound({ key, wallets: [...tagged("eip155", wallets), ...immediate] });
+      }
+    });
+    return () => {
+      active = false;
+    };
+  }, [key]);
+  return found && found.key === key ? found.wallets : null;
+}
+
+// src/react/auth.ts
+function useSignInMethods() {
+  const relay = useRelay();
+  const [methods, setMethods] = useState6(null);
+  useEffect5(() => {
     let active = true;
     relay.auth.providers().then((result) => {
       if (!active) {
@@ -543,20 +665,43 @@ function useSignInMethods() {
       }
       setMethods({
         providers: result.providers.filter((p) => p.configured).map((p) => p.provider),
-        email: result.email
+        email: result.email,
+        wallets: result.wallets
       });
-    }).catch(() => active && setMethods({ providers: [], email: true }));
+    }).catch(
+      () => active && setMethods({ providers: [], email: true, wallets: [] })
+    );
     return () => {
       active = false;
     };
   }, [relay]);
   return methods;
 }
+function useMe() {
+  const relay = useRelay();
+  const { member } = useExperience();
+  const [me, setMe] = useState6(null);
+  useEffect5(() => {
+    if (!member) {
+      setMe(null);
+      return;
+    }
+    let active = true;
+    const read = () => void relay.me.get().then((value) => active && setMe(value)).catch(() => active && setMe(null));
+    read();
+    window.addEventListener(WALLETS_CHANGED, read);
+    return () => {
+      active = false;
+      window.removeEventListener(WALLETS_CHANGED, read);
+    };
+  }, [relay, member]);
+  return me;
+}
 function useSignIn() {
   const relay = useRelay();
-  const [challenge, setChallenge] = useState5(null);
-  const [busy, setBusy] = useState5(false);
-  const [error, setError] = useState5(null);
+  const [challenge, setChallenge] = useState6(null);
+  const [busy, setBusy] = useState6(false);
+  const [error, setError] = useState6(null);
   async function run(task, fallback) {
     setBusy(true);
     setError(null);
@@ -592,12 +737,17 @@ function useSignIn() {
     withProvider: (provider) => run(async () => {
       const { url } = await relay.auth.start(provider, "sign-in");
       window.location.assign(url);
-    }, "Couldn't start sign-in. Try again.")
+    }, "Couldn't start sign-in. Try again."),
+    /** Signs in, or signs up, with a wallet; the wallet asks the participant to sign a message. */
+    withWallet: (signer) => run(async () => {
+      await relay.auth.wallet.signIn(signer);
+      setChallenge(null);
+    }, "Couldn't sign in with this wallet. Try again.")
   };
 }
 function useSignOut() {
   const relay = useRelay();
-  const [busy, setBusy] = useState5(false);
+  const [busy, setBusy] = useState6(false);
   return {
     busy,
     signOut: async () => {
@@ -612,7 +762,7 @@ function useSignOut() {
 }
 
 // src/react/accounts.ts
-import { useCallback as useCallback2, useEffect as useEffect5, useState as useState6 } from "react";
+import { useCallback as useCallback3, useEffect as useEffect6, useState as useState7 } from "react";
 var CHANGED = "relay-accounts-changed";
 function isConnected(accounts, provider) {
   return Boolean(
@@ -624,10 +774,10 @@ function isConnected(accounts, provider) {
 function useAccounts() {
   const relay = useRelay();
   const { member } = useExperience();
-  const [accounts, setAccounts] = useState6(null);
-  const [error, setError] = useState6(null);
-  const [busy, setBusy] = useState6(false);
-  const refresh = useCallback2(async () => {
+  const [accounts, setAccounts] = useState7(null);
+  const [error, setError] = useState7(null);
+  const [busy, setBusy] = useState7(false);
+  const refresh = useCallback3(async () => {
     try {
       setAccounts(await relay.auth.accounts());
       setError(null);
@@ -637,7 +787,7 @@ function useAccounts() {
       );
     }
   }, [relay]);
-  useEffect5(() => {
+  useEffect6(() => {
     if (!member) {
       setAccounts(null);
       return;
@@ -682,8 +832,124 @@ function useAccounts() {
   };
 }
 
+// src/react/profiles.ts
+import { useCallback as useCallback4, useEffect as useEffect7, useRef as useRef2, useState as useState8 } from "react";
+var PROFILE_CHANGED = "relay-profile-changed";
+function useMyProfile() {
+  const relay = useRelay();
+  const { member } = useExperience();
+  const [profile, setProfile] = useState8(null);
+  const [error, setError] = useState8(null);
+  const [busy, setBusy] = useState8(false);
+  const session = useRef2(null);
+  const refresh = useCallback4(async () => {
+    try {
+      const [current, value] = await Promise.all([
+        relay.auth.session(),
+        relay.profiles.mine()
+      ]);
+      session.current = current?.id ?? null;
+      setProfile(value);
+      setError(null);
+    } catch (cause) {
+      setError(
+        cause instanceof Error && cause.message ? cause.message : "Could not load your profile."
+      );
+    }
+  }, [relay]);
+  useEffect7(() => {
+    if (!member) {
+      setProfile(null);
+      session.current = null;
+      return;
+    }
+    const update = () => void refresh();
+    update();
+    window.addEventListener("focus", update);
+    window.addEventListener(PROFILE_CHANGED, update);
+    return () => {
+      window.removeEventListener("focus", update);
+      window.removeEventListener(PROFILE_CHANGED, update);
+    };
+  }, [member, refresh]);
+  async function run(task, fallback) {
+    setBusy(true);
+    setError(null);
+    try {
+      const value = await task(session.current ?? void 0);
+      setProfile(value);
+      window.dispatchEvent(new Event(PROFILE_CHANGED));
+      return true;
+    } catch (cause) {
+      setError(
+        cause instanceof Error && cause.message ? cause.message : fallback
+      );
+      return false;
+    } finally {
+      setBusy(false);
+    }
+  }
+  return {
+    /** Null until read, and while nobody is signed in. */
+    profile,
+    error,
+    busy,
+    refresh,
+    /** Resolves true once saved; a failure sets `error`. */
+    update: (input) => run(
+      (value) => relay.profiles.update(input, { session: value }),
+      "Couldn't save your profile. Try again."
+    ),
+    /** Uploads a JPEG, PNG or WebP of at most 5 MB as the avatar; resolves true once saved. */
+    uploadAvatar: (file) => run(
+      (value) => relay.profiles.uploadAvatar(file, {
+        uploadId: crypto.randomUUID(),
+        session: value
+      }),
+      "Couldn't upload this picture. Try again."
+    )
+  };
+}
+function useProfile(id, options = {}) {
+  const relay = useRelay();
+  const { member } = useExperience();
+  const { intervalMs = 6e4 } = options;
+  const [state, setState] = useState8({ status: "loading" });
+  const refresh = useCallback4(async () => {
+    try {
+      const profile = await relay.profiles.get(id);
+      setState({ status: "ready", profile, stale: null });
+    } catch (cause) {
+      if (cause instanceof RelayError && cause.status === 404) {
+        setState({ status: "missing" });
+        return;
+      }
+      const message = cause instanceof Error && cause.message ? cause.message : "Could not load the profile.";
+      setState(
+        (previous) => previous.status === "ready" ? { ...previous, stale: message } : { status: "error", message }
+      );
+    }
+  }, [relay, id]);
+  useEffect7(() => {
+    setState({ status: "loading" });
+    void refresh();
+    const timer = setInterval(() => {
+      if (document.visibilityState === "visible") {
+        void refresh();
+      }
+    }, intervalMs);
+    const changed = () => void refresh();
+    window.addEventListener(PROFILE_CHANGED, changed);
+    return () => {
+      clearInterval(timer);
+      window.removeEventListener(PROFILE_CHANGED, changed);
+    };
+  }, [refresh, member, intervalMs]);
+  return { ...state, refresh };
+}
+
 // src/react/referrals.ts
-import { useCallback as useCallback3, useEffect as useEffect6, useRef as useRef2, useState as useState7 } from "react";
+import { useCallback as useCallback5, useEffect as useEffect8, useRef as useRef3, useState as useState9 } from "react";
 var PENDING = "domino:pending-referral";
 var CODE = /^[a-zA-Z0-9_-]{1,100}$/;
 function captureReferralCode(param = "ref") {
@@ -709,12 +975,12 @@ function forgetReferralCode() {
 function useInvitation(param = "ref") {
   const relay = useRelay();
   const { member } = useExperience();
-  const [state, setState] = useState7(() => {
+  const [state, setState] = useState9(() => {
     const code = captureReferralCode(param);
     return code ? { status: "pending", code } : { status: "none" };
   });
-  const started = useRef2(null);
-  const accept = useCallback3(
+  const started = useRef3(null);
+  const accept = useCallback5(
     async (code) => {
       setState({ status: "accepting", code });
       try {
@@ -735,7 +1001,7 @@ function useInvitation(param = "ref") {
     },
     [relay]
   );
-  useEffect6(() => {
+  useEffect8(() => {
     if (member && state.status === "pending" && started.current !== `${member}:${state.code}`) {
       started.current = `${member}:${state.code}`;
       void accept(state.code);
@@ -746,9 +1012,9 @@ function useInvitation(param = "ref") {
 function useReferralSummary(options = {}) {
   const relay = useRelay();
   const { member } = useExperience();
-  const [summary, setSummary] = useState7(null);
-  const [error, setError] = useState7(null);
-  const refresh = useCallback3(async () => {
+  const [summary, setSummary] = useState9(null);
+  const [error, setError] = useState9(null);
+  const refresh = useCallback5(async () => {
     try {
       setSummary(await relay.referrals.summary());
       setError(null);
@@ -758,7 +1024,7 @@ function useReferralSummary(options = {}) {
       );
     }
   }, [relay]);
-  useEffect6(() => {
+  useEffect8(() => {
     setSummary(null);
     if (member) {
       void refresh();
@@ -774,13 +1040,13 @@ function useReferralSummary(options = {}) {
 }
 
 // src/react/leaderboards.ts
-import { useCallback as useCallback4, useEffect as useEffect7, useState as useState8 } from "react";
+import { useCallback as useCallback6, useEffect as useEffect9, useState as useState10 } from "react";
 function useLeaderboard(board, options = {}) {
   const relay = useRelay();
   const { member } = useExperience();
   const { limit = 25, intervalMs = 3e4 } = options;
-  const [state, setState] = useState8({ status: "loading" });
-  const refresh = useCallback4(async () => {
+  const [state, setState] = useState10({ status: "loading" });
+  const refresh = useCallback6(async () => {
     try {
       const page = await relay.leaderboards.standings(board, { limit });
       setState({ status: "ready", page, stale: null });
@@ -791,7 +1057,7 @@ function useLeaderboard(board, options = {}) {
       );
     }
   }, [relay, board, limit]);
-  useEffect7(() => {
+  useEffect9(() => {
     void refresh();
     const timer = setInterval(() => {
       if (document.visibilityState === "visible") {
@@ -804,11 +1070,11 @@ function useLeaderboard(board, options = {}) {
 }
 
 // src/react/references.ts
-import { useCallback as useCallback5, useEffect as useEffect8, useState as useState9 } from "react";
+import { useCallback as useCallback7, useEffect as useEffect10, useState as useState11 } from "react";
 function useReferences(read, failure) {
   const relay = useRelay();
-  const [state, setState] = useState9({ status: "loading" });
-  const refresh = useCallback5(async () => {
+  const [state, setState] = useState11({ status: "loading" });
+  const refresh = useCallback7(async () => {
     try {
       setState({ status: "ready", items: await read(relay) });
     } catch (cause) {
@@ -818,7 +1084,7 @@ function useReferences(read, failure) {
       });
     }
   }, [relay, read, failure]);
-  useEffect8(() => {
+  useEffect10(() => {
     void refresh();
   }, [refresh]);
   return { ...state, refresh };
@@ -833,13 +1099,16 @@ function useTieredRewards() {
 }
 export {
   PENDING_POLL_MS,
+  PROFILE_CHANGED,
   RETRY_DELAYS_MS,
   RelayProvider,
+  avatarSrc,
   canRepeat,
   canSubmit,
   captureReferralCode,
   completionCountLabel,
   completionMark,
+  defaultAvatar,
   hasPending,
   isAutomatic,
   isConnected,
@@ -854,14 +1123,21 @@ export {
   useExperience,
   useInvitation,
   useLeaderboard,
+  useMe,
+  useMyProfile,
   usePointLedgers,
+  useProfile,
   useQuest,
   useReferralSummary,
   useRelay,
   useSignIn,
   useSignInMethods,
+  useSignInWallets,
   useSignOut,
   useTieredRewards,
+  useWalletDiscovery,
+  useWallets,
   visibleQuests,
+  walletAvatarSeed,
   watchRoleDeliveries
 };

package/dist/schema.d.ts

@@ -145,6 +145,17 @@ declare const triggerSchema: z.ZodUnion<readonly [z.ZodObject<{
             claim: "claim";
         }>>;
     }, z.core.$strict>>;
+    tracker: z.ZodOptional<z.ZodObject<{
+        tracker: z.ZodString;
+        source: z.ZodEnum<{
+            custom: "custom";
+            "x-search": "x-search";
+        }>;
+        beneficiary: z.ZodEnum<{
+            author: "author";
+            "replied-to": "replied-to";
+        }>;
+    }, z.core.$strict>>;
 }, z.core.$strict>]>;
 declare const prerequisiteSchema: z.ZodObject<{
     quest: z.ZodString;
@@ -493,6 +504,17 @@ declare const questDescriptionSchema: z.ZodObject<{
                 claim: "claim";
             }>>;
         }, z.core.$strict>>;
+        tracker: z.ZodOptional<z.ZodObject<{
+            tracker: z.ZodString;
+            source: z.ZodEnum<{
+                custom: "custom";
+                "x-search": "x-search";
+            }>;
+            beneficiary: z.ZodEnum<{
+                author: "author";
+                "replied-to": "replied-to";
+            }>;
+        }, z.core.$strict>>;
     }, z.core.$strict>]>;
     performance: z.ZodOptional<z.ZodObject<{
         metrics: z.ZodArray<z.ZodEnum<{
@@ -531,6 +553,7 @@ declare const questDescriptionSchema: z.ZodObject<{
         period: z.ZodEnum<{
             lifetime: "lifetime";
             day: "day";
+            week: "week";
         }>;
         limit: z.ZodNumber;
         cost: z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
@@ -788,6 +811,17 @@ declare const publishedReleaseSchema: z.ZodUnion<readonly [z.ZodObject<{
                 claim: "claim";
             }>>;
         }, z.core.$strict>>;
+        tracker: z.ZodOptional<z.ZodObject<{
+            tracker: z.ZodString;
+            source: z.ZodEnum<{
+                custom: "custom";
+                "x-search": "x-search";
+            }>;
+            beneficiary: z.ZodEnum<{
+                author: "author";
+                "replied-to": "replied-to";
+            }>;
+        }, z.core.$strict>>;
     }, z.core.$strict>]>;
     performance: z.ZodOptional<z.ZodObject<{
         metrics: z.ZodArray<z.ZodEnum<{
@@ -826,6 +860,7 @@ declare const publishedReleaseSchema: z.ZodUnion<readonly [z.ZodObject<{
         period: z.ZodEnum<{
             lifetime: "lifetime";
             day: "day";
+            week: "week";
         }>;
         limit: z.ZodNumber;
         cost: z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
@@ -1060,6 +1095,11 @@ declare const publishedReleaseSchema: z.ZodUnion<readonly [z.ZodObject<{
             posts: "after-enrollment" | "since-start";
             historical: "staff" | "automatic" | "claim";
         } | undefined;
+        tracker?: {
+            tracker: string;
+            source: "custom" | "x-search";
+            beneficiary: "author" | "replied-to";
+        } | undefined;
     } | {
         kind: "manual";
         input: "text";
@@ -1099,7 +1139,7 @@ declare const publishedReleaseSchema: z.ZodUnion<readonly [z.ZodObject<{
     budgets: {
         id: string;
         scope: "member" | "project";
-        period: "lifetime" | "day";
+        period: "lifetime" | "day" | "week";
         limit: number;
         cost: number | {
             balance: string;
@@ -1374,6 +1414,17 @@ declare const templateSchema: z.ZodObject<{
                     claim: "claim";
                 }>>;
             }, z.core.$strict>>;
+            tracker: z.ZodOptional<z.ZodObject<{
+                tracker: z.ZodString;
+                source: z.ZodEnum<{
+                    custom: "custom";
+                    "x-search": "x-search";
+                }>;
+                beneficiary: z.ZodEnum<{
+                    author: "author";
+                    "replied-to": "replied-to";
+                }>;
+            }, z.core.$strict>>;
         }, z.core.$strict>]>;
         performance: z.ZodOptional<z.ZodObject<{
             metrics: z.ZodArray<z.ZodEnum<{
@@ -1412,6 +1463,7 @@ declare const templateSchema: z.ZodObject<{
             period: z.ZodEnum<{
                 lifetime: "lifetime";
                 day: "day";
+                week: "week";
             }>;
             limit: z.ZodNumber;
             cost: z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
@@ -1840,6 +1892,17 @@ declare const memberProgressSchema: z.ZodObject<{
                     claim: "claim";
                 }>>;
             }, z.core.$strict>>;
+            tracker: z.ZodOptional<z.ZodObject<{
+                tracker: z.ZodString;
+                source: z.ZodEnum<{
+                    custom: "custom";
+                    "x-search": "x-search";
+                }>;
+                beneficiary: z.ZodEnum<{
+                    author: "author";
+                    "replied-to": "replied-to";
+                }>;
+            }, z.core.$strict>>;
         }, z.core.$strict>]>;
         availability: z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"available">;
@@ -2260,6 +2323,17 @@ declare const snapshotSchema: z.ZodObject<{
                     claim: "claim";
                 }>>;
             }, z.core.$strict>>;
+            tracker: z.ZodOptional<z.ZodObject<{
+                tracker: z.ZodString;
+                source: z.ZodEnum<{
+                    custom: "custom";
+                    "x-search": "x-search";
+                }>;
+                beneficiary: z.ZodEnum<{
+                    author: "author";
+                    "replied-to": "replied-to";
+                }>;
+            }, z.core.$strict>>;
         }, z.core.$strict>]>;
         performance: z.ZodOptional<z.ZodObject<{
             metrics: z.ZodArray<z.ZodEnum<{
@@ -2298,6 +2372,7 @@ declare const snapshotSchema: z.ZodObject<{
             period: z.ZodEnum<{
                 lifetime: "lifetime";
                 day: "day";
+                week: "week";
             }>;
             limit: z.ZodNumber;
             cost: z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
@@ -2532,6 +2607,11 @@ declare const snapshotSchema: z.ZodObject<{
                 posts: "after-enrollment" | "since-start";
                 historical: "staff" | "automatic" | "claim";
             } | undefined;
+            tracker?: {
+                tracker: string;
+                source: "custom" | "x-search";
+                beneficiary: "author" | "replied-to";
+            } | undefined;
         } | {
             kind: "manual";
             input: "text";
@@ -2571,7 +2651,7 @@ declare const snapshotSchema: z.ZodObject<{
         budgets: {
             id: string;
             scope: "member" | "project";
-            period: "lifetime" | "day";
+            period: "lifetime" | "day" | "week";
             limit: number;
             cost: number | {
                 balance: string;

package/dist/schema.js

@@ -59,7 +59,7 @@ import {
   tieredRewardDefinitionSchema,
   tieredRewardReferenceSchema,
   triggerSchema
-} from "./chunk-UYS522ER.js";
+} from "./chunk-IXLY3A7B.js";
 export {
   artifactSchema,
   attemptSchema,