@domino-sdk/relay 0.29.0 → 0.31.0

package/dist/authoring.d.ts

@@ -1,5 +1,5 @@
-import { A as AdmittedContent, O as Observation, T as TrackerTriggerContext, a as TrackerReader, X as XReader, I as ImageReader, D as DiscordMember, b as DiscordMessage, W as WalletConnection, S as SolanaBalance, L as LinkedWallet, c as WalletBalanceQuery, d as WalletBalance, o as observationTriggerSchema, e as TrackerDefinition, f as TrackerBeneficiary, g as TrackerTriggerPolicy, B as Budget, h as AuthoringIdentity, C as ContentMetric, i as IntegrationProvider, j as StreakPolicy, k as TextEvidence, U as UrlEvidence, l as TextOptions, m as UrlOptions } from './submission-input-C0cOmO4Q.js';
-export { n as content, p as customSource, q as defineEngagementReward, r as defineLeaderboard, s as defineReferral, t as defineTracker, u as discord, v as formatUnits, w as parseUnits, x as perContent, y as pointLedgers, z as settings, E as streak, F as trackerTriggerContextSchema, G as x } from './submission-input-C0cOmO4Q.js';
+import { A as AdmittedContent, O as Observation, T as TrackerTriggerContext, a as TrackerReader, X as XReader, I as ImageReader, D as DiscordMember, b as DiscordMessage, W as WalletConnection, S as SolanaBalance, L as LinkedWallet, c as WalletBalanceQuery, d as WalletBalance, e as TrackerDefinition, f as TrackerTriggerMode, g as TrackerWhere, o as observationTriggerSchema, h as TrackerTriggerPolicy, B as Budget, i as AuthoringIdentity, C as ContentMetric, j as IntegrationProvider, k as StreakPolicy, l as TextEvidence, U as UrlEvidence, m as TextOptions, n as UrlOptions } from './submission-input-JDwq3EVK.js';
+export { E as EvmChainId, p as content, q as customSource, r as defineEngagementReward, s as defineLeaderboard, t as defineReferral, u as defineTracker, v as discord, w as formatUnits, x as isEvmChainId, y as parseUnits, z as perContent, F as pointLedgers, G as settings, H as streak, J as trackerTriggerContextSchema, K as x } from './submission-input-JDwq3EVK.js';
 import { z } from 'zod';
 import { TextReviewInput, TextResult, PhotoResult, rewardSchema, triggerSchema, QuestPresentation, QuestProfile, QuizEvidence, Decision, TieredRewardDefinition } from './schema.js';
 
@@ -58,11 +58,32 @@ declare function manual(options: {
     input: "none";
     actor: "staff";
 };
+/** A tracker trigger: which observations of which tracker run the quest, and for whom. */
+type TrackerTriggerInput = {
+    tracker: TrackerDefinition;
+    /**
+     * Which observations fire. `"new-record"`: each record's first observation (the default for X
+     * trackers, where it means each newly collected post). `"new-observation"`: each observation
+     * that becomes its record's current one (the default for custom trackers). `"data-changed"`: a
+     * new record, or a current observation whose `data` differs from the previous one.
+     */
+    on?: TrackerTriggerMode;
+    /**
+     * Admit only observations whose `data` matches, such as `{ path: "amount", gte: 1000 }` or
+     * `{ path: "amount", gte: { setting: "threshold" } }`. Others record no outcome.
+     */
+    where?: TrackerWhere;
+    /**
+     * The record account whose member the quest pays: `"author"` (the default), `"inReplyTo"` on
+     * an X 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.
+     */
+    beneficiary?: string;
+};
 /**
  * An automatic quest. With no argument it runs once its prerequisites are complete; with an
- * observation it runs for each matching observation; with a tracker it runs for each new record
- * observation (each newly discovered post, for an X tracker), for the member Relay attributes the
- * record to.
+ * observation it runs for each matching observation; with a tracker it runs for each observation
+ * its firing mode and filter admit, for the member Relay attributes the beneficiary account to.
  */
 declare function automatic(): {
     kind: "automatic";
@@ -71,15 +92,7 @@ declare function automatic(observation: z.infer<typeof observationTriggerSchema>
     kind: "automatic";
     observation: z.infer<typeof observationTriggerSchema>;
 };
-declare function automatic(input: {
-    tracker: TrackerDefinition;
-    /**
-     * Whose quest each record is. `"author"` (the default): the member who verified the record
-     * author's wallet (custom trackers) or X account (X trackers). `"replied-to"`: the member whose
-     * verified X account an X post replies to.
-     */
-    beneficiary?: TrackerBeneficiary;
-}): {
+declare function automatic(input: TrackerTriggerInput): {
     kind: "automatic";
     tracker: TrackerTriggerPolicy;
 };
@@ -445,7 +458,26 @@ declare function defineQuest<T extends Record<string, z.ZodType>, const G extend
             tracker?: {
                 tracker: string;
                 source: "custom" | "x-search";
-                beneficiary: "author" | "replied-to";
+                beneficiary: string;
+                on?: "new-record" | "new-observation" | "data-changed" | undefined;
+                where?: {
+                    path: string;
+                    gt?: number | {
+                        setting: string;
+                    } | undefined;
+                    gte?: number | {
+                        setting: string;
+                    } | undefined;
+                    lt?: number | {
+                        setting: string;
+                    } | undefined;
+                    lte?: number | {
+                        setting: string;
+                    } | undefined;
+                } | {
+                    path: string;
+                    equals: string | number | boolean;
+                } | undefined;
             } | undefined;
         } | {
             kind: "manual";
@@ -510,4 +542,4 @@ declare function defineQuest<T extends Record<string, z.ZodType>, const G extend
  * Console instances receive independent quest identities and pinned versions. */
 declare const defineQuestType: typeof defineQuest;
 
-export { type EvaluationContext, TrackerTriggerContext, WalletBalance, WalletBalanceQuery, automatic, budget, completed, decision, defineQuest, defineQuestType, defineTieredReward, discordRole, evaluators, evidence, keyed, manual, once, points, staffHandover, untracked };
+export { type EvaluationContext, TrackerTriggerContext, type TrackerTriggerInput, WalletBalance, WalletBalanceQuery, automatic, budget, completed, decision, defineQuest, defineQuestType, defineTieredReward, discordRole, evaluators, evidence, keyed, manual, once, points, staffHandover, untracked };

package/dist/authoring.js

@@ -5,8 +5,10 @@ import {
   defineReferral,
   formatUnits,
   parseUnits
-} from "./chunk-YKS6P4IP.js";
-import "./chunk-MRKFRCCI.js";
+} from "./chunk-QEN4GHL7.js";
+import {
+  isEvmChainId
+} from "./chunk-UI4N4XRZ.js";
 import {
   admittedContentSchema,
   budgetSchema,
@@ -15,6 +17,7 @@ import {
   contentPerformanceSnapshotSchema,
   customSource,
   decisionSchema,
+  defaultTriggerMode,
   defineTracker,
   discord,
   integrationRewardSchema,
@@ -27,6 +30,7 @@ import {
   rewardBundleSchema,
   settingFieldSchema,
   settings,
+  sourceIdentities,
   streak,
   textOptionsSchema,
   tierRewardSchema,
@@ -34,8 +38,9 @@ import {
   trackerTriggerContextSchema,
   trackerTriggerPolicySchema,
   urlOptionsSchema,
-  x
-} from "./chunk-BE5V6RFD.js";
+  x,
+  xAccountRoles
+} from "./chunk-UPWID5KS.js";
 
 // src/authoring.ts
 import { z } from "zod";
@@ -73,20 +78,32 @@ function automatic(input) {
     return { kind: "automatic" };
   }
   if ("tracker" in input) {
-    const { tracker, beneficiary = "author" } = input;
-    if (beneficiary === "replied-to" && tracker.source.kind !== "x-search") {
-      throw new Error('"replied-to" requires an X tracker');
+    const { tracker, beneficiary = "author", on, where } = input;
+    const { source } = tracker;
+    if (source.kind === "x-search" && !xAccountRoles.includes(beneficiary)) {
+      throw new Error(
+        `X trackers pay "author" or "inReplyTo", not "${beneficiary}"`
+      );
     }
-    if (tracker.source.kind === "custom" && tracker.source.authors !== "wallet") {
+    if (!sourceIdentities(source)) {
       throw new Error(
-        'Tracker triggers need attributable authors: use customSource(namespace, { authors: "wallet" })'
+        'Tracker triggers need attributable records: declare customSource(namespace, { identities: ["wallet"] }) or other identity kinds'
+      );
+    }
+    if (source.kind === "custom" && beneficiary !== "author" && !source.accounts?.includes(beneficiary)) {
+      throw new Error(
+        `Tracker "${tracker.key}" has no "${beneficiary}" account: declare it in customSource(namespace, { accounts: ["${beneficiary}"] })`
       );
     }
     return {
       kind: "automatic",
       tracker: trackerTriggerPolicySchema.parse({
         tracker: tracker.key,
-        source: tracker.source.kind,
+        source: source.kind,
+        // The source's default mode is left out, so default quests keep the policy shape
+        // earlier SDKs and servers read.
+        ...on && on !== defaultTriggerMode(source.kind) ? { on } : {},
+        ...where ? { where } : {},
         beneficiary
       })
     };
@@ -182,6 +199,14 @@ function defineQuest(definition) {
       settingFieldSchema.parse(schema.meta())
     ])
   );
+  const where = definition.trigger.kind === "automatic" ? definition.trigger.tracker?.where : void 0;
+  for (const bound of where && !("equals" in where) ? [where.gt, where.gte, where.lt, where.lte] : []) {
+    if (typeof bound === "object" && fields[bound.setting]?.kind !== "integer") {
+      throw new Error(
+        `The tracker filter compares with setting "${bound.setting}", which is not an integer setting`
+      );
+    }
+  }
   function describe(input) {
     const settings2 = definition.settings.parse(input);
     const values = parseSettings(fields, settings2);
@@ -318,6 +343,7 @@ export {
   evaluators,
   evidence,
   formatUnits,
+  isEvmChainId,
   keyed,
   manual,
   once,