@singi-labs/sifa-sdk 0.19.13 → 0.19.15

package/dist/index.d.cts

@@ -1591,6 +1591,17 @@ interface ActivityItem {
      * a `StreamCardVM` too.
      */
     subject?: ActivityItem;
+    /**
+     * Resolved title of the record this one references (the commented-on document,
+     * the replied-to post), set by sifa-api. Shown on the two-tier line as the
+     * subject clause ("Commented on {subjectTitle}").
+     */
+    subjectTitle?: string;
+    /**
+     * Canonical http(s) URL of the referenced record, set by sifa-api, so the
+     * subject clause links out to what was acted on (the blog post, the event).
+     */
+    subjectUrl?: string;
     /**
      * Hypercert claim enrichment, set by sifa-api. Absent for non-hypercert
      * items, for claims with neither contributors nor attachments, and for
@@ -1610,19 +1621,25 @@ 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", "reviewed", "created"];
+declare const STREAM_VERBS: readonly ["posted", "reposted", "published", "presented", "endorsed", "joined", "shipped", "reviewed", "created", "commented", "replied", "rsvped", "liked", "followed", "bookmarked"];
 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";
+    joined: "joined";
+    replied: "replied";
     posted: "posted";
-    reviewed: "reviewed";
     reposted: "reposted";
+    shipped: "shipped";
+    bookmarked: "bookmarked";
+    followed: "followed";
+    reviewed: "reviewed";
     published: "published";
-    presented: "presented";
+    rsvped: "rsvped";
+    commented: "commented";
     endorsed: "endorsed";
-    shipped: "shipped";
-    joined: "joined";
+    presented: "presented";
+    liked: "liked";
 }>;
 interface ActivityVerbMap {
     version: string;
@@ -1882,6 +1899,7 @@ type StreamCardSubject = {
     kind: 'record';
     uri: string;
     title?: string;
+    url?: string;
 };
 /**
  * Presentation-ready, framework-free, serializable view-model for one activity

package/dist/index.d.ts

@@ -1591,6 +1591,17 @@ interface ActivityItem {
      * a `StreamCardVM` too.
      */
     subject?: ActivityItem;
+    /**
+     * Resolved title of the record this one references (the commented-on document,
+     * the replied-to post), set by sifa-api. Shown on the two-tier line as the
+     * subject clause ("Commented on {subjectTitle}").
+     */
+    subjectTitle?: string;
+    /**
+     * Canonical http(s) URL of the referenced record, set by sifa-api, so the
+     * subject clause links out to what was acted on (the blog post, the event).
+     */
+    subjectUrl?: string;
     /**
      * Hypercert claim enrichment, set by sifa-api. Absent for non-hypercert
      * items, for claims with neither contributors nor attachments, and for
@@ -1610,19 +1621,25 @@ 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", "reviewed", "created"];
+declare const STREAM_VERBS: readonly ["posted", "reposted", "published", "presented", "endorsed", "joined", "shipped", "reviewed", "created", "commented", "replied", "rsvped", "liked", "followed", "bookmarked"];
 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";
+    joined: "joined";
+    replied: "replied";
     posted: "posted";
-    reviewed: "reviewed";
     reposted: "reposted";
+    shipped: "shipped";
+    bookmarked: "bookmarked";
+    followed: "followed";
+    reviewed: "reviewed";
     published: "published";
-    presented: "presented";
+    rsvped: "rsvped";
+    commented: "commented";
     endorsed: "endorsed";
-    shipped: "shipped";
-    joined: "joined";
+    presented: "presented";
+    liked: "liked";
 }>;
 interface ActivityVerbMap {
     version: string;
@@ -1882,6 +1899,7 @@ type StreamCardSubject = {
     kind: 'record';
     uri: string;
     title?: string;
+    url?: string;
 };
 /**
  * Presentation-ready, framework-free, serializable view-model for one activity

package/dist/index.js

@@ -4012,37 +4012,48 @@ function getPublisherFromSiteUrl(siteUrl) {
 // src/stream/verbs.json
 var verbs_default = {
   $schema: "https://sifa.id/schemas/activity-verbs/v1.json",
-  version: "1.1.0",
-  updated: "2026-07-19",
+  version: "1.2.0",
+  updated: "2026-09-18",
   defaultVerb: "created",
   verbs: {
+    "agency.portable.membership": "joined",
+    "app.atmobb.discussion.reply": "replied",
     "app.bsky.feed.post": "posted",
+    "app.bsky.feed.repost": "reposted",
+    "app.sidetrail.trail": "shipped",
+    "app.sidetrail.walk": "shipped",
+    "app.userinput.reply": "replied",
+    "at.margin.bookmark": "bookmarked",
+    "at.youandme.connection": "followed",
     "blue.flashes.feed.post": "posted",
-    "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",
     "com.whtwnd.blog.entry": "published",
-    "site.standard.document": "published",
+    "community.lexicon.calendar.rsvp": "rsvped",
+    "community.nooki.comments": "commented",
+    "community.nooki.membership": "joined",
+    "community.opensocial.membership": "joined",
     "computer.aetheros.page": "published",
-    "link.pastesphere.snippet": "published",
-    "pub.leaflet.comment": "published",
+    "eu.atcommons.member": "joined",
+    "fm.plyr.comment": "commented",
+    "forum.barazo.post": "posted",
+    "fyi.unravel.frontpage.post": "posted",
+    "id.sifa.endorsement": "endorsed",
+    "id.sifa.graph.connection": "joined",
     "id.sifa.profile.presentation": "presented",
     "id.sifa.profile.presentationDelivery": "presented",
-    "id.sifa.endorsement": "endorsed",
+    "link.pastesphere.snippet": "published",
+    "org.impactindexer.review.comment": "commented",
+    "pub.leaflet.comment": "commented",
     "sh.tangled.repo": "shipped",
     "sh.tangled.repo.issue": "shipped",
     "sh.tangled.repo.pull": "shipped",
-    "app.sidetrail.trail": "shipped",
-    "app.sidetrail.walk": "shipped",
+    "site.standard.document": "published",
     "social.colibri.membership": "joined",
-    "community.lexicon.calendar.rsvp": "joined",
-    "at.youandme.connection": "joined",
-    "id.sifa.graph.connection": "joined"
+    "social.kut.community.membership": "joined",
+    "social.popfeed.feed.note": "posted",
+    "social.popfeed.feed.post": "posted",
+    "social.popfeed.feed.review": "reviewed",
+    "social.psky.feed.post": "posted"
   }
 };
 
@@ -4056,7 +4067,16 @@ var STREAM_VERBS = [
   "joined",
   "shipped",
   "reviewed",
-  "created"
+  "created",
+  // Relational verbs: a reaction or reference to someone else's thing. These
+  // read with the subject the two-tier line renders after them ("Commented on
+  // {doc}", "Followed {person}").
+  "commented",
+  "replied",
+  "rsvped",
+  "liked",
+  "followed",
+  "bookmarked"
 ];
 var streamVerbSchema = z.enum(STREAM_VERBS);
 var verbMapSchema = z.object({
@@ -4268,7 +4288,8 @@ var streamCardSubjectSchema = z.discriminatedUnion("kind", [
   z.object({
     kind: z.literal("record"),
     uri: z.string(),
-    title: z.string().optional()
+    title: z.string().optional(),
+    url: z.string().optional()
   })
 ]);
 var hypercertDetailsSchema = z.object({
@@ -4505,10 +4526,33 @@ var TITLE_BY_VERB = {
   joined: (label) => `Joined ${label}`,
   shipped: (label) => `Shipped on ${label}`,
   reviewed: (label) => `Reviewed on ${label}`,
-  created: (label) => `Shared on ${label}`
+  created: (label) => `Shared on ${label}`,
+  commented: (_label, hasSubject) => hasSubject ? "Commented on" : "Commented",
+  replied: (_label, hasSubject) => hasSubject ? "Replied to" : "Replied",
+  rsvped: (_label, hasSubject) => hasSubject ? "RSVP'd to" : "RSVP'd",
+  liked: () => "Liked",
+  followed: () => "Followed",
+  bookmarked: () => "Bookmarked"
 };
-function buildTitle(verb, label) {
-  return TITLE_BY_VERB[verb](label);
+function buildTitle(verb, label, hasSubject) {
+  return TITLE_BY_VERB[verb](label, hasSubject);
+}
+function recordHasSubjectRef(record) {
+  if (!record) return false;
+  const subject = record.subject;
+  if (typeof subject === "string" && subject.startsWith("at://")) return true;
+  if (subject && typeof subject === "object") {
+    const uri = subject.uri;
+    if (typeof uri === "string" && uri.length > 0) return true;
+  }
+  const reply = record.reply;
+  if (reply && typeof reply === "object") {
+    for (const key of ["parent", "root"]) {
+      const ref = reply[key];
+      if (ref && typeof ref === "object" && typeof ref.uri === "string") return true;
+    }
+  }
+  return false;
 }
 function resolveSourceUrl(item, record) {
   const authorDid = didFromUri(item.uri);
@@ -4721,6 +4765,14 @@ function applyEventRsvp(vm, record) {
     if (locationCountry) body.locationCountry = locationCountry;
   }
   vm.body = body;
+  const eventUri = nonBlankString(asRecord(record.subject)?.uri);
+  if (eventUri) {
+    vm.subject = {
+      kind: "record",
+      uri: eventUri,
+      ...body.eventName ? { title: body.eventName } : {}
+    };
+  }
   return vm;
 }
 function applyKeytraceVerification(vm, record) {
@@ -4929,8 +4981,16 @@ function genericSubject(record) {
   }
   const uri = nonBlankString(asRecord(subject)?.uri);
   if (uri && uri.startsWith("at://")) return { kind: "record", uri };
+  const parentUri = nonBlankString(asRecord(asRecord(record.reply)?.parent)?.uri);
+  if (parentUri && parentUri.startsWith("at://")) return { kind: "record", uri: parentUri };
   return void 0;
 }
+function withResolvedSubjectMeta(subject, item) {
+  if (subject.kind !== "record") return subject;
+  const title = nonBlankString(item.subjectTitle) ?? subject.title;
+  const url = nonBlankString(item.subjectUrl);
+  return { ...subject, ...title ? { title } : {}, ...url ? { url } : {} };
+}
 function parseFacetFeature(features) {
   for (const raw of features) {
     const feat = asRecord(raw);
@@ -5003,7 +5063,7 @@ function applyGeneric(vm, item, record) {
   if (externalLink) vm.externalLink = externalLink;
   if (!vm.subject) {
     const subject = genericSubject(record);
-    if (subject) vm.subject = subject;
+    if (subject) vm.subject = withResolvedSubjectMeta(subject, item);
   }
   let body;
   if (text) {
@@ -5036,7 +5096,7 @@ function toStreamCardVM(item, options = {}) {
     source,
     tier: getActivityTier(item.collection),
     timestamp,
-    title: buildTitle(verb, source.label)
+    title: buildTitle(verb, source.label, recordHasSubjectRef(record))
   };
   const author = buildAuthor(item);
   if (author) vm.author = author;
@@ -6523,7 +6583,7 @@ function describeSifaRecord(collection, value) {
 }
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.19.13";
+var SIFA_SDK_VERSION = "0.19.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, INVESTMENT_ROLE_LABELS, INVESTMENT_ROLE_OPTIONS, INVESTMENT_STAGE_LABELS, INVESTMENT_STAGE_OPTIONS, INVESTMENT_STATUS_LABELS, INVESTMENT_STATUS_OPTIONS, INVOLVEMENT_HEADING_ORDER, INVOLVEMENT_KIND_HEADINGS, INVOLVEMENT_KIND_LABELS, INVOLVEMENT_KIND_OPTIONS, InvestmentAmountSchema, MIN_SKILLS, ON_BEHALF_OF_EMPLOYMENT_TYPES, OPEN_TO_OPTIONS, OPEN_TO_TOKENS, OPEN_TO_TOKEN_TO_VALUE, OPEN_TO_VALUE_TO_TOKEN, OrgEmploymentAttestationRecordSchema, OrgProfileRecordSchema, PLATFORM_LABELS, PLATFORM_OPTIONS, PRESENTATION_LINK_TYPE_LABELS, PRESENTATION_LINK_TYPE_OPTIONS, PRESENTATION_ROLE_LABELS, PRESENTATION_ROLE_OPTIONS, PROFILE_INVESTMENT_NSID, PROFILE_INVOLVEMENT_NSID, PROJECT_ROLES, PUBLICATION_TYPE_LABELS, PUBLICATION_TYPE_OPTIONS, PUBLISHERS, PresentationDurationSchema, PresentationLinkSchema, ProfileCertificationRecordSchema, ProfileCourseRecordSchema, ProfileEducationRecordSchema, ProfileExternalAccountRecordSchema, ProfileHonorRecordSchema, ProfileInvestmentRecordSchema, ProfileInvolvementRecordSchema, ProfileLanguageRecordSchema, ProfilePositionRecordSchema, ProfilePresentationDeliveryRecordSchema, ProfilePresentationRecordSchema, ProfileProjectRecordSchema, ProfilePublicationRecordSchema, ProfileSelfRecordSchema, ProfileSkillRecordSchema, ProfileVolunteeringRecordSchema, PublicationAuthorSchema, ROADMAP_ISSUES_REPO, ROADMAP_ITEM_META, SECTION_GROUPS, SECTION_LABELS, SELF_APP_ID, SIFA_REPO_GROUPS, SIFA_SDK_VERSION, SKILL_CATEGORIES, STANDARD_PUBLISHER_ID, STREAM_VERBS, SifaFeedItemSchema, VERIFICATION_PROVIDERS, WORKPLACE_TYPE_LABELS, WORKPLACE_TYPE_OPTIONS, actorShowsIdentity, agentRefSchema, atUriSchema, buildMetaDescription, buildProfileHighlights, buildTalkSlug, categoryForApp, certDateExtractor, cidSchema, classifyEntityRef, completenessPercent, completenessScore, contrastRatio, countFilledDimensions, countRecentActivity, countryCodeToFlag, dateRangeExtractor, datetimeSchema, decodeFeedCursor, dedupeSkills, describeSifaRecord, detectPdsProvider, didSchema, dimensionsFromInputs, durationFromMinutes, encodeFeedCursor, entityDisambiguationLabel, entityResultKey, excludeSelfApp, externalRecordRefSchema, filterHidden, findIndustry, formatCompanyName, formatDateRange, formatDisplayUrl, formatDistanceToNow, formatEventDate, formatLocation, formatPresentationDuration, formatRelationship, formatRelativeTime, formatSingleDate, formatSpanDate, formatTimelineDate, getActivityTaxonomyVersion, getActivityTier, getActivityVerbsVersion, getAppCategoryIcon, getAppIdForCollection, getArtifactLinkKindLabel, getCalendarEventModeLabel, getCalendarEventStatusLabel, getContinent, getDisplayLabel, getEmploymentTypeLabel, getFaviconUrl, getFilledDimensionsMap, getHandleStem, getIndustryLabelKey, getInvestmentRoleLabel, getInvestmentStageLabel, getInvestmentStatusLabel, getInvolvementKindHeading, getInvolvementKindLabel, getLexiconEntry, getOpenToLabelKey, getPdsDisplayName, getPlatformLabel, getPresentationLinkTypeLabel, getPresentationRoleLabel, getPublicationTypeLabel, getPublisherByHost, getPublisherById, getPublisherFromSiteUrl, getTierMeta, getVerificationProvider, getVisibleSectionIds, getWorkplaceTypeLabel, groupInvolvementByHeading, groupSkillsByCategory, groupSkillsBySubCategory, groupSkillsForDisplay, hasAdultContent, hasPersonalProfileContent, hoistPrimary, isAppCategory, isCompanyPageIndexable, isCompanyRequired, isKnownAppId, isKnownPlatform, isKnownVerificationProvider, isLinked, isOnBehalfOfApplicable, isPseudoEmployer, isRegistrableDomainHandle, isRelationalActivity, isRoleLineRedundant, isSectionPopulated, isSelfAuthoredRich, isValidRgbColor, isVisibleActivityItem, languageTagSchema, lexiconDateExtractor, limitCombiningMarks, locationSegments, looksLikeDomain, makeGraphFollowRecordSchema, maxGraphemes, meetsContrastAA, normalizeCompanyKey, normalizeDoi, normalizeLegalForm, normalizeOpenTo, normalizePlatformId, normalizePresentationMode, normalizePresentationRole, normalizeSkillCategory, normalizeWorkplaceTypes, openToTokenToValue, openToValueToToken, parseEndorsementComment, parseIntendedAudiences, parseLocationString, parsePresentationDuration, parseTalkRkey, partialDateSchema, pdsProviderFromApi, pickPrimaryFlagged, pickPrimaryPosition, presentationCsvRowToRecord, presentationDeliveryCsvRowToRecord, primaryVerification, profileToDimensionInputs, qualifiesAsOrg, relativeLuminance, renderAsLine, rendersCompanyProfile, rendersPersonalProfile, repoGroupForCollection, resolveAccountFacetMode, resolveAgentRef, resolveCardHealth, resolveCardUrl, resolveEmbed, resolveVerifierProvider, rgbToString, roadmapIssueUrl, sanitizeDisplayText, sanitizeHandleInput, searchResultDisambiguation, selfLabelsSchema, shouldRenderHighlights, singleDateExtractor, skillRefSchema, slugifyTitle, sortByActiveDateRange, sortByDateDesc, sortCertifications, sortEducation, sortHonors, sortLanguages, sortLanguagesByProficiency, sortPositions, sortProjects, sortPublications, streamAddressSchema, streamAuthorSchema, streamCardBodySchema, streamCardSubjectSchema, streamCardVMSchema, streamExternalLinkSchema, streamGeoSchema, streamMediaSchema, streamRichSegmentSchema, streamSourceSchema, streamThemeSchema, streamVerbSchema, stripHtmlToText, strongRefSchema, summarizePresentationDeliveries, summarizeProfileView, toStreamCardVM, toStreamCardVMs, truncateGraphemes, uriSchema, verbForCollection, visibleItems, youtubeThumbnailUrl, youtubeVideoId };
 //# sourceMappingURL=index.js.map