placementt-core 1.400.895 → 1.400.897

package/lib/typeDefinitions.d.ts

@@ -855,6 +855,16 @@ export type InstituteData = {
             url: string;
         };
     };
+    yearGroupConfig?: {
+        field: string;
+        valueMap: {
+            [rawValue: string]: number;
+        };
+        template?: {
+            prefix: string;
+            suffix: string;
+        };
+    };
     aspirationCycleConfig?: {
         autoSend?: boolean;
         scheduledSendMMDD?: string;

package/package.json

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

package/src/typeDefinitions.ts

@@ -840,6 +840,18 @@ export type InstituteData = {
             url: string
         }
     },
+    // YEAR GROUP MAPPING — student year groups are not standardised: the field
+    // may be details.yearGroup or details.year, and values vary ("10", "Year 10",
+    // "Y10"). Configured in Organisation → Field Mappings; consumed by aspiration
+    // surveys (and anything else needing canonical year group numbers).
+    yearGroupConfig?: {
+        field: string,                          // studentsFields entry holding year group, e.g. "yearGroup"
+        valueMap: {[rawValue: string]: number}, // raw stored value → canonical year number, e.g. {"Year 10": 10}
+        template?: {                            // shared prefix/suffix around the year number, e.g. "Year 10" -> {prefix: "Year ", suffix: ""}
+            prefix: string,
+            suffix: string,
+        },
+    },
     // ASPIRATION CYCLE CONFIGURATION (Form A — annual student intent tracking)
     aspirationCycleConfig?: {
         autoSend?: boolean,                     // if true, cron fires each year on scheduledSendMMDD