placementt-core 1.400.967 → 1.400.969

package/lib/typeDefinitions.d.ts

@@ -3350,7 +3350,17 @@ export type LeaverGroup = {
 };
 /** Keys identifying each importable LMI source. Used for lmiMeta/status and
  * for addressing individual sync callables from the admin cards. */
-export type LmiSourceKey = "socDescriptions" | "asheNational" | "asheRegional" | "nomisEmployment" | "standards";
+export type LmiSourceKey = "socDescriptions" | "asheNational" | "asheRegional" | "nomisEmployment" | "standards" | "titleAliases";
+/** One searchable job-title alias pointing into a 4-digit SOC profile, from the
+ * ONS SOC 2020 Volume 2 coding index (~30k titles). Stored in lmiTitleAliases
+ * so a student searching "physiotherapist" or "ethical hacker" resolves to the
+ * right occupation even though those aren't SOC unit-group names. */
+export type LmiTitleAlias = {
+    title: string;
+    search: string;
+    keywords: string[];
+    soc: string;
+};
 /** National full-time gross annual pay percentiles for an occupation (whole
  * pounds). Any percentile ONS suppressed ("x" / "..") is stored as null. */
 export type LmiSalaryPercentiles = {
@@ -3427,6 +3437,9 @@ export type LmiMetaConfig = {
         standards?: {
             url: string;
         };
+        titleAliases?: {
+            url: string;
+        };
     };
     /** Optional per-source note surfaced in the admin card, e.g. to flag a URL
      * that could not be verified and should be checked/corrected by an admin. */
@@ -3466,5 +3479,9 @@ export type LmiStandardsMatchReview = {
         standardLevel: number;
         confidence: number;
     }[];
+    /** Why-it-did-what-it-did counters + samples, for debugging the run. */
+    diagnostics?: {
+        [key: string]: unknown;
+    };
 };
 export {};

package/package.json

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

package/src/typeDefinitions.ts

@@ -3334,7 +3334,19 @@ export type LeaverGroup = {
 /** Keys identifying each importable LMI source. Used for lmiMeta/status and
  * for addressing individual sync callables from the admin cards. */
 export type LmiSourceKey =
-    "socDescriptions"|"asheNational"|"asheRegional"|"nomisEmployment"|"standards";
+    "socDescriptions"|"asheNational"|"asheRegional"|"nomisEmployment"|
+    "standards"|"titleAliases";
+
+/** One searchable job-title alias pointing into a 4-digit SOC profile, from the
+ * ONS SOC 2020 Volume 2 coding index (~30k titles). Stored in lmiTitleAliases
+ * so a student searching "physiotherapist" or "ethical hacker" resolves to the
+ * right occupation even though those aren't SOC unit-group names. */
+export type LmiTitleAlias = {
+    title: string,          // display title, natural word order
+    search: string,         // sanitised lowercase title for prefix search
+    keywords: string[],     // sanitised tokens for word (array-contains) search
+    soc: string,            // 4-digit SOC 2020 the title codes to
+}
 
 /** National full-time gross annual pay percentiles for an occupation (whole
  * pounds). Any percentile ONS suppressed ("x" / "..") is stored as null. */
@@ -3400,6 +3412,7 @@ export type LmiMetaConfig = {
         socVolume1: {url: string},
         nomis: {datasetId: string, geography: string},
         standards?: {url: string},  // Phase 3 — IfATE/Skills England endpoint
+        titleAliases?: {url: string}, // ONS SOC 2020 Vol 2 coding index
     },
     /** Optional per-source note surfaced in the admin card, e.g. to flag a URL
      * that could not be verified and should be checked/corrected by an admin. */
@@ -3434,4 +3447,6 @@ export type LmiStandardsMatchReview = {
         standardLevel: number,
         confidence: number,        // 0-1 heuristic score
     }[],
+    /** Why-it-did-what-it-did counters + samples, for debugging the run. */
+    diagnostics?: {[key: string]: unknown},
 }