@singi-labs/sifa-sdk 0.9.11 → 0.9.12

package/dist/query/fetchers/index.d.cts

@@ -716,6 +716,19 @@ interface ResolveQuotedPostsOptions extends ApiFetchOptions {
  */
 declare function resolveQuotedPosts(config: SifaApiConfig, uris: string[], options?: ResolveQuotedPostsOptions): Promise<Record<string, QuotedPostResult>>;
 
+/**
+ * Reachability of an activity card's external destination, as reported by
+ * sifa-api's `/api/activity` enrichment (see sifa-api `url-health-checker`).
+ *
+ *   ok           -- last HEAD returned 2xx/3xx
+ *   broken       -- confirmed dead (>=2 consecutive 4xx, or >=5 consecutive 5xx)
+ *   unverifiable -- 403/429/network error; anti-bot or rate-limited, NOT dead
+ *   unknown      -- newly seen, not yet checked
+ *
+ * Consumers should only suppress UI on `'broken'`. All other values
+ * (including missing) mean "render normally".
+ */
+type ActivityItemLinkHealth = 'ok' | 'broken' | 'unverifiable' | 'unknown';
 interface HeatmapDay {
     date: string;
     total: number;
@@ -754,6 +767,12 @@ interface ActivityItem {
      * Mutually exclusive with `quotedPost`.
      */
     quotedPostUri?: string;
+    /**
+     * Reachability of the card's external destination as last checked by
+     * sifa-api. Undefined for legacy responses; treat as 'unknown'.
+     * See {@link ActivityItemLinkHealth}.
+     */
+    linkHealth?: ActivityItemLinkHealth;
 }
 interface ActivityTeaserResponse {
     items: ActivityItem[];
@@ -1126,4 +1145,4 @@ declare const sifaQueryKeys: {
 };
 type SifaQueryKey = ReturnType<typeof sifaQueryKeys.all> | ReturnType<typeof sifaQueryKeys.profile.all> | ReturnType<typeof sifaQueryKeys.profile.byHandle> | ReturnType<typeof sifaQueryKeys.profile.atFundLink> | ReturnType<typeof sifaQueryKeys.profile.externalAccounts> | ReturnType<typeof sifaQueryKeys.position.all> | ReturnType<typeof sifaQueryKeys.position.byOwner> | ReturnType<typeof sifaQueryKeys.search.all> | ReturnType<typeof sifaQueryKeys.search.profiles> | ReturnType<typeof sifaQueryKeys.search.canonicalSkills> | ReturnType<typeof sifaQueryKeys.search.skills> | ReturnType<typeof sifaQueryKeys.search.filters> | ReturnType<typeof sifaQueryKeys.discovery.all> | ReturnType<typeof sifaQueryKeys.discovery.similar> | ReturnType<typeof sifaQueryKeys.discovery.suggestions> | ReturnType<typeof sifaQueryKeys.discovery.suggestionCount> | ReturnType<typeof sifaQueryKeys.discovery.featured> | ReturnType<typeof sifaQueryKeys.follow.all> | ReturnType<typeof sifaQueryKeys.follow.following> | ReturnType<typeof sifaQueryKeys.stats.all> | ReturnType<typeof sifaQueryKeys.stats.homepage> | ReturnType<typeof sifaQueryKeys.apps.all> | ReturnType<typeof sifaQueryKeys.apps.registry> | ReturnType<typeof sifaQueryKeys.apps.hidden> | ReturnType<typeof sifaQueryKeys.activity.all> | ReturnType<typeof sifaQueryKeys.activity.heatmap> | ReturnType<typeof sifaQueryKeys.activity.teaser> | ReturnType<typeof sifaQueryKeys.activity.feed> | ReturnType<typeof sifaQueryKeys.endorsement.all> | ReturnType<typeof sifaQueryKeys.endorsement.count> | ReturnType<typeof sifaQueryKeys.stream.all> | ReturnType<typeof sifaQueryKeys.stream.networkCount> | ReturnType<typeof sifaQueryKeys.reactions.all> | ReturnType<typeof sifaQueryKeys.reactions.status> | ReturnType<typeof sifaQueryKeys.reactions.accountCheck> | ReturnType<typeof sifaQueryKeys.roadmap.all> | ReturnType<typeof sifaQueryKeys.roadmap.votes> | ReturnType<typeof sifaQueryKeys.roadmap.myVotes>;
 
-export { type AccountCheckResult, type ActivityFeedResponse, type ActivityItem, type ActivityTeaserResponse, ApiError, type ApiFetchOptions, type AppRegistryEntry, type BulkHideProfileItemInput, type CheckAppAccountOptions, type CreateExternalAccountResult, type CreateResult, type DeleteAccountResult, type EndorsementInput, type ExternalAccountInput, type FeaturedProfile, type FetchActivityFeedOptions, type FetchActivityTeaserOptions, type FetchHiddenAppsOptions, type FetchMyRoadmapVotesOptions, type FetchNetworkStreamCountOptions, type FetchReactionStatusOptions, type FetchSuggestionsOptions, type FilterOptions, type FollowProfile, type FollowingResponse, HIDDEN_ITEM_SOURCES, HIDDEN_ITEM_TYPES, type HeatmapDay, type HeatmapResponse, type HiddenApp, type HiddenItemSource, type HiddenItemType, type HideProfileItemInput, type NetworkMapEdge, type NetworkMapGenerationJob, type NetworkMapGraphData, type NetworkMapNode, type NetworkMapPendingJob, type NetworkMapResponse, type ProfileIndustryInput, type ProfileLocationAddress, type ProfileLocationInput, type ProfileSearchResult, type ProfileSelfLocation, QUOTED_POSTS_BATCH_MAX, type QuotedPostAuthor, type QuotedPostImage, type QuotedPostResult, type QuotedPostView, type ReactionError, type ReactionResult, type ReactionStatus, type RefreshOrcidPublicationsResult, type RefreshPdsResult, type ResolveQuotedPostsOptions, type RoadmapVoter, type RoadmapVotesResponse, type SearchFilters, type SearchResponse, type SifaApiConfig, type SifaQueryKey, type SimilarProfile, type SkillSearchResult, type StatsResponse, type SuggestionProfile, type SuggestionsResponse, type UpdateProfileOverrideInput, type UpdateProfileSelfInput, type UploadAvatarResult, type VerifyExternalAccountResult, type WriteResult, 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, hideKeytraceClaim, hideOrcidPublication, hideProfileItem, hideSifaPublication, hideStandardPublication, initiateNetworkMapGeneration, isNetworkMapResponse, linkSkillToPosition, refreshOrcidPublications, refreshPds, resetProfile, resolveQuotedPosts, retractRoadmapVote, searchSkills, setExternalAccountPrimary, setPositionPrimary, sifaQueryKeys, unhideKeytraceClaim, unhideOrcidPublication, unhideProfileItem, unhideSifaPublication, unhideStandardPublication, unlinkSkillFromPosition, unsetExternalAccountPrimary, unsetPositionPrimary, updateEducation, updateExternalAccount, updatePosition, updateProfileLocation, updateProfileOverride, updateProfileSelf, updateRecord, updateSkill, uploadAvatar, verifyExternalAccount };
+export { type AccountCheckResult, type ActivityFeedResponse, type ActivityItem, type ActivityItemLinkHealth, type ActivityTeaserResponse, ApiError, type ApiFetchOptions, type AppRegistryEntry, type BulkHideProfileItemInput, type CheckAppAccountOptions, type CreateExternalAccountResult, type CreateResult, type DeleteAccountResult, type EndorsementInput, type ExternalAccountInput, type FeaturedProfile, type FetchActivityFeedOptions, type FetchActivityTeaserOptions, type FetchHiddenAppsOptions, type FetchMyRoadmapVotesOptions, type FetchNetworkStreamCountOptions, type FetchReactionStatusOptions, type FetchSuggestionsOptions, type FilterOptions, type FollowProfile, type FollowingResponse, HIDDEN_ITEM_SOURCES, HIDDEN_ITEM_TYPES, type HeatmapDay, type HeatmapResponse, type HiddenApp, type HiddenItemSource, type HiddenItemType, type HideProfileItemInput, type NetworkMapEdge, type NetworkMapGenerationJob, type NetworkMapGraphData, type NetworkMapNode, type NetworkMapPendingJob, type NetworkMapResponse, type ProfileIndustryInput, type ProfileLocationAddress, type ProfileLocationInput, type ProfileSearchResult, type ProfileSelfLocation, QUOTED_POSTS_BATCH_MAX, type QuotedPostAuthor, type QuotedPostImage, type QuotedPostResult, type QuotedPostView, type ReactionError, type ReactionResult, type ReactionStatus, type RefreshOrcidPublicationsResult, type RefreshPdsResult, type ResolveQuotedPostsOptions, type RoadmapVoter, type RoadmapVotesResponse, type SearchFilters, type SearchResponse, type SifaApiConfig, type SifaQueryKey, type SimilarProfile, type SkillSearchResult, type StatsResponse, type SuggestionProfile, type SuggestionsResponse, type UpdateProfileOverrideInput, type UpdateProfileSelfInput, type UploadAvatarResult, type VerifyExternalAccountResult, type WriteResult, 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, hideKeytraceClaim, hideOrcidPublication, hideProfileItem, hideSifaPublication, hideStandardPublication, initiateNetworkMapGeneration, isNetworkMapResponse, linkSkillToPosition, refreshOrcidPublications, refreshPds, resetProfile, resolveQuotedPosts, retractRoadmapVote, searchSkills, setExternalAccountPrimary, setPositionPrimary, sifaQueryKeys, unhideKeytraceClaim, unhideOrcidPublication, unhideProfileItem, unhideSifaPublication, unhideStandardPublication, unlinkSkillFromPosition, unsetExternalAccountPrimary, unsetPositionPrimary, updateEducation, updateExternalAccount, updatePosition, updateProfileLocation, updateProfileOverride, updateProfileSelf, updateRecord, updateSkill, uploadAvatar, verifyExternalAccount };

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

@@ -716,6 +716,19 @@ interface ResolveQuotedPostsOptions extends ApiFetchOptions {
  */
 declare function resolveQuotedPosts(config: SifaApiConfig, uris: string[], options?: ResolveQuotedPostsOptions): Promise<Record<string, QuotedPostResult>>;
 
+/**
+ * Reachability of an activity card's external destination, as reported by
+ * sifa-api's `/api/activity` enrichment (see sifa-api `url-health-checker`).
+ *
+ *   ok           -- last HEAD returned 2xx/3xx
+ *   broken       -- confirmed dead (>=2 consecutive 4xx, or >=5 consecutive 5xx)
+ *   unverifiable -- 403/429/network error; anti-bot or rate-limited, NOT dead
+ *   unknown      -- newly seen, not yet checked
+ *
+ * Consumers should only suppress UI on `'broken'`. All other values
+ * (including missing) mean "render normally".
+ */
+type ActivityItemLinkHealth = 'ok' | 'broken' | 'unverifiable' | 'unknown';
 interface HeatmapDay {
     date: string;
     total: number;
@@ -754,6 +767,12 @@ interface ActivityItem {
      * Mutually exclusive with `quotedPost`.
      */
     quotedPostUri?: string;
+    /**
+     * Reachability of the card's external destination as last checked by
+     * sifa-api. Undefined for legacy responses; treat as 'unknown'.
+     * See {@link ActivityItemLinkHealth}.
+     */
+    linkHealth?: ActivityItemLinkHealth;
 }
 interface ActivityTeaserResponse {
     items: ActivityItem[];
@@ -1126,4 +1145,4 @@ declare const sifaQueryKeys: {
 };
 type SifaQueryKey = ReturnType<typeof sifaQueryKeys.all> | ReturnType<typeof sifaQueryKeys.profile.all> | ReturnType<typeof sifaQueryKeys.profile.byHandle> | ReturnType<typeof sifaQueryKeys.profile.atFundLink> | ReturnType<typeof sifaQueryKeys.profile.externalAccounts> | ReturnType<typeof sifaQueryKeys.position.all> | ReturnType<typeof sifaQueryKeys.position.byOwner> | ReturnType<typeof sifaQueryKeys.search.all> | ReturnType<typeof sifaQueryKeys.search.profiles> | ReturnType<typeof sifaQueryKeys.search.canonicalSkills> | ReturnType<typeof sifaQueryKeys.search.skills> | ReturnType<typeof sifaQueryKeys.search.filters> | ReturnType<typeof sifaQueryKeys.discovery.all> | ReturnType<typeof sifaQueryKeys.discovery.similar> | ReturnType<typeof sifaQueryKeys.discovery.suggestions> | ReturnType<typeof sifaQueryKeys.discovery.suggestionCount> | ReturnType<typeof sifaQueryKeys.discovery.featured> | ReturnType<typeof sifaQueryKeys.follow.all> | ReturnType<typeof sifaQueryKeys.follow.following> | ReturnType<typeof sifaQueryKeys.stats.all> | ReturnType<typeof sifaQueryKeys.stats.homepage> | ReturnType<typeof sifaQueryKeys.apps.all> | ReturnType<typeof sifaQueryKeys.apps.registry> | ReturnType<typeof sifaQueryKeys.apps.hidden> | ReturnType<typeof sifaQueryKeys.activity.all> | ReturnType<typeof sifaQueryKeys.activity.heatmap> | ReturnType<typeof sifaQueryKeys.activity.teaser> | ReturnType<typeof sifaQueryKeys.activity.feed> | ReturnType<typeof sifaQueryKeys.endorsement.all> | ReturnType<typeof sifaQueryKeys.endorsement.count> | ReturnType<typeof sifaQueryKeys.stream.all> | ReturnType<typeof sifaQueryKeys.stream.networkCount> | ReturnType<typeof sifaQueryKeys.reactions.all> | ReturnType<typeof sifaQueryKeys.reactions.status> | ReturnType<typeof sifaQueryKeys.reactions.accountCheck> | ReturnType<typeof sifaQueryKeys.roadmap.all> | ReturnType<typeof sifaQueryKeys.roadmap.votes> | ReturnType<typeof sifaQueryKeys.roadmap.myVotes>;
 
-export { type AccountCheckResult, type ActivityFeedResponse, type ActivityItem, type ActivityTeaserResponse, ApiError, type ApiFetchOptions, type AppRegistryEntry, type BulkHideProfileItemInput, type CheckAppAccountOptions, type CreateExternalAccountResult, type CreateResult, type DeleteAccountResult, type EndorsementInput, type ExternalAccountInput, type FeaturedProfile, type FetchActivityFeedOptions, type FetchActivityTeaserOptions, type FetchHiddenAppsOptions, type FetchMyRoadmapVotesOptions, type FetchNetworkStreamCountOptions, type FetchReactionStatusOptions, type FetchSuggestionsOptions, type FilterOptions, type FollowProfile, type FollowingResponse, HIDDEN_ITEM_SOURCES, HIDDEN_ITEM_TYPES, type HeatmapDay, type HeatmapResponse, type HiddenApp, type HiddenItemSource, type HiddenItemType, type HideProfileItemInput, type NetworkMapEdge, type NetworkMapGenerationJob, type NetworkMapGraphData, type NetworkMapNode, type NetworkMapPendingJob, type NetworkMapResponse, type ProfileIndustryInput, type ProfileLocationAddress, type ProfileLocationInput, type ProfileSearchResult, type ProfileSelfLocation, QUOTED_POSTS_BATCH_MAX, type QuotedPostAuthor, type QuotedPostImage, type QuotedPostResult, type QuotedPostView, type ReactionError, type ReactionResult, type ReactionStatus, type RefreshOrcidPublicationsResult, type RefreshPdsResult, type ResolveQuotedPostsOptions, type RoadmapVoter, type RoadmapVotesResponse, type SearchFilters, type SearchResponse, type SifaApiConfig, type SifaQueryKey, type SimilarProfile, type SkillSearchResult, type StatsResponse, type SuggestionProfile, type SuggestionsResponse, type UpdateProfileOverrideInput, type UpdateProfileSelfInput, type UploadAvatarResult, type VerifyExternalAccountResult, type WriteResult, 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, hideKeytraceClaim, hideOrcidPublication, hideProfileItem, hideSifaPublication, hideStandardPublication, initiateNetworkMapGeneration, isNetworkMapResponse, linkSkillToPosition, refreshOrcidPublications, refreshPds, resetProfile, resolveQuotedPosts, retractRoadmapVote, searchSkills, setExternalAccountPrimary, setPositionPrimary, sifaQueryKeys, unhideKeytraceClaim, unhideOrcidPublication, unhideProfileItem, unhideSifaPublication, unhideStandardPublication, unlinkSkillFromPosition, unsetExternalAccountPrimary, unsetPositionPrimary, updateEducation, updateExternalAccount, updatePosition, updateProfileLocation, updateProfileOverride, updateProfileSelf, updateRecord, updateSkill, uploadAvatar, verifyExternalAccount };
+export { type AccountCheckResult, type ActivityFeedResponse, type ActivityItem, type ActivityItemLinkHealth, type ActivityTeaserResponse, ApiError, type ApiFetchOptions, type AppRegistryEntry, type BulkHideProfileItemInput, type CheckAppAccountOptions, type CreateExternalAccountResult, type CreateResult, type DeleteAccountResult, type EndorsementInput, type ExternalAccountInput, type FeaturedProfile, type FetchActivityFeedOptions, type FetchActivityTeaserOptions, type FetchHiddenAppsOptions, type FetchMyRoadmapVotesOptions, type FetchNetworkStreamCountOptions, type FetchReactionStatusOptions, type FetchSuggestionsOptions, type FilterOptions, type FollowProfile, type FollowingResponse, HIDDEN_ITEM_SOURCES, HIDDEN_ITEM_TYPES, type HeatmapDay, type HeatmapResponse, type HiddenApp, type HiddenItemSource, type HiddenItemType, type HideProfileItemInput, type NetworkMapEdge, type NetworkMapGenerationJob, type NetworkMapGraphData, type NetworkMapNode, type NetworkMapPendingJob, type NetworkMapResponse, type ProfileIndustryInput, type ProfileLocationAddress, type ProfileLocationInput, type ProfileSearchResult, type ProfileSelfLocation, QUOTED_POSTS_BATCH_MAX, type QuotedPostAuthor, type QuotedPostImage, type QuotedPostResult, type QuotedPostView, type ReactionError, type ReactionResult, type ReactionStatus, type RefreshOrcidPublicationsResult, type RefreshPdsResult, type ResolveQuotedPostsOptions, type RoadmapVoter, type RoadmapVotesResponse, type SearchFilters, type SearchResponse, type SifaApiConfig, type SifaQueryKey, type SimilarProfile, type SkillSearchResult, type StatsResponse, type SuggestionProfile, type SuggestionsResponse, type UpdateProfileOverrideInput, type UpdateProfileSelfInput, type UploadAvatarResult, type VerifyExternalAccountResult, type WriteResult, 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, hideKeytraceClaim, hideOrcidPublication, hideProfileItem, hideSifaPublication, hideStandardPublication, initiateNetworkMapGeneration, isNetworkMapResponse, linkSkillToPosition, refreshOrcidPublications, refreshPds, resetProfile, resolveQuotedPosts, retractRoadmapVote, searchSkills, setExternalAccountPrimary, setPositionPrimary, sifaQueryKeys, unhideKeytraceClaim, unhideOrcidPublication, unhideProfileItem, unhideSifaPublication, unhideStandardPublication, unlinkSkillFromPosition, unsetExternalAccountPrimary, unsetPositionPrimary, updateEducation, updateExternalAccount, updatePosition, updateProfileLocation, updateProfileOverride, updateProfileSelf, updateRecord, updateSkill, uploadAvatar, verifyExternalAccount };