@domino-sdk/relay 1.69.0 → 1.71.0

package/dist/{chunk-CZ23KRVK.js → chunk-CVJTIVAP.js}

@@ -3,7 +3,7 @@ import {
   limits,
   resourceHandle,
   responseShape
-} from "./chunk-CQVKOD3B.js";
+} from "./chunk-74SMLZZ5.js";
 import {
   parseDefinition
 } from "./chunk-VNEJH4NT.js";

package/dist/{chunk-TCREFRPK.js → chunk-DDID5QX5.js}

@@ -1,19 +1,24 @@
 import {
   createRelayClient
-} from "./chunk-LGGD7S5T.js";
+} from "./chunk-IDG2VPYG.js";
 import {
   connectSolanaAccount,
   noAccount,
+  parseStationCodeLink,
   registeredWallets
-} from "./chunk-VAGGGB6B.js";
+} from "./chunk-MDSSIOBC.js";
+import {
+  sessionMember
+} from "./chunk-TW4RABVS.js";
 import {
   base58,
   cosmosChain
-} from "./chunk-CQVKOD3B.js";
+} from "./chunk-74SMLZZ5.js";
 import {
   RelayErrorCode,
   asRelayError,
-  clientError
+  clientError,
+  isRelayError
 } from "./chunk-VNEJH4NT.js";
 
 // src/wallet-browser.ts
@@ -515,6 +520,141 @@ function memberTime(me, at = Date.now()) {
   return at + (me.clock?.offsetMs ?? 0);
 }
 
+// src/refusal.ts
+function isRefusal(cause) {
+  return isRelayError(cause) && cause.kind === "http" && !cause.uncertain && cause.status !== void 0 && cause.status >= 400 && cause.status < 500;
+}
+
+// src/session-items.ts
+function readSessionItem(key) {
+  try {
+    return window.sessionStorage.getItem(key);
+  } catch {
+    return null;
+  }
+}
+function writeSessionItem(key, value) {
+  try {
+    if (value === null) {
+      window.sessionStorage.removeItem(key);
+    } else {
+      window.sessionStorage.setItem(key, value);
+    }
+  } catch {
+  }
+}
+function readSessionJson(key, valid) {
+  try {
+    const value = JSON.parse(readSessionItem(key) ?? "null");
+    return valid(value) ? value : null;
+  } catch {
+    return null;
+  }
+}
+
+// src/station-check-in.ts
+var PENDING = "domino:pending-station-check-in";
+var passing = /* @__PURE__ */ (() => /* @__PURE__ */ new Set(["rate-limited", "attempt-pending"]))();
+var stored = () => readSessionJson(
+  PENDING,
+  (value) => typeof value === "object" && value !== null && ["quest", "station", "code", "actionId"].every(
+    (key) => typeof value[key] === "string"
+  )
+);
+function captureStationCheckIn() {
+  if (typeof window === "undefined") {
+    return null;
+  }
+  const url = new URL(window.location.href);
+  const linked = parseStationCodeLink(url);
+  if (!linked) {
+    return stored();
+  }
+  const kept = stored();
+  const pending = kept && kept.quest === linked.quest && kept.station === linked.station && kept.code === linked.code ? kept : { ...linked, actionId: crypto.randomUUID() };
+  writeSessionItem(PENDING, JSON.stringify(pending));
+  url.searchParams.delete("code");
+  window.history.replaceState(window.history.state, "", url);
+  return pending;
+}
+function stationCheckInRetryable(state) {
+  return state.status === "failed" || state.status === "refused" && passing.has(state.code);
+}
+function forgetStationCheckIn(pending) {
+  if (stored()?.actionId === pending.actionId) {
+    writeSessionItem(PENDING, null);
+  }
+}
+function checkInStation(pending, options = {}) {
+  return {
+    key: pending.station,
+    label: options.stations?.find((station) => station.key === pending.station)?.label ?? pending.station
+  };
+}
+async function sendStationCheckIn(relay, pending, options = {}) {
+  const where = {
+    quest: pending.quest,
+    station: checkInStation(pending, options)
+  };
+  try {
+    const attempt = await relay.quests.checkIn(
+      pending.quest,
+      pending.station,
+      { code: pending.code, actionId: pending.actionId },
+      options.session ? { session: options.session } : void 0
+    );
+    forgetStationCheckIn(pending);
+    return { status: "checked-in", ...where, attempt };
+  } catch (caught) {
+    const error = asRelayError(caught, "The check-in couldn't be sent.");
+    if (error.status === 401 || error.code === "stale-session") {
+      return { status: "sign-in-required", ...where };
+    }
+    if (!isRefusal(caught)) {
+      return { status: "failed", ...where, error };
+    }
+    const code = error.code ?? (error.status === 429 ? "rate-limited" : "");
+    if (!passing.has(code)) {
+      forgetStationCheckIn(pending);
+    }
+    return {
+      status: "refused",
+      ...where,
+      code,
+      error,
+      ...error.retryAfter === void 0 ? {} : { retryAfter: error.retryAfter }
+    };
+  }
+}
+async function checkInAtStation(relay, options = {}) {
+  const pending = captureStationCheckIn();
+  if (!pending) {
+    return { status: "none" };
+  }
+  let session;
+  try {
+    session = await relay.auth.session();
+  } catch (caught) {
+    return {
+      status: "failed",
+      quest: pending.quest,
+      station: checkInStation(pending, options),
+      error: asRelayError(caught, "Couldn't read who is signed in.")
+    };
+  }
+  if (!sessionMember(session)) {
+    return {
+      status: "sign-in-required",
+      quest: pending.quest,
+      station: checkInStation(pending, options)
+    };
+  }
+  return sendStationCheckIn(relay, pending, {
+    ...options,
+    session: session.id
+  });
+}
+
 // src/browser.ts
 function createBrowserRelayClient(options) {
   return createRelayClient({
@@ -694,6 +834,15 @@ export {
   readSignInMethods,
   signInOptions,
   memberTime,
+  isRefusal,
+  readSessionItem,
+  writeSessionItem,
+  readSessionJson,
+  captureStationCheckIn,
+  stationCheckInRetryable,
+  checkInStation,
+  sendStationCheckIn,
+  checkInAtStation,
   createBrowserRelayClient,
   browserSubmissionStore
 };

package/dist/{chunk-WVK3G2J2.js → chunk-EMKYDGZ3.js}

@@ -1,7 +1,7 @@
 import {
   clientIdentity,
   retryAfter
-} from "./chunk-SWLW4VN3.js";
+} from "./chunk-KC4UB4ZX.js";
 
 // src/http-exchange.ts
 var uncertainStatuses = /* @__PURE__ */ (() => /* @__PURE__ */ new Set([500, 502, 504]))();

package/dist/{chunk-2A3BJ262.js → chunk-FGZGL5PG.js}

@@ -12,7 +12,7 @@ import {
   resourceHandle,
   responseShape,
   tierRewardSchema
-} from "./chunk-CQVKOD3B.js";
+} from "./chunk-74SMLZZ5.js";
 import {
   parseDefinition
 } from "./chunk-VNEJH4NT.js";

package/dist/{chunk-GEVARKEV.js → chunk-GHBYWDEZ.js}

@@ -9,7 +9,7 @@ import {
   rewardBundleSchema,
   settingsValuesSchema,
   trackerTriggerContextSchema
-} from "./chunk-CQVKOD3B.js";
+} from "./chunk-74SMLZZ5.js";
 
 // src/server/attempt-captures.ts
 import * as z from "zod";
@@ -65,6 +65,13 @@ var attemptCaptureSchema = /* @__PURE__ */ (() => z.object({
      * @experimental A minor release can change quest actions.
      */
     action: attemptActionSchema.nullable().optional(),
+    /**
+     * The code station the member checked in at, for an attempt a station's code started: its
+     * `ctx.action` is `{ kind: "station-code", reference: station }`. Absent for any other attempt.
+     *
+     * @experimental A minor release can change check-in stations.
+     */
+    station: z.string().optional(),
     eligibleAt: timestamp,
     calendar: z.object({
       segments: z.array(

package/dist/{chunk-RKTMSTT7.js → chunk-HN7DE2UN.js}

@@ -4,10 +4,10 @@ import {
   imageFieldsSchema,
   imageInspectionSchema,
   imageSightingsSchema
-} from "./chunk-DIXYVGXO.js";
+} from "./chunk-VFHLMNYV.js";
 import {
   photoResultSchema
-} from "./chunk-CQVKOD3B.js";
+} from "./chunk-74SMLZZ5.js";
 
 // src/image-results.ts
 import * as z from "zod";

package/dist/{chunk-LGGD7S5T.js → chunk-IDG2VPYG.js}

@@ -9,13 +9,13 @@ import {
   createHttpExchange,
   untilAborted,
   withQuery
-} from "./chunk-WVK3G2J2.js";
+} from "./chunk-EMKYDGZ3.js";
 import {
   PARTICIPANT_TIMEOUT,
   lifetime,
   retrying,
   validTimeout
-} from "./chunk-SWLW4VN3.js";
+} from "./chunk-KC4UB4ZX.js";
 import {
   authProvidersSchema,
   collectionPassSchema,
@@ -34,7 +34,7 @@ import {
   questOutcomeSchema,
   rewardDeliveriesSchema,
   rewardDeliveryQuerySchema
-} from "./chunk-ME2KUAVJ.js";
+} from "./chunk-3KKRXN5E.js";
 import {
   exchangeResultSchema,
   exchangeSchema,
@@ -44,7 +44,7 @@ import {
   participantSessionSchema,
   questExperienceSchema,
   sessionMember
-} from "./chunk-PO2ZDY27.js";
+} from "./chunk-TW4RABVS.js";
 import {
   engagementBoundaryPageSchema,
   engagementPageQuerySchema,
@@ -55,7 +55,7 @@ import {
   referralDefinitionSchema,
   referralHistorySchema,
   referralSummarySchema
-} from "./chunk-2A3BJ262.js";
+} from "./chunk-FGZGL5PG.js";
 import {
   AVATAR_UPLOAD_LIMIT,
   accountConnectionSchema,
@@ -99,6 +99,7 @@ import {
   quizEvidenceSchema,
   signInAccountSchema,
   signInProviderInputSchema,
+  stationCheckInSchema,
   submissionEvidenceSchema,
   submitSchema,
   telegramAccountConnectionSchema,
@@ -113,7 +114,7 @@ import {
   walletTransactionChallengeSchema,
   walletTransactionProofSchema,
   walletUnlinkInputSchema
-} from "./chunk-CQVKOD3B.js";
+} from "./chunk-74SMLZZ5.js";
 import {
   RelayError,
   RelayErrorCode,
@@ -1697,6 +1698,31 @@ function relayClient(options) {
           operationId: body2.actionId
         });
       },
+      /**
+       * Checks the signed-in member in at a quest's code station with the code they were given,
+       * and resolves with the queued attempt, which the quest decides with `{ kind:
+       * "station-code", reference: station }` in `ctx.action`; a repeat with the same `actionId`
+       * resolves with the first attempt. Refusals: 422 `station-unknown` when the quest has no
+       * such station, 422 `station-proof-mismatch` when transactions prove it, 409
+       * `station-code-not-set` while it has no code in this environment, 409 `station-revoked`,
+       * 409 `station-closed` outside its window, 422 `station-code-invalid` for a wrong code, and
+       * 429 `rate-limited` (with `Retry-After`) after 10 wrong codes from the member at the station
+       * in an hour or 600 at the station in 10 minutes, right codes included until it ends.
+       *
+       * @experimental A minor release can change check-in stations.
+       */
+      checkIn: async (quest, station, value, requestOptions) => {
+        const body2 = parseInput(stationCheckInSchema, withActionId(value));
+        return request(
+          `/v1/me/quests/${parseInput(identifier, quest)}/stations/${parseInput(identifier, station)}/check-in`,
+          attemptSchema,
+          {
+            json: body2,
+            options: requestOptions,
+            operationId: body2.actionId
+          }
+        );
+      },
       /**
        * Why automatic quests did or did not run for the signed-in member's activity, newest first:
        * each admission, and each skip with its stable code.

package/dist/{chunk-SWLW4VN3.js → chunk-KC4UB4ZX.js}

@@ -4,7 +4,7 @@ import {
 
 // package.json
 var name = "@domino-sdk/relay";
-var version = "1.69.0";
+var version = "1.71.0";
 
 // src/client-identity.ts
 function clientIdentity() {

package/dist/{chunk-ODJGTFPY.js → chunk-KIRXE37T.js}

@@ -6,13 +6,13 @@ import {
   imageSightingsSchema,
   imageUploadsSchema,
   publishedImageSchema
-} from "./chunk-DIXYVGXO.js";
+} from "./chunk-VFHLMNYV.js";
 import {
   dashboardArtifactSchema,
   dashboardIssue,
   dashboardPreviewSchema,
   normalizeDashboard
-} from "./chunk-CZ23KRVK.js";
+} from "./chunk-CVJTIVAP.js";
 import {
   authProvidersSchema,
   collectionPassSchema,
@@ -23,7 +23,7 @@ import {
   questOutcomePageSchema,
   questOutcomeSchema,
   rewardDeliveriesSchema
-} from "./chunk-ME2KUAVJ.js";
+} from "./chunk-3KKRXN5E.js";
 import {
   catalogDeploymentSchema,
   collectionViewSchema,
@@ -37,7 +37,7 @@ import {
   questExperienceSchema,
   questTypeVersionSchema,
   questViewSchema
-} from "./chunk-PO2ZDY27.js";
+} from "./chunk-TW4RABVS.js";
 import {
   engagementArtifactSchema,
   engagementBoundaryPageSchema,
@@ -52,7 +52,7 @@ import {
   referralDefinitionSchema,
   referralHistorySchema,
   referralSummarySchema
-} from "./chunk-2A3BJ262.js";
+} from "./chunk-FGZGL5PG.js";
 import {
   accountConnectionSchema,
   attemptSchema,
@@ -120,7 +120,7 @@ import {
   walletTransactionChallengeSchema,
   walletTransactionsSchema,
   whereSettings
-} from "./chunk-CQVKOD3B.js";
+} from "./chunk-74SMLZZ5.js";
 
 // src/deployments.ts
 import * as z from "zod";

package/dist/{chunk-VAGGGB6B.js → chunk-MDSSIOBC.js}

@@ -77,11 +77,68 @@ function getHostEnvironment() {
   return pending ??= readHostEnvironment();
 }
 
+// src/station-qr.ts
+function stationPayLink(url, station) {
+  const target = new URL(url);
+  target.searchParams.set("station", station);
+  return `solana:${encodeURIComponent(target.href)}`;
+}
+function stationCodeLink(url, { quest, station, code }) {
+  const target = new URL(url);
+  target.searchParams.set("quest", quest);
+  target.searchParams.set("station", station);
+  target.searchParams.set("code", code);
+  return target.href;
+}
+function parseStationCodeLink(link) {
+  let params;
+  try {
+    params = new URL(link).searchParams;
+  } catch {
+    return null;
+  }
+  const quest = params.get("quest");
+  const station = params.get("station");
+  const code = params.get("code");
+  return quest && station && code ? { quest, station, code } : null;
+}
+var escapeXml = (text) => text.replace(
+  /[&<>"']/g,
+  (character) => ({
+    "&": "&amp;",
+    "<": "&lt;",
+    ">": "&gt;",
+    '"': "&quot;",
+    "'": "&apos;"
+  })[character] ?? character
+);
+async function stationQrSvg(link, label) {
+  const { encodeQR } = await import("qr");
+  const modules = encodeQR(link, "raw", { ecc: "medium", border: 4 });
+  const size = modules.length;
+  const scale = 10;
+  const width = size * scale;
+  const labelHeight = 6 * scale;
+  const path = modules.flatMap(
+    (row, y) => row.flatMap((dark, x) => dark ? [`M${x} ${y}h1v1h-1z`] : [])
+  ).join("");
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${width + labelHeight}" viewBox="0 0 ${width} ${width + labelHeight}">
+<rect width="100%" height="100%" fill="#fff"/>
+<path transform="scale(${scale})" fill="#000" shape-rendering="crispEdges" d="${path}"/>
+<text x="${width / 2}" y="${width + labelHeight / 2}" font-family="sans-serif" font-size="${2.4 * scale}" text-anchor="middle" dominant-baseline="middle" fill="#000">${escapeXml(label)}</text>
+</svg>
+`;
+}
+
 export {
   noAccount,
   registeredWallets,
   connectSolanaAccount,
   hostEnvironmentPath,
   hostEnvironmentSchema,
-  getHostEnvironment
+  getHostEnvironment,
+  stationPayLink,
+  stationCodeLink,
+  parseStationCodeLink,
+  stationQrSvg
 };

package/dist/{chunk-BRROI4CH.js → chunk-OFSJYXGI.js}

@@ -1,20 +1,20 @@
 import {
   createHttpExchange,
   uncertainStatuses
-} from "./chunk-WVK3G2J2.js";
+} from "./chunk-EMKYDGZ3.js";
 import {
   MANAGEMENT_TIMEOUT,
   lifetime,
   retrying,
   validTimeout
-} from "./chunk-SWLW4VN3.js";
+} from "./chunk-KC4UB4ZX.js";
 import {
   base58Bytes,
   evmAddressSchema,
   knownResponse,
   solanaDevnet,
   solanaMainnet
-} from "./chunk-CQVKOD3B.js";
+} from "./chunk-74SMLZZ5.js";
 import {
   RequestError,
   isRequestError
@@ -437,6 +437,13 @@ function containsReferralIntegrationReward(value) {
   );
 }
 
+// src/csv.ts
+var csvField = (value) => {
+  const text2 = value == null ? "" : String(value);
+  return /[",\r\n]/.test(text2) ? `"${text2.replaceAll('"', '""')}"` : text2;
+};
+var csvLines = (rows) => rows.map((fields) => fields.map(csvField).join(",")).join("\n");
+
 export {
   questConfiguration,
   hex,
@@ -455,5 +462,6 @@ export {
   managementTransport,
   sequenceCursorSchema,
   REFERRAL_INTEGRATION_REWARD_ERROR,
-  containsReferralIntegrationReward
+  containsReferralIntegrationReward,
+  csvLines
 };

package/dist/{chunk-LZXDYSUH.js → chunk-PYZSCFMJ.js}

@@ -32,6 +32,10 @@ var participantRoutes = [
   { method: "POST", path: `/v1/attempts/:attempt${id}/retry` },
   { method: "GET", path: `/v1/me/quests/:quest${id}/submission` },
   { method: "POST", path: `/v1/me/quests/:quest${id}/submission` },
+  {
+    method: "POST",
+    path: `/v1/me/quests/:quest${id}/stations/:station${id}/check-in`
+  },
   { method: "GET", path: `/v1/me/submissions/:submission${id}` },
   { method: "POST", path: `/v1/me/submissions/:submission${id}` },
   { method: "POST", path: `/v1/me/submissions/:submission${id}/submit` },

package/dist/{chunk-UGM6DUB2.js → chunk-QMKTYPK6.js}

@@ -1,10 +1,10 @@
 import {
   imageAssetArtifactSchema
-} from "./chunk-DIXYVGXO.js";
+} from "./chunk-VFHLMNYV.js";
 import {
   authScopeSchema,
   exchangeResultSchema
-} from "./chunk-PO2ZDY27.js";
+} from "./chunk-TW4RABVS.js";
 import {
   appIdentityKindSchema,
   cosmosAddressSchema,
@@ -17,7 +17,7 @@ import {
   openIdentityKindSchema,
   pageCursorSchema,
   solanaAddressSchema
-} from "./chunk-CQVKOD3B.js";
+} from "./chunk-74SMLZZ5.js";
 
 // src/credential-secrets.ts
 import * as z from "zod";
@@ -623,6 +623,7 @@ ${body}`)
     return null;
   }
   const parsed = scheduledInvocationSchema.safeParse(
+    // A signed body that isn't JSON fails the schema and is refused.
     await new Response(body).json().catch(() => null)
   );
   if (!parsed.success || Math.abs(Date.now() - parsed.data.startedAt) > 6e4) {

package/dist/{chunk-PO2ZDY27.js → chunk-TW4RABVS.js}

@@ -19,7 +19,7 @@ import {
   storedQuestDescriptionSchema,
   storedReviewModeSchema,
   tieredRewardReferenceSchema
-} from "./chunk-CQVKOD3B.js";
+} from "./chunk-74SMLZZ5.js";
 
 // src/participant-activity.ts
 import * as z from "zod";

package/dist/{chunk-AZDZEQFK.js → chunk-UEVZ3TST.js}

@@ -2,13 +2,22 @@ import {
   discordMessageDataSchema,
   discordMessageTextDataSchema,
   discordReactionDataSchema,
+  galleryKinds,
   isKnownTrackerSource,
   takesSolanaTransaction,
   trackerDataSchema,
   xAccountRoles
-} from "./chunk-CQVKOD3B.js";
+} from "./chunk-74SMLZZ5.js";
 
 // src/quest-shape.ts
+var QuestShapeError = class extends Error {
+  constructor(message, code) {
+    super(message);
+    this.code = code;
+    this.name = "QuestShapeError";
+  }
+  code;
+};
 function validateQuestShape(description, options = {}) {
   const {
     trigger,
@@ -18,7 +27,8 @@ function validateQuestShape(description, options = {}) {
     retryCooldownMs,
     completionCooldownMs,
     authorBudgets = [],
-    stations
+    stations,
+    gallery
   } = description;
   const tracker = trigger.kind === "automatic" ? trigger.tracker : void 0;
   const content = tracker?.content === true;
@@ -67,6 +77,22 @@ function validateQuestShape(description, options = {}) {
       "Stations are for quests a signed Solana transaction completes: a member-submitted manual() quest without input"
     );
   }
+  if (gallery && options.template) {
+    throw new Error(
+      "Reusable quest types cannot declare a photo gallery: declare it on a quest written in code"
+    );
+  }
+  if (gallery && !options.authoring && !(trigger.kind === "manual" && trigger.input === "photo")) {
+    throw new QuestShapeError(
+      "A photo gallery is for a quest whose input is a photo: manual({ input: evidence.photo() })",
+      "gallery-requires-photo"
+    );
+  }
+  if (gallery && !galleryKinds.some((kind) => kind === gallery.kind)) {
+    throw new Error(
+      `Unknown gallery kind "${gallery.kind}": use ${galleryKinds.map((kind) => `"${kind}"`).join(" or ")}`
+    );
+  }
   if (trigger.kind === "automatic" && !tracker) {
     if (!options.template && requires.length === 0) {
       throw new Error("Automatic quests need at least one prerequisite");
@@ -120,6 +146,7 @@ function sourceDataSchema(source) {
 }
 
 export {
+  QuestShapeError,
   validateQuestShape,
   sourceRoles,
   sourceDataSchema

package/dist/{chunk-DIXYVGXO.js → chunk-VFHLMNYV.js}

@@ -2,7 +2,7 @@ import {
   identifier,
   responseShape,
   xTweetSchema
-} from "./chunk-CQVKOD3B.js";
+} from "./chunk-74SMLZZ5.js";
 
 // src/x.ts
 import * as z from "zod";

package/dist/{chunk-WNEQEDMU.js → chunk-W6DBNBMT.js}

@@ -1,6 +1,6 @@
 import {
   activityTypeSchema
-} from "./chunk-ODJGTFPY.js";
+} from "./chunk-KIRXE37T.js";
 import {
   completionRecordSchema,
   completionSourceSchema,
@@ -10,7 +10,7 @@ import {
   pageLimit,
   solanaAddressSchema,
   solanaSignatureSchema
-} from "./chunk-CQVKOD3B.js";
+} from "./chunk-74SMLZZ5.js";
 
 // src/server/webhooks.ts
 import * as z from "zod";