@domino-sdk/relay 1.18.1 → 1.20.0

package/dist/{client-93pUw04R.d.ts → client-DSlycgar.d.ts}

@@ -3,7 +3,7 @@ import { j as QuestView, k as ResponseSchema, a as PageQuery, c as QuestEnrollme
 import { M as MissingPrerequisite, V as ValueEvidence } from './submission-input-BEJ9qENg.js';
 import { a as RequestError, b as RequestErrorDetails, c as RequestErrorKind, e as createRelayAction, O as OptionalActionId } from './action-DBzILFx9.js';
 import { f as QuizEvidence, A as Attempt, M as MemberProgress, a as AttemptStatus, h as TrackerSkipCode, cg as submitSchema, be as contentPerformanceQuerySchema } from './schema-Br3c1GOu.js';
-import { b as ParticipantSession, d as exchangeSchema, R as RelayEvent, P as ParticipantActivity } from './participant-activity-DYdUUhw2.js';
+import { b as ParticipantSession, f as exchangeSchema, R as RelayEvent, P as ParticipantActivity } from './telegram-DALZ7GdF.js';
 import { z } from 'zod';
 import { a as AuthProvider } from './accounts-5ciAkCMP.js';
 import { F as profileUpdateSchema, c as ProfileCompletionQuery } from './profiles-D29SS12z.js';
@@ -3392,6 +3392,10 @@ declare function relayClient(options: RelayClientOptions): {
             email: boolean;
             wallets: ("solana" | "eip155" | "cosmos")[];
             demo: boolean;
+            telegram?: {
+                login: boolean;
+                miniApp: boolean;
+            } | undefined;
         }>;
         start: (provider: AuthProvider, mode: "sign-in" | "connect", requestOptions?: RelayRequestOptions) => Promise<{
             url: string;
@@ -3477,6 +3481,63 @@ declare function relayClient(options: RelayClientOptions): {
                 environment: "test" | "live";
             }>;
         };
+        /**
+         * Telegram sign-in and the member's Telegram account. Telegram is not an `AuthProvider` in
+         * SDK 1.x, so `accounts()`, `start()` and `disconnect()` leave it out and these take its place.
+         */
+        telegram: {
+            /**
+             * Leaves for Telegram Login when the platform configured it (`providers().telegram.login`):
+             * `"sign-in"` signs in, or signs up; `"connect"` links Telegram to the signed-in member.
+             */
+            start: (mode: "sign-in" | "connect", requestOptions?: RelayRequestOptions) => Promise<{
+                url: string;
+            }>;
+            /** The member's Telegram account. */
+            account: (requestOptions?: RelayRequestOptions) => Promise<{
+                configured: boolean;
+                status: "disconnected" | "connected" | "reconnect";
+                subject: string | null;
+                revision: number;
+                provider: "telegram";
+            }>;
+            /** Unlinks the member's Telegram account, as `disconnect()` does for the other providers. */
+            disconnect: (requestOptions?: RelayRequestOptions) => Promise<{
+                ok: boolean;
+            }>;
+            /**
+             * Sign-in inside a Telegram Mini App, where the project enabled it in Console
+             * (`providers().telegram.miniApp`). Pass the Mini App's signed launch data,
+             * `telegramMiniAppInitData()`. Relay checks Telegram's signature for the project's bot and
+             * accepts launch data at most five minutes old, once.
+             */
+            miniApp: {
+                /** Signs in, or signs up, as the Telegram user who opened the Mini App. */
+                signIn: (initData: string, requestOptions?: RelayRequestOptions) => Promise<{
+                    id: string;
+                    principal: {
+                        kind: "member";
+                        member: string;
+                    } | {
+                        kind: "staff";
+                        subject: string;
+                    } | {
+                        kind: "operator";
+                        subject: string;
+                    } | {
+                        kind: string;
+                    };
+                    expiresAt: number;
+                    organization: string;
+                    project: string;
+                    environment: "test" | "live";
+                }>;
+                /** Links the Telegram user who opened the Mini App to the signed-in member. */
+                connect: (initData: string, requestOptions?: RelayRequestOptions) => Promise<{
+                    ok: boolean;
+                }>;
+            };
+        };
         /** The member's connected sign-in accounts, one per provider. */
         accounts: (requestOptions?: RelayRequestOptions) => Promise<{
             provider: "discord" | "google" | "apple" | "x";

package/dist/{deployments-Cz-tNK7Z.d.ts → deployments-nNS4spO9.d.ts}

@@ -873,6 +873,19 @@ declare const projectDeploymentSchema: z.ZodObject<{
         settingRenames: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     }, z.core.$strict>>>;
 }, z.core.$strict>;
+/**
+ * Something the deployment publishes that won't work until the project is configured. Warnings
+ * never block publication. `integration-required`: the quests in `quests` (authoring keys) need the
+ * project's `integration` connection, and their attempts fail with `integration-required` until it
+ * is ready. Treat an unknown `code`, which a newer Relay can add, as a notice its `message` explains.
+ */
+declare const deploymentWarningSchema: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    integration: z.ZodOptional<z.ZodString>;
+    quests: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type DeploymentWarning = z.infer<typeof deploymentWarningSchema>;
 declare const deploymentPreviewSchema: z.ZodObject<{
     id: z.ZodString;
     engagement: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -2366,6 +2379,12 @@ declare const deploymentPreviewSchema: z.ZodObject<{
         timeZone: z.ZodString;
         effectiveAt: z.ZodNullable<z.ZodNumber>;
     }, z.core.$strip>>>;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        integration: z.ZodOptional<z.ZodString>;
+        quests: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 /**
  * The 1.0 body of `POST /deployments/publish`, with the deployment's ID.
@@ -3867,6 +3886,12 @@ declare const deploymentResultSchema: z.ZodObject<{
         timeZone: z.ZodString;
         effectiveAt: z.ZodNullable<z.ZodNumber>;
     }, z.core.$strip>>>;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        integration: z.ZodOptional<z.ZodString>;
+        quests: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
     revision: z.ZodNumber;
 }, z.core.$strip>;
 declare const deploymentSourceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -5371,6 +5396,12 @@ declare const deploymentRecordSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         timeZone: z.ZodString;
         effectiveAt: z.ZodNullable<z.ZodNumber>;
     }, z.core.$strip>>>;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        integration: z.ZodOptional<z.ZodString>;
+        quests: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
     status: z.ZodLiteral<"preview">;
     source: z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"direct">;
@@ -6876,6 +6907,12 @@ declare const deploymentRecordSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         timeZone: z.ZodString;
         effectiveAt: z.ZodNullable<z.ZodNumber>;
     }, z.core.$strip>>>;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        integration: z.ZodOptional<z.ZodString>;
+        quests: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
     status: z.ZodLiteral<"pending">;
     submittedAt: z.ZodNumber;
     submittedBy: z.ZodNullable<z.ZodString>;
@@ -8383,6 +8420,12 @@ declare const deploymentRecordSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         timeZone: z.ZodString;
         effectiveAt: z.ZodNullable<z.ZodNumber>;
     }, z.core.$strip>>>;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        integration: z.ZodOptional<z.ZodString>;
+        quests: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
     status: z.ZodLiteral<"rejected">;
     decidedAt: z.ZodNumber;
     decidedBy: z.ZodNullable<z.ZodString>;
@@ -9893,6 +9936,12 @@ declare const deploymentRecordSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         timeZone: z.ZodString;
         effectiveAt: z.ZodNullable<z.ZodNumber>;
     }, z.core.$strip>>>;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        integration: z.ZodOptional<z.ZodString>;
+        quests: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
     revision: z.ZodNumber;
     status: z.ZodLiteral<"published">;
     submittedAt: z.ZodNullable<z.ZodNumber>;
@@ -9956,4 +10005,4 @@ declare const rollbackDeploymentSchema: z.ZodObject<{
 type DeploymentPreview = z.infer<typeof deploymentPreviewSchema>;
 type DeploymentRecord = z.infer<typeof deploymentRecordSchema>;
 
-export { type CalendarPeriod as C, type DeploymentPreview as D, type ProjectCalendar as P, type DeploymentRecord as a, type ProjectCalendarInput as b, activityTypeSchema as c, activityTypes as d, calendarPeriodSchema as e, canonicalTimeZone as f, deploymentActionSchema as g, deploymentPreviewSchema as h, deploymentRecordSchema as i, deploymentRejectionSchema as j, deploymentResultSchema as k, deploymentSourceSchema as l, projectCalendarInputSchema as m, projectCalendarSchema as n, projectCatalogArtifactSchema as o, projectCalendarDeclarationSchema as p, projectDeploymentSchema as q, promoteDeploymentSchema as r, publishDeploymentSchema as s, refuseStreakTimeZone as t, refuseWindowTimeZone as u, rejectDeploymentSchema as v, rollbackDeploymentSchema as w, submitDeploymentSchema as x, timeZoneNameSchema as y, timeZoneSchema as z };
+export { timeZoneNameSchema as A, timeZoneSchema as B, type CalendarPeriod as C, type DeploymentPreview as D, type ProjectCalendar as P, type DeploymentRecord as a, type DeploymentWarning as b, type ProjectCalendarInput as c, activityTypeSchema as d, activityTypes as e, calendarPeriodSchema as f, canonicalTimeZone as g, deploymentActionSchema as h, deploymentPreviewSchema as i, deploymentRecordSchema as j, deploymentRejectionSchema as k, deploymentResultSchema as l, deploymentSourceSchema as m, deploymentWarningSchema as n, projectCalendarInputSchema as o, projectCalendarDeclarationSchema as p, projectCalendarSchema as q, projectCatalogArtifactSchema as r, projectDeploymentSchema as s, promoteDeploymentSchema as t, publishDeploymentSchema as u, refuseStreakTimeZone as v, refuseWindowTimeZone as w, rejectDeploymentSchema as x, rollbackDeploymentSchema as y, submitDeploymentSchema as z };

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 export { B as Badge, M as ManagedBadge, a as MemberBadge, b as MemberBadges, O as Offer, c as OfferDefinition, d as OfferPrice, R as RedeemOfferInput, e as Redemption } from './offers-CPqiF3dZ.js';
 export { R as RelayAction, a as RequestError, b as RequestErrorDetails, c as RequestErrorKind, d as RequestRecovery, e as createRelayAction, i as isRequestError } from './action-DBzILFx9.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, l as RelayResponseOptions, S as SubmissionDraft, m as SubmissionStatus, n as SubmissionStore, V as ValueSubmission, o as createRelayClient, p as isRelayError } from './client-93pUw04R.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, l as RelayResponseOptions, S as SubmissionDraft, m as SubmissionStatus, n as SubmissionStore, V as ValueSubmission, o as createRelayClient, p as isRelayError } from './client-DSlycgar.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-Br3c1GOu.js';
 export { f as formatUnits, p as parseUnits } from './units-CwgsPB_r.js';
 export { A as AccountConnection, a as AuthProvider } from './accounts-5ciAkCMP.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-DYdUUhw2.js';
+export { E as ExchangeInput, M as MemberSummary, P as ParticipantActivity, a as ParticipantPrincipal, b as ParticipantSession, R as RelayEvent, S as Session, T as TelegramAccountConnection, c as TelegramSignInMethods, s as sessionMember } from './telegram-DALZ7GdF.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, R as ResponseResult, U as UnsupportedResponse } from './pages-1h1387a3.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-jLLG7MML.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-BBSdMf0R.js';

package/dist/index.js

@@ -5,18 +5,18 @@ import {
 import {
   QuestUpdatedError,
   createRelayClient
-} from "./chunk-YGWB6GH3.js";
+} from "./chunk-OJOR6VEB.js";
 import {
   createRelayAction
 } from "./chunk-T47OFHHX.js";
 import {
   QuestOutcomeState
-} from "./chunk-IE4QOQUI.js";
+} from "./chunk-5ZRDK4KQ.js";
 import {
   PointEntryKind
 } from "./chunk-XSLRNFIY.js";
 import "./chunk-5P5PTZ3T.js";
-import "./chunk-GTM3XNMQ.js";
+import "./chunk-FEUMOQIM.js";
 import {
   sessionMember
 } from "./chunk-YXAK2637.js";

package/dist/internal.d.ts

@@ -1,4 +1,4 @@
-export { I as IdentityKindClaim, M as ManagementTransportOptions, P as ParticipantRoute, R as REFERRAL_INTEGRATION_REWARD_ERROR, c as containsReferralIntegrationReward, i as identityIntegrationInputSchema, a as identityIntegrationSchema, b as identityIntegrationSecretSchema, d as identityKindClaimSchema, e as isIntegrationParticipantPath, f as isParticipantRoute, m as managementTransport, p as parseImageExtraction, g as parseImageResult, h as participantExchangeSchema, j as participantRoutePattern, k as participantRoutes, q as questConfiguration, s as sequenceCursorSchema, l as sourceDataSchema, n as sourceRoles, v as validateQuestShape } from './transport-CVac_nGZ.js';
+export { I as IdentityKindClaim, M as ManagementTransportOptions, P as ParticipantRoute, R as REFERRAL_INTEGRATION_REWARD_ERROR, c as containsReferralIntegrationReward, i as identityIntegrationInputSchema, a as identityIntegrationSchema, b as identityIntegrationSecretSchema, d as identityKindClaimSchema, e as isIntegrationParticipantPath, f as isParticipantRoute, m as managementTransport, p as parseImageExtraction, g as parseImageResult, h as participantExchangeSchema, j as participantRoutePattern, k as participantRoutes, q as questConfiguration, s as sequenceCursorSchema, l as sourceDataSchema, n as sourceRoles, v as validateQuestShape } from './transport-DE2MMVjr.js';
 export { E as Extracted } from './images-BPiPqVKn.js';
 import { c as RequestErrorKind } from './action-DBzILFx9.js';
 export { i as TrackerDataBudget, s as schemaCheckedReader, t as trackerDataBatchSteps, j as trackerDataIssue, k as trackerDataIssues, l as trackerDataPathTypes, m as trackerDataRecordSteps, w as whereSchemaIssue } from './schema-Br3c1GOu.js';
@@ -9,7 +9,7 @@ import './groups-jLLG7MML.js';
 import './profiles-D29SS12z.js';
 import './automatic-outcomes-BBSdMf0R.js';
 import './attempt-captures-ByzZyggX.js';
-import './deployments-Cz-tNK7Z.js';
+import './deployments-nNS4spO9.js';
 
 /** The management client's and the CLI's default deadline per call. */
 declare const MANAGEMENT_TIMEOUT = 30000;

package/dist/internal.js

@@ -9,7 +9,7 @@ import {
   participantExchangeSchema,
   questConfiguration,
   sequenceCursorSchema
-} from "./chunk-UEPEKXOC.js";
+} from "./chunk-5TQ6452M.js";
 import {
   parseImageExtraction,
   parseImageResult
@@ -25,14 +25,14 @@ import {
   isParticipantRoute,
   participantRoutePattern,
   participantRoutes
-} from "./chunk-UIHPWC4C.js";
+} from "./chunk-USVER53M.js";
 import {
   MANAGEMENT_TIMEOUT,
   lifetime,
   retryAfter,
   retrying
 } from "./chunk-5P5PTZ3T.js";
-import "./chunk-GTM3XNMQ.js";
+import "./chunk-FEUMOQIM.js";
 import "./chunk-YXAK2637.js";
 import {
   schemaCheckedReader,

package/dist/portal-proxy.js

@@ -1,9 +1,9 @@
 import {
   isParticipantRoute
-} from "./chunk-UIHPWC4C.js";
+} from "./chunk-USVER53M.js";
 import {
   clientIdentity
-} from "./chunk-GTM3XNMQ.js";
+} from "./chunk-FEUMOQIM.js";
 import {
   exchangeResultSchema
 } from "./chunk-YXAK2637.js";

package/dist/react/index.d.ts

@@ -1,6 +1,7 @@
 import { B as Badge, b as MemberBadges, O as Offer, e as Redemption } from '../offers-CPqiF3dZ.js';
-import { b as ParticipantSession, R as RelayEvent, P as ParticipantActivity, M as MemberSummary } from '../participant-activity-DYdUUhw2.js';
-import { g as RelayError, R as RelayClient, S as SubmissionDraft } from '../client-93pUw04R.js';
+import { b as ParticipantSession, R as RelayEvent, P as ParticipantActivity, M as MemberSummary } from '../telegram-DALZ7GdF.js';
+export { T as TelegramAccountConnection, c as TelegramSignInMethods } from '../telegram-DALZ7GdF.js';
+import { g as RelayError, R as RelayClient, S as SubmissionDraft } from '../client-DSlycgar.js';
 import { P as Page, y as collectionViewSchema, j as QuestView, g as QuestOutcomeQuery, e as QuestOutcome } from '../pages-1h1387a3.js';
 import * as react from 'react';
 import { ReactNode } from 'react';
@@ -8,8 +9,8 @@ import { J as JSONType } from '../util.d-w9f9t3ua.js';
 import { z } from 'zod';
 import { E as Entitlement, a as AttemptStatus, T as TieredRewardReference } from '../schema-Br3c1GOu.js';
 import { a as AuthProvider, A as AccountConnection } from '../accounts-5ciAkCMP.js';
-import { c as SignInMethods, C as CosmosChains, d as SignInOption, f as SignInUnavailable, g as SignInWallet, D as DiscoveredWallet } from '../sign-in-options--25uHySG.js';
-export { a as EmailSignInOption, O as OAuthSignInOption, b as SignInIcon, W as WalletSignInOption } from '../sign-in-options--25uHySG.js';
+import { c as SignInMethods, C as CosmosChains, d as SignInOption, f as SignInUnavailable, T as TelegramSignInOption, g as SignInWallet, D as DiscoveredWallet } from '../telegram-browser-CGB01TaB.js';
+export { a as EmailSignInOption, O as OAuthSignInOption, b as SignInIcon, W as WalletSignInOption, t as telegramMiniAppInitData } from '../telegram-browser-CGB01TaB.js';
 import { f as WalletSigner, d as WalletSignInNetwork, L as LinkedWallet } from '../wallet-CDyo-U4n.js';
 import { f as LeaderboardPlacement, b7 as referralSummarySchema, e as LeaderboardPage, i as PointBalances, j as PointEntry, n as PointLedgerReference } from '../groups-jLLG7MML.js';
 import { f as ProfileUpdate, e as ProfileSummary, a as ProfileCompletion, d as ProfileReferral } from '../profiles-D29SS12z.js';
@@ -1371,6 +1372,13 @@ declare function useSignIn(): {
     withProvider: (provider: OAuthProvider) => Promise<void>;
     /** Signs in, or signs up, with a wallet; the wallet asks the participant to sign a message. */
     withWallet: (signer: WalletSigner) => Promise<void>;
+    /** Leaves for Telegram Login, where the platform configured it. */
+    withTelegram: () => Promise<void>;
+    /**
+     * Signs in, or signs up, inside a Telegram Mini App the project enabled, with its launch data
+     * (`telegramMiniAppInitData()`).
+     */
+    withTelegramMiniApp: (initData: string) => Promise<void>;
 };
 /**
  * Signs the participant out: `mutate()`, which never rejects, or `mutateAsync()`, which rejects
@@ -1406,6 +1414,8 @@ declare function useSignInOptions(input?: {
 }): {
     options: SignInOption[] | null;
     unavailable: SignInUnavailable[];
+    /** Telegram Login, to render beside `options`; null when the platform did not configure it. */
+    telegram: TelegramSignInOption | null;
     /** Why the project's methods could not be read; the options are then email alone. */
     methodsError: RelayError | null;
     /** True while a sign-in action runs. */
@@ -1500,6 +1510,79 @@ declare function useAccounts(): {
     error: RelayError | null;
     refresh(): Promise<void>;
 };
+/**
+ * The signed-in participant's Telegram account in `data`. Telegram is not one of `useAccounts()`'s
+ * providers in SDK 1.x, so it has this hook of its own, with the same behavior: `connect()` leaves
+ * for Telegram Login, `connectMiniApp(initData)` links the user who opened a Telegram Mini App,
+ * and a failure lands in `actionError`.
+ */
+declare function useTelegramAccount(): {
+    connect: () => Promise<boolean>;
+    connectMiniApp: (initData: string) => Promise<boolean>;
+    disconnect: () => Promise<boolean>;
+    isPending: boolean;
+    actionError: RelayError | null;
+    resetAction: () => void;
+    retry: () => Promise<boolean>;
+    settle: () => boolean;
+    /** True when the account can be used to verify quests right now. */
+    isConnected: boolean;
+    status: "loading";
+    data: undefined;
+    error: null;
+    refresh(): Promise<void>;
+} | {
+    connect: () => Promise<boolean>;
+    connectMiniApp: (initData: string) => Promise<boolean>;
+    disconnect: () => Promise<boolean>;
+    isPending: boolean;
+    actionError: RelayError | null;
+    resetAction: () => void;
+    retry: () => Promise<boolean>;
+    settle: () => boolean;
+    /** True when the account can be used to verify quests right now. */
+    isConnected: boolean;
+    status: "error";
+    data: undefined;
+    error: RelayError;
+    refresh(): Promise<void>;
+} | {
+    connect: () => Promise<boolean>;
+    connectMiniApp: (initData: string) => Promise<boolean>;
+    disconnect: () => Promise<boolean>;
+    isPending: boolean;
+    actionError: RelayError | null;
+    resetAction: () => void;
+    retry: () => Promise<boolean>;
+    settle: () => boolean;
+    /** True when the account can be used to verify quests right now. */
+    isConnected: boolean;
+    status: "signed-out";
+    data: undefined;
+    error: null;
+    refresh(): Promise<void>;
+} | {
+    connect: () => Promise<boolean>;
+    connectMiniApp: (initData: string) => Promise<boolean>;
+    disconnect: () => Promise<boolean>;
+    isPending: boolean;
+    actionError: RelayError | null;
+    resetAction: () => void;
+    retry: () => Promise<boolean>;
+    settle: () => boolean;
+    /** True when the account can be used to verify quests right now. */
+    isConnected: boolean;
+    status: "ready";
+    data: {
+        configured: boolean;
+        status: "disconnected" | "connected" | "reconnect";
+        subject: string | null;
+        revision: number;
+        provider: "telegram";
+    };
+    error: RelayError | null;
+    refresh(): Promise<void>;
+};
 
 /**
  * The signed-in participant's linked Solana, EVM and Cosmos wallets, in `data`.
@@ -1864,4 +1947,4 @@ declare function usePointLedgers(): Query<PointLedgerReference[]>;
  */
 declare function useTieredRewards(): Query<TieredRewardReference[]>;
 
-export { type Collection, CosmosChains, DiscoveredWallet, type ExperienceData, type Invitation, type KnownQuestStatusCode, type KnownRoleDeliveryStatus, type MemberPagedQuery, type MemberQuery, type MemberQueryOptions, type MemberSnapshot, type Mutation, type MutationContext, type MutationOptions, type MutationStatus, type OAuthProvider, Page, type PageLoader, type PageRead, type PagedQuery, type Query, type QueryContext, type QueryKey, type QueryOptions, type QueryRead, type QuerySnapshot, type QuestInput, type QuestNotice, type QuestStatus, type QuestStatusCode, type QuestStatusText, type QuestTone, type ReferralSummary, type RelayActionResult, RelayClient, type RelayPolling, RelayProvider, type RelayQueryOptions, type RoleDelivery, type RoleDeliveryStatus, type SavedSubmission, SignInMethods, SignInOption, SignInUnavailable, SignInWallet, canRepeat, canSubmit, captureReferralCode, completionCountText, isAutomatic, isConnected, isFinished, progressOf, questGroups, questStatus, questStatusText, relayKeys, roleDeliveryLabel, roleDeliveryStatus, useAccounts, useActivity, useBadgeCatalog, useBadges, useBalances, useDeliveries, useEntitlements, useExperience, useInvalidate, useInvitation, useLeaderboard, useLeaderboardPlacement, useMe, useMemberPages, useMemberQuery, useMyProfile, useOffers, usePointHistory, usePointLedgers, useProfile, useProfileBadges, useProfileCompletions, useProfileReferral, useQuest, useQuestOutcomes, useRedeemOffer, useReferralSummary, useRelay, useRelayAction, useRelayMutation, useRelayPages, useRelayQuery, useSession, useSetQueryData, useSignIn, useSignInMethods, useSignInOptions, useSignInWallets, useSignOut, useTieredRewards, useWalletDiscovery, useWallets };
+export { type Collection, CosmosChains, DiscoveredWallet, type ExperienceData, type Invitation, type KnownQuestStatusCode, type KnownRoleDeliveryStatus, type MemberPagedQuery, type MemberQuery, type MemberQueryOptions, type MemberSnapshot, type Mutation, type MutationContext, type MutationOptions, type MutationStatus, type OAuthProvider, Page, type PageLoader, type PageRead, type PagedQuery, type Query, type QueryContext, type QueryKey, type QueryOptions, type QueryRead, type QuerySnapshot, type QuestInput, type QuestNotice, type QuestStatus, type QuestStatusCode, type QuestStatusText, type QuestTone, type ReferralSummary, type RelayActionResult, RelayClient, type RelayPolling, RelayProvider, type RelayQueryOptions, type RoleDelivery, type RoleDeliveryStatus, type SavedSubmission, SignInMethods, SignInOption, SignInUnavailable, SignInWallet, TelegramSignInOption, canRepeat, canSubmit, captureReferralCode, completionCountText, isAutomatic, isConnected, isFinished, progressOf, questGroups, questStatus, questStatusText, relayKeys, roleDeliveryLabel, roleDeliveryStatus, useAccounts, useActivity, useBadgeCatalog, useBadges, useBalances, useDeliveries, useEntitlements, useExperience, useInvalidate, useInvitation, useLeaderboard, useLeaderboardPlacement, useMe, useMemberPages, useMemberQuery, useMyProfile, useOffers, usePointHistory, usePointLedgers, useProfile, useProfileBadges, useProfileCompletions, useProfileReferral, useQuest, useQuestOutcomes, useRedeemOffer, useReferralSummary, useRelay, useRelayAction, useRelayMutation, useRelayPages, useRelayQuery, useSession, useSetQueryData, useSignIn, useSignInMethods, useSignInOptions, useSignInWallets, useSignOut, useTelegramAccount, useTieredRewards, useWalletDiscovery, useWallets };

package/dist/react/index.js

@@ -7,16 +7,17 @@ import {
   discoverSignInWallets,
   discoverSolanaWallets,
   readSignInMethods,
-  signInOptionsFrom
-} from "../chunk-3IX2IYMQ.js";
-import "../chunk-YGWB6GH3.js";
+  signInOptionsFrom,
+  telegramMiniAppInitData
+} from "../chunk-COT7AUM7.js";
+import "../chunk-OJOR6VEB.js";
 import {
   createRelayAction
 } from "../chunk-T47OFHHX.js";
-import "../chunk-IE4QOQUI.js";
+import "../chunk-5ZRDK4KQ.js";
 import "../chunk-XSLRNFIY.js";
 import "../chunk-5P5PTZ3T.js";
-import "../chunk-GTM3XNMQ.js";
+import "../chunk-FEUMOQIM.js";
 import {
   sessionMember
 } from "../chunk-YXAK2637.js";
@@ -2418,6 +2419,20 @@ function useSignIn() {
     }, "Couldn't start sign-in. Try again."),
     [relay, run]
   );
+  const withTelegram = useCallback7(
+    () => run(async () => {
+      const { url } = await relay.auth.telegram.start("sign-in");
+      window.location.assign(url);
+    }, "Couldn't start Telegram sign-in. Try again."),
+    [relay, run]
+  );
+  const withTelegramMiniApp = useCallback7(
+    (initData) => run(async () => {
+      await relay.auth.telegram.miniApp.signIn(initData);
+      setChallenge(null);
+    }, "Couldn't sign in with Telegram. Reopen the Mini App and try again."),
+    [relay, run, setChallenge]
+  );
   const withWallet = useCallback7(
     (signer) => run(async () => {
       await relay.auth.wallet.signIn(signer);
@@ -2442,7 +2457,14 @@ function useSignIn() {
       startOver,
       withProvider,
       /** Signs in, or signs up, with a wallet; the wallet asks the participant to sign a message. */
-      withWallet
+      withWallet,
+      /** Leaves for Telegram Login, where the platform configured it. */
+      withTelegram,
+      /**
+       * Signs in, or signs up, inside a Telegram Mini App the project enabled, with its launch data
+       * (`telegramMiniAppInitData()`).
+       */
+      withTelegramMiniApp
     }),
     [
       busy,
@@ -2453,7 +2475,9 @@ function useSignIn() {
       verifyCode,
       startOver,
       withProvider,
-      withWallet
+      withWallet,
+      withTelegram,
+      withTelegramMiniApp
     ]
   );
 }
@@ -2495,13 +2519,14 @@ function useSignInOptions(input = {}) {
     sendCode,
     verifyCode,
     withProvider,
-    withWallet
+    withWallet,
+    withTelegram
   } = useSignIn();
   const built = useMemo7(() => {
     if (!methods) {
       return null;
     }
-    if (!wallets && methods.providers.length === 0 && !methods.email) {
+    if (!wallets && methods.providers.length === 0 && !methods.email && !methods.telegram?.login) {
       return null;
     }
     return signInOptionsFrom(methods, wallets ?? [], {
@@ -2511,15 +2536,26 @@ function useSignInOptions(input = {}) {
         oauth: withProvider,
         sendCode,
         verifyCode,
-        wallet: withWallet
+        wallet: withWallet,
+        telegram: withTelegram
       }
     });
-  }, [methods, wallets, cosmos, withProvider, sendCode, verifyCode, withWallet]);
+  }, [
+    methods,
+    wallets,
+    cosmos,
+    withProvider,
+    sendCode,
+    verifyCode,
+    withWallet,
+    withTelegram
+  ]);
   const methodsError = methods?.error ?? null;
   return useMemo7(
     () => ({
       options: built?.options ?? null,
       unavailable: built?.unavailable ?? NONE_UNAVAILABLE,
+      telegram: built?.telegram ?? null,
       methodsError,
       isPending: busy,
       busy,
@@ -2596,6 +2632,66 @@ function useAccounts() {
     ]
   );
 }
+function useTelegramAccount() {
+  const relay = useRelay();
+  const invalidate = useInvalidate();
+  const session = useScopeSession();
+  const query = useMemberQuery(
+    [...relayKeys.accounts, "telegram"],
+    (options) => relay.auth.telegram.account(options),
+    { refetchOnFocus: true }
+  );
+  const { isPending, actionError: actionError2, resetAction, run, retry, settle } = useAction();
+  const actions = useMemo8(
+    () => ({
+      connect: () => run(async () => {
+        const { url } = await relay.auth.telegram.start("connect", {
+          session
+        });
+        window.location.assign(url);
+      }),
+      connectMiniApp: (initData) => run(async () => {
+        await relay.auth.telegram.miniApp.connect(initData, { session });
+        void invalidate([relayKeys.accounts, relayKeys.experience]);
+      }),
+      disconnect: () => run(async () => {
+        await relay.auth.telegram.disconnect({ session });
+        void invalidate([
+          relayKeys.accounts,
+          relayKeys.experience,
+          relayKeys.profiles
+        ]);
+      })
+    }),
+    [relay, invalidate, session, run]
+  );
+  const account = query.data;
+  return useMemo8(
+    () => ({
+      ...query,
+      isPending,
+      actionError: actionError2,
+      resetAction,
+      retry,
+      settle,
+      /** True when the account can be used to verify quests right now. */
+      isConnected: Boolean(
+        account?.configured && account.status === "connected"
+      ),
+      ...actions
+    }),
+    [
+      query,
+      isPending,
+      actionError2,
+      resetAction,
+      retry,
+      settle,
+      account,
+      actions
+    ]
+  );
+}
 
 // src/react/profiles.ts
 import { useMemo as useMemo9 } from "react";
@@ -2904,6 +3000,7 @@ export {
   relayKeys,
   roleDeliveryLabel,
   roleDeliveryStatus,
+  telegramMiniAppInitData,
   useAccounts,
   useActivity,
   useBadgeCatalog,
@@ -2943,6 +3040,7 @@ export {
   useSignInOptions,
   useSignInWallets,
   useSignOut,
+  useTelegramAccount,
   useTieredRewards,
   useWalletDiscovery,
   useWallets