@domino-sdk/relay 1.0.0-next.7 → 1.0.0-next.8

package/dist/{chunk-DJZB5RY5.js → chunk-V7EZUZ3Z.js}

@@ -2,9 +2,10 @@ import {
   contentMetricSchema,
   contentMetricsSchema,
   identifier,
+  pageCursorSchema,
   pointsRewardSchema,
   tierRewardSchema
-} from "./chunk-UW6R2QGT.js";
+} from "./chunk-VARGF4JS.js";
 
 // src/authoring-identity.ts
 import { z } from "zod";
@@ -75,7 +76,7 @@ var engagementPageQuerySchema = z2.strictObject({
   rule: identifier,
   content: z2.string().min(1).max(256),
   member: identifier.optional(),
-  before: z2.coerce.number().int().positive().safe().optional()
+  cursor: pageCursorSchema.optional()
 });
 var engagementSettlementSchema = z2.strictObject({
   id: identifier,
@@ -105,7 +106,7 @@ var engagementPageSchema = z2.strictObject({
     reason: z2.string().nullable()
   }).nullable(),
   items: z2.array(engagementSettlementSchema),
-  next: amount.nullable()
+  nextCursor: pageCursorSchema.nullable()
 });
 var engagementChangePreviewInputSchema = z2.strictObject({
   code: z2.string().min(1).max(1e6)
@@ -156,7 +157,7 @@ var engagementBoundaryPageSchema = z2.strictObject({
       settlement: engagementSettlementSchema
     })
   ),
-  next: amount.nullable()
+  nextCursor: pageCursorSchema.nullable()
 });
 var engagementArtifactSchema = engagementPublishSchema.omit({
   actionId: true
@@ -173,128 +174,219 @@ var engagementDeploymentEntrySchema = z2.discriminatedUnion("kind", [
   })
 ]);
 
-// src/profiles.ts
+// src/request-error.ts
+var requestErrorBrand = /* @__PURE__ */ Symbol.for("@domino-sdk/relay.RequestError");
+function isRequestError(value) {
+  return typeof value === "object" && value !== null && value[requestErrorBrand] === true;
+}
+var RequestError = class extends Error {
+  name = "RequestError";
+  [requestErrorBrand] = true;
+  kind;
+  uncertain;
+  status;
+  code;
+  operationId;
+  /** `replay` when there is an `operationId`, else `reconcile`; only when `uncertain`. */
+  recovery;
+  constructor(message, details) {
+    super(message, details.cause === void 0 ? {} : { cause: details.cause });
+    this.kind = details.kind;
+    this.uncertain = details.uncertain ?? false;
+    this.status = details.status;
+    this.code = details.code;
+    this.operationId = details.operationId;
+    this.recovery = this.uncertain ? details.operationId ? "replay" : "reconcile" : void 0;
+  }
+};
+
+// src/errors.ts
 import { z as z3 } from "zod";
-var count = z3.number().int().nonnegative().safe();
-var profileVisibilitySchema = z3.enum([
+var RelayErrorCode = {
+  /** The call needs a signed-in member. */
+  NotSignedIn: "not-signed-in",
+  /** The session changed since the app read it (the `session` option). Reload before retrying. */
+  StaleSession: "stale-session",
+  /** The input failed validation before it was sent. */
+  InvalidInput: "invalid-input",
+  /** Relay's answer was not JSON or not the expected shape (kind `invalid-response`). */
+  InvalidResponse: "invalid-response",
+  /** The transport failed, before a response or while reading its body (kind `network`). */
+  Network: "network",
+  /** The client's deadline elapsed (kind `timeout`). */
+  Timeout: "timeout",
+  /** The caller cancelled the request (kind `aborted`). */
+  Aborted: "aborted",
+  /** A quest or collection the call named is not in the member's experience. */
+  NotFound: "not-found",
+  /** The quest has no failed attempt the member can retry. */
+  RetryUnavailable: "retry-unavailable",
+  /** Durable submission storage is missing, blocked or unreadable. */
+  SubmissionStorage: "submission-storage",
+  /** The saved submission is in a state that does not allow this action. */
+  SubmissionConflict: "submission-conflict",
+  /** The quest changed since the member saw it; review it before submitting again. */
+  QuestUpdated: "quest-updated",
+  /** The quiz changed since the member answered it. */
+  StaleQuiz: "stale-quiz",
+  /** Relay refused the submitted evidence. */
+  InvalidSubmission: "invalid-submission",
+  /** A page cursor Relay cannot read; start again from the first page. */
+  InvalidCursor: "invalid-cursor",
+  /** A wallet signer failed or the member refused to sign; `cause` is the wallet's own error. */
+  WalletSigner: "wallet-signer"
+};
+var relayErrorBrand = /* @__PURE__ */ Symbol.for("@domino-sdk/relay.RelayError");
+function isRelayError(value) {
+  return isRequestError(value) && value[relayErrorBrand] === true;
+}
+var RelayError = class extends RequestError {
+  name = "RelayError";
+  [relayErrorBrand] = true;
+  /** Prerequisite quests the member has not completed, when Relay refused for that reason. */
+  missing;
+  constructor(message, details) {
+    super(message, details);
+    this.missing = details.missing ?? [];
+  }
+};
+function clientError(message, code, details = {}) {
+  return new RelayError(message, { ...details, kind: "client", code });
+}
+function parseInput(schema, value) {
+  const parsed = schema.safeParse(value);
+  if (!parsed.success) {
+    throw clientError(
+      z3.prettifyError(parsed.error),
+      RelayErrorCode.InvalidInput,
+      { cause: parsed.error }
+    );
+  }
+  return parsed.data;
+}
+
+// src/profiles.ts
+import { z as z4 } from "zod";
+var count = z4.number().int().nonnegative().safe();
+var profileVisibilitySchema = z4.enum([
   "private",
   "participants",
   "public"
 ]);
-var avatarProviderSchema = z3.enum(["x", "discord", "google"]);
-var profileDefaultProviderSchema = z3.enum(["x", "discord"]);
-var profileDefaultsSchema = z3.array(profileDefaultProviderSchema).max(profileDefaultProviderSchema.options.length).refine(
+var avatarProviderSchema = z4.enum(["x", "discord", "google"]);
+var profileDefaultProviderSchema = z4.enum(["x", "discord"]);
+var profileDefaultsSchema = z4.array(profileDefaultProviderSchema).max(profileDefaultProviderSchema.options.length).refine(
   (providers) => new Set(providers).size === providers.length,
   "List each provider once"
 );
-var avatarSeedSchema = z3.string().min(1).max(100);
-var profileAvatarSchema = z3.discriminatedUnion("source", [
-  z3.object({
-    source: z3.literal("upload"),
-    url: z3.string().url(),
+var avatarSeedSchema = z4.string().min(1).max(100);
+var profileAvatarSchema = z4.discriminatedUnion("source", [
+  z4.object({
+    source: z4.literal("upload"),
+    url: z4.string().url(),
     seed: avatarSeedSchema
   }),
-  z3.object({
-    source: z3.literal("account"),
+  z4.object({
+    source: z4.literal("account"),
     provider: avatarProviderSchema,
-    url: z3.string().url(),
+    url: z4.string().url(),
     seed: avatarSeedSchema
   }),
-  z3.object({ source: z3.literal("generated"), seed: avatarSeedSchema })
+  z4.object({ source: z4.literal("generated"), seed: avatarSeedSchema })
 ]);
-var profileSummarySchema = z3.object({
+var profileSummarySchema = z4.object({
   id: identifier,
-  name: z3.string(),
+  name: z4.string(),
   avatar: profileAvatarSchema
 });
 var invisible = /[\p{Cc}؜᠎​-‏‪-‮⁠-⁤⁦-⁩]/u;
-var displayNameSchema = z3.string().max(200).transform((value) => value.normalize("NFC").replace(/\s+/g, " ").trim()).pipe(
-  z3.string().min(1, "Enter a name").max(40, "Use at most 40 characters").refine((value) => !invisible.test(value), "Use visible characters only")
+var displayNameSchema = z4.string().max(200).transform((value) => value.normalize("NFC").replace(/\s+/g, " ").trim()).pipe(
+  z4.string().min(1, "Enter a name").max(40, "Use at most 40 characters").refine((value) => !invisible.test(value), "Use visible characters only")
 );
-var profileUpdateSchema = z3.object({
+var profileUpdateSchema = z4.object({
   displayName: displayNameSchema.nullable().optional(),
-  avatar: z3.discriminatedUnion("source", [
-    z3.object({
-      source: z3.literal("account"),
+  avatar: z4.discriminatedUnion("source", [
+    z4.object({
+      source: z4.literal("account"),
       provider: avatarProviderSchema
     }).strict(),
-    z3.object({ source: z3.literal("generated") }).strict()
+    z4.object({ source: z4.literal("generated") }).strict()
   ]).nullable().optional(),
-  hidden: z3.boolean().optional()
+  hidden: z4.boolean().optional()
 }).strict().refine(
   (value) => Object.values(value).some((field) => field !== void 0),
   "Change at least one field"
 );
 var ownProfileSchema = profileSummarySchema.extend({
   /** The name the member chose, or null for the default. */
-  displayName: z3.string().nullable(),
+  displayName: z4.string().nullable(),
   /** The avatar the member chose: `default` follows the project's defaults. */
-  avatarChoice: z3.enum(["default", "upload", "account", "generated"]),
+  avatarChoice: z4.enum(["default", "upload", "account", "generated"]),
   /** The account of an `account` choice. */
   avatarProvider: avatarProviderSchema.nullable(),
-  hidden: z3.boolean(),
+  hidden: z4.boolean(),
   /** An operator locked the name and avatar; the member can still hide the profile. */
-  locked: z3.boolean(),
+  locked: z4.boolean(),
   /** Who can see profiles in this project, so the app can explain it. */
   visibility: profileVisibilitySchema,
   /** The member's connected accounts a picture or name can come from. */
-  options: z3.array(
-    z3.object({
+  options: z4.array(
+    z4.object({
       provider: avatarProviderSchema,
-      name: z3.string().nullable(),
-      imageUrl: z3.string().url().nullable()
+      name: z4.string().nullable(),
+      imageUrl: z4.string().url().nullable()
     })
   )
 });
-var cursor = z3.string().min(1).max(512);
-var profileCompletionQuerySchema = z3.object({
-  limit: z3.coerce.number().int().min(1).max(100).default(20),
+var cursor = z4.string().min(1).max(512);
+var profileCompletionQuerySchema = z4.object({
+  limit: z4.coerce.number().int().min(1).max(100).default(20),
   cursor: cursor.optional()
 }).strict();
-var profileCompletionSchema = z3.object({
+var profileCompletionSchema = z4.object({
   quest: identifier,
   key: identifier.optional(),
-  title: z3.string(),
+  title: z4.string(),
   completions: count.positive(),
   /** Null for completions recorded before completion times were. */
   lastCompletedAt: count.nullable()
 });
-var profileCompletionPageSchema = z3.object({
-  items: z3.array(profileCompletionSchema),
+var profileCompletionPageSchema = z4.object({
+  items: z4.array(profileCompletionSchema),
   nextCursor: cursor.nullable()
 });
-var profileReferralSchema = z3.object({
+var profileReferralSchema = z4.object({
   program: identifier,
   key: identifier.optional(),
-  title: z3.string(),
+  title: z4.string(),
   /** Members this member invited. Invitations are shared by every program. */
   invited: count,
   /** Invited members who qualified in this program. */
   qualified: count,
-  milestones: z3.array(
-    z3.object({ id: identifier, count, reached: z3.boolean() })
+  milestones: z4.array(
+    z4.object({ id: identifier, count, reached: z4.boolean() })
   )
 });
-var profileSettingsSchema = z3.object({
+var profileSettingsSchema = z4.object({
   visibility: profileVisibilitySchema,
   defaults: profileDefaultsSchema,
   revision: count,
-  actor: z3.string().nullable(),
+  actor: z4.string().nullable(),
   updatedAt: count.nullable()
 });
 var profileSettingsInputSchema = profileSettingsSchema.omit({ revision: true, actor: true, updatedAt: true }).extend({
   actionId: identifier,
   /** The revision the change was made against; a newer one is a 409. */
   expectedRevision: count,
-  reason: z3.string().trim().min(1).max(500)
+  reason: z4.string().trim().min(1).max(500)
 }).strict();
-var profileModerationSchema = z3.object({
+var profileModerationSchema = z4.object({
   actionId: identifier,
-  resetName: z3.boolean().default(false),
-  removeAvatar: z3.boolean().default(false),
+  resetName: z4.boolean().default(false),
+  removeAvatar: z4.boolean().default(false),
   /** True locks the name and avatar, false unlocks them. */
-  lock: z3.boolean().optional(),
-  reason: z3.string().trim().min(1).max(1e3)
+  lock: z4.boolean().optional(),
+  reason: z4.string().trim().min(1).max(1e3)
 }).strict().refine(
   (value) => value.resetName || value.removeAvatar || value.lock !== void 0,
   "Choose an action"
@@ -302,25 +394,25 @@ var profileModerationSchema = z3.object({
 var managedProfileSchema = ownProfileSchema.omit({ options: true }).extend({
   member: identifier,
   lockedAt: count.nullable(),
-  lockedBy: z3.string().nullable(),
-  lockedReason: z3.string().nullable(),
+  lockedBy: z4.string().nullable(),
+  lockedReason: z4.string().nullable(),
   updatedAt: count
 });
 var AVATAR_UPLOAD_LIMIT = 5 * 1024 * 1024;
 var avatarUploadTypes = ["image/jpeg", "image/png", "image/webp"];
 
 // src/leaderboards.ts
-import { z as z4 } from "zod";
-var integer = z4.number().int().safe();
+import { z as z5 } from "zod";
+var integer = z5.number().int().safe();
 var timestamp = integer.nonnegative().max(864e13);
-var leaderboardWindowSchema = z4.discriminatedUnion("kind", [
-  z4.object({ kind: z4.literal("all-time") }).strict(),
-  z4.object({ kind: z4.literal("fixed"), start: timestamp, end: timestamp }).strict().refine((w) => w.end > w.start, "Window end must follow its start"),
-  z4.object({ kind: z4.literal("rolling"), days: integer.min(1).max(3660) }).strict(),
-  z4.object({
-    kind: z4.literal("calendar"),
-    period: z4.enum(["day", "week", "month"]),
-    timeZone: z4.string().min(1).max(100).refine((zone) => {
+var leaderboardWindowSchema = z5.discriminatedUnion("kind", [
+  z5.object({ kind: z5.literal("all-time") }).strict(),
+  z5.object({ kind: z5.literal("fixed"), start: timestamp, end: timestamp }).strict().refine((w) => w.end > w.start, "Window end must follow its start"),
+  z5.object({ kind: z5.literal("rolling"), days: integer.min(1).max(3660) }).strict(),
+  z5.object({
+    kind: z5.literal("calendar"),
+    period: z5.enum(["day", "week", "month"]),
+    timeZone: z5.string().min(1).max(100).refine((zone) => {
       try {
         new Intl.DateTimeFormat("en", { timeZone: zone });
         return true;
@@ -332,45 +424,45 @@ var leaderboardWindowSchema = z4.discriminatedUnion("kind", [
 ]);
 var periodScore = {
   window: leaderboardWindowSchema.default({ kind: "all-time" }),
-  quests: z4.array(identifier).min(1).max(100).optional()
+  quests: z5.array(identifier).min(1).max(100).optional()
 };
-var leaderboardDefinitionSchema = z4.object({
+var leaderboardDefinitionSchema = z5.object({
   id: identifier,
   key: identifier.optional(),
-  title: z4.string().trim().min(1).max(120),
+  title: z5.string().trim().min(1).max(120),
   balance: identifier,
-  score: z4.discriminatedUnion("kind", [
-    z4.object({ kind: z4.literal("balance") }).strict(),
-    z4.object({ kind: z4.literal("earned"), ...periodScore }).strict(),
-    z4.object({
-      kind: z4.literal("net"),
+  score: z5.discriminatedUnion("kind", [
+    z5.object({ kind: z5.literal("balance") }).strict(),
+    z5.object({ kind: z5.literal("earned"), ...periodScore }).strict(),
+    z5.object({
+      kind: z5.literal("net"),
       window: leaderboardWindowSchema.default({ kind: "all-time" })
     }).strict()
   ]).default({ kind: "balance" }),
-  access: z4.enum(["participants", "public"]).default("participants"),
+  access: z5.enum(["participants", "public"]).default("participants"),
   group: identifier.optional()
 }).strict();
 var leaderboardAuthoringSchema = leaderboardDefinitionSchema.omit({ id: true }).extend(authoringIdentityShape).strict().superRefine(validateAuthoringIdentity).transform(normalizeAuthoringIdentity);
-var leaderboardArtifactSchema = z4.union([
+var leaderboardArtifactSchema = z5.union([
   leaderboardAuthoringSchema,
-  z4.object({ code: z4.string().min(1).max(2e6) }).strict()
+  z5.object({ code: z5.string().min(1).max(2e6) }).strict()
 ]);
-var publishedLeaderboardSchema = z4.object({
+var publishedLeaderboardSchema = z5.object({
   version: identifier,
   definition: leaderboardDefinitionSchema,
   publishedAt: timestamp,
-  actor: z4.string().nullable()
+  actor: z5.string().nullable()
 });
-var leaderboardQuerySchema = z4.object({
-  limit: z4.coerce.number().int().min(1).max(100).default(25),
-  cursor: z4.string().max(4096).optional()
+var leaderboardQuerySchema = z5.object({
+  limit: z5.coerce.number().int().min(1).max(100).default(25),
+  cursor: z5.string().max(4096).optional()
 }).strict();
-var leaderboardRowSchema = z4.object({
+var leaderboardRowSchema = z5.object({
   /** The row's stable key: a pseudonym per board and member. */
   participant: identifier,
   member: identifier.optional(),
   /** The profile's name where the viewer can see it, otherwise the pseudonym's. */
-  name: z4.string(),
+  name: z5.string(),
   score: integer,
   rank: integer.positive(),
   /**
@@ -379,31 +471,31 @@ var leaderboardRowSchema = z4.object({
    */
   profile: profileSummarySchema.nullable().default(null)
 });
-var leaderboardPageSchema = z4.object({
+var leaderboardPageSchema = z5.object({
   leaderboard: identifier,
-  title: z4.string(),
+  title: z5.string(),
   version: identifier,
-  calculation: z4.enum(["balance", "earned", "net"]),
-  period: z4.object({ start: timestamp.nullable(), end: timestamp.nullable() }),
+  calculation: z5.enum(["balance", "earned", "net"]),
+  period: z5.object({ start: timestamp.nullable(), end: timestamp.nullable() }),
   calculatedAt: timestamp,
   lastEntryAt: timestamp.nullable(),
   total: integer.nonnegative(),
-  items: z4.array(leaderboardRowSchema),
+  items: z5.array(leaderboardRowSchema),
   me: leaderboardRowSchema.nullable(),
-  nearby: z4.array(leaderboardRowSchema),
-  nextCursor: z4.string().nullable()
+  nearby: z5.array(leaderboardRowSchema),
+  nextCursor: z5.string().nullable()
 });
-var leaderboardPlacementSchema = z4.object({
+var leaderboardPlacementSchema = z5.object({
   leaderboard: identifier,
   key: identifier.optional(),
-  title: z4.string(),
+  title: z5.string(),
   profile: identifier,
   rank: integer.positive().nullable(),
   score: integer.nullable(),
   /** Ranked participants on the board. */
   total: integer.nonnegative()
 });
-var leaderboardPreviewSchema = z4.object({
+var leaderboardPreviewSchema = z5.object({
   published: publishedLeaderboardSchema,
   before: leaderboardPageSchema.nullable(),
   after: leaderboardPageSchema
@@ -412,111 +504,111 @@ var mutationBase = {
   actionId: identifier,
   member: identifier,
   balance: identifier,
-  reason: z4.string().trim().min(1).max(1e3)
+  reason: z5.string().trim().min(1).max(1e3)
 };
 var datedMutation = { ...mutationBase, effectiveAt: timestamp.optional() };
-var pointsMutationSchema = z4.discriminatedUnion("kind", [
-  z4.object({
+var pointsMutationSchema = z5.discriminatedUnion("kind", [
+  z5.object({
     ...datedMutation,
-    kind: z4.literal("award"),
-    referralEligible: z4.boolean().optional(),
+    kind: z5.literal("award"),
+    referralEligible: z5.boolean().optional(),
     amount: integer.positive()
   }).strict(),
-  z4.object({
+  z5.object({
     ...datedMutation,
-    kind: z4.literal("spend"),
+    kind: z5.literal("spend"),
     amount: integer.positive()
   }).strict(),
-  z4.object({
+  z5.object({
     ...datedMutation,
-    kind: z4.literal("adjust"),
+    kind: z5.literal("adjust"),
     amount: integer.refine((n) => n !== 0)
   }).strict(),
-  z4.object({
+  z5.object({
     ...datedMutation,
-    kind: z4.literal("set"),
+    kind: z5.literal("set"),
     total: integer.nonnegative(),
     expectedTotal: integer.nonnegative(),
-    classification: z4.enum(["earned", "spend"])
+    classification: z5.enum(["earned", "spend"])
   }).strict(),
-  z4.object({
+  z5.object({
     ...mutationBase,
-    kind: z4.literal("reverse"),
+    kind: z5.literal("reverse"),
     entry: identifier,
     amount: integer.positive()
   }).strict()
 ]);
-var pointsEntrySchema = z4.object({
+var pointsEntrySchema = z5.object({
   id: identifier,
-  completion: z4.string().nullable(),
+  completion: z5.string().nullable(),
   member: identifier,
   balance: identifier,
   amount: integer,
-  kind: z4.enum(["award", "spend", "adjust", "reverse"]),
+  kind: z5.enum(["award", "spend", "adjust", "reverse"]),
   effectiveAt: timestamp,
   receivedAt: timestamp,
   quest: identifier.nullable(),
   original: identifier.nullable(),
-  reason: z4.string(),
-  actor: z4.string().nullable()
+  reason: z5.string(),
+  actor: z5.string().nullable()
 });
-var pointsResultSchema = z4.object({
+var pointsResultSchema = z5.object({
   entry: pointsEntrySchema,
   total: integer.nonnegative()
 });
-var pointsAccountSchema = z4.object({
+var pointsAccountSchema = z5.object({
   member: identifier,
   balance: identifier,
   total: integer.nonnegative(),
   held: integer.nonnegative()
 });
-var leaderboardExclusionSchema = z4.object({
+var leaderboardExclusionSchema = z5.object({
   actionId: identifier,
   member: identifier,
-  excluded: z4.boolean(),
-  reason: z4.string().trim().min(1).max(1e3)
+  excluded: z5.boolean(),
+  reason: z5.string().trim().min(1).max(1e3)
 }).strict();
-var leaderboardGroupSchema = z4.object({
+var leaderboardGroupSchema = z5.object({
   actionId: identifier,
   member: identifier,
-  included: z4.boolean(),
-  reason: z4.string().trim().min(1).max(1e3)
+  included: z5.boolean(),
+  reason: z5.string().trim().min(1).max(1e3)
 }).strict();
 
 // src/referrals.ts
-import { z as z5 } from "zod";
-var rewardSchema = z5.union([pointsRewardSchema, tierRewardSchema]);
-var amount2 = z5.number().int().safe().nonnegative();
-var reason = z5.string().trim().min(1).max(1e3);
-var referralDefinitionSchema = z5.object({
+import { z as z6 } from "zod";
+var rewardSchema = z6.union([pointsRewardSchema, tierRewardSchema]);
+var amount2 = z6.number().int().safe().nonnegative();
+var reason = z6.string().trim().min(1).max(1e3);
+var referralDefinitionSchema = z6.object({
   id: identifier,
   key: identifier.optional(),
-  title: z5.string().trim().min(1).max(120),
-  enabled: z5.boolean().default(true),
-  qualification: z5.discriminatedUnion("kind", [
-    z5.object({ kind: z5.literal("signup") }).strict(),
-    z5.object({ kind: z5.literal("quest"), quest: identifier }).strict(),
-    z5.object({ kind: z5.literal("external") }).strict()
+  title: z6.string().trim().min(1).max(120),
+  enabled: z6.boolean().default(true),
+  qualification: z6.discriminatedUnion("kind", [
+    z6.object({ kind: z6.literal("signup") }).strict(),
+    z6.object({ kind: z6.literal("quest"), quest: identifier }).strict(),
+    z6.object({ kind: z6.literal("external") }).strict()
   ]),
   inviterGroup: identifier.optional(),
-  rewards: z5.object({
-    inviter: z5.array(rewardSchema).max(10).default([]),
-    invitee: z5.array(rewardSchema).max(10).default([])
+  rewards: z6.object({
+    inviter: z6.array(rewardSchema).max(10).default([]),
+    invitee: z6.array(rewardSchema).max(10).default([])
   }).strict().default({ inviter: [], invitee: [] }),
-  milestones: z5.array(
-    z5.object({
+  milestones: z6.array(
+    z6.object({
       id: identifier,
       count: amount2.min(1),
-      rewards: z5.array(rewardSchema).min(1).max(10)
+      rewards: z6.array(rewardSchema).min(1).max(10)
     }).strict()
   ).max(30).default([]),
-  bonuses: z5.array(
-    z5.object({
+  bonuses: z6.array(
+    z6.object({
       id: identifier,
       balance: identifier,
       basisPoints: amount2.min(1).max(1e4),
-      quests: z5.array(identifier).min(1).max(100).optional(),
-      external: z5.boolean().default(false),
+      quests: z6.array(identifier).min(1).max(100).optional(),
+      external: z6.boolean().default(false),
       durationDays: amount2.min(1).max(36500).optional(),
       maxPoints: amount2.min(1).optional()
     }).strict()
@@ -528,145 +620,145 @@ var referralDefinitionSchema = z5.object({
     }
   }
 });
-var referralAuthoringSchema = z5.object(referralDefinitionSchema.shape).omit({ id: true }).extend(authoringIdentityShape).strict().superRefine(validateAuthoringIdentity).superRefine((value, ctx) => {
+var referralAuthoringSchema = z6.object(referralDefinitionSchema.shape).omit({ id: true }).extend(authoringIdentityShape).strict().superRefine(validateAuthoringIdentity).superRefine((value, ctx) => {
   for (const entries of [value.milestones, value.bonuses]) {
     if (new Set(entries.map((entry) => entry.id)).size !== entries.length) {
       ctx.addIssue({ code: "custom", message: "Rule keys must be unique" });
     }
   }
 }).transform(normalizeAuthoringIdentity);
-var referralArtifactSchema = z5.union([
+var referralArtifactSchema = z6.union([
   referralAuthoringSchema,
-  z5.object({ code: z5.string().min(1).max(2e6) }).strict()
+  z6.object({ code: z6.string().min(1).max(2e6) }).strict()
 ]);
-var publishedReferralSchema = z5.object({
+var publishedReferralSchema = z6.object({
   version: identifier,
   definition: referralDefinitionSchema,
   publishedAt: amount2,
-  actor: z5.string().nullable()
+  actor: z6.string().nullable()
 });
-var referralAcceptSchema = z5.object({ actionId: identifier, code: identifier }).strict();
-var referralControlSchema = z5.discriminatedUnion("kind", [
-  z5.object({
-    kind: z5.literal("suspend"),
+var referralAcceptSchema = z6.object({ actionId: identifier, code: identifier }).strict();
+var referralControlSchema = z6.discriminatedUnion("kind", [
+  z6.object({
+    kind: z6.literal("suspend"),
     actionId: identifier,
     member: identifier,
-    suspended: z5.boolean(),
+    suspended: z6.boolean(),
     reason
   }).strict(),
-  z5.object({
-    kind: z5.literal("qualify"),
+  z6.object({
+    kind: z6.literal("qualify"),
     actionId: identifier,
     member: identifier,
     program: identifier,
-    qualified: z5.boolean(),
+    qualified: z6.boolean(),
     reason
   }).strict(),
-  z5.object({
-    kind: z5.literal("resolve-reward"),
+  z6.object({
+    kind: z6.literal("resolve-reward"),
     actionId: identifier,
     entitlement: identifier,
     reason
   }).strict()
 ]);
-var referralRelationshipSchema = z5.object({
+var referralRelationshipSchema = z6.object({
   member: identifier,
   inviter: identifier,
   acceptedAt: amount2,
-  suspended: z5.boolean()
+  suspended: z6.boolean()
 });
-var referralAccountSchema = z5.object({
+var referralAccountSchema = z6.object({
   id: identifier,
   program: identifier,
-  kind: z5.enum(["bonus", "fixed", "milestone"]),
+  kind: z6.enum(["bonus", "fixed", "milestone"]),
   balance: identifier,
   earned: amount2,
   settled: amount2,
   outstanding: amount2
 });
-var referralSummarySchema = z5.object({
+var referralSummarySchema = z6.object({
   code: identifier,
   attributed: amount2,
-  programs: z5.array(
-    z5.object({
+  programs: z6.array(
+    z6.object({
       definition: referralDefinitionSchema,
       qualified: amount2,
-      milestones: z5.array(
-        z5.object({ id: identifier, count: amount2, reached: z5.boolean() })
+      milestones: z6.array(
+        z6.object({ id: identifier, count: amount2, reached: z6.boolean() })
       )
     })
   ),
-  accounts: z5.array(referralAccountSchema)
+  accounts: z6.array(referralAccountSchema)
 });
-var referralHistorySchema = z5.object({
-  items: z5.array(
-    z5.object({
+var referralHistorySchema = z6.object({
+  items: z6.array(
+    z6.object({
       id: amount2,
       program: identifier,
       balance: identifier,
-      amount: z5.number().int().safe(),
+      amount: z6.number().int().safe(),
       at: amount2,
-      reason: z5.string()
+      reason: z6.string()
     })
   ),
-  next: amount2.nullable()
+  nextCursor: pageCursorSchema.nullable()
 });
-var referralManagementSchema = z5.object({
-  relationships: z5.array(referralRelationshipSchema),
-  qualifications: z5.array(
-    z5.object({
+var referralManagementSchema = z6.object({
+  relationships: z6.array(referralRelationshipSchema),
+  qualifications: z6.array(
+    z6.object({
       member: identifier,
       program: identifier,
-      qualified: z5.boolean(),
+      qualified: z6.boolean(),
       qualifiedAt: amount2
     })
   ),
-  accounts: z5.array(
-    referralAccountSchema.extend({ member: identifier, invitee: z5.string() })
+  accounts: z6.array(
+    referralAccountSchema.extend({ member: identifier, invitee: z6.string() })
   ),
-  reviews: z5.array(
-    z5.object({
+  reviews: z6.array(
+    z6.object({
       entitlement: identifier,
       member: identifier,
       program: identifier,
-      reason: z5.string()
+      reason: z6.string()
     })
   ),
   next: amount2.nullable()
 });
 
 // src/wallet.ts
-import { z as z6 } from "zod";
-var solanaAddressSchema = z6.string().min(32).max(44).regex(/^[1-9A-HJ-NP-Za-km-z]+$/);
-var walletConnectionSchema = z6.object({
-  chain: z6.literal("solana"),
+import { z as z7 } from "zod";
+var solanaAddressSchema = z7.string().min(32).max(44).regex(/^[1-9A-HJ-NP-Za-km-z]+$/);
+var walletConnectionSchema = z7.object({
+  chain: z7.literal("solana"),
   address: solanaAddressSchema,
-  verifiedAt: z6.number().int().nonnegative(),
-  revision: z6.number().int().positive()
+  verifiedAt: z7.number().int().nonnegative(),
+  revision: z7.number().int().positive()
 }).strict();
-var walletChallengeInputSchema = z6.object({
-  chain: z6.literal("solana"),
+var walletChallengeInputSchema = z7.object({
+  chain: z7.literal("solana"),
   address: solanaAddressSchema
 }).strict();
 var walletChallengeSchema = walletChallengeInputSchema.extend({
-  id: z6.string().uuid(),
-  message: z6.string(),
-  expiresAt: z6.number()
+  id: z7.string().uuid(),
+  message: z7.string(),
+  expiresAt: z7.number()
 });
-var walletProofSchema = z6.object({
-  challenge: z6.string().uuid(),
-  signature: z6.string().min(64).max(88).regex(/^[1-9A-HJ-NP-Za-km-z]+$/)
+var walletProofSchema = z7.object({
+  challenge: z7.string().uuid(),
+  signature: z7.string().min(64).max(88).regex(/^[1-9A-HJ-NP-Za-km-z]+$/)
 }).strict();
-var solanaBalanceSchema = z6.object({
+var solanaBalanceSchema = z7.object({
   address: solanaAddressSchema,
-  network: z6.literal("mainnet-beta"),
-  lamports: z6.string().regex(/^(0|[1-9][0-9]*)$/),
-  slot: z6.number().int().nonnegative().safe(),
-  observedAt: z6.number().int().nonnegative()
+  network: z7.literal("mainnet-beta"),
+  lamports: z7.string().regex(/^(0|[1-9][0-9]*)$/),
+  slot: z7.number().int().nonnegative().safe(),
+  observedAt: z7.number().int().nonnegative()
 }).strict();
-var walletChainSchema = z6.enum(["solana", "eip155", "cosmos"]);
+var walletChainSchema = z7.enum(["solana", "eip155", "cosmos"]);
 var cosmosNetworkPattern = /^cosmos:[-_a-zA-Z0-9]{1,32}$/;
-var cosmosNetworkSchema = z6.custom(
+var cosmosNetworkSchema = z7.custom(
   (value) => typeof value === "string" && cosmosNetworkPattern.test(value),
   "Use a Cosmos network: cosmos:<chain ID>"
 );
@@ -692,51 +784,51 @@ function cosmosChain(chain) {
   return { ...value, network };
 }
 var solanaMainnet = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
-var evmAddressSchema = z6.string().regex(/^0x[0-9a-fA-F]{40}$/);
-var cosmosAddressSchema = z6.string().min(8).max(90).regex(
+var evmAddressSchema = z7.string().regex(/^0x[0-9a-fA-F]{40}$/);
+var cosmosAddressSchema = z7.string().min(8).max(90).regex(
   /^(?:[a-z][a-z0-9]{0,82}1[02-9ac-hj-np-z]{38,}|[A-Z][A-Z0-9]{0,82}1[02-9AC-HJ-NP-Z]{38,})$/
 );
-var walletAddressInputSchema = z6.discriminatedUnion("chain", [
-  z6.object({ chain: z6.literal("solana"), address: solanaAddressSchema }).strict(),
-  z6.object({
-    chain: z6.literal("eip155"),
+var walletAddressInputSchema = z7.discriminatedUnion("chain", [
+  z7.object({ chain: z7.literal("solana"), address: solanaAddressSchema }).strict(),
+  z7.object({
+    chain: z7.literal("eip155"),
     address: evmAddressSchema,
     /** Shown in the sign-in message's Chain ID line only: links are chain-agnostic. Defaults to 1. */
-    chainId: z6.number().int().positive().safe().optional()
+    chainId: z7.number().int().positive().safe().optional()
   }).strict(),
-  z6.object({
-    chain: z6.literal("cosmos"),
+  z7.object({
+    chain: z7.literal("cosmos"),
     network: cosmosNetworkSchema,
     address: cosmosAddressSchema
   }).strict()
 ]);
-var walletMessageChallengeSchema = z6.object({
-  id: z6.string().min(1).max(200),
-  purpose: z6.enum(["link", "sign-in"]),
+var walletMessageChallengeSchema = z7.object({
+  id: z7.string().min(1).max(200),
+  purpose: z7.enum(["link", "sign-in"]),
   chain: walletChainSchema,
   network: cosmosNetworkSchema.nullable(),
   /** Canonical (base58, EIP-55 or lowercase bech32). The signer must sign with this address. */
-  address: z6.string(),
-  message: z6.string().max(4096),
-  expiresAt: z6.number().int()
+  address: z7.string(),
+  message: z7.string().max(4096),
+  expiresAt: z7.number().int()
 });
-var walletSignatureSchema = z6.object({
-  challenge: z6.string().min(1).max(200),
+var walletSignatureSchema = z7.object({
+  challenge: z7.string().min(1).max(200),
   /** solana: base58, 64 bytes · eip155: 0x and 130 hex digits (65 bytes) · cosmos: base64, 64 bytes (r‖s) */
-  signature: z6.string().min(1).max(256),
+  signature: z7.string().min(1).max(256),
   /** cosmos only: the base64 33-byte compressed secp256k1 key from signArbitrary's pub_key.value */
-  publicKey: z6.string().max(128).optional()
+  publicKey: z7.string().max(128).optional()
 }).strict();
-var linkedWalletSchema = z6.object({
+var linkedWalletSchema = z7.object({
   chain: walletChainSchema,
   network: cosmosNetworkSchema.nullable(),
-  address: z6.string(),
-  verifiedAt: z6.number().int().nonnegative(),
-  revision: z6.number().int().positive(),
+  address: z7.string(),
+  verifiedAt: z7.number().int().nonnegative(),
+  revision: z7.number().int().positive(),
   /** True when this wallet can sign in: it was first used through wallet sign-in. Linking never enables sign-in. */
-  signIn: z6.boolean()
+  signIn: z7.boolean()
 });
-var walletUnlinkInputSchema = z6.object({ chain: walletChainSchema, address: z6.string().min(1).max(100) }).strict();
+var walletUnlinkInputSchema = z7.object({ chain: walletChainSchema, address: z7.string().min(1).max(100) }).strict();
 async function walletAddressInput(signer) {
   const address = await signer.address();
   switch (signer.chain) {
@@ -750,17 +842,20 @@ async function walletAddressInput(signer) {
       };
     case "cosmos":
       if (!signer.network) {
-        throw new Error("Choose the Cosmos chain for this wallet");
+        throw clientError(
+          "Choose the Cosmos chain for this wallet",
+          RelayErrorCode.InvalidInput
+        );
       }
       return { chain: "cosmos", network: signer.network, address };
   }
 }
 var WALLETS_PER_CHAIN = 5;
 var walletSignInFamilies = ["solana", "eip155", "cosmos"];
-var walletSignInNetworkSchema = z6.union([z6.enum(walletSignInFamilies), z6.string().regex(cosmosNetworkPattern)]).transform(
+var walletSignInNetworkSchema = z7.union([z7.enum(walletSignInFamilies), z7.string().regex(cosmosNetworkPattern)]).transform(
   (value) => value.startsWith("cosmos:") ? "cosmos" : value
 );
-var walletSignInNetworksSchema = z6.array(walletSignInNetworkSchema).transform(
+var walletSignInNetworksSchema = z7.array(walletSignInNetworkSchema).transform(
   (values) => walletSignInFamilies.filter((family) => values.includes(family))
 );
 function walletSignInNetwork(wallet) {
@@ -783,24 +878,24 @@ function caip10(wallet, network) {
 function isEvmChainId(value) {
   return /^eip155:[1-9][0-9]{0,15}$/.test(value);
 }
-var evmChainIdSchema = z6.custom(
+var evmChainIdSchema = z7.custom(
   (value) => typeof value === "string" && isEvmChainId(value),
   'Use an EVM chain ID such as "eip155:8453"'
 );
-var units = z6.string().regex(/^(0|[1-9][0-9]*)$/);
-var walletBalanceSchema = z6.object({
+var units = z7.string().regex(/^(0|[1-9][0-9]*)$/);
+var walletBalanceSchema = z7.object({
   /** Canonical CAIP-2 ID: `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp` or `eip155:<chain ID>`. */
-  chain: z6.string(),
+  chain: z7.string(),
   /** The canonical mint (base58) or EIP-55 contract address; null for the native coin. */
-  token: z6.string().nullable(),
+  token: z7.string().nullable(),
   /** Null only for an ERC-20 contract without `decimals()`. */
-  decimals: z6.number().int().min(0).max(255).nullable(),
+  decimals: z7.number().int().min(0).max(255).nullable(),
   /** The sum over `wallets`. */
   total: units,
-  wallets: z6.array(z6.object({ address: z6.string(), amount: units }).strict()),
+  wallets: z7.array(z7.object({ address: z7.string(), amount: units }).strict()),
   /** Solana: the lowest slot the reads saw. EVM: the latest block when the read started (approximate). */
-  at: z6.object({ kind: z6.enum(["slot", "block"]), number: units }).strict(),
-  observedAt: z6.number().int().nonnegative()
+  at: z7.object({ kind: z7.enum(["slot", "block"]), number: units }).strict(),
+  observedAt: z7.number().int().nonnegative()
 }).strict();
 
 export {
@@ -824,6 +919,13 @@ export {
   engagementBoundaryPageSchema,
   engagementArtifactSchema,
   engagementDeploymentEntrySchema,
+  isRequestError,
+  RequestError,
+  RelayErrorCode,
+  isRelayError,
+  RelayError,
+  clientError,
+  parseInput,
   profileVisibilitySchema,
   avatarProviderSchema,
   profileDefaultProviderSchema,