@domino-sdk/relay 1.0.0-next.16 → 1.0.0-next.17

package/dist/browser.d.ts

@@ -607,7 +607,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                 seed: string;
             };
             displayName: string | null;
-            avatarChoice: "default" | "account" | "upload" | "generated";
+            avatarChoice: "default" | "upload" | "account" | "generated";
             avatarProvider: "x" | "discord" | "google" | null;
             hidden: boolean;
             locked: boolean;
@@ -635,7 +635,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                 seed: string;
             };
             displayName: string | null;
-            avatarChoice: "default" | "account" | "upload" | "generated";
+            avatarChoice: "default" | "upload" | "account" | "generated";
             avatarProvider: "x" | "discord" | "google" | null;
             hidden: boolean;
             locked: boolean;
@@ -665,7 +665,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                 seed: string;
             };
             displayName: string | null;
-            avatarChoice: "default" | "account" | "upload" | "generated";
+            avatarChoice: "default" | "upload" | "account" | "generated";
             avatarProvider: "x" | "discord" | "google" | null;
             hidden: boolean;
             locked: boolean;
@@ -818,7 +818,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
             };
             availability: {
                 kind: "available";
-                input: "text" | "url" | "none" | "quiz" | "photo";
+                input: "url" | "text" | "none" | "quiz" | "photo";
             } | {
                 kind: "completed";
             } | {
@@ -911,7 +911,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                 } | undefined;
             } | null;
             release: string;
-            interaction: "text" | "url" | "automatic" | "claim" | "staff" | "quiz" | "photo";
+            interaction: "url" | "text" | "automatic" | "claim" | "staff" | "quiz" | "photo";
             lifecycle: "paused" | "active" | "archived";
             rewards: ({
                 kind: "points";
@@ -1124,7 +1124,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                 };
                 availability: {
                     kind: "available";
-                    input: "text" | "url" | "none" | "quiz" | "photo";
+                    input: "url" | "text" | "none" | "quiz" | "photo";
                 } | {
                     kind: "completed";
                 } | {
@@ -1217,7 +1217,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                     } | undefined;
                 } | null;
                 release: string;
-                interaction: "text" | "url" | "automatic" | "claim" | "staff" | "quiz" | "photo";
+                interaction: "url" | "text" | "automatic" | "claim" | "staff" | "quiz" | "photo";
                 lifecycle: "paused" | "active" | "archived";
                 rewards: ({
                     kind: "points";
@@ -1377,7 +1377,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                     };
                     availability: {
                         kind: "available";
-                        input: "text" | "url" | "none" | "quiz" | "photo";
+                        input: "url" | "text" | "none" | "quiz" | "photo";
                     } | {
                         kind: "completed";
                     } | {
@@ -1470,7 +1470,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                         } | undefined;
                     } | null;
                     release: string;
-                    interaction: "text" | "url" | "automatic" | "claim" | "staff" | "quiz" | "photo";
+                    interaction: "url" | "text" | "automatic" | "claim" | "staff" | "quiz" | "photo";
                     lifecycle: "paused" | "active" | "archived";
                     rewards: ({
                         kind: "points";
@@ -1633,7 +1633,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                 };
                 availability: {
                     kind: "available";
-                    input: "text" | "url" | "none" | "quiz" | "photo";
+                    input: "url" | "text" | "none" | "quiz" | "photo";
                 } | {
                     kind: "completed";
                 } | {
@@ -1726,7 +1726,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                     } | undefined;
                 } | null;
                 release: string;
-                interaction: "text" | "url" | "automatic" | "claim" | "staff" | "quiz" | "photo";
+                interaction: "url" | "text" | "automatic" | "claim" | "staff" | "quiz" | "photo";
                 lifecycle: "paused" | "active" | "archived";
                 rewards: ({
                     kind: "points";
@@ -2108,7 +2108,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                 };
                 availability: {
                     kind: "available";
-                    input: "text" | "url" | "none" | "quiz" | "photo";
+                    input: "url" | "text" | "none" | "quiz" | "photo";
                 } | {
                     kind: "completed";
                 } | {

package/dist/react/index.d.ts

@@ -2598,7 +2598,7 @@ type RoleDeliveryStatus = KnownRoleDeliveryStatus | (string & {});
  * changes whether the quest is completed: the role follows the completion.
  * `failed` means Domino gave up; only the organizer can grant the role now.
  */
-declare function roleDeliveryStatus(deliveries: RoleDelivery[], quest: string): KnownRoleDeliveryStatus | null;
+declare function roleDeliveryStatus(deliveries: readonly RoleDelivery[], quest: string): RoleDeliveryStatus | null;
 /** `roleDeliveryStatus` in English, or null for null. */
 declare function roleDeliveryLabel(status: RoleDeliveryStatus | null): "Role delivery pending" | "Role delivery failed" | "Role granted" | null;
 
@@ -2609,7 +2609,7 @@ declare function roleDeliveryLabel(status: RoleDeliveryStatus | null): "Role del
  * has arrived yet.
  */
 declare function useExperience(): MemberQuery<ExperienceData> & {
-    deliveries: RoleDelivery[];
+    deliveries: readonly RoleDelivery[];
 };
 
 type QuestInput = {
@@ -2636,8 +2636,20 @@ type QuestNotice = "received" | "quest-updated" | null;
  * - When the quest changed underneath the participant, nothing is resubmitted
  *   for them. They see the latest version with whatever draft still applies.
  * - An interrupted submission is resumed, never duplicated.
+ *
+ * The actions keep their identity across renders and act on the latest `view`; the returned object
+ * changes only when something in it does.
  */
 declare function useQuest(observed: QuestView): {
+    restart: () => Promise<void>;
+    submit: (input: QuestInput) => Promise<void>;
+    /** Finish an interrupted submission, or reopen an outdated draft. */
+    resume: () => Promise<void>;
+    /**
+     * Re-run verification that failed to run. Never creates a new attempt.
+     * Domino refuses this for automatic quests, so never offer it for them.
+     */
+    retry: () => Promise<void>;
     /** The newest known version of the quest. Render this, not the prop. */
     view: {
         quest: string;
@@ -2898,15 +2910,6 @@ declare function useQuest(observed: QuestView): {
     /** The attempt the last "received" notice is about. */
     receipt: string | null;
     startingFresh: boolean;
-    restart: () => Promise<void>;
-    submit: (input: QuestInput) => Promise<void>;
-    /** Finish an interrupted submission, or reopen an outdated draft. */
-    resume: () => Promise<void>;
-    /**
-     * Re-run verification that failed to run. Never creates a new attempt.
-     * Domino refuses this for automatic quests, so never offer it for them.
-     */
-    retry: () => Promise<void>;
 };
 
 type QuestTone = "open" | "done" | "waiting" | "attention" | "locked" | "off";
@@ -2956,8 +2959,12 @@ declare function isFinished(view: QuestView): boolean;
  * status and nothing to press.
  */
 declare function isAutomatic(view: QuestView): boolean;
-/** "Completed 3 times" for repeatable quests, otherwise nothing. */
-declare function completionCountLabel(view: QuestView): string | null;
+/**
+ * How often a repeatable quest was completed, in English ("Completed once", "Completed 3 times"),
+ * or null for a quest that is not repeatable or was never completed. To use your own words, read
+ * `view.completionCount` where `view.completion.kind` is `keyed`.
+ */
+declare function completionCountText(view: QuestView): string | null;
 /**
  * True when a repeatable quest's latest submission was accepted. The quest is
  * open again, so show the normal submit action rather than a finished state.
@@ -2965,11 +2972,10 @@ declare function completionCountLabel(view: QuestView): string | null;
 declare function canRepeat(view: QuestView): boolean;
 /**
  * What a QuestView means for the participant, as a tone and a code. Pure and free of copy: render
- * the code in your own words, or call `questStatusText` for English.
+ * the code in your own words, or call `questStatusText` for English. The code is an open string,
+ * so a `switch` over it needs a `default` for codes a newer SDK adds.
  */
-declare function questStatus(view: QuestView): QuestStatus & {
-    code: KnownQuestStatusCode;
-};
+declare function questStatus(view: QuestView): QuestStatus;
 /**
  * `questStatus` in English, for apps that do not localize: a `label` such as "In review", and a
  * `detail` sentence when there is more to say.
@@ -2977,6 +2983,12 @@ declare function questStatus(view: QuestView): QuestStatus & {
 declare function questStatusText(view: QuestView): QuestStatusText;
 /** True when the participant can submit something right now. */
 declare function canSubmit(view: QuestView): boolean;
+/**
+ * "x of y completed" for a list of quests: `total` counts every quest that is not archived or
+ * repeatable, including locked and paused ones, because they are still part of what the
+ * participant works through; `done` counts those that are finished (`isFinished`). A repeatable
+ * quest is never finished, so it stays out of both.
+ */
 declare function progressOf(quests: QuestView[]): {
     total: number;
     done: number;
@@ -3012,6 +3024,11 @@ declare function useSignIn(): {
     /** Signs in, or signs up, with a wallet; the wallet asks the participant to sign a message. */
     withWallet: (signer: WalletSigner) => Promise<void>;
 };
+/**
+ * Signs the participant out. Once Relay confirms, the previous member's cached values are gone and
+ * the member hooks report `signed-out`. `signOut` keeps its identity across renders, and rejects
+ * when Relay could not sign out.
+ */
 declare function useSignOut(): {
     busy: boolean;
     signOut: () => Promise<void>;
@@ -3296,7 +3313,7 @@ declare function useProfileReferral(profile: string, program: string, options?:
  * A profile's completions of quests that show on profiles (`relay.profiles.completions`), most
  * recently completed first, `limit` quests at a time: `data.items`, and `data.nextCursor` while
  * there are more. `loadMore()` appends the next page; `refresh()` starts again from the first, as a
- * quest submission or a profile change does.
+ * new completion in the experience or a profile change does.
  */
 declare function useProfileCompletions(profile: string, options?: {
     limit?: number;
@@ -3349,11 +3366,14 @@ declare function useInvitation(param?: string): {
 /**
  * The signed-in participant's invitation code and progress in `data`: attributed friends,
  * qualified friends per program, milestones, and points. `link` is the share link, null until the
- * summary is read. Read again after an invitation is accepted and after a quest submission.
+ * summary is read. Read again every `intervalMs` (default 60 seconds) while the page is visible, so
+ * friends who qualify show up, after an invitation is accepted, and when a new completion appears
+ * in the experience.
  */
 declare function useReferralSummary(options?: {
     path?: string;
     param?: string;
+    intervalMs?: number;
 }): MemberQuery<ReferralSummary> & {
     link: string | null;
 };
@@ -3361,9 +3381,9 @@ declare function useReferralSummary(options?: {
 /**
  * One leaderboard's top rows plus the participant's own row and neighbours, in `data`.
  *
- * Read again every `intervalMs` while the page is visible, after a quest submission, and for each
- * participant who signs in. Boards default to participants-only access: signed-out visitors get
- * an error unless the board is published as public.
+ * Read again every `intervalMs` while the page is visible, when a new completion appears in the
+ * experience, and for each participant who signs in. Boards default to participants-only access:
+ * signed-out visitors get an error unless the board is published as public.
  */
 declare function useLeaderboard(board: string, options?: {
     limit?: number;
@@ -3402,4 +3422,4 @@ declare function usePointLedgers(): Query<PointLedgerReference[]>;
  */
 declare function useTieredRewards(): Query<TieredRewardReference[]>;
 
-export { type Collection, CosmosChains, DiscoveredWallet, type ExperienceData, type Invitation, type KnownQuestStatusCode, type KnownRoleDeliveryStatus, type MemberPagedQuery, type MemberQuery, type MemberSnapshot, type OAuthProvider, Page, type PageLoader, type PageRead, type PagedQuery, type Query, type QueryContext, type QueryKey, type QueryOptions, type QueryRead, type QuerySnapshot, type QuestInput, type QuestNotice, type QuestStatus, type QuestStatusCode, type QuestStatusText, type QuestTone, type ReferralSummary, type RelayClient, RelayProvider, type RoleDelivery, type RoleDeliveryStatus, type SavedSubmission, SignInMethods, SignInOption, SignInUnavailable, SignInWallet, canRepeat, canSubmit, captureReferralCode, completionCountLabel, isAutomatic, isConnected, isFinished, progressOf, questGroups, questStatus, questStatusText, relayKeys, roleDeliveryLabel, roleDeliveryStatus, useAccounts, useBalances, useExperience, useInvalidate, useInvitation, useLeaderboard, useLeaderboardPlacement, useMe, useMemberPages, useMemberQuery, useMyProfile, usePointHistory, usePointLedgers, useProfile, useProfileCompletions, useProfileReferral, useQuest, useReferralSummary, useRelay, useRelayPages, useRelayQuery, useSession, useSignIn, useSignInMethods, useSignInOptions, useSignInWallets, useSignOut, useTieredRewards, useWalletDiscovery, useWallets };
+export { type Collection, CosmosChains, DiscoveredWallet, type ExperienceData, type Invitation, type KnownQuestStatusCode, type KnownRoleDeliveryStatus, type MemberPagedQuery, type MemberQuery, type MemberSnapshot, type OAuthProvider, Page, type PageLoader, type PageRead, type PagedQuery, type Query, type QueryContext, type QueryKey, type QueryOptions, type QueryRead, type QuerySnapshot, type QuestInput, type QuestNotice, type QuestStatus, type QuestStatusCode, type QuestStatusText, type QuestTone, type ReferralSummary, type RelayClient, RelayProvider, type RoleDelivery, type RoleDeliveryStatus, type SavedSubmission, SignInMethods, SignInOption, SignInUnavailable, SignInWallet, canRepeat, canSubmit, captureReferralCode, completionCountText, isAutomatic, isConnected, isFinished, progressOf, questGroups, questStatus, questStatusText, relayKeys, roleDeliveryLabel, roleDeliveryStatus, useAccounts, useBalances, useExperience, useInvalidate, useInvitation, useLeaderboard, useLeaderboardPlacement, useMe, useMemberPages, useMemberQuery, useMyProfile, usePointHistory, usePointLedgers, useProfile, useProfileCompletions, useProfileReferral, useQuest, useReferralSummary, useRelay, useRelayPages, useRelayQuery, useSession, useSignIn, useSignInMethods, useSignInOptions, useSignInWallets, useSignOut, useTieredRewards, useWalletDiscovery, useWallets };

package/dist/react/index.js

@@ -146,6 +146,7 @@ function watchRoleDeliveries(options) {
 
 // src/react/use-role-deliveries.ts
 import { useEffect, useState } from "react";
+var NONE = Object.freeze([]);
 function useRoleDeliveries(relay, member, completions) {
   const [state, setState] = useState(null);
   useEffect(() => {
@@ -169,12 +170,12 @@ function useRoleDeliveries(relay, member, completions) {
       document.removeEventListener("visibilitychange", wake);
     };
   }, [relay, member, completions]);
-  return member && completions && state?.member === member ? state.deliveries : [];
+  return member && completions && state?.member === member ? state.deliveries : NONE;
 }
 
 // src/react/experience.tsx
 import { jsx } from "react/jsx-runtime";
-var Deliveries = createContext2([]);
+var Deliveries = createContext2(Object.freeze([]));
 function useExperienceSnapshot() {
   const store = useStore();
   const get = () => store.experience;
@@ -503,7 +504,7 @@ function isAutomatic(view) {
 function runsSilently(view) {
   return view.trigger.kind === "automatic" && (view.completion.kind === "keyed" || Boolean(view.trigger.tracker));
 }
-function completionCountLabel(view) {
+function completionCountText(view) {
   if (view.completion.kind !== "keyed" || view.completionCount < 1) {
     return null;
   }
@@ -516,6 +517,9 @@ function visibleQuests(quests) {
   return quests.filter((q) => q.visibility !== "hidden");
 }
 function questStatus(view) {
+  return knownStatus(view);
+}
+function knownStatus(view) {
   if (isFinished(view)) {
     return { tone: "done", code: "completed" };
   }
@@ -569,7 +573,7 @@ function questStatus(view) {
   }
 }
 function questStatusText(view) {
-  const status = questStatus(view);
+  const status = knownStatus(view);
   const words = (label, detail) => detail === void 0 ? { ...status, label } : { ...status, label, detail };
   const rejection = status.reason === void 0 ? null : sentence(status.reason || "That submission wasn't accepted.");
   switch (status.code) {
@@ -604,7 +608,7 @@ function questStatusText(view) {
       return words(
         "Automatic",
         view.completion.kind === "keyed" ? [
-          completionCountLabel(view),
+          completionCountText(view),
           "This counts by itself each time you qualify."
         ].filter(Boolean).join(". ") : "This updates by itself when you qualify."
       );
@@ -789,9 +793,21 @@ var RelayStore = class {
       }
     }
   }
-  /** Writes a value a change returned into the current participant's cache (`QueryCache.set`). */
-  set(key, data) {
-    this.#scope?.cache.set(key, data);
+  /**
+   * Signs the participant out through the client, and drops their scope as soon as Relay confirms:
+   * the previous member's values never wait on the next session read, which may fail. Only the
+   * scope that signed out is dropped: someone who signed in while the request was in flight stays.
+   */
+  async signOut() {
+    const scope = this.#scope;
+    await this.client.auth.signOut();
+    if (!this.#mounted || this.#scope !== scope) {
+      return;
+    }
+    this.#sessionVersion++;
+    this.#sessionRead?.abort();
+    this.#setSession({ status: "ready", data: null, error: null });
+    this.#emit();
   }
   refreshExperience() {
     return this.#observer?.refresh() ?? Promise.resolve();
@@ -1202,7 +1218,14 @@ function questGroups(experience, order = []) {
 }
 
 // src/react/use-quest.ts
-import { useCallback as useCallback3, useEffect as useEffect4, useState as useState3 } from "react";
+import {
+  useCallback as useCallback3,
+  useEffect as useEffect4,
+  useLayoutEffect as useLayoutEffect2,
+  useMemo as useMemo4,
+  useRef as useRef2,
+  useState as useState3
+} from "react";
 function useQuest(observed) {
   const store = useStore();
   const relay = store.client;
@@ -1259,83 +1282,100 @@ function useQuest(observed) {
     },
     [store]
   );
-  return {
-    /** The newest known version of the quest. Render this, not the prop. */
-    view,
-    /** Input recovered after the quest changed. Prefill the form with it. */
-    draft,
-    notice,
-    error,
-    busy,
-    saved,
-    /** The attempt the last "received" notice is about. */
-    receipt,
-    startingFresh: view.attempt?.id === discardedAttempt && view.attempt?.status === "failed",
-    restart: async () => {
-      setBusy(true);
-      setError(null);
-      try {
-        await (await relay.quests.open(view)).discard();
-        setDiscardedAttempt(view.attempt?.id ?? null);
-        setSaved("none");
-        setDraft(null);
-        setNotice(null);
-      } catch (cause) {
-        setError(asRelayError(cause, "Could not start a new submission."));
-      } finally {
-        setBusy(false);
-      }
-    },
-    submit: (input) => run(async () => {
-      if (view.connections.length) {
-        const accounts = await relay.auth.accounts();
-        const missing = view.connections.find(
-          (provider) => !accounts.some(
-            (account) => account.provider === provider && account.configured && account.status === "connected"
-          )
-        );
-        if (missing) {
-          throw new Error(`Connect ${missing} before verifying.`);
+  const shown = useRef2(view);
+  useLayoutEffect2(() => {
+    shown.current = view;
+  });
+  const actions = useMemo4(
+    () => ({
+      restart: async () => {
+        const current = shown.current;
+        setBusy(true);
+        setError(null);
+        try {
+          await (await relay.quests.open(current)).discard();
+          setDiscardedAttempt(current.attempt?.id ?? null);
+          setSaved("none");
+          setDraft(null);
+          setNotice(null);
+        } catch (cause) {
+          setError(asRelayError(cause, "Could not start a new submission."));
+        } finally {
+          setBusy(false);
         }
-      }
-      const controller = await relay.quests.open(view);
-      if ((controller.kind === "text" || controller.kind === "url") && input.kind === controller.kind) {
-        return controller.submit(input.value);
-      }
-      if (controller.kind === "claim" && input.kind === "claim") {
-        return controller.submit();
-      }
-      if (controller.kind === "quiz" && input.kind === "quiz") {
-        return controller.submit(input.answers);
-      }
-      if (controller.kind === "photo" && input.kind === "photo") {
-        return controller.submit(input.file);
-      }
-      throw new Error("This activity changed. Reload and try again.");
+      },
+      submit: (input) => run(async () => {
+        const current = shown.current;
+        if (current.connections.length) {
+          const accounts = await relay.auth.accounts();
+          const missing = current.connections.find(
+            (provider) => !accounts.some(
+              (account) => account.provider === provider && account.configured && account.status === "connected"
+            )
+          );
+          if (missing) {
+            throw new Error(`Connect ${missing} before verifying.`);
+          }
+        }
+        const controller = await relay.quests.open(current);
+        if ((controller.kind === "text" || controller.kind === "url") && input.kind === controller.kind) {
+          return controller.submit(input.value);
+        }
+        if (controller.kind === "claim" && input.kind === "claim") {
+          return controller.submit();
+        }
+        if (controller.kind === "quiz" && input.kind === "quiz") {
+          return controller.submit(input.answers);
+        }
+        if (controller.kind === "photo" && input.kind === "photo") {
+          return controller.submit(input.file);
+        }
+        throw new Error("This activity changed. Reload and try again.");
+      }),
+      /** Finish an interrupted submission, or reopen an outdated draft. */
+      resume: () => run(async () => (await relay.quests.open(shown.current)).resume()),
+      /**
+       * Re-run verification that failed to run. Never creates a new attempt.
+       * Domino refuses this for automatic quests, so never offer it for them.
+       */
+      retry: () => run(async () => {
+        const current = shown.current;
+        if (isAutomatic(current)) {
+          throw new Error("This activity updates by itself.");
+        }
+        return {
+          kind: "submitted",
+          attempt: await relay.quests.retry(current)
+        };
+      })
     }),
-    /** Finish an interrupted submission, or reopen an outdated draft. */
-    resume: () => run(async () => (await relay.quests.open(view)).resume()),
-    /**
-     * Re-run verification that failed to run. Never creates a new attempt.
-     * Domino refuses this for automatic quests, so never offer it for them.
-     */
-    retry: () => run(async () => {
-      if (isAutomatic(view)) {
-        throw new Error("This activity updates by itself.");
-      }
-      return {
-        kind: "submitted",
-        attempt: await relay.quests.retry(view)
-      };
-    })
-  };
+    [relay, run]
+  );
+  const startingFresh = view.attempt?.id === discardedAttempt && view.attempt?.status === "failed";
+  return useMemo4(
+    () => ({
+      /** The newest known version of the quest. Render this, not the prop. */
+      view,
+      /** Input recovered after the quest changed. Prefill the form with it. */
+      draft,
+      notice,
+      error,
+      busy,
+      saved,
+      /** The attempt the last "received" notice is about. */
+      receipt,
+      startingFresh,
+      ...actions
+    }),
+    [view, draft, notice, error, busy, saved, receipt, startingFresh, actions]
+  );
 }
 
 // src/react/auth.ts
-import { useCallback as useCallback4, useMemo as useMemo5, useRef as useRef2, useState as useState5 } from "react";
+import { useCallback as useCallback4, useMemo as useMemo6, useRef as useRef3, useState as useState5 } from "react";
 
 // src/react/wallets.ts
-import { useEffect as useEffect5, useMemo as useMemo4, useState as useState4 } from "react";
+import { useEffect as useEffect5, useMemo as useMemo5, useState as useState4 } from "react";
 function useWallets() {
   const relay = useRelay();
   const invalidate = useInvalidate();
@@ -1346,7 +1386,7 @@ function useWallets() {
     { refetchOnFocus: true }
   );
   const { busy, actionError, run } = useAction();
-  const actions = useMemo4(() => {
+  const actions = useMemo5(() => {
     const changed = () => void invalidate([relayKeys.wallets, relayKeys.experience]);
     return {
       /** Links the wallet to the member the list was read for; another session is refused. */
@@ -1363,7 +1403,7 @@ function useWallets() {
       })
     };
   }, [relay, invalidate, session, run]);
-  return useMemo4(
+  return useMemo5(
     () => ({ ...query, busy, actionError, ...actions }),
     [query, busy, actionError, actions]
   );
@@ -1421,6 +1461,7 @@ ${chains}` : null;
 }
 
 // src/react/auth.ts
+var NONE_UNAVAILABLE = [];
 function useSignInMethods() {
   const relay = useRelay();
   return useRelayQuery(relayKeys.signInMethods, () => readSignInMethods(relay));
@@ -1432,7 +1473,7 @@ function useMe() {
 function useSignIn() {
   const relay = useRelay();
   const [challenge, setChallengeState] = useState5(null);
-  const latest = useRef2(null);
+  const latest = useRef3(null);
   const [busy, setBusy] = useState5(false);
   const [error, setError] = useState5(null);
   const setChallenge = useCallback4((value) => {
@@ -1489,37 +1530,48 @@ function useSignIn() {
     }, "Couldn't sign in with this wallet. Try again."),
     [relay, run, setChallenge]
   );
-  return {
-    busy,
-    error,
-    /** True once a code was sent and the form should ask for it. */
-    codeSent: challenge !== null,
-    sendCode,
-    verifyCode,
-    startOver,
-    withProvider,
-    /** Signs in, or signs up, with a wallet; the wallet asks the participant to sign a message. */
-    withWallet
-  };
+  const codeSent = challenge !== null;
+  return useMemo6(
+    () => ({
+      busy,
+      error,
+      /** True once a code was sent and the form should ask for it. */
+      codeSent,
+      sendCode,
+      verifyCode,
+      startOver,
+      withProvider,
+      /** Signs in, or signs up, with a wallet; the wallet asks the participant to sign a message. */
+      withWallet
+    }),
+    [
+      busy,
+      error,
+      codeSent,
+      sendCode,
+      verifyCode,
+      startOver,
+      withProvider,
+      withWallet
+    ]
+  );
 }
 function useSignOut() {
-  const relay = useRelay();
+  const store = useStore();
   const [busy, setBusy] = useState5(false);
-  return {
-    busy,
-    signOut: async () => {
-      setBusy(true);
-      try {
-        await relay.auth.signOut();
-      } finally {
-        setBusy(false);
-      }
+  const signOut = useCallback4(async () => {
+    setBusy(true);
+    try {
+      await store.signOut();
+    } finally {
+      setBusy(false);
     }
-  };
+  }, [store]);
+  return useMemo6(() => ({ busy, signOut }), [busy, signOut]);
 }
 function useSignInOptions(input = {}) {
   const chains = JSON.stringify(cosmosChainList(input.cosmos));
-  const cosmos = useMemo5(
+  const cosmos = useMemo6(
     () => JSON.parse(chains),
     [chains]
   );
@@ -1535,7 +1587,7 @@ function useSignInOptions(input = {}) {
     withProvider,
     withWallet
   } = useSignIn();
-  const built = useMemo5(() => {
+  const built = useMemo6(() => {
     if (!methods) {
       return null;
     }
@@ -1553,19 +1605,23 @@ function useSignInOptions(input = {}) {
       }
     });
   }, [methods, wallets, cosmos, withProvider, sendCode, verifyCode, withWallet]);
-  return {
-    options: built?.options ?? null,
-    unavailable: built?.unavailable ?? [],
-    methodsError: methods?.error ?? null,
-    busy,
-    error,
-    codeSent,
-    startOver
-  };
+  const methodsError = methods?.error ?? null;
+  return useMemo6(
+    () => ({
+      options: built?.options ?? null,
+      unavailable: built?.unavailable ?? NONE_UNAVAILABLE,
+      methodsError,
+      busy,
+      error,
+      codeSent,
+      startOver
+    }),
+    [built, methodsError, busy, error, codeSent, startOver]
+  );
 }
 
 // src/react/accounts.ts
-import { useMemo as useMemo6 } from "react";
+import { useMemo as useMemo7 } from "react";
 function isConnected(accounts, provider) {
   return Boolean(
     accounts?.some(
@@ -1583,7 +1639,7 @@ function useAccounts() {
     { refetchOnFocus: true }
   );
   const { busy, actionError, run } = useAction();
-  const actions = useMemo6(
+  const actions = useMemo7(
     () => ({
       connect: (provider) => run(async () => {
         const { url } = await relay.auth.start(provider, "connect", {
@@ -1603,7 +1659,7 @@ function useAccounts() {
     [relay, invalidate, session, run]
   );
   const accounts = query.data;
-  return useMemo6(
+  return useMemo7(
     () => ({
       ...query,
       busy,
@@ -1616,12 +1672,11 @@ function useAccounts() {
 }
 
 // src/react/profiles.ts
-import { useMemo as useMemo7 } from "react";
+import { useMemo as useMemo8 } from "react";
 var MINE = [...relayKeys.profiles, "mine"];
 function useMyProfile() {
   const relay = useRelay();
   const store = useStore();
-  const invalidate = useInvalidate();
   const session = useScopeSession();
   const query = useMemberQuery(
     MINE,
@@ -1629,10 +1684,12 @@ function useMyProfile() {
     { refetchOnFocus: true }
   );
   const { busy, actionError, run } = useAction();
-  const actions = useMemo7(() => {
+  const actions = useMemo8(() => {
     const change = (task) => run(async () => {
-      store.set(MINE, await task());
-      void invalidate([
+      const cache = store.scope?.cache;
+      const saved = await task();
+      cache?.set(MINE, saved);
+      void cache?.invalidate([
         [...relayKeys.profiles, "get"],
         relayKeys.leaderboards
       ]);
@@ -1647,8 +1704,8 @@ function useMyProfile() {
         })
       )
     };
-  }, [relay, store, invalidate, session, run]);
-  return useMemo7(
+  }, [relay, store, session, run]);
+  return useMemo8(
     () => ({ ...query, busy, actionError, ...actions }),
     [query, busy, actionError, actions]
   );
@@ -1691,7 +1748,7 @@ function useProfileCompletions(profile, options = {}) {
 }
 
 // src/react/referrals.ts
-import { useCallback as useCallback5, useEffect as useEffect6, useMemo as useMemo8, useRef as useRef3, useState as useState6 } from "react";
+import { useCallback as useCallback5, useEffect as useEffect6, useMemo as useMemo9, useRef as useRef4, useState as useState6 } from "react";
 var PENDING = "domino:pending-referral";
 var CODE = /^[a-zA-Z0-9_-]{1,100}$/;
 function captureReferralCode(param = "ref") {
@@ -1722,7 +1779,7 @@ function useInvitation(param = "ref") {
     const code = captureReferralCode(param);
     return code ? { status: "pending", code } : { status: "none" };
   });
-  const started = useRef3(null);
+  const started = useRef4(null);
   const accept = useCallback5(
     async (code) => {
       setState({ status: "accepting", code });
@@ -1751,16 +1808,17 @@ function useInvitation(param = "ref") {
       void accept(state.code);
     }
   }, [member, state, accept]);
-  return { invitation: state, accept };
+  return useMemo9(() => ({ invitation: state, accept }), [state, accept]);
 }
 function useReferralSummary(options = {}) {
   const relay = useRelay();
+  const { path = "/", param = "ref", intervalMs = 6e4 } = options;
   const query = useMemberQuery(
     [...relayKeys.referrals, "summary"],
-    (request) => relay.referrals.summary(request)
+    (request) => relay.referrals.summary(request),
+    { intervalMs }
   );
-  const { path = "/", param = "ref" } = options;
-  return useMemo8(() => {
+  return useMemo9(() => {
     let link = null;
     if (query.data && typeof window !== "undefined") {
       const url = new URL(path, window.location.origin);
@@ -1818,7 +1876,7 @@ export {
   canRepeat,
   canSubmit,
   captureReferralCode,
-  completionCountLabel,
+  completionCountText,
   isAutomatic,
   isConnected,
   isFinished,

package/dist/schema.d.ts

@@ -1,7 +1,7 @@
 export { A as Attempt, C as ContentPerformanceSnapshot, D as Decision, E as Entitlement, d as MemberPage, M as MemberProgress, P as PhotoResult, e as PickupAvailability, f as PublishedRelease, g as QuestAvailability, h as QuestDescription, Q as QuestPresentation, a as QuestProfile, i as QuestSettingsInput, b as QuizEvidence, j as ReleaseInput, k as ReviewPage, R as Reward, l as Snapshot, S as SubmissionEvidence, c as SubmitInput, m as TextResult, n as TextReviewInput, o as TieredRewardDefinition, T as TieredRewardReference, p as artifactSchema, q as attemptSchema, r as batchReleaseSchema, s as beginHandoverSchema, t as completionRecordSchema, u as configurePickupSchema, v as confirmHandoverSchema, w as contentPerformancePageSchema, x as contentPerformanceQuerySchema, y as contentPerformanceSnapshotSchema, z as createStockItemSchema, B as decisionSchema, F as entitlementSchema, G as errorSchema, H as eventSchema, I as evidenceSchema, J as integrationRewardSchema, K as mediaUrlSchema, L as memberListSchema, N as memberPageSchema, O as memberProgressSchema, U as photoResultSchema, V as pickupAllocationSchema, W as pickupAvailabilitySchema, X as pickupCatalogSchema, Y as pickupPolicySchema, Z as pickupSelectionSchema, _ as pointsRewardSchema, $ as prerequisiteSchema, a0 as publishedReleaseSchema, a1 as questAvailabilitySchema, a2 as questDescriptionSchema, a3 as questPresentationSchema, a4 as questProfileSchema, a5 as questSettingsInputSchema, a6 as quizAnswersSchema, a7 as quizEvidenceSchema, a8 as releaseSchema, a9 as reservationSchema, aa as reviewItemSchema, ab as reviewListSchema, ac as reviewModeSchema, ad as reviewPageSchema, ae as rewardBundleSchema, af as rewardKey, ag as rewardSchema, ah as snapshotSchema, ai as staffDecisionSchema, aj as stockItemSchema, ak as stockSchema, al as storedQuestDescriptionSchema, am as storedReviewModeSchema, an as submissionEvidenceSchema, ao as submitSchema, ap as templateSchema, aq as textResultSchema, ar as textReviewInputSchema, as as tierRewardSchema, at as tieredRewardDefinitionSchema, au as tieredRewardReferenceSchema, av as triggerSchema } from './schema-C4F2K9cm.js';
 export { A as AccountConnection, a as AuthProvider, D as DiscordMember, d as DiscordMessage, e as DiscordMessageData, f as DiscordMessageTextData, g as DiscordReactionData, h as DiscordReader, T as TextEvidence, b as TextOptions, U as UrlEvidence, c as UrlOptions, V as ValueEvidence, i as accountConnectionSchema, j as authProviderSchema, k as discordMemberInputSchema, l as discordMemberSchema, m as discordMessageDataSchema, n as discordMessageInputSchema, o as discordMessageSchema, p as discordMessageTextDataSchema, q as discordMessagesSourceSchema, r as discordReactionDataSchema, s as discordReactionsSourceSchema, t as textEvidenceSchema, u as textOptionsSchema, v as urlEvidenceSchema, w as urlOptionsSchema, x as validateSubmissionValue, y as valueEvidenceSchema, z as xPostId } from './submission-input-CkmBmSL1.js';
 export { E as ExchangeInput, M as MemberSummary, P as Page, a as PageQuery, b as ParticipantPrincipal, c as ParticipantSession, S as Session, d as authScopeSchema, e as exchangeResultSchema, f as exchangeSchema, m as memberSummarySchema, p as pageCursorSchema, g as pageQuerySchema, h as participantPrincipalSchema, i as participantSessionSchema, j as principalSchema, s as sessionMember, k as sessionSchema } from './pages-KYK1L60W.js';
-export { C as CalendarPeriod, D as DeploymentPreview, P as ProjectCalendar, a as ProjectCalendarInput, c as calendarPeriodSchema, b as canonicalTimeZone, d as deploymentPreviewSchema, e as deploymentResultSchema, p as projectCalendarDeclarationSchema, f as projectCalendarInputSchema, g as projectCalendarSchema, h as projectCatalogArtifactSchema, i as projectDeploymentSchema, j as publishDeploymentSchema, r as refuseStreakTimeZone, k as refuseWindowTimeZone, t as timeZoneNameSchema, l as timeZoneSchema } from './deployments-Ds34v0M8.js';
+export { C as CalendarPeriod, D as DeploymentPreview, P as ProjectCalendar, a as ProjectCalendarInput, c as calendarPeriodSchema, b as canonicalTimeZone, d as deploymentPreviewSchema, e as deploymentResultSchema, p as projectCalendarDeclarationSchema, f as projectCalendarInputSchema, g as projectCalendarSchema, h as projectCatalogArtifactSchema, i as projectDeploymentSchema, j as publishDeploymentSchema, r as refuseStreakTimeZone, k as refuseWindowTimeZone, t as timeZoneNameSchema, l as timeZoneSchema } from './deployments-STMb3vdt.js';
 export { K as KnownPointEntryKind, P as PointBalance, a as PointBalances, b as PointEntry, c as PointEntryKind, d as PointHistoryPage, e as PointHistoryQuery, i as PointLedger, f as PointLedgerReference, j as QuestCatalog, k as QuestDraft, l as QuestInstance, Q as QuestInteraction, g as QuestRewardView, h as QuestView, m as allocateQuestSchema, n as allocatedQuestSchema, o as catalogDeploymentPreviewSchema, p as catalogDeploymentSchema, q as collectionSlotDeclarationSchema, r as collectionSlotSchema, s as collectionViewSchema, t as createPointLedgerSchema, u as interactionSchema, v as pointBalanceSchema, w as pointBalancesSchema, x as pointEntrySchema, y as pointHistoryPageSchema, z as pointHistoryQuerySchema, A as pointLedgerDeclarationSchema, B as pointLedgerPropertiesSchema, C as pointLedgerReferenceSchema, D as pointLedgerSchema, E as publishQuestDraftSchema, F as questCatalogSchema, G as questCollectionSchema, H as questDraftChangesSchema, I as questDraftSchema, J as questExperienceSchema, L as questInstanceSchema, M as questInteraction, N as questPublicationPreviewSchema, O as questRewardViewSchema, R as questTypeVersionSchema, S as questViewSchema, T as saveQuestDraftSchema } from './catalog-CVXUHxiO.js';
 export { C as CollectionPass, c as collectionBeginSchema, a as collectionCodeSchema, b as collectionPassSchema, d as collectionPreviewSchema, e as collectionResolveSchema } from './collection-BGneJ6Bk.js';
 export { B as Budget, C as CapabilityErrorCode, a as CapabilityFailure, I as IntegerSettings, b as IntegrationProvider, K as KnownCapabilityErrorCode, P as ProjectIntegration, R as ResourceOption, c as ResourceSource, S as Setting, d as SettingField, e as SettingsValues, X as XConnection, f as XPost, g as XProfile, h as XReader, i as budgetSchema, j as capabilityErrorCodes, k as capabilityFailureSchema, l as compatibleSettingKinds, m as completionKeySchema, n as completionPolicySchema, o as discordServerSchema, p as integrationProviderSchema, q as missingResourceSettings, r as parseSettings, s as projectIntegrationSchema, t as resourceOptionsSchema, u as resourceRequestSchema, v as resourceSourceSchema, w as settingFieldSchema, x as settingsFieldsSchema, y as settingsValuesSchema, z as xConnectionSchema, A as xIdSchema, D as xPostSchema, E as xProfileSchema, F as xRequestSchema } from './capability-error-DO6Q0Qwe.js';

package/dist/server/index.d.ts

@@ -1,7 +1,7 @@
 import { i as TrackerDataSchema, p as TrackerQuery, Z as trackerContentReadSchema, $ as trackerControlSchema, a6 as trackerIngestSchema, l as TrackerOutcomeQuery, a9 as trackerOutcomeRetrySchema, o as TrackerPreviewInput } from '../trackers-Cg2MzFEf.js';
 import { x as contentPerformanceQuerySchema, u as configurePickupSchema, a5 as questSettingsInputSchema, ao as submitSchema, ai as staffDecisionSchema, s as beginHandoverSchema, v as confirmHandoverSchema, z as createStockItemSchema } from '../schema-C4F2K9cm.js';
 import { z } from 'zod';
-import { i as projectDeploymentSchema, j as publishDeploymentSchema, f as projectCalendarInputSchema } from '../deployments-Ds34v0M8.js';
+import { i as projectDeploymentSchema, j as publishDeploymentSchema, f as projectCalendarInputSchema } from '../deployments-STMb3vdt.js';
 import { D as pointLedgerSchema, p as catalogDeploymentSchema, T as saveQuestDraftSchema, E as publishQuestDraftSchema, t as createPointLedgerSchema, m as allocateQuestSchema } from '../catalog-CVXUHxiO.js';
 import { c as collectionBeginSchema } from '../collection-BGneJ6Bk.js';
 import { y as engagementChangePreviewInputSchema, B as engagementChangeSchema, P as engagementVersionQuerySchema, G as engagementPageQuerySchema, I as engagementPublishSchema, s as contentQualificationQuerySchema, i as contentAdmissionQuerySchema, k as contentEnrollmentInputSchema, u as contentReleaseInputSchema, a2 as pointsMutationSchema, aa as referralControlSchema, Z as leaderboardQuerySchema, U as leaderboardExclusionSchema, V as leaderboardGroupSchema } from '../referrals-KQfP4pBf.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@domino-sdk/relay",
-  "version": "1.0.0-next.16",
+  "version": "1.0.0-next.17",
   "type": "module",
   "exports": {
     ".": {

package/dist/{deployments-Ds34v0M8.d.ts → deployments-STMb3vdt.d.ts}

@@ -96,8 +96,8 @@ declare const projectCatalogArtifactSchema: z.ZodObject<{
         id?: string | undefined;
     }>>>>;
     supportedInteractions: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        text: "text";
         url: "url";
+        text: "text";
         automatic: "automatic";
         claim: "claim";
         staff: "staff";
@@ -117,10 +117,10 @@ declare const projectCatalogArtifactSchema: z.ZodObject<{
             kind: z.ZodLiteral<"custom">;
             namespace: z.ZodString;
             identities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                member: "member";
-                wallet: "wallet";
                 x: "x";
                 discord: "discord";
+                member: "member";
+                wallet: "wallet";
             }>>>;
             accounts: z.ZodOptional<z.ZodArray<z.ZodString>>;
             authors: z.ZodOptional<z.ZodLiteral<"wallet">>;
@@ -608,8 +608,8 @@ declare const projectDeploymentSchema: z.ZodObject<{
         id?: string | undefined;
     }>>>>;
     supportedInteractions: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        text: "text";
         url: "url";
+        text: "text";
         automatic: "automatic";
         claim: "claim";
         staff: "staff";
@@ -629,10 +629,10 @@ declare const projectDeploymentSchema: z.ZodObject<{
             kind: z.ZodLiteral<"custom">;
             namespace: z.ZodString;
             identities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                member: "member";
-                wallet: "wallet";
                 x: "x";
                 discord: "discord";
+                member: "member";
+                wallet: "wallet";
             }>>>;
             accounts: z.ZodOptional<z.ZodArray<z.ZodString>>;
             authors: z.ZodOptional<z.ZodLiteral<"wallet">>;
@@ -1280,10 +1280,10 @@ declare const deploymentPreviewSchema: z.ZodObject<{
                 kind: z.ZodLiteral<"custom">;
                 namespace: z.ZodString;
                 identities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                    member: "member";
-                    wallet: "wallet";
                     x: "x";
                     discord: "discord";
+                    member: "member";
+                    wallet: "wallet";
                 }>>>;
                 accounts: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 authors: z.ZodOptional<z.ZodLiteral<"wallet">>;
@@ -2279,8 +2279,8 @@ declare const deploymentPreviewSchema: z.ZodObject<{
         quests: z.ZodArray<z.ZodString>;
     }, z.core.$strict>>;
     supportedInteractions: z.ZodArray<z.ZodEnum<{
-        text: "text";
         url: "url";
+        text: "text";
         automatic: "automatic";
         claim: "claim";
         staff: "staff";
@@ -2839,10 +2839,10 @@ declare const deploymentResultSchema: z.ZodObject<{
                 kind: z.ZodLiteral<"custom">;
                 namespace: z.ZodString;
                 identities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                    member: "member";
-                    wallet: "wallet";
                     x: "x";
                     discord: "discord";
+                    member: "member";
+                    wallet: "wallet";
                 }>>>;
                 accounts: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 authors: z.ZodOptional<z.ZodLiteral<"wallet">>;
@@ -3838,8 +3838,8 @@ declare const deploymentResultSchema: z.ZodObject<{
         quests: z.ZodArray<z.ZodString>;
     }, z.core.$strict>>;
     supportedInteractions: z.ZodArray<z.ZodEnum<{
-        text: "text";
         url: "url";
+        text: "text";
         automatic: "automatic";
         claim: "claim";
         staff: "staff";