@domino-sdk/relay 1.5.1 → 1.6.0

package/dist/{chunk-DGWMLN35.js → chunk-ZOUEEK5L.js}

@@ -12,7 +12,7 @@ import {
   questOutcomeQuerySchema,
   questOutcomeSchema,
   rewardDeliveriesSchema
-} from "./chunk-EYH5RDIE.js";
+} from "./chunk-C25TDFHN.js";
 import {
   AVATAR_UPLOAD_LIMIT,
   RelayError,
@@ -51,7 +51,7 @@ import {
   walletSignInNetworksSchema,
   walletSignatureSchema,
   walletUnlinkInputSchema
-} from "./chunk-36HTX2BM.js";
+} from "./chunk-GMPPLZKH.js";
 import {
   PARTICIPANT_TIMEOUT,
   lifetime,
@@ -65,7 +65,7 @@ import {
   memberSummarySchema,
   participantSessionSchema,
   sessionMember
-} from "./chunk-XFMSUPNS.js";
+} from "./chunk-6ON4RMEN.js";
 import {
   accountConnectionSchema,
   attemptSchema,
@@ -88,7 +88,7 @@ import {
   tieredRewardReferenceSchema,
   validateSubmissionValue,
   valueEvidenceSchema
-} from "./chunk-JON5SESL.js";
+} from "./chunk-KGJSKGKI.js";
 
 // src/submissions.ts
 import { z } from "zod";
@@ -746,9 +746,11 @@ function questActions(submission, latest) {
 // src/client.ts
 function errorBody(value) {
   const body = value !== null && typeof value === "object" ? value : {};
+  const window = body.window === "tracker" ? "tracker" : body.window === "quest" ? "quest" : void 0;
   return {
     message: typeof body.error === "string" && body.error.trim() ? body.error : void 0,
     code: typeof body.code === "string" && body.code.trim() ? body.code : void 0,
+    window,
     missing: Array.isArray(body.missing) ? body.missing.flatMap((entry) => {
       const parsed = missingPrerequisiteSchema.safeParse(entry);
       return parsed.success ? [parsed.data] : [];
@@ -836,6 +838,9 @@ function interrupted(call, life, error, stage) {
   );
 }
 function createRelayClient(options) {
+  return relayClient(options);
+}
+function relayClient(options) {
   if (options.timeout !== void 0 && !validTimeout(options.timeout)) {
     throw invalidTimeout();
   }
@@ -897,11 +902,12 @@ function createRelayClient(options) {
         value = JSON.parse(text);
       } catch {
       }
-      const { message, code, missing } = errorBody(value);
+      const { message, code, window, missing } = errorBody(value);
       throw new RelayError(message ?? `Request failed (${response.status})`, {
         kind: "http",
         status: response.status,
         code,
+        window,
         missing,
         operationId: call.operationId,
         replaySafe: call.replaySafe,
@@ -1634,6 +1640,11 @@ function createRelayClient(options) {
       })
     },
     evidence: {
+      /**
+       * @deprecated Never reachable through participant gates: Relay does not serve evidence back
+       * to members, so this always fails with 404. Reviewers download evidence through the
+       * management API. Removed in 2.0.0.
+       */
       async download(id, requestOptions) {
         const call = { options: requestOptions };
         return exchange(

package/dist/{client-gqnRUHpC.d.ts → client-CQuTAjSs.d.ts}

@@ -1,15 +1,16 @@
-import { aG as referralAcceptSchema, g as LeaderboardQuery, b as CampaignEnrollmentInput, d as CampaignWithdrawalInput, m as PointHistoryQuery, k as PointEntryKind, V as engagementPageQuerySchema } from './groups-Ck-OxzjD.js';
-import { i as QuestView, b as QuestEnrollmentInput, Q as QuestClaimInput, f as QuestOutcomeQuery, P as questExperienceSchema, n as RewardDeliveryAction, A as contentQualificationQuerySchema } from './outcomes-kVB-Juzs.js';
-import { M as MissingPrerequisite, V as ValueEvidence, a as AuthProvider } from './submission-input-BZkm6ohU.js';
-import { R as RequestError, a as RequestErrorDetails, b as RequestErrorKind } from './request-error-DWduJCGV.js';
-import { f as QuizEvidence, A as Attempt, M as MemberProgress, a as AttemptStatus, h as TrackerSkipCode, bI as submitSchema, aI as contentPerformanceQuerySchema } from './schema-DfJzH2ci.js';
-import { d as ParticipantSession, a as PageQuery, g as exchangeSchema, R as RelayEvent, b as ParticipantActivity } from './pages-BBYD21IE.js';
+import { aW as referralAcceptSchema, g as LeaderboardQuery, b as CampaignEnrollmentInput, d as CampaignWithdrawalInput, m as PointHistoryQuery, k as PointEntryKind, a2 as engagementPageQuerySchema } from './groups-D08JtrZu.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-CBa-_u_n.js';
+import { M as MissingPrerequisite, V as ValueEvidence, a as AuthProvider } from './submission-input-BzIWutQi.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, bO as submitSchema, aO as contentPerformanceQuerySchema } from './schema-BPdHSCAc.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';
 
 /** What happened, as in every Domino client error (see `RequestError`). */
 type RelayErrorKind = RequestErrorKind;
+/** @compat open */
 type KnownRelayErrorCode = (typeof RelayErrorCode)[keyof typeof RelayErrorCode];
 /**
  * The machine-readable codes this SDK knows. `RelayError.code` is an open string: Relay can add
@@ -75,21 +76,47 @@ declare const RelayErrorCode: {
     readonly InsufficientPoints: "insufficient-points";
     /** A wallet signer failed or the member refused to sign; `cause` is the wallet's own error. */
     readonly WalletSigner: "wallet-signer";
+    /** The member has not met the quest's prerequisites; `missing` lists them. */
+    readonly PrerequisitesIncomplete: "prerequisites-incomplete";
+    /** The quest is archived or retired: it takes no new participation. */
+    readonly QuestClosed: "quest-closed";
+    /** An operator paused the quest. */
+    readonly QuestPaused: "quest-paused";
+    /** An operator locked the member's profile; hiding it is still allowed. */
+    readonly ProfileLocked: "profile-locked";
+    /** No member in the project has the invitation code the member accepted. */
+    readonly InvitationNotFound: "invitation-not-found";
+    /** The email sign-in code is wrong; the member can type it again. */
+    readonly InvalidCode: "invalid-code";
+    /** The email sign-in code expired, was used or had too many attempts; request another. */
+    readonly CodeExpired: "code-expired";
+    /** The wallet sign-in challenge expired, was used or changed; start sign-in again. */
+    readonly ChallengeExpired: "challenge-expired";
+    /** Too many requests; `retryAfter` says how long to wait when Relay knows. */
+    readonly RateLimited: "rate-limited";
 };
 /** A known code, or one a newer Relay sends. */
 type RelayErrorCode = KnownRelayErrorCode | (string & {});
 type RelayErrorDetails = RequestErrorDetails & {
     code?: RelayErrorCode;
+    /** Which window refused admission when `code` is `outside-window`. */
+    window?: "tracker" | "quest";
     missing?: MissingPrerequisite[];
 };
 declare const relayErrorBrand: unique symbol;
 /** Whether `value` is a `RelayError` from any copy of the SDK. Prefer it to `instanceof`. */
 declare function isRelayError(value: unknown): value is RelayError;
-/** Every error the participant client throws: the shared `RequestError` fields, and `missing`. */
+/**
+ * Every error the participant client throws: the shared `RequestError` fields, and `missing`.
+ *
+ * @compat sealed
+ */
 declare class RelayError extends RequestError {
     readonly name: string;
     readonly [relayErrorBrand] = true;
     readonly code: RelayErrorCode | undefined;
+    /** Which window refused admission when `code` is `outside-window`. */
+    readonly window: "tracker" | "quest" | undefined;
     /** Prerequisites the member does not currently meet, when Relay refused for that reason. */
     readonly missing: MissingPrerequisite[];
     constructor(message: string, details: RelayErrorDetails);
@@ -142,6 +169,8 @@ type SubmissionDraft = {
 /**
  * The quest or quiz changed since the member saw it, so Relay admitted nothing. `draft` holds what
  * the member entered, to show again once they review the quest.
+ *
+ * @compat sealed
  */
 declare class QuestUpdatedError extends RelayError {
     readonly draft: SubmissionDraft | null;
@@ -151,24 +180,6 @@ declare class QuestUpdatedError extends RelayError {
     source?: RelayError);
 }
 
-type ProgressObservation<T = MemberProgress> = {
-    kind: "loading";
-} | {
-    kind: "session";
-    session: ParticipantSession | null;
-} | {
-    kind: "ready";
-    session: ParticipantSession;
-    progress: T;
-} | {
-    kind: "error";
-    error: Error;
-};
-type ProgressObserver = {
-    refresh(): Promise<void>;
-    dispose(): void;
-};
-
 type QuestActionResult = {
     kind: "submitted";
     attempt: Attempt;
@@ -200,7 +211,29 @@ type QuestController = (ActiveController & {
     submit(): Promise<QuestActionResult>;
 });
 
-/** Options every participant client method takes as its last argument. */
+type ProgressObservation<T = MemberProgress> = {
+    kind: "loading";
+} | {
+    kind: "session";
+    session: ParticipantSession | null;
+} | {
+    kind: "ready";
+    session: ParticipantSession;
+    progress: T;
+} | {
+    kind: "error";
+    error: Error;
+};
+type ProgressObserver = {
+    refresh(): Promise<void>;
+    dispose(): void;
+};
+
+/**
+ * Options every participant client method takes as its last argument.
+ *
+ * @compat input
+ */
 type RelayRequestOptions = {
     /**
      * The session ID the app read (`auth.session()`). Relay refuses the call with a `RelayError`
@@ -219,6 +252,7 @@ type RelayRequestOptions = {
      */
     timeout?: number;
 };
+/** @compat input */
 type RelayClientOptions = {
     baseUrl: string;
     token?: string;
@@ -232,7 +266,8 @@ type RelayClientOptions = {
      */
     timeout?: number;
 };
-declare function createRelayClient(options: RelayClientOptions): {
+declare function createRelayClient(options: RelayClientOptions): RelayClient;
+declare function relayClient(options: RelayClientOptions): {
     offers: {
         /** Offers available to this participant, including stock and per-member availability. */
         list: (requestOptions?: RelayRequestOptions) => Promise<{
@@ -1442,6 +1477,7 @@ declare function createRelayClient(options: RelayClientOptions): {
             } | {
                 kind: "blocked";
                 reason: "paused" | "outside-window" | "budget-exhausted" | "connection-required" | "wallet-required" | "enrollment-required";
+                window?: "quest" | "tracker" | undefined;
                 resetsAt?: number | undefined;
             } | {
                 kind: "staff-required";
@@ -1722,6 +1758,7 @@ declare function createRelayClient(options: RelayClientOptions): {
             createdAt: number;
             updatedAt: number;
             automatic?: string | undefined;
+            window?: "quest" | "tracker" | undefined;
         }>;
         /**
          * Why automatic quests did or did not run for the signed-in member's activity, newest first:
@@ -1741,6 +1778,7 @@ declare function createRelayClient(options: RelayClientOptions): {
                 createdAt: number;
                 updatedAt: number;
                 automatic?: string | undefined;
+                window?: "quest" | "tracker" | undefined;
             }[];
             nextCursor: string | null;
         }>;
@@ -2092,6 +2130,7 @@ declare function createRelayClient(options: RelayClientOptions): {
                 } | {
                     kind: "blocked";
                     reason: "paused" | "outside-window" | "budget-exhausted" | "connection-required" | "wallet-required" | "enrollment-required";
+                    window?: "quest" | "tracker" | undefined;
                     resetsAt?: number | undefined;
                 } | {
                     kind: "staff-required";
@@ -2472,6 +2511,7 @@ declare function createRelayClient(options: RelayClientOptions): {
                     } | {
                         kind: "blocked";
                         reason: "paused" | "outside-window" | "budget-exhausted" | "connection-required" | "wallet-required" | "enrollment-required";
+                        window?: "quest" | "tracker" | undefined;
                         resetsAt?: number | undefined;
                     } | {
                         kind: "staff-required";
@@ -2855,6 +2895,7 @@ declare function createRelayClient(options: RelayClientOptions): {
                 } | {
                     kind: "blocked";
                     reason: "paused" | "outside-window" | "budget-exhausted" | "connection-required" | "wallet-required" | "enrollment-required";
+                    window?: "quest" | "tracker" | undefined;
                     resetsAt?: number | undefined;
                 } | {
                     kind: "staff-required";
@@ -3416,17 +3457,7 @@ declare function createRelayClient(options: RelayClientOptions): {
             (quest: string, options?: {
                 input: "photo";
                 release?: string;
-                recoverPrevious
-                /**
-                 * The session ID the app read (`auth.session()`). Relay refuses the call with a `RelayError`
-                 * whose code is `stale-session` if the member's session changed since. Calls Relay binds to a
-                 * session (wallet linking, collection passes, retries) read the current session when omitted.
-                 */
-                ? /**
-                 * The session ID the app read (`auth.session()`). Relay refuses the call with a `RelayError`
-                 * whose code is `stale-session` if the member's session changed since. Calls Relay binds to a
-                 * session (wallet linking, collection passes, retries) read the current session when omitted.
-                 */: boolean;
+                recoverPrevious?: boolean;
                 repeatable?: boolean;
             }): Promise<PhotoSubmission>;
             (quest: string, options: {
@@ -3437,7 +3468,10 @@ declare function createRelayClient(options: RelayClientOptions): {
             }): Promise<QuizSubmission>;
             (quest: string, options: {
                 input: "none";
-                release?: string;
+                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;
                 recoverPrevious?: boolean;
                 repeatable?: boolean;
             }): Promise<ClaimSubmission>;
@@ -3581,6 +3615,7 @@ declare function createRelayClient(options: RelayClientOptions): {
                 } | {
                     kind: "blocked";
                     reason: "paused" | "outside-window" | "budget-exhausted" | "connection-required" | "wallet-required" | "enrollment-required";
+                    window?: "quest" | "tracker" | undefined;
                     resetsAt?: number | undefined;
                 } | {
                     kind: "staff-required";
@@ -4115,6 +4150,11 @@ declare function createRelayClient(options: RelayClientOptions): {
         }>;
     };
     evidence: {
+        /**
+         * @deprecated Never reachable through participant gates: Relay does not serve evidence back
+         * to members, so this always fails with 404. Reviewers download evidence through the
+         * management API. Removed in 2.0.0.
+         */
         download(id: string, requestOptions?: RelayRequestOptions): Promise<Blob>;
     };
     engagement: {
@@ -4267,7 +4307,14 @@ declare function createRelayClient(options: RelayClientOptions): {
         }>;
     };
 };
-/** The participant client `createRelayClient` returns. */
-type RelayClient = ReturnType<typeof createRelayClient>;
+/**
+ * The participant client `createRelayClient` and `createBrowserRelayClient` return. Not for
+ * implementation: only these factories create it, and a 1.x minor release can add methods, so an
+ * object written by hand as a `RelayClient` may stop compiling.
+ *
+ * @compat sealed
+ */
+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 };

package/dist/{groups-Ck-OxzjD.d.ts → groups-D08JtrZu.d.ts}

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { cF as ResourceHandle, cI as GroupHandle } from './schema-DfJzH2ci.js';
+import { cN as ResourceHandle, cQ as GroupHandle } from './schema-BPdHSCAc.js';
 
 declare const pointLedgerPropertiesSchema: z.ZodObject<{
     name: z.ZodString;
@@ -72,6 +72,7 @@ declare const pointBalancesSchema: z.ZodObject<{
         available: z.ZodNumber;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+/** @compat open */
 type KnownPointEntryKind = (typeof PointEntryKind)[keyof typeof PointEntryKind];
 /**
  * The point entry kinds this SDK knows. `PointEntry.kind` is an open string: Relay can add kinds,
@@ -333,6 +334,42 @@ declare const engagementChangePreviewSchema: z.ZodObject<{
         pending: z.ZodString;
     }, z.core.$strict>;
 }, z.core.$strict>;
+/**
+ * One page of an engagement rule's published versions, newest first. Unlike the strict definition
+ * authoring validates, a published version as read keeps parsing when a newer server adds fields.
+ */
+declare const engagementRuleVersionPageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        version: z.ZodString;
+        definition: z.ZodObject<{
+            budgets: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                scope: z.ZodEnum<{
+                    member: "member";
+                    project: "project";
+                }>;
+                period: z.ZodEnum<{
+                    lifetime: "lifetime";
+                    day: "day";
+                    week: "week";
+                    month: "month";
+                }>;
+                limit: z.ZodNumber;
+            }, z.core.$strip>>>;
+            key: z.ZodString;
+            qualifiedBy: z.ZodString;
+            balance: z.ZodString;
+            metrics: z.ZodArray<z.ZodString>;
+            baseline: z.ZodLiteral<"historical">;
+            maxAgeMs: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>;
+        publishedAt: z.ZodNumber;
+        previousVersion: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/** @compat output */
+type EngagementRuleVersionPage = z.infer<typeof engagementRuleVersionPageSchema>;
+/** @deprecated Use `engagementRuleVersionPageSchema`. Removed in 2.0.0. */
 declare const engagementVersionPageSchema: z.ZodObject<{
     items: z.ZodArray<z.ZodObject<{
         version: z.ZodString;
@@ -362,6 +399,7 @@ declare const engagementVersionPageSchema: z.ZodObject<{
     }, z.core.$strict>>;
     next: z.ZodNullable<z.ZodNumber>;
 }, z.core.$strict>;
+/** @deprecated Use `management.engagement.ruleVersions(rule, { cursor })`. Removed in 2.0.0. */
 declare const engagementVersionQuerySchema: z.ZodObject<{
     rule: z.ZodString;
     before: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
@@ -1539,6 +1577,35 @@ declare const pointsEntrySchema: z.ZodObject<{
     reason: z.ZodString;
     actor: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * One page of a member's entries in one point ledger, as operators read them, the most recently
+ * recorded first. Pass `nextCursor` back as `cursor` for the next page.
+ */
+declare const managedPointHistoryPageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        completion: z.ZodNullable<z.ZodString>;
+        member: z.ZodString;
+        balance: z.ZodString;
+        amount: z.ZodNumber;
+        kind: z.ZodEnum<{
+            reverse: "reverse";
+            award: "award";
+            spend: "spend";
+            adjust: "adjust";
+        }>;
+        effectiveAt: z.ZodNumber;
+        receivedAt: z.ZodNumber;
+        quest: z.ZodNullable<z.ZodString>;
+        original: z.ZodNullable<z.ZodString>;
+        reason: z.ZodString;
+        actor: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+    next: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+/** @compat output */
+type ManagedPointHistoryPage = z.infer<typeof managedPointHistoryPageSchema>;
 declare const pointsResultSchema: z.ZodObject<{
     entry: z.ZodObject<{
         id: z.ZodString;
@@ -1573,6 +1640,10 @@ declare const leaderboardExclusionSchema: z.ZodObject<{
     excluded: z.ZodBoolean;
     reason: z.ZodString;
 }, z.core.$strict>;
+/**
+ * @deprecated Use `addGroupMemberSchema` and `removeGroupMemberSchema` (`management.groups`)
+ * instead. Removed in 2.0.0.
+ */
 declare const leaderboardGroupSchema: z.ZodObject<{
     actionId: z.ZodString;
     member: z.ZodString;
@@ -2105,6 +2176,27 @@ declare const referralAcceptSchema: z.ZodObject<{
     actionId: z.ZodString;
     code: z.ZodString;
 }, z.core.$strict>;
+/** `management.referrals.suspend(member, input)`: suspends or restores a member's referral. */
+declare const referralSuspensionSchema: z.ZodObject<{
+    actionId: z.ZodString;
+    suspended: z.ZodBoolean;
+    reason: z.ZodString;
+}, z.core.$strict>;
+/** `management.referrals.qualify(program, member, input)`: qualifies or unqualifies a member. */
+declare const referralQualificationSchema: z.ZodObject<{
+    actionId: z.ZodString;
+    qualified: z.ZodBoolean;
+    reason: z.ZodString;
+}, z.core.$strict>;
+/** `management.referrals.resolveReward(entitlement, input)`: clears a referral reward's review. */
+declare const referralRewardResolutionSchema: z.ZodObject<{
+    actionId: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strict>;
+/**
+ * The 1.0 body of `POST /referrals/control`, with every ID in the body.
+ * @deprecated Use `referralSuspensionSchema`, `referralQualificationSchema` or `referralRewardResolutionSchema` with `management.referrals.suspend`, `qualify` or `resolveReward`. Removed in 2.0.0.
+ */
 declare const referralControlSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"suspend">;
     actionId: z.ZodString;
@@ -2281,6 +2373,11 @@ declare const referralHistorySchema: z.ZodObject<{
     }, z.core.$strip>>;
     nextCursor: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * One page of the project's referral relationships, newest first, with the qualifications and
+ * accounts of the members they name and the referral rewards waiting for review. Pass `nextCursor`
+ * back as `cursor` for the next page.
+ */
 declare const referralManagementSchema: z.ZodObject<{
     relationships: z.ZodArray<z.ZodObject<{
         member: z.ZodString;
@@ -2315,6 +2412,7 @@ declare const referralManagementSchema: z.ZodObject<{
         program: z.ZodString;
         reason: z.ZodString;
     }, z.core.$strip>>;
+    nextCursor: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     next: z.ZodNullable<z.ZodNumber>;
 }, z.core.$strip>;
 
@@ -2438,12 +2536,86 @@ declare const projectGroupAuthoringSchema: z.ZodPipe<z.ZodObject<{
     key: string;
     title?: string | undefined;
 }>>;
-/** Define one project group for prerequisites, leaderboards, and referrals. */
+/**
+ * Define one project group for prerequisites, leaderboards, and referrals. The handle names the
+ * group by its key; operators create the group and manage its members in Console or with
+ * `management.groups`.
+ */
 declare function defineGroup(input: Omit<z.input<typeof projectGroupAuthoringSchema>, "key" | "id"> & AuthoringIdentity): {
     key: string;
     title: string;
 } & ResourceHandle<"group">;
 type ProjectGroupReference = GroupHandle;
 declare function projectGroupKey(group: ProjectGroupReference): string;
+/** Creates a group under `key`, the name prerequisites, leaderboards and referral rules use. */
+declare const createGroupSchema: z.ZodObject<{
+    actionId: z.ZodString;
+    key: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strict>;
+/** Renames a group. Its key, members and history stay. */
+declare const updateGroupSchema: z.ZodObject<{
+    title: z.ZodString;
+}, z.core.$strict>;
+/** Adds `member` to a group, with a reason for the audit history. */
+declare const addGroupMemberSchema: z.ZodObject<{
+    actionId: z.ZodString;
+    member: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strict>;
+/** Removes the member the path names from a group, with a reason for the audit history. */
+declare const removeGroupMemberSchema: z.ZodObject<{
+    actionId: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strict>;
+/** One page of groups or of a group's members: pass `nextCursor` back as `cursor`. */
+declare const groupPageQuerySchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+    /** Items per page, 1–100; the default is 50. */
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+type GroupPageQuery = z.input<typeof groupPageQuerySchema>;
+/**
+ * A group as operators manage it, with the number of its current members. An archived group
+ * keeps its members, and prerequisites, leaderboards and referral rules still read them, but its
+ * membership cannot change until it is unarchived.
+ */
+declare const managedGroupSchema: z.ZodObject<{
+    key: z.ZodString;
+    title: z.ZodString;
+    members: z.ZodNumber;
+    createdAt: z.ZodNumber;
+    archivedAt: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+/** @compat output */
+type ManagedGroup = z.infer<typeof managedGroupSchema>;
+declare const groupPageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        title: z.ZodString;
+        members: z.ZodNumber;
+        createdAt: z.ZodNumber;
+        archivedAt: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/** @compat output */
+type GroupPage = z.infer<typeof groupPageSchema>;
+/** A current member of a group. `addedAt` is null when Relay has no record of when they joined. */
+declare const groupMemberSchema: z.ZodObject<{
+    member: z.ZodString;
+    addedAt: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+/** @compat output */
+type GroupMember = z.infer<typeof groupMemberSchema>;
+declare const groupMemberPageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        member: z.ZodString;
+        addedAt: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/** @compat output */
+type GroupMemberPage = z.infer<typeof groupMemberPageSchema>;
 
-export { engagementSettlementSchema as $, type AvailabilityWindow as A, campaignViewSchema as B, type CampaignDefinition as C, campaignWithdrawalInputSchema as D, type EngagementBudget as E, createPointLedgerSchema as F, defineCampaign as G, defineGroup as H, engagementArtifactSchema as I, engagementBoundaryPageSchema as J, type KnownPointEntryKind as K, type LeaderboardDefinition as L, type MemberCampaignEnrollmentInput as M, engagementBudgetSchema as N, engagementChangePreviewInputSchema as O, type PointBalance as P, engagementChangePreviewSchema as Q, type ReferralDefinition as R, engagementChangeSchema as S, engagementDefinitionSchema as T, engagementDeploymentEntrySchema as U, engagementPageQuerySchema as V, engagementPageSchema as W, engagementPublishSchema as X, engagementRuleSchema as Y, engagementScoreInputSchema as Z, engagementScoreSchema as _, type CampaignEnrollment as a, engagementVersionPageSchema as a0, engagementVersionQuerySchema as a1, leaderboardArtifactSchema as a2, leaderboardAuthoringSchema as a3, leaderboardDefinitionSchema as a4, leaderboardExclusionSchema as a5, leaderboardGroupSchema as a6, leaderboardPageSchema as a7, leaderboardPlacementSchema as a8, leaderboardPreviewSchema as a9, pointsMutationSchema as aA, pointsResultSchema as aB, projectGroupKey as aC, projectGroupSchema as aD, publishedLeaderboardSchema as aE, publishedReferralSchema as aF, referralAcceptSchema as aG, referralAccountSchema as aH, referralArtifactSchema as aI, referralAuthoringSchema as aJ, referralControlSchema as aK, referralDefinitionSchema as aL, referralHistorySchema as aM, referralManagementSchema as aN, referralRelationshipSchema as aO, referralSummarySchema as aP, type AuthoringIdentity as aQ, leaderboardPrizeRewardSchema as aa, leaderboardPrizeSchema as ab, leaderboardQuerySchema as ac, leaderboardRowSchema as ad, leaderboardSettlementApprovalSchema as ae, leaderboardSettlementPolicySchema as af, leaderboardSettlementRowSchema as ag, leaderboardSettlementSchema as ah, leaderboardSettlementStatusSchema as ai, leaderboardSettlementSummarySchema as aj, leaderboardWindowSchema as ak, managedPointLedgerSchema as al, memberCampaignEnrollmentInputSchema as am, memberCampaignWithdrawalInputSchema as an, pointBalanceSchema as ao, pointBalancesSchema as ap, pointEntrySchema as aq, pointHistoryPageSchema as ar, pointHistoryQuerySchema as as, pointLedgerArtifactSchema as at, pointLedgerDeclarationSchema as au, pointLedgerPropertiesSchema as av, pointLedgerReferenceSchema as aw, pointLedgerSchema as ax, pointsAccountSchema as ay, pointsEntrySchema as az, type CampaignEnrollmentInput as b, 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 LeaderboardSettlement as r, type LeaderboardSettlementPolicy as s, type LeaderboardSettlementSummary as t, type ManagedPointLedger as u, type PointLedger as v, availabilityWindowSchema as w, campaignDefinitionSchema as x, campaignEnrollmentInputSchema as y, campaignEnrollmentSchema as z };
+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 };

package/dist/{identity-integration-GxAHdKR2.d.ts → identity-integration-BPovus6e.d.ts}

@@ -1,4 +1,4 @@
-import { O as OpenIdentityKind } from './schema-DfJzH2ci.js';
+import { O as OpenIdentityKind } from './schema-BPdHSCAc.js';
 import { z } from 'zod';
 
 declare const identityIntegrationInputSchema: z.ZodObject<{

package/dist/{images-Dv-P5VBw.d.ts → images-D7en0Awp.d.ts}

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { P as PhotoResult } from './schema-DfJzH2ci.js';
+import { P as PhotoResult } from './schema-BPdHSCAc.js';
 
 /**
  * Quest code names an image; the platform fetches, decodes and pins it. No bytes or URLs cross the

package/dist/index.d.ts

@@ -1,13 +1,13 @@
-export { C as ClaimSubmission, K as KnownRelayErrorCode, P as PhotoSubmission, a as ProgressObservation, b as ProgressObserver, Q as QuestActionResult, c as QuestController, d as QuestUpdatedError, e as QuizSubmission, R as RelayClient, f as RelayClientOptions, g as RelayError, h as RelayErrorCode, i as RelayErrorDetails, j as RelayErrorKind, k as RelayRequestOptions, S as SubmissionDraft, l as SubmissionStatus, m as SubmissionStore, V as ValueSubmission, n as createRelayClient, o as isRelayError } from './client-gqnRUHpC.js';
-export { R as RequestError, a as RequestErrorDetails, b as RequestErrorKind, c as RequestRecovery, i as isRequestError } from './request-error-DWduJCGV.js';
-export { A as Attempt, a as AttemptStatus, E as Entitlement, b as EvaluatorProgress, K as KnownAttemptStatus, c as KnownTrackerSkipCode, M as MemberProgress, Q as QuestBudgetView, d as QuestPresentation, e as QuestProfile, f as QuizEvidence, R as Reward, S as SubmissionEvidence, g as SubmitInput, T as TieredRewardReference, h as TrackerSkipCode } from './schema-DfJzH2ci.js';
+export { C as ClaimSubmission, K as KnownRelayErrorCode, P as PhotoSubmission, a as ProgressObservation, b as ProgressObserver, Q as QuestActionResult, c as QuestController, d as QuestUpdatedError, e as QuizSubmission, R as RelayClient, f as RelayClientOptions, g as RelayError, h as RelayErrorCode, i as RelayErrorDetails, j as RelayErrorKind, k as RelayRequestOptions, S as SubmissionDraft, l as SubmissionStatus, m as SubmissionStore, V as ValueSubmission, n as createRelayClient, o as isRelayError } from './client-CQuTAjSs.js';
+export { R as RequestError, a as RequestErrorDetails, b as RequestErrorKind, c as RequestRecovery, i as isRequestError } from './request-error-D_dUPLwo.js';
+export { A as Attempt, a as AttemptStatus, E as Entitlement, b as EvaluatorProgress, K as KnownAttemptStatus, c as KnownTrackerSkipCode, M as MemberProgress, Q as QuestBudgetView, d as QuestPresentation, e as QuestProfile, f as QuizEvidence, R as Reward, S as SubmissionEvidence, g as SubmitInput, T as TieredRewardReference, h as TrackerSkipCode } from './schema-BPdHSCAc.js';
 export { f as formatUnits, p as parseUnits } from './units-CwgsPB_r.js';
-export { A as AccountConnection, a as AuthProvider, M as MissingPrerequisite, P as Prerequisite, T as TextEvidence, b as TextOptions, U as UrlEvidence, c as UrlOptions, V as ValueEvidence } from './submission-input-BZkm6ohU.js';
-export { E as ExchangeInput, M as MemberSummary, P as Page, a as PageQuery, b as ParticipantActivity, c as ParticipantPrincipal, d as ParticipantSession, R as RelayEvent, S as Session, s as sessionMember } from './pages-BBYD21IE.js';
-export { Q as QuestClaimInput, a as QuestEnrollment, b as QuestEnrollmentInput, c as QuestInteraction, d as QuestOutcome, e as QuestOutcomePage, f as QuestOutcomeQuery, g as QuestOutcomeState, h as QuestRewardView, i as QuestView } from './outcomes-kVB-Juzs.js';
-export { A as AvailabilityWindow, C as CampaignDefinition, a as CampaignEnrollment, b as CampaignEnrollmentInput, c as CampaignView, d as CampaignWithdrawalInput, K as KnownPointEntryKind, L as LeaderboardDefinition, e as LeaderboardPage, f as LeaderboardPlacement, g as LeaderboardQuery, M as MemberCampaignEnrollmentInput, h as MemberCampaignWithdrawalInput, P as PointBalance, i as PointBalances, j as PointEntry, k as PointEntryKind, l as PointHistoryPage, m as PointHistoryQuery, n as PointLedgerReference, o as ProjectGroup, p as ProjectGroupReference, R as ReferralDefinition } from './groups-Ck-OxzjD.js';
-export { A as AutomaticCatchUpPreview, a as AutomaticEvent, b as AutomaticOutcome, C as CollectionPass, c as CounterAchievement, d as CounterPolicy, e as CounterProgress } from './automatic-outcomes-B1xrETxm.js';
-export { O as Offer, a as OfferDefinition, b as OfferPrice, R as RedeemOfferInput, c as Redemption } from './offers-Cy-e4o5x.js';
+export { A as AccountConnection, a as AuthProvider, M as MissingPrerequisite, P as Prerequisite, T as TextEvidence, b as TextOptions, U as UrlEvidence, c as UrlOptions, V as ValueEvidence } from './submission-input-BzIWutQi.js';
+export { E as ExchangeInput, M as MemberSummary, P as ParticipantActivity, a as ParticipantPrincipal, b as ParticipantSession, R as RelayEvent, S as Session, s as sessionMember } from './participant-activity-DkL3nY5a.js';
+export { P as Page, a as PageQuery, Q as QuestClaimInput, b as QuestEnrollment, c as QuestEnrollmentInput, d as QuestInteraction, e as QuestOutcome, f as QuestOutcomePage, g as QuestOutcomeQuery, h as QuestOutcomeState, i as QuestRewardView, j as QuestView } from './pages-CBa-_u_n.js';
+export { A as AvailabilityWindow, C as CampaignDefinition, a as CampaignEnrollment, b as CampaignEnrollmentInput, c as CampaignView, d as CampaignWithdrawalInput, K as KnownPointEntryKind, L as LeaderboardDefinition, e as LeaderboardPage, f as LeaderboardPlacement, g as LeaderboardQuery, M as MemberCampaignEnrollmentInput, h as MemberCampaignWithdrawalInput, P as PointBalance, i as PointBalances, j as PointEntry, k as PointEntryKind, l as PointHistoryPage, m as PointHistoryQuery, n as PointLedgerReference, o as ProjectGroup, p as ProjectGroupReference, R as ReferralDefinition } from './groups-D08JtrZu.js';
+export { A as AutomaticCatchUpPreview, a as AutomaticEvent, b as AutomaticOutcome, C as CollectionPass, c as CounterAchievement, d as CounterPolicy, e as CounterProgress } from './automatic-outcomes-DmuqzQiH.js';
+export { O as Offer, a as OfferDefinition, b as OfferPrice, R as RedeemOfferInput, c as Redemption } from './offers-BENZl5l5.js';
 export { A as AvatarProvider, O as OwnProfile, P as ProfileAvatar, a as ProfileCompletion, b as ProfileCompletionPage, c as ProfileCompletionQuery, d as ProfileReferral, e as ProfileSummary, f as ProfileUpdate, g as ProfileVisibility } from './profiles-D2aFcOxu.js';
 export { Q as QuizContent, S as StreakProgress } from './streaks-CWyq8Px5.js';
 export { C as CosmosChain, a as CosmosNetwork, L as LinkedWallet, W as WalletAddressInput, b as WalletChain, c as WalletMessageChallenge, d as WalletSignInNetwork, e as WalletSignature, f as WalletSigner, g as WalletUnlinkInput } from './wallet-YssWxGg8.js';