@singi-labs/sifa-sdk 0.10.5 → 0.10.6

package/dist/query/index.d.cts

@@ -1,9 +1,107 @@
-export { A as AccountCheckResult, a as ActivityFeedResponse, b as ActivityItem, c as ActivityItemLinkHealth, d as ActivityTeaserResponse, e as ApiError, f as ApiFetchOptions, g as AppRegistryEntry, B as BulkHideProfileItemInput, C as CheckAppAccountOptions, h as CreateExternalAccountResult, i as CreateResult, D as DeleteAccountResult, E as EndorsementInput, j as ExternalAccountInput, F as FeatureAllowlistResponse, k as FeaturedProfile, l as FetchActivityFeedOptions, m as FetchActivityTeaserOptions, n as FetchFollowListOptions, o as FetchFollowProfilePageOptions, p as FetchFollowingFeedOptions, q as FetchHiddenAppsOptions, r as FetchMyRoadmapVotesOptions, s as FetchReactionStatusOptions, t as FetchSuggestionsOptions, u as FilterOptions, v as FollowListPage, w as FollowProfile, x as FollowProfilePageResponse, y as FollowUserResult, z as FollowingResponse, H as HIDDEN_ITEM_SOURCES, G as HIDDEN_ITEM_TYPES, I as HeatmapDay, J as HeatmapResponse, K as HiddenApp, L as HiddenItemSource, M as HiddenItemType, N as HideProfileItemInput, O as ListFeatureAllowlistOptions, P as ProfileIndustryInput, Q as ProfileLocationAddress, R as ProfileLocationInput, S as ProfileSearchResult, T as ProfileSelfLocation, U as QUOTED_POSTS_BATCH_MAX, V as QuotedPostAuthor, W as QuotedPostImage, X as QuotedPostResult, Y as QuotedPostView, Z as ReactionError, _ as ReactionResult, $ as ReactionStatus, a0 as RefreshOrcidPublicationsResult, a1 as RefreshPdsResult, a2 as ResolveQuotedPostsOptions, a3 as RoadmapVoter, a4 as RoadmapVotesResponse, a5 as SearchFilters, a6 as SearchResponse, a7 as SifaApiConfig, a8 as SifaQueryKey, a9 as SimilarProfile, aa as SkillSearchResult, ab as StatsResponse, ac as SuggestionProfile, ad as SuggestionsResponse, ae as UpdateProfileOverrideInput, af as UpdateProfileSelfInput, ag as UploadAvatarResult, ah as VerifyExternalAccountResult, ai as WriteResult, aj as addFeatureAllowlist, ak as apiFetch, al as apiFetchOrNull, am as apiWrite, an as apiWriteCreate, ao as bulkHideProfileItems, ap as bulkHideStandardPublications, aq as bulkUnhideProfileItems, ar as bulkUnhideStandardPublications, as as castRoadmapVote, at as checkAppAccount, au as createEndorsement, av as createExternalAccount, aw as createProfileLocation, ax as createReaction, ay as deleteAccount, az as deleteAvatarOverride, aA as deleteExternalAccount, aB as deleteProfileLocation, aC as deleteReaction, aD as fetchActivityFeed, aE as fetchActivityTeaser, aF as fetchAppsRegistry, aG as fetchExternalAccounts, aH as fetchFeaturedProfile, aI as fetchFollowing, aJ as fetchHeatmapData, aK as fetchHiddenApps, aL as fetchMyRoadmapVotes, aM as fetchReactionStatus, aN as fetchRoadmapVotes, aO as fetchSearchFilters, aP as fetchSearchProfiles, aQ as fetchSimilarProfiles, aR as fetchSkillSuggestions, aS as fetchStats, aT as fetchSuggestionCount, aU as fetchSuggestions, aV as followUser, aW as getBlueskySuggestions, aX as getFollowers, aY as getFollowing, aZ as getFollowingFeed, a_ as getMutuals, a$ as hideOrcidPublication, b0 as hideProfileItem, b1 as hideSifaPublication, b2 as hideStandardPublication, b3 as listFeatureAllowlist, b4 as refreshOrcidPublications, b5 as refreshPds, b6 as removeFeatureAllowlist, b7 as resetProfile, b8 as resolveQuotedPosts, b9 as retractRoadmapVote, ba as searchSkills, bb as setExternalAccountPrimary, bc as sifaQueryKeys, bd as unfollowUser, be as unhideOrcidPublication, bf as unhideProfileItem, bg as unhideSifaPublication, bh as unhideStandardPublication, bi as unsetExternalAccountPrimary, bj as updateExternalAccount, bk as updateProfileLocation, bl as updateProfileOverride, bm as updateProfileSelf, bn as uploadAvatar, bo as verifyExternalAccount } from '../keys-DPeDdYki.cjs';
+import { S as SifaApiConfig, A as ApiFetchOptions, W as WriteResult, s as sifaQueryKeys } from '../keys-GSG0egRE.cjs';
+export { a as AccountCheckResult, b as ActivityFeedResponse, c as ActivityItem, d as ActivityItemLinkHealth, e as ActivityTeaserResponse, f as ApiError, g as AppRegistryEntry, B as BulkHideProfileItemInput, C as CheckAppAccountOptions, h as CreateExternalAccountResult, i as CreateResult, D as DeleteAccountResult, E as EndorsementInput, j as ExternalAccountInput, F as FeatureAllowlistResponse, k as FeaturedProfile, l as FetchActivityFeedOptions, m as FetchActivityTeaserOptions, n as FetchFollowListOptions, o as FetchFollowProfilePageOptions, p as FetchFollowingFeedOptions, q as FetchHiddenAppsOptions, r as FetchMyRoadmapVotesOptions, t as FetchReactionStatusOptions, u as FetchSuggestionsOptions, v as FilterOptions, w as FollowListPage, x as FollowProfile, y as FollowProfilePageResponse, z as FollowUserResult, G as FollowingResponse, H as HIDDEN_ITEM_SOURCES, I as HIDDEN_ITEM_TYPES, J as HeatmapDay, K as HeatmapResponse, L as HiddenApp, M as HiddenItemSource, N as HiddenItemType, O as HideProfileItemInput, P as ListFeatureAllowlistOptions, Q as ProfileIndustryInput, R as ProfileLocationAddress, T as ProfileLocationInput, U as ProfileSearchResult, V as ProfileSelfLocation, X as QUOTED_POSTS_BATCH_MAX, Y as QuotedPostAuthor, Z as QuotedPostImage, _ as QuotedPostResult, $ as QuotedPostView, a0 as ReactionError, a1 as ReactionResult, a2 as ReactionStatus, a3 as RefreshOrcidPublicationsResult, a4 as RefreshPdsResult, a5 as ResolveQuotedPostsOptions, a6 as RoadmapVoter, a7 as RoadmapVotesResponse, a8 as SearchFilters, a9 as SearchResponse, aa as SifaQueryKey, ab as SimilarProfile, ac as SkillSearchResult, ad as StatsResponse, ae as SuggestionProfile, af as SuggestionsResponse, ag as UpdateProfileOverrideInput, ah as UpdateProfileSelfInput, ai as UploadAvatarResult, aj as VerifyExternalAccountResult, ak as addFeatureAllowlist, al as apiFetch, am as apiFetchOrNull, an as apiWrite, ao as apiWriteCreate, ap as bulkHideProfileItems, aq as bulkHideStandardPublications, ar as bulkUnhideProfileItems, as as bulkUnhideStandardPublications, at as castRoadmapVote, au as checkAppAccount, av as createEndorsement, aw as createExternalAccount, ax as createProfileLocation, ay as createReaction, az as deleteAccount, aA as deleteAvatarOverride, aB as deleteExternalAccount, aC as deleteProfileLocation, aD as deleteReaction, aE as fetchActivityFeed, aF as fetchActivityTeaser, aG as fetchAppsRegistry, aH as fetchExternalAccounts, aI as fetchFeaturedProfile, aJ as fetchFollowing, aK as fetchHeatmapData, aL as fetchHiddenApps, aM as fetchMyRoadmapVotes, aN as fetchReactionStatus, aO as fetchRoadmapVotes, aP as fetchSearchFilters, aQ as fetchSearchProfiles, aR as fetchSimilarProfiles, aS as fetchSkillSuggestions, aT as fetchStats, aU as fetchSuggestionCount, aV as fetchSuggestions, aW as followUser, aX as getBlueskySuggestions, aY as getFollowers, aZ as getFollowing, a_ as getFollowingFeed, a$ as getMutuals, b0 as hideOrcidPublication, b1 as hideProfileItem, b2 as hideSifaPublication, b3 as hideStandardPublication, b4 as listFeatureAllowlist, b5 as refreshOrcidPublications, b6 as refreshPds, b7 as removeFeatureAllowlist, b8 as resetProfile, b9 as resolveQuotedPosts, ba as retractRoadmapVote, bb as searchSkills, bc as setExternalAccountPrimary, bd as unfollowUser, be as unhideOrcidPublication, bf as unhideProfileItem, bg as unhideSifaPublication, bh as unhideStandardPublication, bi as unsetExternalAccountPrimary, bj as updateExternalAccount, bk as updateProfileLocation, bl as updateProfileOverride, bm as updateProfileSelf, bn as uploadAvatar, bo as verifyExternalAccount } from '../keys-GSG0egRE.cjs';
 export { AddFeatureAllowlistVariables, CreateReactionVariables, CreateRecordVariables, DeleteReactionVariables, DeleteRecordVariables, FollowVariables, PositionSkillLinkVariables, RemoveFeatureAllowlistVariables, SifaProvider, SifaProviderProps, UnfollowVariables, UpdateEducationVariables, UpdateExternalAccountVariables, UpdatePositionVariables, UpdateProfileLocationVariables, UpdateRecordVariables, UpdateSkillVariables, useActivityFeed, useActivityTeaser, useAddFeatureAllowlist, useAppAccountCheck, useAppsRegistry, useAtFundLink, useBlueskySuggestions, useBulkHideProfileItems, useBulkHideStandardPublications, useBulkUnhideProfileItems, useBulkUnhideStandardPublications, useCanonicalSkillSearch, useCastRoadmapVote, useCreateEducation, useCreateEndorsement, useCreateExternalAccount, useCreatePosition, useCreateProfileLocation, useCreateReaction, useCreateRecord, useCreateSkill, useDeleteAccount, useDeleteAvatarOverride, useDeleteEducation, useDeleteExternalAccount, useDeletePosition, useDeleteProfileLocation, useDeleteReaction, useDeleteRecord, useDeleteSkill, useEndorsementCount, useExternalAccounts, useFeatureAllowlist, useFeaturedProfile, useFollow, useFollowers, useFollowing, useFollowingFeed, useFollowingList, useHeatmapData, useHiddenApps, useHideKeytraceClaim, useHideOrcidPublication, useHideProfileItem, useHideSifaPublication, useHideStandardPublication, useLinkSkillToPosition, useMutuals, useMyRoadmapVotes, useNetworkStreamCount, useProfile, useReactionStatus, useRefreshOrcidPublications, useRefreshPds, useRemoveFeatureAllowlist, useResetProfile, useRetractRoadmapVote, useRoadmapVotes, useSearchFilters, useSearchProfiles, useSetExternalAccountPrimary, useSetPositionPrimary, useSifaConfig, useSimilarProfiles, useSkillSuggestions, useStats, useSuggestionCount, useSuggestions, useUnfollow, useUnhideKeytraceClaim, useUnhideOrcidPublication, useUnhideProfileItem, useUnhideSifaPublication, useUnhideStandardPublication, useUnlinkSkillFromPosition, useUnsetExternalAccountPrimary, useUnsetPositionPrimary, useUpdateEducation, useUpdateExternalAccount, useUpdatePosition, useUpdateProfileLocation, useUpdateProfileOverride, useUpdateProfileSelf, useUpdateRecord, useUpdateSkill, useUploadAvatar, useVerifyExternalAccount } from './hooks/index.cjs';
 export { FetchNetworkStreamCountOptions, NetworkMapEdge, NetworkMapGenerationJob, NetworkMapGraphData, NetworkMapNode, NetworkMapPendingJob, NetworkMapResponse, checkNetworkMapJobStatus, createEducation, createPosition, createRecord, createSkill, deleteEducation, deletePosition, deleteRecord, deleteSkill, fetchAtFundLink, fetchEndorsementCount, fetchNetworkMap, fetchNetworkStreamCount, fetchProfile, hideKeytraceClaim, initiateNetworkMapGeneration, isNetworkMapResponse, linkSkillToPosition, setPositionPrimary, unhideKeytraceClaim, unlinkSkillFromPosition, unsetPositionPrimary, updateEducation, updatePosition, updateRecord, updateSkill } from './fetchers/index.cjs';
-import '../adult-content-BjbP46ad.cjs';
+import { A as AdultContentLabel } from '../adult-content-DxasJdot.cjs';
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { UseQueryOptions } from '@tanstack/react-query';
 import '../feed-DHTy7fUN.cjs';
 import 'zod';
 import 'react/jsx-runtime';
 import 'react';
-import '@tanstack/react-query';
+
+/**
+ * Visibility values defined by `app.bsky.actor.defs#contentLabelPref`.
+ * `null` means the viewer has no explicit pref for that label — call sites
+ * decide a default (Sifa hides by default; Bluesky's own client defaults
+ * to `warn` for adult labels on new accounts).
+ */
+type BskyContentLabelVisibility = 'ignore' | 'warn' | 'hide';
+type BskyContentLabelPrefs = Record<AdultContentLabel, BskyContentLabelVisibility | null>;
+interface BskyContentLabelPrefsResponse {
+    contentLabels: BskyContentLabelPrefs;
+}
+interface BskyPrefsScopeError {
+    error: 'InsufficientScope';
+    message?: string;
+    needsScope: 'bsky-preferences';
+}
+/**
+ * Read the viewer's Bluesky content-label preferences via sifa-api's
+ * proxy. Returns `null` when the viewer's OAuth grant doesn't include the
+ * read scope — sifa-web treats this as "needs scope upgrade" and triggers
+ * a granular re-auth.
+ *
+ * Any other failure (network, upstream PDS error) also resolves to `null`
+ * so callers always have a safe default (hide everything).
+ */
+declare function fetchBskyContentLabelPrefs(config: SifaApiConfig, options?: ApiFetchOptions & {
+    onNeedsScope?: () => void;
+}): Promise<BskyContentLabelPrefs | null>;
+interface UpdateBskyContentLabelPrefsBody {
+    contentLabels: Array<{
+        label: AdultContentLabel;
+        visibility: BskyContentLabelVisibility;
+    }>;
+}
+/**
+ * Update one or more of the viewer's adult content-label preferences. The
+ * sifa-api endpoint merges these into the viewer's existing prefs and
+ * writes the whole array back to their PDS — entries we don't touch are
+ * preserved.
+ *
+ * On insufficient-scope returns `{ success: false, error: ..., needsScope }`
+ * so the caller can drive a granular re-auth.
+ */
+declare function updateBskyContentLabelPrefs(config: SifaApiConfig, body: UpdateBskyContentLabelPrefsBody): Promise<WriteResult & {
+    contentLabels?: BskyContentLabelPrefs;
+    needsScope?: 'bsky-preferences';
+}>;
+/**
+ * Compute the effective visibility for a Bluesky adult label.
+ *
+ * - Anonymous viewer (no prefs): always `hide` — matches Bluesky's logged-out
+ *   behaviour; sifa-web won't even render a Show button.
+ * - Authenticated viewer with no explicit pref: `hide` by default, so Sifa
+ *   stays safe-by-default and matches the gate that ships in sifa-web#1240
+ *   today.
+ * - Authenticated viewer with an explicit pref: use it directly.
+ *
+ * Returns `'ignore'` to mean "render media inline", `'warn'` and `'hide'`
+ * both mean "placeholder card + reveal button" — Sifa doesn't distinguish
+ * the two today, but keeping them separate matches the lexicon and lets the
+ * UI evolve (e.g. blur for warn, full hide for hide) without an SDK change.
+ */
+declare function effectiveContentVisibility(label: AdultContentLabel, prefs: BskyContentLabelPrefs | null, isAuthenticated: boolean): BskyContentLabelVisibility;
+/**
+ * Whether a labeled item should render its media inline. Convenience over
+ * `effectiveContentVisibility` for the common "any adult label hides
+ * everything" case in BlueskyPostCard.
+ */
+declare function shouldGateAdultMedia(labels: ReadonlyArray<{
+    val: string;
+    neg?: boolean;
+}> | undefined, prefs: BskyContentLabelPrefs | null, isAuthenticated: boolean): boolean;
+
+/**
+ * Read the viewer's Bluesky adult content-label preferences. The fetcher
+ * returns `null` when the OAuth grant doesn't include the read scope
+ * (sifa-api responds 403 with `needsScope: 'bsky-preferences'`); call
+ * sites should treat `null` as "needs scope upgrade" and route through
+ * the granular re-auth flow before retrying.
+ *
+ * Pass `enabled: false` for anonymous viewers — TanStack will skip the
+ * fetch entirely and the gate will fall through to its default-hide path.
+ */
+declare function useBskyContentLabelPrefs(options?: Omit<UseQueryOptions<BskyContentLabelPrefs | null, Error, BskyContentLabelPrefs | null, ReturnType<typeof sifaQueryKeys.bskyPreferences.contentLabels>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<BskyContentLabelPrefs | null>, Error>;
+/**
+ * Mutation that updates one or more adult-content prefs on the viewer's
+ * PDS via sifa-api, then writes the merged result back into the prefs
+ * cache so the next render reflects the change without a refetch.
+ */
+declare function useUpdateBskyContentLabelPrefs(): _tanstack_react_query.UseMutationResult<WriteResult & {
+    contentLabels?: BskyContentLabelPrefs;
+    needsScope?: "bsky-preferences";
+}, Error, UpdateBskyContentLabelPrefsBody, unknown>;
+
+export { ApiFetchOptions, type BskyContentLabelPrefs, type BskyContentLabelPrefsResponse, type BskyContentLabelVisibility, type BskyPrefsScopeError, SifaApiConfig, type UpdateBskyContentLabelPrefsBody, WriteResult, effectiveContentVisibility, fetchBskyContentLabelPrefs, shouldGateAdultMedia, sifaQueryKeys, updateBskyContentLabelPrefs, useBskyContentLabelPrefs, useUpdateBskyContentLabelPrefs };

package/dist/query/index.d.ts

@@ -1,9 +1,107 @@
-export { A as AccountCheckResult, a as ActivityFeedResponse, b as ActivityItem, c as ActivityItemLinkHealth, d as ActivityTeaserResponse, e as ApiError, f as ApiFetchOptions, g as AppRegistryEntry, B as BulkHideProfileItemInput, C as CheckAppAccountOptions, h as CreateExternalAccountResult, i as CreateResult, D as DeleteAccountResult, E as EndorsementInput, j as ExternalAccountInput, F as FeatureAllowlistResponse, k as FeaturedProfile, l as FetchActivityFeedOptions, m as FetchActivityTeaserOptions, n as FetchFollowListOptions, o as FetchFollowProfilePageOptions, p as FetchFollowingFeedOptions, q as FetchHiddenAppsOptions, r as FetchMyRoadmapVotesOptions, s as FetchReactionStatusOptions, t as FetchSuggestionsOptions, u as FilterOptions, v as FollowListPage, w as FollowProfile, x as FollowProfilePageResponse, y as FollowUserResult, z as FollowingResponse, H as HIDDEN_ITEM_SOURCES, G as HIDDEN_ITEM_TYPES, I as HeatmapDay, J as HeatmapResponse, K as HiddenApp, L as HiddenItemSource, M as HiddenItemType, N as HideProfileItemInput, O as ListFeatureAllowlistOptions, P as ProfileIndustryInput, Q as ProfileLocationAddress, R as ProfileLocationInput, S as ProfileSearchResult, T as ProfileSelfLocation, U as QUOTED_POSTS_BATCH_MAX, V as QuotedPostAuthor, W as QuotedPostImage, X as QuotedPostResult, Y as QuotedPostView, Z as ReactionError, _ as ReactionResult, $ as ReactionStatus, a0 as RefreshOrcidPublicationsResult, a1 as RefreshPdsResult, a2 as ResolveQuotedPostsOptions, a3 as RoadmapVoter, a4 as RoadmapVotesResponse, a5 as SearchFilters, a6 as SearchResponse, a7 as SifaApiConfig, a8 as SifaQueryKey, a9 as SimilarProfile, aa as SkillSearchResult, ab as StatsResponse, ac as SuggestionProfile, ad as SuggestionsResponse, ae as UpdateProfileOverrideInput, af as UpdateProfileSelfInput, ag as UploadAvatarResult, ah as VerifyExternalAccountResult, ai as WriteResult, aj as addFeatureAllowlist, ak as apiFetch, al as apiFetchOrNull, am as apiWrite, an as apiWriteCreate, ao as bulkHideProfileItems, ap as bulkHideStandardPublications, aq as bulkUnhideProfileItems, ar as bulkUnhideStandardPublications, as as castRoadmapVote, at as checkAppAccount, au as createEndorsement, av as createExternalAccount, aw as createProfileLocation, ax as createReaction, ay as deleteAccount, az as deleteAvatarOverride, aA as deleteExternalAccount, aB as deleteProfileLocation, aC as deleteReaction, aD as fetchActivityFeed, aE as fetchActivityTeaser, aF as fetchAppsRegistry, aG as fetchExternalAccounts, aH as fetchFeaturedProfile, aI as fetchFollowing, aJ as fetchHeatmapData, aK as fetchHiddenApps, aL as fetchMyRoadmapVotes, aM as fetchReactionStatus, aN as fetchRoadmapVotes, aO as fetchSearchFilters, aP as fetchSearchProfiles, aQ as fetchSimilarProfiles, aR as fetchSkillSuggestions, aS as fetchStats, aT as fetchSuggestionCount, aU as fetchSuggestions, aV as followUser, aW as getBlueskySuggestions, aX as getFollowers, aY as getFollowing, aZ as getFollowingFeed, a_ as getMutuals, a$ as hideOrcidPublication, b0 as hideProfileItem, b1 as hideSifaPublication, b2 as hideStandardPublication, b3 as listFeatureAllowlist, b4 as refreshOrcidPublications, b5 as refreshPds, b6 as removeFeatureAllowlist, b7 as resetProfile, b8 as resolveQuotedPosts, b9 as retractRoadmapVote, ba as searchSkills, bb as setExternalAccountPrimary, bc as sifaQueryKeys, bd as unfollowUser, be as unhideOrcidPublication, bf as unhideProfileItem, bg as unhideSifaPublication, bh as unhideStandardPublication, bi as unsetExternalAccountPrimary, bj as updateExternalAccount, bk as updateProfileLocation, bl as updateProfileOverride, bm as updateProfileSelf, bn as uploadAvatar, bo as verifyExternalAccount } from '../keys-Ba4_wCnj.js';
+import { S as SifaApiConfig, A as ApiFetchOptions, W as WriteResult, s as sifaQueryKeys } from '../keys-G_SErFOu.js';
+export { a as AccountCheckResult, b as ActivityFeedResponse, c as ActivityItem, d as ActivityItemLinkHealth, e as ActivityTeaserResponse, f as ApiError, g as AppRegistryEntry, B as BulkHideProfileItemInput, C as CheckAppAccountOptions, h as CreateExternalAccountResult, i as CreateResult, D as DeleteAccountResult, E as EndorsementInput, j as ExternalAccountInput, F as FeatureAllowlistResponse, k as FeaturedProfile, l as FetchActivityFeedOptions, m as FetchActivityTeaserOptions, n as FetchFollowListOptions, o as FetchFollowProfilePageOptions, p as FetchFollowingFeedOptions, q as FetchHiddenAppsOptions, r as FetchMyRoadmapVotesOptions, t as FetchReactionStatusOptions, u as FetchSuggestionsOptions, v as FilterOptions, w as FollowListPage, x as FollowProfile, y as FollowProfilePageResponse, z as FollowUserResult, G as FollowingResponse, H as HIDDEN_ITEM_SOURCES, I as HIDDEN_ITEM_TYPES, J as HeatmapDay, K as HeatmapResponse, L as HiddenApp, M as HiddenItemSource, N as HiddenItemType, O as HideProfileItemInput, P as ListFeatureAllowlistOptions, Q as ProfileIndustryInput, R as ProfileLocationAddress, T as ProfileLocationInput, U as ProfileSearchResult, V as ProfileSelfLocation, X as QUOTED_POSTS_BATCH_MAX, Y as QuotedPostAuthor, Z as QuotedPostImage, _ as QuotedPostResult, $ as QuotedPostView, a0 as ReactionError, a1 as ReactionResult, a2 as ReactionStatus, a3 as RefreshOrcidPublicationsResult, a4 as RefreshPdsResult, a5 as ResolveQuotedPostsOptions, a6 as RoadmapVoter, a7 as RoadmapVotesResponse, a8 as SearchFilters, a9 as SearchResponse, aa as SifaQueryKey, ab as SimilarProfile, ac as SkillSearchResult, ad as StatsResponse, ae as SuggestionProfile, af as SuggestionsResponse, ag as UpdateProfileOverrideInput, ah as UpdateProfileSelfInput, ai as UploadAvatarResult, aj as VerifyExternalAccountResult, ak as addFeatureAllowlist, al as apiFetch, am as apiFetchOrNull, an as apiWrite, ao as apiWriteCreate, ap as bulkHideProfileItems, aq as bulkHideStandardPublications, ar as bulkUnhideProfileItems, as as bulkUnhideStandardPublications, at as castRoadmapVote, au as checkAppAccount, av as createEndorsement, aw as createExternalAccount, ax as createProfileLocation, ay as createReaction, az as deleteAccount, aA as deleteAvatarOverride, aB as deleteExternalAccount, aC as deleteProfileLocation, aD as deleteReaction, aE as fetchActivityFeed, aF as fetchActivityTeaser, aG as fetchAppsRegistry, aH as fetchExternalAccounts, aI as fetchFeaturedProfile, aJ as fetchFollowing, aK as fetchHeatmapData, aL as fetchHiddenApps, aM as fetchMyRoadmapVotes, aN as fetchReactionStatus, aO as fetchRoadmapVotes, aP as fetchSearchFilters, aQ as fetchSearchProfiles, aR as fetchSimilarProfiles, aS as fetchSkillSuggestions, aT as fetchStats, aU as fetchSuggestionCount, aV as fetchSuggestions, aW as followUser, aX as getBlueskySuggestions, aY as getFollowers, aZ as getFollowing, a_ as getFollowingFeed, a$ as getMutuals, b0 as hideOrcidPublication, b1 as hideProfileItem, b2 as hideSifaPublication, b3 as hideStandardPublication, b4 as listFeatureAllowlist, b5 as refreshOrcidPublications, b6 as refreshPds, b7 as removeFeatureAllowlist, b8 as resetProfile, b9 as resolveQuotedPosts, ba as retractRoadmapVote, bb as searchSkills, bc as setExternalAccountPrimary, bd as unfollowUser, be as unhideOrcidPublication, bf as unhideProfileItem, bg as unhideSifaPublication, bh as unhideStandardPublication, bi as unsetExternalAccountPrimary, bj as updateExternalAccount, bk as updateProfileLocation, bl as updateProfileOverride, bm as updateProfileSelf, bn as uploadAvatar, bo as verifyExternalAccount } from '../keys-G_SErFOu.js';
 export { AddFeatureAllowlistVariables, CreateReactionVariables, CreateRecordVariables, DeleteReactionVariables, DeleteRecordVariables, FollowVariables, PositionSkillLinkVariables, RemoveFeatureAllowlistVariables, SifaProvider, SifaProviderProps, UnfollowVariables, UpdateEducationVariables, UpdateExternalAccountVariables, UpdatePositionVariables, UpdateProfileLocationVariables, UpdateRecordVariables, UpdateSkillVariables, useActivityFeed, useActivityTeaser, useAddFeatureAllowlist, useAppAccountCheck, useAppsRegistry, useAtFundLink, useBlueskySuggestions, useBulkHideProfileItems, useBulkHideStandardPublications, useBulkUnhideProfileItems, useBulkUnhideStandardPublications, useCanonicalSkillSearch, useCastRoadmapVote, useCreateEducation, useCreateEndorsement, useCreateExternalAccount, useCreatePosition, useCreateProfileLocation, useCreateReaction, useCreateRecord, useCreateSkill, useDeleteAccount, useDeleteAvatarOverride, useDeleteEducation, useDeleteExternalAccount, useDeletePosition, useDeleteProfileLocation, useDeleteReaction, useDeleteRecord, useDeleteSkill, useEndorsementCount, useExternalAccounts, useFeatureAllowlist, useFeaturedProfile, useFollow, useFollowers, useFollowing, useFollowingFeed, useFollowingList, useHeatmapData, useHiddenApps, useHideKeytraceClaim, useHideOrcidPublication, useHideProfileItem, useHideSifaPublication, useHideStandardPublication, useLinkSkillToPosition, useMutuals, useMyRoadmapVotes, useNetworkStreamCount, useProfile, useReactionStatus, useRefreshOrcidPublications, useRefreshPds, useRemoveFeatureAllowlist, useResetProfile, useRetractRoadmapVote, useRoadmapVotes, useSearchFilters, useSearchProfiles, useSetExternalAccountPrimary, useSetPositionPrimary, useSifaConfig, useSimilarProfiles, useSkillSuggestions, useStats, useSuggestionCount, useSuggestions, useUnfollow, useUnhideKeytraceClaim, useUnhideOrcidPublication, useUnhideProfileItem, useUnhideSifaPublication, useUnhideStandardPublication, useUnlinkSkillFromPosition, useUnsetExternalAccountPrimary, useUnsetPositionPrimary, useUpdateEducation, useUpdateExternalAccount, useUpdatePosition, useUpdateProfileLocation, useUpdateProfileOverride, useUpdateProfileSelf, useUpdateRecord, useUpdateSkill, useUploadAvatar, useVerifyExternalAccount } from './hooks/index.js';
 export { FetchNetworkStreamCountOptions, NetworkMapEdge, NetworkMapGenerationJob, NetworkMapGraphData, NetworkMapNode, NetworkMapPendingJob, NetworkMapResponse, checkNetworkMapJobStatus, createEducation, createPosition, createRecord, createSkill, deleteEducation, deletePosition, deleteRecord, deleteSkill, fetchAtFundLink, fetchEndorsementCount, fetchNetworkMap, fetchNetworkStreamCount, fetchProfile, hideKeytraceClaim, initiateNetworkMapGeneration, isNetworkMapResponse, linkSkillToPosition, setPositionPrimary, unhideKeytraceClaim, unlinkSkillFromPosition, unsetPositionPrimary, updateEducation, updatePosition, updateRecord, updateSkill } from './fetchers/index.js';
-import '../adult-content-BjbP46ad.js';
+import { A as AdultContentLabel } from '../adult-content-DxasJdot.js';
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { UseQueryOptions } from '@tanstack/react-query';
 import '../feed-DHTy7fUN.js';
 import 'zod';
 import 'react/jsx-runtime';
 import 'react';
-import '@tanstack/react-query';
+
+/**
+ * Visibility values defined by `app.bsky.actor.defs#contentLabelPref`.
+ * `null` means the viewer has no explicit pref for that label — call sites
+ * decide a default (Sifa hides by default; Bluesky's own client defaults
+ * to `warn` for adult labels on new accounts).
+ */
+type BskyContentLabelVisibility = 'ignore' | 'warn' | 'hide';
+type BskyContentLabelPrefs = Record<AdultContentLabel, BskyContentLabelVisibility | null>;
+interface BskyContentLabelPrefsResponse {
+    contentLabels: BskyContentLabelPrefs;
+}
+interface BskyPrefsScopeError {
+    error: 'InsufficientScope';
+    message?: string;
+    needsScope: 'bsky-preferences';
+}
+/**
+ * Read the viewer's Bluesky content-label preferences via sifa-api's
+ * proxy. Returns `null` when the viewer's OAuth grant doesn't include the
+ * read scope — sifa-web treats this as "needs scope upgrade" and triggers
+ * a granular re-auth.
+ *
+ * Any other failure (network, upstream PDS error) also resolves to `null`
+ * so callers always have a safe default (hide everything).
+ */
+declare function fetchBskyContentLabelPrefs(config: SifaApiConfig, options?: ApiFetchOptions & {
+    onNeedsScope?: () => void;
+}): Promise<BskyContentLabelPrefs | null>;
+interface UpdateBskyContentLabelPrefsBody {
+    contentLabels: Array<{
+        label: AdultContentLabel;
+        visibility: BskyContentLabelVisibility;
+    }>;
+}
+/**
+ * Update one or more of the viewer's adult content-label preferences. The
+ * sifa-api endpoint merges these into the viewer's existing prefs and
+ * writes the whole array back to their PDS — entries we don't touch are
+ * preserved.
+ *
+ * On insufficient-scope returns `{ success: false, error: ..., needsScope }`
+ * so the caller can drive a granular re-auth.
+ */
+declare function updateBskyContentLabelPrefs(config: SifaApiConfig, body: UpdateBskyContentLabelPrefsBody): Promise<WriteResult & {
+    contentLabels?: BskyContentLabelPrefs;
+    needsScope?: 'bsky-preferences';
+}>;
+/**
+ * Compute the effective visibility for a Bluesky adult label.
+ *
+ * - Anonymous viewer (no prefs): always `hide` — matches Bluesky's logged-out
+ *   behaviour; sifa-web won't even render a Show button.
+ * - Authenticated viewer with no explicit pref: `hide` by default, so Sifa
+ *   stays safe-by-default and matches the gate that ships in sifa-web#1240
+ *   today.
+ * - Authenticated viewer with an explicit pref: use it directly.
+ *
+ * Returns `'ignore'` to mean "render media inline", `'warn'` and `'hide'`
+ * both mean "placeholder card + reveal button" — Sifa doesn't distinguish
+ * the two today, but keeping them separate matches the lexicon and lets the
+ * UI evolve (e.g. blur for warn, full hide for hide) without an SDK change.
+ */
+declare function effectiveContentVisibility(label: AdultContentLabel, prefs: BskyContentLabelPrefs | null, isAuthenticated: boolean): BskyContentLabelVisibility;
+/**
+ * Whether a labeled item should render its media inline. Convenience over
+ * `effectiveContentVisibility` for the common "any adult label hides
+ * everything" case in BlueskyPostCard.
+ */
+declare function shouldGateAdultMedia(labels: ReadonlyArray<{
+    val: string;
+    neg?: boolean;
+}> | undefined, prefs: BskyContentLabelPrefs | null, isAuthenticated: boolean): boolean;
+
+/**
+ * Read the viewer's Bluesky adult content-label preferences. The fetcher
+ * returns `null` when the OAuth grant doesn't include the read scope
+ * (sifa-api responds 403 with `needsScope: 'bsky-preferences'`); call
+ * sites should treat `null` as "needs scope upgrade" and route through
+ * the granular re-auth flow before retrying.
+ *
+ * Pass `enabled: false` for anonymous viewers — TanStack will skip the
+ * fetch entirely and the gate will fall through to its default-hide path.
+ */
+declare function useBskyContentLabelPrefs(options?: Omit<UseQueryOptions<BskyContentLabelPrefs | null, Error, BskyContentLabelPrefs | null, ReturnType<typeof sifaQueryKeys.bskyPreferences.contentLabels>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<BskyContentLabelPrefs | null>, Error>;
+/**
+ * Mutation that updates one or more adult-content prefs on the viewer's
+ * PDS via sifa-api, then writes the merged result back into the prefs
+ * cache so the next render reflects the change without a refetch.
+ */
+declare function useUpdateBskyContentLabelPrefs(): _tanstack_react_query.UseMutationResult<WriteResult & {
+    contentLabels?: BskyContentLabelPrefs;
+    needsScope?: "bsky-preferences";
+}, Error, UpdateBskyContentLabelPrefsBody, unknown>;
+
+export { ApiFetchOptions, type BskyContentLabelPrefs, type BskyContentLabelPrefsResponse, type BskyContentLabelVisibility, type BskyPrefsScopeError, SifaApiConfig, type UpdateBskyContentLabelPrefsBody, WriteResult, effectiveContentVisibility, fetchBskyContentLabelPrefs, shouldGateAdultMedia, sifaQueryKeys, updateBskyContentLabelPrefs, useBskyContentLabelPrefs, useUpdateBskyContentLabelPrefs };

package/dist/query/index.js

@@ -1122,6 +1122,10 @@ var sifaQueryKeys = {
     all: () => ["sifa", "roadmap"],
     votes: () => ["sifa", "roadmap", "votes"],
     myVotes: () => ["sifa", "roadmap", "my-votes"]
+  },
+  bskyPreferences: {
+    all: () => ["sifa", "bsky-preferences"],
+    contentLabels: () => ["sifa", "bsky-preferences", "content-labels"]
   }
 };
 
@@ -2200,6 +2204,83 @@ function useDeleteAccount(options) {
   });
 }
 
-export { ApiError, HIDDEN_ITEM_SOURCES, HIDDEN_ITEM_TYPES, QUOTED_POSTS_BATCH_MAX, SifaProvider, addFeatureAllowlist, apiFetch, apiFetchOrNull, apiWrite, apiWriteCreate, bulkHideProfileItems, bulkHideStandardPublications, bulkUnhideProfileItems, bulkUnhideStandardPublications, castRoadmapVote, checkAppAccount, checkNetworkMapJobStatus, 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, fetchNetworkMap, fetchNetworkStreamCount, fetchProfile, fetchReactionStatus, fetchRoadmapVotes, fetchSearchFilters, fetchSearchProfiles, fetchSimilarProfiles, fetchSkillSuggestions, fetchStats, fetchSuggestionCount, fetchSuggestions, followUser, getBlueskySuggestions, getFollowers, getFollowing, getFollowingFeed, getMutuals, hideKeytraceClaim, hideOrcidPublication, hideProfileItem, hideSifaPublication, hideStandardPublication, initiateNetworkMapGeneration, isNetworkMapResponse, linkSkillToPosition, listFeatureAllowlist, refreshOrcidPublications, refreshPds, removeFeatureAllowlist, resetProfile, resolveQuotedPosts, retractRoadmapVote, searchSkills, setExternalAccountPrimary, setPositionPrimary, sifaQueryKeys, unfollowUser, unhideKeytraceClaim, unhideOrcidPublication, unhideProfileItem, unhideSifaPublication, unhideStandardPublication, unlinkSkillFromPosition, unsetExternalAccountPrimary, unsetPositionPrimary, updateEducation, updateExternalAccount, updatePosition, updateProfileLocation, updateProfileOverride, updateProfileSelf, updateRecord, updateSkill, uploadAvatar, useActivityFeed, useActivityTeaser, useAddFeatureAllowlist, useAppAccountCheck, useAppsRegistry, useAtFundLink, useBlueskySuggestions, useBulkHideProfileItems, useBulkHideStandardPublications, useBulkUnhideProfileItems, useBulkUnhideStandardPublications, useCanonicalSkillSearch, useCastRoadmapVote, useCreateEducation, useCreateEndorsement, useCreateExternalAccount, useCreatePosition, useCreateProfileLocation, useCreateReaction, useCreateRecord, useCreateSkill, useDeleteAccount, useDeleteAvatarOverride, useDeleteEducation, useDeleteExternalAccount, useDeletePosition, useDeleteProfileLocation, useDeleteReaction, useDeleteRecord, useDeleteSkill, useEndorsementCount, useExternalAccounts, useFeatureAllowlist, useFeaturedProfile, useFollow, useFollowers, useFollowing, useFollowingFeed, useFollowingList, useHeatmapData, useHiddenApps, useHideKeytraceClaim, useHideOrcidPublication, useHideProfileItem, useHideSifaPublication, useHideStandardPublication, useLinkSkillToPosition, useMutuals, useMyRoadmapVotes, useNetworkStreamCount, useProfile, useReactionStatus, useRefreshOrcidPublications, useRefreshPds, useRemoveFeatureAllowlist, useResetProfile, useRetractRoadmapVote, useRoadmapVotes, useSearchFilters, useSearchProfiles, useSetExternalAccountPrimary, useSetPositionPrimary, useSifaConfig, useSimilarProfiles, useSkillSuggestions, useStats, useSuggestionCount, useSuggestions, useUnfollow, useUnhideKeytraceClaim, useUnhideOrcidPublication, useUnhideProfileItem, useUnhideSifaPublication, useUnhideStandardPublication, useUnlinkSkillFromPosition, useUnsetExternalAccountPrimary, useUnsetPositionPrimary, useUpdateEducation, useUpdateExternalAccount, useUpdatePosition, useUpdateProfileLocation, useUpdateProfileOverride, useUpdateProfileSelf, useUpdateRecord, useUpdateSkill, useUploadAvatar, useVerifyExternalAccount, verifyExternalAccount };
+// src/cards/adult-content.ts
+var ADULT_CONTENT_LABELS = ["porn", "sexual", "nudity", "graphic-media"];
+
+// src/query/fetchers/bsky-preferences.ts
+async function fetchBskyContentLabelPrefs(config, options = {}) {
+  const { onNeedsScope, ...fetchOptions } = options;
+  try {
+    const res = await apiFetch(
+      config,
+      "/api/bsky/preferences/content-labels",
+      { credentials: "include", ...fetchOptions }
+    );
+    return res.contentLabels;
+  } catch (err) {
+    if (err && typeof err === "object" && "status" in err && err.status === 403) {
+      onNeedsScope?.();
+    }
+    return null;
+  }
+}
+async function updateBskyContentLabelPrefs(config, body) {
+  const result = await apiWrite(config, "/api/bsky/preferences/content-labels", "PUT", {
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(body)
+  });
+  return result;
+}
+function effectiveContentVisibility(label, prefs, isAuthenticated) {
+  if (!isAuthenticated) return "hide";
+  const value = prefs?.[label] ?? null;
+  return value ?? "hide";
+}
+function shouldGateAdultMedia(labels, prefs, isAuthenticated) {
+  if (!labels || labels.length === 0) return false;
+  for (const label of labels) {
+    if (label.neg) continue;
+    if (!ADULT_CONTENT_LABELS.includes(label.val)) continue;
+    const visibility = effectiveContentVisibility(
+      label.val,
+      prefs,
+      isAuthenticated
+    );
+    if (visibility !== "ignore") return true;
+  }
+  return false;
+}
+function useBskyContentLabelPrefs(options) {
+  const config = useSifaConfig();
+  return useQuery({
+    queryKey: sifaQueryKeys.bskyPreferences.contentLabels(),
+    queryFn: () => fetchBskyContentLabelPrefs(config),
+    // Prefs change rarely; long stale time keeps the gate snappy on
+    // navigation. Invalidation after a write is explicit.
+    staleTime: 5 * 6e4,
+    ...options
+  });
+}
+function useUpdateBskyContentLabelPrefs() {
+  const config = useSifaConfig();
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: (body) => updateBskyContentLabelPrefs(config, body),
+    onSuccess: (result) => {
+      if (result.success && result.contentLabels) {
+        queryClient.setQueryData(
+          sifaQueryKeys.bskyPreferences.contentLabels(),
+          result.contentLabels
+        );
+      } else {
+        void queryClient.invalidateQueries({
+          queryKey: sifaQueryKeys.bskyPreferences.all()
+        });
+      }
+    }
+  });
+}
+
+export { ApiError, HIDDEN_ITEM_SOURCES, HIDDEN_ITEM_TYPES, QUOTED_POSTS_BATCH_MAX, SifaProvider, addFeatureAllowlist, apiFetch, apiFetchOrNull, apiWrite, apiWriteCreate, bulkHideProfileItems, bulkHideStandardPublications, bulkUnhideProfileItems, bulkUnhideStandardPublications, castRoadmapVote, checkAppAccount, checkNetworkMapJobStatus, createEducation, createEndorsement, createExternalAccount, createPosition, createProfileLocation, createReaction, createRecord, createSkill, deleteAccount, deleteAvatarOverride, deleteEducation, deleteExternalAccount, deletePosition, deleteProfileLocation, deleteReaction, deleteRecord, deleteSkill, effectiveContentVisibility, fetchActivityFeed, fetchActivityTeaser, fetchAppsRegistry, fetchAtFundLink, fetchBskyContentLabelPrefs, fetchEndorsementCount, fetchExternalAccounts, fetchFeaturedProfile, fetchFollowing, fetchHeatmapData, fetchHiddenApps, fetchMyRoadmapVotes, fetchNetworkMap, fetchNetworkStreamCount, fetchProfile, fetchReactionStatus, fetchRoadmapVotes, fetchSearchFilters, fetchSearchProfiles, fetchSimilarProfiles, fetchSkillSuggestions, fetchStats, fetchSuggestionCount, fetchSuggestions, followUser, getBlueskySuggestions, getFollowers, getFollowing, getFollowingFeed, getMutuals, hideKeytraceClaim, hideOrcidPublication, hideProfileItem, hideSifaPublication, hideStandardPublication, initiateNetworkMapGeneration, isNetworkMapResponse, linkSkillToPosition, listFeatureAllowlist, refreshOrcidPublications, refreshPds, removeFeatureAllowlist, resetProfile, resolveQuotedPosts, retractRoadmapVote, searchSkills, setExternalAccountPrimary, setPositionPrimary, shouldGateAdultMedia, sifaQueryKeys, unfollowUser, unhideKeytraceClaim, unhideOrcidPublication, unhideProfileItem, unhideSifaPublication, unhideStandardPublication, unlinkSkillFromPosition, unsetExternalAccountPrimary, unsetPositionPrimary, updateBskyContentLabelPrefs, updateEducation, updateExternalAccount, updatePosition, updateProfileLocation, updateProfileOverride, updateProfileSelf, updateRecord, updateSkill, uploadAvatar, useActivityFeed, useActivityTeaser, useAddFeatureAllowlist, useAppAccountCheck, useAppsRegistry, useAtFundLink, useBlueskySuggestions, useBskyContentLabelPrefs, useBulkHideProfileItems, useBulkHideStandardPublications, useBulkUnhideProfileItems, useBulkUnhideStandardPublications, useCanonicalSkillSearch, useCastRoadmapVote, useCreateEducation, useCreateEndorsement, useCreateExternalAccount, useCreatePosition, useCreateProfileLocation, useCreateReaction, useCreateRecord, useCreateSkill, useDeleteAccount, useDeleteAvatarOverride, useDeleteEducation, useDeleteExternalAccount, useDeletePosition, useDeleteProfileLocation, useDeleteReaction, useDeleteRecord, useDeleteSkill, useEndorsementCount, useExternalAccounts, useFeatureAllowlist, useFeaturedProfile, useFollow, useFollowers, useFollowing, useFollowingFeed, useFollowingList, useHeatmapData, useHiddenApps, useHideKeytraceClaim, useHideOrcidPublication, useHideProfileItem, useHideSifaPublication, useHideStandardPublication, useLinkSkillToPosition, useMutuals, useMyRoadmapVotes, useNetworkStreamCount, useProfile, useReactionStatus, useRefreshOrcidPublications, useRefreshPds, useRemoveFeatureAllowlist, useResetProfile, useRetractRoadmapVote, useRoadmapVotes, useSearchFilters, useSearchProfiles, useSetExternalAccountPrimary, useSetPositionPrimary, useSifaConfig, useSimilarProfiles, useSkillSuggestions, useStats, useSuggestionCount, useSuggestions, useUnfollow, useUnhideKeytraceClaim, useUnhideOrcidPublication, useUnhideProfileItem, useUnhideSifaPublication, useUnhideStandardPublication, useUnlinkSkillFromPosition, useUnsetExternalAccountPrimary, useUnsetPositionPrimary, useUpdateBskyContentLabelPrefs, useUpdateEducation, useUpdateExternalAccount, useUpdatePosition, useUpdateProfileLocation, useUpdateProfileOverride, useUpdateProfileSelf, useUpdateRecord, useUpdateSkill, useUploadAvatar, useVerifyExternalAccount, verifyExternalAccount };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map