@domino-sdk/relay 1.54.0 → 1.56.0

package/dist/{chunk-IELNFM3V.js → chunk-BHHUSBSD.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. */
@@ -105,7 +110,7 @@ var RelayErrorCode = {
   Credential: "credential",
   /** A wallet signer failed or the member refused to sign; `cause` is the wallet's own error. */
   WalletSigner: "wallet-signer",
-  /** The member has not met the quest's prerequisites; `missing` lists them. */
+  /** The member has not met the quest's or offer's prerequisites; `missing` lists them. */
   PrerequisitesIncomplete: "prerequisites-incomplete",
   /** The quest is archived or retired: it takes no new participation. */
   QuestClosed: "quest-closed",
@@ -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,