@domino-sdk/relay 1.7.0 → 1.10.0

package/dist/{chunk-ZOUEEK5L.js → chunk-7BRHUUVB.js}

@@ -1,3 +1,7 @@
+import {
+  createRelayAction,
+  withActionId
+} from "./chunk-GFAFH7XR.js";
 import {
   collectionPassSchema,
   participantActivityQuerySchema,
@@ -12,7 +16,7 @@ import {
   questOutcomeQuerySchema,
   questOutcomeSchema,
   rewardDeliveriesSchema
-} from "./chunk-C25TDFHN.js";
+} from "./chunk-BKLGWPPD.js";
 import {
   AVATAR_UPLOAD_LIMIT,
   RelayError,
@@ -23,7 +27,7 @@ import {
   engagementPageQuerySchema,
   engagementPageSchema,
   isRelayError,
-  leaderboardDefinitionSchema,
+  leaderboardDefinitionResponseSchema,
   leaderboardPageSchema,
   leaderboardPlacementSchema,
   leaderboardQuerySchema,
@@ -51,7 +55,7 @@ import {
   walletSignInNetworksSchema,
   walletSignatureSchema,
   walletUnlinkInputSchema
-} from "./chunk-GMPPLZKH.js";
+} from "./chunk-UIR6NSYZ.js";
 import {
   PARTICIPANT_TIMEOUT,
   lifetime,
@@ -59,13 +63,16 @@ import {
   retrying,
   validTimeout
 } from "./chunk-6QJ3LADK.js";
+import {
+  clientIdentity
+} from "./chunk-N2HXMTVA.js";
 import {
   exchangeResultSchema,
   exchangeSchema,
   memberSummarySchema,
   participantSessionSchema,
   sessionMember
-} from "./chunk-6ON4RMEN.js";
+} from "./chunk-BUXNTVER.js";
 import {
   accountConnectionSchema,
   attemptSchema,
@@ -79,6 +86,7 @@ import {
   contentQualificationQuerySchema,
   evidenceSchema,
   identifier,
+  knownResponse,
   memberProgressSchema,
   missingPrerequisiteSchema,
   pageQuerySchema,
@@ -88,7 +96,7 @@ import {
   tieredRewardReferenceSchema,
   validateSubmissionValue,
   valueEvidenceSchema
-} from "./chunk-KGJSKGKI.js";
+} from "./chunk-23JUD56J.js";
 
 // src/submissions.ts
 import { z } from "zod";
@@ -848,6 +856,7 @@ function relayClient(options) {
   async function send(path, call, life) {
     const method = methodOf(call);
     const headers = new Headers(call.headers);
+    headers.set("X-Domino-Client", clientIdentity());
     let body2 = call.body;
     if (options.token) {
       headers.set("Authorization", `Bearer ${options.token}`);
@@ -969,7 +978,7 @@ function relayClient(options) {
     } catch (error) {
       throw invalidResponse(response.status, call, error);
     }
-    const parsed = schema.safeParse(value);
+    const parsed = knownResponse(schema).safeParse(value);
     if (!parsed.success) {
       throw invalidResponse(response.status, call, parsed.error);
     }
@@ -1070,6 +1079,32 @@ function relayClient(options) {
   const ok = z2.object({ ok: z2.literal(true) });
   const acknowledged = z2.object({ ok: z2.boolean() });
   return {
+    /** Owns one action key across uncertain writes. Reuse the helper until a definite answer. */
+    action: createRelayAction,
+    /** A JSON call using an explicit tolerant response schema from `@domino-sdk/relay/schema`. */
+    response: (path, schema, call = {}) => {
+      const base = new URL(options.baseUrl, "http://response.invalid");
+      const target = new URL(path, base);
+      if (!path.startsWith("/v1/") || /[\\#]/.test(path) || /%2e|%2f|%5c/i.test(path.split("?")[0]) || target.origin !== base.origin || !target.pathname.startsWith("/v1/")) {
+        throw clientError(
+          "Response path must stay within /v1",
+          RelayErrorCode.InvalidInput
+        );
+      }
+      const requestCall = {
+        method: call.method,
+        json: call.input,
+        operationId: call.operationId,
+        replaySafe: call.replaySafe,
+        headers: { "X-Domino-Response": "tolerant-v1" },
+        options: call
+      };
+      return exchange(path, requestCall, async (response, life) => ({
+        status: response.status,
+        operationId: call.operationId,
+        result: await read(response, schema, requestCall, life)
+      }));
+    },
     offers: {
       /** Offers available to this participant, including stock and per-member availability. */
       list: (requestOptions) => request("/v1/offers", z2.array(offerSchema), {
@@ -1103,7 +1138,7 @@ function relayClient(options) {
         { options: requestOptions }
       ),
       accept: async (value, requestOptions) => {
-        const body2 = parseInput(referralAcceptSchema, value);
+        const body2 = parseInput(referralAcceptSchema, withActionId(value));
         return request("/v1/referrals/accept", ok, {
           json: body2,
           options: requestOptions,
@@ -1138,7 +1173,7 @@ function relayClient(options) {
       })
     },
     leaderboards: {
-      list: (requestOptions) => request("/v1/leaderboards", z2.array(leaderboardDefinitionSchema), {
+      list: (requestOptions) => request("/v1/leaderboards", z2.array(leaderboardDefinitionResponseSchema), {
         options: requestOptions
       }),
       standings: async (board, query = {}, requestOptions) => request(
@@ -1174,10 +1209,15 @@ function relayClient(options) {
        * Changes the member's own name, avatar choice or visibility; omitted fields stay, and null
        * returns to the default.
        */
-      update: async (value, requestOptions) => request("/v1/me/profile", ownProfileSchema, {
-        json: parseInput(profileUpdateSchema, value),
-        options: requestOptions
-      }),
+      update: async (value, requestOptions) => {
+        const { actionId, ...profile } = value;
+        return request("/v1/me/profile", ownProfileSchema, {
+          json: parseInput(profileUpdateSchema, profile),
+          options: requestOptions,
+          operationId: parseInput(identifier, actionId ?? crypto.randomUUID()),
+          replaySafe: false
+        });
+      },
       /**
        * Uploads a JPEG, PNG or WebP of at most 5 MB as the member's avatar. The server crops it to
        * a 512×512 WebP without metadata. The client never resends it: retrying with the same
@@ -1196,8 +1236,11 @@ function relayClient(options) {
             RelayErrorCode.InvalidInput
           );
         }
-        const { uploadId, ...rest } = requestOptions;
-        const operationId = parseInput(identifier, uploadId ?? crypto.randomUUID());
+        const { actionId, uploadId, ...rest } = requestOptions;
+        const operationId = parseInput(
+          identifier,
+          actionId ?? uploadId ?? crypto.randomUUID()
+        );
         return request("/v1/me/profile/avatar", ownProfileSchema, {
           method: "POST",
           body: file,
@@ -1251,7 +1294,7 @@ function relayClient(options) {
        * on a quest that counts from enrollment. Enrolling again returns the first enrollment.
        */
       enroll: async (value, requestOptions) => {
-        const body2 = parseInput(questEnrollmentInputSchema, value);
+        const body2 = parseInput(questEnrollmentInputSchema, withActionId(value));
         return request("/v1/quests/enrollments", questEnrollmentSchema, {
           json: body2,
           options: requestOptions,
@@ -1265,7 +1308,7 @@ function relayClient(options) {
        * with a `RelayError` whose code is that rule's skip code.
        */
       claim: async (value, requestOptions) => {
-        const body2 = parseInput(questClaimInputSchema, value);
+        const body2 = parseInput(questClaimInputSchema, withActionId(value));
         return request("/v1/quests/claims", questOutcomeSchema, {
           json: body2,
           options: requestOptions,
@@ -1335,7 +1378,7 @@ function relayClient(options) {
     campaigns: {
       /** Enrolls the signed-in member once in every quest of a campaign that requires it. */
       enroll: async (value, requestOptions) => {
-        const body2 = parseInput(campaignEnrollmentInputSchema, value);
+        const body2 = parseInput(campaignEnrollmentInputSchema, withActionId(value));
         return request("/v1/campaigns/enrollments", campaignEnrollmentSchema, {
           json: body2,
           options: requestOptions,
@@ -1344,7 +1387,7 @@ function relayClient(options) {
       },
       /** Pauses the signed-in member's campaign enrollment without erasing its history. */
       withdraw: async (value, requestOptions) => {
-        const body2 = parseInput(campaignWithdrawalInputSchema, value);
+        const body2 = parseInput(campaignWithdrawalInputSchema, withActionId(value));
         return request(
           "/v1/campaigns/enrollments/withdraw",
           campaignEnrollmentSchema,
@@ -1624,20 +1667,34 @@ function relayClient(options) {
       },
       /** Claims a quest for the signed-in member. Quest controllers (`quests.open`) call this. */
       claim: async (value, requestOptions) => {
-        const claim = parseInput(submitSchema.omit({ member: true }), value);
+        const claim = parseInput(
+          submitSchema.omit({ member: true }),
+          withActionId(value)
+        );
         return request("/v1/me/attempts", attemptSchema, {
           json: claim,
           options: requestOptions,
           operationId: claim.actionId
         });
       },
-      /** Uploads a photo as the signed-in member's evidence. */
-      upload: (file, requestOptions) => request("/v1/me/evidence", evidenceSchema, {
-        method: "POST",
-        body: file,
-        headers: { "Content-Type": file.type },
-        options: requestOptions
-      })
+      /** Uploads evidence with a generated key; reuse `actionId` and the same file to replay. */
+      upload: (file, requestOptions = {}) => {
+        const { actionId, uploadId, ...options2 } = requestOptions;
+        const operationId = parseInput(
+          identifier,
+          actionId ?? uploadId ?? crypto.randomUUID()
+        );
+        return request("/v1/me/evidence", evidenceSchema, {
+          method: "POST",
+          body: file,
+          headers: {
+            "Content-Type": file.type,
+            "X-Relay-Upload-ID": operationId
+          },
+          options: options2,
+          operationId
+        });
+      }
     },
     evidence: {
       /**

package/dist/{chunk-C25TDFHN.js → chunk-BKLGWPPD.js}

@@ -1,6 +1,6 @@
 import {
   pointLedgerReferenceSchema
-} from "./chunk-GMPPLZKH.js";
+} from "./chunk-UIR6NSYZ.js";
 import {
   authoringIdentityShape,
   entitlementSchema,
@@ -11,12 +11,13 @@ import {
   pickupSelectionSchema,
   prerequisiteSchema,
   publishedReleaseSchema,
+  responseShape,
   reviewModeSchema,
   settingsValuesSchema,
   storedQuestDescriptionSchema,
   storedReviewModeSchema,
   tieredRewardReferenceSchema
-} from "./chunk-KGJSKGKI.js";
+} from "./chunk-23JUD56J.js";
 
 // src/participant-activity.ts
 import { z } from "zod";
@@ -154,22 +155,26 @@ var draftBase = z2.object({
   baseRevision: z2.number().int().nonnegative(),
   changes: questDraftChangesSchema
 });
-var questDraftSchema = z2.discriminatedUnion("status", [
-  draftBase.extend({ status: z2.literal("draft") }),
-  draftBase.extend({
-    status: z2.literal("published"),
-    releaseIds: z2.array(identifier)
+var questDraftSchema = responseShape(
+  z2.discriminatedUnion("status", [
+    draftBase.extend({ status: z2.literal("draft") }),
+    draftBase.extend({
+      status: z2.literal("published"),
+      releaseIds: z2.array(identifier)
+    })
+  ])
+);
+var questCatalogSchema = responseShape(
+  z2.object({
+    revision: z2.number().int().nonnegative(),
+    types: z2.array(questTypeVersionSchema),
+    collections: z2.array(questCollectionSchema),
+    quests: z2.array(questInstanceSchema),
+    drafts: z2.array(questDraftSchema),
+    releases: z2.array(publishedReleaseSchema).default([]),
+    supportedInteractions: z2.array(interactionSchema)
   })
-]);
-var questCatalogSchema = z2.object({
-  revision: z2.number().int().nonnegative(),
-  types: z2.array(questTypeVersionSchema),
-  collections: z2.array(questCollectionSchema),
-  quests: z2.array(questInstanceSchema),
-  drafts: z2.array(questDraftSchema),
-  releases: z2.array(publishedReleaseSchema).default([]),
-  supportedInteractions: z2.array(interactionSchema)
-});
+);
 var catalogDeploymentSchema = z2.object({
   expectedRevision: z2.number().int().nonnegative(),
   types: z2.array(
@@ -181,12 +186,14 @@ var catalogDeploymentSchema = z2.object({
   collections: z2.array(collectionSlotDeclarationSchema).max(50).default([]),
   supportedInteractions: z2.array(interactionSchema).min(1).optional()
 }).strict();
-var catalogDeploymentPreviewSchema = z2.object({
-  revision: z2.number().int().nonnegative(),
-  types: z2.array(questTypeVersionSchema),
-  collections: z2.array(collectionSlotSchema),
-  supportedInteractions: z2.array(interactionSchema)
-});
+var catalogDeploymentPreviewSchema = responseShape(
+  z2.object({
+    revision: z2.number().int().nonnegative(),
+    types: z2.array(questTypeVersionSchema),
+    collections: z2.array(collectionSlotSchema),
+    supportedInteractions: z2.array(interactionSchema)
+  })
+);
 var saveQuestDraftSchema = z2.object({
   id: identifier.optional(),
   actionId: identifier,
@@ -210,13 +217,13 @@ var questRewardViewSchema = z2.discriminatedUnion("kind", [
   }),
   z2.object({ kind: z2.literal("integration"), label: z2.string() })
 ]);
-var questViewSchema = memberProgressSchema.shape.quests.element.extend(
-  {
+var questViewSchema = responseShape(
+  memberProgressSchema.shape.quests.element.extend({
     release: identifier,
     interaction: interactionSchema,
     lifecycle: z2.enum(["active", "paused", "archived"]),
     rewards: z2.array(questRewardViewSchema)
-  }
+  })
 );
 var collectionViewSchema = z2.object({
   key: identifier.optional(),
@@ -224,17 +231,21 @@ var collectionViewSchema = z2.object({
   title: z2.string(),
   quests: z2.array(questViewSchema)
 });
-var questExperienceSchema = z2.object({
-  entitlements: z2.array(entitlementSchema).default([]),
-  member: identifier,
-  quests: z2.array(questViewSchema),
-  collections: z2.array(collectionViewSchema)
-});
-var questPublicationPreviewSchema = z2.object({
-  draft: questDraftSchema,
-  releases: z2.array(publishedReleaseSchema),
-  affectedCollections: z2.array(questCollectionSchema)
-});
+var questExperienceSchema = responseShape(
+  z2.object({
+    entitlements: z2.array(entitlementSchema).default([]),
+    member: identifier,
+    quests: z2.array(questViewSchema),
+    collections: z2.array(collectionViewSchema)
+  })
+);
+var questPublicationPreviewSchema = responseShape(
+  z2.object({
+    draft: questDraftSchema,
+    releases: z2.array(publishedReleaseSchema),
+    affectedCollections: z2.array(questCollectionSchema)
+  })
+);
 var allocateQuestSchema = z2.object({ actionId: identifier }).strict();
 var allocatedQuestSchema = z2.object({ id: identifier });
 

package/dist/{chunk-6ON4RMEN.js → chunk-BUXNTVER.js}

@@ -1,6 +1,6 @@
 import {
   identifier
-} from "./chunk-KGJSKGKI.js";
+} from "./chunk-23JUD56J.js";
 
 // src/auth.ts
 import { z } from "zod";

package/dist/{chunk-BFZHJA2B.js → chunk-GEPSEVQO.js}

@@ -1,12 +1,12 @@
 import {
   createRelayClient
-} from "./chunk-ZOUEEK5L.js";
+} from "./chunk-7BRHUUVB.js";
 import {
   RelayErrorCode,
   asRelayError,
   clientError,
   cosmosChain
-} from "./chunk-GMPPLZKH.js";
+} from "./chunk-UIR6NSYZ.js";
 
 // src/base58.ts
 var alphabet = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";

package/dist/chunk-GFAFH7XR.js

@@ -0,0 +1,98 @@
+import {
+  RelayErrorCode,
+  clientError
+} from "./chunk-UIR6NSYZ.js";
+import {
+  isRequestError
+} from "./chunk-NPGENI7K.js";
+
+// src/action.ts
+function withActionId(value) {
+  return { ...value, actionId: value.actionId ?? crypto.randomUUID() };
+}
+function createRelayAction() {
+  let pending;
+  let flight;
+  let error;
+  let retryAt = 0;
+  function send(write) {
+    pending = write;
+    const previousError = error;
+    flight = Promise.resolve().then(async () => {
+      const wait = retryAt - Date.now();
+      if (wait > 0) {
+        await new Promise((resolve) => setTimeout(resolve, wait));
+      }
+      return write.task(write.actionId);
+    }).then(
+      (value) => {
+        pending = void 0;
+        error = void 0;
+        return value;
+      },
+      (cause) => {
+        retryAt = Date.now() + (isRequestError(cause) ? cause.retryAfter ?? 0 : 0);
+        if (isRequestError(cause) && cause.uncertain) {
+          error = cause;
+        } else if (previousError) {
+          throw previousError;
+        } else {
+          pending = void 0;
+        }
+        throw cause;
+      }
+    ).finally(() => {
+      flight = void 0;
+    });
+    return flight;
+  }
+  function retry() {
+    if (flight) {
+      return flight;
+    }
+    if (!pending || !error || error.recovery !== "replay" || error.operationId !== pending.actionId) {
+      return Promise.reject(
+        error ?? clientError(
+          "There is no replay-safe action to retry",
+          RelayErrorCode.InvalidInput
+        )
+      );
+    }
+    return send(pending);
+  }
+  return {
+    get actionId() {
+      return pending?.actionId;
+    },
+    get busy() {
+      return flight !== void 0;
+    },
+    get error() {
+      return error;
+    },
+    run(task) {
+      if (flight) {
+        return flight;
+      }
+      if (pending) {
+        return retry();
+      }
+      return send({ actionId: crypto.randomUUID(), task });
+    },
+    retry,
+    settle() {
+      if (flight) {
+        return false;
+      }
+      pending = void 0;
+      error = void 0;
+      retryAt = 0;
+      return true;
+    }
+  };
+}
+
+export {
+  withActionId,
+  createRelayAction
+};