@domino-sdk/relay 1.0.0-next.7 → 1.0.0-next.9

package/dist/authoring.js

@@ -10,7 +10,7 @@ import {
   isEvmChainId,
   leaderboardAuthoringSchema,
   referralAuthoringSchema
-} from "./chunk-DJZB5RY5.js";
+} from "./chunk-PHU5VDLR.js";
 import {
   admittedContentSchema,
   budgetSchema,
@@ -29,6 +29,7 @@ import {
   quizContentSchema,
   resourceSourceSchema,
   rewardBundleSchema,
+  schemaCheckedReader,
   settingFieldSchema,
   settingInstant,
   settingResourceId,
@@ -37,13 +38,17 @@ import {
   textOptionsSchema,
   tierRewardSchema,
   tieredRewardDefinitionSchema,
+  trackerDataIssue,
+  trackerDataSchema,
   trackerDefinitionSchema,
   trackerTriggerContextSchema,
   trackerTriggerPolicySchema,
   urlOptionsSchema,
+  whereSchemaIssue,
+  whereSettings,
   xAccountRoles,
   xSearchSourceSchema
-} from "./chunk-UW6R2QGT.js";
+} from "./chunk-YYD4QUBO.js";
 
 // src/builders.ts
 import { z } from "zod";
@@ -112,13 +117,26 @@ function defineLeaderboard(input) {
   };
 }
 var x = {
+  /** Posts matching an X search. Each record's `data` is the provider's post payload. */
   search: (input) => xSearchSourceSchema.parse({ kind: "x-search", ...input })
 };
-var customSource = (namespace, options = {}) => customSourceSchema.parse({
-  kind: "custom",
-  namespace,
-  ...options
-});
+function customSource(namespace, options) {
+  const { data, ...rest } = options ?? {};
+  if (!isZodSchema(data)) {
+    throw new Error(
+      `customSource("${namespace}") needs a data schema: customSource(namespace, { data: z.object({ ... }) }) describes each record's data`
+    );
+  }
+  return customSourceSchema.parse({
+    kind: "custom",
+    namespace,
+    ...rest,
+    data: trackerDataSchema(data)
+  });
+}
+function isZodSchema(value) {
+  return typeof value === "object" && value !== null && "_zod" in value;
+}
 function defineTracker(input) {
   return trackerDefinitionSchema.parse(input);
 }
@@ -142,6 +160,9 @@ var pointLedgers = () => ({
   provider: "domino",
   resource: "point-ledger"
 });
+function setting(_kind, schema) {
+  return schema;
+}
 var settings = {
   pointLedger(options) {
     const field = {
@@ -149,7 +170,10 @@ var settings = {
       kind: "point-ledger",
       default: identifier.parse(options.default)
     };
-    return identifier.default(field.default).meta(field);
+    return setting(
+      "point-ledger",
+      identifier.default(field.default).meta(field)
+    );
   },
   datetime(options) {
     const field = {
@@ -157,7 +181,10 @@ var settings = {
       kind: "datetime",
       default: settingInstant.parse(options.default)
     };
-    return settingInstant.default(field.default).meta(field);
+    return setting(
+      "datetime",
+      settingInstant.default(field.default).meta(field)
+    );
   },
   resource(options) {
     const field = {
@@ -166,11 +193,17 @@ var settings = {
       kind: "resource",
       default: settingResourceId.parse(options.default ?? "")
     };
-    return settingResourceId.default(field.default).meta(field);
+    return setting(
+      "resource",
+      settingResourceId.default(field.default).meta(field)
+    );
   },
   quiz(options) {
     const value = quizContentSchema.parse(options.default);
-    return quizContentSchema.default(value).meta({ ...options, default: value, kind: "quiz" });
+    return setting(
+      "quiz",
+      quizContentSchema.default(value).meta({ ...options, default: value, kind: "quiz" })
+    );
   },
   text(options) {
     const field = {
@@ -180,17 +213,30 @@ var settings = {
       maxLength: options.maxLength ?? 2e3,
       multiline: options.multiline ?? false
     };
-    return z.string().min(field.minLength).max(field.maxLength).default(field.default).meta(field);
+    return setting(
+      "text",
+      z.string().min(field.minLength).max(field.maxLength).default(field.default).meta(field)
+    );
   },
   integer(options) {
-    return z.number().int().min(options.min).max(options.max).default(options.default).meta({ ...options, kind: "integer" });
+    return setting(
+      "integer",
+      z.number().int().min(options.min).max(options.max).default(options.default).meta({ ...options, kind: "integer" })
+    );
   },
   boolean(options) {
-    return z.boolean().default(options.default).meta({ ...options, kind: "boolean" });
+    return setting(
+      "boolean",
+      z.boolean().default(options.default).meta({ ...options, kind: "boolean" })
+    );
   },
   choice(options) {
-    return z.enum(options.options).default(options.default).meta({ ...options, kind: "choice" });
+    return setting(
+      "choice",
+      z.enum(options.options).default(options.default).meta({ ...options, kind: "choice" })
+    );
   },
+  /** A quest's settings: every field is built with one of the builders above. */
   object(shape) {
     return z.object(shape).strict();
   }
@@ -198,6 +244,7 @@ var settings = {
 
 // src/authoring.ts
 import { z as z2 } from "zod";
+import { z as z3 } from "zod";
 var points = (balance, amount) => pointsRewardSchema.parse({ kind: "points", balance, amount });
 var discordRole = (roleId) => integrationRewardSchema.parse({
   kind: "integration",
@@ -232,6 +279,7 @@ function manual(options) {
     ...options?.actor ? { actor: options.actor } : {}
   };
 }
+var triggerDataSchemas = /* @__PURE__ */ new WeakMap();
 function automatic(input) {
   if (!input) {
     return { kind: "automatic" };
@@ -254,23 +302,32 @@ function automatic(input) {
         `Tracker "${tracker.key}" has no "${beneficiary}" account: declare it in customSource(namespace, { accounts: ["${beneficiary}"] })`
       );
     }
-    return {
-      kind: "automatic",
-      tracker: trackerTriggerPolicySchema.parse({
-        tracker: tracker.key,
-        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
-      })
-    };
+    const policy = trackerTriggerPolicySchema.parse({
+      tracker: tracker.key,
+      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
+    });
+    const issue = source.kind === "custom" && source.data ? whereSchemaIssue(source.data, policy.where) : null;
+    if (issue) {
+      throw new Error(issue);
+    }
+    const trigger = { kind: "automatic", tracker: policy };
+    if (source.kind === "custom" && source.data) {
+      triggerDataSchemas.set(trigger, source.data);
+    }
+    return trigger;
   }
   return { kind: "automatic", observation: input };
 }
 var budget = (definition) => budgetSchema.parse(definition);
-var keyed = (key) => ({ kind: "keyed", key });
+var keyed = (key) => ({
+  kind: "keyed",
+  key
+});
 var completed = (quest) => ({
   quest: typeof quest === "string" ? quest : authoringKey(quest)
 });
@@ -306,7 +363,7 @@ var evaluators = {
   quiz(answerKey, options = {}) {
     const expected = quizAnswersSchema.parse(answerKey);
     const questions = Object.keys(expected);
-    const minimum = z2.number().int().min(1).max(questions.length).parse(options.minimumCorrect ?? questions.length);
+    const minimum = z3.number().int().min(1).max(questions.length).parse(options.minimumCorrect ?? questions.length);
     return async ({ input }) => {
       const complete = Object.keys(input.answers).length === questions.length && questions.every((question) => Object.hasOwn(input.answers, question));
       const correct = questions.filter(
@@ -357,16 +414,22 @@ function defineQuest(definition) {
     throw new Error("Evidence quests require an evaluator");
   }
   const fields = Object.fromEntries(
-    Object.entries(definition.settings.shape).map(([key2, schema]) => [
-      key2,
-      settingFieldSchema.parse(schema.meta())
-    ])
+    Object.entries(definition.settings.shape).map(([key2, schema]) => {
+      const field = settingFieldSchema.safeParse(schema.meta());
+      if (!field.success) {
+        throw new Error(
+          `Setting "${key2}" is not a quest setting: build it with a settings builder, such as settings.integer({ label, default, min, max })`
+        );
+      }
+      return [key2, field.data];
+    })
   );
-  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") {
+  for (const setting2 of whereSettings(
+    definition.trigger.kind === "automatic" ? definition.trigger.tracker?.where : void 0
+  )) {
+    if (fields[setting2]?.kind !== "integer") {
       throw new Error(
-        `The tracker filter compares with setting "${bound.setting}", which is not an integer setting`
+        `The tracker filter compares with setting "${setting2}", which is not an integer setting`
       );
     }
   }
@@ -418,15 +481,24 @@ function defineQuest(definition) {
     describe,
     async evaluate(ctx) {
       const settings2 = definition.settings.parse(ctx.settings);
-      const tracker = trackerTrigger ? trackerTriggerContextSchema.parse(ctx.tracker) : null;
+      const pinned = trackerTrigger ? trackerTriggerContextSchema.parse(ctx.tracker) : null;
+      const schema = triggerDataSchemas.get(definition.trigger);
+      const dataIssue = pinned && schema ? trackerDataIssue(schema, pinned.record.data) : null;
+      if (dataIssue) {
+        return decisionSchema.parse({
+          kind: "reject",
+          reason: `The record's data does not match the data schema this quest was built with: ${dataIssue.path} ${dataIssue.reason}`
+        });
+      }
+      const tracker = pinned;
       if (ctx.performance) {
         if (!definition.performance) {
           throw new Error("Quest has no performance evaluator");
         }
         const sample = contentPerformanceSnapshotSchema.parse(ctx.performance);
-        const metrics = z2.record(
-          z2.enum(definition.performance.metrics),
-          z2.number().int().safe().nonnegative()
+        const metrics = z3.record(
+          z3.enum(definition.performance.metrics),
+          z3.number().int().safe().nonnegative()
         ).parse(sample.metrics);
         const result2 = await definition.performance.evaluate({
           settings: settings2,
@@ -469,7 +541,7 @@ function defineQuest(definition) {
         eligibleAt: ctx.eligibleAt,
         now: ctx.now,
         review: ctx.review,
-        trackers: ctx.trackers,
+        trackers: schemaCheckedReader(ctx.trackers),
         wallet: ctx.wallet,
         x: ctx.x,
         images: ctx.images,
@@ -492,7 +564,8 @@ function defineQuest(definition) {
           ...definition.completion.kind === "keyed" ? {
             completionKey: definition.completion.key({
               ...ctx,
-              tracker
+              observation: ctx.observation ?? null,
+              tracker: pinned
             })
           } : {}
         } : result
@@ -531,7 +604,9 @@ export {
   settings,
   staffHandover,
   streak,
+  trackerDataSchema,
   trackerTriggerContextSchema,
   untracked,
-  x
+  x,
+  z2 as z
 };

package/dist/avatar.d.ts

@@ -1,5 +1,5 @@
-import { L as LinkedWallet } from './wallet-Bu6sqJvQ.js';
-import { P as ProfileAvatar } from './profiles-BtOXMGcC.js';
+import { L as LinkedWallet } from './wallet-BGOfFkG9.js';
+import { P as ProfileAvatar } from './profiles-DDMFBRKe.js';
 import 'zod';
 
 /**