@singi-labs/sifa-sdk 0.7.2 → 0.7.4

package/dist/query/index.d.ts

@@ -1,71 +1,10 @@
+import { SifaApiConfig, sifaQueryKeys, WriteResult, RefreshPdsResult, UpdateProfileOverrideInput, UpdateProfileSelfInput, UploadAvatarResult, CreateResult, ProfileLocationInput, ExternalAccountInput, CreateExternalAccountResult, VerifyExternalAccountResult, EndorsementInput, RefreshOrcidPublicationsResult, StatsResponse, AppRegistryEntry, HiddenApp, FilterOptions, SearchFilters, SearchResponse, SkillSearchResult, FeaturedProfile, SimilarProfile, FetchSuggestionsOptions, SuggestionsResponse, FollowingResponse, FetchActivityFeedOptions, ActivityFeedResponse, ActivityTeaserResponse, HeatmapResponse, AccountCheckResult, ReactionStatus, ReactionResult, ReactionError, RoadmapVotesResponse, DeleteAccountResult } from './fetchers/index.js';
+export { ActivityItem, ApiError, ApiFetchOptions, CheckAppAccountOptions, FetchActivityTeaserOptions, FetchHiddenAppsOptions, FetchMyRoadmapVotesOptions, FetchNetworkStreamCountOptions, FetchReactionStatusOptions, FollowProfile, HeatmapDay, ProfileIndustryInput, ProfileLocationAddress, ProfileSearchResult, ProfileSelfLocation, QUOTED_POSTS_BATCH_MAX, QuotedPostAuthor, QuotedPostImage, QuotedPostResult, QuotedPostView, ResolveQuotedPostsOptions, RoadmapVoter, SifaQueryKey, SuggestionProfile, apiFetch, apiFetchOrNull, apiWrite, apiWriteCreate, bulkHideStandardPublications, bulkUnhideStandardPublications, castRoadmapVote, checkAppAccount, createEducation, createEndorsement, createExternalAccount, createPosition, createProfileLocation, createReaction, createRecord, createSkill, deleteAccount, deleteAvatarOverride, deleteEducation, deleteExternalAccount, deletePosition, deleteProfileLocation, deleteReaction, deleteRecord, deleteSkill, fetchActivityFeed, fetchActivityTeaser, fetchAppsRegistry, fetchAtFundLink, fetchEndorsementCount, fetchExternalAccounts, fetchFeaturedProfile, fetchFollowing, fetchHeatmapData, fetchHiddenApps, fetchMyRoadmapVotes, fetchNetworkStreamCount, fetchProfile, fetchReactionStatus, fetchRoadmapVotes, fetchSearchFilters, fetchSearchProfiles, fetchSimilarProfiles, fetchSkillSuggestions, fetchStats, fetchSuggestionCount, fetchSuggestions, hideKeytraceClaim, hideOrcidPublication, hideSifaPublication, hideStandardPublication, linkSkillToPosition, refreshOrcidPublications, refreshPds, resetProfile, resolveQuotedPosts, retractRoadmapVote, searchSkills, setExternalAccountPrimary, setPositionPrimary, unhideKeytraceClaim, unhideOrcidPublication, unhideSifaPublication, unhideStandardPublication, unlinkSkillFromPosition, unsetExternalAccountPrimary, unsetPositionPrimary, updateEducation, updateExternalAccount, updatePosition, updateProfileLocation, updateProfileOverride, updateProfileSelf, updateRecord, updateSkill, uploadAvatar, verifyExternalAccount } from './fetchers/index.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { f as Profile } from '../index-CpM21_Oy.js';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
-
-/**
- * Foundation HTTP client for talking to the Sifa AppView.
- *
- * Stateless. Consumers supply a {@link SifaApiConfig} per call (the React
- * hooks read it from context; non-React consumers pass it explicitly). No
- * singletons, no module-level state.
- */
-/** Configuration passed to every fetcher. */
-interface SifaApiConfig {
-    /** Base URL of the sifa-api AppView, e.g. `https://api.sifa.id`. No trailing slash. */
-    baseUrl: string;
-    /**
-     * Optional fetch implementation. Defaults to {@link globalThis.fetch}.
-     * Lets Next.js consumers pass their cache-enhanced fetch; node/Expo
-     * consumers can leave this unset.
-     */
-    fetch?: typeof fetch;
-}
-/** Options accepted by {@link apiFetch}. */
-interface ApiFetchOptions {
-    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
-    /** Request body. Serialized to JSON automatically. */
-    body?: unknown;
-    /** AbortSignal. Defaults to `AbortSignal.timeout(timeoutMs)` if `timeoutMs` is set. */
-    signal?: AbortSignal;
-    /** Per-call timeout in milliseconds. Default: 10_000. Ignored if `signal` is provided. */
-    timeoutMs?: number;
-    /** Retry on HTTP 429 up to 3 times with the server's `Retry-After` delay (capped at 3s). */
-    retryOn429?: boolean;
-    /** Additional headers. `Content-Type: application/json` is set automatically when `body` is present. */
-    headers?: Record<string, string>;
-    credentials?: RequestCredentials;
-    cache?: RequestCache;
-    /**
-     * Next.js-specific cache hints. Ignored on non-Next runtimes. Passed
-     * through transparently as part of {@link RequestInit}.
-     */
-    next?: {
-        revalidate?: number | false;
-        tags?: string[];
-    };
-}
-/** Error thrown by {@link apiFetch} on non-2xx responses. */
-declare class ApiError extends Error {
-    readonly status: number;
-    readonly body: unknown;
-    constructor(message: string, status: number, body?: unknown);
-}
-/**
- * Generic fetcher used by all SDK query and mutation functions.
- *
- * Returns parsed JSON typed as `T`. Throws {@link ApiError} on non-2xx
- * responses. Use {@link apiFetchOrNull} when 404 should resolve to `null`
- * instead.
- */
-declare function apiFetch<T = unknown>(config: SifaApiConfig, path: string, options?: ApiFetchOptions): Promise<T>;
-/**
- * Variant of {@link apiFetch} that resolves to `null` on HTTP 404 instead
- * of throwing. Useful for "fetch by handle" reads where missing is
- * expected (e.g. unknown profile).
- */
-declare function apiFetchOrNull<T>(config: SifaApiConfig, path: string, options?: ApiFetchOptions): Promise<T | null>;
+import { f as Profile, o as ProfilePosition, S as SkillRef, c as ExternalAccount, t as SkillSuggestion } from '../index-CpM21_Oy.js';
 
 interface SifaProviderProps {
     config: SifaApiConfig;
@@ -92,592 +31,188 @@ declare function SifaProvider({ config, children }: SifaProviderProps): react_js
 declare function useSifaConfig(): SifaApiConfig;
 
 /**
- * Read the aggregated profile for a handle or DID.
- *
- * Returns `null` when the AppView has no profile for the given identifier
- * (HTTP 404). Throws {@link ApiError} on other non-2xx responses.
+ * React hook that reads an aggregated profile by handle or DID via
+ * TanStack Query. Returns `null` data when the profile does not exist.
  *
- * Server-callable (Next.js RSC) and client-callable (Expo, browser).
+ * Pass `{ enabled: false }` (or an empty `handleOrDid`) to defer the
+ * fetch.
  */
-declare function fetchProfile(config: SifaApiConfig, handleOrDid: string, options?: ApiFetchOptions): Promise<Profile | null>;
+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>;
 /**
- * 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.
+ * React hook for a profile's AT Fund link. Returns `null` data on error
+ * or when the profile has no link configured.
  */
-declare function fetchAtFundLink(config: SifaApiConfig, did: string, options?: ApiFetchOptions): Promise<string | null>;
+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>;
 
-/** Result returned by record-write mutations (create / update / delete). */
-interface WriteResult {
-    success: boolean;
-    error?: string;
-    pdsHost?: string;
-}
-/** Result returned by create mutations. Includes the newly created `rkey`. */
-interface CreateResult extends WriteResult {
-    rkey?: string;
-}
 /**
- * Create a new `id.sifa.profile.position` record on the authenticated
- * user's PDS. The AppView signs and writes via the user's OAuth session.
+ * React hook for updating the authenticated user's profile self record.
+ * On success, invalidates the owner's profile cache.
  *
- * `data` should be a lexicon-shaped position record (without `createdAt`
- * or `rkey`; the AppView fills both). Validate with
- * `ProfilePositionRecordSchema.omit({ createdAt: true })` before calling
- * if you want client-side guarantees.
+ * The owner identifier (handle or DID) is required so the mutation can
+ * target the right profile cache entry for invalidation.
  */
-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;
-}
+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>;
 /**
- * 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.
+ * React hook for uploading a new avatar. Pass a `File` (browser) or
+ * `Blob` (Expo) as the mutation variable.
  */
-declare function fetchStats(config: SifaApiConfig, options?: ApiFetchOptions): Promise<StatsResponse | null>;
+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>;
 
-/** 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).
+ * 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 fetchHiddenApps(config: SifaApiConfig, options?: FetchHiddenAppsOptions): Promise<HiddenApp[]>;
+declare function useCreatePosition(ownerDid: string, options?: Omit<UseMutationOptions<CreateResult, Error, Record<string, unknown>>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<CreateResult, Error, Record<string, unknown>, unknown>;
 
-/** 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>;
+/** 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>;
 
-/** 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;
+/** 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>;
 }
-/** 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>;
+/** 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>;
 
-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;
+/** 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>;
 }
-/** People the authenticated user follows. Empty on error. */
-declare function fetchFollowing(config: SifaApiConfig, opts?: {
-    source?: string;
-    cursor?: string;
-    limit?: number;
-} & ApiFetchOptions): Promise<FollowingResponse>;
+/** 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>;
 
-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;
+/** Variables for {@link useCreateRecord}. */
+interface CreateRecordVariables {
+    collection: string;
+    data: Record<string, unknown>;
 }
 /**
- * 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.
+ * 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 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;
+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;
-    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[];
+    data: Record<string, unknown>;
 }
-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;
+/** 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;
 }
-/**
- * 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>;
+/** 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>;
 
-/**
- * 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;
+/** 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;
 }
-/**
- * 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>;
+/** 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>;
 
-/** 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>;
+/** 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<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>;
 
-/** 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.
+ * 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 fetchMyRoadmapVotes(config: SifaApiConfig, options?: FetchMyRoadmapVotesOptions): Promise<string[]>;
+declare function useCreateEndorsement(endorsedHandleOrDid: string | null, options?: Omit<UseMutationOptions<CreateResult, Error, EndorsementInput>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<CreateResult, Error, EndorsementInput, unknown>;
 
-/**
- * Query key factory for TanStack Query.
- *
- * Keys are read-only tuples; the hierarchy matches the SDK's fetcher
- * grouping. Use these instead of inline arrays so consumers can target
- * `queryClient.invalidateQueries({ queryKey: keys.profile.all() })` and
- * similar patterns without typos.
- *
- * Convention: every leaf key starts with the namespace ('sifa') so
- * consumers can invalidate everything Sifa-related in one call.
- */
-declare const sifaQueryKeys: {
-    readonly all: () => readonly ["sifa"];
-    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.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 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 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<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 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>;
 
 /**
  * React hook for the public homepage stats. Returns `null` data on error.
@@ -694,6 +229,13 @@ declare function useHiddenApps(options?: Omit<UseQueryOptions<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>;
+/**
+ * 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<SkillSuggestion[], 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?: {
@@ -730,9 +272,68 @@ declare function useReactionStatus(uris: string[], options?: Omit<UseQueryOption
 /** 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>;
 
+/** 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<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 };
+/** 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 { AccountCheckResult, ActivityFeedResponse, ActivityTeaserResponse, AppRegistryEntry, CreateExternalAccountResult, type CreateReactionVariables, type CreateRecordVariables, CreateResult, DeleteAccountResult, type DeleteReactionVariables, type DeleteRecordVariables, EndorsementInput, ExternalAccountInput, FeaturedProfile, FetchActivityFeedOptions, FetchSuggestionsOptions, FilterOptions, FollowingResponse, HeatmapResponse, HiddenApp, type PositionSkillLinkVariables, ProfileLocationInput, ReactionError, ReactionResult, ReactionStatus, RefreshOrcidPublicationsResult, RefreshPdsResult, RoadmapVotesResponse, SearchFilters, SearchResponse, SifaApiConfig, SifaProvider, type SifaProviderProps, SimilarProfile, SkillSearchResult, StatsResponse, SuggestionsResponse, type UpdateEducationVariables, type UpdateExternalAccountVariables, type UpdatePositionVariables, type UpdateProfileLocationVariables, UpdateProfileOverrideInput, UpdateProfileSelfInput, type UpdateRecordVariables, type UpdateSkillVariables, UploadAvatarResult, VerifyExternalAccountResult, WriteResult, sifaQueryKeys, useActivityFeed, useActivityTeaser, useAppAccountCheck, useAppsRegistry, useAtFundLink, useBulkHideStandardPublications, useBulkUnhideStandardPublications, useCanonicalSkillSearch, useCastRoadmapVote, useCreateEducation, useCreateEndorsement, useCreateExternalAccount, useCreatePosition, useCreateProfileLocation, useCreateReaction, useCreateRecord, useCreateSkill, useDeleteAccount, useDeleteAvatarOverride, useDeleteEducation, useDeleteExternalAccount, useDeletePosition, useDeleteProfileLocation, useDeleteReaction, useDeleteRecord, useDeleteSkill, useEndorsementCount, useExternalAccounts, useFeaturedProfile, useFollowing, useHeatmapData, useHiddenApps, useHideKeytraceClaim, useHideOrcidPublication, useHideSifaPublication, useHideStandardPublication, useLinkSkillToPosition, useMyRoadmapVotes, useNetworkStreamCount, useProfile, useReactionStatus, useRefreshOrcidPublications, useRefreshPds, useResetProfile, useRetractRoadmapVote, useRoadmapVotes, useSearchFilters, useSearchProfiles, useSetExternalAccountPrimary, useSetPositionPrimary, useSifaConfig, useSimilarProfiles, useSkillSuggestions, useStats, useSuggestionCount, useSuggestions, useUnhideKeytraceClaim, useUnhideOrcidPublication, useUnhideSifaPublication, useUnhideStandardPublication, useUnlinkSkillFromPosition, useUnsetExternalAccountPrimary, useUnsetPositionPrimary, useUpdateEducation, useUpdateExternalAccount, useUpdatePosition, useUpdateProfileLocation, useUpdateProfileOverride, useUpdateProfileSelf, useUpdateRecord, useUpdateSkill, useUploadAvatar, useVerifyExternalAccount };