@domino-sdk/relay 0.30.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-B6f27BHm.js';
-export { E as EvmChainId, 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 isEvmChainId, x as parseUnits, y as perContent, z as pointLedgers, F as settings, G as streak, H as trackerTriggerContextSchema, J as x } from './submission-input-B6f27BHm.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,10 +5,10 @@ import {
   defineReferral,
   formatUnits,
   parseUnits
-} from "./chunk-HINZLW46.js";
+} from "./chunk-QEN4GHL7.js";
 import {
   isEvmChainId
-} from "./chunk-CWIJDQDT.js";
+} from "./chunk-UI4N4XRZ.js";
 import {
   admittedContentSchema,
   budgetSchema,
@@ -17,6 +17,7 @@ import {
   contentPerformanceSnapshotSchema,
   customSource,
   decisionSchema,
+  defaultTriggerMode,
   defineTracker,
   discord,
   integrationRewardSchema,
@@ -29,6 +30,7 @@ import {
   rewardBundleSchema,
   settingFieldSchema,
   settings,
+  sourceIdentities,
   streak,
   textOptionsSchema,
   tierRewardSchema,
@@ -36,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";
@@ -75,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 (!sourceIdentities(source)) {
+      throw new Error(
+        'Tracker triggers need attributable records: declare customSource(namespace, { identities: ["wallet"] }) or other identity kinds'
+      );
     }
-    if (tracker.source.kind === "custom" && tracker.source.authors !== "wallet") {
+    if (source.kind === "custom" && beneficiary !== "author" && !source.accounts?.includes(beneficiary)) {
       throw new Error(
-        'Tracker triggers need attributable authors: use customSource(namespace, { authors: "wallet" })'
+        `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
       })
     };
@@ -184,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);

package/dist/browser.d.ts

@@ -1,4 +1,4 @@
-import { a7 as CosmosChain, a8 as CosmosNetwork, Q as WalletSigner, a4 as WalletSignInNetwork, Y as AuthProvider, K as referralAcceptSchema, M as LeaderboardQuery, N as WalletAddressInput, P as walletSignatureSchema, L as LinkedWallet, R as walletChallengeInputSchema, V as walletProofSchema, Z as WalletSignature, _ as engagementPageQuerySchema, $ as contentQualificationQuerySchema, a0 as contentAdmissionQuerySchema, a1 as contentEnrollmentInputSchema, a2 as contentReleaseInputSchema } from './submission-input-B6f27BHm.js';
+import { a8 as CosmosChain, a9 as CosmosNetwork, R as WalletSigner, a5 as WalletSignInNetwork, Z as AuthProvider, M as referralAcceptSchema, N as LeaderboardQuery, P as WalletAddressInput, Q as walletSignatureSchema, L as LinkedWallet, V as walletChallengeInputSchema, Y as walletProofSchema, _ as WalletSignature, $ as engagementPageQuerySchema, a0 as contentQualificationQuerySchema, a1 as contentAdmissionQuerySchema, a2 as contentEnrollmentInputSchema, a3 as contentReleaseInputSchema } from './submission-input-JDwq3EVK.js';
 import { SubmitInput, ReleaseInput, beginHandoverSchema, contentPerformanceQuerySchema } from './schema.js';
 import { createRelayClient, SubmissionStore, ProfileUpdate, ProfileCompletionQuery, QuestView, QuestController, ProgressObservation, questExperienceSchema, ProgressObserver, ExchangeInput, PhotoSubmission, QuizSubmission, ClaimSubmission, ValueSubmission } from './index.js';
 import * as zod from 'zod';
@@ -759,7 +759,26 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                 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";
@@ -1036,7 +1055,26 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                     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";
@@ -1261,7 +1299,26 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                         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";
@@ -1489,7 +1546,26 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                     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";
@@ -2007,7 +2083,26 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                     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";
@@ -2477,7 +2572,26 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                 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";
@@ -2683,7 +2797,26 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                 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";
@@ -2888,7 +3021,26 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                 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";
@@ -3274,7 +3426,26 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
             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";
@@ -3508,7 +3679,26 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
             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";
@@ -3639,7 +3829,26 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                 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";

package/dist/browser.js

@@ -11,12 +11,12 @@ import {
   signInOptions,
   solanaSigner,
   walletStandardSolanaSigner
-} from "./chunk-UMKGCDBX.js";
-import "./chunk-CB7RKKDX.js";
-import "./chunk-HINZLW46.js";
-import "./chunk-TYYGYDYX.js";
-import "./chunk-CWIJDQDT.js";
-import "./chunk-BE5V6RFD.js";
+} from "./chunk-BGN3CQC6.js";
+import "./chunk-IZYXEXUO.js";
+import "./chunk-QEN4GHL7.js";
+import "./chunk-OQ4ZNOC7.js";
+import "./chunk-UI4N4XRZ.js";
+import "./chunk-UPWID5KS.js";
 export {
   browserSubmissionStore,
   cosmosChainList,

package/dist/{chunk-UMKGCDBX.js → chunk-BGN3CQC6.js}

@@ -1,9 +1,9 @@
 import {
   createRelayClient
-} from "./chunk-CB7RKKDX.js";
+} from "./chunk-IZYXEXUO.js";
 import {
   cosmosChain
-} from "./chunk-CWIJDQDT.js";
+} from "./chunk-UI4N4XRZ.js";
 
 // src/base58.ts
 var alphabet = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";

package/dist/{chunk-CB7RKKDX.js → chunk-IZYXEXUO.js}

@@ -19,13 +19,13 @@ import {
   referralHistorySchema,
   referralSummarySchema,
   validateAuthoringIdentity
-} from "./chunk-HINZLW46.js";
+} from "./chunk-QEN4GHL7.js";
 import {
   authScopeSchema,
   exchangeResultSchema,
   memberSummarySchema,
   sessionSchema
-} from "./chunk-TYYGYDYX.js";
+} from "./chunk-OQ4ZNOC7.js";
 import {
   AVATAR_UPLOAD_LIMIT,
   avatarUploadTypes,
@@ -46,7 +46,7 @@ import {
   walletSignInNetworksSchema,
   walletSignatureSchema,
   walletUnlinkInputSchema
-} from "./chunk-CWIJDQDT.js";
+} from "./chunk-UI4N4XRZ.js";
 import {
   accountConnectionSchema,
   attemptSchema,
@@ -85,7 +85,7 @@ import {
   validateSubmissionValue,
   valueEvidenceSchema,
   xTweetSchema
-} from "./chunk-BE5V6RFD.js";
+} from "./chunk-UPWID5KS.js";
 
 // src/point-ledgers.ts
 import { z } from "zod";

package/dist/{chunk-TYYGYDYX.js → chunk-OQ4ZNOC7.js}

@@ -1,6 +1,6 @@
 import {
   identifier
-} from "./chunk-BE5V6RFD.js";
+} from "./chunk-UPWID5KS.js";
 
 // src/auth.ts
 import { z } from "zod";

package/dist/{chunk-HINZLW46.js → chunk-QEN4GHL7.js}

@@ -1,13 +1,13 @@
 import {
   profileSummarySchema
-} from "./chunk-CWIJDQDT.js";
+} from "./chunk-UI4N4XRZ.js";
 import {
   contentMetricSchema,
   contentMetricsSchema,
   identifier,
   pointsRewardSchema,
   tierRewardSchema
-} from "./chunk-BE5V6RFD.js";
+} from "./chunk-UPWID5KS.js";
 
 // src/engagement.ts
 import { z } from "zod";

package/dist/{chunk-CWIJDQDT.js → chunk-UI4N4XRZ.js}

@@ -1,6 +1,6 @@
 import {
   identifier
-} from "./chunk-BE5V6RFD.js";
+} from "./chunk-UPWID5KS.js";
 
 // src/profiles.ts
 import { z } from "zod";