@singi-labs/sifa-sdk 0.7.0 → 0.7.2

package/dist/query/index.d.cts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { P as Profile } from '../index-IDRpze8y.cjs';
+import { f as Profile } from '../index-CpM21_Oy.cjs';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
 
@@ -100,6 +100,12 @@ declare function useSifaConfig(): SifaApiConfig;
  * Server-callable (Next.js RSC) and client-callable (Expo, browser).
  */
 declare function fetchProfile(config: SifaApiConfig, handleOrDid: string, options?: ApiFetchOptions): Promise<Profile | null>;
+/**
+ * Public AT Fund link for a profile, if one is configured. Returns `null`
+ * on any error or when the response payload's `url` field is missing or
+ * non-string.
+ */
+declare function fetchAtFundLink(config: SifaApiConfig, did: string, options?: ApiFetchOptions): Promise<string | null>;
 
 /** Result returned by record-write mutations (create / update / delete). */
 interface WriteResult {
@@ -122,6 +128,59 @@ interface CreateResult extends WriteResult {
  */
 declare function createPosition(config: SifaApiConfig, data: Record<string, unknown>, options?: ApiFetchOptions): Promise<CreateResult>;
 
+/** Public, aggregate stats shown on the homepage and similar surfaces. */
+interface StatsResponse {
+    profileCount: number;
+    avatars: string[];
+    atproto: {
+        userCount: number;
+        growthPerSecond: number;
+        timestamp: number;
+    } | null;
+}
+/**
+ * Homepage stats (profile count, avatar samples, ATproto growth). Public
+ * endpoint -- safe to cache. Returns `null` on any error so callers can
+ * render a graceful empty state.
+ */
+declare function fetchStats(config: SifaApiConfig, options?: ApiFetchOptions): Promise<StatsResponse | null>;
+
+/** Catalog entry describing an ATproto app that Sifa surfaces activity for. */
+interface AppRegistryEntry {
+    id: string;
+    name: string;
+    category: string;
+    collectionPrefixes: string[];
+    scanCollections: string[];
+    urlPattern?: string;
+    color: string;
+}
+/** Compact app representation returned by the hidden-apps endpoint. */
+interface HiddenApp {
+    id: string;
+    name: string;
+    category: string;
+}
+interface FetchHiddenAppsOptions extends ApiFetchOptions {
+    /**
+     * Pass the caller's `Cookie` header on Next.js RSC server-side calls.
+     * `credentials: 'include'` does NOT propagate browser cookies in RSC,
+     * so authenticated server fetches must forward the header explicitly.
+     */
+    cookieHeader?: string;
+}
+/**
+ * Public app registry shown across discovery surfaces. Heavily cached.
+ * Returns `[]` on any error.
+ */
+declare function fetchAppsRegistry(config: SifaApiConfig, options?: ApiFetchOptions): Promise<AppRegistryEntry[]>;
+/**
+ * Apps the authenticated user has chosen to hide from their activity feed.
+ * Requires an authenticated session. Returns `[]` on any error (including
+ * the unauthenticated case).
+ */
+declare function fetchHiddenApps(config: SifaApiConfig, options?: FetchHiddenAppsOptions): Promise<HiddenApp[]>;
+
 /** Profile entry returned by the search endpoint. */
 interface ProfileSearchResult {
     did?: string;
@@ -298,6 +357,229 @@ declare function fetchFollowing(config: SifaApiConfig, opts?: {
     limit?: number;
 } & ApiFetchOptions): Promise<FollowingResponse>;
 
+interface QuotedPostAuthor {
+    did: string;
+    handle: string;
+    displayName?: string;
+    avatar?: string;
+}
+interface QuotedPostImage {
+    thumb: string;
+    fullsize: string;
+    alt?: string;
+}
+interface QuotedPostView {
+    uri: string;
+    cid: string;
+    author: QuotedPostAuthor;
+    text: string;
+    createdAt: string;
+    images?: QuotedPostImage[];
+}
+type QuotedPostResult = {
+    status: 'ok';
+    record: QuotedPostView;
+} | {
+    status: 'deleted';
+    uri: string;
+} | {
+    status: 'unavailable';
+    uri: string;
+};
+/** Max URIs per request to `POST /api/quoted-posts/resolve` (mirrors server cap). */
+declare const QUOTED_POSTS_BATCH_MAX = 20;
+interface ResolveQuotedPostsOptions extends ApiFetchOptions {
+    /** Cookie header for Next.js RSC server-side calls; ignored in browsers. */
+    cookieHeader?: string;
+}
+/**
+ * Resolve a batch of AT-URIs to their quoted-post snapshots via the Sifa AppView.
+ *
+ * Auto-deduplicates input URIs and splits requests into chunks of
+ * {@link QUOTED_POSTS_BATCH_MAX} so callers can pass an arbitrary-length array.
+ * Each chunk is fired in parallel. The server caches results in Valkey, so
+ * repeated calls for the same URI are cheap.
+ *
+ * Returns a map of `uri -> QuotedPostResult`. URIs that fail (network error,
+ * non-2xx, or the server omitting them) are absent from the map; the caller
+ * should render a skeleton or tombstone for those.
+ */
+declare function resolveQuotedPosts(config: SifaApiConfig, uris: string[], options?: ResolveQuotedPostsOptions): Promise<Record<string, QuotedPostResult>>;
+
+interface HeatmapDay {
+    date: string;
+    total: number;
+    apps: {
+        appId: string;
+        count: number;
+    }[];
+}
+interface HeatmapResponse {
+    days: HeatmapDay[];
+    appTotals: {
+        appId: string;
+        appName: string;
+        total: number;
+    }[];
+    thresholds: [number, number, number, number];
+}
+interface ActivityItem {
+    uri: string;
+    cid: string;
+    collection: string;
+    rkey: string;
+    record: Record<string, unknown>;
+    appId: string;
+    appName: string;
+    category: string;
+    indexedAt: string;
+    /**
+     * Set by the server when an `app.bsky.embed.record` quote was already
+     * resolved upstream (AppView path). Mutually exclusive with `quotedPostUri`.
+     */
+    quotedPost?: QuotedPostResult;
+    /**
+     * Set by the server when an `app.bsky.embed.record` quote needs client-side
+     * resolution (PDS path). Pass batches to {@link resolveQuotedPosts}.
+     * Mutually exclusive with `quotedPost`.
+     */
+    quotedPostUri?: string;
+}
+interface ActivityTeaserResponse {
+    items: ActivityItem[];
+    blueskyGated?: boolean;
+    backfillPending?: boolean;
+    failedApps?: string[];
+}
+interface ActivityFeedResponse {
+    items: ActivityItem[];
+    cursor: string | null;
+    hasMore: boolean;
+    availableCategories?: string[];
+    blueskyGated?: boolean;
+    failedApps?: string[];
+}
+/**
+ * Per-day activity counts for a profile across all ATproto apps. Returns
+ * `null` on any error so callers can render a graceful empty state.
+ */
+declare function fetchHeatmapData(config: SifaApiConfig, handleOrDid: string, days: number, options?: ApiFetchOptions): Promise<HeatmapResponse | null>;
+interface FetchActivityTeaserOptions extends ApiFetchOptions {
+    /**
+     * Pass the caller's `Cookie` header on Next.js RSC server-side calls.
+     * Required for authenticated server fetches because `credentials: 'include'`
+     * does not propagate browser cookies in RSC.
+     */
+    cookieHeader?: string;
+}
+/**
+ * Recent activity teaser for a profile (homepage-sized slice). Caps the
+ * upstream wait so the SSR path cannot hang. Returns `null` on any error.
+ */
+declare function fetchActivityTeaser(config: SifaApiConfig, handleOrDid: string, options?: FetchActivityTeaserOptions): Promise<ActivityTeaserResponse | null>;
+interface FetchActivityFeedOptions extends ApiFetchOptions {
+    category?: string;
+    limit?: number;
+    cursor?: string;
+    cookieHeader?: string;
+}
+/**
+ * Paginated activity feed for a profile. Always fresh (`cache: 'no-store'`).
+ * Returns `null` on any error.
+ */
+declare function fetchActivityFeed(config: SifaApiConfig, handleOrDid: string, options?: FetchActivityFeedOptions): Promise<ActivityFeedResponse | null>;
+
+/**
+ * Counts confirmed endorsements received by a DID. The backend's
+ * `GET /api/endorsement/:did` already returns only confirmed endorsements
+ * (via inner join with `endorsementConfirmations`), so this helper just
+ * returns the array length. Failures return 0 so callers can route safely.
+ *
+ * Public endpoint -- no credentials needed.
+ */
+declare function fetchEndorsementCount(config: SifaApiConfig, did: string, options?: ApiFetchOptions): Promise<number>;
+
+interface FetchNetworkStreamCountOptions extends ApiFetchOptions {
+    /**
+     * Pass the caller's `Cookie` header on Next.js RSC server-side calls.
+     * Required for authenticated server fetches because `credentials: 'include'`
+     * does not propagate browser cookies in RSC.
+     *
+     * When omitted, the request falls back to `credentials: 'include'` so
+     * client-side calls work without extra plumbing.
+     */
+    cookieHeader?: string;
+}
+/**
+ * Counts items in the authenticated user's network stream digest. The
+ * underlying `GET /api/stream/network` endpoint may 404 while the feature
+ * is in development; in that case (and on any other error) this returns
+ * 0 so callers can route safely to a fallback experience.
+ */
+declare function fetchNetworkStreamCount(config: SifaApiConfig, did: string, options?: FetchNetworkStreamCountOptions): Promise<number>;
+
+/** Per-URI reaction state for the authenticated viewer. */
+interface ReactionStatus {
+    reacted: boolean;
+    rkey?: string;
+    collection?: string;
+}
+/** Result of checking whether the authenticated viewer has an account on a given app. */
+interface AccountCheckResult {
+    hasAccount: boolean;
+    appName: string;
+    appUrl: string;
+}
+interface FetchReactionStatusOptions extends ApiFetchOptions {
+    /**
+     * Pass the caller's `Cookie` header on Next.js RSC server-side calls.
+     * Required for authenticated server fetches because `credentials: 'include'`
+     * does not propagate browser cookies in RSC.
+     */
+    cookieHeader?: string;
+}
+/**
+ * Batch-look up reaction status for multiple URIs. Returns `{}` for an
+ * empty input list (no network call) and `null` on any error.
+ */
+declare function fetchReactionStatus(config: SifaApiConfig, uris: string[], options?: FetchReactionStatusOptions): Promise<Record<string, ReactionStatus> | null>;
+interface CheckAppAccountOptions extends ApiFetchOptions {
+    cookieHeader?: string;
+}
+/**
+ * Check whether the authenticated viewer has an account on a given app.
+ * Returns `null` on any error.
+ */
+declare function checkAppAccount(config: SifaApiConfig, appId: string, options?: CheckAppAccountOptions): Promise<AccountCheckResult | null>;
+
+/** Voter on a roadmap item. */
+interface RoadmapVoter {
+    did: string;
+    avatarUrl?: string;
+}
+/** Map of item key -> vote tally and voter list. */
+type RoadmapVotesResponse = Record<string, {
+    count: number;
+    voters: RoadmapVoter[];
+}>;
+/**
+ * Public roadmap vote tallies, keyed by item. Returns `{}` on any error.
+ */
+declare function fetchRoadmapVotes(config: SifaApiConfig, options?: ApiFetchOptions): Promise<RoadmapVotesResponse>;
+interface FetchMyRoadmapVotesOptions extends ApiFetchOptions {
+    /**
+     * Pass the caller's `Cookie` header on Next.js RSC server-side calls.
+     * Required for authenticated server fetches because `credentials: 'include'`
+     * does not propagate browser cookies in RSC.
+     */
+    cookieHeader?: string;
+}
+/**
+ * Roadmap items the authenticated user has voted on. Returns `[]` on any
+ * error or when the response payload is shaped unexpectedly.
+ */
+declare function fetchMyRoadmapVotes(config: SifaApiConfig, options?: FetchMyRoadmapVotesOptions): Promise<string[]>;
+
 /**
  * Query key factory for TanStack Query.
  *
@@ -314,6 +596,7 @@ declare const sifaQueryKeys: {
     readonly profile: {
         readonly all: () => readonly ["sifa", "profile"];
         readonly byHandle: (handleOrDid: string) => readonly ["sifa", "profile", string];
+        readonly atFundLink: (did: string) => readonly ["sifa", "profile", "at-fund-link", string];
     };
     readonly position: {
         readonly all: () => readonly ["sifa", "position"];
@@ -336,8 +619,41 @@ declare const sifaQueryKeys: {
         readonly all: () => readonly ["sifa", "follow"];
         readonly following: (opts: Record<string, unknown>) => readonly ["sifa", "follow", "following", Record<string, unknown>];
     };
+    readonly stats: {
+        readonly all: () => readonly ["sifa", "stats"];
+        readonly homepage: () => readonly ["sifa", "stats", "homepage"];
+    };
+    readonly apps: {
+        readonly all: () => readonly ["sifa", "apps"];
+        readonly registry: () => readonly ["sifa", "apps", "registry"];
+        readonly hidden: () => readonly ["sifa", "apps", "hidden"];
+    };
+    readonly activity: {
+        readonly all: () => readonly ["sifa", "activity"];
+        readonly heatmap: (handleOrDid: string, days: number) => readonly ["sifa", "activity", "heatmap", string, number];
+        readonly teaser: (handleOrDid: string) => readonly ["sifa", "activity", "teaser", string];
+        readonly feed: (handleOrDid: string, opts: Record<string, unknown>) => readonly ["sifa", "activity", "feed", string, Record<string, unknown>];
+    };
+    readonly endorsement: {
+        readonly all: () => readonly ["sifa", "endorsement"];
+        readonly count: (did: string) => readonly ["sifa", "endorsement", "count", string];
+    };
+    readonly stream: {
+        readonly all: () => readonly ["sifa", "stream"];
+        readonly networkCount: (did: string) => readonly ["sifa", "stream", "network-count", string];
+    };
+    readonly reactions: {
+        readonly all: () => readonly ["sifa", "reactions"];
+        readonly status: (uris: string[]) => readonly ["sifa", "reactions", "status", string[]];
+        readonly accountCheck: (appId: string) => readonly ["sifa", "reactions", "account-check", string];
+    };
+    readonly roadmap: {
+        readonly all: () => readonly ["sifa", "roadmap"];
+        readonly votes: () => readonly ["sifa", "roadmap", "votes"];
+        readonly myVotes: () => readonly ["sifa", "roadmap", "my-votes"];
+    };
 };
-type SifaQueryKey = ReturnType<typeof sifaQueryKeys.all> | ReturnType<typeof sifaQueryKeys.profile.all> | ReturnType<typeof sifaQueryKeys.profile.byHandle> | ReturnType<typeof sifaQueryKeys.position.all> | ReturnType<typeof sifaQueryKeys.position.byOwner> | ReturnType<typeof sifaQueryKeys.search.all> | ReturnType<typeof sifaQueryKeys.search.profiles> | ReturnType<typeof sifaQueryKeys.search.skills> | ReturnType<typeof sifaQueryKeys.search.filters> | ReturnType<typeof sifaQueryKeys.discovery.all> | ReturnType<typeof sifaQueryKeys.discovery.similar> | ReturnType<typeof sifaQueryKeys.discovery.suggestions> | ReturnType<typeof sifaQueryKeys.discovery.suggestionCount> | ReturnType<typeof sifaQueryKeys.discovery.featured> | ReturnType<typeof sifaQueryKeys.follow.all> | ReturnType<typeof sifaQueryKeys.follow.following>;
+type SifaQueryKey = ReturnType<typeof sifaQueryKeys.all> | ReturnType<typeof sifaQueryKeys.profile.all> | ReturnType<typeof sifaQueryKeys.profile.byHandle> | ReturnType<typeof sifaQueryKeys.profile.atFundLink> | ReturnType<typeof sifaQueryKeys.position.all> | ReturnType<typeof sifaQueryKeys.position.byOwner> | ReturnType<typeof sifaQueryKeys.search.all> | ReturnType<typeof sifaQueryKeys.search.profiles> | ReturnType<typeof sifaQueryKeys.search.skills> | ReturnType<typeof sifaQueryKeys.search.filters> | ReturnType<typeof sifaQueryKeys.discovery.all> | ReturnType<typeof sifaQueryKeys.discovery.similar> | ReturnType<typeof sifaQueryKeys.discovery.suggestions> | ReturnType<typeof sifaQueryKeys.discovery.suggestionCount> | ReturnType<typeof sifaQueryKeys.discovery.featured> | ReturnType<typeof sifaQueryKeys.follow.all> | ReturnType<typeof sifaQueryKeys.follow.following> | ReturnType<typeof sifaQueryKeys.stats.all> | ReturnType<typeof sifaQueryKeys.stats.homepage> | ReturnType<typeof sifaQueryKeys.apps.all> | ReturnType<typeof sifaQueryKeys.apps.registry> | ReturnType<typeof sifaQueryKeys.apps.hidden> | ReturnType<typeof sifaQueryKeys.activity.all> | ReturnType<typeof sifaQueryKeys.activity.heatmap> | ReturnType<typeof sifaQueryKeys.activity.teaser> | ReturnType<typeof sifaQueryKeys.activity.feed> | ReturnType<typeof sifaQueryKeys.endorsement.all> | ReturnType<typeof sifaQueryKeys.endorsement.count> | ReturnType<typeof sifaQueryKeys.stream.all> | ReturnType<typeof sifaQueryKeys.stream.networkCount> | ReturnType<typeof sifaQueryKeys.reactions.all> | ReturnType<typeof sifaQueryKeys.reactions.status> | ReturnType<typeof sifaQueryKeys.reactions.accountCheck> | ReturnType<typeof sifaQueryKeys.roadmap.all> | ReturnType<typeof sifaQueryKeys.roadmap.votes> | ReturnType<typeof sifaQueryKeys.roadmap.myVotes>;
 
 /**
  * React hook that reads an aggregated profile by handle or DID via
@@ -347,6 +663,11 @@ type SifaQueryKey = ReturnType<typeof sifaQueryKeys.all> | ReturnType<typeof sif
  * fetch.
  */
 declare function useProfile(handleOrDid: string | undefined | null, options?: Omit<UseQueryOptions<Profile | null, Error, Profile | null, ReturnType<typeof sifaQueryKeys.profile.byHandle>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<Profile | null, Error>;
+/**
+ * React hook for a profile's AT Fund link. Returns `null` data on error
+ * or when the profile has no link configured.
+ */
+declare function useAtFundLink(did: string | undefined | null, options?: Omit<UseQueryOptions<string | null, Error, string | null, ReturnType<typeof sifaQueryKeys.profile.atFundLink>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<string | null, Error>;
 
 /**
  * React hook for creating a new position record. On success, invalidates
@@ -358,6 +679,19 @@ declare function useProfile(handleOrDid: string | undefined | null, options?: Om
  */
 declare function useCreatePosition(ownerDid: string, options?: Omit<UseMutationOptions<CreateResult, Error, Record<string, unknown>>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<CreateResult, Error, Record<string, unknown>, unknown>;
 
+/**
+ * React hook for the public homepage stats. Returns `null` data on error.
+ */
+declare function useStats(options?: Omit<UseQueryOptions<StatsResponse | null, Error, StatsResponse | null, ReturnType<typeof sifaQueryKeys.stats.homepage>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<StatsResponse | null, Error>;
+
+/** React hook for the public app registry. */
+declare function useAppsRegistry(options?: Omit<UseQueryOptions<AppRegistryEntry[], Error, AppRegistryEntry[], ReturnType<typeof sifaQueryKeys.apps.registry>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<AppRegistryEntry[], Error>;
+/**
+ * React hook for the authenticated user's hidden-apps list. Requires a
+ * client-side session (relies on `credentials: 'include'`).
+ */
+declare function useHiddenApps(options?: Omit<UseQueryOptions<HiddenApp[], Error, HiddenApp[], ReturnType<typeof sifaQueryKeys.apps.hidden>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<HiddenApp[], Error>;
+
 declare function useSearchProfiles(filters: SearchFilters, options?: Omit<UseQueryOptions<SearchResponse, Error, SearchResponse, ReturnType<typeof sifaQueryKeys.search.profiles>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<SearchResponse, Error>;
 declare function useSkillSuggestions(query: string, options?: Omit<UseQueryOptions<SkillSearchResult[], Error, SkillSearchResult[], ReturnType<typeof sifaQueryKeys.search.skills>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<SkillSearchResult[], Error>;
 declare function useSearchFilters(options?: Omit<UseQueryOptions<FilterOptions, Error, FilterOptions, ReturnType<typeof sifaQueryKeys.search.filters>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<FilterOptions, Error>;
@@ -375,4 +709,30 @@ declare function useFollowing(opts?: {
     limit?: number;
 }, options?: Omit<UseQueryOptions<FollowingResponse, Error, FollowingResponse, ReturnType<typeof sifaQueryKeys.follow.following>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<FollowingResponse, Error>;
 
-export { ApiError, type ApiFetchOptions, type CreateResult, type FeaturedProfile, type FetchSuggestionsOptions, type FilterOptions, type FollowProfile, type FollowingResponse, type ProfileSearchResult, type SearchFilters, type SearchResponse, type SifaApiConfig, SifaProvider, type SifaProviderProps, type SifaQueryKey, type SimilarProfile, type SkillSearchResult, type SuggestionProfile, type SuggestionsResponse, type WriteResult, apiFetch, apiFetchOrNull, createPosition, fetchFeaturedProfile, fetchFollowing, fetchProfile, fetchSearchFilters, fetchSearchProfiles, fetchSimilarProfiles, fetchSkillSuggestions, fetchSuggestionCount, fetchSuggestions, sifaQueryKeys, useCreatePosition, useFeaturedProfile, useFollowing, useProfile, useSearchFilters, useSearchProfiles, useSifaConfig, useSimilarProfiles, useSkillSuggestions, useSuggestionCount, useSuggestions };
+declare function useHeatmapData(handleOrDid: string | undefined | null, days: number, options?: Omit<UseQueryOptions<HeatmapResponse | null, Error, HeatmapResponse | null, ReturnType<typeof sifaQueryKeys.activity.heatmap>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<HeatmapResponse | null, Error>;
+declare function useActivityTeaser(handleOrDid: string | undefined | null, options?: Omit<UseQueryOptions<ActivityTeaserResponse | null, Error, ActivityTeaserResponse | null, ReturnType<typeof sifaQueryKeys.activity.teaser>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<ActivityTeaserResponse | null, Error>;
+declare function useActivityFeed(handleOrDid: string | undefined | null, opts?: Pick<FetchActivityFeedOptions, 'category' | 'limit' | 'cursor'>, options?: Omit<UseQueryOptions<ActivityFeedResponse | null, Error, ActivityFeedResponse | null, ReturnType<typeof sifaQueryKeys.activity.feed>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<ActivityFeedResponse | null, Error>;
+
+/** Count of confirmed endorsements for a DID. Returns 0 on error. */
+declare function useEndorsementCount(did: string | undefined | null, options?: Omit<UseQueryOptions<number, Error, number, ReturnType<typeof sifaQueryKeys.endorsement.count>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<number, Error>;
+
+/**
+ * Count of items in the authenticated user's network stream digest.
+ * Returns 0 on error (including when the endpoint isn't yet shipped).
+ */
+declare function useNetworkStreamCount(did: string | undefined | null, options?: Omit<UseQueryOptions<number, Error, number, ReturnType<typeof sifaQueryKeys.stream.networkCount>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<number, Error>;
+
+/**
+ * Batch-look up reaction status for multiple URIs. Skips the network call
+ * when `uris` is empty.
+ */
+declare function useReactionStatus(uris: string[], options?: Omit<UseQueryOptions<Record<string, ReactionStatus> | null, Error, Record<string, ReactionStatus> | null, ReturnType<typeof sifaQueryKeys.reactions.status>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<Record<string, ReactionStatus> | null, Error>;
+/** Check whether the authenticated viewer has an account on the given app. */
+declare function useAppAccountCheck(appId: string | undefined | null, options?: Omit<UseQueryOptions<AccountCheckResult | null, Error, AccountCheckResult | null, ReturnType<typeof sifaQueryKeys.reactions.accountCheck>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<AccountCheckResult | null, Error>;
+
+/** Public roadmap vote tallies. Returns `{}` data on error. */
+declare function useRoadmapVotes(options?: Omit<UseQueryOptions<RoadmapVotesResponse, Error, RoadmapVotesResponse, ReturnType<typeof sifaQueryKeys.roadmap.votes>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<RoadmapVotesResponse, Error>;
+/** Roadmap items the authenticated viewer has voted on. Returns `[]` data on error. */
+declare function useMyRoadmapVotes(options?: Omit<UseQueryOptions<string[], Error, string[], ReturnType<typeof sifaQueryKeys.roadmap.myVotes>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<string[], Error>;
+
+export { type AccountCheckResult, type ActivityFeedResponse, type ActivityItem, type ActivityTeaserResponse, ApiError, type ApiFetchOptions, type AppRegistryEntry, type CheckAppAccountOptions, type CreateResult, type FeaturedProfile, type FetchActivityFeedOptions, type FetchActivityTeaserOptions, type FetchHiddenAppsOptions, type FetchMyRoadmapVotesOptions, type FetchNetworkStreamCountOptions, type FetchReactionStatusOptions, type FetchSuggestionsOptions, type FilterOptions, type FollowProfile, type FollowingResponse, type HeatmapDay, type HeatmapResponse, type HiddenApp, type ProfileSearchResult, QUOTED_POSTS_BATCH_MAX, type QuotedPostAuthor, type QuotedPostImage, type QuotedPostResult, type QuotedPostView, type ReactionStatus, type ResolveQuotedPostsOptions, type RoadmapVoter, type RoadmapVotesResponse, type SearchFilters, type SearchResponse, type SifaApiConfig, SifaProvider, type SifaProviderProps, type SifaQueryKey, type SimilarProfile, type SkillSearchResult, type StatsResponse, type SuggestionProfile, type SuggestionsResponse, type WriteResult, apiFetch, apiFetchOrNull, checkAppAccount, createPosition, fetchActivityFeed, fetchActivityTeaser, fetchAppsRegistry, fetchAtFundLink, fetchEndorsementCount, fetchFeaturedProfile, fetchFollowing, fetchHeatmapData, fetchHiddenApps, fetchMyRoadmapVotes, fetchNetworkStreamCount, fetchProfile, fetchReactionStatus, fetchRoadmapVotes, fetchSearchFilters, fetchSearchProfiles, fetchSimilarProfiles, fetchSkillSuggestions, fetchStats, fetchSuggestionCount, fetchSuggestions, resolveQuotedPosts, sifaQueryKeys, useActivityFeed, useActivityTeaser, useAppAccountCheck, useAppsRegistry, useAtFundLink, useCreatePosition, useEndorsementCount, useFeaturedProfile, useFollowing, useHeatmapData, useHiddenApps, useMyRoadmapVotes, useNetworkStreamCount, useProfile, useReactionStatus, useRoadmapVotes, useSearchFilters, useSearchProfiles, useSifaConfig, useSimilarProfiles, useSkillSuggestions, useStats, useSuggestionCount, useSuggestions };