@domino-sdk/relay 1.60.0 → 1.62.0

package/dist/authoring.d.ts

@@ -1,25 +1,19 @@
-import { B as xContentBodySchema, I as IdentityKind, C as customSourceSchema, W as WithRecordData, D as WithContent, F as WithAccountRoles, y as ResourceHandle, x as QuestHandle, L as LedgerReference, G as GroupHandle, H as pointLedgerDeclarationSchema, J as TrackerSource, N as trackerDefinitionSchema, U as Tracker, V as TrackerData, X as SourceRoles, Y as LedgerHandle, Z as TrackerDataSchema, _ as xSearchSourceSchema, $ as XTweet, a0 as XContentMetric, a1 as TrackerTriggerPolicy, a2 as Where, a3 as MemberIdentity, P as PointBalance, a4 as ReferralHandle, a5 as TrackerTriggerContext, a6 as TrackerReader, a7 as TextReviewInput, a8 as TextResult, z as PhotoResult, a9 as Decision, aa as rewardSchema, ab as TrackerTriggerMode, ac as RoleOf, ad as WhereSetting, ae as ContentBody, af as BadgeHandle, ag as ContentMetricName, ah as triggerSchema, k as QuestPresentation, l as QuestProfile, m as QuizEvidence, ai as TieredRewardDefinition } from './schema-CwbRkmlr.js';
-export { aj as LedgerSetting, ak as TrackerPage, al as TrackerReadQuery, am as trackerDataSchema, an as trackerTriggerContextSchema } from './schema-CwbRkmlr.js';
-import { M as MemberCompletion, B as Budget, A as AuthorBudget } from './capability-error-DufwG3G0.js';
-export { C as CapabilityError, a as CapabilityErrorCode, c as capabilityErrorCodes } from './capability-error-DufwG3G0.js';
-import { N as NftCollection, o as ContractCall, p as ContractEvent, S as SolanaProgram, q as WalletBalanceSourceQuery, r as WalletTransaction, s as WalletInstruction, e as ProfileReferral, t as WalletReader } from './wallet-DZWL7lJH.js';
-export { u as ContractCallParts, v as ContractCallReturnType, w as ContractEventInput, x as ContractEventParts, y as ContractFunction, z as CosmosDenom, a as CosmosNetwork, E as EvmChainId, B as NftCollectionParts, D as NftStandard, F as WalletBalance, G as WalletBalanceChange, H as WalletBalanceQuery, I as WalletBalanceSample, J as WalletCall, K as WalletCallArgument, M as WalletCallQuery, Q as WalletDelegations, R as WalletDelegationsQuery, T as WalletEventCondition, U as WalletEventValue, V as WalletEvents, X as WalletEventsQuery, Y as WalletNfts, Z as WalletNftsQuery, _ as WalletTransactions, $ as WalletTransactionsQuery, a0 as cosmosDenomSchema, a1 as cosmosNetworkSchema, a2 as isContractCall, a3 as isContractEvent, a4 as isEvmChainId, a5 as isNftCollection, a6 as isSolanaProgram, a7 as maxWalletEventLogs, a8 as maxWalletEventLookback, a9 as maxWalletTransactionLookback, aa as maxWalletTransactions, ab as parseContractCall, ac as parseContractEvent, ad as parseContractFunction, ae as parseNftCollection } from './wallet-DZWL7lJH.js';
+import { _ as EngagementBudget, $ as leaderboardDefinitionSchema, Z as AuthoringIdentity, a0 as pointLedgerDeclarationSchema, a1 as referralAuthoringSchema, a2 as discordMessagesSourceSchema, a3 as DiscordMessageData, a4 as DiscordMessageTextData, a5 as discordReactionsSourceSchema, a6 as DiscordReactionData, a7 as KnownIntegrationModule, P as PointBalance, C as CampaignDefinition, a8 as TextReviewInput, a9 as TextResult, aa as PhotoResult, ab as DiscordReader, ac as Decision, ad as rewardSchema, ae as triggerSchema, af as IntegrationModule, D as QuestPresentation, d as AvailabilityWindow, F as QuestProfile, G as QuizEvidence, W as IntegrationModuleProvider, ag as TieredRewardDefinition } from './accounts-CCqCKCVx.js';
+export { ah as KnownIntegrationModuleProvider, ai as defineCampaign, aj as defineGroup } from './accounts-CCqCKCVx.js';
+import { x as xContentBodySchema, I as IdentityKind, g as customSourceSchema, W as WithRecordData, h as WithContent, i as WithAccountRoles, R as ResourceHandle, Q as QuestHandle, L as LedgerReference, G as GroupHandle, j as TrackerSource, k as trackerDefinitionSchema, l as Tracker, m as TrackerData, S as SourceRoles, n as LedgerHandle, f as TrackerDataSchema, o as xSearchSourceSchema, X as XTweet, p as XContentMetric, q as TrackerTriggerPolicy, r as Where, M as MemberIdentity, u as ReferralHandle, v as TrackerTriggerContext, y as TrackerReader, z as TrackerTriggerMode, A as RoleOf, B as WhereSetting, C as ContentBody, D as BadgeHandle, E as ContentMetricName } from './tracker-data-Hb1uQnk5.js';
+export { F as LedgerSetting, H as TrackerPage, J as TrackerReadQuery, N as trackerDataSchema, P as trackerTriggerContextSchema } from './tracker-data-Hb1uQnk5.js';
+import { R as ResourceSource, S as Setting, A as AmountSetting, B as BalanceChain, M as MemberCompletion, a as Budget, b as AuthorBudget, c as BoundSettings, d as Announcement } from './capability-error-DFMwSuSf.js';
+export { C as CapabilityError, e as CapabilityErrorCode, D as DashboardInput, f as DashboardPanelInput, T as TikTokVideoBody, g as TikTokVideoMetric, Y as YouTubeShortBody, h as YouTubeShortMetric, i as capabilityErrorCodes, j as defineDashboard } from './capability-error-DFMwSuSf.js';
+import { N as NftCollection, o as ContractCall, p as ContractEvent, q as SolanaProgram, r as WalletBalanceSourceQuery, s as WalletTransaction, t as WalletInstruction, e as ProfileReferral, u as WalletReader } from './wallet-DTO7SXj7.js';
+export { v as ContractCallParts, w as ContractCallReturnType, x as ContractEventInput, y as ContractEventParts, z as ContractFunction, B as CosmosDenom, a as CosmosNetwork, E as EvmChainId, D as NftCollectionParts, F as NftStandard, G as WalletBalance, H as WalletBalanceChange, I as WalletBalanceQuery, J as WalletBalanceSample, K as WalletCall, M as WalletCallArgument, Q as WalletCallQuery, R as WalletDelegations, T as WalletDelegationsQuery, U as WalletEventCondition, V as WalletEventValue, X as WalletEvents, Y as WalletEventsQuery, Z as WalletNfts, _ as WalletNftsQuery, $ as WalletTransactions, a0 as WalletTransactionsQuery, a1 as cosmosDenomSchema, a2 as cosmosNetworkSchema, a3 as isContractCall, a4 as isContractEvent, a5 as isEvmChainId, a6 as isNftCollection, a7 as isSolanaProgram, a8 as maxWalletEventLogs, a9 as maxWalletEventLookback, aa as maxWalletTransactionLookback, ab as maxWalletTransactions, ac as parseContractCall, ad as parseContractEvent, ae as parseContractFunction, af as parseNftCollection } from './wallet-DTO7SXj7.js';
 import * as z from 'zod';
 export { z } from 'zod';
-import { f as badgeDeclarationSchema, B as Badge } from './offers-CqXfMIxq.js';
-export { g as defineOffer } from './offers-CqXfMIxq.js';
-import { E as EngagementBudget, m as leaderboardDefinitionSchema, l as AuthoringIdentity, r as referralAuthoringSchema, C as CampaignDefinition, A as AvailabilityWindow } from './groups-9Jm3peq3.js';
-export { n as defineCampaign, o as defineGroup } from './groups-9Jm3peq3.js';
-import { d as discordMessagesSourceSchema, D as DiscordMessageData, c as DiscordMessageTextData, e as discordReactionsSourceSchema, f as DiscordReactionData, g as TelegramReader, h as DiscordReader } from './accounts-DoabriBX.js';
-export { i as TelegramChatMember, j as TelegramChatMemberStatus, k as TelegramMessageData, l as TelegramReactionData } from './accounts-DoabriBX.js';
+import { g as badgeDeclarationSchema, h as OfferAuthoring, B as Badge } from './offers-DhAtss4_.js';
 import { a as StreakPolicy, Q as QuizContent } from './streaks-0YuipsUQ.js';
-import { R as ResourceSource, S as Setting, A as AmountSetting, B as BalanceChain, I as IntegrationModule, a as BoundSettings, b as Announcement } from './integrations-CmIkP1Gi.js';
-export { D as DashboardInput, c as DashboardPanelInput, T as TikTokVideoBody, d as TikTokVideoMetric, Y as YouTubeShortBody, e as YouTubeShortMetric, f as defineDashboard } from './integrations-CmIkP1Gi.js';
-import { P as Prerequisite, T as TextEvidence, U as UrlEvidence, a as TextOptions, b as UrlOptions } from './submission-input-D9EGH_yb.js';
-export { c as balanceAtLeast, d as completed, i as inGroup } from './submission-input-D9EGH_yb.js';
-import { I as ImageReader, X as XReader } from './x-KFJD2x8y.js';
+import { e as TelegramReader, P as Prerequisite, b as TextEvidence, U as UrlEvidence, c as TextOptions, d as UrlOptions } from './submission-input-DHGKhXfp.js';
+export { f as TelegramChatMember, g as TelegramChatMemberStatus, h as TelegramConnection, i as TelegramMessageData, j as TelegramReactionData, k as balanceAtLeast, l as completed, m as inGroup } from './submission-input-DHGKhXfp.js';
+import { I as ImageReader, X as XReader } from './analytics-BwAKLi7O.js';
 export { f as formatUnits, p as parseUnits } from './units-CwgsPB_r.js';
-import './analytics-URV-mxjH.js';
 
 declare function defineBadge(input: z.input<typeof badgeDeclarationSchema>): {
     name: string;
@@ -110,6 +104,64 @@ declare const questCompleted: (quest: QuestHandle) => {
     kind: "quest";
     quest: QuestHandle;
 };
+/**
+ * Define one points-priced offer for a tier reward. The reward title is used when no title is set.
+ * Badge and group rewards throw: only quests grant them.
+ */
+declare function defineOffer(input: OfferAuthoring & AuthoringIdentity): {
+    title: string;
+    enabled: boolean;
+    limit: {
+        perMember: number;
+    };
+    reward: {
+        kind: "tier";
+        reward: {
+            id: string;
+            title: string;
+            tiers: {
+                id: string;
+                title: string;
+            }[];
+            inventory: {
+                kind: "untracked";
+            };
+            fulfillment: {
+                kind: "staff-handover";
+            } | {
+                kind: "automatic";
+            };
+            badge?: string | undefined;
+            group?: string | undefined;
+        };
+        tier: string;
+    };
+    price: {
+        kind: "points";
+        balance: string;
+        amount: number;
+    };
+    stock: number;
+    key: string;
+    requires?: ({
+        kind: "completion";
+        quest: string;
+        scope: "ever";
+    } | {
+        kind: "completion";
+        quest: string;
+        scope: "period";
+        period: "day" | "week" | "month";
+    } | {
+        kind: "balance";
+        balance: string;
+        minimum: number;
+    } | {
+        kind: "group";
+        group: string;
+        title: string;
+    })[] | undefined;
+} & ResourceHandle<"offer">;
 type ReferralInput = z.input<typeof referralAuthoringSchema>;
 type ReferralBonus = NonNullable<ReferralInput["bonuses"]>[number];
 type ReferralMilestone = NonNullable<ReferralInput["milestones"]>[number];
@@ -312,6 +364,7 @@ declare function defineLeaderboard(input: Omit<LeaderboardInput, "key" | "id" |
         };
     };
     key: string;
+    ties?: "shared" | "earliest" | undefined;
     includeUnscored?: boolean | undefined;
     settle?: {
         at: "window-end";
@@ -840,6 +893,10 @@ declare function invoked(tx: WalletTransaction, program: string): boolean;
  */
 declare function instruction(tx: WalletTransaction, name: string): WalletInstruction["args"] | null;
 
+/**
+ * A reward that awards the member this badge. Quests grant it, and operators by hand; offers,
+ * leaderboard prizes and referral programs throw when given one.
+ */
 declare const badge: (definition: BadgeHandle & Pick<Badge, "name">) => {
     reward: {
         badge: string;
@@ -866,7 +923,8 @@ declare const badge: (definition: BadgeHandle & Pick<Badge, "name">) => {
  * A reward that adds the member to a group when the completion's rewards are delivered. Publishing
  * the quest creates the group, with no members, where it is missing; an archived group refuses.
  * Revoking the completion removes the membership unless an operator's add or another unrevoked
- * completion also backs it.
+ * completion also backs it. Only quests grant it; offers, leaderboard prizes and referral programs
+ * throw when given one.
  */
 declare const groupMembership: (group: GroupHandle) => {
     reward: {
@@ -982,10 +1040,11 @@ type TrackerTriggerInput<T extends Tracker = Tracker, W extends Where<TrackerDat
      */
     where?: W;
     /**
-     * The record account whose member the quest pays: `"author"` (the default), `"inReplyTo"` on
-     * an X tracker, `"messageAuthor"` on a Discord reactions tracker, or a named account a custom
-     * source declares in `accounts`. Skipped when that account is the record's author account or
-     * belongs to the author's member, such as a reaction to one's own message.
+     * The record account whose member the quest pays: `"author"` (the default), `"inReplyTo"`,
+     * `"quoted"` or `"reposted"` on an X tracker, `"messageAuthor"` on a Discord reactions tracker,
+     * or a named account a custom source declares in `accounts`. Skipped when that account is the
+     * record's author account or belongs to the author's member, such as a reaction to one's own
+     * message.
      */
     beneficiary?: RoleOf<T>;
     /**
@@ -1126,7 +1185,18 @@ declare const budget: {
     (definition: BudgetDefinition<Budget>): Budget;
     (definition: BudgetDefinition<AuthorBudget>): AuthorBudget;
 };
-declare const keyed: (key: (ctx: KeyedContext) => string) => {
+/** Options of a `keyed(...)` completion. */
+type KeyedOptions = {
+    /**
+     * `"members"`: each key completes the quest once in the whole project and environment, for
+     * whichever member uses it first, such as a single-use code or a post that pays once. Another
+     * member's attempt with a used key is rejected with `key-used`. Without it, each member
+     * completes the quest once per key.
+     */
+    across?: "members";
+};
+declare const keyed: (key: (ctx: KeyedContext) => string, options?: KeyedOptions) => {
+    across?: "members" | undefined;
     kind: "keyed";
     key: (ctx: KeyedContext) => string;
 };
@@ -1358,13 +1428,19 @@ type EvaluationCalendar = {
  * the trigger that supplies them and null otherwise. `G` defaults to `any`, which
  * leaves them nullable and lets a shared evaluator, such as `evaluators.photo()`, fit every quest.
  */
-type IntegrationReaders<D extends readonly IntegrationModule[]> = Pick<{
+/**
+ * The declared modules this SDK has readers for. A module it does not know types no reader; an
+ * array typed `IntegrationModule[]`, whose providers are not literals, types every known reader,
+ * as before modules opened.
+ */
+type KnownModules<D extends readonly IntegrationModule[]> = readonly (D[number] extends infer Module extends IntegrationModule ? Module extends KnownIntegrationModule ? Module : string extends Module["provider"] ? KnownIntegrationModule : never : never)[];
+type IntegrationReaders<D extends readonly KnownIntegrationModule[]> = Pick<{
     x: XReader;
     discord: DiscordReader;
 }, D[number]["provider"]>;
 type EvaluationContext<T, I = {
     photo: string;
-}, G = any, D extends readonly IntegrationModule[] = readonly IntegrationModule[]> = {
+}, G = any, D extends readonly KnownIntegrationModule[] = readonly KnownIntegrationModule[]> = {
     settings: T;
     member: EvaluationMember;
     input: I;
@@ -1404,15 +1480,15 @@ type EvaluationContext<T, I = {
     };
     wallet: WalletReader;
     /**
-     * Telegram membership in the chats the project connected. It needs no `integrations` entry;
-     * Relay provides it to every quest from SDK 1.23.0 on, and it is absent from older runtimes and
-     * test contexts that do not supply it.
+     * The member's linked Telegram account and their membership in the chats the project connected.
+     * It needs no `integrations` entry; Relay provides it to every quest from SDK 1.23.0 on, and it
+     * is absent from older runtimes and test contexts that do not supply it.
      */
     telegram?: TelegramReader;
 } & IntegrationReaders<D>;
 type Evaluator<T, I = {
     photo: string;
-}, G = any, D extends readonly IntegrationModule[] = readonly []> = (ctx: EvaluationContext<T, I, G, D>) => Promise<Outcome>;
+}, G = any, D extends readonly KnownIntegrationModule[] = readonly []> = (ctx: EvaluationContext<T, I, G, D>) => Promise<Outcome>;
 declare const evaluators: {
     quiz(answerKey: QuizEvidence["answers"], options?: {
         minimumCorrect?: number;
@@ -1449,7 +1525,7 @@ type CompletionPolicy = ReturnType<typeof once> | ReturnType<typeof keyed> | Str
 /** The completion builders, with key callbacks reading quest `G`'s typed context. */
 type CompletionPolicies<S, G> = {
     once: typeof once;
-    keyed: (key: (ctx: QuestKeyedContext<S, G>) => string) => ReturnType<typeof keyed>;
+    keyed: (key: (ctx: QuestKeyedContext<S, G>) => string, options?: KeyedOptions) => ReturnType<typeof keyed>;
     streak: typeof streak;
     progress: (definition: ProgressDefinition<QuestKeyedContext<S, G>>) => ReturnType<typeof progress>;
 };
@@ -1498,6 +1574,10 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
         settings: z.core.$InferObjectOutput<T, {}>;
     }) => QuestPresentation) | undefined;
     trigger: G & NoInfer<IntegerSettingBounds<G, T>>;
+    /**
+     * The modules the quest uses: `discord` and `x` from this module enable their readers. A
+     * module this SDK does not know, `{ provider }`, builds but types no reader.
+     */
     integrations?: D | undefined;
     requires?: readonly Prerequisite[];
     campaign?: CampaignDefinition;
@@ -1587,7 +1667,7 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
     })[] | ((ctx: {
         settings: z.core.$InferObjectOutput<T, {}>;
     }) => Announcement[]) | undefined;
-    evaluate?: Evaluator<z.core.$InferObjectOutput<T, {}>, QuestInput<G>, NoInfer<G>, NoInfer<D>> | undefined;
+    evaluate?: Evaluator<z.core.$InferObjectOutput<T, {}>, QuestInput<G>, NoInfer<G>, NoInfer<KnownModules<D>>> | undefined;
     /**
      * A content quest's performance stage: once content evaluation accepts an item, each later
      * complete and fresh sample of `metrics` (a subset of the tracker's declared metrics) gates the
@@ -1866,6 +1946,7 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
             kind: "once";
         } | {
             kind: "keyed";
+            across?: "members" | undefined;
         };
         visibility: "visible" | "hidden";
         profile: {
@@ -1880,6 +1961,7 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
                 balance: string;
             };
         }[];
+        integrationModules?: IntegrationModuleProvider[] | undefined;
         announcements?: ({
             action: "post-message";
             text: string;
@@ -1962,12 +2044,12 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
         };
         wallet: WalletReader;
         /**
-         * Telegram membership in the chats the project connected. It needs no `integrations` entry;
-         * Relay provides it to every quest from SDK 1.23.0 on, and it is absent from older runtimes and
-         * test contexts that do not supply it.
+         * The member's linked Telegram account and their membership in the chats the project connected.
+         * It needs no `integrations` entry; Relay provides it to every quest from SDK 1.23.0 on, and it
+         * is absent from older runtimes and test contexts that do not supply it.
          */
         telegram?: TelegramReader;
-    } & IntegrationReaders<readonly IntegrationModule[]> & {
+    } & IntegrationReaders<readonly KnownIntegrationModule[]> & {
         rewards: Reward[];
         humanReview: boolean;
         performance?: unknown;
@@ -1992,6 +2074,10 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
         settings: z.core.$InferObjectOutput<T, {}>;
     }) => QuestPresentation) | undefined;
     trigger: G & NoInfer<IntegerSettingBounds<G, T>>;
+    /**
+     * The modules the quest uses: `discord` and `x` from this module enable their readers. A
+     * module this SDK does not know, `{ provider }`, builds but types no reader.
+     */
     integrations?: D | undefined;
     requires?: readonly Prerequisite[];
     campaign?: CampaignDefinition;
@@ -2081,7 +2167,7 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
     })[] | ((ctx: {
         settings: z.core.$InferObjectOutput<T, {}>;
     }) => Announcement[]) | undefined;
-    evaluate?: Evaluator<z.core.$InferObjectOutput<T, {}>, QuestInput<G>, NoInfer<G>, NoInfer<D>> | undefined;
+    evaluate?: Evaluator<z.core.$InferObjectOutput<T, {}>, QuestInput<G>, NoInfer<G>, NoInfer<KnownModules<D>>> | undefined;
     /**
      * A content quest's performance stage: once content evaluation accepts an item, each later
      * complete and fresh sample of `metrics` (a subset of the tracker's declared metrics) gates the
@@ -2360,6 +2446,7 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
             kind: "once";
         } | {
             kind: "keyed";
+            across?: "members" | undefined;
         };
         visibility: "visible" | "hidden";
         profile: {
@@ -2374,6 +2461,7 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
                 balance: string;
             };
         }[];
+        integrationModules?: IntegrationModuleProvider[] | undefined;
         announcements?: ({
             action: "post-message";
             text: string;
@@ -2456,12 +2544,12 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
         };
         wallet: WalletReader;
         /**
-         * Telegram membership in the chats the project connected. It needs no `integrations` entry;
-         * Relay provides it to every quest from SDK 1.23.0 on, and it is absent from older runtimes and
-         * test contexts that do not supply it.
+         * The member's linked Telegram account and their membership in the chats the project connected.
+         * It needs no `integrations` entry; Relay provides it to every quest from SDK 1.23.0 on, and it
+         * is absent from older runtimes and test contexts that do not supply it.
          */
         telegram?: TelegramReader;
-    } & IntegrationReaders<readonly IntegrationModule[]> & {
+    } & IntegrationReaders<readonly KnownIntegrationModule[]> & {
         rewards: Reward[];
         humanReview: boolean;
         performance?: unknown;
@@ -2476,4 +2564,4 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
     }): Promise<Decision>;
 } & ResourceHandle<"quest">;
 
-export { AmountSetting, BalanceChain, ContentBody, type ContentData, ContentMetricName, type ContentTrigger, type ContentTriggerInput, ContractCall, ContractEvent, DiscordMessageData, DiscordMessageTextData, DiscordReactionData, DiscordReader, type EvaluationCalendar, type EvaluationCalendarDay, type EvaluationContext, type EvaluationMember, GroupHandle, IdentityKind, ImageReader, IntegrationModule, type KeyedContext, LedgerHandle, LedgerReference, MemberCompletion, type MemberCompletionQuery, MemberIdentity, NftCollection, type Outcome, type PerformanceContext, type PerformanceOutcome, PointBalance, ProfileReferral, QuestHandle, type QuestKeyedContext, ReferralHandle, RoleOf, Setting, SolanaProgram, TelegramReader, Tracker, TrackerData, TrackerDataSchema, TrackerReader, type TrackerTrigger, TrackerTriggerContext, type TrackerTriggerInput, type TriggerAdmission, WalletBalanceSourceQuery, WalletInstruction, WalletReader, WalletTransaction, Where, type XContentBody, XReader, automatic, automaticFulfillment, badge, budget, calendar, content, count, customSource, decision, defineBadge, defineEngagementReward, defineLeaderboard, defineLedger, defineQuest, defineQuestType, defineReferral, defineTieredReward, defineTracker, discord, earned, evaluators, evidence, groupMembership, instruction, invoked, keyed, manual, once, pointLedgers, points, progress, questCompleted, received, rolling, settings, spent, staffHandover, streak, swapped, telegram, tiktok, untracked, wallet, x, youtube };
+export { AmountSetting, BalanceChain, ContentBody, type ContentData, ContentMetricName, type ContentTrigger, type ContentTriggerInput, ContractCall, ContractEvent, DiscordMessageData, DiscordMessageTextData, DiscordReactionData, DiscordReader, type EvaluationCalendar, type EvaluationCalendarDay, type EvaluationContext, type EvaluationMember, GroupHandle, IdentityKind, ImageReader, IntegrationModule, IntegrationModuleProvider, type KeyedContext, type KeyedOptions, KnownIntegrationModule, LedgerHandle, LedgerReference, MemberCompletion, type MemberCompletionQuery, MemberIdentity, NftCollection, type Outcome, type PerformanceContext, type PerformanceOutcome, PointBalance, ProfileReferral, QuestHandle, type QuestKeyedContext, ReferralHandle, RoleOf, Setting, SolanaProgram, TelegramReader, Tracker, TrackerData, TrackerDataSchema, TrackerReader, type TrackerTrigger, TrackerTriggerContext, type TrackerTriggerInput, type TriggerAdmission, WalletBalanceSourceQuery, WalletInstruction, WalletReader, WalletTransaction, Where, type XContentBody, XReader, automatic, automaticFulfillment, badge, budget, calendar, content, count, customSource, decision, defineBadge, defineEngagementReward, defineLeaderboard, defineLedger, defineOffer, defineQuest, defineQuestType, defineReferral, defineTieredReward, defineTracker, discord, earned, evaluators, evidence, groupMembership, instruction, invoked, keyed, manual, once, pointLedgers, points, progress, questCompleted, received, rolling, settings, spent, staffHandover, streak, swapped, telegram, tiktok, untracked, wallet, x, youtube };

package/dist/authoring.js

@@ -8,7 +8,7 @@ import {
   tiktokVideoMetrics,
   youtubeShortBodySchema,
   youtubeShortMetrics
-} from "./chunk-N3LJ6GFK.js";
+} from "./chunk-3KLC4AMA.js";
 import {
   CapabilityError,
   capabilityErrorCodes
@@ -17,19 +17,20 @@ import {
   sourceDataSchema,
   sourceRoles,
   validateQuestShape
-} from "./chunk-VWMIA2TT.js";
+} from "./chunk-5TEYFX6X.js";
 import {
-  badgeDeclarationSchema,
-  defineOffer,
   engagementDefinitionSchema,
   engagementScoreInputSchema,
   engagementScoreSchema,
-  leaderboardAuthoringSchema,
+  offerAuthoringSchema,
+  parseDefinition,
   referralAuthoringSchema
-} from "./chunk-MJEJQH5A.js";
+} from "./chunk-GTDW453U.js";
 import {
+  badgeDeclarationSchema,
+  leaderboardAuthoringSchema,
   pointLedgerDeclarationSchema
-} from "./chunk-YNW2ZUUP.js";
+} from "./chunk-WSBYWVTZ.js";
 import {
   announcementSchema,
   authorBudgetSchema,
@@ -60,6 +61,7 @@ import {
   groupReward,
   identifier,
   inGroup,
+  integrationModuleProviderSchema,
   isAmount,
   isBalanceChain,
   isBoundSetting,
@@ -120,15 +122,44 @@ import {
   whereSettings,
   xSearchSourceSchema,
   youtubeShortsNamespace
-} from "./chunk-GBSDAD3N.js";
+} from "./chunk-MK425RXJ.js";
+import "./chunk-K2KS3JLY.js";
 
 // src/builders.ts
 import * as z from "zod";
+
+// src/quest-only-rewards.ts
+function questOnlyRewardError(reward, surface) {
+  const definition = typeof reward === "object" && reward !== null && "kind" in reward && reward.kind === "tier" && "reward" in reward && typeof reward.reward === "object" && reward.reward !== null ? reward.reward : null;
+  if (definition && "badge" in definition && definition.badge !== void 0) {
+    return `Badge rewards can only be granted by quests or manually, not by ${surface}`;
+  }
+  if (definition && "group" in definition && definition.group !== void 0) {
+    return `Group membership rewards can only be granted by quests, not by ${surface}`;
+  }
+  return null;
+}
+function refuseQuestOnlyRewards(context, rewards, path, surface) {
+  for (const [index, reward] of rewards.entries()) {
+    const message = questOnlyRewardError(reward, surface);
+    if (message) {
+      context.addIssue({ code: "custom", message, path: [...path, index] });
+    }
+  }
+}
+
+// src/builders.ts
 function defineBadge(input) {
-  return resourceHandle("badge", badgeDeclarationSchema.parse(input));
+  return resourceHandle(
+    "badge",
+    parseDefinition("Badge", badgeDeclarationSchema, input)
+  );
 }
 function defineLedger(input) {
-  return resourceHandle("ledger", pointLedgerDeclarationSchema.parse(input));
+  return resourceHandle(
+    "ledger",
+    parseDefinition("Point ledger", pointLedgerDeclarationSchema, input)
+  );
 }
 function defineEngagementReward(input) {
   const { target, ledger, ...config } = input;
@@ -168,9 +199,43 @@ var questCompleted = (quest) => ({
   kind: "quest",
   quest
 });
+var offerBuilderSchema = offerAuthoringSchema.superRefine(
+  (offer, context) => {
+    const message = questOnlyRewardError(offer.reward, "offers");
+    if (message) {
+      context.addIssue({ code: "custom", message, path: ["reward"] });
+    }
+  }
+);
+function defineOffer(input) {
+  return resourceHandle(
+    "offer",
+    parseDefinition("Offer", offerBuilderSchema, input)
+  );
+}
+var referralBuilderSchema = referralAuthoringSchema.superRefine(
+  (referral, context) => {
+    for (const side of ["inviter", "invitee"]) {
+      refuseQuestOnlyRewards(
+        context,
+        referral.rewards[side],
+        ["rewards", side],
+        "referral programs"
+      );
+    }
+    for (const [index, milestone] of referral.milestones.entries()) {
+      refuseQuestOnlyRewards(
+        context,
+        milestone.rewards,
+        ["milestones", index, "rewards"],
+        "referral programs"
+      );
+    }
+  }
+);
 function defineReferral(input) {
   const { qualification, inviterGroup, milestones, bonuses, ...properties } = input;
-  const definition = referralAuthoringSchema.parse({
+  const definition = parseDefinition("Referral", referralBuilderSchema, {
     ...properties,
     qualification: qualification.kind === "quest" ? { kind: "quest", quest: qualification.quest.key } : qualification,
     ...inviterGroup ? { inviterGroup: identifier.parse(inviterGroup.key) } : {},
@@ -190,10 +255,22 @@ function defineReferral(input) {
 function earned(options = {}) {
   return { kind: "earned", ...options };
 }
+var leaderboardBuilderSchema = leaderboardAuthoringSchema.superRefine(
+  (board, context) => {
+    for (const [index, prize] of (board.settle?.prizes ?? []).entries()) {
+      refuseQuestOnlyRewards(
+        context,
+        prize.rewards,
+        ["settle", "prizes", index, "rewards"],
+        "leaderboard prizes"
+      );
+    }
+  }
+);
 function defineLeaderboard(input) {
   const { ledger, group, score, settle, ...properties } = input;
   const pool = settle?.pool;
-  const definition = leaderboardAuthoringSchema.parse({
+  const definition = parseDefinition("Leaderboard", leaderboardBuilderSchema, {
     ...properties,
     ...settle ? {
       settle: {
@@ -277,7 +354,7 @@ function isZodSchema(value) {
 function defineTracker(input) {
   return resourceHandle(
     "tracker",
-    trackerDefinitionSchema.parse(input)
+    parseDefinition("Tracker", trackerDefinitionSchema, input)
   );
 }
 function messages(options = {}) {
@@ -793,7 +870,7 @@ function trackerTrigger(input, constructor) {
   const roles = sourceRoles(source);
   if (!roles.includes(beneficiary)) {
     throw new Error(
-      source.kind === "custom" ? `Tracker "${tracker.key}" has no "${beneficiary}" account: declare it in customSource(namespace, { accounts: ["${beneficiary}"] })` : `Tracker "${tracker.key}" pays ${roles.map((role) => `"${role}"`).join(" or ")}, not "${beneficiary}"`
+      source.kind === "custom" ? `Tracker "${tracker.key}" has no "${beneficiary}" account: declare it in customSource(namespace, { accounts: ["${beneficiary}"] })` : `Tracker "${tracker.key}" pays ${new Intl.ListFormat("en", { type: "disjunction" }).format(roles.map((role) => `"${role}"`))}, not "${beneficiary}"`
     );
   }
   const policy = trackerTriggerPolicySchema.parse({
@@ -849,9 +926,10 @@ function defineBudget(definition) {
 }
 var budget = defineBudget;
 var authorBudgets = (budgets = []) => budgets.filter((value) => value.scope === "author");
-var keyed = (key) => ({
+var keyed = (key, options = {}) => ({
   kind: "keyed",
-  key
+  key,
+  ...options.across ? { across: options.across } : {}
 });
 var progress = (definition) => {
   const { distinct, ...policy } = definition;
@@ -947,13 +1025,17 @@ var completionPolicies = { once, keyed, streak, progress };
 function questBuilder(template) {
   return function defineQuest2(definition) {
     const key = authoringKey(definition);
-    const integrations = [
+    const integrationModules = [
       ...new Set(
         (definition.integrations ?? []).map(
-          (module) => evaluatorIntegrationProviderSchema.parse(module.provider)
+          (module) => integrationModuleProviderSchema.parse(module.provider)
         )
       )
     ];
+    const integrations = integrationModules.flatMap((provider) => {
+      const known = evaluatorIntegrationProviderSchema.safeParse(provider);
+      return known.success ? [known.data] : [];
+    });
     const contentTrigger = definition.trigger.kind === "automatic" && definition.trigger.tracker?.content === true;
     const trackerTrigger2 = definition.trigger.kind === "automatic" && definition.trigger.tracker !== void 0;
     const declared = definition.completion;
@@ -1088,13 +1170,17 @@ function questBuilder(template) {
           })
         } : {},
         integrations,
+        // Written only when it holds a module `integrations` lacks, so a quest declaring known
+        // modules describes itself as SDKs before `integrationModules` did, and a Relay that
+        // predates the field still accepts it.
+        ...integrationModules.length > integrations.length ? { integrationModules } : {},
         // A content quest's completion is keyed by its content item, with a key Relay owns.
         completion: !completion ? { kind: "keyed" } : completion.kind === "progress" ? {
           kind: completion.kind,
           goal: completion.goal,
           window: completion.window,
           repeat: completion.repeat
-        } : completion.kind === "streak" ? completion : { kind: completion.kind },
+        } : completion.kind === "streak" ? completion : completion.kind === "keyed" && completion.across ? { kind: completion.kind, across: completion.across } : { kind: completion.kind },
         visibility: definition.visibility ?? "visible",
         profile: definition.profile ?? { visible: false },
         budgets: (definition.budgets ?? []).filter(

package/dist/{automatic-outcomes-Cmou89IS.d.ts → automatic-outcomes-pAsOyIVp.d.ts}

@@ -1,5 +1,5 @@
 import * as z from 'zod';
-import { a as AttemptStatus } from './schema-CwbRkmlr.js';
+import { b as AttemptStatus, X as RewardType } from './accounts-CCqCKCVx.js';
 
 declare const collectionCodeSchema: z.ZodString;
 declare const collectionPassSchema: z.ZodObject<{
@@ -783,6 +783,10 @@ declare const automaticCatchUpPreviewSchema: z.ZodObject<{
         action: z.ZodLiteral<"grant-role">;
         roleId: z.ZodString;
     }, z.core.$strict>]>>;
+    rewardEntries: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodType<RewardType, unknown, z.core.$ZodTypeInternals<RewardType, unknown>>;
+        data: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+    }, z.core.$strip>>>;
     costs: z.ZodArray<z.ZodObject<{
         budget: z.ZodString;
         cost: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"dynamic">]>;

package/dist/avatar.d.ts

@@ -1,4 +1,4 @@
-import { P as ProfileAvatar, L as LinkedWallet } from './wallet-DZWL7lJH.js';
+import { P as ProfileAvatar, L as LinkedWallet } from './wallet-DTO7SXj7.js';
 import 'zod';
 
 /**

package/dist/browser.d.ts

@@ -1,15 +1,17 @@
-import { o as SubmissionStore, f as RelayClientOptions, R as RelayClient } from './client-Cw1pB5sv.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-CTJh4Ro_.js';
+import { o as SubmissionStore, f as RelayClientOptions, R as RelayClient } from './client-B-hbHX30.js';
+export { C as CosmosChains, D as DiscoveredWallet, E as Eip1193Provider, a as EmailSignInOption, K as KeplrLike, O as OAuthSignInOption, P as ProviderSignInOption, 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-BCE7zdOb.js';
 export { H as HostEnvironment, g as getHostEnvironment } from './host-environment-FN4zg3hw.js';
-import { M as MemberSummary } from './participant-activity-DHL8QYks.js';
-import './schema-CwbRkmlr.js';
+import { M as MemberSummary } from './participant-activity-D-Drp24G.js';
+import './accounts-CCqCKCVx.js';
 import 'zod';
-import './wallet-DZWL7lJH.js';
-import './pages-Bti7g5mX.js';
-import './submission-input-D9EGH_yb.js';
-import './groups-9Jm3peq3.js';
-import './action-DBzILFx9.js';
-import './accounts-DoabriBX.js';
+import './tracker-data-Hb1uQnk5.js';
+import './wallet-DTO7SXj7.js';
+import './pages-B8q8Y_dQ.js';
+import './submission-input-DHGKhXfp.js';
+import './request-error-D_dUPLwo.js';
+import './catalog--ZIlskAo.js';
+import './action-9Xl0StBg.js';
+import './sign-in-providers-BkjcDsFF.js';
 
 /**
  * The member's time at the real instant `at` (default now), in epoch milliseconds: what an app
@@ -18,7 +20,9 @@ import './accounts-DoabriBX.js';
  * clock; read `/v1/me` again on `domino:test-state-changed`. Without `clock` (a Relay older than
  * it) the member's time is real time.
  */
-declare function memberTime(me: Pick<MemberSummary, "clock">, at?: number): number;
+declare function memberTime(me: {
+    clock?: MemberSummary["clock"];
+}, at?: number): number;
 
 /** Browser client with durable submission recovery; safe to construct during SSR. */
 declare function createBrowserRelayClient(options: RelayClientOptions): RelayClient;