@singi-labs/sifa-sdk 0.18.21 → 0.19.0

package/dist/{org-DC_71Ojb.d.ts → org-BwK-97S0.d.ts}

@@ -1,6 +1,6 @@
 import { p as ExternalAccount, Q as SkillSuggestion } from './index-C13I8diU.js';
-import { y as FollowFeedPage, B as FollowProfileItem, q as FeatureAllowlistEntry, s as FeatureFlag } from './feed-BMm9Pkew.js';
 import { b as ActivityLabel, t as RepoDeleteResult, w as RepoInventory } from './types-YpOch4Ho.js';
+import { s as FollowProfileItem, p as FeatureAllowlistEntry, r as FeatureFlag } from './follow-profile-D1l6pulB.js';
 import { z } from 'zod';
 import { d as OrgNotificationEmailRequestInput, b as OrgDomainChallengeRequestInput, O as OrgClaimRequestInput, a as OrgProfileUpdateRequestInput, c as OrgDomainVerifyRequestInput } from './org-settings-CZ_tmAYl.js';
 
@@ -21,6 +21,16 @@ interface SifaApiConfig {
      * consumers can leave this unset.
      */
     fetch?: typeof fetch;
+    /**
+     * Optional per-request auth-token minter for auth-required reads. The NATIVE
+     * app supplies this (it has no sifa-api session cookie): given a method NSID
+     * (`lxm`), it mints a short-lived AT Protocol service-auth JWT on the user's
+     * PDS (see the SDK's `/atproto` `mintServiceAuthToken`) and returns it; the
+     * fetcher attaches it as `Authorization: Bearer`. Web omits this and relies on
+     * its session cookie (`credentials: 'include'`). Return `null` to send no
+     * token. See `sifa-api` `createIdentityMiddleware`.
+     */
+    getAuthToken?: (lxm: string) => Promise<string | null>;
 }
 /** Options accepted by {@link apiFetch}. */
 interface ApiFetchOptions {
@@ -1039,6 +1049,182 @@ declare function fetchSuggestionCount(config: SifaApiConfig, since?: string, opt
 /** Featured profile (rotated by sifa-api). Returns `null` when none. */
 declare function fetchFeaturedProfile(config: SifaApiConfig, options?: ApiFetchOptions): Promise<FeaturedProfile | null>;
 
+interface QuotedPostAuthor {
+    did: string;
+    handle: string;
+    displayName?: string;
+    avatar?: string;
+}
+interface QuotedPostImage {
+    thumb: string;
+    fullsize: string;
+    alt?: string;
+}
+interface QuotedPostView {
+    uri: string;
+    cid: string;
+    author: QuotedPostAuthor;
+    text: string;
+    createdAt: string;
+    images?: QuotedPostImage[];
+}
+type QuotedPostResult = {
+    status: 'ok';
+    record: QuotedPostView;
+} | {
+    status: 'deleted';
+    uri: string;
+} | {
+    status: 'unavailable';
+    uri: string;
+};
+/** Max URIs per request to `POST /api/quoted-posts/resolve` (mirrors server cap). */
+declare const QUOTED_POSTS_BATCH_MAX = 20;
+interface ResolveQuotedPostsOptions extends ApiFetchOptions {
+    /** Cookie header for Next.js RSC server-side calls; ignored in browsers. */
+    cookieHeader?: string;
+}
+/**
+ * Resolve a batch of AT-URIs to their quoted-post snapshots via the Sifa AppView.
+ *
+ * Auto-deduplicates input URIs and splits requests into chunks of
+ * {@link QUOTED_POSTS_BATCH_MAX} so callers can pass an arbitrary-length array.
+ * Each chunk is fired in parallel. The server caches results in Valkey, so
+ * repeated calls for the same URI are cheap.
+ *
+ * Returns a map of `uri -> QuotedPostResult`. URIs that fail (network error,
+ * non-2xx, or the server omitting them) are absent from the map; the caller
+ * should render a skeleton or tombstone for those.
+ */
+declare function resolveQuotedPosts(config: SifaApiConfig, uris: string[], options?: ResolveQuotedPostsOptions): Promise<Record<string, QuotedPostResult>>;
+
+/**
+ * Liveness of an activity card's destination, as reported by sifa-api's
+ * `/api/activity` enrichment (see sifa-api `url-health-checker`). How liveness
+ * is measured depends on the card's health strategy (see `resolveCardHealth`):
+ * first-party permalinks (`record`) are checked by record existence on the PDS;
+ * foreign/derived targets (`url`) by HTTP reachability (HEAD, then GET).
+ *
+ *   ok           -- record exists, or the URL returned 2xx/3xx
+ *   broken       -- confirmed dead (record deleted, or >=2 consecutive 4xx / >=5 consecutive 5xx)
+ *   unverifiable -- 403/429, PDS unreachable, or network error; 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;
+    apps: {
+        appId: string;
+        count: number;
+    }[];
+}
+interface HeatmapResponse {
+    days: HeatmapDay[];
+    appTotals: {
+        appId: string;
+        appName: string;
+        total: number;
+    }[];
+    thresholds: [number, number, number, number];
+}
+interface ActivityItem {
+    uri: string;
+    cid: string;
+    collection: string;
+    rkey: string;
+    record: Record<string, unknown>;
+    appId: string;
+    appName: string;
+    category: string;
+    indexedAt: string;
+    /**
+     * The record author's handle / display name / avatar, injected by the server
+     * on MULTI-author feeds (the following feed) so a card can show whose activity
+     * it is. Unset on the per-author activity feed (all one author). Mirrors the
+     * stream `ActivityItem`'s author fields the view-model transform reads.
+     */
+    authorHandle?: string;
+    authorDisplayName?: string;
+    authorAvatar?: string;
+    /**
+     * Set by the server when an `app.bsky.embed.record` quote was already
+     * resolved upstream (AppView path). Mutually exclusive with `quotedPostUri`.
+     */
+    quotedPost?: QuotedPostResult;
+    /**
+     * Set by the server when an `app.bsky.embed.record` quote needs client-side
+     * resolution (PDS path). Pass batches to {@link resolveQuotedPosts}.
+     * Mutually exclusive with `quotedPost`.
+     */
+    quotedPostUri?: string;
+    /**
+     * 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;
+    /**
+     * Content labels from `app.bsky.feed.defs#postView.labels`. Set by
+     * sifa-api for Bluesky posts; undefined for other sources and legacy
+     * responses. Pass items to {@link hasAdultContent} to decide whether to
+     * gate media. See {@link ActivityLabel}.
+     */
+    labels?: ActivityLabel[];
+    /**
+     * The owner has hidden this item from their profile. Only ever set on the
+     * owner's own view of their feed -- every other surface omits hidden items
+     * rather than flagging them -- so a card can offer an unhide in place.
+     */
+    hidden?: boolean;
+}
+interface ActivityTeaserResponse {
+    items: ActivityItem[];
+    blueskyGated?: boolean;
+    backfillPending?: boolean;
+    failedApps?: string[];
+}
+interface ActivityFeedResponse {
+    items: ActivityItem[];
+    cursor: string | null;
+    hasMore: boolean;
+    availableCategories?: string[];
+    blueskyGated?: boolean;
+    failedApps?: string[];
+}
+/**
+ * Per-day activity counts for a profile across all ATproto apps. Returns
+ * `null` on any error so callers can render a graceful empty state.
+ */
+declare function fetchHeatmapData(config: SifaApiConfig, handleOrDid: string, days: number, options?: ApiFetchOptions): Promise<HeatmapResponse | null>;
+interface FetchActivityTeaserOptions extends ApiFetchOptions {
+    /**
+     * Pass the caller's `Cookie` header on Next.js RSC server-side calls.
+     * Required for authenticated server fetches because `credentials: 'include'`
+     * does not propagate browser cookies in RSC.
+     */
+    cookieHeader?: string;
+}
+/**
+ * Recent activity teaser for a profile (homepage-sized slice). Caps the
+ * upstream wait so the SSR path cannot hang. Returns `null` on any error.
+ */
+declare function fetchActivityTeaser(config: SifaApiConfig, handleOrDid: string, options?: FetchActivityTeaserOptions): Promise<ActivityTeaserResponse | null>;
+interface FetchActivityFeedOptions extends ApiFetchOptions {
+    category?: string;
+    limit?: number;
+    cursor?: string;
+    cookieHeader?: string;
+}
+/**
+ * Paginated activity feed for a profile. Always fresh (`cache: 'no-store'`).
+ * Returns `null` on any error.
+ */
+declare function fetchActivityFeed(config: SifaApiConfig, handleOrDid: string, options?: FetchActivityFeedOptions): Promise<ActivityFeedResponse | null>;
+
 interface FollowProfile {
     did: string;
     handle: string;
@@ -1104,35 +1290,23 @@ 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>;
-/**
- * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
- *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
- *   Stream are two distinct surfaces with different data paths (Barazo API
- *   for Timeline, live PDS reads + Valkey for Stream). These collapsed feed
- *   types are no longer consumed. Scheduled for removal in next major bump.
- */
+/** Options for {@link fetchFollowingFeed}. */
 interface FetchFollowingFeedOptions extends ApiFetchOptions {
-    cursor?: string;
     limit?: number;
-    /**
-     * Comma-separated category filter (per sifa-api#673 TR10). Forwarded
-     * as-is; the server validates allowed values.
-     */
-    categories?: string[];
+    /** Forward a `Cookie` header on Next.js RSC server-side calls (web). */
     cookieHeader?: string;
 }
 /**
- * V5 home feed: Sifa events + curated ATmosphere creation events filtered
- * by the authenticated viewer's followees. Composite cursor (per E5/TR4).
- * Returns an empty page on error.
+ * The viewer's cross-app following feed: what OTHER apps their connections use
+ * (Tangled, WhiteWind, Smoke Signal, ...) — Bluesky is excluded server-side, as
+ * it is the least interesting part and other apps already surface it.
  *
- * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
- *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
- *   Stream are two distinct surfaces with different data paths (Barazo API
- *   for Timeline, live PDS reads + Valkey for Stream). This fetcher is no
- *   longer consumed. Scheduled for removal in next major bump.
+ * Auth is identity-only server-side, so the NATIVE app supplies
+ * `config.getAuthToken` to mint a service-auth Bearer, while WEB relies on its
+ * session cookie (`credentials: 'include'`). Returns `null` on error. v1 is a
+ * finite first page (no cursor yet).
  */
-declare function getFollowingFeed(config: SifaApiConfig, opts?: FetchFollowingFeedOptions): Promise<FollowFeedPage>;
+declare function fetchFollowingFeed(config: SifaApiConfig, opts?: FetchFollowingFeedOptions): Promise<ActivityFeedResponse | null>;
 
 /**
  * Options shared by the cursor-paginated follow-graph endpoints introduced in
@@ -1229,173 +1403,6 @@ interface AdminReviewQueues {
  */
 declare function getAdminReviewQueues(config: SifaApiConfig, opts?: GetAdminReviewQueuesOptions): Promise<AdminReviewQueues>;
 
-interface QuotedPostAuthor {
-    did: string;
-    handle: string;
-    displayName?: string;
-    avatar?: string;
-}
-interface QuotedPostImage {
-    thumb: string;
-    fullsize: string;
-    alt?: string;
-}
-interface QuotedPostView {
-    uri: string;
-    cid: string;
-    author: QuotedPostAuthor;
-    text: string;
-    createdAt: string;
-    images?: QuotedPostImage[];
-}
-type QuotedPostResult = {
-    status: 'ok';
-    record: QuotedPostView;
-} | {
-    status: 'deleted';
-    uri: string;
-} | {
-    status: 'unavailable';
-    uri: string;
-};
-/** Max URIs per request to `POST /api/quoted-posts/resolve` (mirrors server cap). */
-declare const QUOTED_POSTS_BATCH_MAX = 20;
-interface ResolveQuotedPostsOptions extends ApiFetchOptions {
-    /** Cookie header for Next.js RSC server-side calls; ignored in browsers. */
-    cookieHeader?: string;
-}
-/**
- * Resolve a batch of AT-URIs to their quoted-post snapshots via the Sifa AppView.
- *
- * Auto-deduplicates input URIs and splits requests into chunks of
- * {@link QUOTED_POSTS_BATCH_MAX} so callers can pass an arbitrary-length array.
- * Each chunk is fired in parallel. The server caches results in Valkey, so
- * repeated calls for the same URI are cheap.
- *
- * Returns a map of `uri -> QuotedPostResult`. URIs that fail (network error,
- * non-2xx, or the server omitting them) are absent from the map; the caller
- * should render a skeleton or tombstone for those.
- */
-declare function resolveQuotedPosts(config: SifaApiConfig, uris: string[], options?: ResolveQuotedPostsOptions): Promise<Record<string, QuotedPostResult>>;
-
-/**
- * Liveness of an activity card's destination, as reported by sifa-api's
- * `/api/activity` enrichment (see sifa-api `url-health-checker`). How liveness
- * is measured depends on the card's health strategy (see `resolveCardHealth`):
- * first-party permalinks (`record`) are checked by record existence on the PDS;
- * foreign/derived targets (`url`) by HTTP reachability (HEAD, then GET).
- *
- *   ok           -- record exists, or the URL returned 2xx/3xx
- *   broken       -- confirmed dead (record deleted, or >=2 consecutive 4xx / >=5 consecutive 5xx)
- *   unverifiable -- 403/429, PDS unreachable, or network error; 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;
-    apps: {
-        appId: string;
-        count: number;
-    }[];
-}
-interface HeatmapResponse {
-    days: HeatmapDay[];
-    appTotals: {
-        appId: string;
-        appName: string;
-        total: number;
-    }[];
-    thresholds: [number, number, number, number];
-}
-interface ActivityItem {
-    uri: string;
-    cid: string;
-    collection: string;
-    rkey: string;
-    record: Record<string, unknown>;
-    appId: string;
-    appName: string;
-    category: string;
-    indexedAt: string;
-    /**
-     * Set by the server when an `app.bsky.embed.record` quote was already
-     * resolved upstream (AppView path). Mutually exclusive with `quotedPostUri`.
-     */
-    quotedPost?: QuotedPostResult;
-    /**
-     * Set by the server when an `app.bsky.embed.record` quote needs client-side
-     * resolution (PDS path). Pass batches to {@link resolveQuotedPosts}.
-     * Mutually exclusive with `quotedPost`.
-     */
-    quotedPostUri?: string;
-    /**
-     * 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;
-    /**
-     * Content labels from `app.bsky.feed.defs#postView.labels`. Set by
-     * sifa-api for Bluesky posts; undefined for other sources and legacy
-     * responses. Pass items to {@link hasAdultContent} to decide whether to
-     * gate media. See {@link ActivityLabel}.
-     */
-    labels?: ActivityLabel[];
-    /**
-     * The owner has hidden this item from their profile. Only ever set on the
-     * owner's own view of their feed -- every other surface omits hidden items
-     * rather than flagging them -- so a card can offer an unhide in place.
-     */
-    hidden?: boolean;
-}
-interface ActivityTeaserResponse {
-    items: ActivityItem[];
-    blueskyGated?: boolean;
-    backfillPending?: boolean;
-    failedApps?: string[];
-}
-interface ActivityFeedResponse {
-    items: ActivityItem[];
-    cursor: string | null;
-    hasMore: boolean;
-    availableCategories?: string[];
-    blueskyGated?: boolean;
-    failedApps?: string[];
-}
-/**
- * Per-day activity counts for a profile across all ATproto apps. Returns
- * `null` on any error so callers can render a graceful empty state.
- */
-declare function fetchHeatmapData(config: SifaApiConfig, handleOrDid: string, days: number, options?: ApiFetchOptions): Promise<HeatmapResponse | null>;
-interface FetchActivityTeaserOptions extends ApiFetchOptions {
-    /**
-     * Pass the caller's `Cookie` header on Next.js RSC server-side calls.
-     * Required for authenticated server fetches because `credentials: 'include'`
-     * does not propagate browser cookies in RSC.
-     */
-    cookieHeader?: string;
-}
-/**
- * Recent activity teaser for a profile (homepage-sized slice). Caps the
- * upstream wait so the SSR path cannot hang. Returns `null` on any error.
- */
-declare function fetchActivityTeaser(config: SifaApiConfig, handleOrDid: string, options?: FetchActivityTeaserOptions): Promise<ActivityTeaserResponse | null>;
-interface FetchActivityFeedOptions extends ApiFetchOptions {
-    category?: string;
-    limit?: number;
-    cursor?: string;
-    cookieHeader?: string;
-}
-/**
- * Paginated activity feed for a profile. Always fresh (`cache: 'no-store'`).
- * Returns `null` on any error.
- */
-declare function fetchActivityFeed(config: SifaApiConfig, handleOrDid: string, options?: FetchActivityFeedOptions): Promise<ActivityFeedResponse | null>;
-
 /**
  * A single merged pull request ingested from GitHub, as served by sifa-api's
  * `GET /api/me/github/pull-requests`. Mirrors the `github_contributions` row.
@@ -1925,4 +1932,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, getFollowers 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, fetchGivenConfirmations as bD, fetchHeatmapData as bE, fetchHiddenActivityItems as bF, fetchHiddenApps as bG, fetchInboxCounts as bH, fetchMyGithubPullRequests as bI, fetchMyRoadmapVotes as bJ, fetchPendingConfirmations as bK, fetchProfileCompleteness as bL, fetchReactionStatus as bM, fetchRepoInventory as bN, fetchRoadmapVotes as bO, fetchSearchFilters as bP, fetchSearchProfiles as bQ, fetchSimilarProfiles as bR, fetchSkillSuggestions as bS, fetchStats as bT, fetchSuggestionCount as bU, fetchSuggestions as bV, fetchUnlinkedPositions as bW, fetchWipePreview as bX, followUser as bY, getAdminReviewQueues as bZ, getBlueskySuggestions 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, getFollowing as c0, getFollowingFeed 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 { 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 };

package/dist/{profile-investment-Bvulg_jG.d.cts → profile-investment-D-nKT3ZK.d.cts}

@@ -216,6 +216,195 @@ declare function makeGraphFollowRecordSchema(followerDid: string): z.ZodObject<{
     note: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 
+/**
+ * Feed item from `GET /api/following/feed`. Discriminated on `source`:
+ *
+ * - `sifa`: a Sifa-native event (e.g. profile update, endorsement).
+ * - `atmosphere`: a curated creation event from another ATproto app
+ *   (Barazo post, etc.). Payload is the hydrated `app.bsky.embed.*#view`
+ *   shape, NOT the raw record (per memory `sifa-hydrated-view-embed-types`).
+ *
+ * Both variants share `actor`, `indexedAt`, and `id` (the materialized
+ * `feed_events.id` row identifier, used in the cursor).
+ */
+declare const FeedActorSchema: z.ZodObject<{
+    did: z.ZodString;
+    handle: z.ZodString;
+    displayName: z.ZodOptional<z.ZodString>;
+    avatarUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type FeedActor = z.infer<typeof FeedActorSchema>;
+/**
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
+ *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
+ *   Stream are two distinct surfaces with different data paths (Barazo API
+ *   for Timeline, live PDS reads + Valkey for Stream). These collapsed feed
+ *   types are no longer consumed. Scheduled for removal in next major bump.
+ */
+declare const SifaFeedItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    actor: z.ZodObject<{
+        did: z.ZodString;
+        handle: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+        avatarUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    indexedAt: z.ZodString;
+    eventType: z.ZodString;
+    source: z.ZodLiteral<"sifa">;
+    appId: z.ZodOptional<z.ZodLiteral<"sifa">>;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+/**
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
+ *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
+ *   Stream are two distinct surfaces with different data paths (Barazo API
+ *   for Timeline, live PDS reads + Valkey for Stream). These collapsed feed
+ *   types are no longer consumed. Scheduled for removal in next major bump.
+ */
+type SifaFeedItem = z.infer<typeof SifaFeedItemSchema>;
+/**
+ * ATmosphere feed item. `payload` is intentionally permissive: it carries
+ * a hydrated `app.bsky.embed.*#view` shape that varies by source app. The
+ * AppView resolves the hydration; clients render via the existing
+ * embed-view union (mirrors `sifa-web/src/components/stream/`).
+ *
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
+ *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
+ *   Stream are two distinct surfaces with different data paths (Barazo API
+ *   for Timeline, live PDS reads + Valkey for Stream). These collapsed feed
+ *   types are no longer consumed. Scheduled for removal in next major bump.
+ */
+declare const AtmosphereFeedItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    actor: z.ZodObject<{
+        did: z.ZodString;
+        handle: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+        avatarUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    indexedAt: z.ZodString;
+    eventType: z.ZodString;
+    source: z.ZodLiteral<"atmosphere">;
+    appId: z.ZodString;
+    uri: z.ZodOptional<z.ZodString>;
+    cid: z.ZodOptional<z.ZodString>;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+/**
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
+ *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
+ *   Stream are two distinct surfaces with different data paths (Barazo API
+ *   for Timeline, live PDS reads + Valkey for Stream). These collapsed feed
+ *   types are no longer consumed. Scheduled for removal in next major bump.
+ */
+type AtmosphereFeedItem = z.infer<typeof AtmosphereFeedItemSchema>;
+/**
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
+ *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
+ *   Stream are two distinct surfaces with different data paths (Barazo API
+ *   for Timeline, live PDS reads + Valkey for Stream). These collapsed feed
+ *   types are no longer consumed. Scheduled for removal in next major bump.
+ */
+declare const FollowFeedItemSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodString;
+    actor: z.ZodObject<{
+        did: z.ZodString;
+        handle: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+        avatarUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    indexedAt: z.ZodString;
+    eventType: z.ZodString;
+    source: z.ZodLiteral<"sifa">;
+    appId: z.ZodOptional<z.ZodLiteral<"sifa">>;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    actor: z.ZodObject<{
+        did: z.ZodString;
+        handle: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+        avatarUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    indexedAt: z.ZodString;
+    eventType: z.ZodString;
+    source: z.ZodLiteral<"atmosphere">;
+    appId: z.ZodString;
+    uri: z.ZodOptional<z.ZodString>;
+    cid: z.ZodOptional<z.ZodString>;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>], "source">;
+/**
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
+ *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
+ *   Stream are two distinct surfaces with different data paths (Barazo API
+ *   for Timeline, live PDS reads + Valkey for Stream). These collapsed feed
+ *   types are no longer consumed. Scheduled for removal in next major bump.
+ */
+type FollowFeedItem = z.infer<typeof FollowFeedItemSchema>;
+/**
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
+ *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
+ *   Stream are two distinct surfaces with different data paths (Barazo API
+ *   for Timeline, live PDS reads + Valkey for Stream). These collapsed feed
+ *   types are no longer consumed. Scheduled for removal in next major bump.
+ */
+declare const FollowFeedPageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        id: z.ZodString;
+        actor: z.ZodObject<{
+            did: z.ZodString;
+            handle: z.ZodString;
+            displayName: z.ZodOptional<z.ZodString>;
+            avatarUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        indexedAt: z.ZodString;
+        eventType: z.ZodString;
+        source: z.ZodLiteral<"sifa">;
+        appId: z.ZodOptional<z.ZodLiteral<"sifa">>;
+        payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        actor: z.ZodObject<{
+            did: z.ZodString;
+            handle: z.ZodString;
+            displayName: z.ZodOptional<z.ZodString>;
+            avatarUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        indexedAt: z.ZodString;
+        eventType: z.ZodString;
+        source: z.ZodLiteral<"atmosphere">;
+        appId: z.ZodString;
+        uri: z.ZodOptional<z.ZodString>;
+        cid: z.ZodOptional<z.ZodString>;
+        payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>], "source">>;
+    cursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
+ *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
+ *   Stream are two distinct surfaces with different data paths (Barazo API
+ *   for Timeline, live PDS reads + Valkey for Stream). These collapsed feed
+ *   types are no longer consumed. Scheduled for removal in next major bump.
+ */
+type FollowFeedPage = z.infer<typeof FollowFeedPageSchema>;
+/**
+ * Composite feed cursor `(indexedAt DESC, source, id)`. Encoded as a
+ * URL-safe base64 string so it survives `URLSearchParams` round-trips
+ * without further encoding. Decoupling encode/decode from the API call
+ * lets consumers persist cursors (e.g. for "jump-back-here" UX) and
+ * lets us unit-test the format.
+ */
+interface FeedCursor {
+    indexedAt: string;
+    source: 'sifa' | 'atmosphere';
+    id: string;
+}
+declare function encodeFeedCursor(cursor: FeedCursor): string;
+declare function decodeFeedCursor(encoded: string): FeedCursor;
+
 /** Zod schema for `id.sifa.profile.certification` records. */
 declare const ProfileCertificationRecordSchema: z.ZodObject<{
     name: z.ZodString;
@@ -608,4 +797,4 @@ declare const ProfileInvestmentRecordSchema: z.ZodObject<{
 }, z.core.$loose>;
 type ProfileInvestmentRecord = z.infer<typeof ProfileInvestmentRecordSchema>;
 
-export { PublicationAuthorSchema as $, type ArtifactLink as A, type BlobRef as B, ProfileInvestmentRecordSchema as C, type ProfileInvolvementRecord as D, type EndorsementConfirmationRecord as E, ProfileInvolvementRecordSchema as F, type GraphFollowRecord as G, type ProfileLanguageRecord as H, InvestmentAmountSchema as I, ProfileLanguageRecordSchema as J, type ProfilePositionRecord as K, ProfilePositionRecordSchema as L, ProfilePresentationDeliveryRecordSchema as M, ProfilePresentationRecordSchema as N, type OrgProfileRecord as O, type PresentationDuration as P, type ProfileProjectRecord as Q, ProfileProjectRecordSchema as R, type ProfilePublicationRecord as S, ProfilePublicationRecordSchema as T, type ProfileSelfRecord as U, ProfileSelfRecordSchema as V, type ProfileSkillRecord as W, ProfileSkillRecordSchema as X, type ProfileVolunteeringRecord as Y, ProfileVolunteeringRecordSchema as Z, type PublicationAuthor as _, type ProfilePresentationDeliveryRecord as a, makeGraphFollowRecordSchema as a0, type ProfileInvestmentRecord as a1, type ProfilePresentationRecord as b, ArtifactLinkSchema as c, BlobRefSchema as d, EndorsementConfirmationRecordSchema as e, type EndorsementRecord as f, EndorsementRecordSchema as g, GraphFollowRecordSchema as h, type OrgEmploymentAttestationRecord as i, OrgEmploymentAttestationRecordSchema as j, OrgProfileRecordSchema as k, PROFILE_INVESTMENT_NSID as l, PROFILE_INVOLVEMENT_NSID as m, PresentationDurationSchema as n, type PresentationLink as o, PresentationLinkSchema as p, type ProfileCertificationRecord as q, ProfileCertificationRecordSchema as r, type ProfileCourseRecord as s, ProfileCourseRecordSchema as t, type ProfileEducationRecord as u, ProfileEducationRecordSchema as v, type ProfileExternalAccountRecord as w, ProfileExternalAccountRecordSchema as x, type ProfileHonorRecord as y, ProfileHonorRecordSchema as z };
+export { type ProfilePublicationRecord as $, type ArtifactLink as A, type BlobRef as B, type ProfileCourseRecord as C, ProfileCourseRecordSchema as D, type EndorsementConfirmationRecord as E, type FeedActor as F, type GraphFollowRecord as G, type ProfileEducationRecord as H, InvestmentAmountSchema as I, ProfileEducationRecordSchema as J, type ProfileExternalAccountRecord as K, ProfileExternalAccountRecordSchema as L, type ProfileHonorRecord as M, ProfileHonorRecordSchema as N, type OrgProfileRecord as O, type PresentationDuration as P, ProfileInvestmentRecordSchema as Q, type ProfileInvolvementRecord as R, ProfileInvolvementRecordSchema as S, type ProfileLanguageRecord as T, ProfileLanguageRecordSchema as U, type ProfilePositionRecord as V, ProfilePositionRecordSchema as W, ProfilePresentationDeliveryRecordSchema as X, ProfilePresentationRecordSchema as Y, type ProfileProjectRecord as Z, ProfileProjectRecordSchema as _, type ProfilePresentationDeliveryRecord as a, ProfilePublicationRecordSchema as a0, type ProfileSelfRecord as a1, ProfileSelfRecordSchema as a2, type ProfileSkillRecord as a3, ProfileSkillRecordSchema as a4, type ProfileVolunteeringRecord as a5, ProfileVolunteeringRecordSchema as a6, type PublicationAuthor as a7, PublicationAuthorSchema as a8, type SifaFeedItem as a9, SifaFeedItemSchema as aa, decodeFeedCursor as ab, encodeFeedCursor as ac, makeGraphFollowRecordSchema as ad, type ProfileInvestmentRecord as ae, type ProfilePresentationRecord as b, ArtifactLinkSchema as c, type AtmosphereFeedItem as d, AtmosphereFeedItemSchema as e, BlobRefSchema as f, EndorsementConfirmationRecordSchema as g, type EndorsementRecord as h, EndorsementRecordSchema as i, FeedActorSchema as j, type FeedCursor as k, type FollowFeedItem as l, FollowFeedItemSchema as m, type FollowFeedPage as n, FollowFeedPageSchema as o, GraphFollowRecordSchema as p, type OrgEmploymentAttestationRecord as q, OrgEmploymentAttestationRecordSchema as r, OrgProfileRecordSchema as s, PROFILE_INVESTMENT_NSID as t, PROFILE_INVOLVEMENT_NSID as u, PresentationDurationSchema as v, type PresentationLink as w, PresentationLinkSchema as x, type ProfileCertificationRecord as y, ProfileCertificationRecordSchema as z };