@singi-labs/sifa-sdk 0.11.3 → 0.11.5

package/dist/{adult-content-CC8eR44a.d.cts → adult-content-Bwr392Yu.d.cts}

@@ -174,6 +174,49 @@ interface ProfileCourse {
     credentialRkey?: string;
     hidden?: boolean;
 }
+/** A related link on a presentation or delivery, as returned by the AppView. */
+interface PresentationLinkView {
+    uri: string;
+    label?: string;
+    type?: string;
+}
+/** An occasion on which a presentation was delivered (the AppView view-model). */
+interface ProfilePresentationDelivery {
+    rkey: string;
+    /** rkey of the parent presentation when this delivery references one. */
+    presentationRkey?: string | null;
+    title?: string | null;
+    role?: string | null;
+    eventName?: string | null;
+    /** Day-only date, YYYY-MM-DD. */
+    date?: string | null;
+    location?: string | null;
+    /** Full community.lexicon.calendar.event mode token. */
+    mode?: string | null;
+    /** Full community.lexicon.calendar.event status token. */
+    status?: string | null;
+    links?: PresentationLinkView[];
+    /** at-uri of the linked calendar event, when present. */
+    eventUri?: string | null;
+    hidden?: boolean;
+}
+/** A reusable presentation with its deliveries grouped underneath (AppView view-model). */
+interface ProfilePresentation {
+    rkey: string;
+    title: string;
+    description?: string | null;
+    /** Duration in minutes: a fixed value (min only) or a range. */
+    duration?: {
+        minMinutes: number;
+        maxMinutes?: number;
+    } | null;
+    intendedAudiences?: string[];
+    links?: PresentationLinkView[];
+    /** at-uri of a long-form write-up (Leaflet / site.standard document). */
+    writeupUri?: string | null;
+    hidden?: boolean;
+    deliveries?: ProfilePresentationDelivery[];
+}
 interface TrustStat {
     key: string;
     label: string;
@@ -319,6 +362,8 @@ interface Profile {
     honors?: ProfileHonor[];
     languages?: ProfileLanguage[];
     courses?: ProfileCourse[];
+    presentations?: ProfilePresentation[];
+    presentationDeliveries?: ProfilePresentationDelivery[];
     externalAccounts?: ExternalAccount[];
 }
 
@@ -361,4 +406,4 @@ declare function hasAdultContent(item: {
     labels?: ActivityLabel[];
 }): boolean;
 
-export { type AdultContentLabel as A, type ExternalAccount as E, type FeedItem as F, type LocationValue as L, type ProfileSkill as P, type SkillSuggestion as S, type TrustStat as T, type VerifiedAccount as V, type ActivityLabel as a, type PdsProviderInfo as b, type Profile as c, ADULT_CONTENT_LABELS as d, type ActiveApp as e, type Endorsement as f, type EndorsementData as g, type ExternalAccountKeytraceClaim as h, type LanguageProficiency as i, type ProfileCertification as j, type ProfileCourse as k, type ProfileEducation as l, type ProfileHonor as m, type ProfileIndustry as n, type ProfileLanguage as o, type ProfileLocation as p, type ProfileOverrideSource as q, type ProfilePosition as r, type ProfileProject as s, type ProfilePublication as t, type ProfileVolunteering as u, type PublicationContributor as v, type SkillRef as w, hasAdultContent as x };
+export { type AdultContentLabel as A, hasAdultContent as B, type ExternalAccount as E, type FeedItem as F, type LocationValue as L, type ProfileSkill as P, type SkillSuggestion as S, type TrustStat as T, type VerifiedAccount as V, type ActivityLabel as a, type PdsProviderInfo as b, type Profile as c, ADULT_CONTENT_LABELS as d, type ActiveApp as e, type Endorsement as f, type EndorsementData as g, type ExternalAccountKeytraceClaim as h, type LanguageProficiency as i, type PresentationLinkView as j, type ProfileCertification as k, type ProfileCourse as l, type ProfileEducation as m, type ProfileHonor as n, type ProfileIndustry as o, type ProfileLanguage as p, type ProfileLocation as q, type ProfileOverrideSource as r, type ProfilePosition as s, type ProfilePresentation as t, type ProfilePresentationDelivery as u, type ProfileProject as v, type ProfilePublication as w, type ProfileVolunteering as x, type PublicationContributor as y, type SkillRef as z };

package/dist/{adult-content-CC8eR44a.d.ts → adult-content-Bwr392Yu.d.ts}

@@ -174,6 +174,49 @@ interface ProfileCourse {
     credentialRkey?: string;
     hidden?: boolean;
 }
+/** A related link on a presentation or delivery, as returned by the AppView. */
+interface PresentationLinkView {
+    uri: string;
+    label?: string;
+    type?: string;
+}
+/** An occasion on which a presentation was delivered (the AppView view-model). */
+interface ProfilePresentationDelivery {
+    rkey: string;
+    /** rkey of the parent presentation when this delivery references one. */
+    presentationRkey?: string | null;
+    title?: string | null;
+    role?: string | null;
+    eventName?: string | null;
+    /** Day-only date, YYYY-MM-DD. */
+    date?: string | null;
+    location?: string | null;
+    /** Full community.lexicon.calendar.event mode token. */
+    mode?: string | null;
+    /** Full community.lexicon.calendar.event status token. */
+    status?: string | null;
+    links?: PresentationLinkView[];
+    /** at-uri of the linked calendar event, when present. */
+    eventUri?: string | null;
+    hidden?: boolean;
+}
+/** A reusable presentation with its deliveries grouped underneath (AppView view-model). */
+interface ProfilePresentation {
+    rkey: string;
+    title: string;
+    description?: string | null;
+    /** Duration in minutes: a fixed value (min only) or a range. */
+    duration?: {
+        minMinutes: number;
+        maxMinutes?: number;
+    } | null;
+    intendedAudiences?: string[];
+    links?: PresentationLinkView[];
+    /** at-uri of a long-form write-up (Leaflet / site.standard document). */
+    writeupUri?: string | null;
+    hidden?: boolean;
+    deliveries?: ProfilePresentationDelivery[];
+}
 interface TrustStat {
     key: string;
     label: string;
@@ -319,6 +362,8 @@ interface Profile {
     honors?: ProfileHonor[];
     languages?: ProfileLanguage[];
     courses?: ProfileCourse[];
+    presentations?: ProfilePresentation[];
+    presentationDeliveries?: ProfilePresentationDelivery[];
     externalAccounts?: ExternalAccount[];
 }
 
@@ -361,4 +406,4 @@ declare function hasAdultContent(item: {
     labels?: ActivityLabel[];
 }): boolean;
 
-export { type AdultContentLabel as A, type ExternalAccount as E, type FeedItem as F, type LocationValue as L, type ProfileSkill as P, type SkillSuggestion as S, type TrustStat as T, type VerifiedAccount as V, type ActivityLabel as a, type PdsProviderInfo as b, type Profile as c, ADULT_CONTENT_LABELS as d, type ActiveApp as e, type Endorsement as f, type EndorsementData as g, type ExternalAccountKeytraceClaim as h, type LanguageProficiency as i, type ProfileCertification as j, type ProfileCourse as k, type ProfileEducation as l, type ProfileHonor as m, type ProfileIndustry as n, type ProfileLanguage as o, type ProfileLocation as p, type ProfileOverrideSource as q, type ProfilePosition as r, type ProfileProject as s, type ProfilePublication as t, type ProfileVolunteering as u, type PublicationContributor as v, type SkillRef as w, hasAdultContent as x };
+export { type AdultContentLabel as A, hasAdultContent as B, type ExternalAccount as E, type FeedItem as F, type LocationValue as L, type ProfileSkill as P, type SkillSuggestion as S, type TrustStat as T, type VerifiedAccount as V, type ActivityLabel as a, type PdsProviderInfo as b, type Profile as c, ADULT_CONTENT_LABELS as d, type ActiveApp as e, type Endorsement as f, type EndorsementData as g, type ExternalAccountKeytraceClaim as h, type LanguageProficiency as i, type PresentationLinkView as j, type ProfileCertification as k, type ProfileCourse as l, type ProfileEducation as m, type ProfileHonor as n, type ProfileIndustry as o, type ProfileLanguage as p, type ProfileLocation as q, type ProfileOverrideSource as r, type ProfilePosition as s, type ProfilePresentation as t, type ProfilePresentationDelivery as u, type ProfileProject as v, type ProfilePublication as w, type ProfileVolunteering as x, type PublicationContributor as y, type SkillRef as z };

package/dist/index.cjs

@@ -1404,6 +1404,16 @@ function formatRelativeTime(dateString) {
   return `${years}y ago`;
 }
 
+// src/format/format-duration.ts
+function formatPresentationDuration(duration) {
+  if (!duration) return void 0;
+  const { minMinutes, maxMinutes } = duration;
+  if (maxMinutes != null && maxMinutes !== minMinutes) {
+    return `${minMinutes}-${maxMinutes} min`;
+  }
+  return `${minMinutes} min`;
+}
+
 // src/format/sort-by-date.ts
 var FAR_FUTURE = "9999-12-31";
 var FAR_PAST = "0000-01-01";
@@ -1627,6 +1637,102 @@ function meetsContrastAA(foreground, background) {
   return contrastRatio(foreground, background) >= 4.5;
 }
 
+// src/import/presentation-csv.ts
+function clean(value) {
+  return (value ?? "").trim();
+}
+function parsePresentationDuration(input) {
+  const numbers = (clean(input).match(/\d+/g) ?? []).map((n) => Number.parseInt(n, 10)).filter((n) => Number.isInteger(n) && n > 0);
+  const min = numbers.at(0);
+  if (min === void 0) return void 0;
+  const max = numbers.at(1);
+  return max !== void 0 && max >= min ? { minMinutes: min, maxMinutes: max } : { minMinutes: min };
+}
+function durationFromMinutes(minRaw, maxRaw) {
+  const min = Number.parseInt(clean(minRaw), 10);
+  if (!Number.isInteger(min) || min < 1) return void 0;
+  const max = Number.parseInt(clean(maxRaw), 10);
+  return Number.isInteger(max) && max >= min ? { minMinutes: min, maxMinutes: max } : { minMinutes: min };
+}
+function parseIntendedAudiences(input, delimiter = ";") {
+  return clean(input).split(delimiter).map((s) => s.trim()).filter(Boolean);
+}
+function stripHtmlToText(input) {
+  const text = clean(input).replace(/<\s*br\s*\/?>/gi, "\n").replace(/<\/\s*(p|div|li|h[1-6])\s*>/gi, "\n").replace(/<[^>]*>/g, "").replace(/&nbsp;/gi, " ").replace(/&amp;/gi, "&").replace(/&lt;/gi, "<").replace(/&gt;/gi, ">").replace(/&quot;/gi, '"').replace(/&#0*39;|&apos;/gi, "'");
+  return text.replace(/[ \t]+/g, " ").replace(/ *\n */g, "\n").replace(/\n{3,}/g, "\n\n").trim();
+}
+var ROLE_TOKENS = {
+  presenter: "id.sifa.defs#presenter",
+  speaker: "id.sifa.defs#presenter",
+  panelist: "id.sifa.defs#panelist",
+  keynote: "id.sifa.defs#keynote",
+  workshop: "id.sifa.defs#workshop",
+  host: "id.sifa.defs#host"
+};
+function normalizePresentationRole(value) {
+  const v = clean(value).toLowerCase();
+  if (!v) return void 0;
+  if (v.startsWith("id.sifa.defs#")) return v;
+  return ROLE_TOKENS[v] ?? v;
+}
+var MODE_FRAGMENTS = {
+  inperson: "#inperson",
+  "in person": "#inperson",
+  "in-person": "#inperson",
+  virtual: "#virtual",
+  online: "#virtual",
+  remote: "#virtual",
+  hybrid: "#hybrid"
+};
+function normalizePresentationMode(value) {
+  const v = clean(value).toLowerCase();
+  if (!v) return void 0;
+  if (v.startsWith("community.lexicon.calendar.event#")) return v;
+  const fragment = MODE_FRAGMENTS[v];
+  return fragment ? `community.lexicon.calendar.event${fragment}` : void 0;
+}
+function link(uri, type) {
+  const u = clean(uri);
+  return u ? { uri: u, type } : void 0;
+}
+function presentationCsvRowToRecord(row) {
+  const description = stripHtmlToText(row.description);
+  const duration = parsePresentationDuration(row.duration) ?? durationFromMinutes(row.duration_min_minutes, row.duration_max_minutes);
+  const intendedAudiences = parseIntendedAudiences(row.intended_audiences);
+  const links = [
+    link(row.slides_url, "id.sifa.defs#linkSlides"),
+    link(row.recording_url, "id.sifa.defs#linkRecording"),
+    link(row.writeup_url, "id.sifa.defs#linkWriteup")
+  ].filter((l) => l !== void 0);
+  const record = { title: clean(row.title) };
+  if (description) record.description = description;
+  if (duration) record.duration = duration;
+  if (intendedAudiences.length) record.intendedAudiences = intendedAudiences;
+  if (links.length) record.links = links;
+  return { key: clean(row.presentation_key) || void 0, record };
+}
+function presentationDeliveryCsvRowToRecord(row) {
+  const links = [
+    link(row.event_url, "id.sifa.defs#linkEvent"),
+    link(row.recording_url, "id.sifa.defs#linkRecording")
+  ].filter((l) => l !== void 0);
+  const record = {};
+  const title = clean(row.title);
+  const eventName = clean(row.event_name);
+  const date = clean(row.date);
+  const location = clean(row.location);
+  const role = normalizePresentationRole(row.role);
+  const mode = normalizePresentationMode(row.mode);
+  if (title) record.title = title;
+  if (role) record.role = role;
+  if (eventName) record.eventName = eventName;
+  if (date) record.date = date;
+  if (location) record.location = location;
+  if (mode) record.mode = mode;
+  if (links.length) record.links = links;
+  return { presentationKey: clean(row.presentation_key) || void 0, record };
+}
+
 // src/cards/app-url-patterns.ts
 var APP_URL_PATTERNS = Object.freeze({
   bluesky: {
@@ -2444,7 +2550,7 @@ var ProfileVolunteeringRecordSchema = zod.z.object({
 });
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.11.3";
+var SIFA_SDK_VERSION = "0.11.5";
 
 exports.ACTIVITY_TIERS = ACTIVITY_TIERS;
 exports.ACTIVITY_VISIBILITY_RULES = ACTIVITY_VISIBILITY_RULES;
@@ -2528,11 +2634,13 @@ exports.dedupeSkills = dedupeSkills;
 exports.detectPdsProvider = detectPdsProvider;
 exports.didSchema = didSchema;
 exports.dimensionsFromInputs = dimensionsFromInputs;
+exports.durationFromMinutes = durationFromMinutes;
 exports.encodeFeedCursor = encodeFeedCursor;
 exports.externalRecordRefSchema = externalRecordRefSchema;
 exports.findIndustry = findIndustry;
 exports.formatDistanceToNow = formatDistanceToNow;
 exports.formatLocation = formatLocation;
+exports.formatPresentationDuration = formatPresentationDuration;
 exports.formatRelativeTime = formatRelativeTime;
 exports.getActivityTaxonomyVersion = getActivityTaxonomyVersion;
 exports.getActivityTier = getActivityTier;
@@ -2574,12 +2682,18 @@ exports.maxGraphemes = maxGraphemes;
 exports.meetsContrastAA = meetsContrastAA;
 exports.normalizeOpenTo = normalizeOpenTo;
 exports.normalizePlatformId = normalizePlatformId;
+exports.normalizePresentationMode = normalizePresentationMode;
+exports.normalizePresentationRole = normalizePresentationRole;
 exports.normalizeWorkplaceTypes = normalizeWorkplaceTypes;
 exports.openToTokenToValue = openToTokenToValue;
 exports.openToValueToToken = openToValueToToken;
+exports.parseIntendedAudiences = parseIntendedAudiences;
 exports.parseLocationString = parseLocationString;
+exports.parsePresentationDuration = parsePresentationDuration;
 exports.pdsProviderFromApi = pdsProviderFromApi;
 exports.pickPrimaryPosition = pickPrimaryPosition;
+exports.presentationCsvRowToRecord = presentationCsvRowToRecord;
+exports.presentationDeliveryCsvRowToRecord = presentationDeliveryCsvRowToRecord;
 exports.profileToDimensionInputs = profileToDimensionInputs;
 exports.relativeLuminance = relativeLuminance;
 exports.resolveCardUrl = resolveCardUrl;
@@ -2589,6 +2703,7 @@ exports.sanitizeHandleInput = sanitizeHandleInput;
 exports.selfLabelsSchema = selfLabelsSchema;
 exports.singleDateExtractor = singleDateExtractor;
 exports.sortByDateDesc = sortByDateDesc;
+exports.stripHtmlToText = stripHtmlToText;
 exports.strongRefSchema = strongRefSchema;
 exports.truncateGraphemes = truncateGraphemes;
 exports.uriSchema = uriSchema;