@singi-labs/sifa-sdk 0.19.44 → 0.19.46

package/dist/import/presentation-csv.js

@@ -0,0 +1,116 @@
+// 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;
+  const exact = ROLE_TOKENS[v];
+  if (exact) return exact;
+  if (v.includes("keynote")) return ROLE_TOKENS.keynote;
+  if (v.includes("workshop") || v.includes("masterclass") || v.includes("training"))
+    return ROLE_TOKENS.workshop;
+  if (v.includes("panel")) return ROLE_TOKENS.panelist;
+  if (v.includes("host") || v.includes("moderat") || v.includes("emcee") || v.includes("chair"))
+    return ROLE_TOKENS.host;
+  if (v.includes("speaker") || v.includes("present") || v.includes("talk"))
+    return ROLE_TOKENS.presenter;
+  return void 0;
+}
+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 };
+}
+export {
+  durationFromMinutes,
+  normalizePresentationMode,
+  normalizePresentationRole,
+  parseIntendedAudiences,
+  parsePresentationDuration,
+  presentationCsvRowToRecord,
+  presentationDeliveryCsvRowToRecord,
+  stripHtmlToText
+};
+//# sourceMappingURL=presentation-csv.js.map

package/dist/import/presentation-csv.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/import/presentation-csv.ts"],"sourcesContent":["import type {\n  ProfilePresentationRecord,\n  ProfilePresentationDeliveryRecord,\n  PresentationLink,\n  PresentationDuration,\n} from '../schemas/index.js';\n\n/**\n * CSV parsers for the Talks & sessions import (two templates joined by a\n * presentation_key). The value parsers and row mappers are reusable and pure;\n * the actual PDS writing (create a presentation, then write its deliveries with\n * a presentationRef to it) is orchestrated by the consumer, which has the\n * created record's AT-URI.\n */\n\n/** A CSV row as a header-keyed map. Missing cells may be undefined or empty. */\nexport type CsvRow = Record<string, string | undefined>;\n\nfunction clean(value: string | undefined): string {\n  return (value ?? '').trim();\n}\n\n/**\n * Parse a free-text duration into minutes: a single value (\"30 min\", \"30\n * minutes\", \"30\") or a range (\"20-30 min\", \"20 to 30 minutes\", \"20-30\").\n * Returns undefined when no usable number is present. A second number is used\n * as the upper bound only when it is greater than or equal to the first.\n */\nexport function parsePresentationDuration(\n  input: string | undefined,\n): PresentationDuration | undefined {\n  const numbers = (clean(input).match(/\\d+/g) ?? [])\n    .map((n) => Number.parseInt(n, 10))\n    .filter((n) => Number.isInteger(n) && n > 0);\n  // `.at()` is typed `number | undefined`, which both tsc (under\n  // noUncheckedIndexedAccess) and eslint agree on, so the guards are clean.\n  const min = numbers.at(0);\n  if (min === undefined) return undefined;\n  const max = numbers.at(1);\n  return max !== undefined && max >= min\n    ? { minMinutes: min, maxMinutes: max }\n    : { minMinutes: min };\n}\n\n/** Build a duration from explicit min/max minute columns. */\nexport function durationFromMinutes(\n  minRaw: string | undefined,\n  maxRaw: string | undefined,\n): PresentationDuration | undefined {\n  const min = Number.parseInt(clean(minRaw), 10);\n  if (!Number.isInteger(min) || min < 1) return undefined;\n  const max = Number.parseInt(clean(maxRaw), 10);\n  return Number.isInteger(max) && max >= min\n    ? { minMinutes: min, maxMinutes: max }\n    : { minMinutes: min };\n}\n\n/** Split a delimited list into trimmed, non-empty values. Default delimiter \";\". */\nexport function parseIntendedAudiences(input: string | undefined, delimiter = ';'): string[] {\n  return clean(input)\n    .split(delimiter)\n    .map((s) => s.trim())\n    .filter(Boolean);\n}\n\n/**\n * Strip HTML to plain text and decode the common entities, for descriptions\n * exported as HTML (e.g. Webflow). The AppView re-sanitizes on write; this is\n * only to produce readable text.\n */\nexport function stripHtmlToText(input: string | undefined): string {\n  const text = clean(input)\n    .replace(/<\\s*br\\s*\\/?>/gi, '\\n')\n    .replace(/<\\/\\s*(p|div|li|h[1-6])\\s*>/gi, '\\n')\n    .replace(/<[^>]*>/g, '')\n    .replace(/&nbsp;/gi, ' ')\n    .replace(/&amp;/gi, '&')\n    .replace(/&lt;/gi, '<')\n    .replace(/&gt;/gi, '>')\n    .replace(/&quot;/gi, '\"')\n    .replace(/&#0*39;|&apos;/gi, \"'\");\n  return text\n    .replace(/[ \\t]+/g, ' ')\n    .replace(/ *\\n */g, '\\n')\n    .replace(/\\n{3,}/g, '\\n\\n')\n    .trim();\n}\n\nconst ROLE_TOKENS: Record<string, string> = {\n  presenter: 'id.sifa.defs#presenter',\n  speaker: 'id.sifa.defs#presenter',\n  panelist: 'id.sifa.defs#panelist',\n  keynote: 'id.sifa.defs#keynote',\n  workshop: 'id.sifa.defs#workshop',\n  host: 'id.sifa.defs#host',\n};\n\n/**\n * Map a friendly role value to its token. An existing token passes through.\n * Free-text or compound values (e.g. \"Organizer & co-host/moderator\") are\n * mapped to the nearest token by keyword. An organizer-only value has no\n * speaking token, so it, and any other unrecognized value, is dropped rather\n * than stored raw -- matching normalizePresentationMode's drop-unknown\n * behavior, so a fixed role dropdown never has to render arbitrary strings.\n */\nexport function normalizePresentationRole(value: string | undefined): string | undefined {\n  const v = clean(value).toLowerCase();\n  if (!v) return undefined;\n  if (v.startsWith('id.sifa.defs#')) return v;\n  const exact = ROLE_TOKENS[v];\n  if (exact) return exact;\n  if (v.includes('keynote')) return ROLE_TOKENS.keynote;\n  if (v.includes('workshop') || v.includes('masterclass') || v.includes('training'))\n    return ROLE_TOKENS.workshop;\n  if (v.includes('panel')) return ROLE_TOKENS.panelist;\n  if (v.includes('host') || v.includes('moderat') || v.includes('emcee') || v.includes('chair'))\n    return ROLE_TOKENS.host;\n  if (v.includes('speaker') || v.includes('present') || v.includes('talk'))\n    return ROLE_TOKENS.presenter;\n  return undefined;\n}\n\nconst MODE_FRAGMENTS: Record<string, string> = {\n  inperson: '#inperson',\n  'in person': '#inperson',\n  'in-person': '#inperson',\n  virtual: '#virtual',\n  online: '#virtual',\n  remote: '#virtual',\n  hybrid: '#hybrid',\n};\n\n/** Map a friendly mode value to the community calendar token; drops an unknown value. */\nexport function normalizePresentationMode(value: string | undefined): string | undefined {\n  const v = clean(value).toLowerCase();\n  if (!v) return undefined;\n  if (v.startsWith('community.lexicon.calendar.event#')) return v;\n  const fragment = MODE_FRAGMENTS[v];\n  return fragment ? `community.lexicon.calendar.event${fragment}` : undefined;\n}\n\nfunction link(uri: string | undefined, type: string): PresentationLink | undefined {\n  const u = clean(uri);\n  return u ? { uri: u, type } : undefined;\n}\n\nexport interface ParsedPresentation {\n  /** presentation_key used to link delivery rows to this presentation. */\n  key?: string;\n  record: Omit<ProfilePresentationRecord, 'createdAt'>;\n}\n\n/** Map a row of the presentations template to a presentation record (minus createdAt). */\nexport function presentationCsvRowToRecord(row: CsvRow): ParsedPresentation {\n  const description = stripHtmlToText(row.description);\n  const duration =\n    parsePresentationDuration(row.duration) ??\n    durationFromMinutes(row.duration_min_minutes, row.duration_max_minutes);\n  const intendedAudiences = parseIntendedAudiences(row.intended_audiences);\n  const links = [\n    link(row.slides_url, 'id.sifa.defs#linkSlides'),\n    link(row.recording_url, 'id.sifa.defs#linkRecording'),\n    link(row.writeup_url, 'id.sifa.defs#linkWriteup'),\n  ].filter((l): l is PresentationLink => l !== undefined);\n\n  const record: Omit<ProfilePresentationRecord, 'createdAt'> = { title: clean(row.title) };\n  if (description) record.description = description;\n  if (duration) record.duration = duration;\n  if (intendedAudiences.length) record.intendedAudiences = intendedAudiences;\n  if (links.length) record.links = links;\n\n  return { key: clean(row.presentation_key) || undefined, record };\n}\n\nexport interface ParsedDelivery {\n  /** presentation_key to resolve into a presentationRef once the presentation exists. */\n  presentationKey?: string;\n  record: Omit<ProfilePresentationDeliveryRecord, 'createdAt' | 'presentationRef'>;\n}\n\n/** Map a row of the deliveries template to a delivery record (minus createdAt and presentationRef). */\nexport function presentationDeliveryCsvRowToRecord(row: CsvRow): ParsedDelivery {\n  const links = [\n    link(row.event_url, 'id.sifa.defs#linkEvent'),\n    link(row.recording_url, 'id.sifa.defs#linkRecording'),\n  ].filter((l): l is PresentationLink => l !== undefined);\n\n  const record: Omit<ProfilePresentationDeliveryRecord, 'createdAt' | 'presentationRef'> = {};\n  const title = clean(row.title);\n  const eventName = clean(row.event_name);\n  const date = clean(row.date);\n  const location = clean(row.location);\n  const role = normalizePresentationRole(row.role);\n  const mode = normalizePresentationMode(row.mode);\n  if (title) record.title = title;\n  if (role) record.role = role;\n  if (eventName) record.eventName = eventName;\n  if (date) record.date = date;\n  if (location) record.location = location;\n  if (mode) record.mode = mode;\n  if (links.length) record.links = links;\n\n  return { presentationKey: clean(row.presentation_key) || undefined, record };\n}\n"],"mappings":";AAkBA,SAAS,MAAM,OAAmC;AAChD,UAAQ,SAAS,IAAI,KAAK;AAC5B;AAQO,SAAS,0BACd,OACkC;AAClC,QAAM,WAAW,MAAM,KAAK,EAAE,MAAM,MAAM,KAAK,CAAC,GAC7C,IAAI,CAAC,MAAM,OAAO,SAAS,GAAG,EAAE,CAAC,EACjC,OAAO,CAAC,MAAM,OAAO,UAAU,CAAC,KAAK,IAAI,CAAC;AAG7C,QAAM,MAAM,QAAQ,GAAG,CAAC;AACxB,MAAI,QAAQ,OAAW,QAAO;AAC9B,QAAM,MAAM,QAAQ,GAAG,CAAC;AACxB,SAAO,QAAQ,UAAa,OAAO,MAC/B,EAAE,YAAY,KAAK,YAAY,IAAI,IACnC,EAAE,YAAY,IAAI;AACxB;AAGO,SAAS,oBACd,QACA,QACkC;AAClC,QAAM,MAAM,OAAO,SAAS,MAAM,MAAM,GAAG,EAAE;AAC7C,MAAI,CAAC,OAAO,UAAU,GAAG,KAAK,MAAM,EAAG,QAAO;AAC9C,QAAM,MAAM,OAAO,SAAS,MAAM,MAAM,GAAG,EAAE;AAC7C,SAAO,OAAO,UAAU,GAAG,KAAK,OAAO,MACnC,EAAE,YAAY,KAAK,YAAY,IAAI,IACnC,EAAE,YAAY,IAAI;AACxB;AAGO,SAAS,uBAAuB,OAA2B,YAAY,KAAe;AAC3F,SAAO,MAAM,KAAK,EACf,MAAM,SAAS,EACf,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EACnB,OAAO,OAAO;AACnB;AAOO,SAAS,gBAAgB,OAAmC;AACjE,QAAM,OAAO,MAAM,KAAK,EACrB,QAAQ,mBAAmB,IAAI,EAC/B,QAAQ,iCAAiC,IAAI,EAC7C,QAAQ,YAAY,EAAE,EACtB,QAAQ,YAAY,GAAG,EACvB,QAAQ,WAAW,GAAG,EACtB,QAAQ,UAAU,GAAG,EACrB,QAAQ,UAAU,GAAG,EACrB,QAAQ,YAAY,GAAG,EACvB,QAAQ,oBAAoB,GAAG;AAClC,SAAO,KACJ,QAAQ,WAAW,GAAG,EACtB,QAAQ,WAAW,IAAI,EACvB,QAAQ,WAAW,MAAM,EACzB,KAAK;AACV;AAEA,IAAM,cAAsC;AAAA,EAC1C,WAAW;AAAA,EACX,SAAS;AAAA,EACT,UAAU;AAAA,EACV,SAAS;AAAA,EACT,UAAU;AAAA,EACV,MAAM;AACR;AAUO,SAAS,0BAA0B,OAA+C;AACvF,QAAM,IAAI,MAAM,KAAK,EAAE,YAAY;AACnC,MAAI,CAAC,EAAG,QAAO;AACf,MAAI,EAAE,WAAW,eAAe,EAAG,QAAO;AAC1C,QAAM,QAAQ,YAAY,CAAC;AAC3B,MAAI,MAAO,QAAO;AAClB,MAAI,EAAE,SAAS,SAAS,EAAG,QAAO,YAAY;AAC9C,MAAI,EAAE,SAAS,UAAU,KAAK,EAAE,SAAS,aAAa,KAAK,EAAE,SAAS,UAAU;AAC9E,WAAO,YAAY;AACrB,MAAI,EAAE,SAAS,OAAO,EAAG,QAAO,YAAY;AAC5C,MAAI,EAAE,SAAS,MAAM,KAAK,EAAE,SAAS,SAAS,KAAK,EAAE,SAAS,OAAO,KAAK,EAAE,SAAS,OAAO;AAC1F,WAAO,YAAY;AACrB,MAAI,EAAE,SAAS,SAAS,KAAK,EAAE,SAAS,SAAS,KAAK,EAAE,SAAS,MAAM;AACrE,WAAO,YAAY;AACrB,SAAO;AACT;AAEA,IAAM,iBAAyC;AAAA,EAC7C,UAAU;AAAA,EACV,aAAa;AAAA,EACb,aAAa;AAAA,EACb,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,QAAQ;AACV;AAGO,SAAS,0BAA0B,OAA+C;AACvF,QAAM,IAAI,MAAM,KAAK,EAAE,YAAY;AACnC,MAAI,CAAC,EAAG,QAAO;AACf,MAAI,EAAE,WAAW,mCAAmC,EAAG,QAAO;AAC9D,QAAM,WAAW,eAAe,CAAC;AACjC,SAAO,WAAW,mCAAmC,QAAQ,KAAK;AACpE;AAEA,SAAS,KAAK,KAAyB,MAA4C;AACjF,QAAM,IAAI,MAAM,GAAG;AACnB,SAAO,IAAI,EAAE,KAAK,GAAG,KAAK,IAAI;AAChC;AASO,SAAS,2BAA2B,KAAiC;AAC1E,QAAM,cAAc,gBAAgB,IAAI,WAAW;AACnD,QAAM,WACJ,0BAA0B,IAAI,QAAQ,KACtC,oBAAoB,IAAI,sBAAsB,IAAI,oBAAoB;AACxE,QAAM,oBAAoB,uBAAuB,IAAI,kBAAkB;AACvE,QAAM,QAAQ;AAAA,IACZ,KAAK,IAAI,YAAY,yBAAyB;AAAA,IAC9C,KAAK,IAAI,eAAe,4BAA4B;AAAA,IACpD,KAAK,IAAI,aAAa,0BAA0B;AAAA,EAClD,EAAE,OAAO,CAAC,MAA6B,MAAM,MAAS;AAEtD,QAAM,SAAuD,EAAE,OAAO,MAAM,IAAI,KAAK,EAAE;AACvF,MAAI,YAAa,QAAO,cAAc;AACtC,MAAI,SAAU,QAAO,WAAW;AAChC,MAAI,kBAAkB,OAAQ,QAAO,oBAAoB;AACzD,MAAI,MAAM,OAAQ,QAAO,QAAQ;AAEjC,SAAO,EAAE,KAAK,MAAM,IAAI,gBAAgB,KAAK,QAAW,OAAO;AACjE;AASO,SAAS,mCAAmC,KAA6B;AAC9E,QAAM,QAAQ;AAAA,IACZ,KAAK,IAAI,WAAW,wBAAwB;AAAA,IAC5C,KAAK,IAAI,eAAe,4BAA4B;AAAA,EACtD,EAAE,OAAO,CAAC,MAA6B,MAAM,MAAS;AAEtD,QAAM,SAAmF,CAAC;AAC1F,QAAM,QAAQ,MAAM,IAAI,KAAK;AAC7B,QAAM,YAAY,MAAM,IAAI,UAAU;AACtC,QAAM,OAAO,MAAM,IAAI,IAAI;AAC3B,QAAM,WAAW,MAAM,IAAI,QAAQ;AACnC,QAAM,OAAO,0BAA0B,IAAI,IAAI;AAC/C,QAAM,OAAO,0BAA0B,IAAI,IAAI;AAC/C,MAAI,MAAO,QAAO,QAAQ;AAC1B,MAAI,KAAM,QAAO,OAAO;AACxB,MAAI,UAAW,QAAO,YAAY;AAClC,MAAI,KAAM,QAAO,OAAO;AACxB,MAAI,SAAU,QAAO,WAAW;AAChC,MAAI,KAAM,QAAO,OAAO;AACxB,MAAI,MAAM,OAAQ,QAAO,QAAQ;AAEjC,SAAO,EAAE,iBAAiB,MAAM,IAAI,gBAAgB,KAAK,QAAW,OAAO;AAC7E;","names":[]}

package/dist/index.cjs

@@ -2824,6 +2824,8 @@ var DATE_LOOKAHEAD_MONTHS = {
   projectStart: 6,
   publication: 6,
   talk: 12,
+  /** Admitted to a programme that starts next year. */
+  educationStart: 12,
   educationEnd: 96
 };
 function isBeyondLookahead(value, months, now = /* @__PURE__ */ new Date()) {
@@ -2859,6 +2861,9 @@ function formatPositionDateRange(start, end, now = /* @__PURE__ */ new Date()) {
   if (start && !end && isUpcomingStart(start, now)) return `Starts ${formatTimelineDate(start)}`;
   return formatDateRange(start, end);
 }
+function formatCredentialDateRange(issueDate, expiryDate) {
+  return formatDateRange(issueDate ?? void 0, expiryDate ?? void 0, false);
+}
 
 // src/format/collapse-contributors.ts
 function collapseContributors(contributors, options = {}) {
@@ -7084,7 +7089,7 @@ function describeSifaRecord(collection, value) {
 }
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.19.44";
+var SIFA_SDK_VERSION = "0.19.46";
 
 exports.ACTIVITY_TIERS = ACTIVITY_TIERS;
 exports.ACTIVITY_VERBS = ACTIVITY_VERBS;
@@ -7244,6 +7249,7 @@ exports.externalRecordRefSchema = externalRecordRefSchema;
 exports.filterHidden = filterHidden;
 exports.findIndustry = findIndustry;
 exports.formatCompanyName = formatCompanyName;
+exports.formatCredentialDateRange = formatCredentialDateRange;
 exports.formatDateRange = formatDateRange;
 exports.formatDisplayUrl = formatDisplayUrl;
 exports.formatDistanceToNow = formatDistanceToNow;