@domino-sdk/relay 1.9.0 → 1.10.1

package/dist/{chunk-5ECM6AWV.js → chunk-A2KXEGGD.js}

@@ -4,15 +4,15 @@ import {
   imageFieldsSchema,
   imageInspectionSchema,
   imageSightingsSchema
-} from "./chunk-JW4G3SY5.js";
+} from "./chunk-S4IHOJEP.js";
 import {
   authScopeSchema
-} from "./chunk-6ON4RMEN.js";
+} from "./chunk-PRLGLZM4.js";
 import {
   appIdentityKindSchema,
   openIdentityKindSchema,
   photoResultSchema
-} from "./chunk-KGJSKGKI.js";
+} from "./chunk-5WK4EB5I.js";
 
 // src/configuration.ts
 function questConfiguration(release) {

package/dist/{chunk-L3QFIRGO.js → chunk-FH7ZFHDB.js}

@@ -1,12 +1,12 @@
 import {
   createRelayClient
-} from "./chunk-FWSSMSIA.js";
+} from "./chunk-MDN5EJY2.js";
 import {
   RelayErrorCode,
   asRelayError,
   clientError,
   cosmosChain
-} from "./chunk-2V74CHDL.js";
+} from "./chunk-MJMFGTVV.js";
 
 // src/base58.ts
 var alphabet = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";

package/dist/{chunk-FWSSMSIA.js → chunk-MDN5EJY2.js}

@@ -1,7 +1,7 @@
 import {
   createRelayAction,
   withActionId
-} from "./chunk-ETPL6AAJ.js";
+} from "./chunk-PFKV2M4B.js";
 import {
   collectionPassSchema,
   participantActivityQuerySchema,
@@ -16,7 +16,7 @@ import {
   questOutcomeQuerySchema,
   questOutcomeSchema,
   rewardDeliveriesSchema
-} from "./chunk-2N464DDE.js";
+} from "./chunk-NM2ZAWTF.js";
 import {
   AVATAR_UPLOAD_LIMIT,
   RelayError,
@@ -27,7 +27,7 @@ import {
   engagementPageQuerySchema,
   engagementPageSchema,
   isRelayError,
-  leaderboardDefinitionSchema,
+  leaderboardDefinitionResponseSchema,
   leaderboardPageSchema,
   leaderboardPlacementSchema,
   leaderboardQuerySchema,
@@ -55,7 +55,7 @@ import {
   walletSignInNetworksSchema,
   walletSignatureSchema,
   walletUnlinkInputSchema
-} from "./chunk-2V74CHDL.js";
+} from "./chunk-MJMFGTVV.js";
 import {
   PARTICIPANT_TIMEOUT,
   lifetime,
@@ -63,13 +63,16 @@ import {
   retrying,
   validTimeout
 } from "./chunk-6QJ3LADK.js";
+import {
+  clientIdentity
+} from "./chunk-2M3HLQFP.js";
 import {
   exchangeResultSchema,
   exchangeSchema,
   memberSummarySchema,
   participantSessionSchema,
   sessionMember
-} from "./chunk-6ON4RMEN.js";
+} from "./chunk-PRLGLZM4.js";
 import {
   accountConnectionSchema,
   attemptSchema,
@@ -83,6 +86,7 @@ import {
   contentQualificationQuerySchema,
   evidenceSchema,
   identifier,
+  knownResponse,
   memberProgressSchema,
   missingPrerequisiteSchema,
   pageQuerySchema,
@@ -92,7 +96,7 @@ import {
   tieredRewardReferenceSchema,
   validateSubmissionValue,
   valueEvidenceSchema
-} from "./chunk-KGJSKGKI.js";
+} from "./chunk-5WK4EB5I.js";
 
 // src/submissions.ts
 import { z } from "zod";
@@ -852,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}`);
@@ -973,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);
     }
@@ -1076,6 +1081,30 @@ function relayClient(options) {
   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), {
@@ -1144,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(

package/dist/{chunk-2V74CHDL.js → chunk-MJMFGTVV.js}

@@ -12,9 +12,10 @@ import {
   pointsRewardSchema,
   refuseWindowTimeZone,
   resourceHandle,
+  responseShape,
   rewardKey,
   tierRewardSchema
-} from "./chunk-KGJSKGKI.js";
+} from "./chunk-5WK4EB5I.js";
 
 // src/errors.ts
 import { z } from "zod";
@@ -577,6 +578,9 @@ var validateSettlementWindow = (definition, context) => {
   }
 };
 var leaderboardDefinitionSchema = leaderboardDefinitionObject.superRefine(validateSettlementWindow);
+var leaderboardDefinitionResponseSchema = responseShape(
+  leaderboardDefinitionSchema
+);
 var leaderboardAuthoringSchema = leaderboardDefinitionObject.omit({ id: true }).extend({
   ...authoringIdentityShape,
   score: z5.preprocess(refuseWindowTimeZone, scoreSchema),
@@ -589,7 +593,7 @@ var leaderboardArtifactSchema = z5.union([
 var publishedLeaderboardSchema = z5.object({
   archivedAt: z5.number().int().nonnegative().nullable().optional(),
   version: identifier,
-  definition: leaderboardDefinitionSchema,
+  definition: leaderboardDefinitionResponseSchema,
   publishedAt: timestamp,
   actor: z5.string().nullable()
 });
@@ -943,18 +947,22 @@ var offerArtifactSchema = z7.union([
   offerAuthoringSchema,
   z7.object({ code: z7.string().min(1).max(2e6) }).strict()
 ]);
-var offerAvailabilitySchema = z7.discriminatedUnion("kind", [
-  z7.object({ kind: z7.literal("available"), remaining: quantity }).strict(),
-  z7.object({ kind: z7.literal("out-of-stock") }).strict(),
-  z7.object({ kind: z7.literal("limit-reached") }).strict(),
-  z7.object({ kind: z7.literal("paused") }).strict()
-]);
-var offerSchema = offerDefinitionSchema.extend({
-  revision: z7.number().int().positive(),
-  available: quantity,
-  redeemed: quantity,
-  availability: offerAvailabilitySchema
-});
+var offerAvailabilitySchema = responseShape(
+  z7.discriminatedUnion("kind", [
+    z7.object({ kind: z7.literal("available"), remaining: quantity }).strict(),
+    z7.object({ kind: z7.literal("out-of-stock") }).strict(),
+    z7.object({ kind: z7.literal("limit-reached") }).strict(),
+    z7.object({ kind: z7.literal("paused") }).strict()
+  ])
+);
+var offerSchema = responseShape(
+  offerDefinitionSchema.extend({
+    revision: z7.number().int().positive(),
+    available: quantity,
+    redeemed: quantity,
+    availability: offerAvailabilitySchema
+  })
+);
 var redeemOfferSchema = z7.object({ actionId: identifier }).strict();
 var redemptionBase = {
   id: identifier,
@@ -972,15 +980,17 @@ var redemptionBase = {
   revision: z7.number().int().positive(),
   redeemedAt: z7.number().int().safe().nonnegative()
 };
-var redemptionSchema = z7.discriminatedUnion("status", [
-  z7.object({ ...redemptionBase, status: z7.literal("fulfilled") }).strict(),
-  z7.object({
-    ...redemptionBase,
-    status: z7.literal("canceled"),
-    canceledAt: z7.number().int().safe().nonnegative(),
-    reason: z7.string().min(1).max(500)
-  }).strict()
-]);
+var redemptionSchema = responseShape(
+  z7.discriminatedUnion("status", [
+    z7.object({ ...redemptionBase, status: z7.literal("fulfilled") }).strict(),
+    z7.object({
+      ...redemptionBase,
+      status: z7.literal("canceled"),
+      canceledAt: z7.number().int().safe().nonnegative(),
+      reason: z7.string().min(1).max(500)
+    }).strict()
+  ])
+);
 var offerControlSchema = z7.object({
   actionId: identifier,
   revision: z7.number().int().positive(),
@@ -1130,20 +1140,24 @@ var evmChainIdSchema = z8.custom(
   'Use an EVM chain ID such as "eip155:8453"'
 );
 var units = z8.string().regex(/^(0|[1-9][0-9]*)$/);
-var walletBalanceSchema = z8.object({
-  /** Canonical CAIP-2 ID for Solana, EVM or a supported Cosmos SDK chain. */
-  chain: z8.string(),
-  /** The canonical mint, EIP-55 contract or Cosmos bank denom; null for a native coin. */
-  token: z8.string().nullable(),
-  /** Null when token metadata does not report decimals. */
-  decimals: z8.number().int().min(0).max(255).nullable(),
-  /** The sum over `wallets`. */
-  total: units,
-  wallets: z8.array(z8.object({ address: z8.string(), amount: units }).strict()),
-  /** Solana: lowest slot. EVM: approximate latest block. Cosmos: the fixed queried block. */
-  at: z8.object({ kind: z8.enum(["slot", "block"]), number: units }).strict(),
-  observedAt: z8.number().int().nonnegative()
-}).strict();
+var walletBalanceSchema = responseShape(
+  z8.object({
+    /** Canonical CAIP-2 ID for Solana, EVM or a supported Cosmos SDK chain. */
+    chain: z8.string(),
+    /** The canonical mint, EIP-55 contract or Cosmos bank denom; null for a native coin. */
+    token: z8.string().nullable(),
+    /** Null when token metadata does not report decimals. */
+    decimals: z8.number().int().min(0).max(255).nullable(),
+    /** The sum over `wallets`. */
+    total: units,
+    wallets: z8.array(
+      z8.object({ address: z8.string(), amount: units }).strict()
+    ),
+    /** Solana: lowest slot. EVM: approximate latest block. Cosmos: the fixed queried block. */
+    at: z8.object({ kind: z8.enum(["slot", "block"]), number: units }).strict(),
+    observedAt: z8.number().int().nonnegative()
+  }).strict()
+);
 
 export {
   RelayErrorCode,
@@ -1208,6 +1222,7 @@ export {
   leaderboardPrizeSchema,
   leaderboardSettlementPolicySchema,
   leaderboardDefinitionSchema,
+  leaderboardDefinitionResponseSchema,
   leaderboardAuthoringSchema,
   leaderboardArtifactSchema,
   publishedLeaderboardSchema,

package/dist/{chunk-2N464DDE.js → chunk-NM2ZAWTF.js}

@@ -1,6 +1,6 @@
 import {
   pointLedgerReferenceSchema
-} from "./chunk-2V74CHDL.js";
+} from "./chunk-MJMFGTVV.js";
 import {
   authoringIdentityShape,
   entitlementSchema,
@@ -11,12 +11,13 @@ import {
   pickupSelectionSchema,
   prerequisiteSchema,
   publishedReleaseSchema,
+  responseShape,
   reviewModeSchema,
   settingsValuesSchema,
   storedQuestDescriptionSchema,
   storedReviewModeSchema,
   tieredRewardReferenceSchema
-} from "./chunk-KGJSKGKI.js";
+} from "./chunk-5WK4EB5I.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-ETPL6AAJ.js → chunk-PFKV2M4B.js}

@@ -1,7 +1,7 @@
 import {
   RelayErrorCode,
   clientError
-} from "./chunk-2V74CHDL.js";
+} from "./chunk-MJMFGTVV.js";
 import {
   isRequestError
 } from "./chunk-NPGENI7K.js";

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

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

package/dist/{chunk-JW4G3SY5.js → chunk-S4IHOJEP.js}

@@ -1,7 +1,8 @@
 import {
   identifier,
+  responseShape,
   xTweetSchema
-} from "./chunk-KGJSKGKI.js";
+} from "./chunk-5WK4EB5I.js";
 
 // src/x.ts
 import { z } from "zod";
@@ -85,33 +86,41 @@ var imageRequestSchema = z2.discriminatedUnion("operation", [
   })
 ]);
 var hash = z2.string().regex(/^[0-9a-f]{16}$/);
-var imageInspectionSchema = z2.strictObject({
-  width: z2.number().int().positive(),
-  height: z2.number().int().positive(),
-  format: z2.enum(["jpeg", "png", "webp", "gif", "avif"]),
-  bytes: z2.number().int().positive(),
-  sha256: z2.string().regex(/^[0-9a-f]{64}$/),
-  phash: hash,
-  dhash: hash
-});
+var imageInspectionSchema = responseShape(
+  z2.strictObject({
+    width: z2.number().int().positive(),
+    height: z2.number().int().positive(),
+    format: z2.enum(["jpeg", "png", "webp", "gif", "avif"]),
+    bytes: z2.number().int().positive(),
+    sha256: z2.string().regex(/^[0-9a-f]{64}$/),
+    phash: hash,
+    dhash: hash
+  })
+);
 var distance = z2.number().int().min(0).max(64);
-var imageComparisonSchema = z2.strictObject({
-  identical: z2.boolean(),
-  phashDistance: distance,
-  dhashDistance: distance
-});
-var imageExtractionSchema = z2.strictObject({
-  values: z2.record(
-    z2.string(),
-    z2.union([z2.string().max(2e3), z2.number(), z2.boolean(), z2.null()])
-  ),
-  reason: z2.string().min(1).max(2e3)
-});
-var imageSightingsSchema = z2.strictObject({
-  matches: z2.number().int().nonnegative(),
-  closestDistance: distance.nullable(),
-  firstSeenAt: z2.number().int().nonnegative().nullable()
-});
+var imageComparisonSchema = responseShape(
+  z2.strictObject({
+    identical: z2.boolean(),
+    phashDistance: distance,
+    dhashDistance: distance
+  })
+);
+var imageExtractionSchema = responseShape(
+  z2.strictObject({
+    values: z2.record(
+      z2.string(),
+      z2.union([z2.string().max(2e3), z2.number(), z2.boolean(), z2.null()])
+    ),
+    reason: z2.string().min(1).max(2e3)
+  })
+);
+var imageSightingsSchema = responseShape(
+  z2.strictObject({
+    matches: z2.number().int().nonnegative(),
+    closestDistance: distance.nullable(),
+    firstSeenAt: z2.number().int().nonnegative().nullable()
+  })
+);
 var sha256 = z2.string().regex(/^[0-9a-f]{64}$/);
 var imageSize = z2.number().int().positive().max(5 * 1024 * 1024);
 var imageAssetArtifactSchema = z2.strictObject({
@@ -129,26 +138,30 @@ var imageUploadRequestSchema = z2.strictObject({
     })
   ).min(1).max(10)
 });
-var imageUploadsSchema = z2.strictObject({
-  images: z2.array(
-    z2.strictObject({
-      sha256,
-      upload: z2.strictObject({
-        url: z2.string().url(),
-        headers: z2.record(z2.string(), z2.string()),
-        expiresAt: z2.number().int().positive()
-      }).nullable()
-    })
-  )
-});
-var publishedImageSchema = z2.strictObject({
-  key: identifier,
-  sha256,
-  type: z2.enum(["image/jpeg", "image/png", "image/webp"]),
-  size: imageSize,
-  width: z2.number().int().positive(),
-  height: z2.number().int().positive()
-});
+var imageUploadsSchema = responseShape(
+  z2.strictObject({
+    images: z2.array(
+      z2.strictObject({
+        sha256,
+        upload: z2.strictObject({
+          url: z2.string().url(),
+          headers: z2.record(z2.string(), z2.string()),
+          expiresAt: z2.number().int().positive()
+        }).nullable()
+      })
+    )
+  })
+);
+var publishedImageSchema = responseShape(
+  z2.strictObject({
+    key: identifier,
+    sha256,
+    type: z2.enum(["image/jpeg", "image/png", "image/webp"]),
+    size: imageSize,
+    width: z2.number().int().positive(),
+    height: z2.number().int().positive()
+  })
+);
 
 export {
   xIdSchema,

package/dist/{chunk-23QJ7WH4.js → chunk-WZJQ7XAT.js}

@@ -5,7 +5,7 @@ import {
   isKnownTrackerSource,
   trackerDataSchema,
   xAccountRoles
-} from "./chunk-KGJSKGKI.js";
+} from "./chunk-5WK4EB5I.js";
 
 // src/quest-shape.ts
 function validateQuestShape(description, options = {}) {