@domino-sdk/relay 1.5.1 → 1.6.0

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";

package/dist/{chunk-JON5SESL.js → chunk-KGJSKGKI.js}

@@ -390,7 +390,7 @@ function literalsOf(schema) {
 }
 function matches(schema, value, at, budget) {
   charge(budget, 1);
-  const issue = (reason) => ({ at, reason });
+  const issue = (reason2) => ({ at, reason: reason2 });
   if (schema.const !== void 0 && value !== schema.const) {
     return issue(() => `expected ${JSON.stringify(schema.const)}`);
   }
@@ -1078,7 +1078,7 @@ var trackerSkipCodes = [
   "prerequisites-incomplete"
 ];
 var trackerOutcomeSchema = z6.discriminatedUnion("state", [
-  z6.strictObject({
+  z6.object({
     ...trackerOutcomeFields,
     state: z6.literal("admitted"),
     code: z6.null(),
@@ -1088,19 +1088,21 @@ var trackerOutcomeSchema = z6.discriminatedUnion("state", [
     /** The admitted attempt. Its evaluation, decision and rewards live on the attempt. */
     attempt: identifier
   }),
-  z6.strictObject({
+  z6.object({
     ...trackerOutcomeFields,
     state: z6.literal("skipped"),
     /** Why the observation was skipped, as one of `trackerSkipCodes`. */
     code: z6.string().min(1),
     /** Why the observation was skipped, for people. */
     reason: z6.string(),
+    /** Which window refused admission when `code` is `outside-window`. */
+    window: z6.enum(["tracker", "quest"]).optional(),
     /** The attributed member, when attribution got that far. */
     member: identifier.nullable(),
     attempt: identifier.nullable()
   })
 ]);
-var trackerOutcomeQuerySchema = z6.strictObject({
+var trackerOutcomeFilters = {
   /** Quest key or ID. */
   quest: identifier.optional(),
   record: externalId.optional(),
@@ -1108,7 +1110,18 @@ var trackerOutcomeQuerySchema = z6.strictObject({
   state: z6.enum(["admitted", "skipped"]).optional(),
   /** Only skips with this code, such as `unlinked-account`. */
   code: z6.string().min(1).max(100).optional(),
-  limit: z6.coerce.number().int().min(1).max(100).default(25),
+  limit: z6.coerce.number().int().min(1).max(100).default(25)
+};
+var trackerTriggerOutcomeQuerySchema = z6.strictObject({
+  ...trackerOutcomeFilters,
+  cursor: pageCursorSchema.optional()
+});
+var trackerTriggerOutcomePageSchema = z6.object({
+  items: z6.array(trackerOutcomeSchema).max(100),
+  nextCursor: pageCursorSchema.nullable()
+});
+var trackerOutcomeQuerySchema = z6.strictObject({
+  ...trackerOutcomeFilters,
   /** Opaque cursor from `next`: older outcomes. */
   before: z6.string().max(512).optional()
 });
@@ -1829,6 +1842,9 @@ var resourceOptionsSchema = z16.object({
       disabledReason: z16.string().optional()
     })
   ),
+  /** Pass back as `cursor` for the next page; null on the last one. */
+  nextCursor: z16.string().nullable().default(null),
+  /** @deprecated Use `nextCursor`. Removed in 2.0.0. */
   cursor: z16.string().nullable()
 });
 
@@ -2017,6 +2033,37 @@ function defineGroup(input) {
 function projectGroupKey(group) {
   return identifier.parse(group.key);
 }
+var groupTitle = z21.string().trim().min(1).max(120);
+var reason = z21.string().trim().min(1).max(1e3);
+var timestamp5 = z21.number().int().nonnegative().max(864e13);
+var createGroupSchema = z21.object({ actionId: identifier, key: identifier, title: groupTitle }).strict();
+var updateGroupSchema = z21.object({ title: groupTitle }).strict();
+var addGroupMemberSchema = z21.object({ actionId: identifier, member: identifier, reason }).strict();
+var removeGroupMemberSchema = z21.object({ actionId: identifier, reason }).strict();
+var groupPageQuerySchema = z21.strictObject({
+  cursor: pageCursorSchema.optional(),
+  /** Items per page, 1–100; the default is 50. */
+  limit: z21.number().int().min(1).max(100).optional()
+});
+var managedGroupSchema = z21.object({
+  key: identifier,
+  title: z21.string(),
+  members: z21.number().int().nonnegative(),
+  createdAt: timestamp5,
+  archivedAt: timestamp5.nullable()
+});
+var groupPageSchema = z21.object({
+  items: z21.array(managedGroupSchema),
+  nextCursor: pageCursorSchema.nullable()
+});
+var groupMemberSchema = z21.object({
+  member: identifier,
+  addedAt: timestamp5.nullable()
+});
+var groupMemberPageSchema = z21.object({
+  items: z21.array(groupMemberSchema),
+  nextCursor: pageCursorSchema.nullable()
+});
 
 // src/prerequisites.ts
 import { z as z22 } from "zod";
@@ -2339,6 +2386,7 @@ var submitSchema = z23.object({
   evidence: identifier.optional(),
   input: submissionEvidenceSchema.optional(),
   release: identifier.optional(),
+  /** @deprecated Relay refuses a submission that sets it to `true` and ignores `false`. Removed in 2.0.0. */
   faultAfterReview: z23.boolean().optional()
 }).strict();
 var AttemptStatus = {
@@ -2545,11 +2593,24 @@ var entitlementCorrectionSchema = z23.object({
   revision: z23.number().int().positive(),
   reason: z23.string().trim().min(1).max(500)
 }).strict();
+var CompletionSourceKind = {
+  Quest: "quest",
+  Leaderboard: "leaderboard"
+};
+var completionSourceKindSchema = z23.string().min(1).max(64);
+var completionSourceSchema = z23.object({
+  kind: completionSourceKindSchema,
+  id: identifier
+});
 var completionRecordSchema = z23.object({
+  /** The occurrence the completion consumed. For a leaderboard prize, the settlement ID. */
   key: z23.string().default("once"),
   id: identifier,
+  /** The quest ID, or the board ID when `source.kind` is `leaderboard`. */
   quest: identifier,
-  member: identifier
+  member: identifier,
+  /** What paid the completion. `source.id` repeats `quest`. */
+  source: completionSourceSchema.optional()
 });
 var questAvailabilitySchema = z23.discriminatedUnion("kind", [
   z23.object({
@@ -2571,6 +2632,8 @@ var questAvailabilitySchema = z23.discriminatedUnion("kind", [
       "outside-window",
       "enrollment-required"
     ]),
+    /** Which window refused admission when `reason` is `outside-window`. */
+    window: z23.enum(["tracker", "quest"]).optional(),
     resetsAt: z23.number().int().safe().optional()
   }).strict(),
   z23.object({ kind: z23.literal("staff-required") }).strict(),
@@ -2643,6 +2706,8 @@ var evidenceSchema = z23.object({
 var errorSchema = z23.object({
   error: z23.string(),
   code: z23.string().optional(),
+  /** Which window refused admission when `code` is `outside-window`. */
+  window: z23.enum(["tracker", "quest"]).optional(),
   missing: z23.array(missingPrerequisiteSchema).optional()
 });
 var staffDecisionSchema = z23.object({
@@ -2805,6 +2870,8 @@ export {
   trackerIngestResultSchema,
   trackerSkipCodes,
   trackerOutcomeSchema,
+  trackerTriggerOutcomeQuerySchema,
+  trackerTriggerOutcomePageSchema,
   trackerOutcomeQuerySchema,
   trackerOutcomePageSchema,
   trackerOutcomeRetrySchema,
@@ -2906,6 +2973,15 @@ export {
   projectGroupSchema,
   defineGroup,
   projectGroupKey,
+  createGroupSchema,
+  updateGroupSchema,
+  addGroupMemberSchema,
+  removeGroupMemberSchema,
+  groupPageQuerySchema,
+  managedGroupSchema,
+  groupPageSchema,
+  groupMemberSchema,
+  groupMemberPageSchema,
   completionPrerequisiteSchema,
   balancePrerequisiteSchema,
   groupPrerequisiteSchema,
@@ -2963,6 +3039,8 @@ export {
   beginHandoverSchema,
   confirmHandoverSchema,
   entitlementCorrectionSchema,
+  CompletionSourceKind,
+  completionSourceSchema,
   completionRecordSchema,
   questAvailabilitySchema,
   questBudgetViewSchema,

package/dist/{chunk-WJSSJ7AF.js → chunk-QGLHZ2E5.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
 };