@singi-labs/sifa-sdk 0.12.14 → 0.12.16

package/dist/index.d.cts

@@ -158,15 +158,6 @@ declare const PLATFORM_LABELS: {
     readonly keyoxide: "Keyoxide";
 };
 type PlatformId = keyof typeof PLATFORM_LABELS;
-/**
- * Normalize a platform value to the short code used throughout the app (the
- * editor, the API `VALID_PLATFORMS` enum, the DB, and {@link PLATFORM_LABELS}).
- *
- * External-account records may carry `platform` as the raw lexicon knownValue
- * token (`id.sifa.defs#platformLinkedin`) instead of the short code — written by
- * some third-party apps. This maps the token to its lowercase suffix
- * (`linkedin`) and passes short codes / unknown values through unchanged.
- */
 declare function normalizePlatformId(platform: string): string;
 declare function isKnownPlatform(platform: string): platform is PlatformId;
 declare function getPlatformLabel(platform: string): string;
@@ -1191,6 +1182,13 @@ interface ActivityItem {
     rkey: string;
     /** The raw record from the PDS / AppView. Parsed defensively by the transform. */
     record: unknown;
+    /**
+     * The record author's handle, injected by the AppView. The activity snapshot
+     * is per-author, so the api sets this per item (and per `subject` item) to let
+     * handle-keyed apps (Bluesky, Popfeed, Tangled, ...) resolve a `sourceUrl`.
+     * Absent when the handle is unknown; the transform then relies on the DID.
+     */
+    authorHandle?: string;
     /** App id from the app registry, e.g. `bluesky`. */
     appId: string;
     /** Human app name from the app registry, e.g. `Bluesky`. */
@@ -1487,6 +1485,13 @@ interface StreamCardVM {
     timestamp: string;
     /** Human sentence fragment, verb-aware. */
     title: string;
+    /**
+     * Canonical http(s) permalink to this record on its source app (e.g. a
+     * Bluesky post's `bsky.app` URL). Absent when no linkable URL is available —
+     * see {@link resolveCardUrl}, which keys some apps on the author handle the
+     * transform may not have. Consumers use this to make the card click through.
+     */
+    sourceUrl?: string;
     body?: StreamCardBody;
     media?: StreamMedia[];
     externalLink?: StreamExternalLink;

package/dist/index.d.ts

@@ -158,15 +158,6 @@ declare const PLATFORM_LABELS: {
     readonly keyoxide: "Keyoxide";
 };
 type PlatformId = keyof typeof PLATFORM_LABELS;
-/**
- * Normalize a platform value to the short code used throughout the app (the
- * editor, the API `VALID_PLATFORMS` enum, the DB, and {@link PLATFORM_LABELS}).
- *
- * External-account records may carry `platform` as the raw lexicon knownValue
- * token (`id.sifa.defs#platformLinkedin`) instead of the short code — written by
- * some third-party apps. This maps the token to its lowercase suffix
- * (`linkedin`) and passes short codes / unknown values through unchanged.
- */
 declare function normalizePlatformId(platform: string): string;
 declare function isKnownPlatform(platform: string): platform is PlatformId;
 declare function getPlatformLabel(platform: string): string;
@@ -1191,6 +1182,13 @@ interface ActivityItem {
     rkey: string;
     /** The raw record from the PDS / AppView. Parsed defensively by the transform. */
     record: unknown;
+    /**
+     * The record author's handle, injected by the AppView. The activity snapshot
+     * is per-author, so the api sets this per item (and per `subject` item) to let
+     * handle-keyed apps (Bluesky, Popfeed, Tangled, ...) resolve a `sourceUrl`.
+     * Absent when the handle is unknown; the transform then relies on the DID.
+     */
+    authorHandle?: string;
     /** App id from the app registry, e.g. `bluesky`. */
     appId: string;
     /** Human app name from the app registry, e.g. `Bluesky`. */
@@ -1487,6 +1485,13 @@ interface StreamCardVM {
     timestamp: string;
     /** Human sentence fragment, verb-aware. */
     title: string;
+    /**
+     * Canonical http(s) permalink to this record on its source app (e.g. a
+     * Bluesky post's `bsky.app` URL). Absent when no linkable URL is available —
+     * see {@link resolveCardUrl}, which keys some apps on the author handle the
+     * transform may not have. Consumers use this to make the card click through.
+     */
+    sourceUrl?: string;
     body?: StreamCardBody;
     media?: StreamMedia[];
     externalLink?: StreamExternalLink;

package/dist/index.js

@@ -803,11 +803,13 @@ var PLATFORM_LABELS = {
   keyoxide: "Keyoxide"
 };
 var PLATFORM_TOKEN_PREFIX = "id.sifa.defs#platform";
+var PLATFORM_ALIASES = {
+  activitypub: "fediverse",
+  mastodon: "fediverse"
+};
 function normalizePlatformId(platform) {
-  if (platform.startsWith(PLATFORM_TOKEN_PREFIX)) {
-    return platform.slice(PLATFORM_TOKEN_PREFIX.length).toLowerCase();
-  }
-  return platform;
+  const code = platform.startsWith(PLATFORM_TOKEN_PREFIX) ? platform.slice(PLATFORM_TOKEN_PREFIX.length).toLowerCase() : platform;
+  return PLATFORM_ALIASES[code.toLowerCase()] ?? code;
 }
 function isKnownPlatform(platform) {
   return platform in PLATFORM_LABELS;
@@ -3009,6 +3011,7 @@ var streamCardVMSchema = z.lazy(
     tier: z.enum(["creation", "action", "filtered"]),
     timestamp: z.string(),
     title: z.string(),
+    sourceUrl: z.string().optional(),
     body: streamCardBodySchema.optional(),
     media: z.array(streamMediaSchema).optional(),
     externalLink: streamExternalLinkSchema.optional(),
@@ -3184,6 +3187,20 @@ var TITLE_BY_VERB = {
 function buildTitle(verb, label) {
   return TITLE_BY_VERB[verb](label);
 }
+function resolveSourceUrl(item, record) {
+  const authorDid = didFromUri(item.uri);
+  if (!authorDid) return void 0;
+  const authorHandle = asNonEmptyString(item.authorHandle) ?? asNonEmptyString(record.handle);
+  const url = resolveCardUrl({
+    collection: item.collection,
+    record,
+    uri: item.uri,
+    rkey: item.rkey,
+    authorDid,
+    ...authorHandle ? { authorHandle } : {}
+  });
+  return url && /^https?:\/\//i.test(url) ? url : void 0;
+}
 function readTheme(record) {
   const theme = asRecord(record?.publicationTheme ?? record?.theme);
   if (!theme) return void 0;
@@ -3681,6 +3698,10 @@ function toStreamCardVM(item, options = {}) {
   };
   const theme = readTheme(record);
   if (theme) vm.theme = theme;
+  if (record) {
+    const sourceUrl = resolveSourceUrl(item, record);
+    if (sourceUrl) vm.sourceUrl = sourceUrl;
+  }
   if (item.subject) {
     vm.subject = { kind: "post", post: toStreamCardVM(item.subject, options) };
   }
@@ -4542,7 +4563,7 @@ var ProfileVolunteeringRecordSchema = z.object({
 });
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.12.14";
+var SIFA_SDK_VERSION = "0.12.16";
 
 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, INVOLVEMENT_HEADING_ORDER, INVOLVEMENT_KIND_HEADINGS, INVOLVEMENT_KIND_LABELS, INVOLVEMENT_KIND_OPTIONS, MIN_SKILLS, 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_INVOLVEMENT_NSID, PUBLISHERS, PresentationDurationSchema, PresentationLinkSchema, ProfileCertificationRecordSchema, ProfileCourseRecordSchema, ProfileEducationRecordSchema, ProfileExternalAccountRecordSchema, ProfileHonorRecordSchema, ProfileInvolvementRecordSchema, ProfileLanguageRecordSchema, ProfilePositionRecordSchema, ProfilePresentationDeliveryRecordSchema, ProfilePresentationRecordSchema, ProfileProjectRecordSchema, ProfilePublicationRecordSchema, ProfileSelfRecordSchema, ProfileSkillRecordSchema, ProfileVolunteeringRecordSchema, PublicationAuthorSchema, SECTION_GROUPS, SECTION_LABELS, SIFA_SDK_VERSION, SKILL_CATEGORIES, STANDARD_PUBLISHER_ID, STREAM_VERBS, SifaFeedItemSchema, VERIFICATION_PROVIDERS, WORKPLACE_TYPE_LABELS, WORKPLACE_TYPE_OPTIONS, atUriSchema, buildTalkSlug, categoryForApp, certDateExtractor, cidSchema, classifyEntityRef, completenessPercent, completenessScore, contrastRatio, countFilledDimensions, countryCodeToFlag, dateRangeExtractor, datetimeSchema, decodeFeedCursor, dedupeSkills, detectPdsProvider, didSchema, dimensionsFromInputs, durationFromMinutes, encodeFeedCursor, entityDisambiguationLabel, entityResultKey, externalRecordRefSchema, 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, hasAdultContent, hoistPrimary, isAppCategory, isCompanyPageIndexable, isCompanyRequired, isKnownAppId, isKnownPlatform, isKnownVerificationProvider, isLinked, isPseudoEmployer, isRegistrableDomainHandle, isSectionPopulated, isValidRgbColor, isVisibleActivityItem, languageTagSchema, lexiconDateExtractor, limitCombiningMarks, looksLikeDomain, makeGraphFollowRecordSchema, maxGraphemes, meetsContrastAA, normalizeCompanyKey, normalizeLegalForm, normalizeOpenTo, normalizePlatformId, normalizePresentationMode, normalizePresentationRole, normalizeWorkplaceTypes, openToTokenToValue, openToValueToToken, parseIntendedAudiences, parseLocationString, parsePresentationDuration, parseTalkRkey, partialDateSchema, pdsProviderFromApi, pickPrimaryPosition, presentationCsvRowToRecord, presentationDeliveryCsvRowToRecord, primaryVerification, profileToDimensionInputs, qualifiesAsOrg, relativeLuminance, resolveCardHealth, resolveCardUrl, resolveEmbed, resolveVerifierProvider, rgbToString, sanitizeDisplayText, sanitizeHandleInput, searchResultDisambiguation, selfLabelsSchema, singleDateExtractor, slugifyTitle, sortByActiveDateRange, sortByDateDesc, sortCertifications, sortEducation, sortHonors, sortLanguages, sortLanguagesByProficiency, sortPositions, sortProjects, sortPublications, streamAddressSchema, streamCardBodySchema, streamCardSubjectSchema, streamCardVMSchema, streamExternalLinkSchema, streamGeoSchema, streamMediaSchema, streamRichSegmentSchema, streamSourceSchema, streamThemeSchema, streamVerbSchema, stripHtmlToText, strongRefSchema, summarizePresentationDeliveries, toStreamCardVM, toStreamCardVMs, truncateGraphemes, uriSchema, verbForCollection, visibleItems, youtubeThumbnailUrl, youtubeVideoId };
 //# sourceMappingURL=index.js.map