@domino-sdk/relay 0.28.0 → 0.30.0

package/dist/react/index.js

@@ -8,17 +8,17 @@ import {
   discoverSolanaWallets,
   readSignInMethods,
   signInOptionsFrom
-} from "../chunk-NHSA6ATH.js";
+} from "../chunk-UMKGCDBX.js";
 import {
   RelayError,
   avatarSrc,
   defaultAvatar,
   walletAvatarSeed
-} from "../chunk-ZP43MHO3.js";
-import "../chunk-AKB266O5.js";
-import "../chunk-AL5GXMKI.js";
-import "../chunk-D6BX627V.js";
-import "../chunk-IXLY3A7B.js";
+} from "../chunk-CB7RKKDX.js";
+import "../chunk-HINZLW46.js";
+import "../chunk-TYYGYDYX.js";
+import "../chunk-CWIJDQDT.js";
+import "../chunk-BE5V6RFD.js";
 
 // src/react/provider.tsx
 import { useState as useState3 } from "react";
@@ -689,12 +689,9 @@ function useMe() {
       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);
+    void relay.me.get().then((value) => active && setMe(value)).catch(() => active && setMe(null));
     return () => {
       active = false;
-      window.removeEventListener(WALLETS_CHANGED, read);
     };
   }, [relay, member]);
   return me;
@@ -985,26 +982,26 @@ function useMyProfile() {
     )
   };
 }
-function useProfile(id, options = {}) {
-  const relay = useRelay();
+function useProfileRead(read, intervalMs, fallback) {
   const { member } = useExperience();
-  const { intervalMs = 6e4 } = options;
-  const [state, setState] = useState8({ status: "loading" });
+  const [state, setState] = useState8({
+    status: "loading"
+  });
   const refresh = useCallback5(async () => {
     try {
-      const profile = await relay.profiles.get(id);
-      setState({ status: "ready", profile, stale: null });
+      const value = await read();
+      setState({ status: "ready", value, 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.";
+      const message = cause instanceof Error && cause.message ? cause.message : fallback;
       setState(
         (previous) => previous.status === "ready" ? { ...previous, stale: message } : { status: "error", message }
       );
     }
-  }, [relay, id]);
+  }, [read, fallback]);
   useEffect7(() => {
     setState({ status: "loading" });
     void refresh();
@@ -1020,8 +1017,129 @@ function useProfile(id, options = {}) {
       window.removeEventListener(PROFILE_CHANGED, changed);
     };
   }, [refresh, member, intervalMs]);
+  return { state, refresh };
+}
+function useProfile(id, options = {}) {
+  const relay = useRelay();
+  const read = useCallback5(() => relay.profiles.get(id), [relay, id]);
+  const { state, refresh } = useProfileRead(
+    read,
+    options.intervalMs ?? 6e4,
+    "Could not load the profile."
+  );
+  const value = state.status === "ready" ? { status: "ready", profile: state.value, stale: state.stale } : state;
+  return { ...value, refresh };
+}
+function useLeaderboardPlacement(board, profile, options = {}) {
+  const relay = useRelay();
+  const read = useCallback5(
+    () => relay.leaderboards.placement(board, profile),
+    [relay, board, profile]
+  );
+  const { state, refresh } = useProfileRead(
+    read,
+    options.intervalMs ?? 3e4,
+    "Could not load the leaderboard placement."
+  );
   return { ...state, refresh };
 }
+function useProfileReferral(profile, program, options = {}) {
+  const relay = useRelay();
+  const read = useCallback5(
+    () => relay.profiles.referral(profile, program),
+    [relay, profile, program]
+  );
+  const { state, refresh } = useProfileRead(
+    read,
+    options.intervalMs ?? 6e4,
+    "Could not load referral progress."
+  );
+  return { ...state, refresh };
+}
+function useProfileCompletions(profile, options = {}) {
+  const relay = useRelay();
+  const { member } = useExperience();
+  const { limit = 20 } = options;
+  const [state, setState] = useState8({
+    status: "loading"
+  });
+  const cursor = useRef3(null);
+  const generation = useRef3(0);
+  const paging = useRef3({ ready: false, busy: false });
+  const load = useCallback5(
+    async (first) => {
+      if (first) {
+        generation.current++;
+        paging.current = { ready: false, busy: false };
+      } else {
+        if (!paging.current.ready || paging.current.busy || cursor.current === null) {
+          return;
+        }
+        paging.current.busy = true;
+        setState(
+          (previous) => previous.status === "ready" ? { ...previous, loading: true, error: null } : previous
+        );
+      }
+      const current = generation.current;
+      const own = paging.current;
+      try {
+        const page = await relay.profiles.completions(profile, {
+          limit,
+          ...!first && cursor.current ? { cursor: cursor.current } : {}
+        });
+        if (current !== generation.current) {
+          return;
+        }
+        cursor.current = page.nextCursor;
+        own.ready = true;
+        setState((previous) => ({
+          status: "ready",
+          items: !first && previous.status === "ready" ? [...previous.items, ...page.items] : page.items,
+          more: page.nextCursor !== null,
+          loading: false,
+          error: null
+        }));
+      } catch (cause) {
+        if (current !== generation.current) {
+          return;
+        }
+        if (first && cause instanceof RelayError && cause.status === 404) {
+          setState({ status: "missing" });
+          return;
+        }
+        const message = cause instanceof Error && cause.message ? cause.message : "Could not load completed quests.";
+        setState(
+          (previous) => !first && previous.status === "ready" ? { ...previous, loading: false, error: message } : { status: "error", message }
+        );
+      } finally {
+        if (!first) {
+          own.busy = false;
+        }
+      }
+    },
+    [relay, profile, limit]
+  );
+  useEffect7(() => {
+    setState({ status: "loading" });
+    cursor.current = null;
+    void load(true);
+    const changed = () => void load(true);
+    window.addEventListener(PROFILE_CHANGED, changed);
+    return () => {
+      generation.current++;
+      window.removeEventListener(PROFILE_CHANGED, changed);
+    };
+  }, [load, member]);
+  return {
+    ...state,
+    refresh: () => load(true),
+    /**
+     * Appends the next page; does nothing while one loads, while the first page reloads, or when
+     * there is none.
+     */
+    loadMore: () => load(false)
+  };
+}
 
 // src/react/referrals.ts
 import { useCallback as useCallback6, useEffect as useEffect8, useRef as useRef4, useState as useState9 } from "react";
@@ -1198,10 +1316,13 @@ export {
   useExperience,
   useInvitation,
   useLeaderboard,
+  useLeaderboardPlacement,
   useMe,
   useMyProfile,
   usePointLedgers,
   useProfile,
+  useProfileCompletions,
+  useProfileReferral,
   useQuest,
   useReferralSummary,
   useRelay,

package/dist/schema.d.ts

@@ -310,6 +310,14 @@ declare const questPresentationSchema: z.ZodObject<{
     }, z.core.$strict>>;
 }, z.core.$strict>;
 type QuestPresentation = z.infer<typeof questPresentationSchema>;
+/**
+ * How a quest appears on participant profiles. Hidden by default: a completion can reveal what a
+ * member holds or did, so each quest opts in.
+ */
+declare const questProfileSchema: z.ZodObject<{
+    visible: z.ZodBoolean;
+}, z.core.$strict>;
+type QuestProfile = z.infer<typeof questProfileSchema>;
 declare const questDescriptionSchema: z.ZodObject<{
     quest: z.ZodString;
     runtimeVersion: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
@@ -544,6 +552,9 @@ declare const questDescriptionSchema: z.ZodObject<{
         visible: "visible";
         hidden: "hidden";
     }>>;
+    profile: z.ZodOptional<z.ZodObject<{
+        visible: z.ZodBoolean;
+    }, z.core.$strict>>;
     budgets: z.ZodDefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         scope: z.ZodEnum<{
@@ -851,6 +862,9 @@ declare const publishedReleaseSchema: z.ZodUnion<readonly [z.ZodObject<{
         visible: "visible";
         hidden: "hidden";
     }>>;
+    profile: z.ZodOptional<z.ZodObject<{
+        visible: z.ZodBoolean;
+    }, z.core.$strict>>;
     budgets: z.ZodDefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         scope: z.ZodEnum<{
@@ -1155,6 +1169,9 @@ declare const publishedReleaseSchema: z.ZodUnion<readonly [z.ZodObject<{
         metrics: ("likes" | "replies" | "reposts" | "quotes" | "views" | "bookmarks")[];
         maxAgeMs: number;
     } | undefined;
+    profile?: {
+        visible: boolean;
+    } | undefined;
     key?: string | undefined;
     origin?: {
         typeVersion: string;
@@ -1454,6 +1471,9 @@ declare const templateSchema: z.ZodObject<{
             visible: "visible";
             hidden: "hidden";
         }>>;
+        profile: z.ZodOptional<z.ZodObject<{
+            visible: z.ZodBoolean;
+        }, z.core.$strict>>;
         budgets: z.ZodDefault<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             scope: z.ZodEnum<{
@@ -2363,6 +2383,9 @@ declare const snapshotSchema: z.ZodObject<{
             visible: "visible";
             hidden: "hidden";
         }>>;
+        profile: z.ZodOptional<z.ZodObject<{
+            visible: z.ZodBoolean;
+        }, z.core.$strict>>;
         budgets: z.ZodDefault<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             scope: z.ZodEnum<{
@@ -2667,6 +2690,9 @@ declare const snapshotSchema: z.ZodObject<{
             metrics: ("likes" | "replies" | "reposts" | "quotes" | "views" | "bookmarks")[];
             maxAgeMs: number;
         } | undefined;
+        profile?: {
+            visible: boolean;
+        } | undefined;
         key?: string | undefined;
         origin?: {
             typeVersion: string;
@@ -3212,4 +3238,4 @@ declare const contentPerformancePageSchema: z.ZodObject<{
     next: z.ZodNullable<z.ZodNumber>;
 }, z.core.$strict>;
 
-export { type Attempt, type ContentPerformanceSnapshot, type Decision, type Entitlement, type MemberPage, type MemberProgress, type PhotoResult, type PickupAvailability, type PublishedRelease, type QuestAvailability, type QuestDescription, type QuestPresentation, type QuestSettingsInput, type QuizEvidence, type ReleaseInput, type ReviewPage, type Reward, type Snapshot, type SubmissionEvidence, type SubmitInput, type TextResult, type TextReviewInput, type TieredRewardDefinition, type TieredRewardReference, artifactSchema, attemptSchema, batchReleaseSchema, beginHandoverSchema, completionRecordSchema, configurePickupSchema, confirmHandoverSchema, contentPerformancePageSchema, contentPerformanceQuerySchema, contentPerformanceSnapshotSchema, createStockItemSchema, decisionSchema, entitlementSchema, errorSchema, eventSchema, evidenceSchema, identifier, integrationRewardSchema, mediaUrlSchema, memberListSchema, memberPageSchema, memberProgressSchema, photoResultSchema, pickupAllocationSchema, pickupAvailabilitySchema, pickupCatalogSchema, pickupPolicySchema, pickupSelectionSchema, pointsRewardSchema, prerequisiteSchema, publishedReleaseSchema, questAvailabilitySchema, questDescriptionSchema, questPresentationSchema, questSettingsInputSchema, quizAnswersSchema, quizEvidenceSchema, releaseSchema, reservationSchema, reviewItemSchema, reviewListSchema, reviewModeSchema, reviewPageSchema, rewardBundleSchema, rewardKey, rewardSchema, snapshotSchema, staffDecisionSchema, stockItemSchema, stockSchema, storedReviewModeSchema, submissionEvidenceSchema, submitSchema, templateSchema, textResultSchema, textReviewInputSchema, tierRewardSchema, tieredRewardDefinitionSchema, tieredRewardReferenceSchema, triggerSchema };
+export { type Attempt, type ContentPerformanceSnapshot, type Decision, type Entitlement, type MemberPage, type MemberProgress, type PhotoResult, type PickupAvailability, type PublishedRelease, type QuestAvailability, type QuestDescription, type QuestPresentation, type QuestProfile, type QuestSettingsInput, type QuizEvidence, type ReleaseInput, type ReviewPage, type Reward, type Snapshot, type SubmissionEvidence, type SubmitInput, type TextResult, type TextReviewInput, type TieredRewardDefinition, type TieredRewardReference, artifactSchema, attemptSchema, batchReleaseSchema, beginHandoverSchema, completionRecordSchema, configurePickupSchema, confirmHandoverSchema, contentPerformancePageSchema, contentPerformanceQuerySchema, contentPerformanceSnapshotSchema, createStockItemSchema, decisionSchema, entitlementSchema, errorSchema, eventSchema, evidenceSchema, identifier, integrationRewardSchema, mediaUrlSchema, memberListSchema, memberPageSchema, memberProgressSchema, photoResultSchema, pickupAllocationSchema, pickupAvailabilitySchema, pickupCatalogSchema, pickupPolicySchema, pickupSelectionSchema, pointsRewardSchema, prerequisiteSchema, publishedReleaseSchema, questAvailabilitySchema, questDescriptionSchema, questPresentationSchema, questProfileSchema, questSettingsInputSchema, quizAnswersSchema, quizEvidenceSchema, releaseSchema, reservationSchema, reviewItemSchema, reviewListSchema, reviewModeSchema, reviewPageSchema, rewardBundleSchema, rewardKey, rewardSchema, snapshotSchema, staffDecisionSchema, stockItemSchema, stockSchema, storedReviewModeSchema, submissionEvidenceSchema, submitSchema, templateSchema, textResultSchema, textReviewInputSchema, tierRewardSchema, tieredRewardDefinitionSchema, tieredRewardReferenceSchema, triggerSchema };

package/dist/schema.js

@@ -33,6 +33,7 @@ import {
   questAvailabilitySchema,
   questDescriptionSchema,
   questPresentationSchema,
+  questProfileSchema,
   questSettingsInputSchema,
   quizAnswersSchema,
   quizEvidenceSchema,
@@ -59,7 +60,7 @@ import {
   tieredRewardDefinitionSchema,
   tieredRewardReferenceSchema,
   triggerSchema
-} from "./chunk-IXLY3A7B.js";
+} from "./chunk-BE5V6RFD.js";
 export {
   artifactSchema,
   attemptSchema,
@@ -95,6 +96,7 @@ export {
   questAvailabilitySchema,
   questDescriptionSchema,
   questPresentationSchema,
+  questProfileSchema,
   questSettingsInputSchema,
   quizAnswersSchema,
   quizEvidenceSchema,