@singi-labs/sifa-sdk 0.12.13 → 0.12.15

package/dist/index.d.cts

@@ -1191,6 +1191,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`. */
@@ -1213,12 +1220,13 @@ interface ActivityItem {
  * standard-site; "posted" spans Bluesky and Picosky) so a day-grouped feed
  * reads like sentences.
  */
-declare const STREAM_VERBS: readonly ["posted", "reposted", "published", "presented", "endorsed", "joined", "shipped", "created"];
+declare const STREAM_VERBS: readonly ["posted", "reposted", "published", "presented", "endorsed", "joined", "shipped", "reviewed", "created"];
 type StreamVerb = (typeof STREAM_VERBS)[number];
 /** Zod enum for a {@link StreamVerb}, shared with the view-model schema. */
 declare const streamVerbSchema: z.ZodEnum<{
     created: "created";
     posted: "posted";
+    reviewed: "reviewed";
     reposted: "reposted";
     published: "published";
     presented: "presented";
@@ -1486,6 +1494,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

@@ -1191,6 +1191,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`. */
@@ -1213,12 +1220,13 @@ interface ActivityItem {
  * standard-site; "posted" spans Bluesky and Picosky) so a day-grouped feed
  * reads like sentences.
  */
-declare const STREAM_VERBS: readonly ["posted", "reposted", "published", "presented", "endorsed", "joined", "shipped", "created"];
+declare const STREAM_VERBS: readonly ["posted", "reposted", "published", "presented", "endorsed", "joined", "shipped", "reviewed", "created"];
 type StreamVerb = (typeof STREAM_VERBS)[number];
 /** Zod enum for a {@link StreamVerb}, shared with the view-model schema. */
 declare const streamVerbSchema: z.ZodEnum<{
     created: "created";
     posted: "posted";
+    reviewed: "reviewed";
     reposted: "reposted";
     published: "published";
     presented: "presented";
@@ -1486,6 +1494,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

@@ -2745,8 +2745,8 @@ function getPublisherFromSiteUrl(siteUrl) {
 // src/stream/verbs.json
 var verbs_default = {
   $schema: "https://sifa.id/schemas/activity-verbs/v1.json",
-  version: "1.0.0",
-  updated: "2026-07-17",
+  version: "1.1.0",
+  updated: "2026-07-19",
   defaultVerb: "created",
   verbs: {
     "app.bsky.feed.post": "posted",
@@ -2754,6 +2754,8 @@ var verbs_default = {
     "social.psky.feed.post": "posted",
     "social.popfeed.feed.post": "posted",
     "social.popfeed.feed.note": "posted",
+    "social.popfeed.feed.review": "reviewed",
+    "buzz.bookhive.book": "reviewed",
     "fyi.unravel.frontpage.post": "posted",
     "forum.barazo.post": "posted",
     "app.bsky.feed.repost": "reposted",
@@ -2788,6 +2790,7 @@ var STREAM_VERBS = [
   "endorsed",
   "joined",
   "shipped",
+  "reviewed",
   "created"
 ];
 var streamVerbSchema = z.enum(STREAM_VERBS);
@@ -3006,6 +3009,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(),
@@ -3168,18 +3172,33 @@ function buildSource(item, options) {
   };
 }
 var TITLE_BY_VERB = {
-  posted: (label) => `Posted on ${label}`,
-  reposted: () => "Reposted a post",
+  posted: () => "Posted",
+  reposted: () => "Reposted",
   published: (label) => `Published on ${label}`,
   presented: () => "Gave a presentation",
   endorsed: () => "Wrote an endorsement",
   joined: (label) => `Joined ${label}`,
   shipped: (label) => `Shipped on ${label}`,
-  created: (label) => `Created a record on ${label}`
+  reviewed: (label) => `Reviewed on ${label}`,
+  created: (label) => `Shared on ${label}`
 };
 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;
@@ -3677,6 +3696,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) };
   }
@@ -4538,7 +4561,7 @@ var ProfileVolunteeringRecordSchema = z.object({
 });
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.12.13";
+var SIFA_SDK_VERSION = "0.12.15";
 
 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