@singi-labs/sifa-sdk 0.12.9 → 0.12.11

package/dist/index.d.cts

@@ -1230,21 +1230,56 @@ interface StreamExternalLink {
     title?: string;
     thumb?: string;
 }
+/**
+ * One span of a rich-text body. Built from `app.bsky.richtext.facet`-style
+ * facets (byte-offset ranges over the plain `text`). Plain runs carry only
+ * `text`; enriched runs additionally carry exactly one of `link` (resolved
+ * URL), `mention` (DID), or `tag` (hashtag). `body.text` always holds the full
+ * plain string, so a renderer can ignore `richSegments` and still show content.
+ */
+interface StreamRichSegment {
+    text: string;
+    link?: string;
+    mention?: string;
+    tag?: string;
+}
+/** A geo coordinate pair (beacon `location`). */
+interface StreamGeo {
+    latitude: number;
+    longitude: number;
+}
+/** A structured postal address (beacon `addressDetails`). All parts optional. */
+interface StreamAddress {
+    name?: string;
+    street?: string;
+    locality?: string;
+    region?: string;
+    country?: string;
+    postalCode?: string;
+}
 /**
  * The primary content body. A small discriminated union so both the React and
  * the string-HTML renderer switch on one field. `track` is reserved (dame
- * music scrobbles; no sifa-web card uses it yet). App-specific variants
- * (github-pr, book, event-rsvp, ...) layer in additively in later milestones.
+ * music scrobbles; no sifa-web card uses it yet). The app-specific variants
+ * (`github-pr`, `book`, ...) carry only structured data — enums, raw NSIDs,
+ * dates, blob/URL refs — never pre-localized strings or built URLs, so each
+ * surface renders identically.
  */
 type StreamCardBody = {
     kind: 'text';
     text: string;
+    /** Facet-derived spans over `text` (links/mentions/tags). Additive. */
+    richSegments?: StreamRichSegment[];
+    /** Hashtags carried alongside the text (e.g. asq questions). */
+    tags?: string[];
 } | {
     kind: 'media';
     text?: string;
+    tags?: string[];
 } | {
     kind: 'link';
     text?: string;
+    tags?: string[];
 } | {
     kind: 'track';
     text?: string;
@@ -1253,6 +1288,98 @@ type StreamCardBody = {
 } | {
     kind: 'generic';
     text?: string;
+    tags?: string[];
+} | {
+    kind: 'github-pr';
+    repoOwner: string;
+    repoName: string;
+    prNumber: number;
+    title: string;
+    url?: string;
+    /** GitHub language name (renderer maps to a color dot). */
+    language?: string;
+    additions: number;
+    deletions: number;
+    /** The card's display date is `mergedAt`, not `createdAt`. */
+    mergedAt?: string;
+} | {
+    kind: 'book';
+    title: string;
+    authors: string[];
+    /** Rating on the lexicon's 1-10 scale. */
+    stars?: number;
+    /** Raw reading-status NSID, e.g. `buzz.bookhive.defs#finished`. */
+    status?: string;
+    review?: string;
+} | {
+    kind: 'media-review';
+    /** Which popfeed collection this came from (drives the action label). */
+    reviewKind: 'review' | 'post' | 'note' | 'other';
+    title?: string;
+    /** Raw creative-work type, e.g. `movie` (renderer maps to a label + icon). */
+    mediaType?: string;
+    /** Rating on the 1-10 scale. */
+    rating?: number;
+    mainCredit?: string;
+    reviewText?: string;
+    isRevisit: boolean;
+} | {
+    kind: 'event-rsvp';
+    rsvpStatus: 'going' | 'interested' | 'notgoing' | 'unknown';
+    eventName?: string;
+    startsAt?: string;
+    endsAt?: string;
+    mode?: 'inperson' | 'virtual' | 'hybrid';
+    locationName?: string;
+    locationLocality?: string;
+    locationCountry?: string;
+} | {
+    kind: 'verification';
+    /** Keytrace claim type (`github`, `dns`, ...) or `bluesky` for a bsky verification. */
+    platform: string;
+    verified: boolean;
+    subjectLabel?: string;
+    /** The verified handle (Bluesky verifications only). */
+    handle?: string;
+    profileUrl?: string;
+} | {
+    kind: 'membership';
+    communityName?: string;
+    description?: string;
+    /** The community record's at-uri (renderer builds the outbound link). */
+    communityUri?: string;
+} | {
+    kind: 'location';
+    venueName?: string;
+    shout?: string;
+    address?: StreamAddress;
+    geo?: StreamGeo;
+} | {
+    kind: 'travel';
+    origin?: string;
+    destination?: string;
+    /** Raw transportation mode, e.g. `flight` (renderer maps to a label). */
+    transportation?: string;
+    carrier?: string;
+    carrierCode?: string;
+    startDate?: string;
+    endDate?: string;
+} | {
+    kind: 'standard-site';
+    title?: string;
+    description?: string;
+    /** Publication base URL (renderer derives host / builds the canonical link). */
+    siteUrl?: string;
+    path?: string;
+    /** Resolved from the publisher registry when the host is allowlisted. */
+    publisherName?: string;
+    /** Publication icon — a resolved CDN URL added by AppView enrichment. */
+    icon?: string;
+    /** Document cover — a resolved CDN URL added by AppView enrichment. */
+    coverImageUrl?: string;
+    /** Estimated reading time in minutes. */
+    readingTime?: number;
+    publishedAt?: string;
 };
 /**
  * A repost / reply / quote target. Three shapes: a full post (normalized
@@ -1300,6 +1427,9 @@ declare const streamSourceSchema: z.ZodType<StreamSource>;
 declare const streamThemeSchema: z.ZodType<StreamTheme>;
 declare const streamMediaSchema: z.ZodType<StreamMedia>;
 declare const streamExternalLinkSchema: z.ZodType<StreamExternalLink>;
+declare const streamGeoSchema: z.ZodType<StreamGeo>;
+declare const streamAddressSchema: z.ZodType<StreamAddress>;
+declare const streamRichSegmentSchema: z.ZodType<StreamRichSegment>;
 declare const streamCardBodySchema: z.ZodType<StreamCardBody>;
 /**
  * A stream item's repost / reply / quote target. The `post` variant nests a
@@ -1328,8 +1458,13 @@ interface ToStreamCardVMOptions {
  *
  * Reference implementations: the generic/unknown case, `app.bsky.feed.post`
  * (text + images + external embed), and reposts (whose `subject` is normalized
- * through this same function). Other collections fall through to the generic
- * body variant until M2 enriches them.
+ * through this same function). Collections with a typed body variant
+ * (`github-pr`, `book`, `media-review`, `event-rsvp`, `verification`,
+ * `membership`, `location`, `travel`, `standard-site`) are enriched from their
+ * raw record below; `at.youandme.connection` and `fyi.asq.answer` populate a
+ * person / record `subject`. Everything else (base collections + unknown apps)
+ * flows through {@link applyGeneric}, which extracts text / media / link /
+ * subject from common record shapes, degrading to an empty generic body.
  */
 declare function toStreamCardVM(item: ActivityItem, options?: ToStreamCardVMOptions): StreamCardVM;
 /**
@@ -1807,4 +1942,4 @@ declare function groupInvolvementByHeading(items: ProfileInvolvement[]): Involve
  */
 declare const SIFA_SDK_VERSION: string;
 
-export { ACTIVITY_TIERS, ACTIVITY_VERBS, ACTIVITY_VISIBILITY_RULES, ALL_SECTIONS, APP_CATEGORIES, APP_CATEGORY_IDS, APP_CATEGORY_MAP, APP_URL_PATTERNS, ARTIFACT_LINK_KIND_LABELS, ARTIFACT_LINK_KIND_OPTIONS, type AccountVerification, type ActivityItem, type ActivityItemForUrl, type ActivityTaxonomy, type ActivityTier, type ActivityVerbMap, type AppCategoryId, type AppUrlPatterns, type ArtifactLinkKindOption, 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, type CardHealth, type CardHealthStrategy, type CompanyFirmographics, type ContinentCode, type CsvRow, DIMENSIONS_MAX_SCORE, type DimensionKey, type DimensionMap, type DisambiguationFields, EMPLOYMENT_TYPE_GROUPS, EMPLOYMENT_TYPE_LABELS, ENTITY_REF_ANCHORS, type EmploymentTypeGroup, type EmploymentTypeOption, type EntityRefAnchor, EntitySearchResult, INDUSTRY_OPTIONS, INVOLVEMENT_HEADING_ORDER, INVOLVEMENT_KIND_HEADINGS, INVOLVEMENT_KIND_LABELS, INVOLVEMENT_KIND_OPTIONS, type IndustryOption, type InvolvementGroup, type InvolvementKindOption, type KnownAppId, type LexiconEntry, LocationValue, MIN_SKILLS, type MergedProfileSkill, OPEN_TO_OPTIONS, OPEN_TO_TOKENS, OPEN_TO_TOKEN_TO_VALUE, OPEN_TO_VALUE_TO_TOKEN, type OpenToGroup, type OpenToOption, OrgProfileRecord, PLATFORM_LABELS, PLATFORM_OPTIONS, PRESENTATION_LINK_TYPE_LABELS, PRESENTATION_LINK_TYPE_OPTIONS, PRESENTATION_ROLE_LABELS, PRESENTATION_ROLE_OPTIONS, PUBLISHERS, type ParsedDelivery, type ParsedPresentation, type PdsProvider, PdsProviderInfo, type PlatformId, type PresentationDeliverySummary, PresentationDuration, type PresentationLinkTypeOption, type PresentationRoleOption, type PrimaryPositionCandidate, Profile, ProfileCertification, type ProfileCompletion, type ProfileDimensionInputs, ProfileEducation, ProfileHonor, ProfileInvolvement, ProfileLanguage, ProfilePosition, ProfilePresentationDelivery, ProfilePresentationDeliveryRecord, ProfilePresentationRecord, ProfileProject, ProfilePublication, ProfileSkill, type Publisher, type RgbColor, SECTION_GROUPS, SECTION_LABELS, SIFA_SDK_VERSION, SKILL_CATEGORIES, STANDARD_PUBLISHER_ID, STREAM_VERBS, type SectionGroupId, type SectionId, type SkillCategory, type StreamCardBody, type StreamCardSubject, type StreamCardVM, type StreamExternalLink, type StreamMedia, type StreamMediaBase, type StreamMediaBlob, type StreamMediaResolved, type StreamSource, type StreamTheme, type StreamVerb, type TierMeta, type ToStreamCardVMOptions, VERIFICATION_PROVIDERS, type VerificationProvider, type VerificationProviderId, type VerificationSource, WORKPLACE_TYPE_LABELS, WORKPLACE_TYPE_OPTIONS, type WorkplaceTypeOption, categoryForApp, certDateExtractor, classifyEntityRef, completenessPercent, completenessScore, contrastRatio, countFilledDimensions, countryCodeToFlag, dateRangeExtractor, dedupeSkills, detectPdsProvider, dimensionsFromInputs, durationFromMinutes, entityDisambiguationLabel, entityResultKey, filterHidden, findIndustry, formatCompanyName, formatDateRange, formatDistanceToNow, formatLocation, formatPresentationDuration, formatRelativeTime, formatTimelineDate, getActivityTaxonomyVersion, getActivityTier, getActivityVerbsVersion, getAppCategoryIcon, getAppIdForCollection, getArtifactLinkKindLabel, getCalendarEventModeLabel, getCalendarEventStatusLabel, getContinent, getDisplayLabel, getEmploymentTypeLabel, getFaviconUrl, getFilledDimensionsMap, getHandleStem, getIndustryLabelKey, getInvolvementKindHeading, getInvolvementKindLabel, getLexiconEntry, getOpenToLabelKey, getPdsDisplayName, getPlatformLabel, getPresentationLinkTypeLabel, getPresentationRoleLabel, getPublisherByHost, getPublisherById, getPublisherFromSiteUrl, getTierMeta, getVerificationProvider, getVisibleSectionIds, getWorkplaceTypeLabel, groupInvolvementByHeading, groupSkillsByCategory, hoistPrimary, isAppCategory, isCompanyPageIndexable, isCompanyRequired, isKnownAppId, isKnownPlatform, isKnownVerificationProvider, isLinked, isPseudoEmployer, isRegistrableDomainHandle, isSectionPopulated, isValidRgbColor, isVisibleActivityItem, lexiconDateExtractor, limitCombiningMarks, looksLikeDomain, meetsContrastAA, normalizeCompanyKey, normalizeLegalForm, normalizeOpenTo, normalizePlatformId, normalizePresentationMode, normalizePresentationRole, normalizeWorkplaceTypes, openToTokenToValue, openToValueToToken, parseIntendedAudiences, parseLocationString, parsePresentationDuration, pdsProviderFromApi, pickPrimaryPosition, presentationCsvRowToRecord, presentationDeliveryCsvRowToRecord, primaryVerification, profileToDimensionInputs, qualifiesAsOrg, relativeLuminance, resolveCardHealth, resolveCardUrl, resolveVerifierProvider, rgbToString, sanitizeDisplayText, sanitizeHandleInput, searchResultDisambiguation, singleDateExtractor, sortByActiveDateRange, sortByDateDesc, sortCertifications, sortEducation, sortHonors, sortLanguages, sortLanguagesByProficiency, sortPositions, sortProjects, sortPublications, streamCardBodySchema, streamCardSubjectSchema, streamCardVMSchema, streamExternalLinkSchema, streamMediaSchema, streamSourceSchema, streamThemeSchema, streamVerbSchema, stripHtmlToText, summarizePresentationDeliveries, toStreamCardVM, toStreamCardVMs, truncateGraphemes, verbForCollection, visibleItems };
+export { ACTIVITY_TIERS, ACTIVITY_VERBS, ACTIVITY_VISIBILITY_RULES, ALL_SECTIONS, APP_CATEGORIES, APP_CATEGORY_IDS, APP_CATEGORY_MAP, APP_URL_PATTERNS, ARTIFACT_LINK_KIND_LABELS, ARTIFACT_LINK_KIND_OPTIONS, type AccountVerification, type ActivityItem, type ActivityItemForUrl, type ActivityTaxonomy, type ActivityTier, type ActivityVerbMap, type AppCategoryId, type AppUrlPatterns, type ArtifactLinkKindOption, 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, type CardHealth, type CardHealthStrategy, type CompanyFirmographics, type ContinentCode, type CsvRow, DIMENSIONS_MAX_SCORE, type DimensionKey, type DimensionMap, type DisambiguationFields, EMPLOYMENT_TYPE_GROUPS, EMPLOYMENT_TYPE_LABELS, ENTITY_REF_ANCHORS, type EmploymentTypeGroup, type EmploymentTypeOption, type EntityRefAnchor, EntitySearchResult, INDUSTRY_OPTIONS, INVOLVEMENT_HEADING_ORDER, INVOLVEMENT_KIND_HEADINGS, INVOLVEMENT_KIND_LABELS, INVOLVEMENT_KIND_OPTIONS, type IndustryOption, type InvolvementGroup, type InvolvementKindOption, type KnownAppId, type LexiconEntry, LocationValue, MIN_SKILLS, type MergedProfileSkill, OPEN_TO_OPTIONS, OPEN_TO_TOKENS, OPEN_TO_TOKEN_TO_VALUE, OPEN_TO_VALUE_TO_TOKEN, type OpenToGroup, type OpenToOption, OrgProfileRecord, PLATFORM_LABELS, PLATFORM_OPTIONS, PRESENTATION_LINK_TYPE_LABELS, PRESENTATION_LINK_TYPE_OPTIONS, PRESENTATION_ROLE_LABELS, PRESENTATION_ROLE_OPTIONS, PUBLISHERS, type ParsedDelivery, type ParsedPresentation, type PdsProvider, PdsProviderInfo, type PlatformId, type PresentationDeliverySummary, PresentationDuration, type PresentationLinkTypeOption, type PresentationRoleOption, type PrimaryPositionCandidate, Profile, ProfileCertification, type ProfileCompletion, type ProfileDimensionInputs, ProfileEducation, ProfileHonor, ProfileInvolvement, ProfileLanguage, ProfilePosition, ProfilePresentationDelivery, ProfilePresentationDeliveryRecord, ProfilePresentationRecord, ProfileProject, ProfilePublication, ProfileSkill, type Publisher, type RgbColor, SECTION_GROUPS, SECTION_LABELS, SIFA_SDK_VERSION, SKILL_CATEGORIES, STANDARD_PUBLISHER_ID, STREAM_VERBS, type SectionGroupId, type SectionId, type SkillCategory, type StreamAddress, type StreamCardBody, type StreamCardSubject, type StreamCardVM, type StreamExternalLink, type StreamGeo, type StreamMedia, type StreamMediaBase, type StreamMediaBlob, type StreamMediaResolved, type StreamRichSegment, type StreamSource, type StreamTheme, type StreamVerb, type TierMeta, type ToStreamCardVMOptions, VERIFICATION_PROVIDERS, type VerificationProvider, type VerificationProviderId, type VerificationSource, WORKPLACE_TYPE_LABELS, WORKPLACE_TYPE_OPTIONS, type WorkplaceTypeOption, categoryForApp, certDateExtractor, classifyEntityRef, completenessPercent, completenessScore, contrastRatio, countFilledDimensions, countryCodeToFlag, dateRangeExtractor, dedupeSkills, detectPdsProvider, dimensionsFromInputs, durationFromMinutes, entityDisambiguationLabel, entityResultKey, filterHidden, findIndustry, formatCompanyName, formatDateRange, formatDistanceToNow, formatLocation, formatPresentationDuration, formatRelativeTime, formatTimelineDate, getActivityTaxonomyVersion, getActivityTier, getActivityVerbsVersion, getAppCategoryIcon, getAppIdForCollection, getArtifactLinkKindLabel, getCalendarEventModeLabel, getCalendarEventStatusLabel, getContinent, getDisplayLabel, getEmploymentTypeLabel, getFaviconUrl, getFilledDimensionsMap, getHandleStem, getIndustryLabelKey, getInvolvementKindHeading, getInvolvementKindLabel, getLexiconEntry, getOpenToLabelKey, getPdsDisplayName, getPlatformLabel, getPresentationLinkTypeLabel, getPresentationRoleLabel, getPublisherByHost, getPublisherById, getPublisherFromSiteUrl, getTierMeta, getVerificationProvider, getVisibleSectionIds, getWorkplaceTypeLabel, groupInvolvementByHeading, groupSkillsByCategory, hoistPrimary, isAppCategory, isCompanyPageIndexable, isCompanyRequired, isKnownAppId, isKnownPlatform, isKnownVerificationProvider, isLinked, isPseudoEmployer, isRegistrableDomainHandle, isSectionPopulated, isValidRgbColor, isVisibleActivityItem, lexiconDateExtractor, limitCombiningMarks, looksLikeDomain, meetsContrastAA, normalizeCompanyKey, normalizeLegalForm, normalizeOpenTo, normalizePlatformId, normalizePresentationMode, normalizePresentationRole, normalizeWorkplaceTypes, openToTokenToValue, openToValueToToken, parseIntendedAudiences, parseLocationString, parsePresentationDuration, pdsProviderFromApi, pickPrimaryPosition, presentationCsvRowToRecord, presentationDeliveryCsvRowToRecord, primaryVerification, profileToDimensionInputs, qualifiesAsOrg, relativeLuminance, resolveCardHealth, resolveCardUrl, resolveVerifierProvider, rgbToString, sanitizeDisplayText, sanitizeHandleInput, searchResultDisambiguation, singleDateExtractor, sortByActiveDateRange, sortByDateDesc, sortCertifications, sortEducation, sortHonors, sortLanguages, sortLanguagesByProficiency, sortPositions, sortProjects, sortPublications, streamAddressSchema, streamCardBodySchema, streamCardSubjectSchema, streamCardVMSchema, streamExternalLinkSchema, streamGeoSchema, streamMediaSchema, streamRichSegmentSchema, streamSourceSchema, streamThemeSchema, streamVerbSchema, stripHtmlToText, summarizePresentationDeliveries, toStreamCardVM, toStreamCardVMs, truncateGraphemes, verbForCollection, visibleItems };

package/dist/index.d.ts

@@ -1230,21 +1230,56 @@ interface StreamExternalLink {
     title?: string;
     thumb?: string;
 }
+/**
+ * One span of a rich-text body. Built from `app.bsky.richtext.facet`-style
+ * facets (byte-offset ranges over the plain `text`). Plain runs carry only
+ * `text`; enriched runs additionally carry exactly one of `link` (resolved
+ * URL), `mention` (DID), or `tag` (hashtag). `body.text` always holds the full
+ * plain string, so a renderer can ignore `richSegments` and still show content.
+ */
+interface StreamRichSegment {
+    text: string;
+    link?: string;
+    mention?: string;
+    tag?: string;
+}
+/** A geo coordinate pair (beacon `location`). */
+interface StreamGeo {
+    latitude: number;
+    longitude: number;
+}
+/** A structured postal address (beacon `addressDetails`). All parts optional. */
+interface StreamAddress {
+    name?: string;
+    street?: string;
+    locality?: string;
+    region?: string;
+    country?: string;
+    postalCode?: string;
+}
 /**
  * The primary content body. A small discriminated union so both the React and
  * the string-HTML renderer switch on one field. `track` is reserved (dame
- * music scrobbles; no sifa-web card uses it yet). App-specific variants
- * (github-pr, book, event-rsvp, ...) layer in additively in later milestones.
+ * music scrobbles; no sifa-web card uses it yet). The app-specific variants
+ * (`github-pr`, `book`, ...) carry only structured data — enums, raw NSIDs,
+ * dates, blob/URL refs — never pre-localized strings or built URLs, so each
+ * surface renders identically.
  */
 type StreamCardBody = {
     kind: 'text';
     text: string;
+    /** Facet-derived spans over `text` (links/mentions/tags). Additive. */
+    richSegments?: StreamRichSegment[];
+    /** Hashtags carried alongside the text (e.g. asq questions). */
+    tags?: string[];
 } | {
     kind: 'media';
     text?: string;
+    tags?: string[];
 } | {
     kind: 'link';
     text?: string;
+    tags?: string[];
 } | {
     kind: 'track';
     text?: string;
@@ -1253,6 +1288,98 @@ type StreamCardBody = {
 } | {
     kind: 'generic';
     text?: string;
+    tags?: string[];
+} | {
+    kind: 'github-pr';
+    repoOwner: string;
+    repoName: string;
+    prNumber: number;
+    title: string;
+    url?: string;
+    /** GitHub language name (renderer maps to a color dot). */
+    language?: string;
+    additions: number;
+    deletions: number;
+    /** The card's display date is `mergedAt`, not `createdAt`. */
+    mergedAt?: string;
+} | {
+    kind: 'book';
+    title: string;
+    authors: string[];
+    /** Rating on the lexicon's 1-10 scale. */
+    stars?: number;
+    /** Raw reading-status NSID, e.g. `buzz.bookhive.defs#finished`. */
+    status?: string;
+    review?: string;
+} | {
+    kind: 'media-review';
+    /** Which popfeed collection this came from (drives the action label). */
+    reviewKind: 'review' | 'post' | 'note' | 'other';
+    title?: string;
+    /** Raw creative-work type, e.g. `movie` (renderer maps to a label + icon). */
+    mediaType?: string;
+    /** Rating on the 1-10 scale. */
+    rating?: number;
+    mainCredit?: string;
+    reviewText?: string;
+    isRevisit: boolean;
+} | {
+    kind: 'event-rsvp';
+    rsvpStatus: 'going' | 'interested' | 'notgoing' | 'unknown';
+    eventName?: string;
+    startsAt?: string;
+    endsAt?: string;
+    mode?: 'inperson' | 'virtual' | 'hybrid';
+    locationName?: string;
+    locationLocality?: string;
+    locationCountry?: string;
+} | {
+    kind: 'verification';
+    /** Keytrace claim type (`github`, `dns`, ...) or `bluesky` for a bsky verification. */
+    platform: string;
+    verified: boolean;
+    subjectLabel?: string;
+    /** The verified handle (Bluesky verifications only). */
+    handle?: string;
+    profileUrl?: string;
+} | {
+    kind: 'membership';
+    communityName?: string;
+    description?: string;
+    /** The community record's at-uri (renderer builds the outbound link). */
+    communityUri?: string;
+} | {
+    kind: 'location';
+    venueName?: string;
+    shout?: string;
+    address?: StreamAddress;
+    geo?: StreamGeo;
+} | {
+    kind: 'travel';
+    origin?: string;
+    destination?: string;
+    /** Raw transportation mode, e.g. `flight` (renderer maps to a label). */
+    transportation?: string;
+    carrier?: string;
+    carrierCode?: string;
+    startDate?: string;
+    endDate?: string;
+} | {
+    kind: 'standard-site';
+    title?: string;
+    description?: string;
+    /** Publication base URL (renderer derives host / builds the canonical link). */
+    siteUrl?: string;
+    path?: string;
+    /** Resolved from the publisher registry when the host is allowlisted. */
+    publisherName?: string;
+    /** Publication icon — a resolved CDN URL added by AppView enrichment. */
+    icon?: string;
+    /** Document cover — a resolved CDN URL added by AppView enrichment. */
+    coverImageUrl?: string;
+    /** Estimated reading time in minutes. */
+    readingTime?: number;
+    publishedAt?: string;
 };
 /**
  * A repost / reply / quote target. Three shapes: a full post (normalized
@@ -1300,6 +1427,9 @@ declare const streamSourceSchema: z.ZodType<StreamSource>;
 declare const streamThemeSchema: z.ZodType<StreamTheme>;
 declare const streamMediaSchema: z.ZodType<StreamMedia>;
 declare const streamExternalLinkSchema: z.ZodType<StreamExternalLink>;
+declare const streamGeoSchema: z.ZodType<StreamGeo>;
+declare const streamAddressSchema: z.ZodType<StreamAddress>;
+declare const streamRichSegmentSchema: z.ZodType<StreamRichSegment>;
 declare const streamCardBodySchema: z.ZodType<StreamCardBody>;
 /**
  * A stream item's repost / reply / quote target. The `post` variant nests a
@@ -1328,8 +1458,13 @@ interface ToStreamCardVMOptions {
  *
  * Reference implementations: the generic/unknown case, `app.bsky.feed.post`
  * (text + images + external embed), and reposts (whose `subject` is normalized
- * through this same function). Other collections fall through to the generic
- * body variant until M2 enriches them.
+ * through this same function). Collections with a typed body variant
+ * (`github-pr`, `book`, `media-review`, `event-rsvp`, `verification`,
+ * `membership`, `location`, `travel`, `standard-site`) are enriched from their
+ * raw record below; `at.youandme.connection` and `fyi.asq.answer` populate a
+ * person / record `subject`. Everything else (base collections + unknown apps)
+ * flows through {@link applyGeneric}, which extracts text / media / link /
+ * subject from common record shapes, degrading to an empty generic body.
  */
 declare function toStreamCardVM(item: ActivityItem, options?: ToStreamCardVMOptions): StreamCardVM;
 /**
@@ -1807,4 +1942,4 @@ declare function groupInvolvementByHeading(items: ProfileInvolvement[]): Involve
  */
 declare const SIFA_SDK_VERSION: string;
 
-export { ACTIVITY_TIERS, ACTIVITY_VERBS, ACTIVITY_VISIBILITY_RULES, ALL_SECTIONS, APP_CATEGORIES, APP_CATEGORY_IDS, APP_CATEGORY_MAP, APP_URL_PATTERNS, ARTIFACT_LINK_KIND_LABELS, ARTIFACT_LINK_KIND_OPTIONS, type AccountVerification, type ActivityItem, type ActivityItemForUrl, type ActivityTaxonomy, type ActivityTier, type ActivityVerbMap, type AppCategoryId, type AppUrlPatterns, type ArtifactLinkKindOption, 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, type CardHealth, type CardHealthStrategy, type CompanyFirmographics, type ContinentCode, type CsvRow, DIMENSIONS_MAX_SCORE, type DimensionKey, type DimensionMap, type DisambiguationFields, EMPLOYMENT_TYPE_GROUPS, EMPLOYMENT_TYPE_LABELS, ENTITY_REF_ANCHORS, type EmploymentTypeGroup, type EmploymentTypeOption, type EntityRefAnchor, EntitySearchResult, INDUSTRY_OPTIONS, INVOLVEMENT_HEADING_ORDER, INVOLVEMENT_KIND_HEADINGS, INVOLVEMENT_KIND_LABELS, INVOLVEMENT_KIND_OPTIONS, type IndustryOption, type InvolvementGroup, type InvolvementKindOption, type KnownAppId, type LexiconEntry, LocationValue, MIN_SKILLS, type MergedProfileSkill, OPEN_TO_OPTIONS, OPEN_TO_TOKENS, OPEN_TO_TOKEN_TO_VALUE, OPEN_TO_VALUE_TO_TOKEN, type OpenToGroup, type OpenToOption, OrgProfileRecord, PLATFORM_LABELS, PLATFORM_OPTIONS, PRESENTATION_LINK_TYPE_LABELS, PRESENTATION_LINK_TYPE_OPTIONS, PRESENTATION_ROLE_LABELS, PRESENTATION_ROLE_OPTIONS, PUBLISHERS, type ParsedDelivery, type ParsedPresentation, type PdsProvider, PdsProviderInfo, type PlatformId, type PresentationDeliverySummary, PresentationDuration, type PresentationLinkTypeOption, type PresentationRoleOption, type PrimaryPositionCandidate, Profile, ProfileCertification, type ProfileCompletion, type ProfileDimensionInputs, ProfileEducation, ProfileHonor, ProfileInvolvement, ProfileLanguage, ProfilePosition, ProfilePresentationDelivery, ProfilePresentationDeliveryRecord, ProfilePresentationRecord, ProfileProject, ProfilePublication, ProfileSkill, type Publisher, type RgbColor, SECTION_GROUPS, SECTION_LABELS, SIFA_SDK_VERSION, SKILL_CATEGORIES, STANDARD_PUBLISHER_ID, STREAM_VERBS, type SectionGroupId, type SectionId, type SkillCategory, type StreamCardBody, type StreamCardSubject, type StreamCardVM, type StreamExternalLink, type StreamMedia, type StreamMediaBase, type StreamMediaBlob, type StreamMediaResolved, type StreamSource, type StreamTheme, type StreamVerb, type TierMeta, type ToStreamCardVMOptions, VERIFICATION_PROVIDERS, type VerificationProvider, type VerificationProviderId, type VerificationSource, WORKPLACE_TYPE_LABELS, WORKPLACE_TYPE_OPTIONS, type WorkplaceTypeOption, categoryForApp, certDateExtractor, classifyEntityRef, completenessPercent, completenessScore, contrastRatio, countFilledDimensions, countryCodeToFlag, dateRangeExtractor, dedupeSkills, detectPdsProvider, dimensionsFromInputs, durationFromMinutes, entityDisambiguationLabel, entityResultKey, filterHidden, findIndustry, formatCompanyName, formatDateRange, formatDistanceToNow, formatLocation, formatPresentationDuration, formatRelativeTime, formatTimelineDate, getActivityTaxonomyVersion, getActivityTier, getActivityVerbsVersion, getAppCategoryIcon, getAppIdForCollection, getArtifactLinkKindLabel, getCalendarEventModeLabel, getCalendarEventStatusLabel, getContinent, getDisplayLabel, getEmploymentTypeLabel, getFaviconUrl, getFilledDimensionsMap, getHandleStem, getIndustryLabelKey, getInvolvementKindHeading, getInvolvementKindLabel, getLexiconEntry, getOpenToLabelKey, getPdsDisplayName, getPlatformLabel, getPresentationLinkTypeLabel, getPresentationRoleLabel, getPublisherByHost, getPublisherById, getPublisherFromSiteUrl, getTierMeta, getVerificationProvider, getVisibleSectionIds, getWorkplaceTypeLabel, groupInvolvementByHeading, groupSkillsByCategory, hoistPrimary, isAppCategory, isCompanyPageIndexable, isCompanyRequired, isKnownAppId, isKnownPlatform, isKnownVerificationProvider, isLinked, isPseudoEmployer, isRegistrableDomainHandle, isSectionPopulated, isValidRgbColor, isVisibleActivityItem, lexiconDateExtractor, limitCombiningMarks, looksLikeDomain, meetsContrastAA, normalizeCompanyKey, normalizeLegalForm, normalizeOpenTo, normalizePlatformId, normalizePresentationMode, normalizePresentationRole, normalizeWorkplaceTypes, openToTokenToValue, openToValueToToken, parseIntendedAudiences, parseLocationString, parsePresentationDuration, pdsProviderFromApi, pickPrimaryPosition, presentationCsvRowToRecord, presentationDeliveryCsvRowToRecord, primaryVerification, profileToDimensionInputs, qualifiesAsOrg, relativeLuminance, resolveCardHealth, resolveCardUrl, resolveVerifierProvider, rgbToString, sanitizeDisplayText, sanitizeHandleInput, searchResultDisambiguation, singleDateExtractor, sortByActiveDateRange, sortByDateDesc, sortCertifications, sortEducation, sortHonors, sortLanguages, sortLanguagesByProficiency, sortPositions, sortProjects, sortPublications, streamCardBodySchema, streamCardSubjectSchema, streamCardVMSchema, streamExternalLinkSchema, streamMediaSchema, streamSourceSchema, streamThemeSchema, streamVerbSchema, stripHtmlToText, summarizePresentationDeliveries, toStreamCardVM, toStreamCardVMs, truncateGraphemes, verbForCollection, visibleItems };
+export { ACTIVITY_TIERS, ACTIVITY_VERBS, ACTIVITY_VISIBILITY_RULES, ALL_SECTIONS, APP_CATEGORIES, APP_CATEGORY_IDS, APP_CATEGORY_MAP, APP_URL_PATTERNS, ARTIFACT_LINK_KIND_LABELS, ARTIFACT_LINK_KIND_OPTIONS, type AccountVerification, type ActivityItem, type ActivityItemForUrl, type ActivityTaxonomy, type ActivityTier, type ActivityVerbMap, type AppCategoryId, type AppUrlPatterns, type ArtifactLinkKindOption, 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, type CardHealth, type CardHealthStrategy, type CompanyFirmographics, type ContinentCode, type CsvRow, DIMENSIONS_MAX_SCORE, type DimensionKey, type DimensionMap, type DisambiguationFields, EMPLOYMENT_TYPE_GROUPS, EMPLOYMENT_TYPE_LABELS, ENTITY_REF_ANCHORS, type EmploymentTypeGroup, type EmploymentTypeOption, type EntityRefAnchor, EntitySearchResult, INDUSTRY_OPTIONS, INVOLVEMENT_HEADING_ORDER, INVOLVEMENT_KIND_HEADINGS, INVOLVEMENT_KIND_LABELS, INVOLVEMENT_KIND_OPTIONS, type IndustryOption, type InvolvementGroup, type InvolvementKindOption, type KnownAppId, type LexiconEntry, LocationValue, MIN_SKILLS, type MergedProfileSkill, OPEN_TO_OPTIONS, OPEN_TO_TOKENS, OPEN_TO_TOKEN_TO_VALUE, OPEN_TO_VALUE_TO_TOKEN, type OpenToGroup, type OpenToOption, OrgProfileRecord, PLATFORM_LABELS, PLATFORM_OPTIONS, PRESENTATION_LINK_TYPE_LABELS, PRESENTATION_LINK_TYPE_OPTIONS, PRESENTATION_ROLE_LABELS, PRESENTATION_ROLE_OPTIONS, PUBLISHERS, type ParsedDelivery, type ParsedPresentation, type PdsProvider, PdsProviderInfo, type PlatformId, type PresentationDeliverySummary, PresentationDuration, type PresentationLinkTypeOption, type PresentationRoleOption, type PrimaryPositionCandidate, Profile, ProfileCertification, type ProfileCompletion, type ProfileDimensionInputs, ProfileEducation, ProfileHonor, ProfileInvolvement, ProfileLanguage, ProfilePosition, ProfilePresentationDelivery, ProfilePresentationDeliveryRecord, ProfilePresentationRecord, ProfileProject, ProfilePublication, ProfileSkill, type Publisher, type RgbColor, SECTION_GROUPS, SECTION_LABELS, SIFA_SDK_VERSION, SKILL_CATEGORIES, STANDARD_PUBLISHER_ID, STREAM_VERBS, type SectionGroupId, type SectionId, type SkillCategory, type StreamAddress, type StreamCardBody, type StreamCardSubject, type StreamCardVM, type StreamExternalLink, type StreamGeo, type StreamMedia, type StreamMediaBase, type StreamMediaBlob, type StreamMediaResolved, type StreamRichSegment, type StreamSource, type StreamTheme, type StreamVerb, type TierMeta, type ToStreamCardVMOptions, VERIFICATION_PROVIDERS, type VerificationProvider, type VerificationProviderId, type VerificationSource, WORKPLACE_TYPE_LABELS, WORKPLACE_TYPE_OPTIONS, type WorkplaceTypeOption, categoryForApp, certDateExtractor, classifyEntityRef, completenessPercent, completenessScore, contrastRatio, countFilledDimensions, countryCodeToFlag, dateRangeExtractor, dedupeSkills, detectPdsProvider, dimensionsFromInputs, durationFromMinutes, entityDisambiguationLabel, entityResultKey, filterHidden, findIndustry, formatCompanyName, formatDateRange, formatDistanceToNow, formatLocation, formatPresentationDuration, formatRelativeTime, formatTimelineDate, getActivityTaxonomyVersion, getActivityTier, getActivityVerbsVersion, getAppCategoryIcon, getAppIdForCollection, getArtifactLinkKindLabel, getCalendarEventModeLabel, getCalendarEventStatusLabel, getContinent, getDisplayLabel, getEmploymentTypeLabel, getFaviconUrl, getFilledDimensionsMap, getHandleStem, getIndustryLabelKey, getInvolvementKindHeading, getInvolvementKindLabel, getLexiconEntry, getOpenToLabelKey, getPdsDisplayName, getPlatformLabel, getPresentationLinkTypeLabel, getPresentationRoleLabel, getPublisherByHost, getPublisherById, getPublisherFromSiteUrl, getTierMeta, getVerificationProvider, getVisibleSectionIds, getWorkplaceTypeLabel, groupInvolvementByHeading, groupSkillsByCategory, hoistPrimary, isAppCategory, isCompanyPageIndexable, isCompanyRequired, isKnownAppId, isKnownPlatform, isKnownVerificationProvider, isLinked, isPseudoEmployer, isRegistrableDomainHandle, isSectionPopulated, isValidRgbColor, isVisibleActivityItem, lexiconDateExtractor, limitCombiningMarks, looksLikeDomain, meetsContrastAA, normalizeCompanyKey, normalizeLegalForm, normalizeOpenTo, normalizePlatformId, normalizePresentationMode, normalizePresentationRole, normalizeWorkplaceTypes, openToTokenToValue, openToValueToToken, parseIntendedAudiences, parseLocationString, parsePresentationDuration, pdsProviderFromApi, pickPrimaryPosition, presentationCsvRowToRecord, presentationDeliveryCsvRowToRecord, primaryVerification, profileToDimensionInputs, qualifiesAsOrg, relativeLuminance, resolveCardHealth, resolveCardUrl, resolveVerifierProvider, rgbToString, sanitizeDisplayText, sanitizeHandleInput, searchResultDisambiguation, singleDateExtractor, sortByActiveDateRange, sortByDateDesc, sortCertifications, sortEducation, sortHonors, sortLanguages, sortLanguagesByProficiency, sortPositions, sortProjects, sortPublications, streamAddressSchema, streamCardBodySchema, streamCardSubjectSchema, streamCardVMSchema, streamExternalLinkSchema, streamGeoSchema, streamMediaSchema, streamRichSegmentSchema, streamSourceSchema, streamThemeSchema, streamVerbSchema, stripHtmlToText, summarizePresentationDeliveries, toStreamCardVM, toStreamCardVMs, truncateGraphemes, verbForCollection, visibleItems };