@singi-labs/sifa-sdk 0.9.19 → 0.9.20

package/dist/query/hooks/index.d.ts

@@ -0,0 +1,479 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { a7 as SifaApiConfig, bc as sifaQueryKeys, ai as WriteResult, a1 as RefreshPdsResult, ae as UpdateProfileOverrideInput, af as UpdateProfileSelfInput, ag as UploadAvatarResult, i as CreateResult, R as ProfileLocationInput, j as ExternalAccountInput, h as CreateExternalAccountResult, ah as VerifyExternalAccountResult, E as EndorsementInput, a0 as RefreshOrcidPublicationsResult, B as BulkHideProfileItemInput, N as HideProfileItemInput, ab as StatsResponse, g as AppRegistryEntry, K as HiddenApp, u as FilterOptions, a5 as SearchFilters, a6 as SearchResponse, aa as SkillSearchResult, k as FeaturedProfile, a9 as SimilarProfile, t as FetchSuggestionsOptions, ad as SuggestionsResponse, y as FollowUserResult, n as FetchFollowListOptions, v as FollowListPage, z as FollowingResponse, p as FetchFollowingFeedOptions, o as FetchFollowProfilePageOptions, x as FollowProfilePageResponse, F as FeatureAllowlistResponse, l as FetchActivityFeedOptions, a as ActivityFeedResponse, d as ActivityTeaserResponse, J as HeatmapResponse, A as AccountCheckResult, $ as ReactionStatus, _ as ReactionResult, Z as ReactionError, a4 as RoadmapVotesResponse, D as DeleteAccountResult } from '../../keys-D-vNPzXx.js';
+export { a8 as SifaQueryKey } from '../../keys-D-vNPzXx.js';
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { UseQueryOptions, UseMutationOptions, UseInfiniteQueryOptions, InfiniteData } from '@tanstack/react-query';
+import { b as Profile, o as ProfilePosition, t as SkillRef, E as ExternalAccount, S as SkillSuggestion } from '../../index-DYUYJxOs.js';
+import { F as FollowFeedPage, c as FeatureFlag } from '../../feed-DHTy7fUN.js';
+import 'zod';
+
+interface SifaProviderProps {
+    config: SifaApiConfig;
+    children: ReactNode;
+}
+/**
+ * Provides the {@link SifaApiConfig} that hooks under it can read via
+ * {@link useSifaConfig}. Wrap the React tree once; hooks consume it.
+ *
+ * @example
+ * ```tsx
+ * <QueryClientProvider client={queryClient}>
+ *   <SifaProvider config={{ baseUrl: process.env.NEXT_PUBLIC_API_URL! }}>
+ *     <App />
+ *   </SifaProvider>
+ * </QueryClientProvider>
+ * ```
+ */
+declare function SifaProvider({ config, children }: SifaProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Read the SDK's {@link SifaApiConfig} from context. Throws if no
+ * {@link SifaProvider} is mounted above.
+ */
+declare function useSifaConfig(): SifaApiConfig;
+
+/**
+ * React hook that reads an aggregated profile by handle or DID via
+ * TanStack Query. Returns `null` data when the profile does not exist.
+ *
+ * Pass `{ enabled: false }` (or an empty `handleOrDid`) to defer the
+ * 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<NoInfer<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 updating the authenticated user's profile self record.
+ * On success, invalidates the owner's profile cache.
+ *
+ * The owner identifier (handle or DID) is required so the mutation can
+ * target the right profile cache entry for invalidation.
+ */
+declare function useUpdateProfileSelf(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, UpdateProfileSelfInput>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, UpdateProfileSelfInput, unknown>;
+/** React hook for updating the authenticated user's profile override fields. */
+declare function useUpdateProfileOverride(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, UpdateProfileOverrideInput>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, UpdateProfileOverrideInput, unknown>;
+/** React hook for re-pulling the authenticated user's PDS-side profile. */
+declare function useRefreshPds(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<RefreshPdsResult, Error, void>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<RefreshPdsResult, Error, void, unknown>;
+/**
+ * React hook for uploading a new avatar. Pass a `File` (browser) or
+ * `Blob` (Expo) as the mutation variable.
+ */
+declare function useUploadAvatar(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<UploadAvatarResult, Error, Blob>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<UploadAvatarResult, Error, Blob, unknown>;
+/** React hook for deleting the avatar override (revert to PDS avatar). */
+declare function useDeleteAvatarOverride(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, void>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, void, unknown>;
+
+/**
+ * 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>;
+
+/** Variables for {@link useUpdatePosition}. */
+interface UpdatePositionVariables {
+    rkey: string;
+    data: Record<string, unknown>;
+}
+/** React hook for updating a position record. */
+declare function useUpdatePosition(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, UpdatePositionVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, UpdatePositionVariables, unknown>;
+/** React hook for deleting a position record. Variable: the `rkey` string. */
+declare function useDeletePosition(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
+/** React hook for marking a position as primary. Variable: the `rkey` string. */
+declare function useSetPositionPrimary(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
+/** React hook for clearing the primary flag on a position. */
+declare function useUnsetPositionPrimary(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
+/** Variables for {@link useLinkSkillToPosition} / {@link useUnlinkSkillFromPosition}. */
+interface PositionSkillLinkVariables {
+    position: ProfilePosition;
+    skillRef: SkillRef;
+}
+/** React hook for linking a skill to a position. Idempotent. */
+declare function useLinkSkillToPosition(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, PositionSkillLinkVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, PositionSkillLinkVariables, unknown>;
+/** React hook for unlinking a skill from a position. */
+declare function useUnlinkSkillFromPosition(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, PositionSkillLinkVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, PositionSkillLinkVariables, unknown>;
+
+/** React hook for creating an education record. */
+declare function useCreateEducation(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<CreateResult, Error, Record<string, unknown>>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<CreateResult, Error, Record<string, unknown>, unknown>;
+/** Variables for {@link useUpdateEducation}. */
+interface UpdateEducationVariables {
+    rkey: string;
+    data: Record<string, unknown>;
+}
+/** React hook for updating an education record. */
+declare function useUpdateEducation(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, UpdateEducationVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, UpdateEducationVariables, unknown>;
+/** React hook for deleting an education record. Variable: the `rkey` string. */
+declare function useDeleteEducation(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
+
+/** React hook for creating a skill record. */
+declare function useCreateSkill(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<CreateResult, Error, Record<string, unknown>>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<CreateResult, Error, Record<string, unknown>, unknown>;
+/** Variables for {@link useUpdateSkill}. */
+interface UpdateSkillVariables {
+    rkey: string;
+    data: Record<string, unknown>;
+}
+/** React hook for updating a skill record. */
+declare function useUpdateSkill(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, UpdateSkillVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, UpdateSkillVariables, unknown>;
+/** React hook for deleting a skill record. Variable: the `rkey` string. */
+declare function useDeleteSkill(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
+
+/** Variables for {@link useCreateRecord}. */
+interface CreateRecordVariables {
+    collection: string;
+    data: Record<string, unknown>;
+}
+/**
+ * Generic record-create escape hatch for collections without a
+ * dedicated section helper (certifications, projects, publications,
+ * volunteering, honors, languages, courses). Prefer the typed helpers
+ * when one exists for the section.
+ */
+declare function useCreateRecord(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<CreateResult, Error, CreateRecordVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<CreateResult, Error, CreateRecordVariables, unknown>;
+/** Variables for {@link useUpdateRecord}. */
+interface UpdateRecordVariables {
+    collection: string;
+    rkey: string;
+    data: Record<string, unknown>;
+}
+/** Generic record-update escape hatch. See {@link useCreateRecord}. */
+declare function useUpdateRecord(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, UpdateRecordVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, UpdateRecordVariables, unknown>;
+/** Variables for {@link useDeleteRecord}. */
+interface DeleteRecordVariables {
+    collection: string;
+    rkey: string;
+}
+/** Generic record-delete escape hatch. See {@link useCreateRecord}. */
+declare function useDeleteRecord(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, DeleteRecordVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, DeleteRecordVariables, unknown>;
+
+/** React hook for creating a profile location record. */
+declare function useCreateProfileLocation(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<CreateResult, Error, ProfileLocationInput>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<CreateResult, Error, ProfileLocationInput, unknown>;
+/** Variables for {@link useUpdateProfileLocation}. */
+interface UpdateProfileLocationVariables {
+    rkey: string;
+    data: ProfileLocationInput;
+}
+/** React hook for updating a profile location record. */
+declare function useUpdateProfileLocation(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, UpdateProfileLocationVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, UpdateProfileLocationVariables, unknown>;
+/** React hook for deleting a profile location record. Variable: the `rkey` string. */
+declare function useDeleteProfileLocation(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
+
+/** React hook for reading the external-accounts list. Returns `[]` data on error. */
+declare function useExternalAccounts(handleOrDid: string | undefined | null, options?: Omit<UseQueryOptions<ExternalAccount[], Error, ExternalAccount[], ReturnType<typeof sifaQueryKeys.profile.externalAccounts>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<ExternalAccount[]>, Error>;
+/** React hook for creating an external account. */
+declare function useCreateExternalAccount(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<CreateExternalAccountResult, Error, ExternalAccountInput>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<CreateExternalAccountResult, Error, ExternalAccountInput, unknown>;
+/** Variables for {@link useUpdateExternalAccount}. */
+interface UpdateExternalAccountVariables {
+    rkey: string;
+    data: ExternalAccountInput;
+}
+/** React hook for updating an external account. */
+declare function useUpdateExternalAccount(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, UpdateExternalAccountVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, UpdateExternalAccountVariables, unknown>;
+/** React hook for deleting an external account. Variable: the `rkey` string. */
+declare function useDeleteExternalAccount(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
+/** React hook for marking an external account primary. */
+declare function useSetExternalAccountPrimary(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
+/** React hook for clearing the primary flag on an external account. */
+declare function useUnsetExternalAccountPrimary(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
+/** React hook for running server-side verification of an external account. */
+declare function useVerifyExternalAccount(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<VerifyExternalAccountResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<VerifyExternalAccountResult, Error, string, unknown>;
+
+/**
+ * React hook for creating an endorsement of another user's skill. The
+ * mutation needs the endorsed user's handle/DID (not the endorser's)
+ * so the endorsed profile + their endorsement count caches get
+ * invalidated; pass `null` to skip endorsed-profile invalidation
+ * (e.g., if you only know the skill URI).
+ */
+declare function useCreateEndorsement(endorsedHandleOrDid: string | null, options?: Omit<UseMutationOptions<CreateResult, Error, EndorsementInput>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<CreateResult, Error, EndorsementInput, unknown>;
+
+/** React hook for hiding a keytrace claim. Variable: the claim `rkey` string. */
+declare function useHideKeytraceClaim(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
+/** React hook for unhiding a previously-hidden keytrace claim. */
+declare function useUnhideKeytraceClaim(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
+
+/** React hook for hiding an ORCID publication. Variable: the `putCode` number. */
+declare const useHideOrcidPublication: (ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, number, unknown>, "mutationFn"> | undefined) => _tanstack_react_query.UseMutationResult<WriteResult, Error, number, unknown>;
+/** React hook for unhiding an ORCID publication. Variable: the `putCode` number. */
+declare const useUnhideOrcidPublication: (ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, number, unknown>, "mutationFn"> | undefined) => _tanstack_react_query.UseMutationResult<WriteResult, Error, number, unknown>;
+/** React hook for hiding a standard publication. Variable: the AT URI string. */
+declare const useHideStandardPublication: (ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string, unknown>, "mutationFn"> | undefined) => _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
+/** React hook for unhiding a standard publication. Variable: the AT URI string. */
+declare const useUnhideStandardPublication: (ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string, unknown>, "mutationFn"> | undefined) => _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
+/** React hook for bulk-hiding standard publications. Variable: the URI list. */
+declare const useBulkHideStandardPublications: (ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string[], unknown>, "mutationFn"> | undefined) => _tanstack_react_query.UseMutationResult<WriteResult, Error, string[], unknown>;
+/** React hook for bulk-unhiding standard publications. Variable: the URI list. */
+declare const useBulkUnhideStandardPublications: (ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string[], unknown>, "mutationFn"> | undefined) => _tanstack_react_query.UseMutationResult<WriteResult, Error, string[], unknown>;
+/** React hook for hiding a Sifa-authored publication. Variable: the `rkey` string. */
+declare const useHideSifaPublication: (ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string, unknown>, "mutationFn"> | undefined) => _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
+/** React hook for unhiding a Sifa-authored publication. Variable: the `rkey` string. */
+declare const useUnhideSifaPublication: (ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string, unknown>, "mutationFn"> | undefined) => _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
+/** React hook for re-pulling ORCID publications. */
+declare function useRefreshOrcidPublications(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<RefreshOrcidPublicationsResult, Error, void>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<RefreshOrcidPublicationsResult, Error, void, unknown>;
+
+/**
+ * Hide one profile item across any supported section. The underlying
+ * record stays on the user's PDS; only its display on sifa.id is
+ * suppressed.
+ */
+declare const useHideProfileItem: (ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, HideProfileItemInput, unknown>, "mutationFn"> | undefined) => _tanstack_react_query.UseMutationResult<WriteResult, Error, HideProfileItemInput, unknown>;
+/** Restore a previously-hidden profile item. */
+declare const useUnhideProfileItem: (ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, HideProfileItemInput, unknown>, "mutationFn"> | undefined) => _tanstack_react_query.UseMutationResult<WriteResult, Error, HideProfileItemInput, unknown>;
+/** Bulk-hide profile items sharing the same `itemType` + `source`. */
+declare const useBulkHideProfileItems: (ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, BulkHideProfileItemInput, unknown>, "mutationFn"> | undefined) => _tanstack_react_query.UseMutationResult<WriteResult, Error, BulkHideProfileItemInput, unknown>;
+/** Bulk-unhide profile items sharing the same `itemType` + `source`. */
+declare const useBulkUnhideProfileItems: (ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, BulkHideProfileItemInput, unknown>, "mutationFn"> | undefined) => _tanstack_react_query.UseMutationResult<WriteResult, Error, BulkHideProfileItemInput, 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<NoInfer<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<NoInfer<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<NoInfer<HiddenApp[]>, Error>;
+
+declare function useSearchProfiles(filters: SearchFilters, options?: Omit<UseQueryOptions<SearchResponse, Error, SearchResponse, ReturnType<typeof sifaQueryKeys.search.profiles>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<SearchResponse>, Error>;
+declare function useSkillSuggestions(query: string, options?: Omit<UseQueryOptions<SkillSearchResult[], Error, SkillSearchResult[], ReturnType<typeof sifaQueryKeys.search.skills>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<SkillSearchResult[]>, Error>;
+/**
+ * Canonical-skill search hook. Hits `/api/skills/search` (the
+ * canonical-skills DB lookup, distinct from {@link useSkillSuggestions}'s
+ * `/api/search/skills` profile-skill typeahead). Skips the network call
+ * when the query is empty.
+ */
+declare function useCanonicalSkillSearch(query: string, limit?: number, options?: Omit<UseQueryOptions<SkillSuggestion[], Error, SkillSuggestion[], ReturnType<typeof sifaQueryKeys.search.canonicalSkills>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<SkillSuggestion[]>, Error>;
+declare function useSearchFilters(options?: Omit<UseQueryOptions<FilterOptions, Error, FilterOptions, ReturnType<typeof sifaQueryKeys.search.filters>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<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<NoInfer<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<NoInfer<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<NoInfer<FeaturedProfile | null>, Error>;
+
+/**
+ * Legacy "people I follow" query. Kept as-is for back-compat with sifa-web
+ * call sites that pre-date the V5 feed work. New code should use
+ * {@link useFollowingList} (paginated per-profile) or
+ * {@link useFollowingFeed} (V5 feed).
+ */
+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<NoInfer<FollowingResponse>, Error>;
+/** Variables for {@link useFollow}. */
+interface FollowVariables {
+    handle: string;
+    /** Server-resolved DID of the subject, when known. Used for optimistic cache writes. */
+    subjectDid?: string;
+    /** Optional Sifa-only "why I followed" note (max 200 graphemes). */
+    note?: string;
+}
+/** Variables for {@link useUnfollow}. */
+interface UnfollowVariables {
+    handle: string;
+}
+/**
+ * Mutation hook for following a handle. Optimistically marks the
+ * follow-state cache as `true` and rolls back on failure (per
+ * sifa-api#673 TR8 / iter-1 plan TR8). Invalidates the followers /
+ * following lists and the V5 feed on success so they refetch.
+ *
+ * Optimistic cache entry: `sifaQueryKeys.follow.followers(handle)`
+ * receives the viewer prepended to the list shape; the optimistic update
+ * is intentionally conservative — it only flips per-handle state and
+ * doesn't try to invent rich `FollowProfile` fields.
+ */
+declare function useFollow(options?: Omit<UseMutationOptions<FollowUserResult, Error, FollowVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<FollowUserResult, Error, FollowVariables, unknown>;
+/**
+ * Mutation hook for unfollowing a handle. Optimistic + rollback mirror
+ * of {@link useFollow}.
+ */
+declare function useUnfollow(options?: Omit<UseMutationOptions<WriteResult, Error, UnfollowVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, UnfollowVariables, unknown>;
+/** Infinite-query hook for `handle`'s followers list. */
+declare function useFollowers(handle: string, opts?: Omit<FetchFollowListOptions, 'cursor'>, options?: Omit<UseInfiniteQueryOptions<FollowListPage, Error, InfiniteData<FollowListPage>, ReturnType<typeof sifaQueryKeys.follow.followers>, string | undefined>, 'queryKey' | 'queryFn' | 'initialPageParam' | 'getNextPageParam'>): _tanstack_react_query.UseInfiniteQueryResult<InfiniteData<FollowListPage, unknown>, Error>;
+/** Infinite-query hook for who `handle` follows. */
+declare function useFollowingList(handle: string, opts?: Omit<FetchFollowListOptions, 'cursor'>, options?: Omit<UseInfiniteQueryOptions<FollowListPage, Error, InfiniteData<FollowListPage>, ReturnType<typeof sifaQueryKeys.follow.followingOf>, string | undefined>, 'queryKey' | 'queryFn' | 'initialPageParam' | 'getNextPageParam'>): _tanstack_react_query.UseInfiniteQueryResult<InfiniteData<FollowListPage, unknown>, Error>;
+/**
+ * Infinite-query hook for the V5 home feed (authenticated viewer).
+ *
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
+ *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
+ *   Stream are two distinct surfaces with different data paths (Barazo API
+ *   for Timeline, live PDS reads + Valkey for Stream). This hook is no
+ *   longer consumed. Scheduled for removal in next major bump.
+ */
+declare function useFollowingFeed(opts?: Omit<FetchFollowingFeedOptions, 'cursor'>, options?: Omit<UseInfiniteQueryOptions<FollowFeedPage, Error, InfiniteData<FollowFeedPage>, ReturnType<typeof sifaQueryKeys.follow.feed>, string | undefined>, 'queryKey' | 'queryFn' | 'initialPageParam' | 'getNextPageParam'>): _tanstack_react_query.UseInfiniteQueryResult<InfiniteData<{
+    items: ({
+        id: string;
+        actor: {
+            did: string;
+            handle: string;
+            displayName?: string | undefined;
+            avatarUrl?: string | undefined;
+        };
+        indexedAt: string;
+        eventType: string;
+        source: "sifa";
+        payload: Record<string, unknown>;
+        appId?: "sifa" | undefined;
+    } | {
+        id: string;
+        actor: {
+            did: string;
+            handle: string;
+            displayName?: string | undefined;
+            avatarUrl?: string | undefined;
+        };
+        indexedAt: string;
+        eventType: string;
+        source: "atmosphere";
+        appId: string;
+        payload: Record<string, unknown>;
+        uri?: string | undefined;
+        cid?: string | undefined;
+    })[];
+    cursor: string | null;
+}, unknown>, Error>;
+
+/**
+ * Infinite-query hook for the mutuals list of `handleOrDid`. Backed by
+ * {@link getMutuals} (`GET /api/profile/{handleOrDid}/mutuals`). Disabled
+ * when `handleOrDid` is empty so component-mount with a lazy handle doesn't
+ * fire a wasted request.
+ */
+declare function useMutuals(handleOrDid: string, opts?: Omit<FetchFollowProfilePageOptions, 'cursor'>, options?: Omit<UseInfiniteQueryOptions<FollowProfilePageResponse, Error, InfiniteData<FollowProfilePageResponse>, ReturnType<typeof sifaQueryKeys.follow.mutuals>, string | undefined>, 'queryKey' | 'queryFn' | 'initialPageParam' | 'getNextPageParam'>): _tanstack_react_query.UseInfiniteQueryResult<InfiniteData<FollowProfilePageResponse, unknown>, Error>;
+/**
+ * Infinite-query hook for the authenticated viewer's Bluesky-follow
+ * suggestions (people the viewer follows on Bluesky but not Sifa).
+ * Backed by {@link getBlueskySuggestions}.
+ */
+declare function useBlueskySuggestions(opts?: Omit<FetchFollowProfilePageOptions, 'cursor'>, options?: Omit<UseInfiniteQueryOptions<FollowProfilePageResponse, Error, InfiniteData<FollowProfilePageResponse>, ReturnType<typeof sifaQueryKeys.follow.blueskySuggestions>, string | undefined>, 'queryKey' | 'queryFn' | 'initialPageParam' | 'getNextPageParam'>): _tanstack_react_query.UseInfiniteQueryResult<InfiniteData<FollowProfilePageResponse, unknown>, Error>;
+
+/**
+ * Read hook for the admin allowlist of a given feature flag. Admin-gated on
+ * the server; non-admins get an empty list (the fetcher swallows 403).
+ */
+declare function useFeatureAllowlist(flag: FeatureFlag, options?: Omit<UseQueryOptions<FeatureAllowlistResponse, Error, FeatureAllowlistResponse, ReturnType<typeof sifaQueryKeys.admin.featureAllowlist>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<FeatureAllowlistResponse>, Error>;
+/** Snapshot of the previous cache entry; returned from `onMutate` for rollback. */
+interface AllowlistMutationContext {
+    previous: FeatureAllowlistResponse | undefined;
+}
+/** Variables for {@link useAddFeatureAllowlist}. */
+interface AddFeatureAllowlistVariables {
+    did: string;
+    note?: string;
+}
+/**
+ * Mutation hook to add (or upsert) a DID on the given flag's allowlist.
+ * Optimistically prepends a synthesized entry to the cache so admin UIs feel
+ * instant; rolls back if the server reports failure.
+ */
+declare function useAddFeatureAllowlist(flag: FeatureFlag, options?: Omit<UseMutationOptions<WriteResult, Error, AddFeatureAllowlistVariables, AllowlistMutationContext>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, AddFeatureAllowlistVariables, AllowlistMutationContext>;
+/** Variables for {@link useRemoveFeatureAllowlist}. */
+interface RemoveFeatureAllowlistVariables {
+    did: string;
+}
+/**
+ * Mutation hook to remove a DID from the given flag's allowlist.
+ * Optimistically removes the row from the cache; rolls back if the server
+ * reports failure.
+ */
+declare function useRemoveFeatureAllowlist(flag: FeatureFlag, options?: Omit<UseMutationOptions<WriteResult, Error, RemoveFeatureAllowlistVariables, AllowlistMutationContext>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, RemoveFeatureAllowlistVariables, AllowlistMutationContext>;
+
+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<NoInfer<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<NoInfer<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<NoInfer<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<NoInfer<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<NoInfer<AccountCheckResult | null>, Error>;
+
+/** Variables for {@link useCreateReaction}. */
+interface CreateReactionVariables {
+    targetUri: string;
+    appId: string;
+    targetCid?: string;
+}
+type CreateReactionMutationResult = {
+    ok: true;
+    data: ReactionResult;
+} | {
+    ok: false;
+    error: ReactionError;
+};
+/**
+ * React hook for creating a reaction. Returns the discriminated-union
+ * result so the caller can detect `scope_insufficient` and trigger an
+ * OAuth scope-upgrade flow.
+ *
+ * Invalidates the entire `sifaQueryKeys.reactions.all()` subtree on
+ * success (any cached `useReactionStatus` view that includes the new
+ * URI needs a refresh).
+ */
+declare function useCreateReaction(options?: Omit<UseMutationOptions<CreateReactionMutationResult, Error, CreateReactionVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<{
+    ok: true;
+    data: ReactionResult;
+} | {
+    ok: false;
+    error: ReactionError;
+}, Error, CreateReactionVariables, unknown>;
+/** Variables for {@link useDeleteReaction}. */
+interface DeleteReactionVariables {
+    targetUri: string;
+    appId: string;
+}
+/** React hook for deleting a reaction. */
+declare function useDeleteReaction(options?: Omit<UseMutationOptions<WriteResult, Error, DeleteReactionVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, DeleteReactionVariables, unknown>;
+
+/** 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<NoInfer<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<NoInfer<string[]>, Error>;
+
+/** React hook for casting a roadmap vote. Variable: the item key. */
+declare function useCastRoadmapVote(options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
+/** React hook for retracting a previously-cast roadmap vote. */
+declare function useRetractRoadmapVote(options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
+
+/**
+ * React hook for resetting the authenticated user's Sifa profile.
+ * Variable: `deletePdsData` boolean.
+ *
+ * Invalidates the entire `sifaQueryKeys.all()` subtree on success
+ * (everything Sifa-related needs a refresh after a reset).
+ */
+declare function useResetProfile(options?: Omit<UseMutationOptions<WriteResult, Error, boolean>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, boolean, unknown>;
+/**
+ * React hook for deleting the authenticated user's account. Variable:
+ * `deletePdsData` boolean. Returns the deleted handle on success.
+ *
+ * On success, clears the entire query cache (the user is logged out
+ * and nothing they previously cached should be retained).
+ */
+declare function useDeleteAccount(options?: Omit<UseMutationOptions<DeleteAccountResult, Error, boolean>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<DeleteAccountResult, Error, boolean, unknown>;
+
+export { type AddFeatureAllowlistVariables, type CreateReactionVariables, type CreateRecordVariables, type DeleteReactionVariables, type DeleteRecordVariables, type FollowVariables, type PositionSkillLinkVariables, type RemoveFeatureAllowlistVariables, SifaProvider, type SifaProviderProps, type UnfollowVariables, type UpdateEducationVariables, type UpdateExternalAccountVariables, type UpdatePositionVariables, type UpdateProfileLocationVariables, type UpdateRecordVariables, type UpdateSkillVariables, sifaQueryKeys, useActivityFeed, useActivityTeaser, useAddFeatureAllowlist, useAppAccountCheck, useAppsRegistry, useAtFundLink, useBlueskySuggestions, useBulkHideProfileItems, useBulkHideStandardPublications, useBulkUnhideProfileItems, useBulkUnhideStandardPublications, useCanonicalSkillSearch, useCastRoadmapVote, useCreateEducation, useCreateEndorsement, useCreateExternalAccount, useCreatePosition, useCreateProfileLocation, useCreateReaction, useCreateRecord, useCreateSkill, useDeleteAccount, useDeleteAvatarOverride, useDeleteEducation, useDeleteExternalAccount, useDeletePosition, useDeleteProfileLocation, useDeleteReaction, useDeleteRecord, useDeleteSkill, useEndorsementCount, useExternalAccounts, useFeatureAllowlist, useFeaturedProfile, useFollow, useFollowers, useFollowing, useFollowingFeed, useFollowingList, useHeatmapData, useHiddenApps, useHideKeytraceClaim, useHideOrcidPublication, useHideProfileItem, useHideSifaPublication, useHideStandardPublication, useLinkSkillToPosition, useMutuals, useMyRoadmapVotes, useNetworkStreamCount, useProfile, useReactionStatus, useRefreshOrcidPublications, useRefreshPds, useRemoveFeatureAllowlist, useResetProfile, useRetractRoadmapVote, useRoadmapVotes, useSearchFilters, useSearchProfiles, useSetExternalAccountPrimary, useSetPositionPrimary, useSifaConfig, useSimilarProfiles, useSkillSuggestions, useStats, useSuggestionCount, useSuggestions, useUnfollow, useUnhideKeytraceClaim, useUnhideOrcidPublication, useUnhideProfileItem, useUnhideSifaPublication, useUnhideStandardPublication, useUnlinkSkillFromPosition, useUnsetExternalAccountPrimary, useUnsetPositionPrimary, useUpdateEducation, useUpdateExternalAccount, useUpdatePosition, useUpdateProfileLocation, useUpdateProfileOverride, useUpdateProfileSelf, useUpdateRecord, useUpdateSkill, useUploadAvatar, useVerifyExternalAccount };