@domino-sdk/relay 1.54.0 → 1.56.0

package/dist/authoring.js

@@ -2,6 +2,15 @@ import {
   formatUnits,
   parseUnits
 } from "./chunk-V7UKZLHA.js";
+import {
+  defineDashboard,
+  tiktokVideoBodySchema,
+  tiktokVideoMetrics,
+  tiktokVideosNamespace,
+  youtubeShortBodySchema,
+  youtubeShortMetrics,
+  youtubeShortsNamespace
+} from "./chunk-ULQU7KC4.js";
 import {
   CapabilityError,
   capabilityErrorCodes
@@ -10,7 +19,7 @@ import {
   sourceDataSchema,
   sourceRoles,
   validateQuestShape
-} from "./chunk-S2PMKZSX.js";
+} from "./chunk-H2MD6E7Z.js";
 import {
   badgeDeclarationSchema,
   defineOffer,
@@ -18,13 +27,13 @@ import {
   engagementScoreInputSchema,
   engagementScoreSchema,
   leaderboardAuthoringSchema,
-  pointLedgerDeclarationSchema,
   referralAuthoringSchema
-} from "./chunk-CCE2JWES.js";
+} from "./chunk-BJYMTCWG.js";
 import {
+  pointLedgerDeclarationSchema,
   telegramReactionDataSchema,
   telegramReactionsNamespace
-} from "./chunk-2NUD237O.js";
+} from "./chunk-VSHV7FEA.js";
 import {
   authoringKey,
   badgeReward,
@@ -52,6 +61,9 @@ import {
   groupReward,
   identifier,
   inGroup,
+  isAmount,
+  isBalanceChain,
+  isBoundSetting,
   isEvmChainId,
   ledgerKey,
   ledgerSettingSchema,
@@ -73,6 +85,7 @@ import {
   sourceIdentities,
   streakPolicySchema,
   textOptionsSchema,
+  textSettingSchema,
   tierRewardSchema,
   tieredRewardDefinitionSchema,
   trackerDataIssue,
@@ -84,7 +97,7 @@ import {
   whereSchemaIssue,
   whereSettings,
   xSearchSourceSchema
-} from "./chunk-IELNFM3V.js";
+} from "./chunk-BHHUSBSD.js";
 
 // src/builders.ts
 import * as z from "zod";
@@ -155,9 +168,22 @@ function earned(options = {}) {
   return { kind: "earned", ...options };
 }
 function defineLeaderboard(input) {
-  const { ledger, group, score, ...properties } = input;
+  const { ledger, group, score, settle, ...properties } = input;
+  const pool = settle?.pool;
   const definition = leaderboardAuthoringSchema.parse({
     ...properties,
+    ...settle ? {
+      settle: {
+        ...settle,
+        prizes: settle.prizes ?? [],
+        ...pool ? {
+          pool: {
+            ...pool,
+            ...pool.ledger === void 0 ? {} : { ledger: ledgerKey(pool.ledger) }
+          }
+        } : {}
+      }
+    } : {},
     balance: ledgerKey(ledger),
     ...group ? { group: identifier.parse(group.key) } : {},
     score: score?.kind === "earned" ? { ...score, quests: score.quests?.map((quest) => quest.key) } : score
@@ -274,6 +300,28 @@ var telegram = {
     });
   }
 };
+var youtube = {
+  shorts() {
+    return customSource(youtubeShortsNamespace, {
+      identities: ["member"],
+      content: {
+        body: youtubeShortBodySchema,
+        metrics: youtubeShortMetrics
+      }
+    });
+  }
+};
+var tiktok = {
+  videos() {
+    return customSource(tiktokVideosNamespace, {
+      identities: ["member"],
+      content: {
+        body: tiktokVideoBodySchema,
+        metrics: tiktokVideoMetrics
+      }
+    });
+  }
+};
 var pointLedgers = () => ({
   provider: "domino",
   resource: "point-ledger"
@@ -355,6 +403,54 @@ var settings = {
       z.string().max(field.maxLength).default(field.default).meta(field)
     );
   },
+  /**
+   * A non-negative token amount in base units, as an integer string such as `"1000000"`: exact at
+   * any scale, so an 18-decimal threshold fits. A tracker filter may compare with it
+   * (`gte: { setting }`). With `decimals`, Console shows and edits it in whole tokens.
+   */
+  amount(options) {
+    if (!isAmount(options.default)) {
+      throw new Error(
+        `settings.amount() takes a base-unit integer string as its default, not "${options.default}"`
+      );
+    }
+    const field = {
+      ...options,
+      kind: "text",
+      minLength: 1,
+      maxLength: 100,
+      multiline: false,
+      picker: "amount"
+    };
+    return setting(
+      "text",
+      textSettingSchema(field).default(field.default).meta(field)
+    );
+  },
+  /**
+   * A chain `ctx.wallet.balance()` reads: `"solana"` (or Solana mainnet's CAIP-2 ID), or an EVM
+   * chain's CAIP-2 ID such as `"eip155:8453"`. Typed as the query's chain, so it passes to
+   * `ctx.wallet.balance({ chain })` as it is.
+   */
+  chain(options) {
+    if (!isBalanceChain(options.default)) {
+      throw new Error(
+        `settings.chain() takes "solana" or an EVM chain ID such as "eip155:8453" as its default, not "${options.default}"`
+      );
+    }
+    const field = {
+      ...options,
+      kind: "text",
+      minLength: 1,
+      maxLength: 64,
+      multiline: false,
+      picker: "chain"
+    };
+    return setting(
+      "text",
+      textSettingSchema(field).transform((value) => value).default(field.default).meta(field)
+    );
+  },
   integer(options) {
     return setting(
       "integer",
@@ -600,6 +696,7 @@ var evaluators = {
     };
   }
 };
+var completionPolicies = { once, keyed, streak, progress };
 function questBuilder(template) {
   return function defineQuest2(definition) {
     const key = authoringKey(definition);
@@ -612,7 +709,8 @@ function questBuilder(template) {
     ];
     const contentTrigger = definition.trigger.kind === "automatic" && definition.trigger.tracker?.content === true;
     const trackerTrigger2 = definition.trigger.kind === "automatic" && definition.trigger.tracker !== void 0;
-    const completion = definition.completion;
+    const declared = definition.completion;
+    const completion = typeof declared === "function" ? declared(completionPolicies) : declared;
     if (contentTrigger && completion !== void 0) {
       throw new Error(
         "A content quest completes once per content item: remove its completion"
@@ -632,7 +730,8 @@ function questBuilder(template) {
           metrics: definition.performance.metrics,
           maxAgeMs: definition.performance.maxAgeMs
         }) : void 0,
-        ...definition.retryCooldownMs === void 0 ? {} : { retryCooldownMs: definition.retryCooldownMs }
+        ...definition.retryCooldownMs === void 0 ? {} : { retryCooldownMs: definition.retryCooldownMs },
+        ...definition.completionCooldownMs === void 0 ? {} : { completionCooldownMs: definition.completionCooldownMs }
       },
       { template }
     );
@@ -641,10 +740,15 @@ function questBuilder(template) {
         "retryCooldownMs must be whole milliseconds from 1000 (one second) to 604800000 (seven days)"
       );
     }
+    if (definition.completionCooldownMs !== void 0 && !retryCooldownMsSchema.safeParse(definition.completionCooldownMs).success) {
+      throw new Error(
+        "completionCooldownMs must be whole milliseconds from 1000 (one second) to 604800000 (seven days)"
+      );
+    }
     if (definition.performance) {
-      const declared = triggerContentMetrics.get(definition.trigger) ?? [];
+      const declared2 = triggerContentMetrics.get(definition.trigger) ?? [];
       const unknown = definition.performance.metrics.filter(
-        (metric) => !declared.includes(metric)
+        (metric) => !declared2.includes(metric)
       );
       if (unknown.length) {
         throw new Error(
@@ -669,9 +773,9 @@ function questBuilder(template) {
     for (const setting2 of whereSettings(
       definition.trigger.kind === "automatic" ? definition.trigger.tracker?.where : void 0
     )) {
-      if (fields[setting2]?.kind !== "integer") {
+      if (!isBoundSetting(fields[setting2])) {
         throw new Error(
-          `The tracker filter compares with setting "${setting2}", which is not an integer setting`
+          `The tracker filter compares with setting "${setting2}", which is not an integer or amount setting`
         );
       }
     }
@@ -724,7 +828,8 @@ function questBuilder(template) {
         requires: definition.requires ?? [],
         ...definition.campaign ? { campaign: definition.campaign } : {},
         ...definition.availability ? { availability: definition.availability } : {},
-        ...definition.retryCooldownMs === void 0 ? {} : { retryCooldownMs: definition.retryCooldownMs }
+        ...definition.retryCooldownMs === void 0 ? {} : { retryCooldownMs: definition.retryCooldownMs },
+        ...definition.completionCooldownMs === void 0 ? {} : { completionCooldownMs: definition.completionCooldownMs }
       });
     }
     return resourceHandle("quest", {
@@ -809,12 +914,19 @@ function questBuilder(template) {
             requestedReview: true
           });
         }
+        if ((result.kind === "accept" || result.kind === "review") && result.completionKey !== void 0 && completion?.kind !== "keyed") {
+          ctx.diagnose?.({
+            code: "completion-key-ignored",
+            message: ignoredCompletionKey(completion, result.completionKey)
+          });
+        }
+        const keyContext = { ...ctx, settings: settings2, tracker: pinned };
         return decisionSchema.parse(
           result.kind === "accept" || result.kind === "review" ? {
             ...result,
             rewards: result.rewards ?? ctx.rewards,
             ...completion?.kind === "keyed" || completion?.kind === "progress" ? {
-              completionKey: completion.kind === "progress" ? completion.distinct({ ...ctx, tracker: pinned }) : result.completionKey ?? completion.key({ ...ctx, tracker: pinned })
+              completionKey: completion.kind === "progress" ? completion.distinct(keyContext) : result.completionKey ?? completion.key(keyContext)
             } : {}
           } : result
         );
@@ -822,6 +934,19 @@ function questBuilder(template) {
     });
   };
 }
+function ignoredCompletionKey(completion, key) {
+  const ignored = `ignores completionKey ${JSON.stringify(key)}`;
+  switch (completion?.kind) {
+    case void 0:
+      return `A content quest completes once per content item, under a key Relay sets, so it ${ignored}`;
+    case "once":
+      return `once() completes the quest once per member and ${ignored}: use keyed(...) to complete it once per key`;
+    case "streak":
+      return `streak(...) keys its own completions and ${ignored}`;
+    case "progress":
+      return `progress(...) keys each contribution with its distinct(...) and ${ignored}: derive the key in distinct(...)`;
+  }
+}
 var defineQuest = questBuilder(false);
 var defineQuestType = questBuilder(true);
 export {
@@ -842,6 +967,7 @@ export {
   decision,
   defineBadge,
   defineCampaign,
+  defineDashboard,
   defineEngagementReward,
   defineGroup,
   defineLeaderboard,
@@ -873,9 +999,11 @@ export {
   staffHandover,
   streak,
   telegram,
+  tiktok,
   trackerDataSchema,
   trackerTriggerContextSchema,
   untracked,
   x,
+  youtube,
   z2 as z
 };

package/dist/{automatic-outcomes-CVyZHxir.d.ts → automatic-outcomes-DxW_v5Wc.d.ts}

@@ -1,5 +1,5 @@
 import * as z from 'zod';
-import { a as AttemptStatus } from './schema-BJ9bOgpN.js';
+import { a as AttemptStatus } from './schema-C4m9RhCR.js';
 
 declare const collectionCodeSchema: z.ZodString;
 declare const collectionPassSchema: z.ZodObject<{
@@ -523,7 +523,10 @@ declare const automaticOutcomeSchema: z.ZodUnion<readonly [z.ZodObject<{
     updatedAt: z.ZodNumber;
 }, z.core.$strip>]>;
 type AutomaticOutcome = z.infer<typeof automaticOutcomeSchema>;
-/** Whether a linked attempt can be replaced after current admission rules pass. */
+/**
+ * Whether a linked attempt can be replaced after current admission rules pass: a rejection by
+ * budget exhaustion, or a failure because a project integration the quest needs was not ready.
+ */
 declare const isRetryableAutomaticOutcome: (outcome: Pick<z.input<typeof automaticOutcomeSchema>, "linkedAttempt">) => boolean;
 declare const automaticOutcomeQuerySchema: z.ZodObject<{
     quest: z.ZodOptional<z.ZodString>;

package/dist/avatar.d.ts

@@ -1,5 +1,5 @@
 import { L as LinkedWallet } from './wallet-Ac7OFpOr.js';
-import { P as ProfileAvatar } from './profiles-Cdv4BSd_.js';
+import { P as ProfileAvatar } from './profiles-BoOK03cR.js';
 import 'zod';
 
 /**

package/dist/browser.d.ts

@@ -1,15 +1,15 @@
-import { o as SubmissionStore, f as RelayClientOptions, R as RelayClient } from './client-CzNtl8UO.js';
-export { C as CosmosChains, D as DiscoveredWallet, E as Eip1193Provider, a as EmailSignInOption, K as KeplrLike, O as OAuthSignInOption, S as SignInClient, b as SignInIcon, c as SignInMethods, d as SignInOption, e as SignInOptions, f as SignInUnavailable, g as SignInWallet, h as SolanaInjectedProvider, i as StandardWallet, j as StandardWalletAccount, T as TelegramSignInOption, W as WalletSignInOption, k as cosmosChainList, l as cosmosSigner, m as discoverCosmosWallets, n as discoverEvmWallets, o as discoverSignInWallets, p as discoverSolanaWallets, q as evmSigner, s as signInOptions, r as solanaSigner, t as telegramMiniAppInitData, w as walletStandardSolanaSigner } from './telegram-browser-C36j_6v-.js';
+import { o as SubmissionStore, f as RelayClientOptions, R as RelayClient } from './client-bX3oTpRu.js';
+export { C as CosmosChains, D as DiscoveredWallet, E as Eip1193Provider, a as EmailSignInOption, K as KeplrLike, O as OAuthSignInOption, S as SignInClient, b as SignInIcon, c as SignInMethods, d as SignInOption, e as SignInOptions, f as SignInUnavailable, g as SignInWallet, h as SolanaInjectedProvider, i as StandardWallet, j as StandardWalletAccount, T as TelegramSignInOption, W as WalletSignInOption, k as cosmosChainList, l as cosmosSigner, m as discoverCosmosWallets, n as discoverEvmWallets, o as discoverSignInWallets, p as discoverSolanaWallets, q as evmSigner, s as signInOptions, r as solanaSigner, t as telegramMiniAppInitData, w as walletStandardSolanaSigner } from './telegram-browser-Bh3i0HiH.js';
 export { H as HostEnvironment, g as getHostEnvironment } from './host-environment-FN4zg3hw.js';
-import './groups-B5R1RCsl.js';
+import './schema-C4m9RhCR.js';
 import 'zod';
-import './schema-BJ9bOgpN.js';
-import './pages-BTlOg8sl.js';
-import './submission-input-BNah53go.js';
+import './pages-BlLqB8ZQ.js';
+import './submission-input-wTiYGdgA.js';
+import './groups-DPE004_V.js';
 import './action-DBzILFx9.js';
 import './participant-activity-iciCEs_8.js';
 import './accounts-DRPENuZe.js';
-import './profiles-Cdv4BSd_.js';
+import './profiles-BoOK03cR.js';
 import './wallet-Ac7OFpOr.js';
 
 /** Browser client with durable submission recovery; safe to construct during SSR. */

package/dist/browser.js

@@ -12,19 +12,19 @@ import {
   solanaSigner,
   telegramMiniAppInitData,
   walletStandardSolanaSigner
-} from "./chunk-QIDQWXSF.js";
-import "./chunk-JL7J3EQQ.js";
-import "./chunk-YVC3B72P.js";
-import "./chunk-ZJ3FVZRP.js";
-import "./chunk-CCE2JWES.js";
-import "./chunk-2NUD237O.js";
+} from "./chunk-OTITLABX.js";
+import "./chunk-NK6EER33.js";
+import "./chunk-INSWI2VZ.js";
+import "./chunk-RBPMT53S.js";
+import "./chunk-BJYMTCWG.js";
+import "./chunk-VSHV7FEA.js";
 import {
   getHostEnvironment
 } from "./chunk-KDR2VAJP.js";
-import "./chunk-XFAYQFRO.js";
-import "./chunk-RP4LLEON.js";
-import "./chunk-53JMTUWG.js";
-import "./chunk-IELNFM3V.js";
+import "./chunk-KBVH4XZC.js";
+import "./chunk-ABJ4G47X.js";
+import "./chunk-QNQNKIAA.js";
+import "./chunk-BHHUSBSD.js";
 export {
   browserSubmissionStore,
   cosmosChainList,

package/dist/{capability-error-FQGGb5xS.d.ts → capability-error-DSd8EMQC.d.ts}

@@ -1,5 +1,71 @@
 import * as z from 'zod';
 
+declare const completionPolicySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"streak">;
+    days: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"progress">;
+    goal: z.ZodObject<{
+        kind: z.ZodLiteral<"count">;
+        count: z.ZodNumber;
+    }, z.core.$strict>;
+    window: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"lifetime">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"calendar">;
+        period: z.ZodEnum<{
+            day: "day";
+            week: "week";
+            month: "month";
+        }>;
+        latenessMs: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"rolling">;
+        durationMs: z.ZodNumber;
+    }, z.core.$strict>], "kind">;
+    repeat: z.ZodDefault<z.ZodEnum<{
+        repeat: "repeat";
+        once: "once";
+    }>>;
+}, z.core.$strict>, 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>;
+/**
+ * One of the member's accepted, unrevoked quest completions, as `ctx.member.completions()` reads
+ * it. `quest` is the quest's key and `key` the completion key. `completedAt` is when it was
+ * recorded, in epoch milliseconds on the member's clock (a test member's advanced one); null for
+ * older completions recorded without a time.
+ */
+declare const memberCompletionSchema: z.ZodObject<{
+    quest: z.ZodString;
+    key: z.ZodString;
+    completedAt: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+type MemberCompletion = z.infer<typeof memberCompletionSchema>;
+/** The most completions one `ctx.member.completions()` call returns, and its default `limit`. */
+declare const maxMemberCompletions = 100;
+
 /**
  * Why an evaluator capability could not answer:
  *
@@ -12,7 +78,15 @@ import * as z from 'zod';
  *   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.
+ * Later versions can add codes. Relay also sends codes this tuple does not list, as SDK 1.x keeps
+ * it fixed:
+ *
+ * - `integration-required`: the project's integration needs configuration before the call can
+ *   answer.
+ * - `capability-limit`: the evaluation run already made its eight capability calls, which all
+ *   capabilities share. Never retryable: the run makes the same calls again.
+ *
+ * Treat an unknown code as a failure its `message` explains.
  */
 declare const capabilityErrorCodes: readonly ["not-linked", "provider-unavailable", "author-error"];
 /** @compat open */
@@ -68,4 +142,4 @@ declare class CapabilityError extends Error {
     static from(failure: CapabilityFailure): CapabilityError;
 }
 
-export { CapabilityError as C, type KnownCapabilityErrorCode as K, type CapabilityErrorCode as a, type CapabilityFailure as b, capabilityErrorCodes as c, capabilityFailureSchema as d };
+export { type Budget as B, CapabilityError as C, type KnownCapabilityErrorCode as K, type MemberCompletion as M, type CapabilityErrorCode as a, type CapabilityFailure as b, capabilityErrorCodes as c, budgetSchema as d, capabilityFailureSchema as e, completionKeySchema as f, completionPolicySchema as g, memberCompletionSchema as h, maxMemberCompletions as m };

package/dist/{chunk-RP4LLEON.js → chunk-ABJ4G47X.js}

@@ -1,6 +1,6 @@
 // package.json
 var name = "@domino-sdk/relay";
-var version = "1.54.0";
+var version = "1.56.0";
 
 // src/client-identity.ts
 function clientIdentity() {