placementt-core 1.400.983 → 1.400.985

package/lib/typeDefinitions.d.ts

@@ -1964,6 +1964,7 @@ export type CheckInEntry = {
     activities?: string[];
     linkedinUrl?: string;
     currentPostcode?: string;
+    currentCity?: string;
     currentCountry?: string;
 };
 /** Trusted contact / parent fallback stored on the Alumni record */
@@ -2339,12 +2340,18 @@ export type Alumni = {
     sector?: string;
     subsector?: string;
     businessSize?: string;
-    /** Typed check-in history — replaces the previous untyped enrolmentHistory: {}[] */
+    /** Typed check-in history — replaces the previous untyped enrolmentHistory: {}[].
+     * This is the alumnus's activity timeline: every check-in appends here. */
     enrolmentHistory: CheckInEntry[];
+    /** Most recent check-in answers — the alumnus's current role/destination snapshot.
+     * Written on every check-in submission; a "no change" reply leaves it untouched. */
+    currentRole?: CheckInEntry;
     checkInConsent: boolean;
     checkInConsentDate?: string;
     lastCheckIn?: string;
     nextCheckInDue?: string;
+    /** ISO — when the most recent annual check-in invite was emailed; cron double-send guard. */
+    checkInInviteSentAt?: string;
     trustedContact?: TrustedContact;
     trustedContactConsent?: boolean;
     trustedContactConsentDate?: string;
@@ -2359,10 +2366,14 @@ export type Alumni = {
     lacStatus?: boolean;
     aspirationHistory?: AspirationEntry[];
     visibleToStudents?: boolean;
+    /** Consent to share their journey with students at other schools in their school's trust.
+     * Only meaningful when visibleToStudents is true and the school has an approved trust link. */
+    shareJourneyWithTrust?: boolean;
     enableConversations?: boolean;
     linkedinUrl?: string;
     homePostcode?: string;
     currentPostcode?: string;
+    currentCity?: string;
     currentCountry?: string;
     linkCode: string;
     linkCodeExpiry: string;
@@ -2843,7 +2854,8 @@ export type YearScoreData = {
     campaignsClicked?: number;
     campaignsFailed?: number;
 };
-type MessageTypes = "hubOrTrustInviteSchool" | "sendPlacementActionRequired" | "sendPlacementAdditionalInformationRequired" | "sendFeedbackReminder" | "sendProviderContactInvite" | "sendProviderContactActivityInvite" | "sendActivateUserAccount" | "shareEmployerEventRequest" | "employerEventInvite" | "schoolEventInvite" | "reuploadPlacementDocument" | "requestEventDates" | "taskReminder" | "eventDatesReminder" | "parentDatabase" | "aspirationInvite" | "leaverInvite" | "leaverReminder" | "leaverResultsInvite" | "leaverResultsReminder" | "leaverChristmasInvite" | "leaverChristmasReminder" | "alumniCheckInTrustedContact";
+type MessageTypes = "hubOrTrustInviteSchool" | "sendPlacementActionRequired" | "sendPlacementAdditionalInformationRequired" | "sendFeedbackReminder" | "sendProviderContactInvite" | "sendProviderContactActivityInvite" | "sendActivateUserAccount" | "shareEmployerEventRequest" | "employerEventInvite" | "schoolEventInvite" | "reuploadPlacementDocument" | "requestEventDates" | "taskReminder" | "eventDatesReminder" | "parentDatabase" | "aspirationInvite" | "leaverInvite" | "leaverReminder" | "leaverResultsInvite" | "leaverResultsReminder" | "leaverChristmasInvite" | "leaverChristmasReminder" | "alumniCheckInInvite" | // annual "where are you now" check-in — reminder chain falls back to the trusted contact
+"alumniCheckInTrustedContact";
 /** Keys for reminderFailureFunctions — the fallback dispatched once a reminder chain
  * is exhausted with no response. Params are read from the interaction's additionalData. */
 export type ReminderFallbackType = "checkInTrustedContact";

package/package.json

@@ -2,7 +2,7 @@
   "private": false,
   "name": "placementt-core",
   "author": "Placementt",
-  "version": "1.400.983",
+  "version": "1.400.985",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "scripts": {

package/src/typeDefinitions.ts

@@ -983,7 +983,7 @@ export type InstituteData = {
     emailTemplates?: {
         onboarding: boolean,
         employerDatabaseInvite?: string,
-    },
+    }, 
     acceptingParents?: boolean,
     parentDatabaseEmailTemplate?: string,
     publicEventsDescription?: Descendant[],
@@ -995,7 +995,8 @@ export type InstituteData = {
         k: string;
         e?: WhereFilterOp;
         v: unknown;
-    }[],}
+    }[],
+    }
     // RECURRING WORK EXPERIENCE GROUPS (templates that spawn a cohort instance each year)
     cohortConfig?: {
         [groupId: string]: {
@@ -1908,7 +1909,8 @@ export type CheckInEntry = {
     /** IDs of the institute's externalActivities this alumni is willing to support — mirrors the employer/alumni-join activity model. */
     activities?: string[],
     linkedinUrl?: string,
-    currentPostcode?: string,   // Alumni location at time of check-in — for map/mobility analysis
+    currentPostcode?: string,   // Legacy — no longer collected; annual check-in asks for city instead
+    currentCity?: string,       // Alumni town/city at time of check-in
     currentCountry?: string,    // Populated when alumni is outside UK
 }
 
@@ -2284,14 +2286,21 @@ export type Alumni = {
     subsector?: string,
     businessSize?: string,
 
-    /** Typed check-in history — replaces the previous untyped enrolmentHistory: {}[] */
+    /** Typed check-in history — replaces the previous untyped enrolmentHistory: {}[].
+     * This is the alumnus's activity timeline: every check-in appends here. */
     enrolmentHistory: CheckInEntry[],
 
+    /** Most recent check-in answers — the alumnus's current role/destination snapshot.
+     * Written on every check-in submission; a "no change" reply leaves it untouched. */
+    currentRole?: CheckInEntry,
+
     // Check-in management
     checkInConsent: boolean,
     checkInConsentDate?: string,
     lastCheckIn?: string,      // ISO date
     nextCheckInDue?: string,   // ISO date
+    /** ISO — when the most recent annual check-in invite was emailed; cron double-send guard. */
+    checkInInviteSentAt?: string,
 
     // Trusted contact
     trustedContact?: TrustedContact,
@@ -2316,12 +2325,16 @@ export type Alumni = {
 
     // Engagement
     visibleToStudents?: boolean,
+    /** Consent to share their journey with students at other schools in their school's trust.
+     * Only meaningful when visibleToStudents is true and the school has an approved trust link. */
+    shareJourneyWithTrust?: boolean,
     enableConversations?: boolean,
     linkedinUrl?: string,
 
     // Location (alumni-only — enables alumni map view)
     homePostcode?: string,      // Frozen from MIS at leaver export
-    currentPostcode?: string,   // Self-reported annually via Form C; may differ from homePostcode
+    currentPostcode?: string,   // Legacy — check-in now asks for city, not postcode
+    currentCity?: string,       // Self-reported town/city via the annual check-in
     currentCountry?: string,    // Populated when alumni has moved abroad; otherwise UK assumed
 
     // Auth
@@ -2768,6 +2781,7 @@ type MessageTypes =
     "leaverResultsReminder" |
     "leaverChristmasInvite" |
     "leaverChristmasReminder" |
+    "alumniCheckInInvite" | // annual "where are you now" check-in — reminder chain falls back to the trusted contact
     "alumniCheckInTrustedContact" // parent/trusted-contact fallback invite — has its own reminder chain
 
 /** Keys for reminderFailureFunctions — the fallback dispatched once a reminder chain