@domino-sdk/relay 1.0.0-next.1 → 1.0.0-next.2

package/dist/authoring.d.ts

@@ -129,7 +129,6 @@ declare const keyed: (key: (ctx: {
 };
 declare const completed: (quest: AuthoringIdentity | string) => {
     quest: string;
-    scope: "ever";
 };
 declare const untracked: () => {
     kind: "untracked";
@@ -174,17 +173,47 @@ type Outcome = {
     kind: "reject";
     reason: string;
 };
+/**
+ * A performance evaluator's answer. It gates the rewards content evaluation already selected, so
+ * it carries none: a `rewards` value fails the evaluation.
+ */
+type PerformanceOutcome = {
+    kind: "accept";
+    rewards?: never;
+} | {
+    kind: "review";
+    reason: string;
+    rewards?: never;
+} | {
+    kind: "reject";
+    reason: string;
+};
+declare function accept(): {
+    kind: "accept";
+};
+declare function accept(options: {
+    rewards?: Reward[];
+}): Outcome;
+declare function review(options: {
+    reason: string;
+    rewards?: undefined;
+}): {
+    kind: "review";
+    reason: string;
+};
+declare function review(options: {
+    reason: string;
+    rewards?: Reward[];
+}): Outcome;
 declare const decision: {
-    accept: (options?: {
-        rewards?: Reward[];
-    }) => Outcome;
+    accept: typeof accept;
     reject: (options: {
         reason: string;
-    }) => Outcome;
-    review: (options: {
+    }) => {
+        kind: "reject";
         reason: string;
-        rewards?: Reward[];
-    }) => Outcome;
+    };
+    review: typeof review;
 };
 type EvaluationContext<T, I = {
     photo: string;
@@ -304,7 +333,7 @@ declare function defineQuest<T extends Record<string, z.ZodType>, const G extend
             content: AdmittedContent;
             metrics: Record<M[number], number>;
             observedAt: number;
-        }) => Outcome | Promise<Outcome>;
+        }) => PerformanceOutcome | Promise<PerformanceOutcome>;
     } : never;
 }): {
     key: string;
@@ -503,7 +532,6 @@ declare function defineQuest<T extends Record<string, z.ZodType>, const G extend
         };
         requires: {
             quest: string;
-            scope: "ever";
         }[];
         completion: {
             kind: "streak";
@@ -542,4 +570,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, type TrackerTriggerInput, WalletBalance, WalletBalanceQuery, automatic, budget, completed, decision, defineQuest, defineQuestType, defineTieredReward, discordRole, evaluators, evidence, keyed, manual, once, points, staffHandover, untracked };
+export { type EvaluationContext, type PerformanceOutcome, 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-QEN4GHL7.js";
+} from "./chunk-B76BAJ25.js";
 import {
   isEvmChainId
-} from "./chunk-UI4N4XRZ.js";
+} from "./chunk-ONDBQSMU.js";
 import {
   admittedContentSchema,
   budgetSchema,
@@ -40,7 +40,7 @@ import {
   urlOptionsSchema,
   x,
   xAccountRoles
-} from "./chunk-UPWID5KS.js";
+} from "./chunk-NKGJEYZM.js";
 
 // src/authoring.ts
 import { z } from "zod";
@@ -64,6 +64,11 @@ var evidence = {
   quiz: () => "quiz"
 };
 function manual(options) {
+  if (options?.actor && options.input !== void 0) {
+    throw new Error(
+      'manual() cannot combine actor "staff" with input: staff-captured evidence is not supported. Use manual({ actor: "staff" }) for a staff confirmation, or manual({ input }) for evidence the participant submits.'
+    );
+  }
   if (typeof options?.input === "object") {
     return { kind: "manual", ...options.input };
   }
@@ -113,8 +118,7 @@ function automatic(input) {
 var budget = (definition) => budgetSchema.parse(definition);
 var keyed = (key) => ({ kind: "keyed", key });
 var completed = (quest) => ({
-  quest: typeof quest === "string" ? quest : authoringKey(quest),
-  scope: "ever"
+  quest: typeof quest === "string" ? quest : authoringKey(quest)
 });
 var untracked = () => ({ kind: "untracked" });
 var staffHandover = () => ({ kind: "staff-handover" });
@@ -130,19 +134,19 @@ function defineTieredReward(input) {
   };
 }
 var once = () => ({ kind: "once" });
+function accept(options = {}) {
+  return { kind: "accept", ...options };
+}
+function review(options) {
+  return { kind: "review", ...options };
+}
 var decision = {
-  accept: (options = {}) => ({
-    kind: "accept",
-    ...options
-  }),
+  accept,
   reject: (options) => ({
     kind: "reject",
     ...options
   }),
-  review: (options) => ({
-    kind: "review",
-    ...options
-  })
+  review
 };
 var evaluators = {
   quiz(answerKey, options = {}) {
@@ -190,6 +194,17 @@ function defineQuest(definition) {
   if (definition.completion.kind === "streak" && (definition.trigger.kind !== "automatic" || !definition.trigger.observation)) {
     throw new Error("Streaks require an automatic observation trigger");
   }
+  const bareAutomatic = definition.trigger.kind === "automatic" && !definition.trigger.observation && !definition.trigger.content && !definition.trigger.tracker;
+  if (bareAutomatic && !definition.requires?.length) {
+    throw new Error(
+      "A bare automatic() quest needs at least one requires entry, such as requires: [completed(quest)]. Give it an observation, content or tracker trigger, or a prerequisite."
+    );
+  }
+  if (bareAutomatic && definition.completion.kind === "keyed") {
+    throw new Error(
+      "A bare automatic() quest cannot use keyed() completion. Give it an observation, content or tracker trigger, or use once()."
+    );
+  }
   if (definition.trigger.kind === "manual" && definition.trigger.input !== "none" && !definition.evaluate) {
     throw new Error("Evidence quests require an evaluator");
   }
@@ -275,6 +290,11 @@ function defineQuest(definition) {
         if (!result2) {
           throw new Error("Performance evaluator returned no decision");
         }
+        if (result2.rewards !== void 0) {
+          throw new Error(
+            "A performance evaluator cannot select rewards. It gates the rewards content evaluation selected: return accept, review or reject with a reason only."
+          );
+        }
         return decisionSchema.parse(
           result2.kind === "accept" ? {
             kind: "accept",