@singi-labs/sifa-sdk 0.19.6 → 0.19.7

package/dist/index.cjs

@@ -6447,7 +6447,7 @@ function describeSifaRecord(collection, value) {
 }
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.19.6";
+var SIFA_SDK_VERSION = "0.19.7";
 
 exports.ACTIVITY_TIERS = ACTIVITY_TIERS;
 exports.ACTIVITY_VERBS = ACTIVITY_VERBS;

package/dist/index.js

@@ -6445,7 +6445,7 @@ function describeSifaRecord(collection, value) {
 }
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.19.6";
+var SIFA_SDK_VERSION = "0.19.7";
 
 export { ACTIVITY_TIERS, ACTIVITY_VERBS, ACTIVITY_VISIBILITY_RULES, ADULT_CONTENT_LABELS, ALL_SECTIONS, APP_CATEGORIES, APP_CATEGORY_IDS, APP_CATEGORY_MAP, APP_URL_PATTERNS, ARTIFACT_LINK_KIND_LABELS, ARTIFACT_LINK_KIND_OPTIONS, ArtifactLinkSchema, AtmosphereFeedItemSchema, BlobRefSchema, CALENDAR_EVENT_MODE_LABELS, CALENDAR_EVENT_STATUS_LABELS, CATEGORY_LABELS, CATEGORY_ORDER, COLLECTION_TO_APP, COMPANY_OPTIONAL_EMPLOYMENT_TYPES, COMPANY_PAGE_MIN_FIRMOGRAPHIC_FIELDS, COMPLETENESS_MAX_SCORE, CONTINENTS, COUNTRIES, DIMENSIONS_MAX_SCORE, EMPLOYMENT_TYPE_GROUPS, EMPLOYMENT_TYPE_LABELS, ENTITY_REF_ANCHORS, EndorsementConfirmationRecordSchema, EndorsementRecordSchema, EntityImportSearchResponseSchema, EntityMintDomainResponseSchema, EntityResolveDomainRequestSchema, EntityResolveDomainResponseSchema, EntitySearchResponseSchema, EntitySearchResultSchema, EntitySelectRequestSchema, EntitySelectResponseSchema, FEATURE_FLAGS, FeatureAllowlistEntrySchema, FeedActorSchema, FollowFeedItemSchema, FollowFeedPageSchema, FollowProfilePageSchema, FollowProfileSchema, GraphFollowRecordSchema, INDUSTRY_OPTIONS, INVESTMENT_ROLE_LABELS, INVESTMENT_ROLE_OPTIONS, INVESTMENT_STAGE_LABELS, INVESTMENT_STAGE_OPTIONS, INVESTMENT_STATUS_LABELS, INVESTMENT_STATUS_OPTIONS, INVOLVEMENT_HEADING_ORDER, INVOLVEMENT_KIND_HEADINGS, INVOLVEMENT_KIND_LABELS, INVOLVEMENT_KIND_OPTIONS, InvestmentAmountSchema, MIN_SKILLS, ON_BEHALF_OF_EMPLOYMENT_TYPES, OPEN_TO_OPTIONS, OPEN_TO_TOKENS, OPEN_TO_TOKEN_TO_VALUE, OPEN_TO_VALUE_TO_TOKEN, OrgEmploymentAttestationRecordSchema, OrgProfileRecordSchema, PLATFORM_LABELS, PLATFORM_OPTIONS, PRESENTATION_LINK_TYPE_LABELS, PRESENTATION_LINK_TYPE_OPTIONS, PRESENTATION_ROLE_LABELS, PRESENTATION_ROLE_OPTIONS, PROFILE_INVESTMENT_NSID, PROFILE_INVOLVEMENT_NSID, PROJECT_ROLES, PUBLICATION_TYPE_LABELS, PUBLICATION_TYPE_OPTIONS, PUBLISHERS, PresentationDurationSchema, PresentationLinkSchema, ProfileCertificationRecordSchema, ProfileCourseRecordSchema, ProfileEducationRecordSchema, ProfileExternalAccountRecordSchema, ProfileHonorRecordSchema, ProfileInvestmentRecordSchema, ProfileInvolvementRecordSchema, ProfileLanguageRecordSchema, ProfilePositionRecordSchema, ProfilePresentationDeliveryRecordSchema, ProfilePresentationRecordSchema, ProfileProjectRecordSchema, ProfilePublicationRecordSchema, ProfileSelfRecordSchema, ProfileSkillRecordSchema, ProfileVolunteeringRecordSchema, PublicationAuthorSchema, ROADMAP_ISSUES_REPO, ROADMAP_ITEM_META, SECTION_GROUPS, SECTION_LABELS, SELF_APP_ID, SIFA_REPO_GROUPS, SIFA_SDK_VERSION, SKILL_CATEGORIES, STANDARD_PUBLISHER_ID, STREAM_VERBS, SifaFeedItemSchema, VERIFICATION_PROVIDERS, WORKPLACE_TYPE_LABELS, WORKPLACE_TYPE_OPTIONS, actorShowsIdentity, agentRefSchema, atUriSchema, buildMetaDescription, buildProfileHighlights, buildTalkSlug, categoryForApp, certDateExtractor, cidSchema, classifyEntityRef, completenessPercent, completenessScore, contrastRatio, countFilledDimensions, countRecentActivity, countryCodeToFlag, dateRangeExtractor, datetimeSchema, decodeFeedCursor, dedupeSkills, describeSifaRecord, detectPdsProvider, didSchema, dimensionsFromInputs, durationFromMinutes, encodeFeedCursor, entityDisambiguationLabel, entityResultKey, excludeSelfApp, externalRecordRefSchema, filterHidden, findIndustry, formatCompanyName, formatDateRange, formatDisplayUrl, formatDistanceToNow, formatEventDate, formatLocation, formatPresentationDuration, formatRelativeTime, formatSingleDate, formatSpanDate, formatTimelineDate, getActivityTaxonomyVersion, getActivityTier, getActivityVerbsVersion, getAppCategoryIcon, getAppIdForCollection, getArtifactLinkKindLabel, getCalendarEventModeLabel, getCalendarEventStatusLabel, getContinent, getDisplayLabel, getEmploymentTypeLabel, getFaviconUrl, getFilledDimensionsMap, getHandleStem, getIndustryLabelKey, getInvestmentRoleLabel, getInvestmentStageLabel, getInvestmentStatusLabel, getInvolvementKindHeading, getInvolvementKindLabel, getLexiconEntry, getOpenToLabelKey, getPdsDisplayName, getPlatformLabel, getPresentationLinkTypeLabel, getPresentationRoleLabel, getPublicationTypeLabel, getPublisherByHost, getPublisherById, getPublisherFromSiteUrl, getTierMeta, getVerificationProvider, getVisibleSectionIds, getWorkplaceTypeLabel, groupInvolvementByHeading, groupSkillsByCategory, groupSkillsBySubCategory, groupSkillsForDisplay, hasAdultContent, hasPersonalProfileContent, hoistPrimary, isAppCategory, isCompanyPageIndexable, isCompanyRequired, isKnownAppId, isKnownPlatform, isKnownVerificationProvider, isLinked, isOnBehalfOfApplicable, isPseudoEmployer, isRegistrableDomainHandle, isRoleLineRedundant, isSectionPopulated, isValidRgbColor, isVisibleActivityItem, languageTagSchema, lexiconDateExtractor, limitCombiningMarks, locationSegments, looksLikeDomain, makeGraphFollowRecordSchema, maxGraphemes, meetsContrastAA, normalizeCompanyKey, normalizeDoi, normalizeLegalForm, normalizeOpenTo, normalizePlatformId, normalizePresentationMode, normalizePresentationRole, normalizeSkillCategory, normalizeWorkplaceTypes, openToTokenToValue, openToValueToToken, parseIntendedAudiences, parseLocationString, parsePresentationDuration, parseTalkRkey, partialDateSchema, pdsProviderFromApi, pickPrimaryFlagged, pickPrimaryPosition, presentationCsvRowToRecord, presentationDeliveryCsvRowToRecord, primaryVerification, profileToDimensionInputs, qualifiesAsOrg, relativeLuminance, rendersCompanyProfile, rendersPersonalProfile, repoGroupForCollection, resolveAccountFacetMode, resolveAgentRef, resolveCardHealth, resolveCardUrl, resolveEmbed, resolveVerifierProvider, rgbToString, roadmapIssueUrl, sanitizeDisplayText, sanitizeHandleInput, searchResultDisambiguation, selfLabelsSchema, shouldRenderHighlights, singleDateExtractor, skillRefSchema, slugifyTitle, sortByActiveDateRange, sortByDateDesc, sortCertifications, sortEducation, sortHonors, sortLanguages, sortLanguagesByProficiency, sortPositions, sortProjects, sortPublications, streamAddressSchema, streamAuthorSchema, streamCardBodySchema, streamCardSubjectSchema, streamCardVMSchema, streamExternalLinkSchema, streamGeoSchema, streamMediaSchema, streamRichSegmentSchema, streamSourceSchema, streamThemeSchema, streamVerbSchema, stripHtmlToText, strongRefSchema, summarizePresentationDeliveries, summarizeProfileView, toStreamCardVM, toStreamCardVMs, truncateGraphemes, uriSchema, verbForCollection, visibleItems, youtubeThumbnailUrl, youtubeVideoId };
 //# sourceMappingURL=index.js.map

package/dist/{network-map-ZV2UJZ3c.d.ts → network-map-BXpm9LIk.d.ts}

@@ -1,5 +1,5 @@
 import { c as Profile, d as ProfilePosition, S as SkillRef, w as PresentationLinkView } from './index-HgcjpMWO.js';
-import { S as SifaApiConfig, A as ApiFetchOptions, C as CreateResult, W as WriteResult } from './org-CvJVOYuN.js';
+import { S as SifaApiConfig, A as ApiFetchOptions, C as CreateResult, W as WriteResult } from './org-H2bPqXeC.js';
 import { n as ProfileView } from './types-CX9OttHr.js';
 import { S as SummarizeProfileViewOptions, P as ProfileSummary } from './profile-summary-FpWgNDBB.js';
 import { i as EntitySearchResponse, E as EntitySearchResult, c as EntityMintDomainResponse, g as EntityResolveDomainResponse, l as EntitySelectRequest, n as EntitySelectResponse } from './follow-profile-D1l6pulB.js';

package/dist/{network-map-DtmFGMeM.d.cts → network-map-DUIEbJf9.d.cts}

@@ -1,5 +1,5 @@
 import { c as Profile, d as ProfilePosition, S as SkillRef, w as PresentationLinkView } from './index-DDlGa7CO.cjs';
-import { S as SifaApiConfig, A as ApiFetchOptions, C as CreateResult, W as WriteResult } from './org-eHZkLNx1.cjs';
+import { S as SifaApiConfig, A as ApiFetchOptions, C as CreateResult, W as WriteResult } from './org-Bfrfa9sD.cjs';
 import { n as ProfileView } from './types-D1Nt3rqN.cjs';
 import { S as SummarizeProfileViewOptions, P as ProfileSummary } from './profile-summary-Cv8TmIe0.cjs';
 import { i as EntitySearchResponse, E as EntitySearchResult, c as EntityMintDomainResponse, g as EntityResolveDomainResponse, l as EntitySelectRequest, n as EntitySelectResponse } from './follow-profile-D1l6pulB.cjs';

package/dist/{org-eHZkLNx1.d.cts → org-Bfrfa9sD.d.cts}

@@ -1290,17 +1290,48 @@ interface FetchFollowListOptions extends ApiFetchOptions {
 declare function getFollowers(config: SifaApiConfig, handle: string, opts?: FetchFollowListOptions): Promise<FollowListPage>;
 /** Paginated list of who `handle` follows. */
 declare function getFollowing(config: SifaApiConfig, handle: string, opts?: FetchFollowListOptions): Promise<FollowListPage>;
+/** One app the viewer's network is active on, for the feed's source tabs. */
+interface FollowingFeedApp {
+    /** Registry app id, e.g. `tangled`. Pass back as {@link FetchFollowingFeedOptions.app}. */
+    id: string;
+    name: string;
+    /** Summed recent activity across the network; the tab ordering. */
+    count: number;
+}
+/**
+ * Why a following-feed page came back empty. Lets a client say something true
+ * per case instead of one catch-all sentence, and point at the right next step.
+ */
+type FollowingFeedEmptyReason = 'no_follows' | 'no_visible_follows' | 'no_cross_app_activity' | 'no_recent_records' | 'all_hidden' | 'nothing_renderable' | 'hydration_failed';
 /** Options for {@link fetchFollowingFeed}. */
 interface FetchFollowingFeedOptions extends ApiFetchOptions {
     limit?: number;
     /**
      * Opt in to the viewer's Bluesky activity too. Off by default: the point of
      * the feed is what connections do on OTHER apps.
+     *
+     * Ignored when {@link app} is set, since a source tab selects one app.
      */
     includeBluesky?: boolean;
+    /**
+     * Restrict the page to one app (a registry id from the response's `apps`).
+     * This is what a source tab selects. `app: 'bluesky'` selects Bluesky even
+     * though it is excluded from the default mixed view.
+     */
+    app?: string;
     /** Forward a `Cookie` header on Next.js RSC server-side calls (web). */
     cookieHeader?: string;
 }
+/** The following feed's response: an activity feed plus its tab metadata. */
+interface FollowingFeedResponse extends ActivityFeedResponse {
+    /**
+     * Apps the viewer's network is actually active on, most active first.
+     * Present on empty pages too, so a client's tabs survive a quiet tab.
+     */
+    apps?: FollowingFeedApp[];
+    /** Set only when `items` is empty. */
+    reason?: FollowingFeedEmptyReason;
+}
 /**
  * The viewer's cross-app following feed: what OTHER apps their connections use
  * (Tangled, WhiteWind, Smoke Signal, ...) — Bluesky is excluded server-side by
@@ -1312,7 +1343,7 @@ interface FetchFollowingFeedOptions extends ApiFetchOptions {
  * session cookie (`credentials: 'include'`). Returns `null` on error. v1 is a
  * finite first page (no cursor yet).
  */
-declare function fetchFollowingFeed(config: SifaApiConfig, opts?: FetchFollowingFeedOptions): Promise<ActivityFeedResponse | null>;
+declare function fetchFollowingFeed(config: SifaApiConfig, opts?: FetchFollowingFeedOptions): Promise<FollowingFeedResponse | null>;
 
 /**
  * Options shared by the cursor-paginated follow-graph endpoints introduced in
@@ -1938,4 +1969,4 @@ declare function addOrgNotificationEmail(config: SifaApiConfig, body: OrgNotific
  */
 declare function removeOrgNotificationEmail(config: SifaApiConfig, body: OrgNotificationEmailRequestInput, options?: Omit<ApiFetchOptions, 'method' | 'body'>): Promise<WriteResult & Partial<OrgNotificationEmailRemoveResult>>;
 
-export { HIDDEN_ITEM_SOURCES as $, type ApiFetchOptions as A, type BulkHideProfileItemInput as B, type CreateResult as C, type DeleteAccountResult as D, type EndorsementInput as E, type FeatureAllowlistResponse as F, type FetchFollowingFeedOptions as G, type FetchHiddenActivityItemsOptions as H, type FetchHiddenAppsOptions as I, type FetchInboxCountsOptions as J, type FetchMyGithubPullRequestsOptions as K, type FetchMyRoadmapVotesOptions as L, type FetchProfileCompletenessOptions as M, type FetchReactionStatusOptions as N, type FetchSuggestionsOptions as O, type FetchUnlinkedPositionsOptions as P, type FilterOptions as Q, type FollowListPage as R, type SifaApiConfig as S, type FollowProfile as T, type FollowProfilePageResponse as U, type FollowUserResult as V, type WriteResult as W, type FollowingResponse as X, type GetAdminReviewQueuesOptions as Y, type GithubPullRequest as Z, type GivenConfirmation as _, type ConfirmEndorsementInput as a, type UploadAvatarResult as a$, HIDDEN_ITEM_TYPES as a0, type HeatmapDay as a1, type HeatmapResponse as a2, type HiddenActivityItem as a3, type HiddenApp as a4, type HiddenItemSource as a5, type HiddenItemType as a6, type HideActivityItemInput as a7, type HideProfileItemInput as a8, type InboxCounts as a9, type QuotedPostView as aA, type ReactionError as aB, type ReactionResult as aC, type ReactionStatus as aD, type RefreshOrcidPublicationsResult as aE, type RefreshPdsResult as aF, type RepoDeleteInput as aG, type ResetProfileResult as aH, type ResolveQuotedPostsOptions as aI, type RoadmapVoteError as aJ, type RoadmapVoteResult as aK, type RoadmapVoter as aL, type RoadmapVotesResponse as aM, type SearchFilters as aN, type SearchResponse as aO, type SifaQueryKey as aP, type SimilarProfile as aQ, type SkillSearchResult as aR, type StatsResponse as aS, type SubCategoryBulkResult as aT, type SuggestionProfile as aU, type SuggestionsResponse as aV, type UnhideActivityItemInput as aW, type UnlinkedPosition as aX, type UnlinkedPositionsResult as aY, type UpdateProfileOverrideInput as aZ, type UpdateProfileSelfInput as a_, type ListFeatureAllowlistOptions as aa, type MyGithubPullRequestsResponse as ab, type OrgClaimBinding as ac, type OrgClaimResult as ad, type OrgDomainChallengeResult as ae, type OrgDomainVerifyResult as af, type OrgNotificationEmailAddResult as ag, type OrgNotificationEmailRemoveResult as ah, type OrgProfileEcho as ai, type OrgProfileUpdateResult as aj, PROFILE_COMPLETENESS_SIGNALS as ak, type PdsWipeOutcome as al, type PendingConfirmation as am, type PendingConfirmationsPage as an, type PrimarySection as ao, type ProfileCompleteness as ap, type ProfileCompletenessSignal as aq, type ProfileIndustryInput as ar, type ProfileLocationAddress as as, type ProfileLocationInput as at, type ProfileSearchResult as au, type ProfileSelfLocation as av, QUOTED_POSTS_BATCH_MAX as aw, type QuotedPostAuthor as ax, type QuotedPostImage as ay, type QuotedPostResult as az, type ConfirmEndorsementResult as b, getBlueskySuggestions as b$, type UploadPronunciationAudioResult as b0, type VerifyExternalAccountResult as b1, type WipePreview as b2, addFeatureAllowlist as b3, addOrgNotificationEmail as b4, apiFetch as b5, apiFetchOrNull as b6, apiWrite as b7, apiWriteCreate as b8, bulkHideProfileItems as b9, fetchExternalAccounts as bA, fetchFeaturedProfile as bB, fetchFollowing as bC, fetchFollowingFeed as bD, fetchGivenConfirmations as bE, fetchHeatmapData as bF, fetchHiddenActivityItems as bG, fetchHiddenApps as bH, fetchInboxCounts as bI, fetchMyGithubPullRequests as bJ, fetchMyRoadmapVotes as bK, fetchPendingConfirmations as bL, fetchProfileCompleteness as bM, fetchReactionStatus as bN, fetchRepoInventory as bO, fetchRoadmapVotes as bP, fetchSearchFilters as bQ, fetchSearchProfiles as bR, fetchSimilarProfiles as bS, fetchSkillSuggestions as bT, fetchStats as bU, fetchSuggestionCount as bV, fetchSuggestions as bW, fetchUnlinkedPositions as bX, fetchWipePreview as bY, followUser as bZ, getAdminReviewQueues as b_, bulkHideStandardPublications as ba, bulkUnhideProfileItems as bb, bulkUnhideStandardPublications as bc, castRoadmapVote as bd, checkAppAccount as be, confirmEndorsement as bf, createConfirmation as bg, createEndorsement as bh, createExternalAccount as bi, createProfileLocation as bj, createReaction as bk, createSkill as bl, deleteAccount as bm, deleteAvatarOverride as bn, deleteExternalAccount as bo, deleteNamePronunciationAudio as bp, deleteProfileLocation as bq, deleteReaction as br, deleteRepoRecords as bs, deleteSkill as bt, dismissConfirmation as bu, dismissUnlinkedPosition as bv, fetchAccounts as bw, fetchActivityFeed as bx, fetchActivityTeaser as by, fetchAppsRegistry as bz, type AccountCheckResult as c, getFollowers as c0, getFollowing as c1, getMutuals as c2, hideActivityItem as c3, hideOrcidPublication as c4, hideProfileItem as c5, hideSifaPublication as c6, hideStandardPublication as c7, listFeatureAllowlist as c8, refreshOrcidPublications as c9, updateProfileSelf as cA, updateSkill as cB, updateSkillSubCategories as cC, uploadAvatar as cD, uploadNamePronunciationAudio as cE, verifyExternalAccount as cF, verifyOrgDomain as cG, type CompanySearchFilters as cH, type CompanySearchResponse as cI, type CompanySearchResult as cJ, fetchSearchCompanies as cK, refreshPds as ca, removeFeatureAllowlist as cb, removeOrgNotificationEmail as cc, repoExportUrl as cd, requestOrgDomainChallenge as ce, resetProfile as cf, resolveQuotedPosts as cg, retractRoadmapVote as ch, revokeConfirmation as ci, searchSkills as cj, setExternalAccountPrimary as ck, setSectionPrimary as cl, submitOrgClaim as cm, switchAccount as cn, unfollowUser as co, unhideActivityItem as cp, unhideOrcidPublication as cq, unhideProfileItem as cr, unhideSifaPublication as cs, unhideStandardPublication as ct, unsetExternalAccountPrimary as cu, unsetSectionPrimary as cv, updateExternalAccount as cw, updateOrgProfile as cx, updateProfileLocation as cy, updateProfileOverride as cz, type AccountSummary as d, type ActivityFeedResponse as e, type ActivityItem as f, type ActivityItemLinkHealth as g, type ActivityTeaserResponse as h, type AdminReviewQueues as i, ApiError as j, type AppRegistryEntry as k, type CastRoadmapVoteResult as l, type CheckAppAccountOptions as m, type ConfirmationInput as n, type ConfirmationSubjectInput as o, type CreateExternalAccountResult as p, type DismissUnlinkedPositionInput as q, type ExternalAccountInput as r, sifaQueryKeys as s, type FeaturedProfile as t, type FetchAccountsOptions as u, type FetchActivityFeedOptions as v, type FetchActivityTeaserOptions as w, type FetchConfirmationsOptions as x, type FetchFollowListOptions as y, type FetchFollowProfilePageOptions as z };
+export { type GetAdminReviewQueuesOptions as $, type ApiFetchOptions as A, type BulkHideProfileItemInput as B, type CreateResult as C, type DeleteAccountResult as D, type EndorsementInput as E, type FeatureAllowlistResponse as F, type FetchFollowingFeedOptions as G, type FetchHiddenActivityItemsOptions as H, type FetchHiddenAppsOptions as I, type FetchInboxCountsOptions as J, type FetchMyGithubPullRequestsOptions as K, type FetchMyRoadmapVotesOptions as L, type FetchProfileCompletenessOptions as M, type FetchReactionStatusOptions as N, type FetchSuggestionsOptions as O, type FetchUnlinkedPositionsOptions as P, type FilterOptions as Q, type FollowListPage as R, type SifaApiConfig as S, type FollowProfile as T, type FollowProfilePageResponse as U, type FollowUserResult as V, type WriteResult as W, type FollowingFeedApp as X, type FollowingFeedEmptyReason as Y, type FollowingFeedResponse as Z, type FollowingResponse as _, type ConfirmEndorsementInput as a, type UnlinkedPositionsResult as a$, type GithubPullRequest as a0, type GivenConfirmation as a1, HIDDEN_ITEM_SOURCES as a2, HIDDEN_ITEM_TYPES as a3, type HeatmapDay as a4, type HeatmapResponse as a5, type HiddenActivityItem as a6, type HiddenApp as a7, type HiddenItemSource as a8, type HiddenItemType as a9, type QuotedPostAuthor as aA, type QuotedPostImage as aB, type QuotedPostResult as aC, type QuotedPostView as aD, type ReactionError as aE, type ReactionResult as aF, type ReactionStatus as aG, type RefreshOrcidPublicationsResult as aH, type RefreshPdsResult as aI, type RepoDeleteInput as aJ, type ResetProfileResult as aK, type ResolveQuotedPostsOptions as aL, type RoadmapVoteError as aM, type RoadmapVoteResult as aN, type RoadmapVoter as aO, type RoadmapVotesResponse as aP, type SearchFilters as aQ, type SearchResponse as aR, type SifaQueryKey as aS, type SimilarProfile as aT, type SkillSearchResult as aU, type StatsResponse as aV, type SubCategoryBulkResult as aW, type SuggestionProfile as aX, type SuggestionsResponse as aY, type UnhideActivityItemInput as aZ, type UnlinkedPosition as a_, type HideActivityItemInput as aa, type HideProfileItemInput as ab, type InboxCounts as ac, type ListFeatureAllowlistOptions as ad, type MyGithubPullRequestsResponse as ae, type OrgClaimBinding as af, type OrgClaimResult as ag, type OrgDomainChallengeResult as ah, type OrgDomainVerifyResult as ai, type OrgNotificationEmailAddResult as aj, type OrgNotificationEmailRemoveResult as ak, type OrgProfileEcho as al, type OrgProfileUpdateResult as am, PROFILE_COMPLETENESS_SIGNALS as an, type PdsWipeOutcome as ao, type PendingConfirmation as ap, type PendingConfirmationsPage as aq, type PrimarySection as ar, type ProfileCompleteness as as, type ProfileCompletenessSignal as at, type ProfileIndustryInput as au, type ProfileLocationAddress as av, type ProfileLocationInput as aw, type ProfileSearchResult as ax, type ProfileSelfLocation as ay, QUOTED_POSTS_BATCH_MAX as az, type ConfirmEndorsementResult as b, fetchWipePreview as b$, type UpdateProfileOverrideInput as b0, type UpdateProfileSelfInput as b1, type UploadAvatarResult as b2, type UploadPronunciationAudioResult as b3, type VerifyExternalAccountResult as b4, type WipePreview as b5, addFeatureAllowlist as b6, addOrgNotificationEmail as b7, apiFetch as b8, apiFetchOrNull as b9, fetchActivityFeed as bA, fetchActivityTeaser as bB, fetchAppsRegistry as bC, fetchExternalAccounts as bD, fetchFeaturedProfile as bE, fetchFollowing as bF, fetchFollowingFeed as bG, fetchGivenConfirmations as bH, fetchHeatmapData as bI, fetchHiddenActivityItems as bJ, fetchHiddenApps as bK, fetchInboxCounts as bL, fetchMyGithubPullRequests as bM, fetchMyRoadmapVotes as bN, fetchPendingConfirmations as bO, fetchProfileCompleteness as bP, fetchReactionStatus as bQ, fetchRepoInventory as bR, fetchRoadmapVotes as bS, fetchSearchFilters as bT, fetchSearchProfiles as bU, fetchSimilarProfiles as bV, fetchSkillSuggestions as bW, fetchStats as bX, fetchSuggestionCount as bY, fetchSuggestions as bZ, fetchUnlinkedPositions as b_, apiWrite as ba, apiWriteCreate as bb, bulkHideProfileItems as bc, bulkHideStandardPublications as bd, bulkUnhideProfileItems as be, bulkUnhideStandardPublications as bf, castRoadmapVote as bg, checkAppAccount as bh, confirmEndorsement as bi, createConfirmation as bj, createEndorsement as bk, createExternalAccount as bl, createProfileLocation as bm, createReaction as bn, createSkill as bo, deleteAccount as bp, deleteAvatarOverride as bq, deleteExternalAccount as br, deleteNamePronunciationAudio as bs, deleteProfileLocation as bt, deleteReaction as bu, deleteRepoRecords as bv, deleteSkill as bw, dismissConfirmation as bx, dismissUnlinkedPosition as by, fetchAccounts as bz, type AccountCheckResult as c, followUser as c0, getAdminReviewQueues as c1, getBlueskySuggestions as c2, getFollowers as c3, getFollowing as c4, getMutuals as c5, hideActivityItem as c6, hideOrcidPublication as c7, hideProfileItem as c8, hideSifaPublication as c9, updateOrgProfile as cA, updateProfileLocation as cB, updateProfileOverride as cC, updateProfileSelf as cD, updateSkill as cE, updateSkillSubCategories as cF, uploadAvatar as cG, uploadNamePronunciationAudio as cH, verifyExternalAccount as cI, verifyOrgDomain as cJ, type CompanySearchFilters as cK, type CompanySearchResponse as cL, type CompanySearchResult as cM, fetchSearchCompanies as cN, hideStandardPublication as ca, listFeatureAllowlist as cb, refreshOrcidPublications as cc, refreshPds as cd, removeFeatureAllowlist as ce, removeOrgNotificationEmail as cf, repoExportUrl as cg, requestOrgDomainChallenge as ch, resetProfile as ci, resolveQuotedPosts as cj, retractRoadmapVote as ck, revokeConfirmation as cl, searchSkills as cm, setExternalAccountPrimary as cn, setSectionPrimary as co, submitOrgClaim as cp, switchAccount as cq, unfollowUser as cr, unhideActivityItem as cs, unhideOrcidPublication as ct, unhideProfileItem as cu, unhideSifaPublication as cv, unhideStandardPublication as cw, unsetExternalAccountPrimary as cx, unsetSectionPrimary as cy, updateExternalAccount as cz, type AccountSummary as d, type ActivityFeedResponse as e, type ActivityItem as f, type ActivityItemLinkHealth as g, type ActivityTeaserResponse as h, type AdminReviewQueues as i, ApiError as j, type AppRegistryEntry as k, type CastRoadmapVoteResult as l, type CheckAppAccountOptions as m, type ConfirmationInput as n, type ConfirmationSubjectInput as o, type CreateExternalAccountResult as p, type DismissUnlinkedPositionInput as q, type ExternalAccountInput as r, sifaQueryKeys as s, type FeaturedProfile as t, type FetchAccountsOptions as u, type FetchActivityFeedOptions as v, type FetchActivityTeaserOptions as w, type FetchConfirmationsOptions as x, type FetchFollowListOptions as y, type FetchFollowProfilePageOptions as z };

package/dist/{org-CvJVOYuN.d.ts → org-H2bPqXeC.d.ts}

@@ -1290,17 +1290,48 @@ interface FetchFollowListOptions extends ApiFetchOptions {
 declare function getFollowers(config: SifaApiConfig, handle: string, opts?: FetchFollowListOptions): Promise<FollowListPage>;
 /** Paginated list of who `handle` follows. */
 declare function getFollowing(config: SifaApiConfig, handle: string, opts?: FetchFollowListOptions): Promise<FollowListPage>;
+/** One app the viewer's network is active on, for the feed's source tabs. */
+interface FollowingFeedApp {
+    /** Registry app id, e.g. `tangled`. Pass back as {@link FetchFollowingFeedOptions.app}. */
+    id: string;
+    name: string;
+    /** Summed recent activity across the network; the tab ordering. */
+    count: number;
+}
+/**
+ * Why a following-feed page came back empty. Lets a client say something true
+ * per case instead of one catch-all sentence, and point at the right next step.
+ */
+type FollowingFeedEmptyReason = 'no_follows' | 'no_visible_follows' | 'no_cross_app_activity' | 'no_recent_records' | 'all_hidden' | 'nothing_renderable' | 'hydration_failed';
 /** Options for {@link fetchFollowingFeed}. */
 interface FetchFollowingFeedOptions extends ApiFetchOptions {
     limit?: number;
     /**
      * Opt in to the viewer's Bluesky activity too. Off by default: the point of
      * the feed is what connections do on OTHER apps.
+     *
+     * Ignored when {@link app} is set, since a source tab selects one app.
      */
     includeBluesky?: boolean;
+    /**
+     * Restrict the page to one app (a registry id from the response's `apps`).
+     * This is what a source tab selects. `app: 'bluesky'` selects Bluesky even
+     * though it is excluded from the default mixed view.
+     */
+    app?: string;
     /** Forward a `Cookie` header on Next.js RSC server-side calls (web). */
     cookieHeader?: string;
 }
+/** The following feed's response: an activity feed plus its tab metadata. */
+interface FollowingFeedResponse extends ActivityFeedResponse {
+    /**
+     * Apps the viewer's network is actually active on, most active first.
+     * Present on empty pages too, so a client's tabs survive a quiet tab.
+     */
+    apps?: FollowingFeedApp[];
+    /** Set only when `items` is empty. */
+    reason?: FollowingFeedEmptyReason;
+}
 /**
  * The viewer's cross-app following feed: what OTHER apps their connections use
  * (Tangled, WhiteWind, Smoke Signal, ...) — Bluesky is excluded server-side by
@@ -1312,7 +1343,7 @@ interface FetchFollowingFeedOptions extends ApiFetchOptions {
  * session cookie (`credentials: 'include'`). Returns `null` on error. v1 is a
  * finite first page (no cursor yet).
  */
-declare function fetchFollowingFeed(config: SifaApiConfig, opts?: FetchFollowingFeedOptions): Promise<ActivityFeedResponse | null>;
+declare function fetchFollowingFeed(config: SifaApiConfig, opts?: FetchFollowingFeedOptions): Promise<FollowingFeedResponse | null>;
 
 /**
  * Options shared by the cursor-paginated follow-graph endpoints introduced in
@@ -1938,4 +1969,4 @@ declare function addOrgNotificationEmail(config: SifaApiConfig, body: OrgNotific
  */
 declare function removeOrgNotificationEmail(config: SifaApiConfig, body: OrgNotificationEmailRequestInput, options?: Omit<ApiFetchOptions, 'method' | 'body'>): Promise<WriteResult & Partial<OrgNotificationEmailRemoveResult>>;
 
-export { HIDDEN_ITEM_SOURCES as $, type ApiFetchOptions as A, type BulkHideProfileItemInput as B, type CreateResult as C, type DeleteAccountResult as D, type EndorsementInput as E, type FeatureAllowlistResponse as F, type FetchFollowingFeedOptions as G, type FetchHiddenActivityItemsOptions as H, type FetchHiddenAppsOptions as I, type FetchInboxCountsOptions as J, type FetchMyGithubPullRequestsOptions as K, type FetchMyRoadmapVotesOptions as L, type FetchProfileCompletenessOptions as M, type FetchReactionStatusOptions as N, type FetchSuggestionsOptions as O, type FetchUnlinkedPositionsOptions as P, type FilterOptions as Q, type FollowListPage as R, type SifaApiConfig as S, type FollowProfile as T, type FollowProfilePageResponse as U, type FollowUserResult as V, type WriteResult as W, type FollowingResponse as X, type GetAdminReviewQueuesOptions as Y, type GithubPullRequest as Z, type GivenConfirmation as _, type ConfirmEndorsementInput as a, type UploadAvatarResult as a$, HIDDEN_ITEM_TYPES as a0, type HeatmapDay as a1, type HeatmapResponse as a2, type HiddenActivityItem as a3, type HiddenApp as a4, type HiddenItemSource as a5, type HiddenItemType as a6, type HideActivityItemInput as a7, type HideProfileItemInput as a8, type InboxCounts as a9, type QuotedPostView as aA, type ReactionError as aB, type ReactionResult as aC, type ReactionStatus as aD, type RefreshOrcidPublicationsResult as aE, type RefreshPdsResult as aF, type RepoDeleteInput as aG, type ResetProfileResult as aH, type ResolveQuotedPostsOptions as aI, type RoadmapVoteError as aJ, type RoadmapVoteResult as aK, type RoadmapVoter as aL, type RoadmapVotesResponse as aM, type SearchFilters as aN, type SearchResponse as aO, type SifaQueryKey as aP, type SimilarProfile as aQ, type SkillSearchResult as aR, type StatsResponse as aS, type SubCategoryBulkResult as aT, type SuggestionProfile as aU, type SuggestionsResponse as aV, type UnhideActivityItemInput as aW, type UnlinkedPosition as aX, type UnlinkedPositionsResult as aY, type UpdateProfileOverrideInput as aZ, type UpdateProfileSelfInput as a_, type ListFeatureAllowlistOptions as aa, type MyGithubPullRequestsResponse as ab, type OrgClaimBinding as ac, type OrgClaimResult as ad, type OrgDomainChallengeResult as ae, type OrgDomainVerifyResult as af, type OrgNotificationEmailAddResult as ag, type OrgNotificationEmailRemoveResult as ah, type OrgProfileEcho as ai, type OrgProfileUpdateResult as aj, PROFILE_COMPLETENESS_SIGNALS as ak, type PdsWipeOutcome as al, type PendingConfirmation as am, type PendingConfirmationsPage as an, type PrimarySection as ao, type ProfileCompleteness as ap, type ProfileCompletenessSignal as aq, type ProfileIndustryInput as ar, type ProfileLocationAddress as as, type ProfileLocationInput as at, type ProfileSearchResult as au, type ProfileSelfLocation as av, QUOTED_POSTS_BATCH_MAX as aw, type QuotedPostAuthor as ax, type QuotedPostImage as ay, type QuotedPostResult as az, type ConfirmEndorsementResult as b, getBlueskySuggestions as b$, type UploadPronunciationAudioResult as b0, type VerifyExternalAccountResult as b1, type WipePreview as b2, addFeatureAllowlist as b3, addOrgNotificationEmail as b4, apiFetch as b5, apiFetchOrNull as b6, apiWrite as b7, apiWriteCreate as b8, bulkHideProfileItems as b9, fetchExternalAccounts as bA, fetchFeaturedProfile as bB, fetchFollowing as bC, fetchFollowingFeed as bD, fetchGivenConfirmations as bE, fetchHeatmapData as bF, fetchHiddenActivityItems as bG, fetchHiddenApps as bH, fetchInboxCounts as bI, fetchMyGithubPullRequests as bJ, fetchMyRoadmapVotes as bK, fetchPendingConfirmations as bL, fetchProfileCompleteness as bM, fetchReactionStatus as bN, fetchRepoInventory as bO, fetchRoadmapVotes as bP, fetchSearchFilters as bQ, fetchSearchProfiles as bR, fetchSimilarProfiles as bS, fetchSkillSuggestions as bT, fetchStats as bU, fetchSuggestionCount as bV, fetchSuggestions as bW, fetchUnlinkedPositions as bX, fetchWipePreview as bY, followUser as bZ, getAdminReviewQueues as b_, bulkHideStandardPublications as ba, bulkUnhideProfileItems as bb, bulkUnhideStandardPublications as bc, castRoadmapVote as bd, checkAppAccount as be, confirmEndorsement as bf, createConfirmation as bg, createEndorsement as bh, createExternalAccount as bi, createProfileLocation as bj, createReaction as bk, createSkill as bl, deleteAccount as bm, deleteAvatarOverride as bn, deleteExternalAccount as bo, deleteNamePronunciationAudio as bp, deleteProfileLocation as bq, deleteReaction as br, deleteRepoRecords as bs, deleteSkill as bt, dismissConfirmation as bu, dismissUnlinkedPosition as bv, fetchAccounts as bw, fetchActivityFeed as bx, fetchActivityTeaser as by, fetchAppsRegistry as bz, type AccountCheckResult as c, getFollowers as c0, getFollowing as c1, getMutuals as c2, hideActivityItem as c3, hideOrcidPublication as c4, hideProfileItem as c5, hideSifaPublication as c6, hideStandardPublication as c7, listFeatureAllowlist as c8, refreshOrcidPublications as c9, updateProfileSelf as cA, updateSkill as cB, updateSkillSubCategories as cC, uploadAvatar as cD, uploadNamePronunciationAudio as cE, verifyExternalAccount as cF, verifyOrgDomain as cG, type CompanySearchFilters as cH, type CompanySearchResponse as cI, type CompanySearchResult as cJ, fetchSearchCompanies as cK, refreshPds as ca, removeFeatureAllowlist as cb, removeOrgNotificationEmail as cc, repoExportUrl as cd, requestOrgDomainChallenge as ce, resetProfile as cf, resolveQuotedPosts as cg, retractRoadmapVote as ch, revokeConfirmation as ci, searchSkills as cj, setExternalAccountPrimary as ck, setSectionPrimary as cl, submitOrgClaim as cm, switchAccount as cn, unfollowUser as co, unhideActivityItem as cp, unhideOrcidPublication as cq, unhideProfileItem as cr, unhideSifaPublication as cs, unhideStandardPublication as ct, unsetExternalAccountPrimary as cu, unsetSectionPrimary as cv, updateExternalAccount as cw, updateOrgProfile as cx, updateProfileLocation as cy, updateProfileOverride as cz, type AccountSummary as d, type ActivityFeedResponse as e, type ActivityItem as f, type ActivityItemLinkHealth as g, type ActivityTeaserResponse as h, type AdminReviewQueues as i, ApiError as j, type AppRegistryEntry as k, type CastRoadmapVoteResult as l, type CheckAppAccountOptions as m, type ConfirmationInput as n, type ConfirmationSubjectInput as o, type CreateExternalAccountResult as p, type DismissUnlinkedPositionInput as q, type ExternalAccountInput as r, sifaQueryKeys as s, type FeaturedProfile as t, type FetchAccountsOptions as u, type FetchActivityFeedOptions as v, type FetchActivityTeaserOptions as w, type FetchConfirmationsOptions as x, type FetchFollowListOptions as y, type FetchFollowProfilePageOptions as z };
+export { type GetAdminReviewQueuesOptions as $, type ApiFetchOptions as A, type BulkHideProfileItemInput as B, type CreateResult as C, type DeleteAccountResult as D, type EndorsementInput as E, type FeatureAllowlistResponse as F, type FetchFollowingFeedOptions as G, type FetchHiddenActivityItemsOptions as H, type FetchHiddenAppsOptions as I, type FetchInboxCountsOptions as J, type FetchMyGithubPullRequestsOptions as K, type FetchMyRoadmapVotesOptions as L, type FetchProfileCompletenessOptions as M, type FetchReactionStatusOptions as N, type FetchSuggestionsOptions as O, type FetchUnlinkedPositionsOptions as P, type FilterOptions as Q, type FollowListPage as R, type SifaApiConfig as S, type FollowProfile as T, type FollowProfilePageResponse as U, type FollowUserResult as V, type WriteResult as W, type FollowingFeedApp as X, type FollowingFeedEmptyReason as Y, type FollowingFeedResponse as Z, type FollowingResponse as _, type ConfirmEndorsementInput as a, type UnlinkedPositionsResult as a$, type GithubPullRequest as a0, type GivenConfirmation as a1, HIDDEN_ITEM_SOURCES as a2, HIDDEN_ITEM_TYPES as a3, type HeatmapDay as a4, type HeatmapResponse as a5, type HiddenActivityItem as a6, type HiddenApp as a7, type HiddenItemSource as a8, type HiddenItemType as a9, type QuotedPostAuthor as aA, type QuotedPostImage as aB, type QuotedPostResult as aC, type QuotedPostView as aD, type ReactionError as aE, type ReactionResult as aF, type ReactionStatus as aG, type RefreshOrcidPublicationsResult as aH, type RefreshPdsResult as aI, type RepoDeleteInput as aJ, type ResetProfileResult as aK, type ResolveQuotedPostsOptions as aL, type RoadmapVoteError as aM, type RoadmapVoteResult as aN, type RoadmapVoter as aO, type RoadmapVotesResponse as aP, type SearchFilters as aQ, type SearchResponse as aR, type SifaQueryKey as aS, type SimilarProfile as aT, type SkillSearchResult as aU, type StatsResponse as aV, type SubCategoryBulkResult as aW, type SuggestionProfile as aX, type SuggestionsResponse as aY, type UnhideActivityItemInput as aZ, type UnlinkedPosition as a_, type HideActivityItemInput as aa, type HideProfileItemInput as ab, type InboxCounts as ac, type ListFeatureAllowlistOptions as ad, type MyGithubPullRequestsResponse as ae, type OrgClaimBinding as af, type OrgClaimResult as ag, type OrgDomainChallengeResult as ah, type OrgDomainVerifyResult as ai, type OrgNotificationEmailAddResult as aj, type OrgNotificationEmailRemoveResult as ak, type OrgProfileEcho as al, type OrgProfileUpdateResult as am, PROFILE_COMPLETENESS_SIGNALS as an, type PdsWipeOutcome as ao, type PendingConfirmation as ap, type PendingConfirmationsPage as aq, type PrimarySection as ar, type ProfileCompleteness as as, type ProfileCompletenessSignal as at, type ProfileIndustryInput as au, type ProfileLocationAddress as av, type ProfileLocationInput as aw, type ProfileSearchResult as ax, type ProfileSelfLocation as ay, QUOTED_POSTS_BATCH_MAX as az, type ConfirmEndorsementResult as b, fetchWipePreview as b$, type UpdateProfileOverrideInput as b0, type UpdateProfileSelfInput as b1, type UploadAvatarResult as b2, type UploadPronunciationAudioResult as b3, type VerifyExternalAccountResult as b4, type WipePreview as b5, addFeatureAllowlist as b6, addOrgNotificationEmail as b7, apiFetch as b8, apiFetchOrNull as b9, fetchActivityFeed as bA, fetchActivityTeaser as bB, fetchAppsRegistry as bC, fetchExternalAccounts as bD, fetchFeaturedProfile as bE, fetchFollowing as bF, fetchFollowingFeed as bG, fetchGivenConfirmations as bH, fetchHeatmapData as bI, fetchHiddenActivityItems as bJ, fetchHiddenApps as bK, fetchInboxCounts as bL, fetchMyGithubPullRequests as bM, fetchMyRoadmapVotes as bN, fetchPendingConfirmations as bO, fetchProfileCompleteness as bP, fetchReactionStatus as bQ, fetchRepoInventory as bR, fetchRoadmapVotes as bS, fetchSearchFilters as bT, fetchSearchProfiles as bU, fetchSimilarProfiles as bV, fetchSkillSuggestions as bW, fetchStats as bX, fetchSuggestionCount as bY, fetchSuggestions as bZ, fetchUnlinkedPositions as b_, apiWrite as ba, apiWriteCreate as bb, bulkHideProfileItems as bc, bulkHideStandardPublications as bd, bulkUnhideProfileItems as be, bulkUnhideStandardPublications as bf, castRoadmapVote as bg, checkAppAccount as bh, confirmEndorsement as bi, createConfirmation as bj, createEndorsement as bk, createExternalAccount as bl, createProfileLocation as bm, createReaction as bn, createSkill as bo, deleteAccount as bp, deleteAvatarOverride as bq, deleteExternalAccount as br, deleteNamePronunciationAudio as bs, deleteProfileLocation as bt, deleteReaction as bu, deleteRepoRecords as bv, deleteSkill as bw, dismissConfirmation as bx, dismissUnlinkedPosition as by, fetchAccounts as bz, type AccountCheckResult as c, followUser as c0, getAdminReviewQueues as c1, getBlueskySuggestions as c2, getFollowers as c3, getFollowing as c4, getMutuals as c5, hideActivityItem as c6, hideOrcidPublication as c7, hideProfileItem as c8, hideSifaPublication as c9, updateOrgProfile as cA, updateProfileLocation as cB, updateProfileOverride as cC, updateProfileSelf as cD, updateSkill as cE, updateSkillSubCategories as cF, uploadAvatar as cG, uploadNamePronunciationAudio as cH, verifyExternalAccount as cI, verifyOrgDomain as cJ, type CompanySearchFilters as cK, type CompanySearchResponse as cL, type CompanySearchResult as cM, fetchSearchCompanies as cN, hideStandardPublication as ca, listFeatureAllowlist as cb, refreshOrcidPublications as cc, refreshPds as cd, removeFeatureAllowlist as ce, removeOrgNotificationEmail as cf, repoExportUrl as cg, requestOrgDomainChallenge as ch, resetProfile as ci, resolveQuotedPosts as cj, retractRoadmapVote as ck, revokeConfirmation as cl, searchSkills as cm, setExternalAccountPrimary as cn, setSectionPrimary as co, submitOrgClaim as cp, switchAccount as cq, unfollowUser as cr, unhideActivityItem as cs, unhideOrcidPublication as ct, unhideProfileItem as cu, unhideSifaPublication as cv, unhideStandardPublication as cw, unsetExternalAccountPrimary as cx, unsetSectionPrimary as cy, updateExternalAccount as cz, type AccountSummary as d, type ActivityFeedResponse as e, type ActivityItem as f, type ActivityItemLinkHealth as g, type ActivityTeaserResponse as h, type AdminReviewQueues as i, ApiError as j, type AppRegistryEntry as k, type CastRoadmapVoteResult as l, type CheckAppAccountOptions as m, type ConfirmationInput as n, type ConfirmationSubjectInput as o, type CreateExternalAccountResult as p, type DismissUnlinkedPositionInput as q, type ExternalAccountInput as r, sifaQueryKeys as s, type FeaturedProfile as t, type FetchAccountsOptions as u, type FetchActivityFeedOptions as v, type FetchActivityTeaserOptions as w, type FetchConfirmationsOptions as x, type FetchFollowListOptions as y, type FetchFollowProfilePageOptions as z };

package/dist/query/fetchers/index.cjs

@@ -1061,7 +1061,8 @@ var FOLLOWING_FEED_LXM = "id.sifa.feed.getFollowingFeed";
 async function fetchFollowingFeed(config, opts = {}) {
   const params = new URLSearchParams();
   if (opts.limit) params.set("limit", String(opts.limit));
-  if (opts.includeBluesky) params.set("includeBluesky", "true");
+  if (opts.app) params.set("app", opts.app);
+  else if (opts.includeBluesky) params.set("includeBluesky", "true");
   const qs = params.toString();
   const headers = { ...opts.headers ?? {} };
   if (opts.cookieHeader) headers.cookie = opts.cookieHeader;