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

package/dist/authoring.d.ts

@@ -1,15 +1,16 @@
 import { z } from 'zod';
 export { z } from 'zod';
 import { e as ContentPolicy, C as ContentMetric, E as EngagementBudget, T as leaderboardDefinitionSchema, a9 as referralAuthoringSchema, A as AdmittedContent } from './referrals-KQfP4pBf.js';
-import { r as discordMessagesSourceSchema, a as DiscordMessageData, b as DiscordMessageTextData, t as discordReactionsSourceSchema, c as DiscordReactionData, e as ResourceSource, S as Setting, j as XReader, D as DiscordMessage, B as Budget, I as IntegerSettings, d as IntegrationProvider } from './integrations-C1vB6Ry6.js';
+import { q as discordMessagesSourceSchema, e as DiscordMessageData, f as DiscordMessageTextData, s as discordReactionsSourceSchema, g as DiscordReactionData, h as DiscordReader, T as TextEvidence, U as UrlEvidence, b as TextOptions, c as UrlOptions } from './submission-input-CkmBmSL1.js';
 import { Q as QuizContent, a as StreakPolicy } from './streaks-CWyq8Px5.js';
-import { j as TrackerDefinition, I as IdentityKind, K as customSourceSchema, G as WithRecordData, t as TrackerSource, a2 as trackerDefinitionSchema, T as Tracker, g as TrackerData, aw as xSearchSourceSchema, X as XTweet, w as TrackerTriggerContext, y as TrackerTriggerPolicy, q as TrackerReader, W as Where, x as TrackerTriggerMode, F as WhereSetting } from './trackers-7lxSWp2g.js';
-export { i as TrackerDataSchema, m as TrackerPage, ay as trackerDataSchema, am as trackerTriggerContextSchema } from './trackers-7lxSWp2g.js';
+import { c as ResourceSource, S as Setting, h as XReader, B as Budget, I as IntegerSettings, b as IntegrationProvider } from './capability-error-DO6Q0Qwe.js';
+export { G as CapabilityError, C as CapabilityErrorCode, j as capabilityErrorCodes } from './capability-error-DO6Q0Qwe.js';
+import { j as TrackerDefinition, I as IdentityKind, L as customSourceSchema, H as WithRecordData, u as TrackerSource, a3 as trackerDefinitionSchema, T as Tracker, g as TrackerData, ax as xSearchSourceSchema, X as XTweet, x as TrackerTriggerContext, z as TrackerTriggerPolicy, r as TrackerReader, W as Where, y as TrackerTriggerMode, G as WhereSetting } from './trackers-Cg2MzFEf.js';
+export { i as TrackerDataSchema, m as TrackerPage, q as TrackerReadQuery, az as trackerDataSchema, an as trackerTriggerContextSchema } from './trackers-Cg2MzFEf.js';
 import { e as ImageReader } from './images-CRxHUuG5.js';
-import { D as DiscordMember, T as TextEvidence, U as UrlEvidence, b as TextOptions, c as UrlOptions } from './submission-input-CccwAl5Z.js';
 import { n as TextReviewInput, m as TextResult, P as PhotoResult, ag as rewardSchema, av as triggerSchema, Q as QuestPresentation, a as QuestProfile, b as QuizEvidence, D as Decision, o as TieredRewardDefinition } from './schema-C4F2K9cm.js';
-import { k as WalletConnection, S as SolanaBalance, L as LinkedWallet, j as WalletBalanceQuery, i as WalletBalance } from './wallet-BtiG0Xhr.js';
-export { E as EvmChainId, r as isEvmChainId } from './wallet-BtiG0Xhr.js';
+import { l as WalletReader } from './wallet-CYK5E2wj.js';
+export { E as EvmChainId, i as WalletBalance, j as WalletBalanceQuery, s as isEvmChainId } from './wallet-CYK5E2wj.js';
 export { f as formatUnits, p as parseUnits } from './units-CwgsPB_r.js';
 
 /** Legacy `id` names an authoring key, never a server resource ID. */
@@ -610,27 +611,8 @@ type EvaluationContext<T, I = {
             criteria: string;
         }): Promise<PhotoResult>;
     };
-    discord: {
-        member(): Promise<DiscordMember | null>;
-        message(input: {
-            channelId: string;
-            messageId: string;
-        }): Promise<DiscordMessage | null>;
-    };
-    wallet: {
-        /** The member's newest linked Solana wallet. */
-        connection(): Promise<WalletConnection | null>;
-        /** SOL held by the newest linked Solana wallet. */
-        solanaBalance(): Promise<SolanaBalance | null>;
-        /** Every wallet the member has linked to this project, pinned once per attempt. */
-        list(): Promise<LinkedWallet[]>;
-        /**
-         * The native or token balance of the member's pinned linked wallets on one chain: all wallets of
-         * that family, or `address` (which must be one of them). No wallets gives `total: "0"` and
-         * `wallets: []`. Provider failures throw; they never read as a zero balance.
-         */
-        balance(query: WalletBalanceQuery): Promise<WalletBalance>;
-    };
+    discord: DiscordReader;
+    wallet: WalletReader;
 };
 type Evaluator<T, I = {
     photo: string;
@@ -966,4 +948,4 @@ declare function defineQuest<T extends Record<string, Setting>, const G extends
  * Console instances receive independent quest identities and pinned versions. */
 declare const defineQuestType: typeof defineQuest;
 
-export { DiscordMessageData, DiscordMessageTextData, DiscordReactionData, type EvaluationContext, ImageReader, type KeyedContext, type PerformanceOutcome, Setting, Tracker, TrackerData, TrackerReader, type TrackerTrigger, TrackerTriggerContext, type TrackerTriggerInput, WalletBalance, WalletBalanceQuery, Where, XReader, automatic, budget, completed, content, customSource, decision, defineEngagementReward, defineLeaderboard, defineQuest, defineQuestType, defineReferral, defineTieredReward, defineTracker, discord, discordRole, evaluators, evidence, keyed, manual, once, perContent, pointLedgers, points, settings, staffHandover, streak, untracked, x };
+export { DiscordMessageData, DiscordMessageTextData, DiscordReactionData, DiscordReader, type EvaluationContext, ImageReader, type KeyedContext, type PerformanceOutcome, Setting, Tracker, TrackerData, TrackerReader, type TrackerTrigger, TrackerTriggerContext, type TrackerTriggerInput, WalletReader, Where, XReader, automatic, budget, completed, content, customSource, decision, defineEngagementReward, defineLeaderboard, defineQuest, defineQuestType, defineReferral, defineTieredReward, defineTracker, discord, discordRole, evaluators, evidence, keyed, manual, once, perContent, pointLedgers, points, settings, staffHandover, streak, untracked, x };

package/dist/authoring.js

@@ -2,6 +2,10 @@ import {
   formatUnits,
   parseUnits
 } from "./chunk-V7UKZLHA.js";
+import {
+  CapabilityError,
+  capabilityErrorCodes
+} from "./chunk-MC6V6VMG.js";
 import {
   sourceDataSchema,
   sourceRoles
@@ -595,8 +599,10 @@ function defineQuest(definition) {
 }
 var defineQuestType = defineQuest;
 export {
+  CapabilityError,
   automatic,
   budget,
+  capabilityErrorCodes,
   completed,
   content,
   customSource,

package/dist/avatar.d.ts

@@ -1,5 +1,5 @@
-import { L as LinkedWallet } from './wallet-BtiG0Xhr.js';
-import { P as ProfileAvatar } from './profiles-BtOXMGcC.js';
+import { L as LinkedWallet } from './wallet-CYK5E2wj.js';
+import { P as ProfileAvatar } from './profiles-md0g5fjx.js';
 import 'zod';
 
 /**

package/dist/browser.d.ts

@@ -1,11 +1,11 @@
 import { a6 as referralAcceptSchema, c as LeaderboardQuery, G as engagementPageQuerySchema, s as contentQualificationQuerySchema, i as contentAdmissionQuerySchema, k as contentEnrollmentInputSchema, u as contentReleaseInputSchema } from './referrals-KQfP4pBf.js';
 import { ao as submitSchema, x as contentPerformanceQuerySchema } from './schema-C4F2K9cm.js';
 import { h as QuestView, J as questExperienceSchema, e as PointHistoryQuery, c as PointEntryKind } from './catalog-CVXUHxiO.js';
-import { n as createRelayClient, g as RelayError, m as SubmissionStore, k as RelayRequestOptions, c as QuestController, a as ProgressObservation, b as ProgressObserver, P as PhotoSubmission, e as QuizSubmission, C as ClaimSubmission, V as ValueSubmission } from './client-dfXT6hhq.js';
+import { n as createRelayClient, g as RelayError, m as SubmissionStore, k as RelayRequestOptions, c as QuestController, a as ProgressObservation, b as ProgressObserver, P as PhotoSubmission, e as QuizSubmission, C as ClaimSubmission, V as ValueSubmission } from './client-DG9qAB4o.js';
 import { a as PageQuery, f as exchangeSchema } from './pages-KYK1L60W.js';
-import { a as AuthProvider } from './submission-input-CccwAl5Z.js';
-import { C as CosmosChain, a as CosmosNetwork, f as WalletSigner, d as WalletSignInNetwork, x as walletAddressInputSchema, M as walletSignatureSchema, L as LinkedWallet } from './wallet-BtiG0Xhr.js';
-import { F as profileUpdateSchema, c as ProfileCompletionQuery } from './profiles-BtOXMGcC.js';
+import { a as AuthProvider } from './submission-input-CkmBmSL1.js';
+import { C as CosmosChain, a as CosmosNetwork, f as WalletSigner, d as WalletSignInNetwork, y as walletAddressInputSchema, N as walletSignatureSchema, L as LinkedWallet } from './wallet-CYK5E2wj.js';
+import { F as profileUpdateSchema, c as ProfileCompletionQuery } from './profiles-md0g5fjx.js';
 import * as zod from 'zod';
 import './request-error-VnTiMXc3.js';
 

package/dist/{integrations-C1vB6Ry6.d.ts → capability-error-DO6Q0Qwe.d.ts}

@@ -1,69 +1,5 @@
 import { z } from 'zod';
 
-/** A Discord message as `ctx.discord.message()` reads it, from the project's Discord server. */
-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>;
-/**
- * Messages posted in the project's Discord server, written by the Discord gateway. The record's
- * `author` is the message author's Discord account. Message text is stored only with `text: true`.
- */
-declare const discordMessagesSourceSchema: z.ZodObject<{
-    kind: z.ZodLiteral<"discord-messages">;
-    /** Store each message's text in `data.text`. Off unless set. */
-    text: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strict>;
-/**
- * Reactions added in the project's Discord server, written by the Discord gateway. The record's
- * `author` is the reactor's Discord account and its `messageAuthor` account is the message's
- * author, when Discord could name it.
- */
-declare const discordReactionsSourceSchema: z.ZodObject<{
-    kind: z.ZodLiteral<"discord-reactions">;
-}, z.core.$strict>;
-/** The `data` of a `discord.messages()` record. IDs are Discord snowflakes. */
-declare const discordMessageDataSchema: z.ZodObject<{
-    guildId: z.ZodString;
-    channelId: z.ZodString;
-    messageId: z.ZodString;
-    replyTo: z.ZodNullable<z.ZodString>;
-    publishedAt: z.ZodNumber;
-}, z.core.$strip>;
-type DiscordMessageData = z.infer<typeof discordMessageDataSchema>;
-/**
- * The `data` of a `discord.messages({ text: true })` record. `text` is null when the platform's
- * bot does not receive message content.
- */
-declare const discordMessageTextDataSchema: z.ZodObject<{
-    guildId: z.ZodString;
-    channelId: z.ZodString;
-    messageId: z.ZodString;
-    replyTo: z.ZodNullable<z.ZodString>;
-    publishedAt: z.ZodNumber;
-    text: z.ZodNullable<z.ZodString>;
-}, z.core.$strip>;
-type DiscordMessageTextData = z.infer<typeof discordMessageTextDataSchema>;
-/** The `data` of a `discord.reactions()` record. IDs are Discord snowflakes. */
-declare const discordReactionDataSchema: z.ZodObject<{
-    guildId: z.ZodString;
-    channelId: z.ZodString;
-    messageId: z.ZodString;
-    emoji: z.ZodObject<{
-        id: z.ZodNullable<z.ZodString>;
-        name: z.ZodString;
-    }, z.core.$strip>;
-    reactorRoles: z.ZodArray<z.ZodString>;
-    messagePublishedAt: z.ZodNumber;
-}, z.core.$strip>;
-type DiscordReactionData = z.infer<typeof discordReactionDataSchema>;
-
 declare const resourceSourceSchema: z.ZodUnion<readonly [z.ZodObject<{
     provider: z.ZodLiteral<"domino">;
     resource: z.ZodLiteral<"point-ledger">;
@@ -340,18 +276,25 @@ declare const xRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 type XConnection = z.infer<typeof xConnectionSchema>;
 type XProfile = z.infer<typeof xProfileSchema>;
 type XPost = z.infer<typeof xPostSchema>;
+/**
+ * Reads the member's linked X account and public X data. The account is pinned at the attempt's
+ * first X read: later links and unlinks do not change the attempt. `connection()`, `profile()`,
+ * `follows()` and `reposted()` resolve to `null` when the member has no linked X account;
+ * `post()` reads any public post and resolves to `null` when it does not exist. Provider failures
+ * throw `CapabilityError` with code `"provider-unavailable"`.
+ */
 interface XReader {
     connection(): Promise<XConnection | null>;
-    profile(): Promise<XProfile>;
+    profile(): Promise<XProfile | null>;
     post(input: {
         postId: string;
-    }): Promise<XPost>;
+    }): Promise<XPost | null>;
     follows(input: {
         userId: string;
-    }): Promise<boolean>;
+    }): Promise<boolean | null>;
     reposted(input: {
         postId: string;
-    }): Promise<boolean>;
+    }): Promise<boolean | null>;
 }
 
 declare const completionPolicySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -412,4 +355,71 @@ declare const projectIntegrationSchema: z.ZodObject<{
 }, z.core.$strip>;
 type ProjectIntegration = z.infer<typeof projectIntegrationSchema>;
 
-export { resourceRequestSchema as A, type Budget as B, resourceSourceSchema as C, type DiscordMessage as D, settingFieldSchema as E, settingsFieldsSchema as F, settingsValuesSchema as G, xConnectionSchema as H, type IntegerSettings as I, xIdSchema as J, xPostSchema as K, xProfileSchema as L, xRequestSchema as M, type ProjectIntegration as P, type ResourceOption as R, type Setting as S, type XConnection as X, type DiscordMessageData as a, type DiscordMessageTextData as b, type DiscordReactionData as c, type IntegrationProvider as d, type ResourceSource as e, type SettingField as f, type SettingsValues as g, type XPost as h, type XProfile as i, type XReader as j, budgetSchema as k, compatibleSettingKinds as l, completionKeySchema as m, completionPolicySchema as n, discordMessageDataSchema as o, discordMessageSchema as p, discordMessageTextDataSchema as q, discordMessagesSourceSchema as r, discordReactionDataSchema as s, discordReactionsSourceSchema as t, discordServerSchema as u, integrationProviderSchema as v, missingResourceSettings as w, parseSettings as x, projectIntegrationSchema as y, resourceOptionsSchema as z };
+/**
+ * Why an evaluator capability could not answer:
+ *
+ * - `not-linked`: the call needs a member account that is not linked, and its result cannot be
+ *   null, such as an image check of the member's X profile picture. Readers of the member's own
+ *   accounts return `null` instead.
+ * - `provider-unavailable`: the provider (X, Discord, a chain RPC, AI review) did not answer, or
+ *   the project's integration cannot reach it.
+ * - `author-error`: the call cannot be answered as written: invalid input, an undeclared
+ *   integration, an unknown tracker, a chain Relay does not read, a wallet the member never
+ *   linked, or an image that does not exist.
+ *
+ * Later versions can add codes. Treat an unknown code as a failure its `message` explains.
+ */
+declare const capabilityErrorCodes: readonly ["not-linked", "provider-unavailable", "author-error"];
+type KnownCapabilityErrorCode = (typeof capabilityErrorCodes)[number];
+/** A known code, or one a newer Relay added. */
+type CapabilityErrorCode = KnownCapabilityErrorCode | (string & {});
+/**
+ * A capability failure as it crosses the sandbox boundary and as Relay captures it. Open, so a
+ * newer Relay can add codes and fields without breaking an older evaluator or Worker.
+ */
+declare const capabilityFailureSchema: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    /**
+     * True when Relay retries the attempt if the error reaches it uncaught, and calls the provider
+     * again. A failure that is not retryable is captured (or follows from the attempt's pinned
+     * inputs), so every run of the attempt sees it again. A retryable failure that quest code
+     * handles and moves past is final for the attempt; one that escapes the evaluation is retried.
+     */
+    retryable: z.ZodBoolean;
+}, z.core.$loose>;
+type CapabilityFailure = z.infer<typeof capabilityFailureSchema>;
+/**
+ * Thrown by an evaluator capability (`ctx.x`, `ctx.discord`, `ctx.wallet`, `ctx.trackers`,
+ * `ctx.images`, `ctx.review`) that could not answer. A capability whose subject is missing (an
+ * account the member has not linked, a deleted post or message) returns `null` instead of
+ * throwing.
+ *
+ * Catch it to decide yourself; rethrow anything else. An uncaught retryable error makes Relay
+ * retry the attempt later; an uncaught one that is not retryable fails it.
+ *
+ * ```ts
+ * try {
+ *   return (await ctx.x.follows({ userId })) ? decision.accept() : decision.reject({ reason })
+ * } catch (error) {
+ *   if (error instanceof CapabilityError && error.code === "provider-unavailable")
+ *     return decision.review({ reason: "X is unavailable" })
+ *   throw error
+ * }
+ * ```
+ */
+declare class CapabilityError extends Error {
+    readonly code: CapabilityErrorCode;
+    readonly retryable: boolean;
+    constructor(code: CapabilityErrorCode, message: string, options?: {
+        retryable?: boolean;
+    });
+    static [Symbol.hasInstance](value: unknown): boolean;
+    /**
+     * The error for a captured or transported failure. A code this SDK does not know is never
+     * retryable: nothing tells it a retry would help.
+     */
+    static from(failure: CapabilityFailure): CapabilityError;
+}
+
+export { xIdSchema as A, type Budget as B, type CapabilityErrorCode as C, xPostSchema as D, xProfileSchema as E, xRequestSchema as F, CapabilityError as G, type IntegerSettings as I, type KnownCapabilityErrorCode as K, type ProjectIntegration as P, type ResourceOption as R, type Setting as S, type XConnection as X, type CapabilityFailure as a, type IntegrationProvider as b, type ResourceSource as c, type SettingField as d, type SettingsValues as e, type XPost as f, type XProfile as g, type XReader as h, budgetSchema as i, capabilityErrorCodes as j, capabilityFailureSchema as k, compatibleSettingKinds as l, completionKeySchema as m, completionPolicySchema as n, discordServerSchema as o, integrationProviderSchema as p, missingResourceSettings as q, parseSettings as r, projectIntegrationSchema as s, resourceOptionsSchema as t, resourceRequestSchema as u, resourceSourceSchema as v, settingFieldSchema as w, settingsFieldsSchema as x, settingsValuesSchema as y, xConnectionSchema as z };

package/dist/{chunk-HWRBLM7E.js → chunk-JZ74VJX4.js}

@@ -52,20 +52,25 @@ var participantExchangeSchema = z.object({
 }).strict();
 
 // src/image-results.ts
+import { z as z2 } from "zod";
+var invalid = (message, path) => new z2.ZodError([{ code: "custom", message, path, input: void 0 }]);
 function parseImageExtraction(raw, value) {
   const result = imageExtractionSchema.parse(value);
   const fields = imageFieldsSchema.parse(raw);
   for (const [key, field] of Object.entries(fields)) {
     const extracted = result.values[key];
     if (extracted === void 0) {
-      throw new Error("Image extraction omitted " + key);
+      throw invalid("Image extraction omitted " + key, ["values", key]);
     }
     if (extracted !== null && typeof extracted !== field.type) {
-      throw new Error("Image extraction returned the wrong type for " + key);
+      throw invalid("Image extraction returned the wrong type for " + key, [
+        "values",
+        key
+      ]);
     }
   }
   if (Object.keys(result.values).some((key) => !Object.hasOwn(fields, key))) {
-    throw new Error("Image extraction returned an undeclared field");
+    throw invalid("Image extraction returned an undeclared field", ["values"]);
   }
   return result;
 }
@@ -85,8 +90,8 @@ function parseImageResult(request, value) {
 }
 
 // src/sequence-cursor.ts
-import { z as z2 } from "zod";
-var sequenceCursorSchema = z2.string().regex(/^[1-9][0-9]{0,15}$/, "Invalid cursor").transform(Number).pipe(z2.number().int().positive().safe());
+import { z as z3 } from "zod";
+var sequenceCursorSchema = z3.string().regex(/^[1-9][0-9]{0,15}$/, "Invalid cursor").transform(Number).pipe(z3.number().int().positive().safe());
 
 export {
   questConfiguration,

package/dist/chunk-MC6V6VMG.js

@@ -0,0 +1,49 @@
+// src/capability-error.ts
+import { z } from "zod";
+var capabilityErrorCodes = [
+  "not-linked",
+  "provider-unavailable",
+  "author-error"
+];
+var isKnown = (code) => capabilityErrorCodes.includes(code);
+var capabilityFailureSchema = z.looseObject({
+  code: z.string().min(1),
+  message: z.string().min(1),
+  /**
+   * True when Relay retries the attempt if the error reaches it uncaught, and calls the provider
+   * again. A failure that is not retryable is captured (or follows from the attempt's pinned
+   * inputs), so every run of the attempt sees it again. A retryable failure that quest code
+   * handles and moves past is final for the attempt; one that escapes the evaluation is retried.
+   */
+  retryable: z.boolean()
+});
+var brand = /* @__PURE__ */ Symbol.for("@domino-sdk/relay/CapabilityError");
+var CapabilityError = class _CapabilityError extends Error {
+  code;
+  retryable;
+  constructor(code, message, options = {}) {
+    super(message);
+    this.name = "CapabilityError";
+    this.code = code;
+    this.retryable = options.retryable ?? code === "provider-unavailable";
+    Object.defineProperty(this, brand, { value: true });
+  }
+  static [Symbol.hasInstance](value) {
+    return typeof value === "object" && value !== null && value[brand] === true;
+  }
+  /**
+   * The error for a captured or transported failure. A code this SDK does not know is never
+   * retryable: nothing tells it a retry would help.
+   */
+  static from(failure) {
+    return new _CapabilityError(failure.code, failure.message, {
+      retryable: isKnown(failure.code) && failure.retryable
+    });
+  }
+};
+
+export {
+  capabilityErrorCodes,
+  capabilityFailureSchema,
+  CapabilityError
+};

package/dist/{client-dfXT6hhq.d.ts → client-DG9qAB4o.d.ts}

@@ -1,12 +1,12 @@
 import { h as QuestView, J as questExperienceSchema, e as PointHistoryQuery, c as PointEntryKind } from './catalog-CVXUHxiO.js';
-import { V as ValueEvidence, a as AuthProvider } from './submission-input-CccwAl5Z.js';
+import { V as ValueEvidence, a as AuthProvider } from './submission-input-CkmBmSL1.js';
 import { R as RequestError, a as RequestErrorDetails, b as RequestErrorKind } from './request-error-VnTiMXc3.js';
 import { b as QuizEvidence, A as Attempt, M as MemberProgress, ao as submitSchema, x as contentPerformanceQuerySchema } from './schema-C4F2K9cm.js';
 import { z } from 'zod';
 import { c as ParticipantSession, a as PageQuery, f as exchangeSchema } from './pages-KYK1L60W.js';
 import { a6 as referralAcceptSchema, c as LeaderboardQuery, G as engagementPageQuerySchema, s as contentQualificationQuerySchema, i as contentAdmissionQuerySchema, k as contentEnrollmentInputSchema, u as contentReleaseInputSchema } from './referrals-KQfP4pBf.js';
-import { F as profileUpdateSchema, c as ProfileCompletionQuery } from './profiles-BtOXMGcC.js';
-import { x as walletAddressInputSchema, M as walletSignatureSchema, L as LinkedWallet, f as WalletSigner } from './wallet-BtiG0Xhr.js';
+import { F as profileUpdateSchema, c as ProfileCompletionQuery } from './profiles-md0g5fjx.js';
+import { y as walletAddressInputSchema, N as walletSignatureSchema, L as LinkedWallet, f as WalletSigner } from './wallet-CYK5E2wj.js';
 
 /** What happened, as in every Domino client error (see `RequestError`). */
 type RelayErrorKind = RequestErrorKind;

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

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { i as TrackerDataSchema } from './trackers-7lxSWp2g.js';
+import { i as TrackerDataSchema } from './trackers-Cg2MzFEf.js';
 
 /**
  * The canonical name of a named IANA timezone, or null for an unknown name or a fixed offset.

package/dist/index.d.ts

@@ -1,13 +1,13 @@
-export { C as ClaimSubmission, K as KnownRelayErrorCode, P as PhotoSubmission, a as ProgressObservation, b as ProgressObserver, Q as QuestActionResult, c as QuestController, d as QuestUpdatedError, e as QuizSubmission, R as RelayClient, f as RelayClientOptions, g as RelayError, h as RelayErrorCode, i as RelayErrorDetails, j as RelayErrorKind, k as RelayRequestOptions, S as SubmissionDraft, l as SubmissionStatus, m as SubmissionStore, V as ValueSubmission, n as createRelayClient, o as isRelayError } from './client-dfXT6hhq.js';
+export { C as ClaimSubmission, K as KnownRelayErrorCode, P as PhotoSubmission, a as ProgressObservation, b as ProgressObserver, Q as QuestActionResult, c as QuestController, d as QuestUpdatedError, e as QuizSubmission, R as RelayClient, f as RelayClientOptions, g as RelayError, h as RelayErrorCode, i as RelayErrorDetails, j as RelayErrorKind, k as RelayRequestOptions, S as SubmissionDraft, l as SubmissionStatus, m as SubmissionStore, V as ValueSubmission, n as createRelayClient, o as isRelayError } from './client-DG9qAB4o.js';
 export { R as RequestError, a as RequestErrorDetails, b as RequestErrorKind, c as RequestRecovery, i as isRequestError } from './request-error-VnTiMXc3.js';
 export { f as formatUnits, p as parseUnits } from './units-CwgsPB_r.js';
-export { A as AccountConnection, a as AuthProvider, T as TextEvidence, b as TextOptions, U as UrlEvidence, c as UrlOptions, V as ValueEvidence } from './submission-input-CccwAl5Z.js';
+export { A as AccountConnection, a as AuthProvider, T as TextEvidence, b as TextOptions, U as UrlEvidence, c as UrlOptions, V as ValueEvidence } 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, s as sessionMember } from './pages-KYK1L60W.js';
 export { K as KnownPointEntryKind, P as PointBalance, a as PointBalances, b as PointEntry, c as PointEntryKind, d as PointHistoryPage, e as PointHistoryQuery, f as PointLedgerReference, Q as QuestInteraction, g as QuestRewardView, h as QuestView } from './catalog-CVXUHxiO.js';
 export { C as CollectionPass } from './collection-BGneJ6Bk.js';
 export { L as LeaderboardDefinition, a as LeaderboardPage, b as LeaderboardPlacement, c as LeaderboardQuery, R as ReferralDefinition } from './referrals-KQfP4pBf.js';
-export { A as AvatarProvider, O as OwnProfile, P as ProfileAvatar, a as ProfileCompletion, b as ProfileCompletionPage, c as ProfileCompletionQuery, d as ProfileReferral, e as ProfileSummary, f as ProfileUpdate, g as ProfileVisibility } from './profiles-BtOXMGcC.js';
+export { A as AvatarProvider, O as OwnProfile, P as ProfileAvatar, a as ProfileCompletion, b as ProfileCompletionPage, c as ProfileCompletionQuery, d as ProfileReferral, e as ProfileSummary, f as ProfileUpdate, g as ProfileVisibility } from './profiles-md0g5fjx.js';
 export { Q as QuizContent, S as StreakProgress } from './streaks-CWyq8Px5.js';
 export { A as Attempt, E as Entitlement, M as MemberProgress, Q as QuestPresentation, a as QuestProfile, b as QuizEvidence, R as Reward, S as SubmissionEvidence, c as SubmitInput, T as TieredRewardReference } from './schema-C4F2K9cm.js';
-export { C as CosmosChain, a as CosmosNetwork, L as LinkedWallet, W as WalletAddressInput, b as WalletChain, c as WalletMessageChallenge, d as WalletSignInNetwork, e as WalletSignature, f as WalletSigner, g as WalletUnlinkInput } from './wallet-BtiG0Xhr.js';
+export { C as CosmosChain, a as CosmosNetwork, L as LinkedWallet, W as WalletAddressInput, b as WalletChain, c as WalletMessageChallenge, d as WalletSignInNetwork, e as WalletSignature, f as WalletSigner, g as WalletUnlinkInput } from './wallet-CYK5E2wj.js';
 import 'zod';

package/dist/internal.d.ts

@@ -2,8 +2,8 @@ import { f as PublishedRelease } from './schema-C4F2K9cm.js';
 export { i as identityIntegrationInputSchema, a as identityIntegrationSchema, b as identityIntegrationSecretSchema, p as participantExchangeSchema } from './identity-integration-CBR8l3ju.js';
 import { c as ImageFields, g as ImageRequest } from './images-CRxHUuG5.js';
 import { z } from 'zod';
-import { t as TrackerSource, i as TrackerDataSchema } from './trackers-7lxSWp2g.js';
-export { az as TrackerDataBudget, aA as schemaCheckedReader, aB as trackerDataBatchSteps, aC as trackerDataIssue, aD as trackerDataIssues, aE as trackerDataPathTypes, aF as trackerDataRecordSteps, aG as whereSchemaIssue } from './trackers-7lxSWp2g.js';
+import { u as TrackerSource, i as TrackerDataSchema } from './trackers-Cg2MzFEf.js';
+export { aA as TrackerDataBudget, aB as schemaCheckedReader, aC as trackerDataBatchSteps, aD as trackerDataIssue, aE as trackerDataIssues, aF as trackerDataPathTypes, aG as trackerDataRecordSteps, aH as whereSchemaIssue } from './trackers-Cg2MzFEf.js';
 
 /** Older releases did not record ownership. Preserve every value, including defaults. */
 declare function questConfiguration(release: PublishedRelease): {

package/dist/internal.js

@@ -7,7 +7,7 @@ import {
   participantExchangeSchema,
   questConfiguration,
   sequenceCursorSchema
-} from "./chunk-HWRBLM7E.js";
+} from "./chunk-JZ74VJX4.js";
 import "./chunk-CYD6QMHU.js";
 import {
   sourceDataSchema,

package/dist/react/index.d.ts

@@ -3,13 +3,13 @@ import { ReactNode } from 'react';
 import { a6 as referralAcceptSchema, c as LeaderboardQuery, G as engagementPageQuerySchema, s as contentQualificationQuerySchema, i as contentAdmissionQuerySchema, k as contentEnrollmentInputSchema, u as contentReleaseInputSchema, b as LeaderboardPlacement, af as referralSummarySchema, a as LeaderboardPage } from '../referrals-KQfP4pBf.js';
 import { ao as submitSchema, x as contentPerformanceQuerySchema, T as TieredRewardReference } from '../schema-C4F2K9cm.js';
 import { a as PageQuery, f as exchangeSchema, P as Page, c as ParticipantSession, M as MemberSummary } 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 { y as walletAddressInputSchema, N as walletSignatureSchema, L as LinkedWallet, f as WalletSigner, d as WalletSignInNetwork } from '../wallet-CYK5E2wj.js';
 import { h as QuestView, J as questExperienceSchema, e as PointHistoryQuery, c as PointEntryKind, a as PointBalances, b as PointEntry, f as PointLedgerReference } from '../catalog-CVXUHxiO.js';
-import { F as profileUpdateSchema, c as ProfileCompletionQuery, f as ProfileUpdate, e as ProfileSummary, a as ProfileCompletion, d as ProfileReferral } from '../profiles-BtOXMGcC.js';
+import { F as profileUpdateSchema, c as ProfileCompletionQuery, f as ProfileUpdate, e as ProfileSummary, a as ProfileCompletion, d as ProfileReferral } from '../profiles-md0g5fjx.js';
 import * as zod from 'zod';
 import { z } from 'zod';
-import { g as RelayError, 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-dfXT6hhq.js';
-import { a as AuthProvider, A as AccountConnection } from '../submission-input-CccwAl5Z.js';
+import { g as RelayError, 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-DG9qAB4o.js';
+import { a as AuthProvider, A as AccountConnection } from '../submission-input-CkmBmSL1.js';
 import { createBrowserRelayClient, SignInMethods, CosmosChains, SignInOption, SignInUnavailable, SignInWallet, DiscoveredWallet } from '../browser.js';
 export { EmailSignInOption, OAuthSignInOption, SignInIcon, WalletSignInOption } from '../browser.js';
 import '../request-error-VnTiMXc3.js';
@@ -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 };