@domino-sdk/relay 0.17.1 → 0.18.0

package/dist/authoring.d.ts

@@ -1,5 +1,5 @@
-import { O as Observation, T as TrackerReader, X as XReader, D as DiscordMember, a as DiscordMessage, W as WalletConnection, S as SolanaBalance, o as observationTriggerSchema, B as Budget, A as AuthoringIdentity, I as IntegrationProvider, b as StreakPolicy, c as TextEvidence, U as UrlEvidence, d as TextOptions, e as UrlOptions } from './submission-input-Cktvl71b.js';
-export { f as customSource, g as defineLeaderboard, h as defineReferral, i as defineTracker, j as discord, p as pointLedgers, s as settings, k as streak, x } from './submission-input-Cktvl71b.js';
+import { A as AdmittedContent, O as Observation, T as TrackerReader, X as XReader, D as DiscordMember, a as DiscordMessage, W as WalletConnection, S as SolanaBalance, o as observationTriggerSchema, B as Budget, b as AuthoringIdentity, C as ContentMetric, I as IntegrationProvider, c as StreakPolicy, d as TextEvidence, U as UrlEvidence, e as TextOptions, f as UrlOptions } from './submission-input-DWlvrAQY.js';
+export { g as content, h as customSource, i as defineEngagementReward, j as defineLeaderboard, k as defineReferral, l as defineTracker, m as discord, p as perContent, n as pointLedgers, s as settings, q as streak, x } from './submission-input-DWlvrAQY.js';
 import { z } from 'zod';
 import { TextReviewInput, TextResult, PhotoResult, rewardSchema, triggerSchema, QuestPresentation, QuizEvidence, Decision, TieredRewardDefinition } from './schema.js';
 
@@ -78,6 +78,7 @@ declare const keyed: (key: (ctx: {
     member: {
         id: string;
     };
+    content?: AdmittedContent | null;
     observation: Observation | null;
     eligibleAt: number;
 }) => string) => {
@@ -86,6 +87,7 @@ declare const keyed: (key: (ctx: {
         member: {
             id: string;
         };
+        content?: AdmittedContent | null;
         observation: Observation | null;
         eligibleAt: number;
     }) => string;
@@ -157,6 +159,7 @@ type EvaluationContext<T, I = {
         id: string;
     };
     input: I;
+    content: AdmittedContent | null;
     observation: Observation | null;
     eligibleAt: number;
     trackers: TrackerReader;
@@ -206,7 +209,10 @@ type QuestInput<T extends Trigger> = T extends {
 } ? TextEvidence : T extends {
     input: "url";
 } ? UrlEvidence : Record<string, never>;
-declare function defineQuest<T extends Record<string, z.ZodType>, const G extends Trigger>(definition: AuthoringIdentity & {
+declare function defineQuest<T extends Record<string, z.ZodType>, const G extends Trigger, const M extends readonly [ContentMetric, ...ContentMetric[]] = readonly [
+    ContentMetric,
+    ...ContentMetric[]
+]>(definition: AuthoringIdentity & {
     title: string | ((ctx: {
         settings: z.output<z.ZodObject<T>>;
     }) => string);
@@ -229,6 +235,21 @@ declare function defineQuest<T extends Record<string, z.ZodType>, const G extend
         settings: z.output<z.ZodObject<T>>;
     }) => Reward[]);
     evaluate?: Evaluator<z.output<z.ZodObject<T>>, QuestInput<G>>;
+    performance?: G extends {
+        content: unknown;
+    } ? {
+        metrics: M;
+        maxAgeMs?: number;
+        evaluate: (ctx: {
+            settings: z.output<z.ZodObject<T>>;
+            member: {
+                id: string;
+            };
+            content: AdmittedContent;
+            metrics: Record<M[number], number>;
+            observedAt: number;
+        }) => Outcome | Promise<Outcome>;
+    } : never;
 }): {
     key: string;
     /** @deprecated Authoring key alias. Use key. */
@@ -363,6 +384,22 @@ declare function defineQuest<T extends Record<string, z.ZodType>, const G extend
         })[];
         humanReview: boolean;
         trigger: {
+            kind: "automatic";
+            observation?: {
+                source: string;
+                type: string;
+            } | undefined;
+            content?: {
+                tracker: string;
+                window: {
+                    start: number;
+                    end?: number | undefined;
+                };
+                enrollment: "required" | "none";
+                posts: "after-enrollment" | "since-start";
+                historical: "staff" | "automatic" | "claim";
+            } | undefined;
+        } | {
             kind: "manual";
             input: "text";
             constraints: {
@@ -370,7 +407,7 @@ declare function defineQuest<T extends Record<string, z.ZodType>, const G extend
                 minLength: number;
                 maxLength: number;
             };
-            actor?: "staff" | "member" | undefined;
+            actor?: "member" | "staff" | undefined;
         } | {
             kind: "manual";
             input: "url";
@@ -378,17 +415,11 @@ declare function defineQuest<T extends Record<string, z.ZodType>, const G extend
                 required: boolean;
                 allowedHosts?: string[] | undefined;
             };
-            actor?: "staff" | "member" | undefined;
+            actor?: "member" | "staff" | undefined;
         } | {
             kind: "manual";
             input: "photo" | "quiz" | "none";
-            actor?: "staff" | "member" | undefined;
-        } | {
-            kind: "automatic";
-            observation?: {
-                source: string;
-                type: string;
-            } | undefined;
+            actor?: "member" | "staff" | undefined;
         };
         requires: {
             quest: string;
@@ -413,10 +444,15 @@ declare function defineQuest<T extends Record<string, z.ZodType>, const G extend
                 balance: string;
             };
         }[];
+        performance?: {
+            metrics: ("likes" | "replies" | "reposts" | "quotes" | "views" | "bookmarks")[];
+            maxAgeMs: number;
+        } | undefined;
     };
     evaluate(ctx: EvaluationContext<unknown, QuestInput<G>> & {
         rewards: Reward[];
         humanReview: boolean;
+        performance?: unknown;
     }): Promise<Decision>;
 };
 /** Publish this artifact as a reusable type. Its key names the type;

package/dist/authoring.js

@@ -1,17 +1,22 @@
 import {
   authoringKey,
-  customSource,
+  defineEngagementReward,
   defineLeaderboard,
-  defineReferral,
-  defineTracker,
-  x
-} from "./chunk-XNS25KST.js";
+  defineReferral
+} from "./chunk-FBOW2TLN.js";
 import {
+  admittedContentSchema,
   budgetSchema,
+  content,
+  contentPerformancePolicySchema,
+  contentPerformanceSnapshotSchema,
+  customSource,
   decisionSchema,
+  defineTracker,
   discord,
   integrationRewardSchema,
   parseSettings,
+  perContent,
   pointLedgers,
   pointsRewardSchema,
   questDescriptionSchema,
@@ -23,8 +28,9 @@ import {
   textOptionsSchema,
   tierRewardSchema,
   tieredRewardDefinitionSchema,
-  urlOptionsSchema
-} from "./chunk-YUAE6PFY.js";
+  urlOptionsSchema,
+  x
+} from "./chunk-23ZZTCDK.js";
 
 // src/authoring.ts
 import { z } from "zod";
@@ -124,6 +130,16 @@ var evaluators = {
 };
 function defineQuest(definition) {
   const key = authoringKey(definition);
+  const contentTrigger = definition.trigger.kind === "automatic" && definition.trigger.content !== void 0;
+  if (definition.performance && !contentTrigger) {
+    throw new Error("Performance requires a content trigger");
+  }
+  const contentCompletion = "perContent" in definition.completion;
+  if (contentTrigger !== contentCompletion) {
+    throw new Error(
+      "Content triggers require perContent completion, and perContent requires a content trigger"
+    );
+  }
   if (definition.completion.kind === "streak" && (definition.trigger.kind !== "automatic" || !definition.trigger.observation)) {
     throw new Error("Streaks require an automatic observation trigger");
   }
@@ -152,6 +168,12 @@ function defineQuest(definition) {
       rewards,
       humanReview: definition.review?.({ settings: settings2 })?.enabled ?? true,
       trigger: definition.trigger,
+      ...definition.performance ? {
+        performance: contentPerformancePolicySchema.parse({
+          metrics: definition.performance.metrics,
+          maxAgeMs: definition.performance.maxAgeMs
+        })
+      } : {},
       integrations: [
         .../* @__PURE__ */ new Set([
           ...definition.integrations ?? [],
@@ -176,10 +198,42 @@ function defineQuest(definition) {
     describe,
     async evaluate(ctx) {
       const settings2 = definition.settings.parse(ctx.settings);
+      if (ctx.performance) {
+        if (!definition.performance) {
+          throw new Error("Quest has no performance evaluator");
+        }
+        const sample = contentPerformanceSnapshotSchema.parse(ctx.performance);
+        const metrics = z.record(
+          z.enum(definition.performance.metrics),
+          z.number().int().safe().nonnegative()
+        ).parse(sample.metrics);
+        const result2 = await definition.performance.evaluate({
+          settings: settings2,
+          member: ctx.member,
+          content: admittedContentSchema.parse(ctx.content),
+          metrics,
+          observedAt: sample.observedAt
+        });
+        if (!result2) {
+          throw new Error("Performance evaluator returned no decision");
+        }
+        return decisionSchema.parse(
+          result2.kind === "accept" ? {
+            kind: "accept",
+            rewards: sample.rewards,
+            completionKey: admittedContentSchema.parse(ctx.content).completionKey
+          } : result2.kind === "review" && ctx.humanReview ? {
+            kind: "review",
+            reason: result2.reason,
+            rewards: sample.rewards
+          } : { kind: "reject", reason: result2.reason }
+        );
+      }
       const result = definition.evaluate ? await definition.evaluate({
         settings: settings2,
         member: ctx.member,
         input: ctx.input,
+        content: contentTrigger ? admittedContentSchema.parse(ctx.content) : null,
         observation: ctx.observation ?? null,
         eligibleAt: ctx.eligibleAt,
         review: ctx.review,
@@ -209,8 +263,10 @@ export {
   automatic,
   budget,
   completed,
+  content,
   customSource,
   decision,
+  defineEngagementReward,
   defineLeaderboard,
   defineQuest,
   defineQuestType,
@@ -224,6 +280,7 @@ export {
   keyed,
   manual,
   once,
+  perContent,
   pointLedgers,
   points,
   settings,