@domino-sdk/relay 1.7.0 → 1.10.0

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

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

package/dist/{client-pfml_XAa.d.ts → client-Yq11HA_f.d.ts}

@@ -1,12 +1,13 @@
-import { aW as referralAcceptSchema, g as LeaderboardQuery, b as CampaignEnrollmentInput, d as CampaignWithdrawalInput, m as PointHistoryQuery, k as PointEntryKind, a2 as engagementPageQuerySchema } from './groups-BpWEqaPn.js';
-import { j as QuestView, a as PageQuery, c as QuestEnrollmentInput, Q as QuestClaimInput, g as QuestOutcomeQuery, V as questExperienceSchema, o as RewardDeliveryAction, B as contentQualificationQuerySchema } from './pages-CixTNnF4.js';
-import { M as MissingPrerequisite, V as ValueEvidence, a as AuthProvider } from './submission-input-CLefHTrj.js';
+import { aZ as referralAcceptSchema, g as LeaderboardQuery, b as CampaignEnrollmentInput, d as CampaignWithdrawalInput, m as PointHistoryQuery, k as PointEntryKind, a6 as engagementPageQuerySchema } from './groups-BK8ts2yK.js';
+import { j as QuestView, k as ResponseSchema, a as PageQuery, c as QuestEnrollmentInput, Q as QuestClaimInput, g as QuestOutcomeQuery, Y as questExperienceSchema, l as RewardDeliveryAction, E as contentQualificationQuerySchema } from './pages-D00JDZB-.js';
+import { M as MissingPrerequisite, V as ValueEvidence, a as AuthProvider } from './submission-input-BbBJTVlT.js';
 import { R as RequestError, a as RequestErrorDetails, b as RequestErrorKind } from './request-error-D_dUPLwo.js';
-import { f as QuizEvidence, A as Attempt, M as MemberProgress, a as AttemptStatus, h as TrackerSkipCode, bW as submitSchema, aW as contentPerformanceQuerySchema } from './schema-CQydLqw4.js';
+import { f as QuizEvidence, A as Attempt, M as MemberProgress, a as AttemptStatus, h as TrackerSkipCode, c6 as submitSchema, b8 as contentPerformanceQuerySchema } from './schema-DEM8y8Fm.js';
 import { b as ParticipantSession, d as exchangeSchema, R as RelayEvent, P as ParticipantActivity } from './participant-activity-DkL3nY5a.js';
 import { z } from 'zod';
-import { F as profileUpdateSchema, c as ProfileCompletionQuery } from './profiles-D2aFcOxu.js';
-import { y as walletAddressInputSchema, I as walletSignatureSchema, L as LinkedWallet, f as WalletSigner } from './wallet-YssWxGg8.js';
+import { c as createRelayAction, O as OptionalActionId } from './action-9Xl0StBg.js';
+import { F as profileUpdateSchema, c as ProfileCompletionQuery } from './profiles-BHMVj0kM.js';
+import { y as walletAddressInputSchema, I as walletSignatureSchema, L as LinkedWallet, f as WalletSigner } from './wallet-CDyo-U4n.js';
 
 /** What happened, as in every Domino client error (see `RequestError`). */
 type RelayErrorKind = RequestErrorKind;
@@ -266,8 +267,25 @@ type RelayClientOptions = {
      */
     timeout?: number;
 };
+/** @compat input */
+type RelayResponseOptions = RelayRequestOptions & {
+    method?: "GET" | "POST";
+    input?: unknown;
+    /** Persist this identity before sending a write. */
+    operationId?: string;
+    /** Use only when the route records a receipt for the supplied operation identity. */
+    replaySafe?: boolean;
+};
 declare function createRelayClient(options: RelayClientOptions): RelayClient;
 declare function relayClient(options: RelayClientOptions): {
+    /** Owns one action key across uncertain writes. Reuse the helper until a definite answer. */
+    action: typeof createRelayAction;
+    /** A JSON call using an explicit tolerant response schema from `@domino-sdk/relay/schema`. */
+    response: <T>(path: string, schema: ResponseSchema<T>, call?: RelayResponseOptions) => Promise<{
+        status: number;
+        operationId: string | undefined;
+        result: Awaited<T>;
+    }>;
     offers: {
         /** Offers available to this participant, including stock and per-member availability. */
         list: (requestOptions?: RelayRequestOptions) => Promise<{
@@ -631,7 +649,7 @@ declare function relayClient(options: RelayClientOptions): {
             }[];
             nextCursor: string | null;
         }>;
-        accept: (value: z.input<typeof referralAcceptSchema>, requestOptions?: RelayRequestOptions) => Promise<{
+        accept: (value: OptionalActionId<z.input<typeof referralAcceptSchema>>, requestOptions?: RelayRequestOptions) => Promise<{
             ok: true;
         }>;
     };
@@ -1060,7 +1078,7 @@ declare function relayClient(options: RelayClientOptions): {
                     period: "day" | "week" | "month";
                 };
             };
-            access: "participants" | "public";
+            access: "public" | "participants";
             key?: string | undefined;
             group?: string | undefined;
             settle?: {
@@ -1224,7 +1242,7 @@ declare function relayClient(options: RelayClientOptions): {
             avatarProvider: "discord" | "google" | "x" | null;
             hidden: boolean;
             locked: boolean;
-            visibility: "private" | "participants" | "public";
+            visibility: "public" | "private" | "participants";
             options: {
                 provider: "discord" | "google" | "x";
                 name: string | null;
@@ -1235,7 +1253,9 @@ declare function relayClient(options: RelayClientOptions): {
          * Changes the member's own name, avatar choice or visibility; omitted fields stay, and null
          * returns to the default.
          */
-        update: (value: z.input<typeof profileUpdateSchema>, requestOptions?: RelayRequestOptions) => Promise<{
+        update: (value: z.input<typeof profileUpdateSchema> & {
+            actionId?: string;
+        }, requestOptions?: RelayRequestOptions) => Promise<{
             id: string;
             name: string;
             avatar: {
@@ -1256,7 +1276,7 @@ declare function relayClient(options: RelayClientOptions): {
             avatarProvider: "discord" | "google" | "x" | null;
             hidden: boolean;
             locked: boolean;
-            visibility: "private" | "participants" | "public";
+            visibility: "public" | "private" | "participants";
             options: {
                 provider: "discord" | "google" | "x";
                 name: string | null;
@@ -1269,6 +1289,7 @@ declare function relayClient(options: RelayClientOptions): {
          * `uploadId` and file stores no second picture, but only before another upload replaces it.
          */
         uploadAvatar: (file: Blob, requestOptions?: RelayRequestOptions & {
+            actionId?: string;
             uploadId?: string;
         }) => Promise<{
             id: string;
@@ -1291,7 +1312,7 @@ declare function relayClient(options: RelayClientOptions): {
             avatarProvider: "discord" | "google" | "x" | null;
             hidden: boolean;
             locked: boolean;
-            visibility: "private" | "participants" | "public";
+            visibility: "public" | "private" | "participants";
             options: {
                 provider: "discord" | "google" | "x";
                 name: string | null;
@@ -1439,14 +1460,14 @@ declare function relayClient(options: RelayClientOptions): {
                         equals: string | number | boolean;
                     })[] | undefined;
                     enrollment?: "none" | "required" | undefined;
-                    since?: "activation" | "window" | "enrollment" | undefined;
+                    since?: "window" | "activation" | "enrollment" | undefined;
                     historical?: "staff" | "claim" | "automatic" | undefined;
                     content?: true | undefined;
                 } | undefined;
             };
             availability: {
                 kind: "available";
-                input: "text" | "none" | "url" | "quiz" | "photo";
+                input: "url" | "text" | "none" | "quiz" | "photo";
             } | {
                 kind: "completed";
             } | {
@@ -1476,7 +1497,7 @@ declare function relayClient(options: RelayClientOptions): {
                 })[];
             } | {
                 kind: "blocked";
-                reason: "paused" | "outside-window" | "budget-exhausted" | "connection-required" | "wallet-required" | "enrollment-required";
+                reason: "outside-window" | "enrollment-required" | "budget-exhausted" | "paused" | "connection-required" | "wallet-required";
                 window?: "quest" | "tracker" | undefined;
                 resetsAt?: number | undefined;
             } | {
@@ -1639,7 +1660,7 @@ declare function relayClient(options: RelayClientOptions): {
                 } | undefined;
             } | null;
             release: string;
-            interaction: "text" | "staff" | "claim" | "automatic" | "url" | "quiz" | "photo";
+            interaction: "url" | "text" | "staff" | "claim" | "automatic" | "quiz" | "photo";
             lifecycle: "paused" | "active" | "archived";
             rewards: ({
                 kind: "points";
@@ -1734,7 +1755,7 @@ declare function relayClient(options: RelayClientOptions): {
          * counts from then on; earlier activity is historical, or skipped with `before-enrollment`
          * on a quest that counts from enrollment. Enrolling again returns the first enrollment.
          */
-        enroll: (value: QuestEnrollmentInput, requestOptions?: RelayRequestOptions) => Promise<{
+        enroll: (value: OptionalActionId<QuestEnrollmentInput>, requestOptions?: RelayRequestOptions) => Promise<{
             quest: string;
             member: string;
             enrolledAt: number;
@@ -1745,7 +1766,7 @@ declare function relayClient(options: RelayClientOptions): {
          * historical activity released and returns the outcome; a rule that still fails rejects
          * with a `RelayError` whose code is that rule's skip code.
          */
-        claim: (value: QuestClaimInput, requestOptions?: RelayRequestOptions) => Promise<{
+        claim: (value: OptionalActionId<QuestClaimInput>, requestOptions?: RelayRequestOptions) => Promise<{
             quest: string;
             tracker: string | null;
             record: string | null;
@@ -2092,14 +2113,14 @@ declare function relayClient(options: RelayClientOptions): {
                             equals: string | number | boolean;
                         })[] | undefined;
                         enrollment?: "none" | "required" | undefined;
-                        since?: "activation" | "window" | "enrollment" | undefined;
+                        since?: "window" | "activation" | "enrollment" | undefined;
                         historical?: "staff" | "claim" | "automatic" | undefined;
                         content?: true | undefined;
                     } | undefined;
                 };
                 availability: {
                     kind: "available";
-                    input: "text" | "none" | "url" | "quiz" | "photo";
+                    input: "url" | "text" | "none" | "quiz" | "photo";
                 } | {
                     kind: "completed";
                 } | {
@@ -2129,7 +2150,7 @@ declare function relayClient(options: RelayClientOptions): {
                     })[];
                 } | {
                     kind: "blocked";
-                    reason: "paused" | "outside-window" | "budget-exhausted" | "connection-required" | "wallet-required" | "enrollment-required";
+                    reason: "outside-window" | "enrollment-required" | "budget-exhausted" | "paused" | "connection-required" | "wallet-required";
                     window?: "quest" | "tracker" | undefined;
                     resetsAt?: number | undefined;
                 } | {
@@ -2292,7 +2313,7 @@ declare function relayClient(options: RelayClientOptions): {
                     } | undefined;
                 } | null;
                 release: string;
-                interaction: "text" | "staff" | "claim" | "automatic" | "url" | "quiz" | "photo";
+                interaction: "url" | "text" | "staff" | "claim" | "automatic" | "quiz" | "photo";
                 lifecycle: "paused" | "active" | "archived";
                 rewards: ({
                     kind: "points";
@@ -2473,14 +2494,14 @@ declare function relayClient(options: RelayClientOptions): {
                                 equals: string | number | boolean;
                             })[] | undefined;
                             enrollment?: "none" | "required" | undefined;
-                            since?: "activation" | "window" | "enrollment" | undefined;
+                            since?: "window" | "activation" | "enrollment" | undefined;
                             historical?: "staff" | "claim" | "automatic" | undefined;
                             content?: true | undefined;
                         } | undefined;
                     };
                     availability: {
                         kind: "available";
-                        input: "text" | "none" | "url" | "quiz" | "photo";
+                        input: "url" | "text" | "none" | "quiz" | "photo";
                     } | {
                         kind: "completed";
                     } | {
@@ -2510,7 +2531,7 @@ declare function relayClient(options: RelayClientOptions): {
                         })[];
                     } | {
                         kind: "blocked";
-                        reason: "paused" | "outside-window" | "budget-exhausted" | "connection-required" | "wallet-required" | "enrollment-required";
+                        reason: "outside-window" | "enrollment-required" | "budget-exhausted" | "paused" | "connection-required" | "wallet-required";
                         window?: "quest" | "tracker" | undefined;
                         resetsAt?: number | undefined;
                     } | {
@@ -2673,7 +2694,7 @@ declare function relayClient(options: RelayClientOptions): {
                         } | undefined;
                     } | null;
                     release: string;
-                    interaction: "text" | "staff" | "claim" | "automatic" | "url" | "quiz" | "photo";
+                    interaction: "url" | "text" | "staff" | "claim" | "automatic" | "quiz" | "photo";
                     lifecycle: "paused" | "active" | "archived";
                     rewards: ({
                         kind: "points";
@@ -2857,14 +2878,14 @@ declare function relayClient(options: RelayClientOptions): {
                             equals: string | number | boolean;
                         })[] | undefined;
                         enrollment?: "none" | "required" | undefined;
-                        since?: "activation" | "window" | "enrollment" | undefined;
+                        since?: "window" | "activation" | "enrollment" | undefined;
                         historical?: "staff" | "claim" | "automatic" | undefined;
                         content?: true | undefined;
                     } | undefined;
                 };
                 availability: {
                     kind: "available";
-                    input: "text" | "none" | "url" | "quiz" | "photo";
+                    input: "url" | "text" | "none" | "quiz" | "photo";
                 } | {
                     kind: "completed";
                 } | {
@@ -2894,7 +2915,7 @@ declare function relayClient(options: RelayClientOptions): {
                     })[];
                 } | {
                     kind: "blocked";
-                    reason: "paused" | "outside-window" | "budget-exhausted" | "connection-required" | "wallet-required" | "enrollment-required";
+                    reason: "outside-window" | "enrollment-required" | "budget-exhausted" | "paused" | "connection-required" | "wallet-required";
                     window?: "quest" | "tracker" | undefined;
                     resetsAt?: number | undefined;
                 } | {
@@ -3057,7 +3078,7 @@ declare function relayClient(options: RelayClientOptions): {
                     } | undefined;
                 } | null;
                 release: string;
-                interaction: "text" | "staff" | "claim" | "automatic" | "url" | "quiz" | "photo";
+                interaction: "url" | "text" | "staff" | "claim" | "automatic" | "quiz" | "photo";
                 lifecycle: "paused" | "active" | "archived";
                 rewards: ({
                     kind: "points";
@@ -3157,7 +3178,7 @@ declare function relayClient(options: RelayClientOptions): {
     };
     campaigns: {
         /** Enrolls the signed-in member once in every quest of a campaign that requires it. */
-        enroll: (value: CampaignEnrollmentInput, requestOptions?: RelayRequestOptions) => Promise<{
+        enroll: (value: OptionalActionId<CampaignEnrollmentInput>, requestOptions?: RelayRequestOptions) => Promise<{
             campaign: string;
             member: string;
             enrolledAt: number;
@@ -3165,7 +3186,7 @@ declare function relayClient(options: RelayClientOptions): {
             withdrawalReason: string | null;
         }>;
         /** Pauses the signed-in member's campaign enrollment without erasing its history. */
-        withdraw: (value: CampaignWithdrawalInput, requestOptions?: RelayRequestOptions) => Promise<{
+        withdraw: (value: OptionalActionId<CampaignWithdrawalInput>, requestOptions?: RelayRequestOptions) => Promise<{
             campaign: string;
             member: string;
             enrolledAt: number;
@@ -3468,10 +3489,7 @@ declare function relayClient(options: RelayClientOptions): {
             }): Promise<QuizSubmission>;
             (quest: string, options: {
                 input: "none";
-                release? /**
-                 * Cancels the call, which rejects with a `RelayError` of kind `aborted`. Cancelling stops any
-                 * retry; a write already sent stays `uncertain`, since Relay may have applied it.
-                 */: string;
+                release?: string;
                 recoverPrevious?: boolean;
                 repeatable?: boolean;
             }): Promise<ClaimSubmission>;
@@ -3577,14 +3595,14 @@ declare function relayClient(options: RelayClientOptions): {
                             equals: string | number | boolean;
                         })[] | undefined;
                         enrollment?: "none" | "required" | undefined;
-                        since?: "activation" | "window" | "enrollment" | undefined;
+                        since?: "window" | "activation" | "enrollment" | undefined;
                         historical?: "staff" | "claim" | "automatic" | undefined;
                         content?: true | undefined;
                     } | undefined;
                 };
                 availability: {
                     kind: "available";
-                    input: "text" | "none" | "url" | "quiz" | "photo";
+                    input: "url" | "text" | "none" | "quiz" | "photo";
                 } | {
                     kind: "completed";
                 } | {
@@ -3614,7 +3632,7 @@ declare function relayClient(options: RelayClientOptions): {
                     })[];
                 } | {
                     kind: "blocked";
-                    reason: "paused" | "outside-window" | "budget-exhausted" | "connection-required" | "wallet-required" | "enrollment-required";
+                    reason: "outside-window" | "enrollment-required" | "budget-exhausted" | "paused" | "connection-required" | "wallet-required";
                     window?: "quest" | "tracker" | undefined;
                     resetsAt?: number | undefined;
                 } | {
@@ -4075,7 +4093,7 @@ declare function relayClient(options: RelayClientOptions): {
             nextCursor: string | null;
         }>;
         /** Claims a quest for the signed-in member. Quest controllers (`quests.open`) call this. */
-        claim: (value: Omit<z.input<typeof submitSchema>, "member">, requestOptions?: RelayRequestOptions) => Promise<{
+        claim: (value: OptionalActionId<Omit<z.input<typeof submitSchema>, "member">>, requestOptions?: RelayRequestOptions) => Promise<{
             id: string;
             release: string;
             quest: string;
@@ -4141,8 +4159,11 @@ declare function relayClient(options: RelayClientOptions): {
                 release?: string | undefined;
             } | undefined;
         }>;
-        /** Uploads a photo as the signed-in member's evidence. */
-        upload: (file: Blob, requestOptions?: RelayRequestOptions) => Promise<{
+        /** Uploads evidence with a generated key; reuse `actionId` and the same file to replay. */
+        upload: (file: Blob, requestOptions?: RelayRequestOptions & {
+            actionId?: string;
+            uploadId?: string;
+        }) => Promise<{
             id: string;
             member: string;
             type: "image/jpeg" | "image/png";
@@ -4317,4 +4338,4 @@ declare function relayClient(options: RelayClientOptions): {
 interface RelayClient extends ReturnType<typeof relayClient> {
 }
 
-export { type ClaimSubmission as C, type KnownRelayErrorCode as K, type PhotoSubmission as P, type QuestActionResult as Q, type RelayClient as R, type SubmissionDraft as S, type ValueSubmission as V, type ProgressObservation as a, type ProgressObserver as b, type QuestController as c, QuestUpdatedError as d, type QuizSubmission as e, type RelayClientOptions as f, RelayError as g, RelayErrorCode as h, type RelayErrorDetails as i, type RelayErrorKind as j, type RelayRequestOptions as k, type SubmissionStatus as l, type SubmissionStore as m, createRelayClient as n, isRelayError as o };
+export { type ClaimSubmission as C, type KnownRelayErrorCode as K, type PhotoSubmission as P, type QuestActionResult as Q, type RelayClient as R, type SubmissionDraft as S, type ValueSubmission as V, type ProgressObservation as a, type ProgressObserver as b, type QuestController as c, QuestUpdatedError as d, type QuizSubmission as e, type RelayClientOptions as f, RelayError as g, RelayErrorCode as h, type RelayErrorDetails as i, type RelayErrorKind as j, type RelayRequestOptions as k, type RelayResponseOptions as l, type SubmissionStatus as m, type SubmissionStore as n, createRelayClient as o, isRelayError as p };

package/dist/{groups-BpWEqaPn.d.ts → groups-BK8ts2yK.d.ts}

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { cV as ResourceHandle, cY as GroupHandle } from './schema-CQydLqw4.js';
+import { n as ResourceHandle, G as GroupHandle } from './schema-DEM8y8Fm.js';
 
 declare const pointLedgerPropertiesSchema: z.ZodObject<{
     name: z.ZodString;
@@ -755,8 +755,96 @@ declare const leaderboardDefinitionSchema: z.ZodObject<{
         }, z.core.$strip>], "kind">>;
     }, z.core.$strict>], "kind">>;
     access: z.ZodDefault<z.ZodEnum<{
+        public: "public";
         participants: "participants";
+    }>>;
+    group: z.ZodOptional<z.ZodString>;
+    settle: z.ZodOptional<z.ZodObject<{
+        at: z.ZodLiteral<"window-end">;
+        ties: z.ZodEnum<{
+            shared: "shared";
+            earliest: "earliest";
+        }>;
+        prizes: z.ZodArray<z.ZodObject<{
+            ranks: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+            rewards: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                kind: z.ZodDefault<z.ZodLiteral<"points">>;
+                balance: z.ZodString;
+                amount: z.ZodNumber;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"tier">;
+                reward: z.ZodObject<{
+                    id: z.ZodString;
+                    title: z.ZodString;
+                    tiers: z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        title: z.ZodString;
+                    }, z.core.$strict>>;
+                    inventory: z.ZodObject<{
+                        kind: z.ZodLiteral<"untracked">;
+                    }, z.core.$strict>;
+                    fulfillment: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        kind: z.ZodLiteral<"staff-handover">;
+                    }, z.core.$strict>, z.ZodObject<{
+                        kind: z.ZodLiteral<"automatic">;
+                    }, z.core.$strict>], "kind">;
+                }, z.core.$strict>;
+                tier: z.ZodString;
+            }, z.core.$strict>]>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+/** Known leaderboard data is read separately from its strict authoring definition. */
+declare const leaderboardDefinitionResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    key: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
+    balance: z.ZodString;
+    score: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"balance">;
+    }, z.core.$strict>, z.ZodObject<{
+        window: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"all-time">;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"fixed">;
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"rolling">;
+            days: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"calendar">;
+            period: z.ZodEnum<{
+                day: "day";
+                week: "week";
+                month: "month";
+            }>;
+        }, z.core.$strip>], "kind">>;
+        quests: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        kind: z.ZodLiteral<"earned">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"net">;
+        window: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"all-time">;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"fixed">;
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"rolling">;
+            days: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"calendar">;
+            period: z.ZodEnum<{
+                day: "day";
+                week: "week";
+                month: "month";
+            }>;
+        }, z.core.$strip>], "kind">>;
+    }, z.core.$strict>], "kind">>;
+    access: z.ZodDefault<z.ZodEnum<{
         public: "public";
+        participants: "participants";
     }>>;
     group: z.ZodOptional<z.ZodString>;
     settle: z.ZodOptional<z.ZodObject<{
@@ -799,8 +887,8 @@ declare const leaderboardAuthoringSchema: z.ZodObject<{
     title: z.ZodString;
     balance: z.ZodString;
     access: z.ZodDefault<z.ZodEnum<{
-        participants: "participants";
         public: "public";
+        participants: "participants";
     }>>;
     settle: z.ZodOptional<z.ZodObject<{
         at: z.ZodLiteral<"window-end">;
@@ -885,8 +973,8 @@ declare const leaderboardArtifactSchema: z.ZodUnion<readonly [z.ZodObject<{
     title: z.ZodString;
     balance: z.ZodString;
     access: z.ZodDefault<z.ZodEnum<{
-        participants: "participants";
         public: "public";
+        participants: "participants";
     }>>;
     settle: z.ZodOptional<z.ZodObject<{
         at: z.ZodLiteral<"window-end">;
@@ -1020,8 +1108,8 @@ declare const publishedLeaderboardSchema: z.ZodObject<{
             }, z.core.$strip>], "kind">>;
         }, z.core.$strict>], "kind">>;
         access: z.ZodDefault<z.ZodEnum<{
-            participants: "participants";
             public: "public";
+            participants: "participants";
         }>>;
         group: z.ZodOptional<z.ZodString>;
         settle: z.ZodOptional<z.ZodObject<{
@@ -1264,8 +1352,8 @@ declare const leaderboardPreviewSchema: z.ZodObject<{
                 }, z.core.$strip>], "kind">>;
             }, z.core.$strict>], "kind">>;
             access: z.ZodDefault<z.ZodEnum<{
-                participants: "participants";
                 public: "public";
+                participants: "participants";
             }>>;
             group: z.ZodOptional<z.ZodString>;
             settle: z.ZodOptional<z.ZodObject<{
@@ -2618,4 +2706,4 @@ declare const groupMemberPageSchema: z.ZodObject<{
 /** @compat output */
 type GroupMemberPage = z.infer<typeof groupMemberPageSchema>;
 
-export { engagementChangeSchema as $, type AvailabilityWindow as A, type ManagedPointLedger as B, type CampaignDefinition as C, type PointLedger as D, type EngagementBudget as E, addGroupMemberSchema as F, type GroupMember as G, availabilityWindowSchema as H, campaignDefinitionSchema as I, campaignEnrollmentInputSchema as J, type KnownPointEntryKind as K, type LeaderboardDefinition as L, type MemberCampaignEnrollmentInput as M, campaignEnrollmentSchema as N, campaignViewSchema as O, type PointBalance as P, campaignWithdrawalInputSchema as Q, type ReferralDefinition as R, createGroupSchema as S, createPointLedgerSchema as T, defineCampaign as U, defineGroup as V, engagementArtifactSchema as W, engagementBoundaryPageSchema as X, engagementBudgetSchema as Y, engagementChangePreviewInputSchema as Z, engagementChangePreviewSchema as _, type CampaignEnrollment as a, referralDefinitionSchema as a$, engagementDefinitionSchema as a0, engagementDeploymentEntrySchema as a1, engagementPageQuerySchema as a2, engagementPageSchema as a3, engagementPublishSchema as a4, engagementRuleSchema as a5, engagementRuleVersionPageSchema as a6, engagementScoreInputSchema as a7, engagementScoreSchema as a8, engagementSettlementSchema as a9, managedPointHistoryPageSchema as aA, managedPointLedgerSchema as aB, memberCampaignEnrollmentInputSchema as aC, memberCampaignWithdrawalInputSchema as aD, pointBalanceSchema as aE, pointBalancesSchema as aF, pointEntrySchema as aG, pointHistoryPageSchema as aH, pointHistoryQuerySchema as aI, pointLedgerArtifactSchema as aJ, pointLedgerDeclarationSchema as aK, pointLedgerPropertiesSchema as aL, pointLedgerReferenceSchema as aM, pointLedgerSchema as aN, pointsAccountSchema as aO, pointsEntrySchema as aP, pointsMutationSchema as aQ, pointsResultSchema as aR, projectGroupKey as aS, projectGroupSchema as aT, publishedLeaderboardSchema as aU, publishedReferralSchema as aV, referralAcceptSchema as aW, referralAccountSchema as aX, referralArtifactSchema as aY, referralAuthoringSchema as aZ, referralControlSchema as a_, engagementVersionPageSchema as aa, engagementVersionQuerySchema as ab, groupMemberPageSchema as ac, groupMemberSchema as ad, groupPageQuerySchema as ae, groupPageSchema as af, leaderboardArtifactSchema as ag, leaderboardAuthoringSchema as ah, leaderboardDefinitionSchema as ai, leaderboardExclusionSchema as aj, leaderboardGroupSchema as ak, leaderboardPageSchema as al, leaderboardPlacementSchema as am, leaderboardPreviewSchema as an, leaderboardPrizeRewardSchema as ao, leaderboardPrizeSchema as ap, leaderboardQuerySchema as aq, leaderboardRowSchema as ar, leaderboardSettlementApprovalSchema as as, leaderboardSettlementPolicySchema as at, leaderboardSettlementRowSchema as au, leaderboardSettlementSchema as av, leaderboardSettlementStatusSchema as aw, leaderboardSettlementSummarySchema as ax, leaderboardWindowSchema as ay, managedGroupSchema as az, type CampaignEnrollmentInput as b, referralHistorySchema as b0, referralManagementSchema as b1, referralQualificationSchema as b2, referralRelationshipSchema as b3, referralRewardResolutionSchema as b4, referralSummarySchema as b5, referralSuspensionSchema as b6, removeGroupMemberSchema as b7, updateGroupSchema as b8, type AuthoringIdentity as b9, type CampaignView as c, type CampaignWithdrawalInput as d, type LeaderboardPage as e, type LeaderboardPlacement as f, type LeaderboardQuery as g, type MemberCampaignWithdrawalInput as h, type PointBalances as i, type PointEntry as j, PointEntryKind as k, type PointHistoryPage as l, type PointHistoryQuery as m, type PointLedgerReference as n, type ProjectGroup as o, type ProjectGroupReference as p, type EngagementDefinition as q, type EngagementRuleVersionPage as r, type GroupMemberPage as s, type GroupPage as t, type GroupPageQuery as u, type LeaderboardSettlement as v, type LeaderboardSettlementPolicy as w, type LeaderboardSettlementSummary as x, type ManagedGroup as y, type ManagedPointHistoryPage as z };
+export { engagementBoundaryPageSchema as $, type AvailabilityWindow as A, type GroupPageQuery as B, type CampaignDefinition as C, type LeaderboardSettlement as D, type EngagementBudget as E, type LeaderboardSettlementPolicy as F, type GroupMember as G, type LeaderboardSettlementSummary as H, type ManagedGroup as I, type ManagedPointHistoryPage as J, type KnownPointEntryKind as K, type LeaderboardDefinition as L, type MemberCampaignEnrollmentInput as M, type ManagedPointLedger as N, type PointLedger as O, type PointBalance as P, addGroupMemberSchema as Q, type ReferralDefinition as R, availabilityWindowSchema as S, campaignDefinitionSchema as T, campaignEnrollmentInputSchema as U, campaignEnrollmentSchema as V, campaignViewSchema as W, campaignWithdrawalInputSchema as X, createGroupSchema as Y, createPointLedgerSchema as Z, engagementArtifactSchema as _, type CampaignEnrollment as a, referralArtifactSchema as a$, engagementBudgetSchema as a0, engagementChangePreviewInputSchema as a1, engagementChangePreviewSchema as a2, engagementChangeSchema as a3, engagementDefinitionSchema as a4, engagementDeploymentEntrySchema as a5, engagementPageQuerySchema as a6, engagementPageSchema as a7, engagementPublishSchema as a8, engagementRuleSchema as a9, leaderboardSettlementStatusSchema as aA, leaderboardSettlementSummarySchema as aB, leaderboardWindowSchema as aC, managedGroupSchema as aD, managedPointHistoryPageSchema as aE, managedPointLedgerSchema as aF, memberCampaignEnrollmentInputSchema as aG, memberCampaignWithdrawalInputSchema as aH, pointBalanceSchema as aI, pointBalancesSchema as aJ, pointEntrySchema as aK, pointHistoryPageSchema as aL, pointHistoryQuerySchema as aM, pointLedgerArtifactSchema as aN, pointLedgerPropertiesSchema as aO, pointLedgerReferenceSchema as aP, pointLedgerSchema as aQ, pointsAccountSchema as aR, pointsEntrySchema as aS, pointsMutationSchema as aT, pointsResultSchema as aU, projectGroupKey as aV, projectGroupSchema as aW, publishedLeaderboardSchema as aX, publishedReferralSchema as aY, referralAcceptSchema as aZ, referralAccountSchema as a_, engagementRuleVersionPageSchema as aa, engagementScoreInputSchema as ab, engagementScoreSchema as ac, engagementSettlementSchema as ad, engagementVersionPageSchema as ae, engagementVersionQuerySchema as af, groupMemberPageSchema as ag, groupMemberSchema as ah, groupPageQuerySchema as ai, groupPageSchema as aj, leaderboardArtifactSchema as ak, leaderboardAuthoringSchema as al, leaderboardDefinitionResponseSchema as am, leaderboardExclusionSchema as an, leaderboardGroupSchema as ao, leaderboardPageSchema as ap, leaderboardPlacementSchema as aq, leaderboardPreviewSchema as ar, leaderboardPrizeRewardSchema as as, leaderboardPrizeSchema as at, leaderboardQuerySchema as au, leaderboardRowSchema as av, leaderboardSettlementApprovalSchema as aw, leaderboardSettlementPolicySchema as ax, leaderboardSettlementRowSchema as ay, leaderboardSettlementSchema as az, type CampaignEnrollmentInput as b, referralControlSchema as b0, referralDefinitionSchema as b1, referralHistorySchema as b2, referralManagementSchema as b3, referralQualificationSchema as b4, referralRelationshipSchema as b5, referralRewardResolutionSchema as b6, referralSummarySchema as b7, referralSuspensionSchema as b8, removeGroupMemberSchema as b9, updateGroupSchema as ba, type CampaignView as c, type CampaignWithdrawalInput as d, type LeaderboardPage as e, type LeaderboardPlacement as f, type LeaderboardQuery as g, type MemberCampaignWithdrawalInput as h, type PointBalances as i, type PointEntry as j, PointEntryKind as k, type PointHistoryPage as l, type PointHistoryQuery as m, type PointLedgerReference as n, type ProjectGroup as o, type ProjectGroupReference as p, type AuthoringIdentity as q, leaderboardDefinitionSchema as r, pointLedgerDeclarationSchema as s, referralAuthoringSchema as t, defineCampaign as u, defineGroup as v, type EngagementDefinition as w, type EngagementRuleVersionPage as x, type GroupMemberPage as y, type GroupPage as z };