@singi-labs/sifa-sdk 0.19.29 → 0.19.31

package/dist/{index-4R221H7q.d.ts → index-CpbCm2Fe.d.ts}

@@ -503,6 +503,14 @@ interface ProfileCourse {
     /** Date the course was completed, as an RFC 3339 datetime. Optional; the
      * editor collects month granularity (YYYY-MM). */
     completedAt?: string;
+    /** `id.sifa.defs#courseRole` token. Absent means the user took the course. */
+    role?: string;
+    /** Teaching period of a taught or assisted course (YYYY, YYYY-MM or YYYY-MM-DD). */
+    startedAt?: string;
+    endedAt?: string;
+    /** rkey of the position the course was taught under. The AppView resolves
+     * it from the record's `position` at-uri when building the profile view. */
+    positionRkey?: string;
     hidden?: boolean;
 }
 /** A related link on a presentation or delivery, as returned by the AppView. */
@@ -576,7 +584,7 @@ interface ProfilePresentationDelivery {
     title?: string | null;
     role?: string | null;
     eventName?: string | null;
-    /** Day-only date, YYYY-MM-DD. */
+    /** YYYY-MM-DD, or YYYY-MM / YYYY when the exact day is unknown. */
     date?: string | null;
     location?: string | null;
     locationCountry?: string | null;

package/dist/{index-BKSZeo7T.d.cts → index-piLIwMN1.d.cts}

@@ -503,6 +503,14 @@ interface ProfileCourse {
     /** Date the course was completed, as an RFC 3339 datetime. Optional; the
      * editor collects month granularity (YYYY-MM). */
     completedAt?: string;
+    /** `id.sifa.defs#courseRole` token. Absent means the user took the course. */
+    role?: string;
+    /** Teaching period of a taught or assisted course (YYYY, YYYY-MM or YYYY-MM-DD). */
+    startedAt?: string;
+    endedAt?: string;
+    /** rkey of the position the course was taught under. The AppView resolves
+     * it from the record's `position` at-uri when building the profile view. */
+    positionRkey?: string;
     hidden?: boolean;
 }
 /** A related link on a presentation or delivery, as returned by the AppView. */
@@ -576,7 +584,7 @@ interface ProfilePresentationDelivery {
     title?: string | null;
     role?: string | null;
     eventName?: string | null;
-    /** Day-only date, YYYY-MM-DD. */
+    /** YYYY-MM-DD, or YYYY-MM / YYYY when the exact day is unknown. */
     date?: string | null;
     location?: string | null;
     locationCountry?: string | null;

package/dist/index.cjs

@@ -2257,6 +2257,33 @@ function getInvolvementKindHeading(value) {
   return INVOLVEMENT_KIND_HEADINGS[value] ?? "Other";
 }
 
+// src/taxonomy/course-role.ts
+var COURSE_ROLE_TAKEN = "id.sifa.defs#courseTaken";
+var COURSE_ROLE_TAUGHT = "id.sifa.defs#courseTaught";
+var COURSE_ROLE_TEACHING_ASSISTANT = "id.sifa.defs#courseTeachingAssistant";
+var COURSE_ROLE_OPTIONS = [
+  { value: COURSE_ROLE_TAKEN, label: "Student" },
+  { value: COURSE_ROLE_TAUGHT, label: "Instructor" },
+  { value: COURSE_ROLE_TEACHING_ASSISTANT, label: "Teaching assistant" }
+];
+var COURSE_ROLE_LABELS = Object.fromEntries(
+  COURSE_ROLE_OPTIONS.map((o) => [o.value, o.label])
+);
+function getCourseRoleLabel(value) {
+  if (!value) return void 0;
+  return COURSE_ROLE_LABELS[value];
+}
+var TEACHING_ROLES = /* @__PURE__ */ new Set([COURSE_ROLE_TAUGHT, COURSE_ROLE_TEACHING_ASSISTANT]);
+function isTeachingCourse(course) {
+  return !!course.role && TEACHING_ROLES.has(course.role);
+}
+function splitCoursesByRole(courses) {
+  const taken = [];
+  const teaching = [];
+  for (const c of courses) (isTeachingCourse(c) ? teaching : taken).push(c);
+  return { taken, teaching };
+}
+
 // src/taxonomy/artifact-link-kind.ts
 var ARTIFACT_LINK_KIND_OPTIONS = [
   { value: "pull-request", label: "Pull request" },
@@ -6099,6 +6126,14 @@ var ProfileCourseRecordSchema = zod.z.object({
   // at-uri (not a strongRef) so the link tracks the live certification.
   credential: atUriSchema.optional(),
   completedAt: partialDateSchema.optional(),
+  // id.sifa.defs#courseRole token; absent means the user took the course.
+  role: zod.z.string().refine(maxGraphemes(64)).max(640).optional(),
+  // Teaching period of a taught or assisted course.
+  startedAt: partialDateSchema.optional(),
+  endedAt: partialDateSchema.optional(),
+  // AT-URI of the id.sifa.profile.position the course was taught under. Plain
+  // at-uri (not a strongRef) so the link tracks the live position.
+  position: atUriSchema.optional(),
   createdAt: datetimeSchema
 });
 var ProfileEducationRecordSchema = zod.z.object({
@@ -6272,8 +6307,8 @@ var ProfilePresentationDeliveryRecordSchema = zod.z.object({
   title: zod.z.string().refine(maxGraphemes(300)).max(3e3).optional(),
   role: zod.z.string().refine(maxGraphemes(64)).max(640).optional(),
   eventName: zod.z.string().refine(maxGraphemes(300)).max(3e3).optional(),
-  // Calendar date as YYYY-MM-DD (day only).
-  date: zod.z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "date must be YYYY-MM-DD").optional(),
+  // Calendar date as YYYY-MM-DD, or YYYY-MM / YYYY when the exact day is unknown.
+  date: zod.z.string().regex(/^\d{4}(-\d{2}(-\d{2})?)?$/, "date must be YYYY, YYYY-MM or YYYY-MM-DD").optional(),
   location: zod.z.string().refine(maxGraphemes(256)).max(2560).optional(),
   // Structured community.lexicon.location.address for the occasion. The
   // free-text `location` string above stays as a legacy fallback.
@@ -6661,7 +6696,7 @@ function describeSifaRecord(collection, value) {
 }
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.19.29";
+var SIFA_SDK_VERSION = "0.19.31";
 
 exports.ACTIVITY_TIERS = ACTIVITY_TIERS;
 exports.ACTIVITY_VERBS = ACTIVITY_VERBS;
@@ -6687,6 +6722,11 @@ exports.COMPANY_PAGE_MIN_FIRMOGRAPHIC_FIELDS = COMPANY_PAGE_MIN_FIRMOGRAPHIC_FIE
 exports.COMPLETENESS_MAX_SCORE = COMPLETENESS_MAX_SCORE;
 exports.CONTINENTS = CONTINENTS;
 exports.COUNTRIES = COUNTRIES;
+exports.COURSE_ROLE_LABELS = COURSE_ROLE_LABELS;
+exports.COURSE_ROLE_OPTIONS = COURSE_ROLE_OPTIONS;
+exports.COURSE_ROLE_TAKEN = COURSE_ROLE_TAKEN;
+exports.COURSE_ROLE_TAUGHT = COURSE_ROLE_TAUGHT;
+exports.COURSE_ROLE_TEACHING_ASSISTANT = COURSE_ROLE_TEACHING_ASSISTANT;
 exports.DIMENSIONS_MAX_SCORE = DIMENSIONS_MAX_SCORE;
 exports.EMPLOYMENT_TYPE_GROUPS = EMPLOYMENT_TYPE_GROUPS;
 exports.EMPLOYMENT_TYPE_LABELS = EMPLOYMENT_TYPE_LABELS;
@@ -6829,6 +6869,7 @@ exports.getArtifactLinkKindLabel = getArtifactLinkKindLabel;
 exports.getCalendarEventModeLabel = getCalendarEventModeLabel;
 exports.getCalendarEventStatusLabel = getCalendarEventStatusLabel;
 exports.getContinent = getContinent;
+exports.getCourseRoleLabel = getCourseRoleLabel;
 exports.getDisplayLabel = getDisplayLabel;
 exports.getEmploymentTypeLabel = getEmploymentTypeLabel;
 exports.getFaviconUrl = getFaviconUrl;
@@ -6875,6 +6916,7 @@ exports.isRelationalActivity = isRelationalActivity;
 exports.isRoleLineRedundant = isRoleLineRedundant;
 exports.isSectionPopulated = isSectionPopulated;
 exports.isSelfAuthoredRich = isSelfAuthoredRich;
+exports.isTeachingCourse = isTeachingCourse;
 exports.isValidRgbColor = isValidRgbColor;
 exports.isVisibleActivityItem = isVisibleActivityItem;
 exports.languageTagSchema = languageTagSchema;
@@ -6941,6 +6983,7 @@ exports.sortLanguagesByProficiency = sortLanguagesByProficiency;
 exports.sortPositions = sortPositions;
 exports.sortProjects = sortProjects;
 exports.sortPublications = sortPublications;
+exports.splitCoursesByRole = splitCoursesByRole;
 exports.streamAddressSchema = streamAddressSchema;
 exports.streamAuthorSchema = streamAuthorSchema;
 exports.streamCardBodySchema = streamCardBodySchema;