@singi-labs/sifa-sdk 0.6.0 → 0.7.1

package/dist/query/index.d.ts

@@ -1,8 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { P as Profile } from '../index-IDRpze8y.js';
+import { f as Profile } from '../index-CpM21_Oy.js';
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { UseMutationOptions, UseQueryOptions } from '@tanstack/react-query';
+import { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
 
 /**
  * Foundation HTTP client for talking to the Sifa AppView.
@@ -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,15 +128,397 @@ 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;
+}
 /**
- * React hook for creating a new position record. On success, invalidates
- * the owner's profile cache so the new position is reflected on the next
- * read.
+ * 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;
+    handle: string;
+    displayName?: string;
+    headline?: string;
+    avatar?: string;
+    about?: string;
+    currentRole?: string;
+    currentCompany?: string;
+    industry?: string;
+    domain?: string;
+    countryCode?: string;
+    locationCountry?: string;
+    preferredWorkplace?: string[];
+    claimed?: boolean;
+    blueskyVerified?: boolean;
+    blueskyVerifiedAt?: string | null;
+}
+interface SearchFilters {
+    q?: string;
+    skill?: string;
+    country?: string;
+    industry?: string;
+    domain?: string;
+    workplace?: string;
+    app?: string;
+    limit?: number;
+}
+interface SearchResponse {
+    profiles: ProfileSearchResult[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+/** Skill typeahead suggestion. */
+interface SkillSearchResult {
+    name: string;
+    slug: string;
+    category: string;
+    userCount: number;
+}
+interface FilterOptions {
+    countries: {
+        countryCode: string;
+        country: string;
+        count: number;
+    }[];
+    industries: {
+        industry: string;
+        count: number;
+    }[];
+    apps: {
+        appId: string;
+        count: number;
+    }[];
+}
+/**
+ * Search profiles by free-text query and optional filters. Returns an
+ * empty result set when no filters are provided (matching sifa-web's
+ * "no input, no fetch" behavior).
+ */
+declare function fetchSearchProfiles(config: SifaApiConfig, filters: SearchFilters, options?: ApiFetchOptions): Promise<SearchResponse>;
+/**
+ * Skill typeahead. Returns up to 8 matches for the given prefix. Empty
+ * input returns an empty array without hitting the server.
+ */
+declare function fetchSkillSuggestions(config: SifaApiConfig, query: string, options?: ApiFetchOptions): Promise<SkillSearchResult[]>;
+/** Available filter facets (countries, industries, apps) for search UI. */
+declare function fetchSearchFilters(config: SifaApiConfig, options?: ApiFetchOptions): Promise<FilterOptions>;
+
+/** Lightweight profile representation used by discovery endpoints. */
+interface SimilarProfile {
+    did: string;
+    handle: string;
+    displayName?: string | null;
+    avatar?: string | null;
+    headline?: string | null;
+    currentRole?: string | null;
+    currentCompany?: string | null;
+    industry?: string | null;
+    domain?: string | null;
+}
+interface SuggestionProfile {
+    did: string;
+    handle: string;
+    displayName?: string;
+    headline?: string;
+    avatarUrl?: string;
+    source: string;
+    dismissed: boolean;
+    blueskyVerified?: boolean;
+}
+interface SuggestionsResponse {
+    onSifa: SuggestionProfile[];
+    notOnSifa: SuggestionProfile[];
+    cursor?: string;
+}
+interface FeaturedProfile {
+    did: string;
+    handle: string;
+    displayName?: string;
+    avatar?: string;
+    pronouns?: string;
+    headline?: string;
+    about?: string;
+    currentRole?: string;
+    currentCompany?: string;
+    locationCountry?: string;
+    locationRegion?: string;
+    /** Legacy alias for `locationLocality`; emitted by sifa-api during the additive response window. */
+    locationCity?: string;
+    /** community.lexicon.location.address field name -- prefer over `locationCity`. */
+    locationLocality?: string;
+    countryCode?: string;
+    location?: string;
+    website?: string;
+    openTo?: string[];
+    preferredWorkplace?: string[];
+    availableFromUtc?: number;
+    availableToUtc?: number;
+    followersCount?: number;
+    atprotoFollowersCount?: number;
+    pdsProvider?: {
+        name: string;
+        host: string;
+    } | null;
+    claimed: boolean;
+    featuredDate: string;
+}
+/** Profiles similar to the given DID (matchmaking). Returns `[]` on error. */
+declare function fetchSimilarProfiles(config: SifaApiConfig, did: string, opts?: {
+    limit?: number;
+} & ApiFetchOptions): Promise<SimilarProfile[]>;
+interface FetchSuggestionsOptions extends ApiFetchOptions {
+    source?: string;
+    includeDismissed?: boolean;
+    cursor?: string;
+    limit?: number;
+    /**
+     * 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;
+}
+/** Discovery suggestions feed. Resolves to empty arrays on error. */
+declare function fetchSuggestions(config: SifaApiConfig, opts?: FetchSuggestionsOptions): Promise<SuggestionsResponse>;
+/** Count of pending suggestions since an optional timestamp. */
+declare function fetchSuggestionCount(config: SifaApiConfig, since?: string, options?: ApiFetchOptions): Promise<number>;
+/** Featured profile (rotated by sifa-api). Returns `null` when none. */
+declare function fetchFeaturedProfile(config: SifaApiConfig, options?: ApiFetchOptions): Promise<FeaturedProfile | null>;
+
+interface FollowProfile {
+    did: string;
+    handle: string;
+    displayName?: string;
+    headline?: string;
+    avatarUrl?: string;
+    source: string;
+    claimed: boolean;
+    followedAt: string;
+    blueskyVerified?: boolean;
+    blueskyVerifiedAt?: string | null;
+}
+interface FollowingResponse {
+    follows: FollowProfile[];
+    cursor?: string;
+}
+/** People the authenticated user follows. Empty on error. */
+declare function fetchFollowing(config: SifaApiConfig, opts?: {
+    source?: string;
+    cursor?: string;
+    limit?: number;
+} & ApiFetchOptions): Promise<FollowingResponse>;
+
+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;
+}
+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.
  *
- * The owner DID is required so the mutation can target the correct
- * profile cache entry for invalidation.
+ * Public endpoint -- no credentials needed.
  */
-declare function useCreatePosition(ownerDid: string, options?: Omit<UseMutationOptions<CreateResult, Error, Record<string, unknown>>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<CreateResult, Error, Record<string, unknown>, unknown>;
+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.
@@ -148,13 +536,64 @@ 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"];
         readonly byOwner: (did: string) => readonly ["sifa", "position", "by-owner", string];
     };
+    readonly search: {
+        readonly all: () => readonly ["sifa", "search"];
+        readonly profiles: (filters: Record<string, unknown>) => readonly ["sifa", "search", "profiles", Record<string, unknown>];
+        readonly skills: (query: string) => readonly ["sifa", "search", "skills", string];
+        readonly filters: () => readonly ["sifa", "search", "filters"];
+    };
+    readonly discovery: {
+        readonly all: () => readonly ["sifa", "discovery"];
+        readonly similar: (did: string, limit: number) => readonly ["sifa", "discovery", "similar", string, number];
+        readonly suggestions: (opts: Record<string, unknown>) => readonly ["sifa", "discovery", "suggestions", Record<string, unknown>];
+        readonly suggestionCount: (since: string | undefined) => readonly ["sifa", "discovery", "suggestion-count", string | null];
+        readonly featured: () => readonly ["sifa", "discovery", "featured"];
+    };
+    readonly follow: {
+        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>;
+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
@@ -164,5 +603,76 @@ 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
+ * the owner's profile cache so the new position is reflected on the next
+ * read.
+ *
+ * The owner DID is required so the mutation can target the correct
+ * profile cache entry for invalidation.
+ */
+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>;
+
+declare function useSimilarProfiles(did: string | undefined | null, opts?: {
+    limit?: number;
+}, options?: Omit<UseQueryOptions<SimilarProfile[], Error, SimilarProfile[], ReturnType<typeof sifaQueryKeys.discovery.similar>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<SimilarProfile[], Error>;
+declare function useSuggestions(opts?: Omit<FetchSuggestionsOptions, keyof Omit<FetchSuggestionsOptions, 'source' | 'includeDismissed' | 'cursor' | 'limit'>>, options?: Omit<UseQueryOptions<SuggestionsResponse, Error, SuggestionsResponse, ReturnType<typeof sifaQueryKeys.discovery.suggestions>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<SuggestionsResponse, Error>;
+declare function useSuggestionCount(since?: string, options?: Omit<UseQueryOptions<number, Error, number, ReturnType<typeof sifaQueryKeys.discovery.suggestionCount>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<number, Error>;
+declare function useFeaturedProfile(options?: Omit<UseQueryOptions<FeaturedProfile | null, Error, FeaturedProfile | null, ReturnType<typeof sifaQueryKeys.discovery.featured>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<FeaturedProfile | null, Error>;
+
+declare function useFollowing(opts?: {
+    source?: string;
+    cursor?: string;
+    limit?: number;
+}, options?: Omit<UseQueryOptions<FollowingResponse, Error, FollowingResponse, ReturnType<typeof sifaQueryKeys.follow.following>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<FollowingResponse, Error>;
+
+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 { ApiError, type ApiFetchOptions, type CreateResult, type SifaApiConfig, SifaProvider, type SifaProviderProps, type SifaQueryKey, type WriteResult, apiFetch, apiFetchOrNull, createPosition, fetchProfile, sifaQueryKeys, useCreatePosition, useProfile, useSifaConfig };
+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, type ReactionStatus, 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, 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 };