@domino-sdk/relay 1.0.0-next.10 → 1.0.0-next.13

package/dist/observations-CQ6IcNuQ.d.ts

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+
+declare const observationInputSchema: z.ZodObject<{
+    id: z.ZodString;
+    source: z.ZodString;
+    type: z.ZodString;
+    member: z.ZodString;
+    actor: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodString;
+        subject: z.ZodString;
+    }, z.core.$strict>>;
+    occurredAt: z.ZodNumber;
+    data: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+}, z.core.$strict>;
+declare const observationSchema: z.ZodObject<{
+    id: z.ZodString;
+    source: z.ZodString;
+    type: z.ZodString;
+    member: z.ZodString;
+    actor: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodString;
+        subject: z.ZodString;
+    }, z.core.$strict>>;
+    occurredAt: z.ZodNumber;
+    data: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+    receivedAt: z.ZodNumber;
+}, z.core.$strict>;
+type Observation = z.infer<typeof observationSchema>;
+declare const observationTriggerSchema: z.ZodObject<{
+    source: z.ZodString;
+    type: z.ZodString;
+}, z.core.$strict>;
+declare const completionPolicySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"streak">;
+    days: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"once">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"keyed">;
+}, z.core.$strict>], "kind">;
+declare const completionKeySchema: z.ZodString;
+declare const budgetSchema: z.ZodObject<{
+    id: z.ZodString;
+    scope: z.ZodEnum<{
+        member: "member";
+        project: "project";
+    }>;
+    period: z.ZodEnum<{
+        lifetime: "lifetime";
+        day: "day";
+        week: "week";
+        month: "month";
+    }>;
+    limit: z.ZodNumber;
+    cost: z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+        balance: z.ZodString;
+    }, z.core.$strict>]>;
+}, z.core.$strict>;
+type Budget = z.infer<typeof budgetSchema>;
+declare const observationReceiptSchema: z.ZodObject<{
+    id: z.ZodString;
+    source: z.ZodString;
+    attempts: z.ZodArray<z.ZodString>;
+    receivedAt: z.ZodNumber;
+}, z.core.$strip>;
+declare const discordReactionSchema: z.ZodObject<{
+    guildId: z.ZodString;
+    channelId: z.ZodString;
+    messageId: z.ZodString;
+    userId: z.ZodString;
+    messageAuthorId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    actorRoles: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    emoji: z.ZodObject<{
+        id: z.ZodNullable<z.ZodString>;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    messagePublishedAt: z.ZodNumber;
+}, z.core.$strict>;
+declare const discordMessageSchema: z.ZodObject<{
+    guildId: z.ZodString;
+    channelId: z.ZodString;
+    messageId: z.ZodString;
+    userId: z.ZodString;
+    content: z.ZodNullable<z.ZodString>;
+    replyTo: z.ZodNullable<z.ZodString>;
+    publishedAt: z.ZodNumber;
+}, z.core.$strict>;
+type DiscordMessage = z.infer<typeof discordMessageSchema>;
+
+export { type Budget as B, type DiscordMessage as D, type Observation as O, completionPolicySchema as a, budgetSchema as b, completionKeySchema as c, discordMessageSchema as d, discordReactionSchema as e, observationReceiptSchema as f, observationSchema as g, observationTriggerSchema as h, observationInputSchema as o };

package/dist/pages-KYK1L60W.d.ts

@@ -0,0 +1,152 @@
+import { z } from 'zod';
+
+declare const authScopeSchema: z.ZodObject<{
+    organization: z.ZodString;
+    project: z.ZodString;
+    environment: z.ZodEnum<{
+        test: "test";
+        live: "live";
+    }>;
+}, z.core.$strict>;
+declare const principalSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"member">;
+    member: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"staff">;
+    subject: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"operator">;
+    subject: z.ZodString;
+}, z.core.$strip>], "kind">;
+declare const sessionSchema: z.ZodObject<{
+    id: z.ZodString;
+    principal: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"member">;
+        member: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"staff">;
+        subject: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"operator">;
+        subject: z.ZodString;
+    }, z.core.$strip>], "kind">;
+    expiresAt: z.ZodNumber;
+    organization: z.ZodString;
+    project: z.ZodString;
+    environment: z.ZodEnum<{
+        test: "test";
+        live: "live";
+    }>;
+}, z.core.$strip>;
+type Session = z.infer<typeof sessionSchema>;
+/**
+ * A session's principal as the participant client reads it: a known kind, or `{ kind }` alone for
+ * a kind a newer Relay added, so reading the session never fails on it.
+ */
+declare const participantPrincipalSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"member">;
+    member: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"staff">;
+    subject: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"operator">;
+    subject: z.ZodString;
+}, z.core.$strip>], "kind">, z.ZodObject<{
+    kind: z.ZodString;
+}, z.core.$strip>]>;
+type ParticipantPrincipal = z.infer<typeof participantPrincipalSchema>;
+/** The session the participant client returns (`auth.session()`). */
+declare const participantSessionSchema: z.ZodObject<{
+    id: z.ZodString;
+    principal: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"member">;
+        member: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"staff">;
+        subject: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"operator">;
+        subject: z.ZodString;
+    }, z.core.$strip>], "kind">, z.ZodObject<{
+        kind: z.ZodString;
+    }, z.core.$strip>]>;
+    expiresAt: z.ZodNumber;
+    organization: z.ZodString;
+    project: z.ZodString;
+    environment: z.ZodEnum<{
+        test: "test";
+        live: "live";
+    }>;
+}, z.core.$strip>;
+type ParticipantSession = z.infer<typeof participantSessionSchema>;
+/** The member a session signs in, or null for a signed-out visitor or another principal kind. */
+declare function sessionMember(session: {
+    principal: ParticipantPrincipal;
+} | null | undefined): string | null;
+/**
+ * The signed-in member (`GET /v1/me`). `avatarSeed` seeds the member's generated avatar
+ * (`defaultAvatar`): an HMAC of the member ID under a per-project secret, so it is stable in the
+ * project, whatever the member links, and reveals nothing. Not strict: newer servers may add fields.
+ */
+declare const memberSummarySchema: z.ZodObject<{
+    member: z.ZodString;
+    avatarSeed: z.ZodString;
+}, z.core.$strip>;
+type MemberSummary = z.infer<typeof memberSummarySchema>;
+declare const exchangeSchema: z.ZodObject<{
+    organization: z.ZodString;
+    project: z.ZodString;
+    environment: z.ZodEnum<{
+        test: "test";
+        live: "live";
+    }>;
+    identity: z.ZodObject<{
+        issuer: z.ZodString;
+        subject: z.ZodString;
+    }, z.core.$strict>;
+    role: z.ZodEnum<{
+        member: "member";
+        staff: "staff";
+        operator: "operator";
+    }>;
+}, z.core.$strict>;
+type ExchangeInput = z.infer<typeof exchangeSchema>;
+declare const exchangeResultSchema: z.ZodObject<{
+    token: z.ZodString;
+    session: z.ZodObject<{
+        id: z.ZodString;
+        principal: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"member">;
+            member: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"staff">;
+            subject: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"operator">;
+            subject: z.ZodString;
+        }, z.core.$strip>], "kind">;
+        expiresAt: z.ZodNumber;
+        organization: z.ZodString;
+        project: z.ZodString;
+        environment: z.ZodEnum<{
+            test: "test";
+            live: "live";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+
+/** A cursor as a client passes it back. */
+declare const pageCursorSchema: z.ZodString;
+/** A query that pages by cursor only. */
+declare const pageQuerySchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type PageQuery = z.input<typeof pageQuerySchema>;
+/** One page of a paged read. */
+type Page<T> = {
+    items: T[];
+    nextCursor: string | null;
+};
+
+export { type ExchangeInput as E, type MemberSummary as M, type Page as P, type Session as S, type PageQuery as a, type ParticipantPrincipal as b, type ParticipantSession as c, authScopeSchema as d, exchangeResultSchema as e, exchangeSchema as f, pageQuerySchema as g, participantPrincipalSchema as h, participantSessionSchema as i, principalSchema as j, sessionSchema as k, memberSummarySchema as m, pageCursorSchema as p, sessionMember as s };

package/dist/portal-proxy.js

@@ -1,13 +1,14 @@
 import {
   isContentParticipantRoute,
+  isPointsParticipantRoute,
   isProfileParticipantRoute,
   isWalletParticipantRoute,
   isWalletSignInRoute
-} from "./chunk-ZWY3R6B3.js";
+} from "./chunk-6A2V4L3T.js";
 import {
   exchangeResultSchema
-} from "./chunk-7Q4BGGT6.js";
-import "./chunk-YYD4QUBO.js";
+} from "./chunk-FXYJ4OMX.js";
+import "./chunk-CRNQP7NV.js";
 
 // src/portal-proxy.ts
 async function proxyParticipant(request, upstream) {
@@ -17,7 +18,7 @@ async function proxyParticipant(request, upstream) {
     path
   ) || /^\/v1\/me\/(progress|experience|attempts|evidence|collection-pass)$/.test(
     path
-  ) || isWalletParticipantRoute(path) || isWalletSignInRoute(path) || path === "/v1/me" && request.method === "GET" || /^\/v1\/attempts\/[\w-]+\/retry$/.test(path) || /^\/v1\/referrals(?:\/(me|history))?$/.test(path) && request.method === "GET" || isContentParticipantRoute(path, request.method) || isProfileParticipantRoute(path, request.method) || path === "/v1/reward-deliveries" && request.method === "GET" || path === "/v1/referrals/accept" && request.method === "POST" || request.method === "GET" && /^\/v1\/leaderboards(?:\/[\w-]+)?$/.test(path) || request.method === "GET" && (path === "/v1/point-ledgers" || path === "/v1/tiered-rewards"));
+  ) || isWalletParticipantRoute(path) || isWalletSignInRoute(path) || path === "/v1/me" && request.method === "GET" || /^\/v1\/attempts\/[\w-]+\/retry$/.test(path) || /^\/v1\/referrals(?:\/(me|history))?$/.test(path) && request.method === "GET" || isContentParticipantRoute(path, request.method) || isProfileParticipantRoute(path, request.method) || isPointsParticipantRoute(path, request.method) || path === "/v1/reward-deliveries" && request.method === "GET" || path === "/v1/referrals/accept" && request.method === "POST" || request.method === "GET" && /^\/v1\/leaderboards(?:\/[\w-]+)?$/.test(path) || request.method === "GET" && (path === "/v1/point-ledgers" || path === "/v1/tiered-rewards"));
   if (!allowed || !["GET", "POST"].includes(request.method)) {
     return Response.json({ error: "Route not found" }, { status: 404 });
   }

package/dist/{profiles-DDMFBRKe.d.ts → profiles-BtOXMGcC.d.ts}

@@ -294,4 +294,4 @@ type ManagedProfile = z.infer<typeof managedProfileSchema>;
 declare const AVATAR_UPLOAD_LIMIT: number;
 declare const avatarUploadTypes: string[];
 
-export { type AvatarProvider as A, profileModerationSchema as B, profileReferralSchema as C, profileSettingsInputSchema as D, profileSettingsSchema as E, profileSummarySchema as F, profileVisibilitySchema as G, type ManagedProfile as M, type OwnProfile as O, type ProfileAvatar as P, type ProfileCompletion as a, type ProfileCompletionPage as b, type ProfileCompletionQuery as c, type ProfileReferral as d, type ProfileSummary as e, type ProfileUpdate as f, type ProfileVisibility as g, AVATAR_UPLOAD_LIMIT as h, type ProfileDefaultProvider as i, type ProfileDefaults as j, type ProfileModeration as k, type ProfileSettings as l, type ProfileSettingsInput as m, avatarProviderSchema as n, avatarSeedSchema as o, profileUpdateSchema as p, avatarUploadTypes as q, displayNameSchema as r, managedProfileSchema as s, ownProfileSchema as t, profileAvatarSchema as u, profileCompletionPageSchema as v, profileCompletionQuerySchema as w, profileCompletionSchema as x, profileDefaultProviderSchema as y, profileDefaultsSchema as z };
+export { type AvatarProvider as A, profileReferralSchema as B, profileSettingsInputSchema as C, profileSettingsSchema as D, profileSummarySchema as E, profileUpdateSchema as F, profileVisibilitySchema as G, type ManagedProfile as M, type OwnProfile as O, type ProfileAvatar as P, type ProfileCompletion as a, type ProfileCompletionPage as b, type ProfileCompletionQuery as c, type ProfileReferral as d, type ProfileSummary as e, type ProfileUpdate as f, type ProfileVisibility as g, AVATAR_UPLOAD_LIMIT as h, type ProfileDefaultProvider as i, type ProfileDefaults as j, type ProfileModeration as k, type ProfileSettings as l, type ProfileSettingsInput as m, avatarProviderSchema as n, avatarSeedSchema as o, avatarUploadTypes as p, displayNameSchema as q, managedProfileSchema as r, ownProfileSchema as s, profileAvatarSchema as t, profileCompletionPageSchema as u, profileCompletionQuerySchema as v, profileCompletionSchema as w, profileDefaultProviderSchema as x, profileDefaultsSchema as y, profileModerationSchema as z };

package/dist/react/index.d.ts

@@ -1,16 +1,18 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { i as referralAcceptSchema, d as LeaderboardQuery, a as AuthProvider, j as engagementPageQuerySchema, k as contentQualificationQuerySchema, m as contentAdmissionQuerySchema, n as contentEnrollmentInputSchema, o as contentReleaseInputSchema, A as AccountConnection, aq as referralSummarySchema, b as LeaderboardPage } from '../submission-input-0OOGaq8c.js';
-import { s as submitSchema, g as contentPerformanceQuerySchema, T as TieredRewardReference } from '../schema-Di3aLSiK.js';
-import { a as PageQuery, e as QuestView, q as questExperienceSchema, f as exchangeSchema } from '../pages-D3titw5B.js';
-import { w as walletAddressInputSchema, l as walletSignatureSchema, L as LinkedWallet, f as WalletSigner, d as WalletSignInNetwork } from '../wallet-BGOfFkG9.js';
-import { p as profileUpdateSchema, c as ProfileCompletionQuery, a as ProfileCompletion, e as ProfileSummary, f as ProfileUpdate } from '../profiles-DDMFBRKe.js';
+import { a6 as referralAcceptSchema, c as LeaderboardQuery, G as engagementPageQuerySchema, s as contentQualificationQuerySchema, i as contentAdmissionQuerySchema, k as contentEnrollmentInputSchema, u as contentReleaseInputSchema, af as referralSummarySchema, a as LeaderboardPage } from '../referrals-KQfP4pBf.js';
+import { ao as submitSchema, x as contentPerformanceQuerySchema, T as TieredRewardReference } from '../schema-BF_TQsmT.js';
+import { a as PageQuery, f as exchangeSchema } from '../pages-KYK1L60W.js';
+import { x as walletAddressInputSchema, M as walletSignatureSchema, L as LinkedWallet, f as WalletSigner, d as WalletSignInNetwork } from '../wallet-BtiG0Xhr.js';
+import { h as QuestView, J as questExperienceSchema, e as PointHistoryQuery, c as PointEntryKind, P as PointBalance, b as PointEntry, f as PointLedgerReference } from '../catalog-C85V1NgW.js';
+import { F as profileUpdateSchema, c as ProfileCompletionQuery, a as ProfileCompletion, e as ProfileSummary, f as ProfileUpdate } from '../profiles-BtOXMGcC.js';
 import * as zod from 'zod';
 import { z } from 'zod';
-import { k as RelayRequestOptions, c as QuestController, a as ProgressObservation, b as ProgressObserver, P as PhotoSubmission, e as QuizSubmission, C as ClaimSubmission, V as ValueSubmission, S as SubmissionDraft } from '../client-CT4-S5vc.js';
+import { k as RelayRequestOptions, c as QuestController, a as ProgressObservation, b as ProgressObserver, P as PhotoSubmission, e as QuizSubmission, C as ClaimSubmission, V as ValueSubmission, S as SubmissionDraft } from '../client-Bf9PNUIi.js';
+import { a as AuthProvider, A as AccountConnection } from '../submission-input-CccwAl5Z.js';
 import { createBrowserRelayClient, SignInMethods, CosmosChains, SignInOption, SignInUnavailable, SignInWallet, DiscoveredWallet } from '../browser.js';
 export { EmailSignInOption, OAuthSignInOption, SignInIcon, WalletSignInOption } from '../browser.js';
-import { P as PointLedgerReference } from '../point-ledgers-iS00Z_v0.js';
+import '../request-error-VnTiMXc3.js';
 
 type RelayClient = ReturnType<typeof createBrowserRelayClient>;
 /** The participant client, for calls no hook covers. */
@@ -277,7 +279,6 @@ declare function useRelay(): {
                 } | {
                     kind: "calendar";
                     period: "day" | "week" | "month";
-                    timeZone: string;
                 };
                 kind: "earned";
                 quests?: string[] | undefined;
@@ -295,7 +296,6 @@ declare function useRelay(): {
                 } | {
                     kind: "calendar";
                     period: "day" | "week" | "month";
-                    timeZone: string;
                 };
             };
             access: "participants" | "public";
@@ -662,7 +662,6 @@ declare function useRelay(): {
             completion: {
                 kind: "streak";
                 days: number;
-                timeZone: string;
             } | {
                 kind: "once";
             } | {
@@ -977,7 +976,6 @@ declare function useRelay(): {
                 completion: {
                     kind: "streak";
                     days: number;
-                    timeZone: string;
                 } | {
                     kind: "once";
                 } | {
@@ -1239,7 +1237,6 @@ declare function useRelay(): {
                     completion: {
                         kind: "streak";
                         days: number;
-                        timeZone: string;
                     } | {
                         kind: "once";
                     } | {
@@ -1504,7 +1501,6 @@ declare function useRelay(): {
                 completion: {
                     kind: "streak";
                     days: number;
-                    timeZone: string;
                 } | {
                     kind: "once";
                 } | {
@@ -1988,7 +1984,6 @@ declare function useRelay(): {
                 completion: {
                     kind: "streak";
                     days: number;
-                    timeZone: string;
                 } | {
                     kind: "once";
                 } | {
@@ -2182,6 +2177,28 @@ declare function useRelay(): {
                 deliveredAt: number | null;
             }[];
         }>;
+        balances: (requestOptions?: RelayRequestOptions) => Promise<{
+            items: {
+                ledger: {
+                    id: string;
+                    key: string | null;
+                    name: string;
+                };
+                balance: number;
+                available: number;
+            }[];
+        }>;
+        pointHistory: (query: PointHistoryQuery, requestOptions?: RelayRequestOptions) => Promise<{
+            items: {
+                id: string;
+                amount: number;
+                kind: PointEntryKind;
+                at: number;
+                quest: string | null;
+                reverses: string | null;
+            }[];
+            nextCursor: string | null;
+        }>;
         claim: (value: Omit<zod.input<typeof submitSchema>, "member">, requestOptions?: RelayRequestOptions) => Promise<{
             id: string;
             release: string;
@@ -2257,11 +2274,11 @@ declare function useRelay(): {
                     metrics: ("likes" | "replies" | "reposts" | "quotes" | "views" | "bookmarks")[];
                     baseline: "historical";
                     maxAgeMs: number;
-                    budget: {
-                        projectDaily?: number | undefined;
-                        memberDaily?: number | undefined;
-                        projectLifetime?: number | undefined;
-                    };
+                    budgets: {
+                        scope: "member" | "project";
+                        period: "lifetime" | "day" | "week" | "month";
+                        limit: number;
+                    }[];
                 };
                 publishedAt: number;
             };
@@ -2302,11 +2319,11 @@ declare function useRelay(): {
                     metrics: ("likes" | "replies" | "reposts" | "quotes" | "views" | "bookmarks")[];
                     baseline: "historical";
                     maxAgeMs: number;
-                    budget: {
-                        projectDaily?: number | undefined;
-                        memberDaily?: number | undefined;
-                        projectLifetime?: number | undefined;
-                    };
+                    budgets: {
+                        scope: "member" | "project";
+                        period: "lifetime" | "day" | "week" | "month";
+                        limit: number;
+                    }[];
                 };
                 publishedAt: number;
             } | null;
@@ -2319,11 +2336,11 @@ declare function useRelay(): {
                     metrics: ("likes" | "replies" | "reposts" | "quotes" | "views" | "bookmarks")[];
                     baseline: "historical";
                     maxAgeMs: number;
-                    budget: {
-                        projectDaily?: number | undefined;
-                        memberDaily?: number | undefined;
-                        projectLifetime?: number | undefined;
-                    };
+                    budgets: {
+                        scope: "member" | "project";
+                        period: "lifetime" | "day" | "week" | "month";
+                        limit: number;
+                    }[];
                 };
                 publishedAt: number;
             };
@@ -2679,7 +2696,6 @@ declare function useQuest(observed: QuestView): {
         completion: {
             kind: "streak";
             days: number;
-            timeZone: string;
         } | {
             kind: "once";
         } | {
@@ -3440,6 +3456,109 @@ declare function useLeaderboard(board: string, options?: {
     stale: string | null;
 };
 
+type BalancesState = {
+    status: "loading";
+} | {
+    status: "signed-out";
+} | {
+    status: "error";
+    message: string;
+} | {
+    status: "ready";
+    items: PointBalance[];
+    stale: string | null;
+};
+type PointHistoryState = {
+    status: "loading";
+} | {
+    status: "signed-out";
+}
+/** No ledger has this key or ID in the project (`point-ledger-not-found`). */
+ | {
+    status: "missing";
+}
+/** The member has not joined this project, so it has no points here (`not-joined`). */
+ | {
+    status: "not-joined";
+} | {
+    status: "error";
+    message: string;
+} | {
+    status: "ready";
+    items: PointEntry[];
+    /** Whether `loadMore()` has another page to read. */
+    more: boolean;
+    /** A next page is loading. */
+    loading: boolean;
+    /** Why the last next page failed; the items read so far stay. */
+    error: string | null;
+};
+/**
+ * The signed-in participant's balance in each of the project's point ledgers: `balance` counts
+ * every entry, `available` leaves out points reservations hold. Read again when the participant
+ * signs in or out and after a quest completes. Find a ledger by the key your app declared:
+ * `items.find((b) => b.ledger.key === "points")`.
+ */
+declare function useBalances(): {
+    refresh: () => Promise<void>;
+    status: "loading";
+} | {
+    refresh: () => Promise<void>;
+    status: "signed-out";
+} | {
+    refresh: () => Promise<void>;
+    status: "error";
+    message: string;
+} | {
+    refresh: () => Promise<void>;
+    status: "ready";
+    items: PointBalance[];
+    stale: string | null;
+};
+/**
+ * The signed-in participant's own entries in one ledger, by key or ID, most recently recorded first, a page at a
+ * time. Starts over when the participant signs in or out and after a quest completes.
+ */
+declare function usePointHistory(ledger: string): {
+    refresh: () => Promise<void>;
+    /** Appends the next page; does nothing while a page loads or when there is none. */
+    loadMore: () => Promise<void>;
+    status: "loading";
+} | {
+    refresh: () => Promise<void>;
+    /** Appends the next page; does nothing while a page loads or when there is none. */
+    loadMore: () => Promise<void>;
+    status: "signed-out";
+} | {
+    refresh: () => Promise<void>;
+    /** Appends the next page; does nothing while a page loads or when there is none. */
+    loadMore: () => Promise<void>;
+    status: "missing";
+} | {
+    refresh: () => Promise<void>;
+    /** Appends the next page; does nothing while a page loads or when there is none. */
+    loadMore: () => Promise<void>;
+    status: "not-joined";
+} | {
+    refresh: () => Promise<void>;
+    /** Appends the next page; does nothing while a page loads or when there is none. */
+    loadMore: () => Promise<void>;
+    status: "error";
+    message: string;
+} | {
+    refresh: () => Promise<void>;
+    /** Appends the next page; does nothing while a page loads or when there is none. */
+    loadMore: () => Promise<void>;
+    status: "ready";
+    items: PointEntry[];
+    /** Whether `loadMore()` has another page to read. */
+    more: boolean;
+    /** A next page is loading. */
+    loading: boolean;
+    /** Why the last next page failed; the items read so far stay. */
+    error: string | null;
+};
+
 type ReferencesState<T> = {
     status: "loading";
 } | {
@@ -3497,4 +3616,4 @@ declare function useTieredRewards(): {
     }[];
 };
 
-export { type Collection, CosmosChains, DiscoveredWallet, type Experience, type Invitation, type LeaderboardState, type OAuthProvider, PENDING_POLL_MS, PROFILE_CHANGED, type PointLedgersState, type ProfileCompletionsState, type ProfileReadState, type ProfileState, type QuestInput, type QuestNotice, type QuestStatus, type QuestTone, RETRY_DELAYS_MS, type ReferencesState, type ReferralSummary, type RelayClient, RelayProvider, type RoleDelivery, type SavedSubmission, SignInMethods, SignInOption, SignInUnavailable, SignInWallet, type TieredRewardsState, canRepeat, canSubmit, captureReferralCode, completionCountLabel, completionMark, hasPending, isAutomatic, isConnected, isFinished, progressOf, questGroups, questStatus, roleDeliveryLabel, runsSilently, sanitizeDeliveries, useAccounts, useExperience, useInvitation, useLeaderboard, useLeaderboardPlacement, useMe, useMyProfile, usePointLedgers, useProfile, useProfileCompletions, useProfileReferral, useQuest, useReferralSummary, useRelay, useSignIn, useSignInMethods, useSignInOptions, useSignInWallets, useSignOut, useTieredRewards, useWalletDiscovery, useWallets, visibleQuests, watchRoleDeliveries };
+export { type BalancesState, type Collection, CosmosChains, DiscoveredWallet, type Experience, type Invitation, type LeaderboardState, type OAuthProvider, PENDING_POLL_MS, PROFILE_CHANGED, type PointHistoryState, type PointLedgersState, type ProfileCompletionsState, type ProfileReadState, type ProfileState, type QuestInput, type QuestNotice, type QuestStatus, type QuestTone, RETRY_DELAYS_MS, type ReferencesState, type ReferralSummary, type RelayClient, RelayProvider, type RoleDelivery, type SavedSubmission, SignInMethods, SignInOption, SignInUnavailable, SignInWallet, type TieredRewardsState, canRepeat, canSubmit, captureReferralCode, completionCountLabel, completionMark, hasPending, isAutomatic, isConnected, isFinished, progressOf, questGroups, questStatus, roleDeliveryLabel, runsSilently, sanitizeDeliveries, useAccounts, useBalances, useExperience, useInvitation, useLeaderboard, useLeaderboardPlacement, useMe, useMyProfile, usePointHistory, usePointLedgers, useProfile, useProfileCompletions, useProfileReferral, useQuest, useReferralSummary, useRelay, useSignIn, useSignInMethods, useSignInOptions, useSignInWallets, useSignOut, useTieredRewards, useWalletDiscovery, useWallets, visibleQuests, watchRoleDeliveries };