@domino-sdk/relay 1.5.2 → 1.7.0

package/dist/browser.js

@@ -11,14 +11,14 @@ import {
   signInOptions,
   solanaSigner,
   walletStandardSolanaSigner
-} from "./chunk-24AFCBZN.js";
-import "./chunk-DGWMLN35.js";
-import "./chunk-EYH5RDIE.js";
-import "./chunk-36HTX2BM.js";
+} from "./chunk-BFZHJA2B.js";
+import "./chunk-ZOUEEK5L.js";
+import "./chunk-C25TDFHN.js";
+import "./chunk-GMPPLZKH.js";
 import "./chunk-6QJ3LADK.js";
 import "./chunk-NPGENI7K.js";
-import "./chunk-XFMSUPNS.js";
-import "./chunk-JON5SESL.js";
+import "./chunk-6ON4RMEN.js";
+import "./chunk-KGJSKGKI.js";
 export {
   browserSubmissionStore,
   cosmosChainList,

package/dist/{capability-error-DNMwKmlL.d.ts → capability-error-Bv996M-h.d.ts}

@@ -45,6 +45,7 @@ declare const resourceOptionsSchema: z.ZodObject<{
         group: z.ZodOptional<z.ZodString>;
         disabledReason: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
+    nextCursor: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     cursor: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 type ResourceOption = z.infer<typeof resourceOptionsSchema>["options"][number];
@@ -403,6 +404,7 @@ type ProjectIntegration = z.infer<typeof projectIntegrationSchema>;
  * Later versions can add codes. Treat an unknown code as a failure its `message` explains.
  */
 declare const capabilityErrorCodes: readonly ["not-linked", "provider-unavailable", "author-error"];
+/** @compat open */
 type KnownCapabilityErrorCode = (typeof capabilityErrorCodes)[number];
 /** A known code, or one a newer Relay added. */
 type CapabilityErrorCode = KnownCapabilityErrorCode | (string & {});

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

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

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

@@ -4,15 +4,15 @@ import {
   imageFieldsSchema,
   imageInspectionSchema,
   imageSightingsSchema
-} from "./chunk-BGGKNIRP.js";
+} from "./chunk-JW4G3SY5.js";
 import {
   authScopeSchema
-} from "./chunk-XFMSUPNS.js";
+} from "./chunk-6ON4RMEN.js";
 import {
   appIdentityKindSchema,
   openIdentityKindSchema,
   photoResultSchema
-} from "./chunk-JON5SESL.js";
+} from "./chunk-KGJSKGKI.js";
 
 // src/configuration.ts
 function questConfiguration(release) {
@@ -138,6 +138,24 @@ function parseImageResult(request, value) {
 import { z as z3 } from "zod";
 var sequenceCursorSchema = z3.string().regex(/^[1-9][0-9]{0,15}$/, "Invalid cursor").transform(Number).pipe(z3.number().int().positive().safe());
 
+// src/referral-reward-kinds.ts
+var REFERRAL_INTEGRATION_REWARD_ERROR = "Referral programs can grant points and tiered rewards; Discord roles need a quest";
+var isRecord = (value) => typeof value === "object" && value !== null;
+function containsReferralIntegrationReward(value) {
+  if (Array.isArray(value)) {
+    return value.some(
+      (reward) => isRecord(reward) && reward.kind === "integration"
+    );
+  }
+  if (!isRecord(value)) {
+    return false;
+  }
+  const definition = isRecord(value.definition) ? value.definition : value;
+  return isRecord(definition.rewards) && (containsReferralIntegrationReward(definition.rewards.inviter) || containsReferralIntegrationReward(definition.rewards.invitee)) || Array.isArray(definition.milestones) && definition.milestones.some(
+    (milestone) => isRecord(milestone) && containsReferralIntegrationReward(milestone.rewards)
+  );
+}
+
 export {
   questConfiguration,
   identityIntegrationInputSchema,
@@ -147,5 +165,7 @@ export {
   participantExchangeSchema,
   parseImageExtraction,
   parseImageResult,
-  sequenceCursorSchema
+  sequenceCursorSchema,
+  REFERRAL_INTEGRATION_REWARD_ERROR,
+  containsReferralIntegrationReward
 };

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

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

package/dist/{chunk-VFHHLN6A.js → chunk-6RBF3UDA.js}

@@ -1,13 +1,13 @@
 import {
   imageAssetArtifactSchema,
   publishedImageSchema
-} from "./chunk-BGGKNIRP.js";
+} from "./chunk-JW4G3SY5.js";
 import {
   catalogDeploymentSchema,
   interactionSchema,
   questCollectionSchema,
   questTypeVersionSchema
-} from "./chunk-EYH5RDIE.js";
+} from "./chunk-C25TDFHN.js";
 import {
   engagementArtifactSchema,
   engagementDeploymentEntrySchema,
@@ -19,8 +19,9 @@ import {
   pointLedgerSchema,
   publishedReferralSchema,
   referralArtifactSchema
-} from "./chunk-36HTX2BM.js";
+} from "./chunk-GMPPLZKH.js";
 import {
+  attemptSchema,
   identifier,
   pageCursorSchema,
   projectCalendarDeclarationSchema,
@@ -31,7 +32,7 @@ import {
   rewardSchema,
   timeZoneNameSchema,
   trackerArtifactSchema
-} from "./chunk-JON5SESL.js";
+} from "./chunk-KGJSKGKI.js";
 
 // src/deployments.ts
 import { z } from "zod";
@@ -126,6 +127,10 @@ var rejectDeploymentSchema = z.object({
   id: identifier,
   reason: z.string().trim().min(1).max(1e3)
 }).strict();
+var deploymentRejectionSchema = rejectDeploymentSchema.omit({
+  id: true
+});
+var deploymentActionSchema = z.object({ actionId: z.string().uuid() }).strict();
 var repeatableDeploymentSchema = z.object({ actionId: z.string().uuid(), id: identifier }).strict();
 var promoteDeploymentSchema = repeatableDeploymentSchema;
 var rollbackDeploymentSchema = repeatableDeploymentSchema;
@@ -168,7 +173,13 @@ var automaticEventResponseSchema = z3.union([
     kind: z3.string().refine((kind) => !knownEventKinds.has(kind))
   }).catchall(z3.json())
 ]);
-var automaticOutcomeSchema = z3.object({
+var automaticLinkedAttemptSchema = z3.object({
+  id: identifier,
+  status: attemptSchema.shape.status,
+  /** Open code for the linked attempt. Consumers must tolerate new values. */
+  code: z3.string().nullable()
+});
+var automaticOutcomeFields = {
   id: identifier,
   quest: identifier,
   member: identifier,
@@ -177,11 +188,39 @@ var automaticOutcomeSchema = z3.object({
   state: z3.enum(["admitted", "skipped"]),
   code: z3.string().nullable(),
   reason: z3.string().nullable(),
-  attempt: identifier.nullable(),
+  /** Which window refused admission when `code` is `outside-window`. */
+  window: z3.enum(["tracker", "quest"]).optional(),
   revision: z3.number().int().nonnegative(),
   createdAt: z3.number().int().safe(),
   updatedAt: z3.number().int().safe()
+};
+var automaticOutcomeWithoutAttemptSchema = z3.object({
+  ...automaticOutcomeFields,
+  /** @deprecated Use `linkedAttempt` instead. Removed in 2.0.0. */
+  attempt: z3.null(),
+  /** Current linked attempt. Optional so responses from older Relay versions remain readable. */
+  linkedAttempt: z3.null().optional()
 });
+var automaticOutcomeWithAttemptSchema = z3.object({
+  ...automaticOutcomeFields,
+  /** @deprecated Use `linkedAttempt` instead. Removed in 2.0.0. */
+  attempt: identifier,
+  /** Current linked attempt. Optional so responses from older Relay versions remain readable. */
+  linkedAttempt: automaticLinkedAttemptSchema.nullable().optional()
+}).superRefine((outcome, context) => {
+  if (outcome.linkedAttempt !== null && outcome.linkedAttempt !== void 0 && outcome.linkedAttempt.id !== outcome.attempt) {
+    context.addIssue({
+      code: "custom",
+      path: ["linkedAttempt", "id"],
+      message: "Linked attempt ID must match the legacy attempt ID"
+    });
+  }
+});
+var automaticOutcomeSchema = z3.union([
+  automaticOutcomeWithoutAttemptSchema,
+  automaticOutcomeWithAttemptSchema
+]);
+var isRetryableAutomaticOutcome = (outcome) => outcome.linkedAttempt?.status === "rejected" && outcome.linkedAttempt.code === "budget-exhausted";
 var automaticOutcomeQuerySchema = z3.strictObject({
   quest: identifier.optional(),
   member: identifier.optional(),
@@ -206,6 +245,7 @@ var automaticCatchUpPreviewSchema = z3.object({
       outcome: automaticOutcomeSchema,
       code: z3.string().nullable(),
       reason: z3.string().nullable(),
+      window: z3.enum(["tracker", "quest"]).optional(),
       attempt: identifier.nullable(),
       wouldAdmit: z3.boolean(),
       budgets: z3.array(questBudgetViewSchema)
@@ -265,12 +305,15 @@ export {
   deploymentRecordSchema,
   submitDeploymentSchema,
   rejectDeploymentSchema,
+  deploymentRejectionSchema,
+  deploymentActionSchema,
   promoteDeploymentSchema,
   rollbackDeploymentSchema,
   activityTypes,
   activityTypeSchema,
   automaticEventSchema,
   automaticOutcomeSchema,
+  isRetryableAutomaticOutcome,
   automaticOutcomeQuerySchema,
   automaticOutcomePageSchema,
   automaticCatchUpInputSchema,

package/dist/chunk-AXRMT33W.js

@@ -0,0 +1,112 @@
+// src/participant-routes.ts
+var id = "{[\\w-]+}";
+var participantRoutes = [
+  // Sign-in, the session and connected accounts. Integrations reach /v1/auth/start in connect
+  // mode only (Relay checks the mode).
+  { method: "GET", path: "/v1/auth/providers", hostedOnly: true },
+  { method: "POST", path: "/v1/auth/start" },
+  { method: "GET", path: "/v1/auth/authorize", hostedOnly: true },
+  {
+    method: "GET",
+    path: "/v1/auth/callback/:provider{[a-z][a-z0-9-]*}",
+    hostedOnly: true
+  },
+  { method: "GET", path: "/v1/auth/complete" },
+  { method: "POST", path: "/v1/auth/email/start", hostedOnly: true },
+  { method: "POST", path: "/v1/auth/email/verify", hostedOnly: true },
+  { method: "POST", path: "/v1/auth/wallet/start", hostedOnly: true },
+  { method: "POST", path: "/v1/auth/wallet/verify", hostedOnly: true },
+  { method: "GET", path: "/v1/auth/session" },
+  { method: "POST", path: "/v1/auth/logout" },
+  { method: "GET", path: "/v1/auth/accounts" },
+  { method: "POST", path: "/v1/auth/accounts/disconnect" },
+  // The signed-in member: progress, submissions, rewards, points, activity and linked wallets.
+  { method: "GET", path: "/v1/me" },
+  { method: "GET", path: "/v1/me/progress" },
+  { method: "GET", path: "/v1/me/experience" },
+  { method: "POST", path: "/v1/me/attempts" },
+  { method: "POST", path: `/v1/attempts/:attempt${id}/retry` },
+  { method: "POST", path: "/v1/me/evidence" },
+  { method: "POST", path: "/v1/me/collection-pass" },
+  { method: "GET", path: "/v1/me/entitlements" },
+  { method: "GET", path: "/v1/me/deliveries" },
+  { method: "GET", path: "/v1/me/points" },
+  { method: "GET", path: `/v1/me/points/:ledger${id}/history` },
+  { method: "GET", path: "/v1/me/activity" },
+  { method: "GET", path: "/v1/me/wallets" },
+  { method: "POST", path: "/v1/me/wallets/challenge" },
+  { method: "POST", path: "/v1/me/wallets/verify" },
+  { method: "POST", path: "/v1/me/wallets/unlink" },
+  // Profiles: the member's own, and the reads keyed by a public profile ID.
+  { method: "GET", path: "/v1/me/profile" },
+  { method: "POST", path: "/v1/me/profile" },
+  { method: "POST", path: "/v1/me/profile/avatar" },
+  { method: "GET", path: `/v1/profiles/:profile${id}` },
+  { method: "GET", path: `/v1/profiles/:profile${id}/completions` },
+  {
+    method: "GET",
+    path: `/v1/profiles/:profile${id}/referrals/:program${id}`
+  },
+  {
+    method: "GET",
+    path: `/v1/leaderboards/:board${id}/profiles/:profile${id}`
+  },
+  // Quest and campaign enrollment, automatic-quest outcomes and historical claims.
+  { method: "POST", path: "/v1/quests/enrollments" },
+  { method: "POST", path: "/v1/quests/claims" },
+  { method: "GET", path: "/v1/quests/outcomes" },
+  { method: "POST", path: "/v1/campaigns/enrollments" },
+  { method: "POST", path: "/v1/campaigns/enrollments/withdraw" },
+  // Content stages and engagement.
+  { method: "GET", path: "/v1/content/qualifications" },
+  { method: "GET", path: "/v1/content/performance" },
+  { method: "GET", path: "/v1/engagement/history" },
+  { method: "GET", path: "/v1/engagement/boundaries" },
+  // Referrals, offers, reward deliveries, leaderboards and the project's reference lists.
+  { method: "GET", path: "/v1/referrals" },
+  { method: "GET", path: "/v1/referrals/me" },
+  { method: "GET", path: "/v1/referrals/history" },
+  { method: "POST", path: "/v1/referrals/accept" },
+  { method: "GET", path: "/v1/offers" },
+  { method: "POST", path: `/v1/offers/:offer${id}/redeem` },
+  { method: "GET", path: "/v1/reward-deliveries" },
+  { method: "GET", path: "/v1/leaderboards" },
+  { method: "GET", path: `/v1/leaderboards/:board${id}` },
+  { method: "GET", path: "/v1/point-ledgers" },
+  { method: "GET", path: "/v1/tiered-rewards" }
+];
+function participantRoutePattern(path) {
+  const parts = path.split(/:\w+\{([^}]+)\}/);
+  const source = parts.map((part, index) => {
+    if (index % 2 === 0) {
+      if (/[:{}]/.test(part)) {
+        throw new Error(`${path}: write each parameter as :name{pattern}`);
+      }
+      return part.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    }
+    if (part.includes("/") || new RegExp(`^(?:${part})$`).test("/")) {
+      throw new Error(`${path}: a parameter pattern cannot match "/"`);
+    }
+    return `(?:${part})`;
+  });
+  return new RegExp("^" + source.join("") + "$");
+}
+var compiled = participantRoutes.map((route) => ({
+  ...route,
+  pattern: participantRoutePattern(route.path)
+}));
+function isParticipantRoute(path, method) {
+  return compiled.some(
+    (route) => route.method === method && route.pattern.test(path)
+  );
+}
+function isIntegrationParticipantPath(path) {
+  return compiled.some((route) => !route.hostedOnly && route.pattern.test(path));
+}
+
+export {
+  participantRoutes,
+  participantRoutePattern,
+  isParticipantRoute,
+  isIntegrationParticipantPath
+};

package/dist/{chunk-24AFCBZN.js → chunk-BFZHJA2B.js}

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

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

@@ -1,6 +1,6 @@
 import {
   pointLedgerReferenceSchema
-} from "./chunk-36HTX2BM.js";
+} from "./chunk-GMPPLZKH.js";
 import {
   authoringIdentityShape,
   entitlementSchema,
@@ -16,7 +16,7 @@ import {
   storedQuestDescriptionSchema,
   storedReviewModeSchema,
   tieredRewardReferenceSchema
-} from "./chunk-JON5SESL.js";
+} from "./chunk-KGJSKGKI.js";
 
 // src/participant-activity.ts
 import { z } from "zod";
@@ -307,6 +307,8 @@ var questOutcomeSchema = z4.object({
   code: z4.string().nullable(),
   /** Why it was skipped, for people; null when admitted. */
   reason: z4.string().nullable(),
+  /** Which window refused admission when `code` is `outside-window`. */
+  window: z4.enum(["tracker", "quest"]).optional(),
   /** The admitted attempt. */
   attempt: identifier.nullable(),
   /** The member can claim it with `relay.quests.claim()`. */

package/dist/{chunk-36HTX2BM.js → chunk-GMPPLZKH.js}

@@ -14,7 +14,7 @@ import {
   resourceHandle,
   rewardKey,
   tierRewardSchema
-} from "./chunk-JON5SESL.js";
+} from "./chunk-KGJSKGKI.js";
 
 // src/point-ledgers.ts
 import { z } from "zod";
@@ -180,10 +180,25 @@ var engagementChangePreviewSchema = z2.strictObject({
     pending: total
   })
 });
-var engagementVersionPageSchema = z2.strictObject({
+var engagementVersionSchema = engagementRuleSchema.extend({
+  previousVersion: identifier.nullable()
+});
+var engagementRuleVersionPageSchema = z2.object({
   items: z2.array(
-    engagementRuleSchema.extend({ previousVersion: identifier.nullable() })
+    z2.object({
+      version: identifier,
+      definition: z2.object({
+        ...engagementDefinitionSchema.shape,
+        budgets: z2.array(z2.object(engagementBudgetSchema.shape)).max(8).default([])
+      }),
+      publishedAt: amount,
+      previousVersion: identifier.nullable()
+    })
   ),
+  nextCursor: pageCursorSchema.nullable()
+});
+var engagementVersionPageSchema = z2.strictObject({
+  items: z2.array(engagementVersionSchema),
   next: amount.nullable()
 });
 var engagementVersionQuerySchema = z2.strictObject({
@@ -280,7 +295,25 @@ var RelayErrorCode = {
   /** The participant's available point balance is below the offer price. */
   InsufficientPoints: "insufficient-points",
   /** A wallet signer failed or the member refused to sign; `cause` is the wallet's own error. */
-  WalletSigner: "wallet-signer"
+  WalletSigner: "wallet-signer",
+  /** The member has not met the quest's prerequisites; `missing` lists them. */
+  PrerequisitesIncomplete: "prerequisites-incomplete",
+  /** The quest is archived or retired: it takes no new participation. */
+  QuestClosed: "quest-closed",
+  /** An operator paused the quest. */
+  QuestPaused: "quest-paused",
+  /** An operator locked the member's profile; hiding it is still allowed. */
+  ProfileLocked: "profile-locked",
+  /** No member in the project has the invitation code the member accepted. */
+  InvitationNotFound: "invitation-not-found",
+  /** The email sign-in code is wrong; the member can type it again. */
+  InvalidCode: "invalid-code",
+  /** The email sign-in code expired, was used or had too many attempts; request another. */
+  CodeExpired: "code-expired",
+  /** The wallet sign-in challenge expired, was used or changed; start sign-in again. */
+  ChallengeExpired: "challenge-expired",
+  /** Too many requests; `retryAfter` says how long to wait when Relay knows. */
+  RateLimited: "rate-limited"
 };
 var relayErrorBrand = /* @__PURE__ */ Symbol.for("@domino-sdk/relay.RelayError");
 function isRelayError(value) {
@@ -289,10 +322,13 @@ function isRelayError(value) {
 var RelayError = class extends RequestError {
   name = "RelayError";
   [relayErrorBrand] = true;
+  /** Which window refused admission when `code` is `outside-window`. */
+  window;
   /** Prerequisites the member does not currently meet, when Relay refused for that reason. */
   missing;
   constructor(message, details) {
     super(message, details);
+    this.window = details.window;
     this.missing = details.missing ?? [];
   }
 };
@@ -653,6 +689,12 @@ var pointsEntrySchema = z5.object({
   reason: z5.string(),
   actor: z5.string().nullable()
 });
+var managedPointHistoryPageSchema = z5.object({
+  items: z5.array(pointsEntrySchema),
+  nextCursor: pageCursorSchema.nullable(),
+  /** @deprecated Use `nextCursor`, passed back as `cursor`. Removed in 2.0.0. */
+  next: z5.number().nullable()
+});
 var pointsResultSchema = z5.object({
   entry: pointsEntrySchema,
   total: integer.nonnegative()
@@ -778,6 +820,9 @@ var publishedReferralSchema = z6.object({
   actor: z6.string().nullable()
 });
 var referralAcceptSchema = z6.object({ actionId: identifier, code: identifier }).strict();
+var referralSuspensionSchema = z6.object({ actionId: identifier, suspended: z6.boolean(), reason }).strict();
+var referralQualificationSchema = z6.object({ actionId: identifier, qualified: z6.boolean(), reason }).strict();
+var referralRewardResolutionSchema = z6.object({ actionId: identifier, reason }).strict();
 var referralControlSchema = z6.discriminatedUnion("kind", [
   z6.object({
     kind: z6.literal("suspend"),
@@ -864,6 +909,8 @@ var referralManagementSchema = z6.object({
       reason: z6.string()
     })
   ),
+  nextCursor: pageCursorSchema.nullable().default(null),
+  /** @deprecated Use `nextCursor`, passed back as `cursor`. Removed in 2.0.0. */
   next: amount2.nullable()
 });
 
@@ -913,6 +960,11 @@ var redemptionBase = {
   id: identifier,
   offer: identifier,
   member: identifier,
+  /**
+   * @deprecated Use `id` to refer to a redemption. A redemption is fulfilled in the request that
+   * makes it, so nothing is reserved beforehand; the ID refers to no other record. Removed in
+   * 2.0.0.
+   */
   reservation: identifier,
   price: offerPriceSchema,
   reward: tierRewardSchema,
@@ -1119,6 +1171,7 @@ export {
   engagementChangePreviewInputSchema,
   engagementChangeSchema,
   engagementChangePreviewSchema,
+  engagementRuleVersionPageSchema,
   engagementVersionPageSchema,
   engagementVersionQuerySchema,
   engagementBoundaryPageSchema,
@@ -1165,6 +1218,7 @@ export {
   leaderboardPreviewSchema,
   pointsMutationSchema,
   pointsEntrySchema,
+  managedPointHistoryPageSchema,
   pointsResultSchema,
   pointsAccountSchema,
   leaderboardExclusionSchema,
@@ -1179,6 +1233,9 @@ export {
   referralArtifactSchema,
   publishedReferralSchema,
   referralAcceptSchema,
+  referralSuspensionSchema,
+  referralQualificationSchema,
+  referralRewardResolutionSchema,
   referralControlSchema,
   referralRelationshipSchema,
   referralAccountSchema,

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

@@ -1,7 +1,7 @@
 import {
   identifier,
   xTweetSchema
-} from "./chunk-JON5SESL.js";
+} from "./chunk-KGJSKGKI.js";
 
 // src/x.ts
 import { z } from "zod";