@domino-sdk/relay 1.54.0 → 1.55.0

package/dist/{chunk-IELNFM3V.js → chunk-YCOKTQ4E.js}

@@ -75,6 +75,11 @@ var RelayErrorCode = {
    * says when they may submit again.
    */
   RetryCooldown: "retry-cooldown",
+  /**
+   * The member's last accepted completion of the quest is more recent than its completion
+   * cooldown; `retryAt` says when they may submit again.
+   */
+  CompletionCooldown: "completion-cooldown",
   /** The quiz changed since the member answered it. */
   StaleQuiz: "stale-quiz",
   /** Relay refused the submitted evidence. */
@@ -135,7 +140,10 @@ var RelayError = class extends RequestError {
   window;
   /** Prerequisites the member does not currently meet, when Relay refused for that reason. */
   missing;
-  /** Unix milliseconds when the member may submit again, when `code` is `retry-cooldown`. */
+  /**
+   * Unix milliseconds when the member may submit again, when `code` is `retry-cooldown` or
+   * `completion-cooldown`.
+   */
   retryAt;
   constructor(message, details) {
     super(message, details);
@@ -1346,6 +1354,21 @@ var trackerStatusSchema = z8.object({
   archivedAt: z8.number().int().nonnegative().nullable().optional(),
   published: publishedTrackerSchema,
   paused: z8.boolean(),
+  /**
+   * Why a paused tracker is paused, null when it isn't: `operator` (paused by hand),
+   * `x-budget-exhausted` (the project's monthly X budget, or in test the organization's, is spent;
+   * it resumes on its own at `resumesAt`, or sooner on a plan that allows more), or
+   * `test-window-ended` (a test X tracker collects for 14 days; resume it for another 14). Treat an
+   * unknown reason, which a newer Relay can add, as paused. Older servers leave it out.
+   */
+  pauseReason: z8.string().nullable().optional(),
+  /** When a tracker paused on its X budget resumes on its own: the start of the next UTC month. */
+  resumesAt: timestamp.nullable().optional(),
+  /**
+   * The interval a scheduled tracker actually runs at: `refreshSeconds`, but no shorter than the
+   * project's plan allows (6 hours, shorter on Enterprise). Older servers leave it out.
+   */
+  effectiveRefreshSeconds: z8.number().int().positive().optional(),
   state: z8.enum(["idle", "syncing", "error", "complete"]),
   lastStartedAt: timestamp.nullable(),
   lastCompletedAt: timestamp.nullable(),
@@ -2112,7 +2135,9 @@ var reservedAttemptCodes = Object.freeze([
   "integration-required",
   "not-linked",
   "provider-unavailable",
-  "author-error"
+  "author-error",
+  "evaluator-error",
+  "capability-limit"
 ]);
 var rejectCodeMaxLength = 64;
 var rejectCodePattern = /^[a-z0-9-]+$/;
@@ -2198,6 +2223,12 @@ var budgetSchema = z16.object({
     z16.object({ balance: name }).strict()
   ])
 }).strict();
+var memberCompletionSchema = z16.object({
+  quest: z16.string().min(1).max(200),
+  key: completionKeySchema,
+  completedAt: z16.number().int().nonnegative().safe().nullable()
+});
+var maxMemberCompletions = 100;
 
 // src/integrations.ts
 import * as z17 from "zod";
@@ -2554,9 +2585,17 @@ var settingFieldSchema = z23.discriminatedUnion("kind", [
     multiline: z23.boolean(),
     /**
      * A list Console offers the value from, beside free text: `telegram-chat` lists the
-     * project's connected Telegram chats. Unknown pickers read as free text.
+     * project's connected Telegram chats. Unknown pickers read as free text. Two pickers also
+     * constrain the value, at publication and when an operator edits it: `amount`, a
+     * non-negative integer in a token's base units (`settings.amount()`), and `chain`, a chain
+     * `ctx.wallet.balance()` reads (`settings.chain()`).
+     */
+    picker: z23.string().optional(),
+    /**
+     * On an `amount` setting, the token's decimals: Console shows and edits the value in whole
+     * tokens.
      */
-    picker: z23.string().optional()
+    decimals: z23.number().int().min(0).max(255).optional()
   }).strict(),
   z23.object({
     ...base,
@@ -2581,6 +2620,32 @@ var settingsValuesSchema = z23.record(
   z23.string(),
   z23.union([z23.string(), z23.number().finite(), z23.boolean(), quizContentSchema])
 );
+function isAmount(value) {
+  return value.length <= 100 && /^(0|[1-9][0-9]*)$/.test(value);
+}
+function isBalanceChain(value) {
+  return value === "solana" || value === solanaMainnet || isEvmChainId(value);
+}
+function isBoundSetting(field) {
+  return field?.kind === "integer" || field?.kind === "text" && field.picker === "amount";
+}
+function textSettingSchema(field) {
+  const text = z23.string().min(field.minLength).max(field.maxLength);
+  switch (field.picker) {
+    case "amount":
+      return text.refine(
+        isAmount,
+        "Use a whole number of base units, such as 1000000"
+      );
+    case "chain":
+      return text.refine(
+        isBalanceChain,
+        'Use "solana" or an EVM chain ID such as "eip155:8453"'
+      );
+    default:
+      return text;
+  }
+}
 function parseSettings(fields2, input) {
   const shape = {};
   for (const [key, field] of Object.entries(fields2)) {
@@ -2598,7 +2663,7 @@ function parseSettings(fields2, input) {
         shape[key] = quizContentSchema.default(field.default);
         break;
       case "text":
-        shape[key] = z23.string().min(field.minLength).max(field.maxLength).default(field.default);
+        shape[key] = textSettingSchema(field).default(field.default);
         break;
       case "integer":
         shape[key] = z23.number().int().min(field.min).max(field.max).default(field.default);
@@ -3107,7 +3172,13 @@ var questDescriptionSchema = z28.object({
    * Milliseconds a member waits after an attempt is rejected (by the evaluator or a reviewer)
    * before submitting this quest again. Only for quests members submit. Omitted: no cooldown.
    */
-  retryCooldownMs: retryCooldownMsSchema.optional()
+  retryCooldownMs: retryCooldownMsSchema.optional(),
+  /**
+   * Milliseconds a member waits after an accepted completion of this quest, of any key, before
+   * submitting it again. Only for repeatable quests members submit; same bounds as
+   * `retryCooldownMs`. Omitted: no cooldown.
+   */
+  completionCooldownMs: retryCooldownMsSchema.optional()
 }).strict();
 var artifactSchema = z28.object({ code: z28.string().min(1).max(1e6) }).strict();
 var releaseSchema = artifactSchema.extend({
@@ -3522,6 +3593,15 @@ var memberProgressSchema = responseShape(
          * `retry-cooldown`. Absent when no cooldown is running.
          */
         retryAt: z28.number().int().safe().optional(),
+        /**
+         * Unix milliseconds when the member may next submit the quest, while it waits on something
+         * that ends by itself: the retry cooldown after a rejection, the completion cooldown after
+         * an accepted completion, an exhausted budget's next reset, or the next window of a counter
+         * that pays once per window. The latest of these when
+         * several apply; use it for countdowns. Absent when the member can submit now, or when
+         * nothing will reopen the quest (a used-up lifetime budget, a closed window).
+         */
+        nextAvailableAt: z28.number().int().safe().optional(),
         attempt: attemptSchema.nullable()
       })
     ),
@@ -3558,7 +3638,10 @@ var errorSchema = z28.object({
   /** Which window refused admission when `code` is `outside-window`. */
   window: z28.enum(["tracker", "quest"]).optional(),
   missing: z28.array(missingPrerequisiteSchema).optional(),
-  /** Unix milliseconds when the member may submit again, when `code` is `retry-cooldown`. */
+  /**
+   * Unix milliseconds when the member may submit again, when `code` is `retry-cooldown` or
+   * `completion-cooldown`.
+   */
   retryAt: z28.number().int().safe().optional()
 });
 var staffDecisionSchema = z28.object({
@@ -3810,6 +3893,8 @@ export {
   completionPolicySchema,
   completionKeySchema,
   budgetSchema,
+  memberCompletionSchema,
+  maxMemberCompletions,
   evaluatorIntegrationProviderSchema,
   integrationProviderSchema,
   discordServerSchema,
@@ -3856,6 +3941,10 @@ export {
   settingFieldSchema,
   settingsFieldsSchema,
   settingsValuesSchema,
+  isAmount,
+  isBalanceChain,
+  isBoundSetting,
+  textSettingSchema,
   parseSettings,
   missingResourceSettings,
   compatibleSettingKinds,

package/dist/{chunk-LPHXTZDA.js → chunk-YE3XYB2F.js}

@@ -4,10 +4,10 @@ import {
   imageFieldsSchema,
   imageInspectionSchema,
   imageSightingsSchema
-} from "./chunk-K6TVMNU4.js";
+} from "./chunk-YEVD4A5X.js";
 import {
   photoResultSchema
-} from "./chunk-IELNFM3V.js";
+} from "./chunk-YCOKTQ4E.js";
 
 // src/image-results.ts
 import * as z from "zod";

package/dist/{chunk-K6TVMNU4.js → chunk-YEVD4A5X.js}

@@ -2,7 +2,7 @@ import {
   identifier,
   responseShape,
   xTweetSchema
-} from "./chunk-IELNFM3V.js";
+} from "./chunk-YCOKTQ4E.js";
 
 // src/x.ts
 import * as z from "zod";

package/dist/{client-CzNtl8UO.d.ts → client-C4zUZKpj.d.ts}

@@ -1,12 +1,12 @@
-import { y as referralAcceptSchema, i as LeaderboardQuery, b as CampaignEnrollmentInput, d as CampaignWithdrawalInput, o as PointHistoryQuery, m as PointEntryKind, f as LeaderboardHistoryQuery, z as engagementPageQuerySchema } from './groups-B5R1RCsl.js';
-import { j as QuestView, k as ResponseSchema, a as PageQuery, c as QuestEnrollmentInput, Q as QuestClaimInput, g as QuestOutcomeQuery, q as questExperienceSchema, l as RewardDeliveryQuery, m as RewardDeliveryAction, n as contentQualificationQuerySchema } from './pages-BTlOg8sl.js';
-import { M as MissingPrerequisite, V as ValueEvidence } from './submission-input-BNah53go.js';
+import { m as QuizEvidence, A as Attempt, M as MemberProgress, a as AttemptStatus, o as TrackerSkipCode, i as PointHistoryQuery, g as PointEntryKind, ao as submitSchema, ap as contentPerformanceQuerySchema } from './schema-C4m9RhCR.js';
+import { j as QuestView, k as ResponseSchema, a as PageQuery, c as QuestEnrollmentInput, Q as QuestClaimInput, g as QuestOutcomeQuery, q as questExperienceSchema, l as RewardDeliveryQuery, m as RewardDeliveryAction, n as contentQualificationQuerySchema } from './pages-BFloMpyQ.js';
+import { M as MissingPrerequisite, V as ValueEvidence } from './submission-input-BbdawqVy.js';
 import { a as RequestError, b as RequestErrorDetails, c as RequestErrorKind, e as createRelayAction, O as OptionalActionId } from './action-DBzILFx9.js';
-import { f as QuizEvidence, A as Attempt, M as MemberProgress, a as AttemptStatus, h as TrackerSkipCode, ae as submitSchema, af as contentPerformanceQuerySchema } from './schema-BJ9bOgpN.js';
 import { b as ParticipantSession, e as exchangeSchema, R as RelayEvent, P as ParticipantActivity } from './participant-activity-iciCEs_8.js';
 import * as z from 'zod';
 import { a as AuthProvider } from './accounts-DRPENuZe.js';
-import { p as profileUpdateSchema, c as ProfileCompletionQuery } from './profiles-Cdv4BSd_.js';
+import { p as referralAcceptSchema, i as LeaderboardQuery, b as CampaignEnrollmentInput, d as CampaignWithdrawalInput, f as LeaderboardHistoryQuery, q as engagementPageQuerySchema } from './groups-O6onGPmC.js';
+import { p as profileUpdateSchema, c as ProfileCompletionQuery } from './profiles-BoOK03cR.js';
 import { w as walletAddressInputSchema, o as walletSignatureSchema, L as LinkedWallet, f as WalletSigner } from './wallet-Ac7OFpOr.js';
 
 /** What happened, as in every Domino client error (see `RequestError`). */
@@ -59,6 +59,11 @@ declare const RelayErrorCode: {
      * says when they may submit again.
      */
     readonly RetryCooldown: "retry-cooldown";
+    /**
+     * The member's last accepted completion of the quest is more recent than its completion
+     * cooldown; `retryAt` says when they may submit again.
+     */
+    readonly CompletionCooldown: "completion-cooldown";
     /** The quiz changed since the member answered it. */
     readonly StaleQuiz: "stale-quiz";
     /** Relay refused the submitted evidence. */
@@ -115,7 +120,10 @@ type RelayErrorDetails = RequestErrorDetails & {
     /** Which window refused admission when `code` is `outside-window`. */
     window?: "tracker" | "quest";
     missing?: MissingPrerequisite[];
-    /** Unix milliseconds when the member may submit again, when `code` is `retry-cooldown`. */
+    /**
+     * Unix milliseconds when the member may submit again, when `code` is `retry-cooldown` or
+     * `completion-cooldown`.
+     */
     retryAt?: number;
 };
 declare const relayErrorBrand: unique symbol;
@@ -134,7 +142,10 @@ declare class RelayError extends RequestError {
     readonly window: "tracker" | "quest" | undefined;
     /** Prerequisites the member does not currently meet, when Relay refused for that reason. */
     readonly missing: MissingPrerequisite[];
-    /** Unix milliseconds when the member may submit again, when `code` is `retry-cooldown`. */
+    /**
+     * Unix milliseconds when the member may submit again, when `code` is `retry-cooldown` or
+     * `completion-cooldown`.
+     */
     readonly retryAt: number | undefined;
     constructor(message: string, details: RelayErrorDetails);
 }
@@ -1217,6 +1228,15 @@ declare function relayClient(options: RelayClientOptions): {
                         amount: number;
                     })[];
                 }[];
+                pool?: {
+                    amount: string;
+                    unit: "points" | {
+                        code: string;
+                        decimals: number;
+                    };
+                    ledger?: string | undefined;
+                    minScore?: number | undefined;
+                } | undefined;
             } | undefined;
         }[]>;
         standings: (board: string, query?: LeaderboardQuery, requestOptions?: RelayRequestOptions) => Promise<{
@@ -1364,6 +1384,7 @@ declare function relayClient(options: RelayClientOptions): {
             options: {
                 provider: "discord" | "google" | "x";
                 name: string | null;
+                givenName: string | null;
                 imageUrl: string | null;
             }[];
         }>;
@@ -1398,6 +1419,7 @@ declare function relayClient(options: RelayClientOptions): {
             options: {
                 provider: "discord" | "google" | "x";
                 name: string | null;
+                givenName: string | null;
                 imageUrl: string | null;
             }[];
         }>;
@@ -1434,6 +1456,7 @@ declare function relayClient(options: RelayClientOptions): {
             options: {
                 provider: "discord" | "google" | "x";
                 name: string | null;
+                givenName: string | null;
                 imageUrl: string | null;
             }[];
         }>;
@@ -1899,6 +1922,7 @@ declare function relayClient(options: RelayClientOptions): {
                 } | null;
             } | null | undefined;
             retryAt?: number | undefined;
+            nextAvailableAt?: number | undefined;
         }>;
         /**
          * Enrolls the signed-in member in a quest whose tracker trigger requires enrollment. Activity
@@ -2586,6 +2610,7 @@ declare function relayClient(options: RelayClientOptions): {
                     } | null;
                 } | null | undefined;
                 retryAt?: number | undefined;
+                nextAvailableAt?: number | undefined;
             }[];
             collections: {
                 id: string;
@@ -2999,6 +3024,7 @@ declare function relayClient(options: RelayClientOptions): {
                         } | null;
                     } | null | undefined;
                     retryAt?: number | undefined;
+                    nextAvailableAt?: number | undefined;
                 }[];
                 key?: string | undefined;
                 description?: string | undefined;
@@ -3418,6 +3444,7 @@ declare function relayClient(options: RelayClientOptions): {
                     } | null;
                 } | null | undefined;
                 retryAt?: number | undefined;
+                nextAvailableAt?: number | undefined;
             }[];
             key?: string | undefined;
             description?: string | undefined;
@@ -4224,6 +4251,7 @@ declare function relayClient(options: RelayClientOptions): {
                     } | null;
                 } | null | undefined;
                 retryAt?: number | undefined;
+                nextAvailableAt?: number | undefined;
             }[];
             entitlements: ({
                 [x: string]: unknown;