@singi-labs/sifa-sdk 0.11.23 → 0.11.25

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/dist/{adult-content-DLMF0jAx.d.cts → adult-content-pvNBfDQL.d.cts} +32 -1
  2. package/dist/{adult-content-DLMF0jAx.d.ts → adult-content-pvNBfDQL.d.ts} +32 -1
  3. package/dist/{feed-DMWCGvKv.d.cts → feed-D2ZV8Eaj.d.cts} +74 -1
  4. package/dist/{feed-DMWCGvKv.d.ts → feed-D2ZV8Eaj.d.ts} +74 -1
  5. package/dist/index-BXi6sYhX.d.ts +611 -0
  6. package/dist/index-CCi2sg_u.d.ts +261 -0
  7. package/dist/index-CtH-frgT.d.cts +611 -0
  8. package/dist/index-OBJQIB9t.d.cts +261 -0
  9. package/dist/index.cjs +134 -1
  10. package/dist/index.cjs.map +1 -1
  11. package/dist/index.d.cts +64 -7
  12. package/dist/index.d.ts +64 -7
  13. package/dist/index.js +120 -2
  14. package/dist/index.js.map +1 -1
  15. package/dist/{keys-OgHsKn9B.d.ts → keys-CxTXTPnI.d.ts} +2 -2
  16. package/dist/{keys-6Ck_vMeF.d.cts → keys-c5LIN2pO.d.cts} +2 -2
  17. package/dist/query/fetchers/index.cjs +11 -0
  18. package/dist/query/fetchers/index.cjs.map +1 -1
  19. package/dist/query/fetchers/index.d.cts +4 -247
  20. package/dist/query/fetchers/index.d.ts +4 -247
  21. package/dist/query/fetchers/index.js +11 -0
  22. package/dist/query/fetchers/index.js.map +1 -1
  23. package/dist/query/hooks/index.cjs +11 -0
  24. package/dist/query/hooks/index.cjs.map +1 -1
  25. package/dist/query/hooks/index.d.cts +6 -558
  26. package/dist/query/hooks/index.d.ts +6 -558
  27. package/dist/query/hooks/index.js +11 -0
  28. package/dist/query/hooks/index.js.map +1 -1
  29. package/dist/query/index.cjs +47 -0
  30. package/dist/query/index.cjs.map +1 -1
  31. package/dist/query/index.d.cts +6 -6
  32. package/dist/query/index.d.ts +6 -6
  33. package/dist/query/index.js +44 -1
  34. package/dist/query/index.js.map +1 -1
  35. package/dist/schemas/index.cjs +14 -0
  36. package/dist/schemas/index.cjs.map +1 -1
  37. package/dist/schemas/index.d.cts +415 -3
  38. package/dist/schemas/index.d.ts +415 -3
  39. package/dist/schemas/index.js +12 -1
  40. package/dist/schemas/index.js.map +1 -1
  41. package/package.json +1 -1
  42. package/dist/shared-CHCY7Lst.d.cts +0 -416
  43. package/dist/shared-CHCY7Lst.d.ts +0 -416
@@ -0,0 +1,611 @@
1
+ import * as react from 'react';
2
+ import { ReactNode } from 'react';
3
+ import { S as SifaApiConfig, s as sifaQueryKeys, W as WriteResult, a5 as RefreshPdsResult, aj as UpdateProfileOverrideInput, ak as UpdateProfileSelfInput, al as UploadAvatarResult, j as CreateResult, U as ProfileLocationInput, k as ExternalAccountInput, i as CreateExternalAccountResult, am as VerifyExternalAccountResult, E as EndorsementInput, a4 as RefreshOrcidPublicationsResult, B as BulkHideProfileItemInput, P as HideProfileItemInput, ag as StatsResponse, g as AppRegistryEntry, M as HiddenApp, w as FilterOptions, ab as SearchFilters, ac as SearchResponse, af as SkillSearchResult, l as FeaturedProfile, ae as SimilarProfile, v as FetchSuggestionsOptions, ai as SuggestionsResponse, G as FollowUserResult, o as FetchFollowListOptions, x as FollowListPage, H as FollowingResponse, q as FetchFollowingFeedOptions, p as FetchFollowProfilePageOptions, z as FollowProfilePageResponse, F as FeatureAllowlistResponse, m as FetchActivityFeedOptions, b as ActivityFeedResponse, e as ActivityTeaserResponse, L as HeatmapResponse, a as AccountCheckResult, a3 as ReactionStatus, a2 as ReactionResult, a1 as ReactionError, aa as RoadmapVotesResponse, C as CastRoadmapVoteResult, D as DeleteAccountResult } from './keys-c5LIN2pO.cjs';
4
+ import * as _tanstack_react_query from '@tanstack/react-query';
5
+ import { UseQueryOptions, UseMutationOptions, UseInfiniteQueryOptions, InfiniteData } from '@tanstack/react-query';
6
+ import { d as Profile, v as ProfilePosition, D as SkillRef, E as ExternalAccount, S as SkillSuggestion } from './adult-content-pvNBfDQL.cjs';
7
+ import { m as EntitySearchResponse, E as EntitySearchResult, g as EntityMintDomainResponse, k as EntityResolveDomainResponse, r as EntitySelectResponse, p as EntitySelectRequest, F as FollowFeedPage, c as FeatureFlag } from './feed-D2ZV8Eaj.cjs';
8
+
9
+ interface SifaProviderProps {
10
+ config: SifaApiConfig;
11
+ children: ReactNode;
12
+ }
13
+ /**
14
+ * Provides the {@link SifaApiConfig} that hooks under it can read via
15
+ * {@link useSifaConfig}. Wrap the React tree once; hooks consume it.
16
+ *
17
+ * @example
18
+ * ```tsx
19
+ * <QueryClientProvider client={queryClient}>
20
+ * <SifaProvider config={{ baseUrl: process.env.NEXT_PUBLIC_API_URL! }}>
21
+ * <App />
22
+ * </SifaProvider>
23
+ * </QueryClientProvider>
24
+ * ```
25
+ */
26
+ declare function SifaProvider({ config, children }: SifaProviderProps): react.JSX.Element;
27
+ /**
28
+ * Read the SDK's {@link SifaApiConfig} from context. Throws if no
29
+ * {@link SifaProvider} is mounted above.
30
+ */
31
+ declare function useSifaConfig(): SifaApiConfig;
32
+
33
+ /**
34
+ * React hook that reads an aggregated profile by handle or DID via
35
+ * TanStack Query. Returns `null` data when the profile does not exist.
36
+ *
37
+ * Pass `{ enabled: false }` (or an empty `handleOrDid`) to defer the
38
+ * fetch.
39
+ */
40
+ declare function useProfile(handleOrDid: string | undefined | null, options?: Omit<UseQueryOptions<Profile | null, Error, Profile | null, ReturnType<typeof sifaQueryKeys.profile.byHandle>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<Profile | null>, Error>;
41
+ /**
42
+ * React hook for a profile's AT Fund link. Returns `null` data on error
43
+ * or when the profile has no link configured.
44
+ */
45
+ 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>;
46
+
47
+ /**
48
+ * React hook for updating the authenticated user's profile self record.
49
+ * On success, invalidates the owner's profile cache.
50
+ *
51
+ * The owner identifier (handle or DID) is required so the mutation can
52
+ * target the right profile cache entry for invalidation.
53
+ */
54
+ declare function useUpdateProfileSelf(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, UpdateProfileSelfInput>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, UpdateProfileSelfInput, unknown>;
55
+ /** React hook for updating the authenticated user's profile override fields. */
56
+ declare function useUpdateProfileOverride(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, UpdateProfileOverrideInput>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, UpdateProfileOverrideInput, unknown>;
57
+ /** React hook for re-pulling the authenticated user's PDS-side profile. */
58
+ declare function useRefreshPds(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<RefreshPdsResult, Error, void>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<RefreshPdsResult, Error, void, unknown>;
59
+ /**
60
+ * React hook for uploading a new avatar. Pass a `File` (browser) or
61
+ * `Blob` (Expo) as the mutation variable.
62
+ */
63
+ declare function useUploadAvatar(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<UploadAvatarResult, Error, Blob>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<UploadAvatarResult, Error, Blob, unknown>;
64
+ /** React hook for deleting the avatar override (revert to PDS avatar). */
65
+ declare function useDeleteAvatarOverride(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, void>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, void, unknown>;
66
+
67
+ /**
68
+ * React hook for creating a new position record. On success, invalidates
69
+ * the owner's profile cache so the new position is reflected on the next
70
+ * read.
71
+ *
72
+ * The owner DID is required so the mutation can target the correct
73
+ * profile cache entry for invalidation.
74
+ */
75
+ declare function useCreatePosition(ownerDid: string, options?: Omit<UseMutationOptions<CreateResult, Error, Record<string, unknown>>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<CreateResult, Error, Record<string, unknown>, unknown>;
76
+
77
+ /** Variables for {@link useUpdatePosition}. */
78
+ interface UpdatePositionVariables {
79
+ rkey: string;
80
+ data: Record<string, unknown>;
81
+ }
82
+ /** React hook for updating a position record. */
83
+ declare function useUpdatePosition(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, UpdatePositionVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, UpdatePositionVariables, unknown>;
84
+ /** React hook for deleting a position record. Variable: the `rkey` string. */
85
+ declare function useDeletePosition(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
86
+ /** React hook for marking a position as primary. Variable: the `rkey` string. */
87
+ declare function useSetPositionPrimary(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
88
+ /** React hook for clearing the primary flag on a position. */
89
+ declare function useUnsetPositionPrimary(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
90
+ /** Variables for {@link useLinkSkillToPosition} / {@link useUnlinkSkillFromPosition}. */
91
+ interface PositionSkillLinkVariables {
92
+ position: ProfilePosition;
93
+ skillRef: SkillRef;
94
+ }
95
+ /** React hook for linking a skill to a position. Idempotent. */
96
+ declare function useLinkSkillToPosition(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, PositionSkillLinkVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, PositionSkillLinkVariables, unknown>;
97
+ /** React hook for unlinking a skill from a position. */
98
+ declare function useUnlinkSkillFromPosition(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, PositionSkillLinkVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, PositionSkillLinkVariables, unknown>;
99
+
100
+ /** React hook for creating an education record. */
101
+ declare function useCreateEducation(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<CreateResult, Error, Record<string, unknown>>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<CreateResult, Error, Record<string, unknown>, unknown>;
102
+ /** Variables for {@link useUpdateEducation}. */
103
+ interface UpdateEducationVariables {
104
+ rkey: string;
105
+ data: Record<string, unknown>;
106
+ }
107
+ /** React hook for updating an education record. */
108
+ declare function useUpdateEducation(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, UpdateEducationVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, UpdateEducationVariables, unknown>;
109
+ /** React hook for deleting an education record. Variable: the `rkey` string. */
110
+ declare function useDeleteEducation(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
111
+
112
+ /** React hook for creating a skill record. */
113
+ declare function useCreateSkill(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<CreateResult, Error, Record<string, unknown>>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<CreateResult, Error, Record<string, unknown>, unknown>;
114
+ /** Variables for {@link useUpdateSkill}. */
115
+ interface UpdateSkillVariables {
116
+ rkey: string;
117
+ data: Record<string, unknown>;
118
+ }
119
+ /** React hook for updating a skill record. */
120
+ declare function useUpdateSkill(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, UpdateSkillVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, UpdateSkillVariables, unknown>;
121
+ /** React hook for deleting a skill record. Variable: the `rkey` string. */
122
+ declare function useDeleteSkill(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
123
+
124
+ /** Variables for {@link useCreateRecord}. */
125
+ interface CreateRecordVariables {
126
+ collection: string;
127
+ data: Record<string, unknown>;
128
+ }
129
+ /**
130
+ * Generic record-create escape hatch for collections without a
131
+ * dedicated section helper (certifications, projects, publications,
132
+ * volunteering, honors, languages, courses). Prefer the typed helpers
133
+ * when one exists for the section.
134
+ */
135
+ declare function useCreateRecord(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<CreateResult, Error, CreateRecordVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<CreateResult, Error, CreateRecordVariables, unknown>;
136
+ /** Variables for {@link useUpdateRecord}. */
137
+ interface UpdateRecordVariables {
138
+ collection: string;
139
+ rkey: string;
140
+ data: Record<string, unknown>;
141
+ }
142
+ /** Generic record-update escape hatch. See {@link useCreateRecord}. */
143
+ declare function useUpdateRecord(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, UpdateRecordVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, UpdateRecordVariables, unknown>;
144
+ /** Variables for {@link useDeleteRecord}. */
145
+ interface DeleteRecordVariables {
146
+ collection: string;
147
+ rkey: string;
148
+ }
149
+ /** Generic record-delete escape hatch. See {@link useCreateRecord}. */
150
+ declare function useDeleteRecord(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, DeleteRecordVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, DeleteRecordVariables, unknown>;
151
+
152
+ /** React hook for creating a profile location record. */
153
+ declare function useCreateProfileLocation(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<CreateResult, Error, ProfileLocationInput>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<CreateResult, Error, ProfileLocationInput, unknown>;
154
+ /** Variables for {@link useUpdateProfileLocation}. */
155
+ interface UpdateProfileLocationVariables {
156
+ rkey: string;
157
+ data: ProfileLocationInput;
158
+ }
159
+ /** React hook for updating a profile location record. */
160
+ declare function useUpdateProfileLocation(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, UpdateProfileLocationVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, UpdateProfileLocationVariables, unknown>;
161
+ /** React hook for deleting a profile location record. Variable: the `rkey` string. */
162
+ declare function useDeleteProfileLocation(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
163
+
164
+ /** React hook for reading the external-accounts list. Returns `[]` data on error. */
165
+ declare function useExternalAccounts(handleOrDid: string | undefined | null, options?: Omit<UseQueryOptions<ExternalAccount[], Error, ExternalAccount[], ReturnType<typeof sifaQueryKeys.profile.externalAccounts>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<ExternalAccount[]>, Error>;
166
+ /** React hook for creating an external account. */
167
+ declare function useCreateExternalAccount(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<CreateExternalAccountResult, Error, ExternalAccountInput>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<CreateExternalAccountResult, Error, ExternalAccountInput, unknown>;
168
+ /** Variables for {@link useUpdateExternalAccount}. */
169
+ interface UpdateExternalAccountVariables {
170
+ rkey: string;
171
+ data: ExternalAccountInput;
172
+ }
173
+ /** React hook for updating an external account. */
174
+ declare function useUpdateExternalAccount(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, UpdateExternalAccountVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, UpdateExternalAccountVariables, unknown>;
175
+ /** React hook for deleting an external account. Variable: the `rkey` string. */
176
+ declare function useDeleteExternalAccount(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
177
+ /** React hook for marking an external account primary. */
178
+ declare function useSetExternalAccountPrimary(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
179
+ /** React hook for clearing the primary flag on an external account. */
180
+ declare function useUnsetExternalAccountPrimary(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
181
+ /** React hook for running server-side verification of an external account. */
182
+ declare function useVerifyExternalAccount(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<VerifyExternalAccountResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<VerifyExternalAccountResult, Error, string, unknown>;
183
+
184
+ /**
185
+ * React hook for creating an endorsement of another user's skill. The
186
+ * mutation needs the endorsed user's handle/DID (not the endorser's)
187
+ * so the endorsed profile + their endorsement count caches get
188
+ * invalidated; pass `null` to skip endorsed-profile invalidation
189
+ * (e.g., if you only know the skill URI).
190
+ */
191
+ declare function useCreateEndorsement(endorsedHandleOrDid: string | null, options?: Omit<UseMutationOptions<CreateResult, Error, EndorsementInput>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<CreateResult, Error, EndorsementInput, unknown>;
192
+
193
+ /** React hook for hiding a keytrace claim. Variable: the claim `rkey` string. */
194
+ declare function useHideKeytraceClaim(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
195
+ /** React hook for unhiding a previously-hidden keytrace claim. */
196
+ declare function useUnhideKeytraceClaim(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
197
+
198
+ /** React hook for revealing (making public) a Marque domain. Variable: the domain string. */
199
+ declare function useRevealMarqueDomain(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
200
+ /** React hook for hiding a previously-revealed Marque domain again. */
201
+ declare function useUnrevealMarqueDomain(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
202
+
203
+ /** React hook for hiding an ORCID publication. Variable: the `putCode` number. */
204
+ declare const useHideOrcidPublication: (ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, number, unknown>, "mutationFn"> | undefined) => _tanstack_react_query.UseMutationResult<WriteResult, Error, number, unknown>;
205
+ /** React hook for unhiding an ORCID publication. Variable: the `putCode` number. */
206
+ declare const useUnhideOrcidPublication: (ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, number, unknown>, "mutationFn"> | undefined) => _tanstack_react_query.UseMutationResult<WriteResult, Error, number, unknown>;
207
+ /** React hook for hiding a standard publication. Variable: the AT URI string. */
208
+ declare const useHideStandardPublication: (ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string, unknown>, "mutationFn"> | undefined) => _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
209
+ /** React hook for unhiding a standard publication. Variable: the AT URI string. */
210
+ declare const useUnhideStandardPublication: (ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string, unknown>, "mutationFn"> | undefined) => _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
211
+ /** React hook for bulk-hiding standard publications. Variable: the URI list. */
212
+ declare const useBulkHideStandardPublications: (ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string[], unknown>, "mutationFn"> | undefined) => _tanstack_react_query.UseMutationResult<WriteResult, Error, string[], unknown>;
213
+ /** React hook for bulk-unhiding standard publications. Variable: the URI list. */
214
+ declare const useBulkUnhideStandardPublications: (ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string[], unknown>, "mutationFn"> | undefined) => _tanstack_react_query.UseMutationResult<WriteResult, Error, string[], unknown>;
215
+ /** React hook for hiding a Sifa-authored publication. Variable: the `rkey` string. */
216
+ declare const useHideSifaPublication: (ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string, unknown>, "mutationFn"> | undefined) => _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
217
+ /** React hook for unhiding a Sifa-authored publication. Variable: the `rkey` string. */
218
+ declare const useUnhideSifaPublication: (ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string, unknown>, "mutationFn"> | undefined) => _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
219
+ /** React hook for re-pulling ORCID publications. */
220
+ declare function useRefreshOrcidPublications(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<RefreshOrcidPublicationsResult, Error, void>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<RefreshOrcidPublicationsResult, Error, void, unknown>;
221
+
222
+ /**
223
+ * Hide one profile item across any supported section. The underlying
224
+ * record stays on the user's PDS; only its display on sifa.id is
225
+ * suppressed.
226
+ */
227
+ declare const useHideProfileItem: (ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, HideProfileItemInput, unknown>, "mutationFn"> | undefined) => _tanstack_react_query.UseMutationResult<WriteResult, Error, HideProfileItemInput, unknown>;
228
+ /** Restore a previously-hidden profile item. */
229
+ declare const useUnhideProfileItem: (ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, HideProfileItemInput, unknown>, "mutationFn"> | undefined) => _tanstack_react_query.UseMutationResult<WriteResult, Error, HideProfileItemInput, unknown>;
230
+ /** Bulk-hide profile items sharing the same `itemType` + `source`. */
231
+ declare const useBulkHideProfileItems: (ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, BulkHideProfileItemInput, unknown>, "mutationFn"> | undefined) => _tanstack_react_query.UseMutationResult<WriteResult, Error, BulkHideProfileItemInput, unknown>;
232
+ /** Bulk-unhide profile items sharing the same `itemType` + `source`. */
233
+ declare const useBulkUnhideProfileItems: (ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, BulkHideProfileItemInput, unknown>, "mutationFn"> | undefined) => _tanstack_react_query.UseMutationResult<WriteResult, Error, BulkHideProfileItemInput, unknown>;
234
+
235
+ /**
236
+ * React hook for the public homepage stats. Returns `null` data on error.
237
+ */
238
+ declare function useStats(options?: Omit<UseQueryOptions<StatsResponse | null, Error, StatsResponse | null, ReturnType<typeof sifaQueryKeys.stats.homepage>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<StatsResponse | null>, Error>;
239
+
240
+ /** React hook for the public app registry. */
241
+ declare function useAppsRegistry(options?: Omit<UseQueryOptions<AppRegistryEntry[], Error, AppRegistryEntry[], ReturnType<typeof sifaQueryKeys.apps.registry>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<AppRegistryEntry[]>, Error>;
242
+ /**
243
+ * React hook for the authenticated user's hidden-apps list. Requires a
244
+ * client-side session (relies on `credentials: 'include'`).
245
+ */
246
+ declare function useHiddenApps(options?: Omit<UseQueryOptions<HiddenApp[], Error, HiddenApp[], ReturnType<typeof sifaQueryKeys.apps.hidden>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<HiddenApp[]>, Error>;
247
+
248
+ declare function useSearchProfiles(filters: SearchFilters, options?: Omit<UseQueryOptions<SearchResponse, Error, SearchResponse, ReturnType<typeof sifaQueryKeys.search.profiles>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<SearchResponse>, Error>;
249
+ declare function useSkillSuggestions(query: string, options?: Omit<UseQueryOptions<SkillSearchResult[], Error, SkillSearchResult[], ReturnType<typeof sifaQueryKeys.search.skills>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<SkillSearchResult[]>, Error>;
250
+ /**
251
+ * Canonical-skill search hook. Hits `/api/skills/search` (the
252
+ * canonical-skills DB lookup, distinct from {@link useSkillSuggestions}'s
253
+ * `/api/search/skills` profile-skill typeahead). Skips the network call
254
+ * when the query is empty.
255
+ */
256
+ declare function useCanonicalSkillSearch(query: string, limit?: number, options?: Omit<UseQueryOptions<SkillSuggestion[], Error, SkillSuggestion[], ReturnType<typeof sifaQueryKeys.search.canonicalSkills>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<SkillSuggestion[]>, Error>;
257
+ declare function useSearchFilters(options?: Omit<UseQueryOptions<FilterOptions, Error, FilterOptions, ReturnType<typeof sifaQueryKeys.search.filters>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<FilterOptions>, Error>;
258
+
259
+ /** Debounce a rapidly-changing value (e.g. a typeahead input). */
260
+ declare function useDebouncedValue<T>(value: T, delayMs?: number): T;
261
+ interface UseEntitySearchOptions {
262
+ /** Max rows to request (default 5). */
263
+ limit?: number;
264
+ /** Debounce delay in ms (default 250). */
265
+ debounceMs?: number;
266
+ enabled?: boolean;
267
+ }
268
+ /**
269
+ * Debounced organization typeahead. The query is debounced internally, so
270
+ * consumers can pass the raw input value on every keystroke. Skips the network
271
+ * call while the (trimmed, debounced) query is empty.
272
+ */
273
+ declare function useEntitySearch(query: string, opts?: UseEntitySearchOptions, queryOptions?: Omit<UseQueryOptions<EntitySearchResponse, Error, EntitySearchResponse, ReturnType<typeof sifaQueryKeys.entity.search>>, 'queryKey' | 'queryFn' | 'enabled'>): _tanstack_react_query.UseQueryResult<NoInfer<{
274
+ results: ({
275
+ kind: string;
276
+ name: string;
277
+ domain: string | null;
278
+ country: string | null;
279
+ logoUrl: string | null;
280
+ parentName: string | null;
281
+ source: "entity";
282
+ entityId: number;
283
+ } | {
284
+ kind: string;
285
+ name: string;
286
+ domain: string | null;
287
+ country: string | null;
288
+ logoUrl: string | null;
289
+ parentName: string | null;
290
+ source: "pdl";
291
+ pdlId: string;
292
+ })[];
293
+ hasMore: boolean;
294
+ }>, Error>;
295
+ /** Mutation: record a selection (promote a PDL row or bump an entity). */
296
+ declare function useSelectEntity(options?: Omit<UseMutationOptions<EntitySelectResponse, Error, EntitySelectRequest>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<{
297
+ entityId: number;
298
+ slug: string;
299
+ kind: string;
300
+ canonicalName: string;
301
+ domain: string | null;
302
+ entityRef: string | null;
303
+ }, Error, {
304
+ entityId?: number | undefined;
305
+ pdlId?: string | undefined;
306
+ }, unknown>;
307
+ /** Mutation: grow-on-demand Wikidata import for a typeahead miss. */
308
+ declare function useImportSearchEntities(options?: Omit<UseMutationOptions<EntitySearchResult[], Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<({
309
+ kind: string;
310
+ name: string;
311
+ domain: string | null;
312
+ country: string | null;
313
+ logoUrl: string | null;
314
+ parentName: string | null;
315
+ source: "entity";
316
+ entityId: number;
317
+ } | {
318
+ kind: string;
319
+ name: string;
320
+ domain: string | null;
321
+ country: string | null;
322
+ logoUrl: string | null;
323
+ parentName: string | null;
324
+ source: "pdl";
325
+ pdlId: string;
326
+ })[], Error, string, unknown>;
327
+ /**
328
+ * Mutation: grow-on-demand by domain, Branch 1. Resolve a domain-shaped
329
+ * typeahead miss to any notable company (Wikidata reverse P856). The response's
330
+ * `canMint` flag drives the "Add <domain>" affordance.
331
+ */
332
+ declare function useResolveEntityDomain(options?: Omit<UseMutationOptions<EntityResolveDomainResponse, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<{
333
+ results: ({
334
+ kind: string;
335
+ name: string;
336
+ domain: string | null;
337
+ country: string | null;
338
+ logoUrl: string | null;
339
+ parentName: string | null;
340
+ source: "entity";
341
+ entityId: number;
342
+ } | {
343
+ kind: string;
344
+ name: string;
345
+ domain: string | null;
346
+ country: string | null;
347
+ logoUrl: string | null;
348
+ parentName: string | null;
349
+ source: "pdl";
350
+ pdlId: string;
351
+ })[];
352
+ canMint: boolean;
353
+ }, Error, string, unknown>;
354
+ /**
355
+ * Mutation: grow-on-demand by domain, Branch 2 (user-initiated). Mint a
356
+ * crawled-tier entity from the domain's homepage. Rejects when the domain is not
357
+ * mintable or the site yields nothing usable.
358
+ */
359
+ declare function useMintEntityDomain(options?: Omit<UseMutationOptions<EntityMintDomainResponse, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<{
360
+ result: {
361
+ kind: string;
362
+ name: string;
363
+ domain: string | null;
364
+ country: string | null;
365
+ logoUrl: string | null;
366
+ parentName: string | null;
367
+ source: "entity";
368
+ entityId: number;
369
+ } | {
370
+ kind: string;
371
+ name: string;
372
+ domain: string | null;
373
+ country: string | null;
374
+ logoUrl: string | null;
375
+ parentName: string | null;
376
+ source: "pdl";
377
+ pdlId: string;
378
+ };
379
+ pending: boolean;
380
+ }, Error, string, unknown>;
381
+
382
+ declare function useSimilarProfiles(did: string | undefined | null, opts?: {
383
+ limit?: number;
384
+ }, options?: Omit<UseQueryOptions<SimilarProfile[], Error, SimilarProfile[], ReturnType<typeof sifaQueryKeys.discovery.similar>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<SimilarProfile[]>, Error>;
385
+ declare function useSuggestions(opts?: Omit<FetchSuggestionsOptions, keyof Omit<FetchSuggestionsOptions, 'source' | 'includeDismissed' | 'cursor' | 'limit'>>, options?: Omit<UseQueryOptions<SuggestionsResponse, Error, SuggestionsResponse, ReturnType<typeof sifaQueryKeys.discovery.suggestions>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<SuggestionsResponse>, Error>;
386
+ declare function useSuggestionCount(since?: string, options?: Omit<UseQueryOptions<number, Error, number, ReturnType<typeof sifaQueryKeys.discovery.suggestionCount>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<number, Error>;
387
+ declare function useFeaturedProfile(options?: Omit<UseQueryOptions<FeaturedProfile | null, Error, FeaturedProfile | null, ReturnType<typeof sifaQueryKeys.discovery.featured>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<FeaturedProfile | null>, Error>;
388
+
389
+ /**
390
+ * Legacy "people I follow" query. Kept as-is for back-compat with sifa-web
391
+ * call sites that pre-date the V5 feed work. New code should use
392
+ * {@link useFollowingList} (paginated per-profile) or
393
+ * {@link useFollowingFeed} (V5 feed).
394
+ */
395
+ declare function useFollowing(opts?: {
396
+ source?: string;
397
+ cursor?: string;
398
+ limit?: number;
399
+ }, options?: Omit<UseQueryOptions<FollowingResponse, Error, FollowingResponse, ReturnType<typeof sifaQueryKeys.follow.following>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<FollowingResponse>, Error>;
400
+ /** Variables for {@link useFollow}. */
401
+ interface FollowVariables {
402
+ handle: string;
403
+ /** Server-resolved DID of the subject, when known. Used for optimistic cache writes. */
404
+ subjectDid?: string;
405
+ /** Optional Sifa-only "why I followed" note (max 200 graphemes). */
406
+ note?: string;
407
+ }
408
+ /** Variables for {@link useUnfollow}. */
409
+ interface UnfollowVariables {
410
+ handle: string;
411
+ }
412
+ /**
413
+ * Mutation hook for following a handle. Optimistically marks the
414
+ * follow-state cache as `true` and rolls back on failure (per
415
+ * sifa-api#673 TR8 / iter-1 plan TR8). Invalidates the followers /
416
+ * following lists and the V5 feed on success so they refetch.
417
+ *
418
+ * Optimistic cache entry: `sifaQueryKeys.follow.followers(handle)`
419
+ * receives the viewer prepended to the list shape; the optimistic update
420
+ * is intentionally conservative — it only flips per-handle state and
421
+ * doesn't try to invent rich `FollowProfile` fields.
422
+ */
423
+ declare function useFollow(options?: Omit<UseMutationOptions<FollowUserResult, Error, FollowVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<FollowUserResult, Error, FollowVariables, unknown>;
424
+ /**
425
+ * Mutation hook for unfollowing a handle. Optimistic + rollback mirror
426
+ * of {@link useFollow}.
427
+ */
428
+ declare function useUnfollow(options?: Omit<UseMutationOptions<WriteResult, Error, UnfollowVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, UnfollowVariables, unknown>;
429
+ /** Infinite-query hook for `handle`'s followers list. */
430
+ declare function useFollowers(handle: string, opts?: Omit<FetchFollowListOptions, 'cursor'>, options?: Omit<UseInfiniteQueryOptions<FollowListPage, Error, InfiniteData<FollowListPage>, ReturnType<typeof sifaQueryKeys.follow.followers>, string | undefined>, 'queryKey' | 'queryFn' | 'initialPageParam' | 'getNextPageParam'>): _tanstack_react_query.UseInfiniteQueryResult<InfiniteData<FollowListPage, unknown>, Error>;
431
+ /** Infinite-query hook for who `handle` follows. */
432
+ declare function useFollowingList(handle: string, opts?: Omit<FetchFollowListOptions, 'cursor'>, options?: Omit<UseInfiniteQueryOptions<FollowListPage, Error, InfiniteData<FollowListPage>, ReturnType<typeof sifaQueryKeys.follow.followingOf>, string | undefined>, 'queryKey' | 'queryFn' | 'initialPageParam' | 'getNextPageParam'>): _tanstack_react_query.UseInfiniteQueryResult<InfiniteData<FollowListPage, unknown>, Error>;
433
+ /**
434
+ * Infinite-query hook for the V5 home feed (authenticated viewer).
435
+ *
436
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
437
+ * Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
438
+ * Stream are two distinct surfaces with different data paths (Barazo API
439
+ * for Timeline, live PDS reads + Valkey for Stream). This hook is no
440
+ * longer consumed. Scheduled for removal in next major bump.
441
+ */
442
+ declare function useFollowingFeed(opts?: Omit<FetchFollowingFeedOptions, 'cursor'>, options?: Omit<UseInfiniteQueryOptions<FollowFeedPage, Error, InfiniteData<FollowFeedPage>, ReturnType<typeof sifaQueryKeys.follow.feed>, string | undefined>, 'queryKey' | 'queryFn' | 'initialPageParam' | 'getNextPageParam'>): _tanstack_react_query.UseInfiniteQueryResult<InfiniteData<{
443
+ items: ({
444
+ id: string;
445
+ actor: {
446
+ did: string;
447
+ handle: string;
448
+ displayName?: string | undefined;
449
+ avatarUrl?: string | undefined;
450
+ };
451
+ indexedAt: string;
452
+ eventType: string;
453
+ source: "sifa";
454
+ payload: Record<string, unknown>;
455
+ appId?: "sifa" | undefined;
456
+ } | {
457
+ id: string;
458
+ actor: {
459
+ did: string;
460
+ handle: string;
461
+ displayName?: string | undefined;
462
+ avatarUrl?: string | undefined;
463
+ };
464
+ indexedAt: string;
465
+ eventType: string;
466
+ source: "atmosphere";
467
+ appId: string;
468
+ payload: Record<string, unknown>;
469
+ uri?: string | undefined;
470
+ cid?: string | undefined;
471
+ })[];
472
+ cursor: string | null;
473
+ }, unknown>, Error>;
474
+
475
+ /**
476
+ * Infinite-query hook for the mutuals list of `handleOrDid`. Backed by
477
+ * {@link getMutuals} (`GET /api/profile/{handleOrDid}/mutuals`). Disabled
478
+ * when `handleOrDid` is empty so component-mount with a lazy handle doesn't
479
+ * fire a wasted request.
480
+ */
481
+ declare function useMutuals(handleOrDid: string, opts?: Omit<FetchFollowProfilePageOptions, 'cursor'>, options?: Omit<UseInfiniteQueryOptions<FollowProfilePageResponse, Error, InfiniteData<FollowProfilePageResponse>, ReturnType<typeof sifaQueryKeys.follow.mutuals>, string | undefined>, 'queryKey' | 'queryFn' | 'initialPageParam' | 'getNextPageParam'>): _tanstack_react_query.UseInfiniteQueryResult<InfiniteData<FollowProfilePageResponse, unknown>, Error>;
482
+ /**
483
+ * Infinite-query hook for the authenticated viewer's Bluesky-follow
484
+ * suggestions (people the viewer follows on Bluesky but not Sifa).
485
+ * Backed by {@link getBlueskySuggestions}.
486
+ */
487
+ declare function useBlueskySuggestions(opts?: Omit<FetchFollowProfilePageOptions, 'cursor'>, options?: Omit<UseInfiniteQueryOptions<FollowProfilePageResponse, Error, InfiniteData<FollowProfilePageResponse>, ReturnType<typeof sifaQueryKeys.follow.blueskySuggestions>, string | undefined>, 'queryKey' | 'queryFn' | 'initialPageParam' | 'getNextPageParam'>): _tanstack_react_query.UseInfiniteQueryResult<InfiniteData<FollowProfilePageResponse, unknown>, Error>;
488
+
489
+ /**
490
+ * Read hook for the admin allowlist of a given feature flag. Admin-gated on
491
+ * the server; non-admins get an empty list (the fetcher swallows 403).
492
+ */
493
+ declare function useFeatureAllowlist(flag: FeatureFlag, options?: Omit<UseQueryOptions<FeatureAllowlistResponse, Error, FeatureAllowlistResponse, ReturnType<typeof sifaQueryKeys.admin.featureAllowlist>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<FeatureAllowlistResponse>, Error>;
494
+ /** Snapshot of the previous cache entry; returned from `onMutate` for rollback. */
495
+ interface AllowlistMutationContext {
496
+ previous: FeatureAllowlistResponse | undefined;
497
+ }
498
+ /** Variables for {@link useAddFeatureAllowlist}. */
499
+ interface AddFeatureAllowlistVariables {
500
+ did: string;
501
+ note?: string;
502
+ }
503
+ /**
504
+ * Mutation hook to add (or upsert) a DID on the given flag's allowlist.
505
+ * Optimistically prepends a synthesized entry to the cache so admin UIs feel
506
+ * instant; rolls back if the server reports failure.
507
+ */
508
+ declare function useAddFeatureAllowlist(flag: FeatureFlag, options?: Omit<UseMutationOptions<WriteResult, Error, AddFeatureAllowlistVariables, AllowlistMutationContext>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, AddFeatureAllowlistVariables, AllowlistMutationContext>;
509
+ /** Variables for {@link useRemoveFeatureAllowlist}. */
510
+ interface RemoveFeatureAllowlistVariables {
511
+ did: string;
512
+ }
513
+ /**
514
+ * Mutation hook to remove a DID from the given flag's allowlist.
515
+ * Optimistically removes the row from the cache; rolls back if the server
516
+ * reports failure.
517
+ */
518
+ declare function useRemoveFeatureAllowlist(flag: FeatureFlag, options?: Omit<UseMutationOptions<WriteResult, Error, RemoveFeatureAllowlistVariables, AllowlistMutationContext>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, RemoveFeatureAllowlistVariables, AllowlistMutationContext>;
519
+
520
+ declare function useHeatmapData(handleOrDid: string | undefined | null, days: number, options?: Omit<UseQueryOptions<HeatmapResponse | null, Error, HeatmapResponse | null, ReturnType<typeof sifaQueryKeys.activity.heatmap>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<HeatmapResponse | null>, Error>;
521
+ declare function useActivityTeaser(handleOrDid: string | undefined | null, options?: Omit<UseQueryOptions<ActivityTeaserResponse | null, Error, ActivityTeaserResponse | null, ReturnType<typeof sifaQueryKeys.activity.teaser>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<ActivityTeaserResponse | null>, Error>;
522
+ declare function useActivityFeed(handleOrDid: string | undefined | null, opts?: Pick<FetchActivityFeedOptions, 'category' | 'limit' | 'cursor'>, options?: Omit<UseQueryOptions<ActivityFeedResponse | null, Error, ActivityFeedResponse | null, ReturnType<typeof sifaQueryKeys.activity.feed>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<ActivityFeedResponse | null>, Error>;
523
+
524
+ /** Count of confirmed endorsements for a DID. Returns 0 on error. */
525
+ declare function useEndorsementCount(did: string | undefined | null, options?: Omit<UseQueryOptions<number, Error, number, ReturnType<typeof sifaQueryKeys.endorsement.count>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<number, Error>;
526
+
527
+ /**
528
+ * Count of items in the authenticated user's network stream digest.
529
+ * Returns 0 on error (including when the endpoint isn't yet shipped).
530
+ */
531
+ declare function useNetworkStreamCount(did: string | undefined | null, options?: Omit<UseQueryOptions<number, Error, number, ReturnType<typeof sifaQueryKeys.stream.networkCount>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<number, Error>;
532
+
533
+ /**
534
+ * Batch-look up reaction status for multiple URIs. Skips the network call
535
+ * when `uris` is empty.
536
+ */
537
+ declare function useReactionStatus(uris: string[], options?: Omit<UseQueryOptions<Record<string, ReactionStatus> | null, Error, Record<string, ReactionStatus> | null, ReturnType<typeof sifaQueryKeys.reactions.status>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<Record<string, ReactionStatus> | null>, Error>;
538
+ /** Check whether the authenticated viewer has an account on the given app. */
539
+ declare function useAppAccountCheck(appId: string | undefined | null, options?: Omit<UseQueryOptions<AccountCheckResult | null, Error, AccountCheckResult | null, ReturnType<typeof sifaQueryKeys.reactions.accountCheck>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<AccountCheckResult | null>, Error>;
540
+
541
+ /** Variables for {@link useCreateReaction}. */
542
+ interface CreateReactionVariables {
543
+ targetUri: string;
544
+ appId: string;
545
+ targetCid?: string;
546
+ }
547
+ type CreateReactionMutationResult = {
548
+ ok: true;
549
+ data: ReactionResult;
550
+ } | {
551
+ ok: false;
552
+ error: ReactionError;
553
+ };
554
+ /**
555
+ * React hook for creating a reaction. Returns the discriminated-union
556
+ * result so the caller can detect `scope_insufficient` and trigger an
557
+ * OAuth scope-upgrade flow.
558
+ *
559
+ * Invalidates the entire `sifaQueryKeys.reactions.all()` subtree on
560
+ * success (any cached `useReactionStatus` view that includes the new
561
+ * URI needs a refresh).
562
+ */
563
+ declare function useCreateReaction(options?: Omit<UseMutationOptions<CreateReactionMutationResult, Error, CreateReactionVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<{
564
+ ok: true;
565
+ data: ReactionResult;
566
+ } | {
567
+ ok: false;
568
+ error: ReactionError;
569
+ }, Error, CreateReactionVariables, unknown>;
570
+ /** Variables for {@link useDeleteReaction}. */
571
+ interface DeleteReactionVariables {
572
+ targetUri: string;
573
+ appId: string;
574
+ }
575
+ /** React hook for deleting a reaction. */
576
+ declare function useDeleteReaction(options?: Omit<UseMutationOptions<WriteResult, Error, DeleteReactionVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, DeleteReactionVariables, unknown>;
577
+
578
+ /** Public roadmap vote tallies. Returns `{}` data on error. */
579
+ declare function useRoadmapVotes(options?: Omit<UseQueryOptions<RoadmapVotesResponse, Error, RoadmapVotesResponse, ReturnType<typeof sifaQueryKeys.roadmap.votes>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<RoadmapVotesResponse>, Error>;
580
+ /** Roadmap items the authenticated viewer has voted on. Returns `[]` data on error. */
581
+ declare function useMyRoadmapVotes(options?: Omit<UseQueryOptions<string[], Error, string[], ReturnType<typeof sifaQueryKeys.roadmap.myVotes>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<string[]>, Error>;
582
+
583
+ /**
584
+ * React hook for casting a roadmap vote. Variable: the item key.
585
+ *
586
+ * Returns the discriminated-union result so callers can detect
587
+ * `scope_insufficient` and trigger an OAuth scope-upgrade flow
588
+ * (see {@link castRoadmapVote}).
589
+ */
590
+ declare function useCastRoadmapVote(options?: Omit<UseMutationOptions<CastRoadmapVoteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<CastRoadmapVoteResult, Error, string, unknown>;
591
+ /** React hook for retracting a previously-cast roadmap vote. */
592
+ declare function useRetractRoadmapVote(options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
593
+
594
+ /**
595
+ * React hook for resetting the authenticated user's Sifa profile.
596
+ * Variable: `deletePdsData` boolean.
597
+ *
598
+ * Invalidates the entire `sifaQueryKeys.all()` subtree on success
599
+ * (everything Sifa-related needs a refresh after a reset).
600
+ */
601
+ declare function useResetProfile(options?: Omit<UseMutationOptions<WriteResult, Error, boolean>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, boolean, unknown>;
602
+ /**
603
+ * React hook for deleting the authenticated user's account. Variable:
604
+ * `deletePdsData` boolean. Returns the deleted handle on success.
605
+ *
606
+ * On success, clears the entire query cache (the user is logged out
607
+ * and nothing they previously cached should be retained).
608
+ */
609
+ declare function useDeleteAccount(options?: Omit<UseMutationOptions<DeleteAccountResult, Error, boolean>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<DeleteAccountResult, Error, boolean, unknown>;
610
+
611
+ export { useFeaturedProfile as $, type AddFeatureAllowlistVariables as A, useCreatePosition as B, type CreateReactionVariables as C, type DeleteReactionVariables as D, useCreateProfileLocation as E, type FollowVariables as F, useCreateReaction as G, useCreateRecord as H, useCreateSkill as I, useDebouncedValue as J, useDeleteAccount as K, useDeleteAvatarOverride as L, useDeleteEducation as M, useDeleteExternalAccount as N, useDeletePosition as O, type PositionSkillLinkVariables as P, useDeleteProfileLocation as Q, type RemoveFeatureAllowlistVariables as R, SifaProvider as S, useDeleteReaction as T, type UnfollowVariables as U, useDeleteRecord as V, useDeleteSkill as W, useEndorsementCount as X, useEntitySearch as Y, useExternalAccounts as Z, useFeatureAllowlist as _, type CreateRecordVariables as a, useFollow as a0, useFollowers as a1, useFollowing as a2, useFollowingFeed as a3, useFollowingList as a4, useHeatmapData as a5, useHiddenApps as a6, useHideKeytraceClaim as a7, useHideOrcidPublication as a8, useHideProfileItem as a9, useStats as aA, useSuggestionCount as aB, useSuggestions as aC, useUnfollow as aD, useUnhideKeytraceClaim as aE, useUnhideOrcidPublication as aF, useUnhideProfileItem as aG, useUnhideSifaPublication as aH, useUnhideStandardPublication as aI, useUnlinkSkillFromPosition as aJ, useUnrevealMarqueDomain as aK, useUnsetExternalAccountPrimary as aL, useUnsetPositionPrimary as aM, useUpdateEducation as aN, useUpdateExternalAccount as aO, useUpdatePosition as aP, useUpdateProfileLocation as aQ, useUpdateProfileOverride as aR, useUpdateProfileSelf as aS, useUpdateRecord as aT, useUpdateSkill as aU, useUploadAvatar as aV, useVerifyExternalAccount as aW, useHideSifaPublication as aa, useHideStandardPublication as ab, useImportSearchEntities as ac, useLinkSkillToPosition as ad, useMintEntityDomain as ae, useMutuals as af, useMyRoadmapVotes as ag, useNetworkStreamCount as ah, useProfile as ai, useReactionStatus as aj, useRefreshOrcidPublications as ak, useRefreshPds as al, useRemoveFeatureAllowlist as am, useResetProfile as an, useResolveEntityDomain as ao, useRetractRoadmapVote as ap, useRevealMarqueDomain as aq, useRoadmapVotes as ar, useSearchFilters as as, useSearchProfiles as at, useSelectEntity as au, useSetExternalAccountPrimary as av, useSetPositionPrimary as aw, useSifaConfig as ax, useSimilarProfiles as ay, useSkillSuggestions as az, type DeleteRecordVariables as b, type SifaProviderProps as c, type UpdateEducationVariables as d, type UpdateExternalAccountVariables as e, type UpdatePositionVariables as f, type UpdateProfileLocationVariables as g, type UpdateRecordVariables as h, type UpdateSkillVariables as i, type UseEntitySearchOptions as j, useActivityTeaser as k, useAddFeatureAllowlist as l, useAppAccountCheck as m, useAppsRegistry as n, useAtFundLink as o, useBlueskySuggestions as p, useBulkHideProfileItems as q, useBulkHideStandardPublications as r, useBulkUnhideProfileItems as s, useBulkUnhideStandardPublications as t, useActivityFeed as u, useCanonicalSkillSearch as v, useCastRoadmapVote as w, useCreateEducation as x, useCreateEndorsement as y, useCreateExternalAccount as z };