@singi-labs/sifa-sdk 0.18.15 → 0.18.17

package/dist/{index-DIwi3bpk.d.cts → index-E2qQbMnv.d.cts}

@@ -89,6 +89,8 @@ interface ProfileEducation {
     startedAt?: string;
     endedAt?: string;
     hidden?: boolean;
+    /** User-flagged primary education entry, surfaced in the Highlights block. */
+    primary?: boolean;
 }
 interface ProfileSkill {
     rkey: string;
@@ -205,6 +207,8 @@ interface ProfileProject {
     /** AT-URI of the same record on another person's profile, when they keep one. */
     sameAs?: string;
     hidden?: boolean;
+    /** User-flagged primary project, surfaced in the Highlights block. Ongoing only. */
+    primary?: boolean;
 }
 interface PublicationContributor {
     name: string;
@@ -248,6 +252,8 @@ interface ProfilePublication {
     verifiedVia?: string;
     orcidPutCode?: number;
     hidden?: boolean;
+    /** User-flagged primary publication, surfaced in the Highlights block. */
+    primary?: boolean;
     orcidCorroborated?: boolean;
     pendingVerification?: boolean;
     appId?: string;
@@ -408,6 +414,8 @@ interface ProfileInvolvement {
      */
     legacy?: boolean;
     hidden?: boolean;
+    /** User-flagged primary involvement, surfaced in the Highlights block. Ongoing only. */
+    primary?: boolean;
     /** Other people named on this involvement, hydrated from the stored DIDs. */
     collaborators?: ProjectMemberCard[];
     /** AT-URI of the same involvement as recorded on another person's profile. */
@@ -551,6 +559,8 @@ interface ProfilePresentation {
     /** Resolved URL of the uploaded cover image, when present. */
     coverImageUrl?: string | null;
     hidden?: boolean;
+    /** User-flagged primary talk, surfaced in the Highlights block. Talks only, not sessions. */
+    primary?: boolean;
     deliveries?: ProfilePresentationDelivery[];
 }
 interface TrustStat {

package/dist/{index-DIwi3bpk.d.ts → index-E2qQbMnv.d.ts}

@@ -89,6 +89,8 @@ interface ProfileEducation {
     startedAt?: string;
     endedAt?: string;
     hidden?: boolean;
+    /** User-flagged primary education entry, surfaced in the Highlights block. */
+    primary?: boolean;
 }
 interface ProfileSkill {
     rkey: string;
@@ -205,6 +207,8 @@ interface ProfileProject {
     /** AT-URI of the same record on another person's profile, when they keep one. */
     sameAs?: string;
     hidden?: boolean;
+    /** User-flagged primary project, surfaced in the Highlights block. Ongoing only. */
+    primary?: boolean;
 }
 interface PublicationContributor {
     name: string;
@@ -248,6 +252,8 @@ interface ProfilePublication {
     verifiedVia?: string;
     orcidPutCode?: number;
     hidden?: boolean;
+    /** User-flagged primary publication, surfaced in the Highlights block. */
+    primary?: boolean;
     orcidCorroborated?: boolean;
     pendingVerification?: boolean;
     appId?: string;
@@ -408,6 +414,8 @@ interface ProfileInvolvement {
      */
     legacy?: boolean;
     hidden?: boolean;
+    /** User-flagged primary involvement, surfaced in the Highlights block. Ongoing only. */
+    primary?: boolean;
     /** Other people named on this involvement, hydrated from the stored DIDs. */
     collaborators?: ProjectMemberCard[];
     /** AT-URI of the same involvement as recorded on another person's profile. */
@@ -551,6 +559,8 @@ interface ProfilePresentation {
     /** Resolved URL of the uploaded cover image, when present. */
     coverImageUrl?: string | null;
     hidden?: boolean;
+    /** User-flagged primary talk, surfaced in the Highlights block. Talks only, not sessions. */
+    primary?: boolean;
     deliveries?: ProfilePresentationDelivery[];
 }
 interface TrustStat {

package/dist/index.cjs

@@ -5085,6 +5085,12 @@ function countFilledDimensions(input) {
   return n;
 }
 
+// src/logic/primary-item.ts
+function pickPrimaryFlagged(items, isEligible = () => true) {
+  if (!items || items.length === 0) return void 0;
+  return items.find((item) => item.primary === true && !item.hidden && isEligible(item));
+}
+
 // src/logic/profile-summary.ts
 var DEFAULT_MAX_SKILLS = 5;
 function summarizeProfileView(view, options = {}) {
@@ -5406,6 +5412,175 @@ function groupInvolvementByHeading(items) {
   }
   return groups;
 }
+
+// src/profile/highlights.ts
+function coPeopleLabel(people, self) {
+  const names = (people ?? []).filter((p) => p.did !== self.did && (!p.handle || p.handle !== self.handle)).map((p) => p.displayName ?? p.name ?? p.handle).filter((n) => Boolean(n && n.trim()));
+  return names.length ? `with ${names.join(", ")}` : void 0;
+}
+var EN_DASH = "\u2013";
+function visible(items) {
+  return (items ?? []).filter((i) => !i.hidden);
+}
+function metaLine(parts) {
+  const kept = parts.filter((p) => Boolean(p && p.trim()));
+  return kept.length ? kept.join(" \xB7 ") : void 0;
+}
+function formatSpanDate(start, end) {
+  if (start && !end) return `Since ${formatTimelineDate(start)}`;
+  if (!start && !end) return void 0;
+  if (!start) return formatTimelineDate(end);
+  const a = formatTimelineDate(start);
+  const b = formatTimelineDate(end);
+  return a === b ? a : `${a} ${EN_DASH} ${b}`;
+}
+function formatSingleDate(date) {
+  return date ? formatTimelineDate(date) : void 0;
+}
+var EVENT_DAY_FMT = new Intl.DateTimeFormat("en", {
+  year: "numeric",
+  month: "short",
+  day: "numeric",
+  timeZone: "UTC"
+});
+function formatEventDate(date) {
+  if (!date) return void 0;
+  if (date.length === 10) {
+    const d = /* @__PURE__ */ new Date(`${date}T00:00:00Z`);
+    if (!Number.isNaN(d.getTime())) return EVENT_DAY_FMT.format(d);
+  }
+  return formatTimelineDate(date);
+}
+function pickTalk(presentations, deliveries, today, self) {
+  const talkRkeys = new Set(presentations.map((p) => p.rkey));
+  const occasions = [];
+  for (const p of presentations) {
+    const dated = visible(p.deliveries).filter((d) => d.date);
+    if (!dated.length) continue;
+    const date = dated.reduce((max, d) => d.date && d.date > max ? d.date : max, "");
+    const delivery2 = dated.find((d) => d.date === date);
+    if (!delivery2) continue;
+    occasions.push({ date, title: p.title, delivery: delivery2, imageUrl: p.coverImageUrl ?? void 0 });
+  }
+  for (const d of deliveries) {
+    const standalone = !d.presentationRkey || !talkRkeys.has(d.presentationRkey);
+    if (!standalone || !d.date || d.hidden) continue;
+    occasions.push({ date: d.date, title: d.title || d.eventName || "Talk", delivery: d });
+  }
+  if (!occasions.length) return void 0;
+  const best = occasions.reduce((a, b) => b.date > a.date ? b : a);
+  const { delivery } = best;
+  return {
+    section: "talk",
+    href: "#presentations",
+    title: best.title,
+    meta: metaLine([
+      delivery.eventName,
+      delivery.location,
+      getPresentationRoleLabel(delivery.role ?? void 0),
+      getCalendarEventModeLabel(delivery.mode ?? void 0),
+      coPeopleLabel(delivery.coSpeakers, self)
+    ]),
+    dateStr: formatEventDate(best.date),
+    imageUrl: best.imageUrl,
+    status: best.date > today ? "upcoming" : "recent"
+  };
+}
+function buildProfileHighlights(profile, { today }) {
+  const row1 = [];
+  const row2 = [];
+  const self = { did: profile.did, handle: profile.handle };
+  const talk = pickTalk(
+    visible(profile.presentations),
+    visible(profile.presentationDeliveries),
+    today,
+    self
+  );
+  if (talk) row1.push(talk);
+  const publication = sortByDateDesc(visible(profile.publications), singleDateExtractor)[0];
+  if (publication) {
+    const venue = publication.publicationName ?? publication.publisher;
+    const coAuthors = coPeopleLabel(publication.contributors, self);
+    const venueIsSelf = venue === profile.handle || !!profile.displayName && venue === profile.displayName && !coAuthors;
+    row1.push({
+      section: "publication",
+      href: "#publications",
+      title: publication.title,
+      meta: metaLine([coAuthors, venue && !venueIsSelf ? venue : void 0, publication.subtitle]),
+      dateStr: formatSingleDate(publication.date),
+      imageUrl: publication.image ?? void 0,
+      status: "recent"
+    });
+  }
+  const positions = visible(profile.positions);
+  const career = pickPrimaryPosition(positions) ?? sortByDateDesc(positions, lexiconDateExtractor)[0];
+  if (career) {
+    row2.push({
+      section: "career",
+      href: "#career",
+      title: career.title,
+      meta: metaLine([career.entityName ?? career.company]),
+      dateStr: formatSpanDate(career.startedAt, career.endedAt),
+      status: career.endedAt ? "recent" : "current"
+    });
+  }
+  const education = sortByDateDesc(visible(profile.education), lexiconDateExtractor)[0];
+  if (education) {
+    const institution = education.entityName ?? education.institution;
+    const title = education.degree || education.fieldOfStudy || institution || "Education";
+    row2.push({
+      section: "education",
+      href: "#education",
+      title,
+      meta: metaLine([title === institution ? void 0 : institution]),
+      dateStr: formatSpanDate(education.startedAt, education.endedAt),
+      status: education.endedAt ? "recent" : "current"
+    });
+  } else {
+    const course = visible(profile.courses)[0];
+    if (course) {
+      row2.push({
+        section: "education",
+        href: "#courses",
+        title: course.name,
+        meta: metaLine([course.entityName ?? course.institution]),
+        dateStr: formatSingleDate(course.completedAt),
+        status: "recent"
+      });
+    }
+  }
+  const ongoingProjects = visible(profile.projects).filter((p) => !p.endDate);
+  const project = sortByDateDesc(ongoingProjects, dateRangeExtractor)[0];
+  if (project) {
+    row2.push({
+      section: "project",
+      href: "#projects",
+      title: project.name,
+      meta: coPeopleLabel(project.members, self),
+      dateStr: formatSpanDate(project.startDate, project.endDate),
+      status: "current"
+    });
+  }
+  const ongoingInvolvement = visible(profile.involvement).filter((i) => !i.endedAt);
+  const involvement = sortByDateDesc(ongoingInvolvement, lexiconDateExtractor)[0];
+  if (involvement) {
+    row2.push({
+      section: "involvement",
+      href: "#involvement",
+      title: involvement.role || involvement.kind || "Involvement",
+      meta: metaLine([
+        involvement.entityName ?? involvement.upstream,
+        coPeopleLabel(involvement.collaborators, self)
+      ]),
+      dateStr: formatSpanDate(involvement.startedAt, involvement.endedAt),
+      status: "current"
+    });
+  }
+  return { row1, row2 };
+}
+function shouldRenderHighlights(rows) {
+  return rows.row1.length + rows.row2.length >= 2;
+}
 var BlobRefSchema = zod.z.object({
   $type: zod.z.literal("blob"),
   ref: zod.z.object({ $link: zod.z.string().min(1) }),
@@ -5687,6 +5862,7 @@ var ProfileEducationRecordSchema = zod.z.object({
   startedAt: partialDateSchema.optional(),
   endedAt: partialDateSchema.optional(),
   labels: selfLabelsSchema.optional(),
+  isPrimary: zod.z.boolean().optional(),
   createdAt: datetimeSchema
 });
 var ProfileExternalAccountRecordSchema = zod.z.object({
@@ -5734,6 +5910,7 @@ var ProfileProjectRecordSchema = zod.z.object({
   startedAt: partialDateSchema.optional(),
   endedAt: partialDateSchema.optional(),
   labels: selfLabelsSchema.optional(),
+  isPrimary: zod.z.boolean().optional(),
   createdAt: datetimeSchema
 });
 
@@ -5764,6 +5941,7 @@ var ProfileInvolvementRecordSchema = zod.z.object({
   labels: selfLabelsSchema.optional(),
   collaborators: zod.z.array(projectMemberRefSchema).max(50).optional(),
   sameAs: externalRecordRefSchema.optional(),
+  isPrimary: zod.z.boolean().optional(),
   createdAt: datetimeSchema
 }).passthrough();
 var ProfileLanguageRecordSchema = zod.z.object({
@@ -5822,6 +6000,7 @@ var ProfilePresentationRecordSchema = zod.z.object({
   writeupRef: externalRecordRefSchema.optional(),
   // Optional uploaded cover image for the talk page.
   coverImage: BlobRefSchema.optional(),
+  isPrimary: zod.z.boolean().optional(),
   createdAt: datetimeSchema
 });
 var communityAddressSchema = zod.z.object({
@@ -5866,6 +6045,7 @@ var ProfilePublicationRecordSchema = zod.z.object({
   description: zod.z.string().refine(maxGraphemes(5e3)).max(5e4).optional(),
   authors: zod.z.array(PublicationAuthorSchema).max(50).optional(),
   publishedAt: partialDateSchema.optional(),
+  isPrimary: zod.z.boolean().optional(),
   createdAt: datetimeSchema
 });
 var ProfileSelfRecordSchema = zod.z.object({
@@ -6227,7 +6407,7 @@ function describeSifaRecord(collection, value) {
 }
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.18.15";
+var SIFA_SDK_VERSION = "0.18.17";
 
 exports.ACTIVITY_TIERS = ACTIVITY_TIERS;
 exports.ACTIVITY_VERBS = ACTIVITY_VERBS;
@@ -6344,6 +6524,7 @@ exports.actorShowsIdentity = actorShowsIdentity;
 exports.agentRefSchema = agentRefSchema;
 exports.atUriSchema = atUriSchema;
 exports.buildMetaDescription = buildMetaDescription;
+exports.buildProfileHighlights = buildProfileHighlights;
 exports.buildTalkSlug = buildTalkSlug;
 exports.categoryForApp = categoryForApp;
 exports.certDateExtractor = certDateExtractor;
@@ -6375,9 +6556,12 @@ exports.formatCompanyName = formatCompanyName;
 exports.formatDateRange = formatDateRange;
 exports.formatDisplayUrl = formatDisplayUrl;
 exports.formatDistanceToNow = formatDistanceToNow;
+exports.formatEventDate = formatEventDate;
 exports.formatLocation = formatLocation;
 exports.formatPresentationDuration = formatPresentationDuration;
 exports.formatRelativeTime = formatRelativeTime;
+exports.formatSingleDate = formatSingleDate;
+exports.formatSpanDate = formatSpanDate;
 exports.formatTimelineDate = formatTimelineDate;
 exports.getActivityTaxonomyVersion = getActivityTaxonomyVersion;
 exports.getActivityTier = getActivityTier;
@@ -6459,6 +6643,7 @@ exports.parsePresentationDuration = parsePresentationDuration;
 exports.parseTalkRkey = parseTalkRkey;
 exports.partialDateSchema = partialDateSchema;
 exports.pdsProviderFromApi = pdsProviderFromApi;
+exports.pickPrimaryFlagged = pickPrimaryFlagged;
 exports.pickPrimaryPosition = pickPrimaryPosition;
 exports.presentationCsvRowToRecord = presentationCsvRowToRecord;
 exports.presentationDeliveryCsvRowToRecord = presentationDeliveryCsvRowToRecord;
@@ -6481,6 +6666,7 @@ exports.sanitizeDisplayText = sanitizeDisplayText;
 exports.sanitizeHandleInput = sanitizeHandleInput;
 exports.searchResultDisambiguation = searchResultDisambiguation;
 exports.selfLabelsSchema = selfLabelsSchema;
+exports.shouldRenderHighlights = shouldRenderHighlights;
 exports.singleDateExtractor = singleDateExtractor;
 exports.skillRefSchema = skillRefSchema;
 exports.slugifyTitle = slugifyTitle;