@singi-labs/sifa-sdk 0.7.1 → 0.7.3

package/dist/query/index.d.cts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { f as Profile } from '../index-CpM21_Oy.cjs';
+import { f as Profile, o as ProfilePosition, S as SkillRef, c as ExternalAccount, t as SkillSuggestion } from '../index-CpM21_Oy.cjs';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
 
@@ -66,6 +66,54 @@ declare function apiFetch<T = unknown>(config: SifaApiConfig, path: string, opti
  * expected (e.g. unknown profile).
  */
 declare function apiFetchOrNull<T>(config: SifaApiConfig, path: string, options?: ApiFetchOptions): Promise<T | null>;
+/**
+ * Result returned by record-write mutations (create / update / delete).
+ *
+ * Never throws -- writes against the user's PDS can fail in many ways
+ * (network, PDS unreachable, rate limit) and the UI needs structured
+ * results to render appropriate messages.
+ */
+interface WriteResult {
+    success: boolean;
+    error?: string;
+    /**
+     * PDS hostname returned by sifa-api when a write failed at the user's
+     * Personal Data Server (issue #167). Lets the UI render
+     * "Your data server (eurosky.social) isn't responding" instead of a
+     * generic "Request failed (500)".
+     */
+    pdsHost?: string;
+}
+/** Result returned by create mutations. Includes the newly created `rkey`. */
+interface CreateResult extends WriteResult {
+    rkey?: string;
+}
+/**
+ * Write mutation against the Sifa AppView. Wraps {@link apiFetch} with the
+ * never-throws contract used by all sifa-web mutations: returns a
+ * structured {@link WriteResult} on both success and failure, and
+ * preserves the `pdsHost` field when the AppView reports a PDS-side
+ * failure (issue #167).
+ *
+ * On success: returns `{ success: true, ...payload }` where `payload` is
+ * whatever the server returned in JSON (or `{}` for 204).
+ *
+ * On failure: returns `{ success: false, error, pdsHost? }`. Never throws.
+ *
+ * Use {@link apiWriteCreate} when you specifically need the `rkey` from a
+ * create response folded into the result shape.
+ */
+declare function apiWrite<TExtra extends object = Record<never, never>>(config: SifaApiConfig, path: string, method: 'POST' | 'PUT' | 'DELETE' | 'PATCH', options?: Omit<ApiFetchOptions, 'method'>): Promise<WriteResult & TExtra>;
+/**
+ * Write mutation that expects the server to return a record key (`rkey`)
+ * in its response body. Wraps {@link apiWrite} and folds the `rkey` into
+ * the result shape so consumers get `{ success, rkey?, error?, pdsHost? }`.
+ *
+ * If the server returns additional fields (e.g. `feedUrl` from external
+ * account creation), pass them via the `TExtra` generic to keep them
+ * typed.
+ */
+declare function apiWriteCreate<TExtra extends object = Record<never, never>>(config: SifaApiConfig, path: string, body: unknown, options?: Omit<ApiFetchOptions, 'method' | 'body'>): Promise<CreateResult & TExtra>;
 
 interface SifaProviderProps {
     config: SifaApiConfig;
@@ -107,16 +155,78 @@ declare function fetchProfile(config: SifaApiConfig, handleOrDid: string, option
  */
 declare function fetchAtFundLink(config: SifaApiConfig, did: string, options?: ApiFetchOptions): Promise<string | null>;
 
-/** Result returned by record-write mutations (create / update / delete). */
-interface WriteResult {
-    success: boolean;
-    error?: string;
-    pdsHost?: string;
+/** Industry/domain entry on the profile self record. */
+interface ProfileIndustryInput {
+    industry: string;
+    domain?: string;
 }
-/** Result returned by create mutations. Includes the newly created `rkey`. */
-interface CreateResult extends WriteResult {
-    rkey?: string;
+/**
+ * Location payload accepted by `updateProfileSelf`.
+ *
+ * Accepts both shapes during the community.lexicon.location.address
+ * migration. Prefer `locality` (new) over `city` (legacy) when sending.
+ * The API's locationSchema is a Zod union that resolves either input.
+ */
+interface ProfileSelfLocation {
+    country: string;
+    countryCode?: string;
+    region?: string;
+    city?: string;
+    locality?: string;
+}
+/** Body accepted by {@link updateProfileSelf}. */
+interface UpdateProfileSelfInput {
+    headline?: string;
+    about?: string;
+    industries?: ProfileIndustryInput[];
+    location?: ProfileSelfLocation;
+    website?: string;
+    openTo?: string[];
+    preferredWorkplace?: string[];
+    availableFromUtc?: number;
+    availableToUtc?: number;
+}
+/** Update the authenticated user's `id.sifa.profile.self` record. */
+declare function updateProfileSelf(config: SifaApiConfig, data: UpdateProfileSelfInput, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Body accepted by {@link updateProfileOverride}. */
+interface UpdateProfileOverrideInput {
+    headline?: string | null;
+    about?: string | null;
+    displayName?: string | null;
+    pronouns?: string | null;
 }
+/**
+ * Override aggregated profile fields with sifa-specific values. `null`
+ * clears the override and falls back to the upstream PDS value.
+ */
+declare function updateProfileOverride(config: SifaApiConfig, data: UpdateProfileOverrideInput, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Extended result for {@link refreshPds}. */
+interface RefreshPdsResult extends WriteResult {
+    displayName?: string | null;
+    avatar?: string | null;
+}
+/**
+ * Re-pull the authenticated user's `app.bsky.actor.profile` from their
+ * PDS. Returns the freshly resolved `displayName` and `avatar` on
+ * success so the UI can update without a full profile refetch.
+ */
+declare function refreshPds(config: SifaApiConfig, options?: ApiFetchOptions): Promise<RefreshPdsResult>;
+/** Extended result for {@link uploadAvatar}. */
+interface UploadAvatarResult extends WriteResult {
+    /** Publicly accessible URL of the newly uploaded avatar. */
+    url?: string;
+}
+/**
+ * Upload a new avatar via `multipart/form-data`. Pass either a `File`
+ * (browser) or any `Blob` (Expo, node). The SDK leaves `Content-Type`
+ * unset so the runtime can set the multipart boundary automatically.
+ *
+ * Never throws -- inspect `result.success` and `result.url`.
+ */
+declare function uploadAvatar(config: SifaApiConfig, file: Blob, options?: ApiFetchOptions): Promise<UploadAvatarResult>;
+/** Delete the authenticated user's avatar override (revert to PDS avatar). */
+declare function deleteAvatarOverride(config: SifaApiConfig, options?: ApiFetchOptions): Promise<WriteResult>;
+
 /**
  * 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.
@@ -125,8 +235,194 @@ interface CreateResult extends WriteResult {
  * or `rkey`; the AppView fills both). Validate with
  * `ProfilePositionRecordSchema.omit({ createdAt: true })` before calling
  * if you want client-side guarantees.
+ *
+ * Never throws -- inspect `result.success` and use `result.error` /
+ * `result.pdsHost` for UI messaging.
  */
 declare function createPosition(config: SifaApiConfig, data: Record<string, unknown>, options?: ApiFetchOptions): Promise<CreateResult>;
+/** Update an existing position by `rkey`. */
+declare function updatePosition(config: SifaApiConfig, rkey: string, data: Record<string, unknown>, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Delete a position by `rkey`. */
+declare function deletePosition(config: SifaApiConfig, rkey: string, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Mark a position as the user's primary (current) role. */
+declare function setPositionPrimary(config: SifaApiConfig, rkey: string, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Clear the "primary" flag on a position. */
+declare function unsetPositionPrimary(config: SifaApiConfig, rkey: string, options?: ApiFetchOptions): Promise<WriteResult>;
+/**
+ * Add a skill link to a position. Idempotent: if the skill is already
+ * linked, resolves to `{ success: true }` without a network call.
+ *
+ * Implementation note: the AppView only exposes whole-record PUTs, so
+ * this helper rebuilds the position body with the new skills list.
+ */
+declare function linkSkillToPosition(config: SifaApiConfig, position: ProfilePosition, skillRef: SkillRef, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Remove a skill link from a position. */
+declare function unlinkSkillFromPosition(config: SifaApiConfig, position: ProfilePosition, skillRef: SkillRef, options?: ApiFetchOptions): Promise<WriteResult>;
+
+/**
+ * Create a new `id.sifa.profile.education` record on the authenticated
+ * user's PDS.
+ */
+declare function createEducation(config: SifaApiConfig, data: Record<string, unknown>, options?: ApiFetchOptions): Promise<CreateResult>;
+/** Update an existing education record by `rkey`. */
+declare function updateEducation(config: SifaApiConfig, rkey: string, data: Record<string, unknown>, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Delete an education record by `rkey`. */
+declare function deleteEducation(config: SifaApiConfig, rkey: string, options?: ApiFetchOptions): Promise<WriteResult>;
+
+/**
+ * Create a new `id.sifa.profile.skill` record on the authenticated
+ * user's PDS.
+ */
+declare function createSkill(config: SifaApiConfig, data: Record<string, unknown>, options?: ApiFetchOptions): Promise<CreateResult>;
+/** Update an existing skill record by `rkey`. */
+declare function updateSkill(config: SifaApiConfig, rkey: string, data: Record<string, unknown>, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Delete a skill record by `rkey`. */
+declare function deleteSkill(config: SifaApiConfig, rkey: string, options?: ApiFetchOptions): Promise<WriteResult>;
+
+/**
+ * Generic record-create escape hatch. Most callers should prefer the
+ * dedicated section helpers (`createPosition`, `createEducation`, etc.)
+ * which take typed payloads and ship matching hooks. Use this when the
+ * lexicon doesn't yet have a dedicated endpoint (certifications,
+ * projects, publications, volunteering, honors, languages, courses).
+ *
+ * `collection` is a `id.sifa.profile.*` collection NSID. Routes to
+ * `POST /api/profile/records/<collection>`.
+ */
+declare function createRecord(config: SifaApiConfig, collection: string, data: Record<string, unknown>, options?: ApiFetchOptions): Promise<CreateResult>;
+/** Generic record-update escape hatch. See {@link createRecord}. */
+declare function updateRecord(config: SifaApiConfig, collection: string, rkey: string, data: Record<string, unknown>, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Generic record-delete escape hatch. See {@link createRecord}. */
+declare function deleteRecord(config: SifaApiConfig, collection: string, rkey: string, options?: ApiFetchOptions): Promise<WriteResult>;
+
+/**
+ * Address payload accepted by `/api/profile/location` endpoints.
+ *
+ * Accepts both shapes during the community.lexicon.location.address
+ * migration. Prefer `country` + `locality` (new) over `countryCode` +
+ * `city` (legacy). The API's `locationSchema` is a Zod union that
+ * accepts either pair.
+ */
+interface ProfileLocationAddress {
+    /** Legacy alias for `country` (alpha-2). */
+    countryCode?: string;
+    /** community.lexicon.location.address field -- prefer over `countryCode`. */
+    country?: string;
+    region?: string;
+    /** Legacy alias for `locality`. */
+    city?: string;
+    /** community.lexicon.location.address field -- prefer over `city`. */
+    locality?: string;
+}
+/** Body accepted by {@link createProfileLocation} / {@link updateProfileLocation}. */
+interface ProfileLocationInput {
+    address: ProfileLocationAddress;
+    type: string;
+    label?: string;
+    isPrimary?: boolean;
+}
+/** Create a new profile location entry. */
+declare function createProfileLocation(config: SifaApiConfig, data: ProfileLocationInput, options?: ApiFetchOptions): Promise<CreateResult>;
+/** Update an existing profile location by `rkey`. */
+declare function updateProfileLocation(config: SifaApiConfig, rkey: string, data: ProfileLocationInput, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Delete a profile location by `rkey`. */
+declare function deleteProfileLocation(config: SifaApiConfig, rkey: string, options?: ApiFetchOptions): Promise<WriteResult>;
+
+/** Body accepted by {@link createExternalAccount} / {@link updateExternalAccount}. */
+interface ExternalAccountInput {
+    platform: string;
+    url: string;
+    label?: string;
+    feedUrl?: string;
+}
+/** Extended create result for {@link createExternalAccount}. */
+interface CreateExternalAccountResult extends WriteResult {
+    rkey?: string;
+    feedUrl?: string | null;
+}
+/** Extended write result for {@link verifyExternalAccount}. */
+interface VerifyExternalAccountResult extends WriteResult {
+    verified?: boolean;
+    verifiedVia?: string;
+}
+/** List external accounts attached to a profile. Returns `[]` on error. */
+declare function fetchExternalAccounts(config: SifaApiConfig, handleOrDid: string, options?: ApiFetchOptions): Promise<ExternalAccount[]>;
+/**
+ * Create a new external account record. Returns the newly-created `rkey`
+ * and the server-resolved `feedUrl` (sifa-api inspects the target for
+ * RSS feeds on platforms that publish them).
+ */
+declare function createExternalAccount(config: SifaApiConfig, data: ExternalAccountInput, options?: ApiFetchOptions): Promise<CreateExternalAccountResult>;
+/** Update an existing external account by `rkey`. */
+declare function updateExternalAccount(config: SifaApiConfig, rkey: string, data: ExternalAccountInput, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Delete an external account by `rkey`. */
+declare function deleteExternalAccount(config: SifaApiConfig, rkey: string, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Mark an external account as the user's primary. */
+declare function setExternalAccountPrimary(config: SifaApiConfig, rkey: string, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Clear the "primary" flag on an external account. */
+declare function unsetExternalAccountPrimary(config: SifaApiConfig, rkey: string, options?: ApiFetchOptions): Promise<WriteResult>;
+/**
+ * Run server-side verification on an external account (e.g. inspect
+ * the target for a keytrace claim). Returns `{ verified, verifiedVia }`
+ * on success.
+ */
+declare function verifyExternalAccount(config: SifaApiConfig, rkey: string, options?: ApiFetchOptions): Promise<VerifyExternalAccountResult>;
+
+/** Body accepted by {@link createEndorsement}. */
+interface EndorsementInput {
+    skillUri: string;
+    comment?: string;
+}
+/**
+ * Create an endorsement of another user's skill. The endorsed user
+ * must confirm before the endorsement appears on their profile (the
+ * endorsement record is on the endorser's PDS; a separate confirmation
+ * record on the endorsed user's PDS gates display).
+ */
+declare function createEndorsement(config: SifaApiConfig, data: EndorsementInput, options?: ApiFetchOptions): Promise<CreateResult>;
+
+/**
+ * Hide a keytrace claim (verified-account claim discovered on the
+ * user's external accounts) from the user's profile. The claim itself
+ * stays in the index; only its display is suppressed.
+ */
+declare function hideKeytraceClaim(config: SifaApiConfig, rkey: string, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Restore a previously-hidden keytrace claim. */
+declare function unhideKeytraceClaim(config: SifaApiConfig, rkey: string, options?: ApiFetchOptions): Promise<WriteResult>;
+
+/** Extended result for {@link refreshOrcidPublications}. */
+interface RefreshOrcidPublicationsResult extends WriteResult {
+    added?: number;
+    removed?: number;
+}
+/**
+ * Hide an ORCID-imported publication from the user's profile. The
+ * `putCode` is the ORCID-side identifier; the underlying record stays
+ * in the index, only its display is suppressed.
+ */
+declare function hideOrcidPublication(config: SifaApiConfig, putCode: number, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Restore a previously-hidden ORCID publication. */
+declare function unhideOrcidPublication(config: SifaApiConfig, putCode: number, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Hide a standard (auto-imported) publication by its AT URI. */
+declare function hideStandardPublication(config: SifaApiConfig, uri: string, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Restore a previously-hidden standard publication. */
+declare function unhideStandardPublication(config: SifaApiConfig, uri: string, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Bulk-hide standard publications by AT URI list. */
+declare function bulkHideStandardPublications(config: SifaApiConfig, uris: string[], options?: ApiFetchOptions): Promise<WriteResult>;
+/** Bulk-unhide standard publications by AT URI list. */
+declare function bulkUnhideStandardPublications(config: SifaApiConfig, uris: string[], options?: ApiFetchOptions): Promise<WriteResult>;
+/** Hide an `id.sifa.profile.publication` (user-authored publication record). */
+declare function hideSifaPublication(config: SifaApiConfig, rkey: string, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Restore a previously-hidden Sifa publication. */
+declare function unhideSifaPublication(config: SifaApiConfig, rkey: string, options?: ApiFetchOptions): Promise<WriteResult>;
+/**
+ * Re-pull the authenticated user's ORCID publications. Returns counts
+ * of added and removed records. The server returns `{ error: '...' }`
+ * inline (not via HTTP status) on quota / linkage failures; the SDK
+ * folds that into `{ success: false, error }` to keep the contract
+ * consistent with other mutations.
+ */
+declare function refreshOrcidPublications(config: SifaApiConfig, options?: ApiFetchOptions): Promise<RefreshOrcidPublicationsResult>;
 
 /** Public, aggregate stats shown on the homepage and similar surfaces. */
 interface StatsResponse {
@@ -251,6 +547,15 @@ declare function fetchSearchProfiles(config: SifaApiConfig, filters: SearchFilte
 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>;
+/**
+ * Canonical-skill search backing the position-editor and similar
+ * skill-pickers. Hits `/api/skills/search` (the canonical-skills DB
+ * lookup) which is distinct from {@link fetchSkillSuggestions}'s
+ * `/api/search/skills` (the profile-skill typeahead).
+ *
+ * Returns `[]` on empty input (no network call) or any error.
+ */
+declare function searchSkills(config: SifaApiConfig, query: string, limit?: number, options?: ApiFetchOptions): Promise<SkillSuggestion[]>;
 
 /** Lightweight profile representation used by discovery endpoints. */
 interface SimilarProfile {
@@ -357,6 +662,55 @@ declare function fetchFollowing(config: SifaApiConfig, opts?: {
     limit?: number;
 } & ApiFetchOptions): Promise<FollowingResponse>;
 
+interface QuotedPostAuthor {
+    did: string;
+    handle: string;
+    displayName?: string;
+    avatar?: string;
+}
+interface QuotedPostImage {
+    thumb: string;
+    fullsize: string;
+    alt?: string;
+}
+interface QuotedPostView {
+    uri: string;
+    cid: string;
+    author: QuotedPostAuthor;
+    text: string;
+    createdAt: string;
+    images?: QuotedPostImage[];
+}
+type QuotedPostResult = {
+    status: 'ok';
+    record: QuotedPostView;
+} | {
+    status: 'deleted';
+    uri: string;
+} | {
+    status: 'unavailable';
+    uri: string;
+};
+/** Max URIs per request to `POST /api/quoted-posts/resolve` (mirrors server cap). */
+declare const QUOTED_POSTS_BATCH_MAX = 20;
+interface ResolveQuotedPostsOptions extends ApiFetchOptions {
+    /** Cookie header for Next.js RSC server-side calls; ignored in browsers. */
+    cookieHeader?: string;
+}
+/**
+ * Resolve a batch of AT-URIs to their quoted-post snapshots via the Sifa AppView.
+ *
+ * Auto-deduplicates input URIs and splits requests into chunks of
+ * {@link QUOTED_POSTS_BATCH_MAX} so callers can pass an arbitrary-length array.
+ * Each chunk is fired in parallel. The server caches results in Valkey, so
+ * repeated calls for the same URI are cheap.
+ *
+ * Returns a map of `uri -> QuotedPostResult`. URIs that fail (network error,
+ * non-2xx, or the server omitting them) are absent from the map; the caller
+ * should render a skeleton or tombstone for those.
+ */
+declare function resolveQuotedPosts(config: SifaApiConfig, uris: string[], options?: ResolveQuotedPostsOptions): Promise<Record<string, QuotedPostResult>>;
+
 interface HeatmapDay {
     date: string;
     total: number;
@@ -384,6 +738,17 @@ interface ActivityItem {
     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[];
@@ -491,6 +856,40 @@ interface CheckAppAccountOptions extends ApiFetchOptions {
  * Returns `null` on any error.
  */
 declare function checkAppAccount(config: SifaApiConfig, appId: string, options?: CheckAppAccountOptions): Promise<AccountCheckResult | null>;
+/** Result of a successful {@link createReaction}. */
+interface ReactionResult {
+    uri: string;
+    rkey: string;
+}
+/** Structured error returned by {@link createReaction} on failure. */
+interface ReactionError {
+    type: 'scope_insufficient' | 'error';
+    /** When `type === 'scope_insufficient'`, the lexicon scope the user must re-authorize for. */
+    requiredScope?: string;
+}
+/**
+ * Create a reaction (like / star) on a target ATproto record.
+ *
+ * Returns a discriminated-union result instead of the generic
+ * {@link WriteResult} shape because reactions have a distinct
+ * "scope insufficient" failure that callers handle differently from
+ * other errors (it triggers an OAuth scope-upgrade flow rather than
+ * an error toast).
+ *
+ * Never throws.
+ */
+declare function createReaction(config: SifaApiConfig, targetUri: string, appId: string, targetCid?: string, options?: ApiFetchOptions): Promise<{
+    ok: true;
+    data: ReactionResult;
+} | {
+    ok: false;
+    error: ReactionError;
+}>;
+/**
+ * Delete a reaction (like / star) on a target ATproto record. Returns
+ * `{ success: true }` on 2xx, `{ success: false, error }` on failure.
+ */
+declare function deleteReaction(config: SifaApiConfig, targetUri: string, appId: string, options?: ApiFetchOptions): Promise<WriteResult>;
 
 /** Voter on a roadmap item. */
 interface RoadmapVoter {
@@ -519,6 +918,39 @@ interface FetchMyRoadmapVotesOptions extends ApiFetchOptions {
  * error or when the response payload is shaped unexpectedly.
  */
 declare function fetchMyRoadmapVotes(config: SifaApiConfig, options?: FetchMyRoadmapVotesOptions): Promise<string[]>;
+/** Cast a vote on a roadmap item by its key. */
+declare function castRoadmapVote(config: SifaApiConfig, key: string, options?: ApiFetchOptions): Promise<WriteResult>;
+/** Retract a previously-cast roadmap vote. */
+declare function retractRoadmapVote(config: SifaApiConfig, key: string, options?: ApiFetchOptions): Promise<WriteResult>;
+
+/** Extended write result for {@link deleteAccount}. */
+interface DeleteAccountResult extends WriteResult {
+    /** The deleted handle, returned by the server for confirmation UIs. */
+    handle?: string;
+}
+/**
+ * Reset the authenticated user's Sifa profile.
+ *
+ * `deletePdsData: true` also deletes the corresponding records on the
+ * user's PDS. `deletePdsData: false` only removes the AppView's
+ * indexed state -- the records on the PDS are left intact and could be
+ * re-indexed later.
+ *
+ * Destructive. Server enforces session check + attestation; the SDK
+ * does not gate on additional confirmation. Wrap call sites in your
+ * own modal if you want a UX confirmation step.
+ */
+declare function resetProfile(config: SifaApiConfig, deletePdsData: boolean, options?: ApiFetchOptions): Promise<WriteResult>;
+/**
+ * Delete the authenticated user's account. Returns the deleted handle
+ * on success (used by the post-delete confirmation screen).
+ *
+ * `deletePdsData: true` also deletes the corresponding records on the
+ * user's PDS; `false` leaves the PDS records intact.
+ *
+ * Destructive. Same caveat as {@link resetProfile}.
+ */
+declare function deleteAccount(config: SifaApiConfig, deletePdsData: boolean, options?: ApiFetchOptions): Promise<DeleteAccountResult>;
 
 /**
  * Query key factory for TanStack Query.
@@ -537,6 +969,7 @@ declare const sifaQueryKeys: {
         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 externalAccounts: (handleOrDid: string) => readonly ["sifa", "profile", "external-accounts", string];
     };
     readonly position: {
         readonly all: () => readonly ["sifa", "position"];
@@ -546,6 +979,7 @@ declare const sifaQueryKeys: {
         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 canonicalSkills: (query: string, limit: number) => readonly ["sifa", "search", "canonical-skills", string, number];
         readonly filters: () => readonly ["sifa", "search", "filters"];
     };
     readonly discovery: {
@@ -593,7 +1027,7 @@ declare const sifaQueryKeys: {
         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>;
+type SifaQueryKey = ReturnType<typeof sifaQueryKeys.all> | ReturnType<typeof sifaQueryKeys.profile.all> | ReturnType<typeof sifaQueryKeys.profile.byHandle> | ReturnType<typeof sifaQueryKeys.profile.atFundLink> | ReturnType<typeof sifaQueryKeys.profile.externalAccounts> | ReturnType<typeof sifaQueryKeys.position.all> | ReturnType<typeof sifaQueryKeys.position.byOwner> | ReturnType<typeof sifaQueryKeys.search.all> | ReturnType<typeof sifaQueryKeys.search.profiles> | ReturnType<typeof sifaQueryKeys.search.canonicalSkills> | ReturnType<typeof sifaQueryKeys.search.skills> | ReturnType<typeof sifaQueryKeys.search.filters> | ReturnType<typeof sifaQueryKeys.discovery.all> | ReturnType<typeof sifaQueryKeys.discovery.similar> | ReturnType<typeof sifaQueryKeys.discovery.suggestions> | ReturnType<typeof sifaQueryKeys.discovery.suggestionCount> | ReturnType<typeof sifaQueryKeys.discovery.featured> | ReturnType<typeof sifaQueryKeys.follow.all> | ReturnType<typeof sifaQueryKeys.follow.following> | ReturnType<typeof sifaQueryKeys.stats.all> | ReturnType<typeof sifaQueryKeys.stats.homepage> | ReturnType<typeof sifaQueryKeys.apps.all> | ReturnType<typeof sifaQueryKeys.apps.registry> | ReturnType<typeof sifaQueryKeys.apps.hidden> | ReturnType<typeof sifaQueryKeys.activity.all> | ReturnType<typeof sifaQueryKeys.activity.heatmap> | ReturnType<typeof sifaQueryKeys.activity.teaser> | ReturnType<typeof sifaQueryKeys.activity.feed> | ReturnType<typeof sifaQueryKeys.endorsement.all> | ReturnType<typeof sifaQueryKeys.endorsement.count> | ReturnType<typeof sifaQueryKeys.stream.all> | ReturnType<typeof sifaQueryKeys.stream.networkCount> | ReturnType<typeof sifaQueryKeys.reactions.all> | ReturnType<typeof sifaQueryKeys.reactions.status> | ReturnType<typeof sifaQueryKeys.reactions.accountCheck> | ReturnType<typeof sifaQueryKeys.roadmap.all> | ReturnType<typeof sifaQueryKeys.roadmap.votes> | ReturnType<typeof sifaQueryKeys.roadmap.myVotes>;
 
 /**
  * React hook that reads an aggregated profile by handle or DID via
@@ -609,6 +1043,26 @@ declare function useProfile(handleOrDid: string | undefined | null, options?: Om
  */
 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
@@ -619,6 +1073,146 @@ declare function useAtFundLink(did: string | undefined | null, options?: Omit<Us
  */
 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<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>;
+
 /**
  * React hook for the public homepage stats. Returns `null` data on error.
  */
@@ -634,6 +1228,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?: {
@@ -670,9 +1271,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, type ReactionStatus, type RoadmapVoter, type RoadmapVotesResponse, type SearchFilters, type SearchResponse, type SifaApiConfig, SifaProvider, type SifaProviderProps, type SifaQueryKey, type SimilarProfile, type SkillSearchResult, type StatsResponse, type SuggestionProfile, type SuggestionsResponse, type WriteResult, apiFetch, apiFetchOrNull, checkAppAccount, createPosition, fetchActivityFeed, fetchActivityTeaser, fetchAppsRegistry, fetchAtFundLink, fetchEndorsementCount, fetchFeaturedProfile, fetchFollowing, fetchHeatmapData, fetchHiddenApps, fetchMyRoadmapVotes, fetchNetworkStreamCount, fetchProfile, fetchReactionStatus, fetchRoadmapVotes, fetchSearchFilters, fetchSearchProfiles, fetchSimilarProfiles, fetchSkillSuggestions, fetchStats, fetchSuggestionCount, fetchSuggestions, sifaQueryKeys, useActivityFeed, useActivityTeaser, useAppAccountCheck, useAppsRegistry, useAtFundLink, useCreatePosition, useEndorsementCount, useFeaturedProfile, useFollowing, useHeatmapData, useHiddenApps, useMyRoadmapVotes, useNetworkStreamCount, useProfile, useReactionStatus, useRoadmapVotes, useSearchFilters, useSearchProfiles, useSifaConfig, useSimilarProfiles, useSkillSuggestions, useStats, useSuggestionCount, useSuggestions };
+/** 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 AccountCheckResult, type ActivityFeedResponse, type ActivityItem, type ActivityTeaserResponse, ApiError, type ApiFetchOptions, type AppRegistryEntry, type CheckAppAccountOptions, type CreateExternalAccountResult, type CreateReactionVariables, type CreateRecordVariables, type CreateResult, type DeleteAccountResult, type DeleteReactionVariables, type DeleteRecordVariables, type EndorsementInput, type ExternalAccountInput, 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 PositionSkillLinkVariables, type ProfileIndustryInput, type ProfileLocationAddress, type ProfileLocationInput, type ProfileSearchResult, type ProfileSelfLocation, QUOTED_POSTS_BATCH_MAX, type QuotedPostAuthor, type QuotedPostImage, type QuotedPostResult, type QuotedPostView, type ReactionError, type ReactionResult, type ReactionStatus, type RefreshOrcidPublicationsResult, type RefreshPdsResult, 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 UpdateEducationVariables, type UpdateExternalAccountVariables, type UpdatePositionVariables, type UpdateProfileLocationVariables, type UpdateProfileOverrideInput, type UpdateProfileSelfInput, type UpdateRecordVariables, type UpdateSkillVariables, type UploadAvatarResult, type VerifyExternalAccountResult, type WriteResult, 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, sifaQueryKeys, unhideKeytraceClaim, unhideOrcidPublication, unhideSifaPublication, unhideStandardPublication, unlinkSkillFromPosition, unsetExternalAccountPrimary, unsetPositionPrimary, updateEducation, updateExternalAccount, updatePosition, updateProfileLocation, updateProfileOverride, updateProfileSelf, updateRecord, updateSkill, uploadAvatar, 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, verifyExternalAccount };