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

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, 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 { 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-jVvTh4Ed.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-jVvTh4Ed.js';
 import { z } from 'zod';
 import { TextReviewInput, TextResult, PhotoResult, rewardSchema, triggerSchema, QuestPresentation, QuestProfile, QuizEvidence, Decision, TieredRewardDefinition } from './schema.js';
 
@@ -114,6 +114,8 @@ declare const keyed: (key: (ctx: {
     /** The pinned tracker observation of a tracker-triggered quest. */
     tracker?: TrackerTriggerContext | null;
     eligibleAt: number;
+    /** The attempt's evaluation time; see {@link EvaluationContext.now}. */
+    now: number;
 }) => string) => {
     kind: "keyed";
     key: (ctx: {
@@ -125,11 +127,12 @@ declare const keyed: (key: (ctx: {
         /** The pinned tracker observation of a tracker-triggered quest. */
         tracker?: TrackerTriggerContext | null;
         eligibleAt: number;
+        /** The attempt's evaluation time; see {@link EvaluationContext.now}. */
+        now: number;
     }) => string;
 };
 declare const completed: (quest: AuthoringIdentity | string) => {
     quest: string;
-    scope: "ever";
 };
 declare const untracked: () => {
     kind: "untracked";
@@ -174,17 +177,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;
@@ -201,7 +234,18 @@ type EvaluationContext<T, I = {
      * was attributed to. Null unless the quest has a tracker trigger.
      */
     tracker: TrackerTriggerContext | null;
+    /**
+     * When the activity happened, in epoch milliseconds: the observation's or tracker record's
+     * occurrence time, else when the attempt was admitted. Budgets and daily keys use it.
+     */
     eligibleAt: number;
+    /**
+     * The attempt's evaluation time, in epoch milliseconds: when its first evaluation started.
+     * Every retry and replay of the attempt receives the same value, and the sandbox freezes
+     * `Date.now()` and `new Date()` at it. Use `eligibleAt` for when the activity
+     * happened.
+     */
+    now: number;
     trackers: TrackerReader;
     x: XReader;
     images: ImageReader;
@@ -304,7 +348,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 +547,6 @@ declare function defineQuest<T extends Record<string, z.ZodType>, const G extend
         };
         requires: {
             quest: string;
-            scope: "ever";
         }[];
         completion: {
             kind: "streak";
@@ -542,4 +585,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",
@@ -295,6 +315,7 @@ function defineQuest(definition) {
         observation: ctx.observation ?? null,
         tracker,
         eligibleAt: ctx.eligibleAt,
+        now: ctx.now,
         review: ctx.review,
         trackers: ctx.trackers,
         wallet: ctx.wallet,