@domino-sdk/relay 1.61.0 → 1.62.0

package/dist/pages-B8q8Y_dQ.d.ts

@@ -0,0 +1,715 @@
+import * as z from 'zod';
+import { T as TrackerSkipCode } from './tracker-data-Hb1uQnk5.js';
+
+/**
+ * The delivery actions this SDK knows. `RewardDelivery.action` is an open string: Relay can add
+ * actions, and a delivery keeps one this SDK does not list. Show such a delivery by its status.
+ */
+declare const RewardDeliveryAction: {
+    /** Delivers a quest's Discord role reward. */
+    readonly GrantRole: "grant-role";
+    /**
+     * Posts a quest's announcement in a Telegram chat or Discord channel. Its `provider` is
+     * `telegram` or `discord`, and its `roleId` is empty.
+     */
+    readonly PostMessage: "post-message";
+};
+/** A known action, or one a newer Relay sends. */
+type RewardDeliveryAction = (typeof RewardDeliveryAction)[keyof typeof RewardDeliveryAction] | (string & {});
+declare const roleReconciliationSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        pending: "pending";
+        removed: "removed";
+        failed: "failed";
+        preserved: "preserved";
+        granted: "granted";
+    }>;
+    ownership: z.ZodEnum<{
+        external: "external";
+        relay: "relay";
+        unclaimed: "unclaimed";
+    }>;
+    at: z.ZodNumber;
+    reason: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+declare const knownRewardDeliverySchema: z.ZodObject<{
+    id: z.ZodString;
+    quest: z.ZodString;
+    completion: z.ZodString;
+    member: z.ZodString;
+    provider: z.ZodLiteral<"discord">;
+    action: z.ZodType<RewardDeliveryAction, unknown, z.core.$ZodTypeInternals<RewardDeliveryAction, unknown>>;
+    roleId: z.ZodString;
+    status: z.ZodEnum<{
+        pending: "pending";
+        failed: "failed";
+        delivered: "delivered";
+    }>;
+    attempts: z.ZodNumber;
+    nextAt: z.ZodNumber;
+    lastError: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodNumber;
+    deliveredAt: z.ZodNullable<z.ZodNumber>;
+    dispatchedAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    revokedAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    reconciliation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        status: z.ZodEnum<{
+            pending: "pending";
+            removed: "removed";
+            failed: "failed";
+            preserved: "preserved";
+            granted: "granted";
+        }>;
+        ownership: z.ZodEnum<{
+            external: "external";
+            relay: "relay";
+            unclaimed: "unclaimed";
+        }>;
+        at: z.ZodNumber;
+        reason: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+declare const rewardDeliverySchema: z.ZodUnion<readonly [z.ZodObject<{
+    id: z.ZodString;
+    quest: z.ZodString;
+    completion: z.ZodString;
+    member: z.ZodString;
+    provider: z.ZodLiteral<"discord">;
+    action: z.ZodType<RewardDeliveryAction, unknown, z.core.$ZodTypeInternals<RewardDeliveryAction, unknown>>;
+    roleId: z.ZodString;
+    status: z.ZodEnum<{
+        pending: "pending";
+        failed: "failed";
+        delivered: "delivered";
+    }>;
+    attempts: z.ZodNumber;
+    nextAt: z.ZodNumber;
+    lastError: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodNumber;
+    deliveredAt: z.ZodNullable<z.ZodNumber>;
+    dispatchedAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    revokedAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    reconciliation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        status: z.ZodEnum<{
+            pending: "pending";
+            removed: "removed";
+            failed: "failed";
+            preserved: "preserved";
+            granted: "granted";
+        }>;
+        ownership: z.ZodEnum<{
+            external: "external";
+            relay: "relay";
+            unclaimed: "unclaimed";
+        }>;
+        at: z.ZodNumber;
+        reason: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$catchall<z.ZodOptional<z.ZodJSONSchema>>>, z.ZodObject<{
+    id: z.ZodString;
+    quest: z.ZodString;
+    completion: z.ZodString;
+    member: z.ZodString;
+    action: z.ZodType<RewardDeliveryAction, unknown, z.core.$ZodTypeInternals<RewardDeliveryAction, unknown>>;
+    attempts: z.ZodNumber;
+    nextAt: z.ZodNumber;
+    lastError: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodNumber;
+    deliveredAt: z.ZodNullable<z.ZodNumber>;
+    dispatchedAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    revokedAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    provider: z.ZodString;
+    status: z.ZodString;
+    roleId: z.ZodOptional<z.ZodString>;
+    reconciliation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        status: z.ZodString;
+        ownership: z.ZodString;
+        at: z.ZodNumber;
+        reason: z.ZodNullable<z.ZodString>;
+    }, z.core.$catchall<z.ZodJSONSchema>>>>;
+}, z.core.$catchall<z.ZodOptional<z.ZodJSONSchema>>>]>;
+/**
+ * One page of reward deliveries, newest first. Pass `nextCursor` back as `cursor` for older ones;
+ * it is null on the last page.
+ */
+declare const rewardDeliveriesSchema: z.ZodObject<{
+    deliveries: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        id: z.ZodString;
+        quest: z.ZodString;
+        completion: z.ZodString;
+        member: z.ZodString;
+        provider: z.ZodLiteral<"discord">;
+        action: z.ZodType<RewardDeliveryAction, unknown, z.core.$ZodTypeInternals<RewardDeliveryAction, unknown>>;
+        roleId: z.ZodString;
+        status: z.ZodEnum<{
+            pending: "pending";
+            failed: "failed";
+            delivered: "delivered";
+        }>;
+        attempts: z.ZodNumber;
+        nextAt: z.ZodNumber;
+        lastError: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodNumber;
+        deliveredAt: z.ZodNullable<z.ZodNumber>;
+        dispatchedAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        revokedAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        reconciliation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            status: z.ZodEnum<{
+                pending: "pending";
+                removed: "removed";
+                failed: "failed";
+                preserved: "preserved";
+                granted: "granted";
+            }>;
+            ownership: z.ZodEnum<{
+                external: "external";
+                relay: "relay";
+                unclaimed: "unclaimed";
+            }>;
+            at: z.ZodNumber;
+            reason: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$catchall<z.ZodOptional<z.ZodJSONSchema>>>, z.ZodObject<{
+        id: z.ZodString;
+        quest: z.ZodString;
+        completion: z.ZodString;
+        member: z.ZodString;
+        action: z.ZodType<RewardDeliveryAction, unknown, z.core.$ZodTypeInternals<RewardDeliveryAction, unknown>>;
+        attempts: z.ZodNumber;
+        nextAt: z.ZodNumber;
+        lastError: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodNumber;
+        deliveredAt: z.ZodNullable<z.ZodNumber>;
+        dispatchedAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        revokedAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        provider: z.ZodString;
+        status: z.ZodString;
+        roleId: z.ZodOptional<z.ZodString>;
+        reconciliation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            status: z.ZodString;
+            ownership: z.ZodString;
+            at: z.ZodNumber;
+            reason: z.ZodNullable<z.ZodString>;
+        }, z.core.$catchall<z.ZodJSONSchema>>>>;
+    }, z.core.$catchall<z.ZodOptional<z.ZodJSONSchema>>>]>>;
+    nextCursor: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Which page of reward deliveries to read: a page's `nextCursor` as `cursor`, and `limit`, 1 to
+ * 500 deliveries a page, 500 by default.
+ */
+declare const rewardDeliveryQuerySchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;
+type RewardDeliveryQuery = z.input<typeof rewardDeliveryQuerySchema>;
+type RewardDelivery = z.infer<typeof rewardDeliverySchema>;
+/**
+ * A Discord role the project's reward deliveries grant, with every delivery of it counted, however
+ * old. `quests` names the quests whose completions requested it.
+ */
+declare const discordRoleRewardSchema: z.ZodObject<{
+    roleId: z.ZodString;
+    quests: z.ZodArray<z.ZodString>;
+    deliveries: z.ZodObject<{
+        pending: z.ZodNumber;
+        delivered: z.ZodNumber;
+        failed: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** Every Discord role the project's reward deliveries grant, in this environment, by role ID. */
+declare const discordRoleRewardsSchema: z.ZodObject<{
+    roles: z.ZodArray<z.ZodObject<{
+        roleId: z.ZodString;
+        quests: z.ZodArray<z.ZodString>;
+        deliveries: z.ZodObject<{
+            pending: z.ZodNumber;
+            delivered: z.ZodNumber;
+            failed: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type DiscordRoleReward = z.infer<typeof discordRoleRewardSchema>;
+
+/**
+ * The longest wording Relay stores: a checkbox label with a link to the policy fits.
+ *
+ * @experimental A minor release can change the consent API.
+ */
+declare const consentWordingMaxLength = 2000;
+/**
+ * The channels Relay records consent for. A later Relay may add others.
+ *
+ * @experimental A minor release can change the consent API.
+ */
+declare const knownConsentChannels: readonly ["email"];
+/**
+ * A channel this SDK knows.
+ *
+ * @compat open
+ * @experimental A minor release can change the consent API.
+ */
+type KnownConsentChannel = (typeof knownConsentChannels)[number];
+/**
+ * A consent channel: one of `knownConsentChannels`, or one a later Relay adds.
+ *
+ * @experimental A minor release can change the consent API.
+ */
+type ConsentChannel = KnownConsentChannel | (string & {});
+/**
+ * A consent state this SDK knows: the member opted in, or opted out.
+ *
+ * @compat open
+ * @experimental A minor release can change the consent API.
+ */
+type KnownConsentState = "granted" | "withdrawn";
+/**
+ * A consent state, or one a later Relay adds.
+ *
+ * @experimental A minor release can change the consent API.
+ */
+type ConsentState = KnownConsentState | (string & {});
+/**
+ * Where a consent record came from: `member`, the member's own choice in the app, or `imported`,
+ * consent a member import carried over from the platform the member came from, with the time and
+ * wording that platform recorded.
+ *
+ * @compat open
+ * @experimental A minor release can change the consent API.
+ */
+type KnownConsentSource = "member" | "imported";
+/**
+ * A consent source, or one a later Relay adds.
+ *
+ * @experimental A minor release can change the consent API.
+ */
+type ConsentSource = KnownConsentSource | (string & {});
+/**
+ * The signed-in member's current consent on one channel (`relay.consent.get()`). `at` is when
+ * Relay recorded it, in epoch milliseconds, by Relay's clock; `wording` is the text the member saw,
+ * as the app sent it, or null for a withdrawal sent without one.
+ *
+ * @compat output
+ * @experimental A minor release can change the consent API.
+ */
+type MemberConsent = {
+    member: string;
+    channel: ConsentChannel;
+    state: ConsentState;
+    at: number;
+    wording: string | null;
+    source: ConsentSource;
+};
+/**
+ * Parses one channel's consent as Relay sends it.
+ *
+ * @experimental A minor release can change the consent API.
+ */
+declare const memberConsentSchema: z.ZodType<MemberConsent>;
+/**
+ * The signed-in member's consent, one entry per channel they ever chose on. A channel with no
+ * entry has no record: the member was never asked, which is not the same as withdrawn.
+ *
+ * @experimental A minor release can change the consent API.
+ */
+declare const memberConsentListSchema: z.ZodArray<z.ZodType<MemberConsent, unknown, z.core.$ZodTypeInternals<MemberConsent, unknown>>>;
+/**
+ * `relay.consent.set()`: grant or withdraw one channel. `wording` is the exact text the app showed
+ * beside the checkbox, required to grant and optional to withdraw. Relay stamps the time; a call
+ * that repeats the current state and wording records nothing and answers the current state.
+ *
+ * Relay refuses an unknown channel with `unsupported-consent-channel`, a grant without wording
+ * with `consent-wording-required`, wording over `consentWordingMaxLength` characters with
+ * `consent-wording-too-long`, and wording that is not text (a NUL or a lone surrogate) with
+ * `consent-wording-invalid`.
+ *
+ * @compat input
+ * @experimental A minor release can change the consent API.
+ */
+type ConsentInput = {
+    actionId: string;
+    channel: KnownConsentChannel;
+    granted: boolean;
+    wording?: string;
+};
+/**
+ * Parses a consent change. It checks the shape only: Relay decides the channel and wording rules,
+ * so every caller gets the same refusal codes.
+ *
+ * @experimental A minor release can change the consent API.
+ */
+declare const consentInputSchema: z.ZodObject<{
+    actionId: z.ZodString;
+    channel: z.ZodCustom<"email", "email">;
+    granted: z.ZodBoolean;
+    wording: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * A consent change as the participant route sends it to the ledger, for the session's member.
+ *
+ * @experimental A minor release can change the consent API.
+ */
+declare const memberConsentInputSchema: z.ZodObject<{
+    actionId: z.ZodString;
+    member: z.ZodString;
+    channel: z.ZodString;
+    granted: z.ZodBoolean;
+    wording: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * One page of a member's consent history for operators (`management.members.consentHistory()`):
+ * every change on every channel, newest first, never edited. Pass `nextCursor` back as `cursor`
+ * for the next page; it is null on the last page.
+ *
+ * @compat output
+ * @experimental A minor release can change the consent API.
+ */
+type MemberConsentHistory = {
+    items: MemberConsent[];
+    nextCursor: string | null;
+};
+/**
+ * Parses one page of a member's consent history as Relay sends it.
+ *
+ * @experimental A minor release can change the consent API.
+ */
+declare const memberConsentHistorySchema: z.ZodType<MemberConsentHistory>;
+/**
+ * Which page of a member's consent history to read: `cursor` from the previous page, and up to
+ * `limit` entries (1 to 100), 50 when omitted.
+ *
+ * @experimental A minor release can change the consent API.
+ */
+declare const memberConsentHistoryQuerySchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;
+
+declare const responseFormat: unique symbol;
+/** A schema whose output explicitly represents unsupported server variants. */
+type ResponseSchema<T> = z.ZodType<T> & {
+    readonly [responseFormat]: true;
+};
+/**
+ * A separate reader for a known wire shape. Input schemas are never mutated. Object fields
+ * are stripped at every depth; collection quotas do not constrain a server response.
+ * Child shapes convert on first parse or schema introspection, sharing each converted node.
+ */
+declare function responseShape<S extends z.core.$ZodType>(schema: S): S;
+/** The original wire entity. No action is inferred from its unknown variant. */
+type UnsupportedResponse = {
+    kind: "unsupported";
+    raw: z.infer<ReturnType<typeof z.json>>;
+};
+/** @compat output */
+type ResponseResult<T> = {
+    kind: "supported";
+    value: T;
+} | UnsupportedResponse;
+/**
+ * Opt-in response contract for a complete entity or operation. A new variant keeps the whole
+ * raw entity; semantic arrays such as requirements and rewards remain atomic.
+ */
+declare function responseSchema<T>(schema: z.ZodType<T>): ResponseSchema<ResponseResult<T>>;
+/** An entity list is complete only when `unsupportedCount` is zero. Item order is retained. */
+declare function responseListSchema<T>(schema: z.ZodType<T>): ResponseSchema<{
+    items: ResponseResult<T>[];
+    unsupportedCount: number;
+}>;
+
+/** The creator-account providers this SDK knows. A later Relay may list others. */
+declare const knownCreatorAccountProviders: readonly ["youtube", "tiktok"];
+/** A creator-account provider: one of `knownCreatorAccountProviders`, or one a later Relay adds. */
+type CreatorAccountProvider = (typeof knownCreatorAccountProviders)[number] | (string & {});
+declare const creatorAccountProviderSchema: z.ZodCustom<CreatorAccountProvider, CreatorAccountProvider>;
+/**
+ * A member's account on one creator platform, as `AccountConnection` describes sign-in accounts.
+ * `subject` is the platform's stable account ID (a YouTube channel ID, `UC…`, or a TikTok
+ * `open_id`); `profile` is the
+ * public name, handle and picture the platform reported when the member linked it. `reconnect`
+ * means Relay can no longer read the account and the member must link it again.
+ *
+ * @compat output
+ */
+declare const creatorAccountSchema: z.ZodObject<{
+    provider: z.ZodCustom<CreatorAccountProvider, CreatorAccountProvider>;
+    configured: z.ZodBoolean;
+    status: z.ZodEnum<{
+        disconnected: "disconnected";
+        connected: "connected";
+        reconnect: "reconnect";
+    }>;
+    subject: z.ZodNullable<z.ZodString>;
+    revision: z.ZodNumber;
+    profile: z.ZodNullable<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        username: z.ZodOptional<z.ZodString>;
+        imageUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type CreatorAccount = z.infer<typeof creatorAccountSchema>;
+/**
+ * The member's creator accounts: one per provider the platform configured.
+ *
+ * @compat output
+ */
+declare const creatorAccountsSchema: z.ZodObject<{
+    accounts: z.ZodArray<z.ZodObject<{
+        provider: z.ZodCustom<CreatorAccountProvider, CreatorAccountProvider>;
+        configured: z.ZodBoolean;
+        status: z.ZodEnum<{
+            disconnected: "disconnected";
+            connected: "connected";
+            reconnect: "reconnect";
+        }>;
+        subject: z.ZodNullable<z.ZodString>;
+        revision: z.ZodNumber;
+        profile: z.ZodNullable<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            username: z.ZodOptional<z.ZodString>;
+            imageUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type CreatorAccounts = z.infer<typeof creatorAccountsSchema>;
+
+declare const contentQualificationDecisionSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        accept: "accept";
+        reject: "reject";
+        review: "review";
+        defer: "defer";
+        progress: "progress";
+        superseded: "superseded";
+    }>;
+    reason: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+declare const contentQualificationQuerySchema: z.ZodObject<{
+    quest: z.ZodString;
+    member: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodString>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+declare const contentQualificationSchema: z.ZodObject<{
+    quest: z.ZodString;
+    content: z.ZodString;
+    member: z.ZodString;
+    release: z.ZodString;
+    attempt: z.ZodString;
+    revision: z.ZodString;
+    observation: z.ZodString;
+    current: z.ZodBoolean;
+    state: z.ZodEnum<{
+        pending: "pending";
+        superseded: "superseded";
+        qualified: "qualified";
+        unqualified: "unqualified";
+        "needs-review": "needs-review";
+        failed: "failed";
+        stale: "stale";
+        blocked: "blocked";
+        unavailable: "unavailable";
+    }>;
+    reason: z.ZodNullable<z.ZodString>;
+    reward: z.ZodObject<{
+        attempt: z.ZodNullable<z.ZodString>;
+        completion: z.ZodNullable<z.ZodString>;
+        state: z.ZodEnum<{
+            awarded: "awarded";
+            excluded: "excluded";
+            unresolved: "unresolved";
+        }>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+declare const contentQualificationPageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        quest: z.ZodString;
+        content: z.ZodString;
+        member: z.ZodString;
+        release: z.ZodString;
+        attempt: z.ZodString;
+        revision: z.ZodString;
+        observation: z.ZodString;
+        current: z.ZodBoolean;
+        state: z.ZodEnum<{
+            pending: "pending";
+            superseded: "superseded";
+            qualified: "qualified";
+            unqualified: "unqualified";
+            "needs-review": "needs-review";
+            failed: "failed";
+            stale: "stale";
+            blocked: "blocked";
+            unavailable: "unavailable";
+        }>;
+        reason: z.ZodNullable<z.ZodString>;
+        reward: z.ZodObject<{
+            attempt: z.ZodNullable<z.ZodString>;
+            completion: z.ZodNullable<z.ZodString>;
+            state: z.ZodEnum<{
+                awarded: "awarded";
+                excluded: "excluded";
+                unresolved: "unresolved";
+            }>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+/** A content metric's name, as its source declares it, such as `likes`. */
+declare const contentMetricSchema: z.ZodString;
+type ContentMetric = z.infer<typeof contentMetricSchema>;
+/** Measured counters by metric name. A metric a sample leaves out is unknown, never zero. */
+declare const contentMetricsSchema: z.ZodRecord<z.ZodString, z.ZodNumber>;
+/** Which declared metrics a content quest's performance stage reads, and how fresh they must be. */
+declare const contentPerformancePolicySchema: z.ZodObject<{
+    metrics: z.ZodArray<z.ZodString>;
+    maxAgeMs: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+type ContentPerformancePolicy = z.infer<typeof contentPerformancePolicySchema>;
+
+/** `relay.quests.enroll()`: the signed-in member enrolls in a quest that requires enrollment. */
+declare const questEnrollmentInputSchema: z.ZodObject<{
+    actionId: z.ZodString;
+    quest: z.ZodString;
+}, z.core.$strict>;
+type QuestEnrollmentInput = z.input<typeof questEnrollmentInputSchema>;
+/** `management.quests.enroll()`: a server enrolls a member, vouching for their consent. */
+declare const memberEnrollmentInputSchema: z.ZodObject<{
+    actionId: z.ZodString;
+    quest: z.ZodString;
+    member: z.ZodString;
+}, z.core.$strict>;
+type MemberEnrollmentInput = z.input<typeof memberEnrollmentInputSchema>;
+/**
+ * A member's active enrollment in a quest. Enrolling again changes nothing; an operator can
+ * withdraw it, after which enrollment starts a new consent period.
+ */
+declare const questEnrollmentSchema: z.ZodObject<{
+    quest: z.ZodString;
+    member: z.ZodString;
+    enrolledAt: z.ZodNumber;
+}, z.core.$strip>;
+type QuestEnrollment = z.infer<typeof questEnrollmentSchema>;
+/**
+ * `relay.quests.claim()`: the signed-in member claims one of their outcomes skipped as
+ * `historical`, on a quest whose historical policy is `"claim"`. Relay decides it again under the
+ * quest's current release with historical activity released; any other rule can still skip it.
+ */
+declare const questClaimInputSchema: z.ZodObject<{
+    actionId: z.ZodString;
+    quest: z.ZodString;
+    tracker: z.ZodString;
+    record: z.ZodString;
+    observedAt: z.ZodNumber;
+}, z.core.$strict>;
+type QuestClaimInput = z.input<typeof questClaimInputSchema>;
+/**
+ * The outcome states this SDK knows: an automatic decision `admitted` an attempt or was `skipped`.
+ */
+declare const QuestOutcomeState: {
+    readonly Admitted: "admitted";
+    readonly Skipped: "skipped";
+};
+type QuestOutcomeState = (typeof QuestOutcomeState)[keyof typeof QuestOutcomeState];
+/**
+ * One automatic decision about the signed-in member's activity: a quest admitted an attempt for a
+ * tracker record observation, or skipped it with a stable code. Only decisions Relay attributed to
+ * the member are theirs to read; a record no member has linked yet names nobody.
+ */
+declare const questOutcomeSchema: z.ZodObject<{
+    automatic: z.ZodOptional<z.ZodString>;
+    quest: z.ZodString;
+    tracker: z.ZodNullable<z.ZodString>;
+    record: z.ZodNullable<z.ZodString>;
+    observedAt: z.ZodNullable<z.ZodNumber>;
+    state: z.ZodEnum<{
+        admitted: "admitted";
+        skipped: "skipped";
+    }>;
+    code: z.ZodType<TrackerSkipCode | null>;
+    reason: z.ZodNullable<z.ZodString>;
+    window: z.ZodOptional<z.ZodEnum<{
+        quest: "quest";
+        tracker: "tracker";
+    }>>;
+    attempt: z.ZodNullable<z.ZodString>;
+    claimable: z.ZodBoolean;
+    createdAt: z.ZodNumber;
+    updatedAt: z.ZodNumber;
+}, z.core.$strip>;
+type QuestOutcome = z.infer<typeof questOutcomeSchema>;
+/** `relay.quests.outcomes()`: newest first, optionally one quest, state or code. */
+declare const questOutcomeQuerySchema: z.ZodObject<{
+    quest: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodEnum<{
+        admitted: "admitted";
+        skipped: "skipped";
+    }>>;
+    code: z.ZodOptional<z.ZodString>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type QuestOutcomeQuery = z.input<typeof questOutcomeQuerySchema>;
+declare const questOutcomePageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        automatic: z.ZodOptional<z.ZodString>;
+        quest: z.ZodString;
+        tracker: z.ZodNullable<z.ZodString>;
+        record: z.ZodNullable<z.ZodString>;
+        observedAt: z.ZodNullable<z.ZodNumber>;
+        state: z.ZodEnum<{
+            admitted: "admitted";
+            skipped: "skipped";
+        }>;
+        code: z.ZodType<TrackerSkipCode | null>;
+        reason: z.ZodNullable<z.ZodString>;
+        window: z.ZodOptional<z.ZodEnum<{
+            quest: "quest";
+            tracker: "tracker";
+        }>>;
+        attempt: z.ZodNullable<z.ZodString>;
+        claimable: z.ZodBoolean;
+        createdAt: z.ZodNumber;
+        updatedAt: z.ZodNumber;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type QuestOutcomePage = z.infer<typeof questOutcomePageSchema>;
+
+/** A cursor as a client passes it back. */
+declare const pageCursorSchema: z.ZodString;
+/** A query that pages by cursor only. */
+declare const pageQuerySchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type PageQuery = z.input<typeof pageQuerySchema>;
+/** One page of a paged read. */
+type Page<T> = {
+    items: T[];
+    nextCursor: string | null;
+};
+/**
+ * Every item of a paged read, page by page as the loop asks for them: `read` gets `undefined` for
+ * the first page, then each page's `nextCursor`, until one is `null`. Any paged participant or
+ * management read fits, with its own query and call options:
+ *
+ * ```ts
+ * for await (const entry of paginate((cursor) => relay.referrals.history({ cursor }))) {
+ *   console.log(entry)
+ * }
+ * ```
+ *
+ * A rejected read rejects the loop; breaking out of the loop reads no further pages.
+ *
+ * A feed never ends: `me.activity.list` answers a `nextCursor` on every page, even an empty one,
+ * so the loop over it never finishes on its own. Stop it yourself, when a page comes back empty or
+ * after as many items as you need, or follow the feed with `me.activity.observe`.
+ */
+declare function paginate<T>(read: (cursor: string | undefined) => Promise<Page<T>>): AsyncGenerator<T, void, undefined>;
+/** A management state page with an operator-selected size. */
+declare const managementStateQuerySchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;
+type ManagementStateQuery = z.input<typeof managementStateQuerySchema>;
+
+export { memberConsentInputSchema as $, consentInputSchema as A, consentWordingMaxLength as B, type ConsentChannel as C, type DiscordRoleReward as D, contentMetricSchema as E, contentMetricsSchema as F, contentPerformancePolicySchema as G, contentQualificationDecisionSchema as H, contentQualificationPageSchema as I, contentQualificationSchema as J, type KnownConsentChannel as K, creatorAccountProviderSchema as L, type MemberConsent as M, creatorAccountSchema as N, creatorAccountsSchema as O, type Page as P, type QuestClaimInput as Q, type ResponseResult as R, discordRoleRewardSchema as S, discordRoleRewardsSchema as T, type UnsupportedResponse as U, knownConsentChannels as V, knownCreatorAccountProviders as W, knownRewardDeliverySchema as X, managementStateQuerySchema as Y, memberConsentHistoryQuerySchema as Z, memberConsentHistorySchema as _, type ConsentInput as a, memberConsentListSchema as a0, memberConsentSchema as a1, memberEnrollmentInputSchema as a2, pageCursorSchema as a3, pageQuerySchema as a4, questClaimInputSchema as a5, questEnrollmentInputSchema as a6, questEnrollmentSchema as a7, questOutcomePageSchema as a8, questOutcomeQuerySchema as a9, questOutcomeSchema as aa, responseListSchema as ab, responseSchema as ac, responseShape as ad, rewardDeliveriesSchema as ae, rewardDeliveryQuerySchema as af, rewardDeliverySchema as ag, roleReconciliationSchema as ah, type ConsentSource as b, type ConsentState as c, type CreatorAccount as d, type CreatorAccountProvider as e, type CreatorAccounts as f, type KnownConsentSource as g, type KnownConsentState as h, type PageQuery as i, type QuestEnrollment as j, type QuestEnrollmentInput as k, type QuestOutcome as l, type QuestOutcomePage as m, type QuestOutcomeQuery as n, QuestOutcomeState as o, paginate as p, type ResponseSchema as q, type RewardDeliveryQuery as r, RewardDeliveryAction as s, contentQualificationQuerySchema as t, type ContentMetric as u, type ContentPerformancePolicy as v, type ManagementStateQuery as w, type MemberConsentHistory as x, type MemberEnrollmentInput as y, type RewardDelivery as z };