@domino-sdk/relay 0.13.0 → 0.14.0

package/dist/index.js

@@ -51,7 +51,7 @@ import {
   walletChallengeSchema,
   walletConnectionSchema,
   walletProofSchema
-} from "./chunk-Y7FVHF65.js";
+} from "./chunk-YZJOZL4V.js";
 import {
   customSource,
   defineLeaderboard,
@@ -90,6 +90,9 @@ import {
   trackerIngestResultSchema,
   trackerIngestSchema,
   trackerPageSchema,
+  trackerPreviewInputSchema,
+  trackerPreviewLimits,
+  trackerPreviewSchema,
   trackerQuerySchema,
   trackerRecordInputSchema,
   trackerRecordSchema,
@@ -98,14 +101,14 @@ import {
   trackerSummarySchema,
   x,
   xTweetSchema
-} from "./chunk-XOEREIXI.js";
+} from "./chunk-CJARNIVP.js";
 import {
   authScopeSchema,
   exchangeResultSchema,
   exchangeSchema,
   principalSchema,
   sessionSchema
-} from "./chunk-VDWQL6HV.js";
+} from "./chunk-I2CCMGN6.js";
 import {
   accountConnectionSchema,
   artifactSchema,
@@ -197,7 +200,7 @@ import {
   tierRewardSchema,
   tieredRewardDefinitionSchema,
   triggerSchema
-} from "./chunk-3UOTI4IU.js";
+} from "./chunk-FUQYKTOJ.js";
 export {
   QuestUpdatedError,
   RelayError,
@@ -378,6 +381,9 @@ export {
   trackerIngestResultSchema,
   trackerIngestSchema,
   trackerPageSchema,
+  trackerPreviewInputSchema,
+  trackerPreviewLimits,
+  trackerPreviewSchema,
   trackerQuerySchema,
   trackerRecordInputSchema,
   trackerRecordSchema,

package/dist/portal-proxy.js

@@ -1,7 +1,7 @@
 import {
   exchangeResultSchema
-} from "./chunk-VDWQL6HV.js";
-import "./chunk-3UOTI4IU.js";
+} from "./chunk-I2CCMGN6.js";
+import "./chunk-FUQYKTOJ.js";
 
 // src/portal-proxy.ts
 async function proxyParticipant(request, upstream) {
@@ -12,14 +12,16 @@ async function proxyParticipant(request, upstream) {
   ) || /^\/v1\/me\/(progress|experience|attempts|evidence|pass|collection-pass|wallet(?:\/challenge|\/verify)?)$/.test(
     path
   ) || /^\/v1\/attempts\/[\w-]+(?:\/retry)?$/.test(path) || /^\/v1\/referrals(?:\/(me|history))?$/.test(path) && request.method === "GET" || path === "/v1/reward-deliveries" && request.method === "GET" || path === "/v1/referrals/accept" && request.method === "POST" || request.method === "GET" && /^\/v1\/leaderboards(?:\/[\w-]+)?$/.test(path));
-  if (!allowed || !["GET", "POST"].includes(request.method))
+  if (!allowed || !["GET", "POST"].includes(request.method)) {
     return Response.json({ error: "Route not found" }, { status: 404 });
+  }
   const target = new URL(upstream.baseUrl);
-  if (target.protocol !== "https:" || target.username || target.password || target.pathname !== "/" || target.search || target.hash)
+  if (target.protocol !== "https:" || target.username || target.password || target.pathname !== "/" || target.search || target.hash) {
     return Response.json(
       { error: "Participant API is not configured" },
       { status: 503 }
     );
+  }
   target.pathname = path;
   target.search = incoming.search;
   const headers = new Headers();
@@ -33,10 +35,13 @@ async function proxyParticipant(request, upstream) {
     "CF-Connecting-IP"
   ]) {
     const value = request.headers.get(name);
-    if (value) headers.set(name, value);
+    if (value) {
+      headers.set(name, value);
+    }
   }
-  if (upstream.hosted ?? true)
+  if (upstream.hosted ?? true) {
     headers.set("X-Relay-App-Origin", incoming.origin);
+  }
   const send = upstream.fetch;
   const response = await send(target, {
     method: request.method,
@@ -54,14 +59,16 @@ async function proxyParticipant(request, upstream) {
 function createParticipantBackend(options) {
   const origin = new URL(options.origin);
   const base = new URL(options.baseUrl);
-  if (origin.protocol !== "https:" || origin.origin !== options.origin || base.protocol !== "https:" || base.origin !== options.baseUrl)
+  if (origin.protocol !== "https:" || origin.origin !== options.origin || base.protocol !== "https:" || base.origin !== options.baseUrl) {
     throw new Error(
       "Configure exact HTTPS application and participant API origins"
     );
-  if (!options.integrationKey.startsWith("di_"))
+  }
+  if (!options.integrationKey.startsWith("di_")) {
     throw new Error(
       "Use an identity integration server key from Console Settings"
     );
+  }
   const send = options.fetch ?? fetch;
   const cookie = (token) => `domino_app_session=${token}; Path=/relay; HttpOnly; Secure; SameSite=Lax; Max-Age=${token ? 28800 : 0}`;
   return async (request) => {
@@ -70,12 +77,14 @@ function createParticipantBackend(options) {
       { error },
       { status, headers: { "Cache-Control": "no-store" } }
     );
-    if (url.origin !== options.origin)
+    if (url.origin !== options.origin) {
       return reject("Unexpected application origin", 403);
-    if (request.method !== "GET" && (request.headers.get("Origin") !== options.origin || request.headers.get("X-Relay-CSRF") !== "1"))
+    }
+    if (request.method !== "GET" && (request.headers.get("Origin") !== options.origin || request.headers.get("X-Relay-CSRF") !== "1")) {
       return reject("Untrusted browser request", 403);
+    }
     const identity = await options.authenticate(request);
-    if (!identity)
+    if (!identity) {
       return Response.json(
         url.pathname === "/relay/v1/auth/session" ? null : { error: "Sign in to the application" },
         {
@@ -83,6 +92,7 @@ function createParticipantBackend(options) {
           headers: { "Set-Cookie": cookie(""), "Cache-Control": "no-store" }
         }
       );
+    }
     const previousToken = request.headers.get("Cookie")?.split(";").map((value) => value.trim()).find((value) => value.startsWith("domino_app_session="))?.slice("domino_app_session=".length);
     const exchanged = await send(options.baseUrl + "/v1/auth/exchange", {
       method: "POST",
@@ -93,11 +103,12 @@ function createParticipantBackend(options) {
       },
       body: JSON.stringify({ subject: identity.subject, previousToken })
     });
-    if (!exchanged.ok)
+    if (!exchanged.ok) {
       return reject(
         "Domino identity exchange failed. Check the server integration key and its expiry in Console Settings.",
         exchanged.status
       );
+    }
     const { token } = exchangeResultSchema.parse(await exchanged.json());
     const response = await proxyParticipant(request, {
       baseUrl: options.baseUrl,
@@ -105,7 +116,9 @@ function createParticipantBackend(options) {
         const headers2 = new Headers(init?.headers);
         headers2.delete("Cookie");
         const returnBinding = request.headers.get("Cookie")?.split(";").map((value) => value.trim()).find((value) => value.startsWith("relay_auth_return="));
-        if (returnBinding) headers2.set("Cookie", returnBinding);
+        if (returnBinding) {
+          headers2.set("Cookie", returnBinding);
+        }
         headers2.set("Authorization", "Bearer " + token);
         headers2.set("X-Relay-Integration-Key", options.integrationKey);
         headers2.set("Origin", options.origin);

package/dist/schema.d.ts

@@ -83,8 +83,8 @@ declare const triggerSchema: z.ZodUnion<readonly [z.ZodObject<{
         none: "none";
     }>;
     actor: z.ZodOptional<z.ZodEnum<{
-        member: "member";
         staff: "staff";
+        member: "member";
     }>>;
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"automatic">;
@@ -373,8 +373,8 @@ declare const questDescriptionSchema: z.ZodObject<{
             none: "none";
         }>;
         actor: z.ZodOptional<z.ZodEnum<{
-            member: "member";
             staff: "staff";
+            member: "member";
         }>>;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"automatic">;
@@ -614,8 +614,8 @@ declare const publishedReleaseSchema: z.ZodUnion<readonly [z.ZodObject<{
             none: "none";
         }>;
         actor: z.ZodOptional<z.ZodEnum<{
-            member: "member";
             staff: "staff";
+            member: "member";
         }>>;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"automatic">;
@@ -672,8 +672,8 @@ declare const publishedReleaseSchema: z.ZodUnion<readonly [z.ZodObject<{
         typeVersion: z.ZodString;
     }, z.core.$strict>>;
     lifecycle: z.ZodDefault<z.ZodEnum<{
-        active: "active";
         paused: "paused";
+        active: "active";
         archived: "archived";
     }>>;
     configuration: z.ZodOptional<z.ZodObject<{
@@ -871,7 +871,7 @@ declare const publishedReleaseSchema: z.ZodUnion<readonly [z.ZodObject<{
     trigger: {
         kind: "manual";
         input: "photo" | "quiz" | "none";
-        actor?: "member" | "staff" | undefined;
+        actor?: "staff" | "member" | undefined;
     } | {
         kind: "automatic";
         observation?: {
@@ -907,7 +907,7 @@ declare const publishedReleaseSchema: z.ZodUnion<readonly [z.ZodObject<{
     id: string;
     createdAt: number;
     legacy: boolean;
-    lifecycle: "active" | "paused" | "archived";
+    lifecycle: "paused" | "active" | "archived";
     key?: string | undefined;
     origin?: {
         typeVersion: string;
@@ -1115,8 +1115,8 @@ declare const templateSchema: z.ZodObject<{
                 none: "none";
             }>;
             actor: z.ZodOptional<z.ZodEnum<{
-                member: "member";
                 staff: "staff";
+                member: "member";
             }>>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"automatic">;
@@ -1499,8 +1499,8 @@ declare const memberProgressSchema: z.ZodObject<{
                 none: "none";
             }>;
             actor: z.ZodOptional<z.ZodEnum<{
-                member: "member";
                 staff: "staff";
+                member: "member";
             }>>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"automatic">;
@@ -1868,8 +1868,8 @@ declare const snapshotSchema: z.ZodObject<{
                 none: "none";
             }>;
             actor: z.ZodOptional<z.ZodEnum<{
-                member: "member";
                 staff: "staff";
+                member: "member";
             }>>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"automatic">;
@@ -1926,8 +1926,8 @@ declare const snapshotSchema: z.ZodObject<{
             typeVersion: z.ZodString;
         }, z.core.$strict>>;
         lifecycle: z.ZodDefault<z.ZodEnum<{
-            active: "active";
             paused: "paused";
+            active: "active";
             archived: "archived";
         }>>;
         configuration: z.ZodOptional<z.ZodObject<{
@@ -2125,7 +2125,7 @@ declare const snapshotSchema: z.ZodObject<{
         trigger: {
             kind: "manual";
             input: "photo" | "quiz" | "none";
-            actor?: "member" | "staff" | undefined;
+            actor?: "staff" | "member" | undefined;
         } | {
             kind: "automatic";
             observation?: {
@@ -2161,7 +2161,7 @@ declare const snapshotSchema: z.ZodObject<{
         id: string;
         createdAt: number;
         legacy: boolean;
-        lifecycle: "active" | "paused" | "archived";
+        lifecycle: "paused" | "active" | "archived";
         key?: string | undefined;
         origin?: {
             typeVersion: string;

package/dist/schema.js

@@ -52,7 +52,7 @@ import {
   tierRewardSchema,
   tieredRewardDefinitionSchema,
   triggerSchema
-} from "./chunk-3UOTI4IU.js";
+} from "./chunk-FUQYKTOJ.js";
 export {
   artifactSchema,
   attemptSchema,

package/dist/{settings-CgI5nDQr.d.ts → settings-CU2y-wUM.d.ts}

@@ -330,6 +330,47 @@ declare const trackerSummarySchema: z.ZodObject<{
         records: z.ZodNumber;
     }, z.core.$strip>;
 }, z.core.$strip>;
+/** Preview bounds: one sample, never stored, never a tracker. */
+declare const trackerPreviewLimits: {
+    readonly pages: 3;
+    readonly posts: 100;
+    readonly days: 30;
+};
+/** A bounded X search sample for exploring a query before defining a tracker in code. */
+declare const trackerPreviewInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    since: z.ZodNumber;
+}, z.core.$strict>;
+type TrackerPreviewInput = z.input<typeof trackerPreviewInputSchema>;
+declare const trackerPreviewSchema: z.ZodObject<{
+    query: z.ZodString;
+    since: z.ZodNumber;
+    fetchedAt: z.ZodNumber;
+    pages: z.ZodNumber;
+    posts: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        userId: z.ZodString;
+        content: z.ZodString;
+        createdAt: z.ZodISODateTime;
+        author: z.ZodObject<{
+            id: z.ZodString;
+            username: z.ZodString;
+            name: z.ZodString;
+            verified: z.ZodDefault<z.ZodNullable<z.ZodBoolean>>;
+        }, z.core.$loose>;
+        likeCount: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        replyCount: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        retweetCount: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        quoteCount: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        viewCount: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        bookmarkCount: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        isReply: z.ZodBoolean;
+        isRetweet: z.ZodBoolean;
+        isQuoteTweet: z.ZodBoolean;
+    }, z.core.$loose>>;
+    more: z.ZodBoolean;
+}, z.core.$strip>;
+type TrackerPreview = z.infer<typeof trackerPreviewSchema>;
 /** Read-only capabilities in hosted quest evaluation; results are captured for replay. */
 type TrackerReader = {
     records(reference: string | {
@@ -2724,4 +2765,4 @@ declare function parseSettings(fields: Record<string, SettingField>, input: unkn
 declare function missingResourceSettings(fields: Record<string, SettingField>, values: SettingsValues): string[];
 declare function compatibleSettingKinds(previous: SettingField, next: SettingField): boolean;
 
-export { discordServerSchema as $, type AuthoringIdentity as A, type Budget as B, type TrackerRecord as C, type DiscordMember as D, type TrackerStatus as E, accountConnectionSchema as F, authProviderSchema as G, budgetSchema as H, type IntegrationProvider as I, communityTimeZoneSchema as J, compatibleSettingKinds as K, type LeaderboardQuery as L, completionKeySchema as M, completionPolicySchema as N, type Observation as O, type ProjectIntegration as P, type QuizContent as Q, type ReferralDefinition as R, type SolanaBalance as S, type TrackerReader as T, discordMemberInputSchema as U, discordMemberSchema as V, type WalletConnection as W, type XTweet as X, discordMessageInputSchema as Y, discordMessageSchema as Z, discordReactionSchema as _, type DiscordMessage as a, integrationProviderSchema as a0, leaderboardArtifactSchema as a1, leaderboardAuthoringSchema as a2, leaderboardDefinitionSchema as a3, leaderboardExclusionSchema as a4, leaderboardGroupSchema as a5, leaderboardPageSchema as a6, leaderboardPreviewSchema as a7, leaderboardQuerySchema as a8, leaderboardRowSchema as a9, referralSummarySchema as aA, resourceOptionsSchema as aB, resourceRequestSchema as aC, resourceSourceSchema as aD, settingFieldSchema as aE, settingsFieldsSchema as aF, settingsValuesSchema as aG, solanaAddressSchema as aH, solanaBalanceSchema as aI, streakPolicySchema as aJ, streakProgressSchema as aK, trackerArtifactSchema as aL, trackerControlSchema as aM, trackerDefinitionSchema as aN, trackerIngestResultSchema as aO, trackerIngestSchema as aP, trackerPageSchema as aQ, trackerQuerySchema as aR, trackerRecordInputSchema as aS, trackerRecordSchema as aT, trackerSourceSchema as aU, trackerStatusSchema as aV, trackerSummarySchema as aW, walletChallengeSchema as aX, walletConnectionSchema as aY, xTweetSchema as aZ, leaderboardWindowSchema as aa, missingResourceSettings as ab, observationInputSchema as ac, observationReceiptSchema as ad, observationSchema as ae, parseSettings as af, pointsAccountSchema as ag, pointsEntrySchema as ah, pointsMutationSchema as ai, pointsResultSchema as aj, projectIntegrationSchema as ak, publishedLeaderboardSchema as al, publishedReferralSchema as am, publishedTrackerSchema as an, quizChoiceSchema as ao, quizContentSchema as ap, quizQuestionSchema as aq, quizQuestionsSchema as ar, referralAccountSchema as as, referralArtifactSchema as at, referralAuthoringSchema as au, referralControlSchema as av, referralDefinitionSchema as aw, referralHistorySchema as ax, referralManagementSchema as ay, referralRelationshipSchema as az, type StreakPolicy as b, customSource as c, defineLeaderboard as d, defineReferral as e, defineTracker as f, discord as g, streak as h, walletProofSchema as i, type AuthProvider as j, type AccountConnection as k, type LeaderboardDefinition as l, type LeaderboardPage as m, type ResourceOption as n, observationTriggerSchema as o, pointLedgers as p, type ResourceSource as q, referralAcceptSchema as r, settings as s, type SettingField as t, type SettingsValues as u, type StreakProgress as v, walletChallengeInputSchema as w, x, type TrackerDefinition as y, type TrackerQuery as z };
+export { discordMessageSchema as $, type AuthoringIdentity as A, type Budget as B, type TrackerPreviewInput as C, type DiscordMember as D, type TrackerQuery as E, type TrackerRecord as F, type TrackerStatus as G, accountConnectionSchema as H, type IntegrationProvider as I, authProviderSchema as J, budgetSchema as K, type LeaderboardQuery as L, communityTimeZoneSchema as M, compatibleSettingKinds as N, type Observation as O, type ProjectIntegration as P, type QuizContent as Q, type ReferralDefinition as R, type SolanaBalance as S, type TrackerReader as T, completionKeySchema as U, completionPolicySchema as V, type WalletConnection as W, type XTweet as X, discordMemberInputSchema as Y, discordMemberSchema as Z, discordMessageInputSchema as _, type DiscordMessage as a, trackerSummarySchema as a$, discordReactionSchema as a0, discordServerSchema as a1, integrationProviderSchema as a2, leaderboardArtifactSchema as a3, leaderboardAuthoringSchema as a4, leaderboardDefinitionSchema as a5, leaderboardExclusionSchema as a6, leaderboardGroupSchema as a7, leaderboardPageSchema as a8, leaderboardPreviewSchema as a9, referralManagementSchema as aA, referralRelationshipSchema as aB, referralSummarySchema as aC, resourceOptionsSchema as aD, resourceRequestSchema as aE, resourceSourceSchema as aF, settingFieldSchema as aG, settingsFieldsSchema as aH, settingsValuesSchema as aI, solanaAddressSchema as aJ, solanaBalanceSchema as aK, streakPolicySchema as aL, streakProgressSchema as aM, trackerArtifactSchema as aN, trackerControlSchema as aO, trackerDefinitionSchema as aP, trackerIngestResultSchema as aQ, trackerIngestSchema as aR, trackerPageSchema as aS, trackerPreviewInputSchema as aT, trackerPreviewLimits as aU, trackerPreviewSchema as aV, trackerQuerySchema as aW, trackerRecordInputSchema as aX, trackerRecordSchema as aY, trackerSourceSchema as aZ, trackerStatusSchema as a_, leaderboardQuerySchema as aa, leaderboardRowSchema as ab, leaderboardWindowSchema as ac, missingResourceSettings as ad, observationInputSchema as ae, observationReceiptSchema as af, observationSchema as ag, parseSettings as ah, pointsAccountSchema as ai, pointsEntrySchema as aj, pointsMutationSchema as ak, pointsResultSchema as al, projectIntegrationSchema as am, publishedLeaderboardSchema as an, publishedReferralSchema as ao, publishedTrackerSchema as ap, quizChoiceSchema as aq, quizContentSchema as ar, quizQuestionSchema as as, quizQuestionsSchema as at, referralAccountSchema as au, referralArtifactSchema as av, referralAuthoringSchema as aw, referralControlSchema as ax, referralDefinitionSchema as ay, referralHistorySchema as az, type StreakPolicy as b, walletChallengeSchema as b0, walletConnectionSchema as b1, xTweetSchema as b2, customSource as c, defineLeaderboard as d, defineReferral as e, defineTracker as f, discord as g, streak as h, walletProofSchema as i, type AuthProvider as j, type AccountConnection as k, type LeaderboardDefinition as l, type LeaderboardPage as m, type ResourceOption as n, observationTriggerSchema as o, pointLedgers as p, type ResourceSource as q, referralAcceptSchema as r, settings as s, type SettingField as t, type SettingsValues as u, type StreakProgress as v, walletChallengeInputSchema as w, x, type TrackerDefinition as y, type TrackerPreview as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@domino-sdk/relay",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "type": "module",
   "exports": {
     ".": {