@domino-sdk/relay 1.60.0 → 1.62.0

package/dist/{chunk-Y2IGFLD2.js → chunk-HTZHBTIL.js}

@@ -1,7 +1,7 @@
 import {
   dashboardArtifactSchema,
   dashboardPreviewSchema
-} from "./chunk-N3LJ6GFK.js";
+} from "./chunk-3KLC4AMA.js";
 import {
   imageAssetArtifactSchema,
   imageComparisonSchema,
@@ -10,41 +10,34 @@ import {
   imageSightingsSchema,
   imageUploadsSchema,
   publishedImageSchema
-} from "./chunk-YOAPPIWN.js";
+} from "./chunk-QYPMPWVX.js";
 import {
-  catalogDeploymentSchema,
+  authProvidersSchema,
   collectionPassSchema,
-  collectionViewSchema,
   creatorAccountsSchema,
-  interactionSchema,
-  participantActivitySchema,
   participantDeliveriesSchema,
   participantEntitlementsSchema,
-  questCatalogSchema,
-  questCollectionSchema,
   questEnrollmentSchema,
-  questExperienceSchema,
   questOutcomePageSchema,
   questOutcomeSchema,
-  questTypeVersionSchema,
-  questViewSchema,
   rewardDeliveriesSchema
-} from "./chunk-XQKUJL7H.js";
+} from "./chunk-CICDIBOF.js";
+import {
+  catalogDeploymentSchema,
+  collectionViewSchema,
+  interactionSchema,
+  participantActivitySchema,
+  questCatalogSchema,
+  questCollectionSchema,
+  questExperienceSchema,
+  questTypeVersionSchema,
+  questViewSchema
+} from "./chunk-D26YNACF.js";
 import {
-  badgeArtifactSchema,
-  badgeSchema,
   engagementArtifactSchema,
   engagementBoundaryPageSchema,
   engagementDeploymentEntrySchema,
   engagementPageSchema,
-  leaderboardArtifactSchema,
-  leaderboardDefinitionSchema,
-  leaderboardHistoryPageSchema,
-  leaderboardPageSchema,
-  leaderboardPlacementSchema,
-  leaderboardPreviewSchema,
-  managedBadgeSchema,
-  memberBadgesSchema,
   offerArtifactSchema,
   offerDefinitionSchema,
   offerSchema,
@@ -54,8 +47,18 @@ import {
   referralDefinitionSchema,
   referralHistorySchema,
   referralSummarySchema
-} from "./chunk-MJEJQH5A.js";
+} from "./chunk-GTDW453U.js";
 import {
+  badgeArtifactSchema,
+  badgeSchema,
+  leaderboardArtifactSchema,
+  leaderboardDefinitionSchema,
+  leaderboardHistoryPageSchema,
+  leaderboardPageSchema,
+  leaderboardPlacementSchema,
+  leaderboardPreviewSchema,
+  managedBadgeSchema,
+  memberBadgesSchema,
   ownProfileSchema,
   pointBalancesSchema,
   pointHistoryPageSchema,
@@ -65,12 +68,12 @@ import {
   profileCompletionPageSchema,
   profileReferralSchema,
   profileSummarySchema
-} from "./chunk-YNW2ZUUP.js";
+} from "./chunk-WSBYWVTZ.js";
 import {
   exchangeResultSchema,
   memberSummarySchema,
   participantSessionSchema
-} from "./chunk-422J3QRW.js";
+} from "./chunk-XJFYAXET.js";
 import {
   accountConnectionSchema,
   attemptSchema,
@@ -95,8 +98,11 @@ import {
   releaseSchema,
   responseListSchema,
   responseSchema,
+  rewardEntrySchema,
   rewardSchema,
   sdkRuntimeSchema,
+  signInAccountSchema,
+  signInProviderOptionSchema,
   telegramAccountConnectionSchema,
   tieredRewardReferenceSchema,
   timeZoneNameSchema,
@@ -109,7 +115,7 @@ import {
   walletNftsSchema,
   walletSignInNetworksSchema,
   walletTransactionsSchema
-} from "./chunk-GBSDAD3N.js";
+} from "./chunk-MK425RXJ.js";
 
 // src/deployments.ts
 import * as z from "zod";
@@ -133,7 +139,12 @@ var projectCatalogArtifactSchema = catalogDeploymentSchema.omit({ expectedRevisi
   runtimes: z.array(sdkRuntimeSchema).max(4).default([])
 });
 var projectDeploymentSchema = projectCatalogArtifactSchema.extend({
-  releases: z.array(releaseSchema).max(questScaleLimits.quests).default([])
+  releases: z.array(releaseSchema).max(questScaleLimits.quests).default([]),
+  /**
+   * The deployment leaves out quests on purpose, as `domino deploy --only` does, so its preview
+   * doesn't warn about published quests it omits (`quests-not-in-bundle`).
+   */
+  partial: z.boolean().optional()
 }).refine(
   (value) => value.engagement.length > 0 || value.trackers.length > 0 || value.pointLedgers.length > 0 || value.badges.length > 0 || value.offers.length > 0 || value.releases.length > 0 || value.leaderboards.length > 0 || value.referrals.length > 0 || value.images.length > 0 || value.dashboards.length > 0 || value.types.length > 0 || value.collections.length > 0 || value.supportedInteractions !== void 0 || value.calendar !== void 0,
   "No resources configured. Add engagement, trackers, quests, questTypes, badges, pointLedgers, offers, leaderboards, referrals, images, dashboards, collections, supportedInteractions, or calendar to relay.json."
@@ -144,6 +155,14 @@ var deploymentWarningSchema = z.object({
   integration: z.string().optional(),
   quests: z.array(z.string()).default([])
 });
+var deploymentQuestChangeSchema = z.object({
+  /** The quest's ID. */
+  quest: identifier,
+  /** The quest's authoring key. */
+  key: identifier.optional(),
+  change: z.enum(["created", "updated", "unchanged"]),
+  replaces: z.object({ release: identifier, createdAt: z.number() }).optional()
+});
 var deploymentPreviewSchema = z.object({
   id: identifier,
   engagement: z.array(engagementDeploymentEntrySchema).default([]),
@@ -153,6 +172,11 @@ var deploymentPreviewSchema = z.object({
   pointLedgers: z.array(pointLedgerSchema).default([]),
   offers: z.array(offerDefinitionSchema).default([]),
   releases: z.array(publishedReleaseSchema),
+  /**
+   * Each quest in `releases` and what publishing does to it (see `deploymentQuestChangeSchema`).
+   * Optional so values built for older SDKs still fit.
+   */
+  questChanges: z.array(deploymentQuestChangeSchema).optional(),
   types: z.array(questTypeVersionSchema),
   collections: z.array(questCollectionSchema),
   supportedInteractions: z.array(interactionSchema),
@@ -421,6 +445,11 @@ var automaticCatchUpPreviewSchema = z3.object({
   ),
   /** Declared rewards per successful evaluation. Evaluators may choose different rewards. */
   rewards: z3.array(rewardSchema),
+  /**
+   * The same declared rewards, kinds this SDK does not know included: the open sibling of
+   * `rewards`, which keeps SDK 1.x's closed `Reward`. Absent from older Relay versions.
+   */
+  rewardEntries: z3.array(rewardEntrySchema).optional(),
   /** Each budget's declared cost per successful evaluation; dynamic costs remain explicit. */
   costs: z3.array(
     z3.object({
@@ -486,6 +515,15 @@ var participantResponseSchemas = lazyResponseReaders({
   get authProviderSchema() {
     return knownResponse(authProviderSchema);
   },
+  get authProvidersSchema() {
+    return knownResponse(authProvidersSchema);
+  },
+  get signInAccountSchema() {
+    return knownResponse(signInAccountSchema);
+  },
+  get signInProviderOptionSchema() {
+    return knownResponse(signInProviderOptionSchema);
+  },
   get campaignEnrollmentSchema() {
     return knownResponse(campaignEnrollmentSchema);
   },
@@ -614,6 +652,9 @@ var participantResponses = {
   accountConnectionSchema: responseSchema(accountConnectionSchema),
   attemptSchema: responseSchema(attemptSchema),
   authProviderSchema: responseSchema(authProviderSchema),
+  authProvidersSchema: responseSchema(authProvidersSchema),
+  signInAccountSchema: responseSchema(signInAccountSchema),
+  signInProviderOptionSchema: responseSchema(signInProviderOptionSchema),
   campaignEnrollmentSchema: responseSchema(campaignEnrollmentSchema),
   collectionPassSchema: responseSchema(collectionPassSchema),
   contentPerformancePageSchema: responseSchema(contentPerformancePageSchema),
@@ -708,6 +749,7 @@ export {
   projectCatalogArtifactSchema,
   projectDeploymentSchema,
   deploymentWarningSchema,
+  deploymentQuestChangeSchema,
   deploymentPreviewSchema,
   publishDeploymentSchema,
   deploymentResultSchema,

package/dist/chunk-K2KS3JLY.js

@@ -0,0 +1,188 @@
+// 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` for a replay-safe operation ID, else `reconcile`; only when `uncertain`. */
+  recovery;
+  /**
+   * Milliseconds the server asked the client to wait before trying again, from the `Retry-After`
+   * header of an error answer such as a 429 or 503. The client's own retries never wait past the
+   * call's deadline, so a longer wait is left to the caller.
+   */
+  retryAfter;
+  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.retryAfter = details.retryAfter;
+    this.recovery = this.uncertain ? details.operationId && (details.replaySafe ?? true) ? "replay" : "reconcile" : void 0;
+  }
+};
+
+// src/errors.ts
+import * as z from "zod";
+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. Nothing was lost: call the
+   * handle's `status()` or `resume()` again once storage is available.
+   */
+  SubmissionStorage: "submission-storage",
+  /** Browser storage is full, so submission progress was not saved. Free space, then resume. */
+  SubmissionStorageQuota: "submission-storage-quota",
+  /** The saved submission is in a state that does not allow this action. */
+  SubmissionConflict: "submission-conflict",
+  /**
+   * The saved submission's operation belongs to a retired contract and cannot continue. Show the
+   * current quest and let the member `discard()` it before submitting again.
+   */
+  OperationRetired: "operation-retired",
+  /** The quest changed since the member saw it; review it before submitting again. */
+  QuestUpdated: "quest-updated",
+  /** Wait for the deferred attempt before submitting another action. */
+  AttemptPending: "attempt-pending",
+  /**
+   * The member's last attempt was rejected and the quest's retry cooldown is running; `retryAt`
+   * says when they may submit again.
+   */
+  RetryCooldown: "retry-cooldown",
+  /**
+   * The member's last accepted completion of the quest is more recent than its completion
+   * cooldown; `retryAt` says when they may submit again.
+   */
+  CompletionCooldown: "completion-cooldown",
+  /** 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",
+  /** No point ledger in the project has the key or ID the call named. */
+  PointLedgerNotFound: "point-ledger-not-found",
+  /** The member has not joined this project, so it holds no points here. */
+  NotJoined: "not-joined",
+  /** The quest or campaign is not open at this time. */
+  OutsideWindow: "outside-window",
+  /** The signed-in member must enroll in the campaign first. */
+  EnrollmentRequired: "enrollment-required",
+  /** The quest's current reward budget has no remaining capacity. */
+  BudgetExhausted: "budget-exhausted",
+  /** No published offer has the key or ID the call named. */
+  OfferNotFound: "offer-not-found",
+  /** The operator paused this offer. */
+  OfferPaused: "offer-paused",
+  /** This member has already used the offer's allowed number of redemptions. */
+  OfferLimitReached: "offer-limit-reached",
+  /** No declared units remain. */
+  OfferOutOfStock: "offer-out-of-stock",
+  /** The participant's available point balance is below the offer price. */
+  InsufficientPoints: "insufficient-points",
+  /** The client's `getToken` failed before anything was sent; `cause` is its own error. */
+  Credential: "credential",
+  /** A wallet signer failed or the member refused to sign; `cause` is the wallet's own error. */
+  WalletSigner: "wallet-signer",
+  /** The member has not met the quest's or offer'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) {
+  return isRequestError(value) && value[relayErrorBrand] === true;
+}
+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;
+  /**
+   * Unix milliseconds when the member may submit again, when `code` is `retry-cooldown` or
+   * `completion-cooldown`.
+   */
+  retryAt;
+  constructor(message, details) {
+    super(message, details);
+    this.window = details.window;
+    this.missing = details.missing ?? [];
+    this.retryAt = details.retryAt;
+  }
+};
+function asRelayError(cause, fallback = "Request failed") {
+  if (isRelayError(cause)) {
+    return cause;
+  }
+  return new RelayError(
+    cause instanceof Error && cause.message ? cause.message : fallback,
+    { kind: "client", cause }
+  );
+}
+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(
+      z.prettifyError(parsed.error),
+      RelayErrorCode.InvalidInput,
+      { cause: parsed.error }
+    );
+  }
+  return parsed.data;
+}
+
+export {
+  isRequestError,
+  RequestError,
+  RelayErrorCode,
+  isRelayError,
+  RelayError,
+  asRelayError,
+  clientError,
+  parseInput
+};