@domino-sdk/relay 1.19.0 → 1.21.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/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-SG5IUOMX.js";
+} from "./chunk-H4FL5WA5.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-RKARJARI.js";
+import "./chunk-WQT4H2PI.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-bLac-fNk.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-DUc8QwDl.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';

package/dist/internal.js

@@ -9,7 +9,7 @@ import {
   participantExchangeSchema,
   questConfiguration,
   sequenceCursorSchema
-} from "./chunk-ANE7DHSG.js";
+} from "./chunk-NHHM5ASX.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-RKARJARI.js";
+import "./chunk-WQT4H2PI.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-RKARJARI.js";
+} from "./chunk-WQT4H2PI.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-QEWAM3OB.js";
-import "../chunk-SG5IUOMX.js";
+  signInOptionsFrom,
+  telegramMiniAppInitData
+} from "../chunk-YVBWCT4S.js";
+import "../chunk-H4FL5WA5.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-RKARJARI.js";
+import "../chunk-WQT4H2PI.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

package/dist/schema.d.ts

@@ -1,7 +1,7 @@
 import { a as AttemptStatus, h as TrackerSkipCode } from './schema-Br3c1GOu.js';
 export { ae as AccountRole, af as AppIdentityKind, A as Attempt, ag as Bound, ah as CompletionSource, ai as CompletionSourceKind, aj as Condition, a3 as ContentBody, a5 as ContentMetricName, ak as ContentPerformanceSnapshot, al as DataLeaves, _ as Decision, E as Entitlement, am as EntitlementCorrection, an as EntitlementState, b as EvaluatorProgress, I as IdentityKind, K as KnownAttemptStatus, ao as KnownCompletionSourceKind, ap as KnownIdentityKind, c as KnownTrackerSkipCode, N as MemberIdentity, aq as MemberPage, M as MemberProgress, O as OpenIdentityKind, P as PhotoResult, ar as PickupAvailability, as as PublishedRelease, at as QuestAvailability, Q as QuestBudgetView, au as QuestDescription, d as QuestPresentation, av as QuestPresentationContent, e as QuestProfile, aw as QuestSettingsInput, ax as QuestStep, ay as QuestStepAction, f as QuizEvidence, az as ReleaseInput, aA as ReviewPage, R as Reward, a1 as RoleOf, aB as Snapshot, B as SourceRoles, S as SubmissionEvidence, g as SubmitInput, Z as TextResult, Y as TextReviewInput, a7 as TieredRewardDefinition, T as TieredRewardReference, y as Tracker, aC as TrackerAccount, aD as TrackerAttribution, aE as TrackerBound, aF as TrackerCondition, aG as TrackerContent, aH as TrackerContentQuery, z as TrackerData, aI as TrackerDataIssue, a9 as TrackerDataSchema, aJ as TrackerDefinition, aK as TrackerDefinitionResponse, aL as TrackerOutcome, aM as TrackerOutcomeQuery, aa as TrackerPage, aN as TrackerPreview, aO as TrackerPreviewInput, aP as TrackerQuery, ab as TrackerReadQuery, V as TrackerReader, aQ as TrackerRecord, u as TrackerSource, aR as TrackerSourceKind, aS as TrackerSourceResponse, aT as TrackerStatus, U as TrackerTriggerContext, a0 as TrackerTriggerMode, aU as TrackerTriggerOutcomePage, aV as TrackerTriggerOutcomeQuery, H as TrackerTriggerPolicy, aW as TrackerWhere, aX as TriggerEnrollment, aY as TriggerHistorical, aZ as TriggerSince, a_ as TypedTrackerRecord, J as Where, a2 as WhereSetting, p as WithAccountRoles, o as WithContent, W as WithRecordData, F as XContentMetric, X as XTweet, a$ as accountRoleSchema, b0 as appIdentityKindSchema, b1 as artifactSchema, b2 as attemptSchema, b3 as badgeReward, b4 as badgeRewardSchema, b5 as batchReleaseSchema, b6 as beginHandoverSchema, b7 as beneficiaryRole, b8 as completionRecordSchema, b9 as completionSourceSchema, ba as configurePickupSchema, bb as confirmHandoverSchema, bc as contentMetricNameSchema, bd as contentPerformancePageSchema, be as contentPerformanceQuerySchema, bf as contentPerformanceSnapshotSchema, bg as createStockItemSchema, bh as customContentSchema, n as customSourceSchema, bi as decisionSchema, bj as defaultTriggerMode, bk as deferPolicy, bl as entitlementCorrectionSchema, bm as entitlementRecoverySchema, bn as entitlementSchema, bo as entitlementStateSchema, bp as errorSchema, bq as evaluatorProgressSchema, br as evaluatorProtocol, bs as evaluatorProtocolSchema, bt as eventSchema, bu as evidenceSchema, bv as identityKindSchema, bw as integrationRewardSchema, bx as isAppIdentityKind, by as isKnownTrackerSource, bz as knownIdentityKinds, bA as mediaUrlSchema, bB as memberIdentitySchema, bC as memberListSchema, bD as memberPageSchema, bE as memberProgressSchema, bF as openIdentityKindSchema, bG as photoResultSchema, bH as pickupAllocationSchema, bI as pickupAvailabilitySchema, bJ as pickupCatalogSchema, bK as pickupPolicySchema, bL as pickupSelectionSchema, bM as pointsRewardSchema, bN as publishedReleaseSchema, bO as publishedTrackerSchema, bP as questAvailabilitySchema, bQ as questBudgetViewSchema, bR as questDescriptionSchema, bS as questPresentationContentSchema, bT as questPresentationRequirementSchema, bU as questPresentationSchema, bV as questProfileSchema, bW as questSettingsInputSchema, bX as questStepActionSchema, bY as questStepSchema, bZ as quizAnswersSchema, b_ as quizEvidenceSchema, b$ as releaseSchema, c0 as reservationSchema, c1 as reviewItemSchema, c2 as reviewListSchema, c3 as reviewModeSchema, c4 as reviewPageSchema, c5 as rewardBundleSchema, c6 as rewardKey, $ as rewardSchema, c7 as snapshotSchema, c8 as sourceContent, c9 as sourceIdentities, ca as staffDecisionSchema, cb as stockItemSchema, cc as stockSchema, cd as storedQuestDescriptionSchema, ce as storedReviewModeSchema, cf as submissionEvidenceSchema, cg as submitSchema, ch as templateSchema, ci as textResultSchema, cj as textReviewInputSchema, ck as tierRewardSchema, cl as tieredRewardDefinitionSchema, cm as tieredRewardReferenceSchema, cn as trackerAccountSchema, co as trackerArtifactSchema, cp as trackerAttributionSchema, cq as trackerBoundSchema, cr as trackerConditionSchema, cs as trackerContentQuerySchema, ct as trackerContentReadSchema, cu as trackerContentSchema, cv as trackerContentStageSchema, cw as trackerControlSchema, cx as trackerDataMaxBranches, cy as trackerDataMaxEntries, cz as trackerDataSchemaSchema, cA as trackerDefinitionResponseSchema, v as trackerDefinitionSchema, cB as trackerEvidenceSchema, cC as trackerIngestResultSchema, cD as trackerIngestSchema, cE as trackerOutcomePageSchema, cF as trackerOutcomeQuerySchema, cG as trackerOutcomeRetrySchema, cH as trackerOutcomeSchema, cI as trackerPageSchema, cJ as trackerPreviewInputSchema, cK as trackerPreviewLimits, cL as trackerPreviewSchema, cM as trackerQuerySchema, cN as trackerRecordAccountSchema, cO as trackerRecordInputSchema, cP as trackerRecordSchema, cQ as trackerSkipCodes, cR as trackerSourceKinds, cS as trackerSourceResponseSchema, cT as trackerSourceSchema, cU as trackerStatusSchema, cV as trackerSummarySchema, ad as trackerTriggerContextSchema, cW as trackerTriggerModeSchema, cX as trackerTriggerOutcomePageSchema, cY as trackerTriggerOutcomeQuerySchema, cZ as trackerTriggerPolicySchema, c_ as trackerTriggerRecordSchema, c$ as trackerWhereSchema, d0 as triggerAdmission, d1 as triggerEnrollmentSchema, d2 as triggerHistoricalSchema, d3 as triggerMode, a6 as triggerSchema, d4 as triggerSinceSchema, d5 as whereConditions, d6 as whereSettings, d7 as xAccountRoles, x as xContentBodySchema, d8 as xContentMetrics, D as xSearchSourceSchema, d9 as xTweetSchema } from './schema-Br3c1GOu.js';
 export { A as AccountConnection, a as AuthProvider, g as DiscordMember, h as DiscordMessage, D as DiscordMessageData, b as DiscordMessageTextData, e as DiscordReactionData, f as DiscordReader, i as accountConnectionSchema, j as authProviderSchema, k as discordMemberInputSchema, l as discordMemberSchema, m as discordMessageDataSchema, n as discordMessageInputSchema, o as discordMessageSchema, p as discordMessageTextDataSchema, d as discordMessagesSourceSchema, q as discordReactionDataSchema, c as discordReactionsSourceSchema, r as discordResourceSourceSchema, s as discordRewardSchema } 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, c as authScopeSchema, e as exchangeResultSchema, d as exchangeSchema, k as knownRelayEventSchema, m as memberSummarySchema, p as participantActivityQuerySchema, f as participantActivitySchema, g as participantPrincipalSchema, h as participantSessionSchema, i as principalSchema, r as relayEventSchema, s as sessionMember, j as sessionSchema } 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, d as authScopeSchema, e as exchangeResultSchema, f as exchangeSchema, k as knownRelayEventSchema, m as memberSummarySchema, p as participantActivityQuerySchema, g as participantActivitySchema, h as participantPrincipalSchema, i as participantSessionSchema, j as principalSchema, r as relayEventSchema, s as sessionMember, l as sessionSchema, t as telegramAccountConnectionSchema, n as telegramInitDataSchema, o as telegramMiniAppSignInSchema, q as telegramSignInMethodsSchema } from './telegram-DALZ7GdF.js';
 export { C as CalendarPeriod, D as DeploymentPreview, a as DeploymentRecord, b as DeploymentWarning, P as ProjectCalendar, c as ProjectCalendarInput, d as activityTypeSchema, e as activityTypes, f as calendarPeriodSchema, g as canonicalTimeZone, h as deploymentActionSchema, i as deploymentPreviewSchema, j as deploymentRecordSchema, k as deploymentRejectionSchema, l as deploymentResultSchema, m as deploymentSourceSchema, n as deploymentWarningSchema, p as projectCalendarDeclarationSchema, o as projectCalendarInputSchema, q as projectCalendarSchema, r as projectCatalogArtifactSchema, s as projectDeploymentSchema, t as promoteDeploymentSchema, u as publishDeploymentSchema, v as refuseStreakTimeZone, w as refuseWindowTimeZone, x as rejectDeploymentSchema, y as rollbackDeploymentSchema, z as submitDeploymentSchema, A as timeZoneNameSchema, B as timeZoneSchema } from './deployments-nNS4spO9.js';
 import { k as PointEntryKind } from './groups-jLLG7MML.js';
 export { A as AvailabilityWindow, C as CampaignDefinition, a as CampaignEnrollment, b as CampaignEnrollmentInput, c as CampaignView, d as CampaignWithdrawalInput, E as EngagementBudget, w as EngagementDefinition, x as EngagementRuleVersionPage, G as GroupMember, y as GroupMemberPage, z as GroupPage, B as GroupPageQuery, K as KnownPointEntryKind, L as LeaderboardDefinition, e as LeaderboardPage, f as LeaderboardPlacement, g as LeaderboardQuery, D as LeaderboardSettlement, F as LeaderboardSettlementPolicy, H as LeaderboardSettlementSummary, I as ManagedGroup, J as ManagedPointHistoryPage, N as ManagedPointLedger, M as MemberCampaignEnrollmentInput, h as MemberCampaignWithdrawalInput, P as PointBalance, i as PointBalances, j as PointEntry, l as PointHistoryPage, m as PointHistoryQuery, O as PointLedger, n as PointLedgerReference, o as ProjectGroup, p as ProjectGroupReference, R as ReferralDefinition, Q as addGroupMemberSchema, S as availabilityWindowSchema, T as campaignDefinitionSchema, U as campaignEnrollmentInputSchema, V as campaignEnrollmentSchema, W as campaignViewSchema, X as campaignWithdrawalInputSchema, Y as createGroupSchema, Z as createPointLedgerSchema, u as defineCampaign, v as defineGroup, _ as engagementArtifactSchema, $ as engagementBoundaryPageSchema, a0 as engagementBudgetSchema, a1 as engagementChangePreviewInputSchema, a2 as engagementChangePreviewSchema, a3 as engagementChangeSchema, a4 as engagementDefinitionSchema, a5 as engagementDeploymentEntrySchema, a6 as engagementPageQuerySchema, a7 as engagementPageSchema, a8 as engagementPublishSchema, a9 as engagementRuleSchema, aa as engagementRuleVersionPageSchema, ab as engagementScoreInputSchema, ac as engagementScoreSchema, ad as engagementSettlementSchema, ae as engagementVersionPageSchema, af as engagementVersionQuerySchema, ag as groupMemberPageSchema, ah as groupMemberSchema, ai as groupPageQuerySchema, aj as groupPageSchema, ak as leaderboardArtifactSchema, al as leaderboardAuthoringSchema, am as leaderboardDefinitionResponseSchema, q as leaderboardDefinitionSchema, an as leaderboardExclusionSchema, ao as leaderboardGroupSchema, ap as leaderboardPageSchema, aq as leaderboardPlacementSchema, ar as leaderboardPreviewSchema, as as leaderboardPrizeRewardSchema, at as leaderboardPrizeSchema, au as leaderboardQuerySchema, av as leaderboardRowSchema, aw as leaderboardSettlementApprovalSchema, ax as leaderboardSettlementPolicySchema, ay as leaderboardSettlementRowSchema, az as leaderboardSettlementSchema, aA as leaderboardSettlementStatusSchema, aB as leaderboardSettlementSummarySchema, aC as leaderboardWindowSchema, aD as managedGroupSchema, aE as managedPointHistoryPageSchema, aF as managedPointLedgerSchema, aG as memberCampaignEnrollmentInputSchema, aH as memberCampaignWithdrawalInputSchema, aI as pointBalanceSchema, aJ as pointBalancesSchema, aK as pointEntrySchema, aL as pointHistoryPageSchema, aM as pointHistoryQuerySchema, aN as pointLedgerArtifactSchema, s as pointLedgerDeclarationSchema, aO as pointLedgerPropertiesSchema, aP as pointLedgerReferenceSchema, aQ as pointLedgerSchema, aR as pointsAccountSchema, aS as pointsEntrySchema, aT as pointsMutationSchema, aU as pointsResultSchema, aV as projectGroupKey, aW as projectGroupSchema, aX as publishedLeaderboardSchema, aY as publishedReferralSchema, aZ as referralAcceptSchema, a_ as referralAccountSchema, a$ as referralArtifactSchema, t as referralAuthoringSchema, b0 as referralControlSchema, b1 as referralDefinitionSchema, b2 as referralHistorySchema, b3 as referralManagementSchema, b4 as referralQualificationSchema, b5 as referralRelationshipSchema, b6 as referralRewardResolutionSchema, b7 as referralSummarySchema, b8 as referralSuspensionSchema, b9 as removeGroupMemberSchema, ba as updateGroupSchema } from './groups-jLLG7MML.js';
@@ -230,6 +230,19 @@ declare const participantResponseSchemas: {
             awardedAt: number;
         }[];
     }, unknown>>;
+    telegramAccountConnectionSchema: zod.ZodType<{
+        configured: boolean;
+        status: "disconnected" | "connected" | "reconnect";
+        subject: string | null;
+        revision: number;
+        provider: "telegram";
+    }, unknown, zod_v4_core.$ZodTypeInternals<{
+        configured: boolean;
+        status: "disconnected" | "connected" | "reconnect";
+        subject: string | null;
+        revision: number;
+        provider: "telegram";
+    }, unknown>>;
     accountConnectionSchema: zod.ZodType<{
         provider: "discord" | "x" | "google" | "apple";
         configured: boolean;
@@ -6097,6 +6110,13 @@ declare const participantResponses: {
             awardedAt: number;
         }[];
     }>>;
+    telegramAccountConnectionSchema: ResponseSchema<ResponseResult<{
+        configured: boolean;
+        status: "disconnected" | "connected" | "reconnect";
+        subject: string | null;
+        revision: number;
+        provider: "telegram";
+    }>>;
     accountConnectionSchema: ResponseSchema<ResponseResult<{
         provider: "discord" | "x" | "google" | "apple";
         configured: boolean;

package/dist/schema.js

@@ -40,7 +40,7 @@ import {
   rejectDeploymentSchema,
   rollbackDeploymentSchema,
   submitDeploymentSchema
-} from "./chunk-K2Q5JHME.js";
+} from "./chunk-7YRXDG7R.js";
 import {
   capabilityErrorCodes,
   capabilityFailureSchema
@@ -110,8 +110,12 @@ import {
   rewardDeliveriesSchema,
   rewardDeliverySchema,
   roleReconciliationSchema,
-  saveQuestDraftSchema
-} from "./chunk-IE4QOQUI.js";
+  saveQuestDraftSchema,
+  telegramAccountConnectionSchema,
+  telegramInitDataSchema,
+  telegramMiniAppSignInSchema,
+  telegramSignInMethodsSchema
+} from "./chunk-5ZRDK4KQ.js";
 import {
   AVATAR_UPLOAD_LIMIT,
   PointEntryKind,
@@ -931,6 +935,10 @@ export {
   submissionEvidenceSchema,
   submitDeploymentSchema,
   submitSchema,
+  telegramAccountConnectionSchema,
+  telegramInitDataSchema,
+  telegramMiniAppSignInSchema,
+  telegramSignInMethodsSchema,
   templateSchema,
   textEvidenceSchema,
   textOptionsSchema,