placementt-core 1.400.925 → 1.400.926

package/lib/typeDefinitions.d.ts

@@ -2003,6 +2003,23 @@ export type AspirationSurveySlot = {
     sendMMDD: string;
     label?: string;
 };
+/**
+ * Per-year-group leaver settings. Used as an override entry in
+ * DestinationsConfig.leavers.byYearGroup — each field replaces the shared leaver
+ * default for that year group only. All MM-DD strings are zero-padded.
+ */
+export type LeaverYearGroupConfig = {
+    intentionsSendMMDD: string;
+    resultsDay: {
+        enabled: boolean;
+        sendMMDD: string;
+    };
+    christmas: {
+        enabled: boolean;
+        sendMMDD: string;
+    };
+    allStudentsLeave?: boolean;
+};
 /**
  * One-time Destinations setup, saved on institutes/{oId}.destinationsConfig by the
  * setup wizard. destinationsProvisionCron reads it each year to auto-create that
@@ -2039,6 +2056,13 @@ export type DestinationsConfig = {
         };
         /** true → every student in these groups leaves (no internal sixth form). */
         allStudentsLeave?: boolean;
+        /** Optional per-year-group override. When a year group key is present its
+         * settings REPLACE the shared leaver fields above for that year group only
+         * (Y11 and Y13 typically differ — GCSE vs A-level results days, sixth-form
+         * stayers, etc.). Falls back to the shared fields when a key is absent. */
+        byYearGroup?: {
+            [yearGroup: string]: LeaverYearGroupConfig;
+        };
         recipientFilters?: DestinationsRecipientFilter;
     };
     alumni: {
@@ -3100,7 +3124,7 @@ export type LeaverGroup = {
     created: string;
     stage: "review" | "created" | "scheduled" | "sent" | "archived";
     emailTemplate?: string;
-    students: string;
+    students?: string;
     sendAt?: string;
     sentAt?: string;
     reminderSentAt?: string;

package/package.json

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

package/src/typeDefinitions.ts

@@ -1916,6 +1916,18 @@ export type DestinationsRecipientFilter = {k: string, e?: WhereFilterOp, v: unkn
 /** One scheduled survey in a year's aspiration programme. `sendMMDD` is "MM-DD". */
 export type AspirationSurveySlot = {sendMMDD: string, label?: string};
 
+/**
+ * Per-year-group leaver settings. Used as an override entry in
+ * DestinationsConfig.leavers.byYearGroup — each field replaces the shared leaver
+ * default for that year group only. All MM-DD strings are zero-padded.
+ */
+export type LeaverYearGroupConfig = {
+    intentionsSendMMDD: string,
+    resultsDay: {enabled: boolean, sendMMDD: string},
+    christmas: {enabled: boolean, sendMMDD: string},
+    allStudentsLeave?: boolean,
+};
+
 /**
  * One-time Destinations setup, saved on institutes/{oId}.destinationsConfig by the
  * setup wizard. destinationsProvisionCron reads it each year to auto-create that
@@ -1946,6 +1958,11 @@ export type DestinationsConfig = {
         christmas: {enabled: boolean, sendMMDD: string},    // default "12-08"
         /** true → every student in these groups leaves (no internal sixth form). */
         allStudentsLeave?: boolean,
+        /** Optional per-year-group override. When a year group key is present its
+         * settings REPLACE the shared leaver fields above for that year group only
+         * (Y11 and Y13 typically differ — GCSE vs A-level results days, sixth-form
+         * stayers, etc.). Falls back to the shared fields when a key is absent. */
+        byYearGroup?: {[yearGroup: string]: LeaverYearGroupConfig},
         recipientFilters?: DestinationsRecipientFilter,
     },
     // ── Alumni (mirrors the institute root flags) ──
@@ -3088,7 +3105,7 @@ export type LeaverGroup = {
     created: string;
     stage: "review" | "created" | "scheduled" | "sent" | "archived"; // Sent means we have sent the request to the students.
     emailTemplate?: string, // What template to use for the request?
-    students: string, // Data Viewer Backend
+    students?: string, // Data Viewer Backend — absent on auto-provisioned drafts until staff pick recipients
     sendAt?: string,                            // ISO — scheduled send date; cron fires emails on/after this
     sentAt?: string,                            // ISO — when invite emails actually fired
     reminderSentAt?: string,                    // ISO — day-14 reminder fire time