placementt-core 1.400.1118 → 1.400.1120

package/lib/callables/he.d.ts

@@ -1,4 +1,18 @@
 import { z } from "zod";
+/**
+ * Contracts for the `he` backend module
+ * (`Placementt-Backend/functions/src/heImport.ts`).
+ *
+ * Admin-only controls for the weekly mirror of the HESA Discover Uni dataset
+ * into `heCourses` / `heProviders`. The status document (`heMeta/status`) is
+ * the source of truth the admin card reads live, so the responses only echo
+ * enough to confirm the call landed - an import can outlive the client's
+ * callable deadline and the card still resolves.
+ */
+/** Every enrichment source, in the order the admin card lists them. The
+ * orchestrator runs "areas" first (the city sources key on its output) and
+ * "finalise" last. */
+export declare const HE_ENRICHMENT_SOURCES: readonly ["areas", "hesaSsr", "hesaFinance", "hesaStudents", "wideningParticipation", "openAlex", "rent", "crime", "localJobs", "weather", "amenities", "population", "finalise"];
 export declare const heCallables: {
     /** Run a full import now. `storagePath` names a zip already uploaded to
      * Cloud Storage (`heImports/<file>.zip`) to use instead of the URL in
@@ -79,6 +93,33 @@ export declare const heCallables: {
             };
         }>;
     };
+    /**
+     * Run the university enrichment: one status entry per source in
+     * `heMeta/enrichmentStatus`, one Cloud Task per source, then a finalise
+     * task that computes provider / area percentiles and reapplies course
+     * percentiles. `sources` limits the run to those sources (a retry of the
+     * ones that failed); omitted, every source runs. Returns as soon as the
+     * tasks are queued; the admin card follows the status document.
+     */
+    "he-runEnrichment": {
+        request: z.ZodObject<{
+            sources: z.ZodOptional<z.ZodArray<z.ZodEnum<["areas", "hesaSsr", "hesaFinance", "hesaStudents", "wideningParticipation", "openAlex", "rent", "crime", "localJobs", "weather", "amenities", "population", "finalise"]>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            sources?: ("areas" | "hesaSsr" | "hesaFinance" | "hesaStudents" | "wideningParticipation" | "openAlex" | "rent" | "crime" | "localJobs" | "weather" | "amenities" | "population" | "finalise")[] | undefined;
+        }, {
+            sources?: ("areas" | "hesaSsr" | "hesaFinance" | "hesaStudents" | "wideningParticipation" | "openAlex" | "rent" | "crime" | "localJobs" | "weather" | "amenities" | "population" | "finalise")[] | undefined;
+        }>;
+        response: z.ZodObject<{
+            runId: z.ZodString;
+            queued: z.ZodArray<z.ZodEnum<["areas", "hesaSsr", "hesaFinance", "hesaStudents", "wideningParticipation", "openAlex", "rent", "crime", "localJobs", "weather", "amenities", "population", "finalise"]>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            runId: string;
+            queued: ("areas" | "hesaSsr" | "hesaFinance" | "hesaStudents" | "wideningParticipation" | "openAlex" | "rent" | "crime" | "localJobs" | "weather" | "amenities" | "population" | "finalise")[];
+        }, {
+            runId: string;
+            queued: ("areas" | "hesaSsr" | "hesaFinance" | "hesaStudents" | "wideningParticipation" | "openAlex" | "rent" | "crime" | "localJobs" | "weather" | "amenities" | "population" | "finalise")[];
+        }>;
+    };
     /** Clear a stuck "running" state. The mirror and its manifest are left
      * alone. */
     "he-resetRun": {

package/lib/callables/he.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.heCallables = void 0;
+exports.heCallables = exports.HE_ENRICHMENT_SOURCES = void 0;
 const zod_1 = require("zod");
 /**
  * Contracts for the `he` backend module
@@ -12,6 +12,11 @@ const zod_1 = require("zod");
  * enough to confirm the call landed - an import can outlive the client's
  * callable deadline and the card still resolves.
  */
+/** Every enrichment source, in the order the admin card lists them. The
+ * orchestrator runs "areas" first (the city sources key on its output) and
+ * "finalise" last. */
+exports.HE_ENRICHMENT_SOURCES = ["areas", "hesaSsr", "hesaFinance", "hesaStudents", "wideningParticipation",
+    "openAlex", "rent", "crime", "localJobs", "weather", "amenities", "population", "finalise"];
 const importCounts = zod_1.z.object({
     coursesAssembled: zod_1.z.number(),
     coursesWritten: zod_1.z.number(),
@@ -39,6 +44,23 @@ exports.heCallables = {
             counts: importCounts,
         }),
     },
+    /**
+     * Run the university enrichment: one status entry per source in
+     * `heMeta/enrichmentStatus`, one Cloud Task per source, then a finalise
+     * task that computes provider / area percentiles and reapplies course
+     * percentiles. `sources` limits the run to those sources (a retry of the
+     * ones that failed); omitted, every source runs. Returns as soon as the
+     * tasks are queued; the admin card follows the status document.
+     */
+    "he-runEnrichment": {
+        request: zod_1.z.object({
+            sources: zod_1.z.array(zod_1.z.enum(exports.HE_ENRICHMENT_SOURCES)).optional(),
+        }),
+        response: zod_1.z.object({
+            runId: zod_1.z.string(),
+            queued: zod_1.z.array(zod_1.z.enum(exports.HE_ENRICHMENT_SOURCES)),
+        }),
+    },
     /** Clear a stuck "running" state. The mirror and its manifest are left
      * alone. */
     "he-resetRun": {

package/lib/callables/he.js.map

@@ -1 +1 @@
-{"version":3,"file":"he.js","sourceRoot":"","sources":["../../src/callables/he.ts"],"names":[],"mappings":";;;AAAA,6BAAsB;AAGtB;;;;;;;;;GASG;AAEH,MAAM,YAAY,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1B,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE;IAC5B,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE;IAC1B,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE;IAC5B,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE;IAC1B,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE;IAC5B,kBAAkB,EAAE,OAAC,CAAC,MAAM,EAAE;CACjC,CAAC,CAAC;AAEU,QAAA,WAAW,GAAG;IACvB;;;4BAGwB;IACxB,cAAc,EAAE;QACZ,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC;YACd,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACrC,CAAC;QACF,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;YACjB,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE;YAC1B,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;gBACb,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;gBAChC,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;aAClB,CAAC;YACF,MAAM,EAAE,YAAY;SACvB,CAAC;KACL;IACD;gBACY;IACZ,aAAa,EAAE;QACX,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACrB,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,EAAE,EAAE,OAAC,CAAC,OAAO,CAAC,IAAI,CAAC;SACtB,CAAC;KACL;CACoB,CAAC"}
+{"version":3,"file":"he.js","sourceRoot":"","sources":["../../src/callables/he.ts"],"names":[],"mappings":";;;AAAA,6BAAsB;AAGtB;;;;;;;;;GASG;AAEH;;sBAEsB;AACT,QAAA,qBAAqB,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,uBAAuB;IAC5G,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,CAAU,CAAC;AAEzG,MAAM,YAAY,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1B,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE;IAC5B,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE;IAC1B,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE;IAC5B,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE;IAC1B,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE;IAC5B,kBAAkB,EAAE,OAAC,CAAC,MAAM,EAAE;CACjC,CAAC,CAAC;AAEU,QAAA,WAAW,GAAG;IACvB;;;4BAGwB;IACxB,cAAc,EAAE;QACZ,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC;YACd,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACrC,CAAC;QACF,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;YACjB,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE;YAC1B,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;gBACb,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;gBAChC,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;aAClB,CAAC;YACF,MAAM,EAAE,YAAY;SACvB,CAAC;KACL;IACD;;;;;;;OAOG;IACH,kBAAkB,EAAE;QAChB,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC;YACd,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,6BAAqB,CAAC,CAAC,CAAC,QAAQ,EAAE;SAC7D,CAAC;QACF,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;YACjB,MAAM,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,6BAAqB,CAAC,CAAC;SACjD,CAAC;KACL;IACD;gBACY;IACZ,aAAa,EAAE;QACX,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACrB,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,EAAE,EAAE,OAAC,CAAC,OAAO,CAAC,IAAI,CAAC;SACtB,CAAC;KACL;CACoB,CAAC"}

package/lib/callables/registry.d.ts

@@ -618,6 +618,25 @@ export declare const allCallables: {
             };
         }>;
     };
+    "he-runEnrichment": {
+        request: z.ZodObject<{
+            sources: z.ZodOptional<z.ZodArray<z.ZodEnum<["areas", "hesaSsr", "hesaFinance", "hesaStudents", "wideningParticipation", "openAlex", "rent", "crime", "localJobs", "weather", "amenities", "population", "finalise"]>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            sources?: ("areas" | "hesaSsr" | "hesaFinance" | "hesaStudents" | "wideningParticipation" | "openAlex" | "rent" | "crime" | "localJobs" | "weather" | "amenities" | "population" | "finalise")[] | undefined;
+        }, {
+            sources?: ("areas" | "hesaSsr" | "hesaFinance" | "hesaStudents" | "wideningParticipation" | "openAlex" | "rent" | "crime" | "localJobs" | "weather" | "amenities" | "population" | "finalise")[] | undefined;
+        }>;
+        response: z.ZodObject<{
+            runId: z.ZodString;
+            queued: z.ZodArray<z.ZodEnum<["areas", "hesaSsr", "hesaFinance", "hesaStudents", "wideningParticipation", "openAlex", "rent", "crime", "localJobs", "weather", "amenities", "population", "finalise"]>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            runId: string;
+            queued: ("areas" | "hesaSsr" | "hesaFinance" | "hesaStudents" | "wideningParticipation" | "openAlex" | "rent" | "crime" | "localJobs" | "weather" | "amenities" | "population" | "finalise")[];
+        }, {
+            runId: string;
+            queued: ("areas" | "hesaSsr" | "hesaFinance" | "hesaStudents" | "wideningParticipation" | "openAlex" | "rent" | "crime" | "localJobs" | "weather" | "amenities" | "population" | "finalise")[];
+        }>;
+    };
     "he-resetRun": {
         request: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
         response: z.ZodObject<{
@@ -2354,6 +2373,25 @@ export declare const callableGroups: {
                 };
             }>;
         };
+        "he-runEnrichment": {
+            request: z.ZodObject<{
+                sources: z.ZodOptional<z.ZodArray<z.ZodEnum<["areas", "hesaSsr", "hesaFinance", "hesaStudents", "wideningParticipation", "openAlex", "rent", "crime", "localJobs", "weather", "amenities", "population", "finalise"]>, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                sources?: ("areas" | "hesaSsr" | "hesaFinance" | "hesaStudents" | "wideningParticipation" | "openAlex" | "rent" | "crime" | "localJobs" | "weather" | "amenities" | "population" | "finalise")[] | undefined;
+            }, {
+                sources?: ("areas" | "hesaSsr" | "hesaFinance" | "hesaStudents" | "wideningParticipation" | "openAlex" | "rent" | "crime" | "localJobs" | "weather" | "amenities" | "population" | "finalise")[] | undefined;
+            }>;
+            response: z.ZodObject<{
+                runId: z.ZodString;
+                queued: z.ZodArray<z.ZodEnum<["areas", "hesaSsr", "hesaFinance", "hesaStudents", "wideningParticipation", "openAlex", "rent", "crime", "localJobs", "weather", "amenities", "population", "finalise"]>, "many">;
+            }, "strip", z.ZodTypeAny, {
+                runId: string;
+                queued: ("areas" | "hesaSsr" | "hesaFinance" | "hesaStudents" | "wideningParticipation" | "openAlex" | "rent" | "crime" | "localJobs" | "weather" | "amenities" | "population" | "finalise")[];
+            }, {
+                runId: string;
+                queued: ("areas" | "hesaSsr" | "hesaFinance" | "hesaStudents" | "wideningParticipation" | "openAlex" | "rent" | "crime" | "localJobs" | "weather" | "amenities" | "population" | "finalise")[];
+            }>;
+        };
         "he-resetRun": {
             request: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
             response: z.ZodObject<{

package/lib/heMappings.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Lookup tables joining Discover Uni courses to the other HE sources.
+ *
+ * A course carries CAH subject codes (Common Aggregation Hierarchy, e.g.
+ * "CAH10-01-02"). The HESA finance and staff tables are published by cost
+ * centre instead, so each CAH code is mapped to the cost centre that teaches
+ * it, most specific match first: a level-3 code, then its level-2 parent
+ * ("CAH10-01"), then its level-1 parent ("CAH10").
+ *
+ * The CAH -> cost centre table follows HESA's own CAH/cost-centre guidance at
+ * the grain a student would recognise. It is deliberately coarse: a cost
+ * centre is a budget line, not a course, so any mapping is an approximation
+ * and every surface says the figure is for the subject area at that
+ * university.
+ */
+/** HESA cost centres (2019/20 onward) by code. */
+export declare const HESA_COST_CENTRES: {
+    [code: string]: string;
+};
+/**
+ * CAH code (level 1, 2 or 3) -> HESA cost centre. Looked up most specific
+ * first by `costCentreForCah`. CAH23 (combined and general studies) has no
+ * cost centre, so courses under it carry no subject stats.
+ */
+export declare const CAH_TO_COST_CENTRE: {
+    [cah: string]: string;
+};
+/**
+ * The CAH level-1, level-2 and level-3 codes of a subject, most specific
+ * first. A malformed code yields just itself.
+ *
+ * @param {string} cah a CAH code at any level, e.g. "CAH10-01-02".
+ * @return {string[]} e.g. ["CAH10-01-02", "CAH10-01", "CAH10"].
+ */
+export declare function cahAncestors(cah: string): string[];
+/**
+ * The HESA cost centre a CAH subject is taught under, most specific mapping
+ * first.
+ *
+ * @param {string|undefined} cah a CAH code at any level.
+ * @return {string|undefined} the cost centre code, or undefined when none
+ * applies (combined studies, or an unknown code).
+ */
+export declare function costCentreForCah(cah: string | undefined): string | undefined;
+/**
+ * BRES broad industrial groups, as Nomis labels them, keyed by a stable id.
+ * The ids are what `HeArea.jobsBySector` and the `jobs_<id>` percentile keys
+ * use.
+ */
+export declare const BRES_SECTORS: {
+    [id: string]: string;
+};
+/**
+ * Resolve a Nomis BRES industry label to its sector id. Nomis prefixes the
+ * labels with a number and suffixes the SIC section letters ("8 : Transport
+ * & storage (inc postal) (H)"), and the edition may swap "&" for "and", so
+ * the match ignores all three. Only a trailing group of section letters is
+ * dropped, so "(inc postal)" still counts.
+ *
+ * @param {string} label the label as it appears in the CSV.
+ * @return {string|undefined} the sector id, or undefined.
+ */
+export declare function bresSectorForLabel(label: string): string | undefined;
+/**
+ * Careers library category -> the BRES sectors its jobs mostly sit in, so
+ * "jobs in the sector you're interested in near this university" can be
+ * scored from the student's interests.
+ */
+export declare const CAREER_CATEGORY_SECTORS: {
+    [category: string]: string[];
+};
+/**
+ * The BRES sectors for a set of career interest categories, de-duplicated in
+ * the order the categories were given.
+ *
+ * @param {string[]} categories careers library categories.
+ * @return {string[]} sector ids.
+ */
+export declare function sectorsForCategories(categories: string[]): string[];

package/lib/heMappings.js

@@ -0,0 +1,268 @@
+"use strict";
+/**
+ * Lookup tables joining Discover Uni courses to the other HE sources.
+ *
+ * A course carries CAH subject codes (Common Aggregation Hierarchy, e.g.
+ * "CAH10-01-02"). The HESA finance and staff tables are published by cost
+ * centre instead, so each CAH code is mapped to the cost centre that teaches
+ * it, most specific match first: a level-3 code, then its level-2 parent
+ * ("CAH10-01"), then its level-1 parent ("CAH10").
+ *
+ * The CAH -> cost centre table follows HESA's own CAH/cost-centre guidance at
+ * the grain a student would recognise. It is deliberately coarse: a cost
+ * centre is a budget line, not a course, so any mapping is an approximation
+ * and every surface says the figure is for the subject area at that
+ * university.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CAREER_CATEGORY_SECTORS = exports.BRES_SECTORS = exports.CAH_TO_COST_CENTRE = exports.HESA_COST_CENTRES = void 0;
+exports.cahAncestors = cahAncestors;
+exports.costCentreForCah = costCentreForCah;
+exports.bresSectorForLabel = bresSectorForLabel;
+exports.sectorsForCategories = sectorsForCategories;
+/** HESA cost centres (2019/20 onward) by code. */
+exports.HESA_COST_CENTRES = {
+    "101": "Clinical medicine",
+    "102": "Clinical dentistry",
+    "103": "Nursing and allied health professions",
+    "104": "Psychology and behavioural sciences",
+    "105": "Health and community studies",
+    "106": "Anatomy and physiology",
+    "107": "Pharmacy and pharmacology",
+    "108": "Sports science and leisure studies",
+    "109": "Veterinary science",
+    "110": "Agriculture, forestry and food science",
+    "111": "Earth, marine and environmental sciences",
+    "112": "Biosciences",
+    "113": "Chemistry",
+    "114": "Physics",
+    "115": "General engineering",
+    "116": "Chemical engineering",
+    "117": "Mineral, metallurgy and materials engineering",
+    "118": "Civil engineering",
+    "119": "Electrical, electronic and computer engineering",
+    "120": "Mechanical, aero and production engineering",
+    "121": "IT, systems sciences and computer software engineering",
+    "122": "Mathematics",
+    "123": "Architecture, built environment and planning",
+    "124": "Geography and environmental studies",
+    "125": "Area studies",
+    "126": "Archaeology",
+    "127": "Anthropology and development studies",
+    "128": "Politics and international studies",
+    "129": "Economics and econometrics",
+    "130": "Law",
+    "131": "Social work and social policy",
+    "132": "Sociology",
+    "133": "Business and management studies",
+    "134": "Catering and hospitality management",
+    "135": "Education",
+    "136": "Continuing education",
+    "137": "Modern languages",
+    "138": "English language and literature",
+    "139": "History",
+    "140": "Classics",
+    "141": "Philosophy",
+    "142": "Theology and religious studies",
+    "143": "Art and design",
+    "144": "Music, dance, drama and performing arts",
+    "145": "Media studies",
+};
+/**
+ * CAH code (level 1, 2 or 3) -> HESA cost centre. Looked up most specific
+ * first by `costCentreForCah`. CAH23 (combined and general studies) has no
+ * cost centre, so courses under it carry no subject stats.
+ */
+exports.CAH_TO_COST_CENTRE = {
+    // Medicine and dentistry
+    "CAH01": "101",
+    "CAH01-01-04": "102",
+    // Subjects allied to medicine
+    "CAH02": "103",
+    "CAH02-01": "107",
+    "CAH02-02": "106",
+    // Biological and sport sciences
+    "CAH03": "112",
+    "CAH03-02": "108",
+    // Psychology
+    "CAH04": "104",
+    // Veterinary sciences
+    "CAH05": "109",
+    // Agriculture, food and related studies
+    "CAH06": "110",
+    // Physical sciences
+    "CAH07": "114",
+    "CAH07-01": "114",
+    "CAH07-02": "113",
+    // Mathematical sciences
+    "CAH09": "122",
+    // Engineering and technology
+    "CAH10": "115",
+    "CAH10-01-01": "115",
+    "CAH10-01-02": "120",
+    "CAH10-01-03": "120",
+    "CAH10-01-04": "120",
+    "CAH10-01-05": "120",
+    "CAH10-01-06": "115",
+    "CAH10-01-07": "118",
+    "CAH10-01-08": "119",
+    "CAH10-01-09": "116",
+    "CAH10-03": "117",
+    // Computing
+    "CAH11": "121",
+    // Architecture, building and planning
+    "CAH13": "123",
+    // Social sciences
+    "CAH15": "132",
+    "CAH15-01": "132",
+    "CAH15-02": "129",
+    "CAH15-03": "128",
+    "CAH15-04": "131",
+    // Law
+    "CAH16": "130",
+    // Business and management
+    "CAH17": "133",
+    // Language and area studies
+    "CAH19": "137",
+    "CAH19-01": "138",
+    // Historical, philosophical and religious studies
+    "CAH20": "139",
+    "CAH20-01": "139",
+    "CAH20-02": "141",
+    // Education and teaching
+    "CAH22": "135",
+    // Media, journalism and communications
+    "CAH24": "145",
+    // Design, and creative and performing arts
+    "CAH25": "143",
+    "CAH25-01": "143",
+    "CAH25-02": "144",
+    // Geography, earth and environmental studies
+    "CAH26": "124",
+};
+/**
+ * The CAH level-1, level-2 and level-3 codes of a subject, most specific
+ * first. A malformed code yields just itself.
+ *
+ * @param {string} cah a CAH code at any level, e.g. "CAH10-01-02".
+ * @return {string[]} e.g. ["CAH10-01-02", "CAH10-01", "CAH10"].
+ */
+function cahAncestors(cah) {
+    const code = (cah || "").trim().toUpperCase();
+    const m = /^(CAH\d{2})(?:-(\d{2}))?(?:-(\d{2}))?$/.exec(code);
+    if (!m)
+        return code ? [code] : [];
+    const out = [];
+    if (m[3])
+        out.push(`${m[1]}-${m[2]}-${m[3]}`);
+    if (m[2])
+        out.push(`${m[1]}-${m[2]}`);
+    out.push(m[1]);
+    return out;
+}
+/**
+ * The HESA cost centre a CAH subject is taught under, most specific mapping
+ * first.
+ *
+ * @param {string|undefined} cah a CAH code at any level.
+ * @return {string|undefined} the cost centre code, or undefined when none
+ * applies (combined studies, or an unknown code).
+ */
+function costCentreForCah(cah) {
+    if (!cah)
+        return undefined;
+    for (const code of cahAncestors(cah)) {
+        const cc = exports.CAH_TO_COST_CENTRE[code];
+        if (cc)
+            return cc;
+    }
+    return undefined;
+}
+/**
+ * BRES broad industrial groups, as Nomis labels them, keyed by a stable id.
+ * The ids are what `HeArea.jobsBySector` and the `jobs_<id>` percentile keys
+ * use.
+ */
+exports.BRES_SECTORS = {
+    agriculture: "Agriculture, forestry & fishing",
+    utilities: "Mining, quarrying & utilities",
+    manufacturing: "Manufacturing",
+    construction: "Construction",
+    motor: "Motor trades",
+    wholesale: "Wholesale",
+    retail: "Retail",
+    transport: "Transport & storage (inc postal)",
+    hospitality: "Accommodation & food services",
+    ict: "Information & communication",
+    finance: "Financial & insurance",
+    property: "Property",
+    professional: "Professional, scientific & technical",
+    business: "Business administration & support services",
+    publicAdmin: "Public administration & defence",
+    education: "Education",
+    health: "Health",
+    arts: "Arts, entertainment, recreation & other services",
+};
+/**
+ * Resolve a Nomis BRES industry label to its sector id. Nomis prefixes the
+ * labels with a number and suffixes the SIC section letters ("8 : Transport
+ * & storage (inc postal) (H)"), and the edition may swap "&" for "and", so
+ * the match ignores all three. Only a trailing group of section letters is
+ * dropped, so "(inc postal)" still counts.
+ *
+ * @param {string} label the label as it appears in the CSV.
+ * @return {string|undefined} the sector id, or undefined.
+ */
+function bresSectorForLabel(label) {
+    const norm = (s) => s.toLowerCase()
+        .replace(/^\s*\d+\s*:\s*/, "")
+        .replace(/\((part\s+)?[a-u](\s*(,|and|-)\s*[a-u])*\)\s*$/i, "")
+        .replace(/\band\b/g, "&")
+        .replace(/[^a-z&]+/g, "");
+    const target = norm(label);
+    if (!target)
+        return undefined;
+    return Object.keys(exports.BRES_SECTORS).find((id) => norm(exports.BRES_SECTORS[id]) === target);
+}
+/**
+ * Careers library category -> the BRES sectors its jobs mostly sit in, so
+ * "jobs in the sector you're interested in near this university" can be
+ * scored from the student's interests.
+ */
+exports.CAREER_CATEGORY_SECTORS = {
+    "Technology & Computing": ["ict"],
+    "Engineering & Manufacturing": ["manufacturing", "utilities"],
+    "Science & Research": ["professional"],
+    "Medicine & Healthcare": ["health"],
+    "Education & Training": ["education"],
+    "Business & Finance": ["finance", "business"],
+    "Law & Public Services": ["publicAdmin", "professional"],
+    "Creative Arts & Design": ["arts", "professional"],
+    "Media & Communications": ["ict", "arts"],
+    "Sport & Leisure": ["arts"],
+    "Hospitality & Tourism": ["hospitality"],
+    "Construction & Property": ["construction", "property"],
+    "Agriculture & Environment": ["agriculture"],
+    "Social Care & Charity": ["health"],
+    "Armed Forces & Emergency Services": ["publicAdmin"],
+    "Retail & Sales": ["retail", "wholesale"],
+    "Transport & Logistics": ["transport", "motor"],
+};
+/**
+ * The BRES sectors for a set of career interest categories, de-duplicated in
+ * the order the categories were given.
+ *
+ * @param {string[]} categories careers library categories.
+ * @return {string[]} sector ids.
+ */
+function sectorsForCategories(categories) {
+    const out = [];
+    for (const c of categories) {
+        for (const s of exports.CAREER_CATEGORY_SECTORS[c] ?? []) {
+            if (!out.includes(s))
+                out.push(s);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=heMappings.js.map

package/lib/heMappings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heMappings.js","sourceRoot":"","sources":["../src/heMappings.ts"],"names":[],"mappings":"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"}

package/lib/heMappings.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/heMappings.test.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const heMappings_1 = require("./heMappings");
+const lmiCategories_1 = require("./lmiCategories");
+describe("cahAncestors", () => {
+    it("lists a level-3 code's parents, most specific first", () => {
+        expect((0, heMappings_1.cahAncestors)("CAH10-01-02")).toEqual(["CAH10-01-02", "CAH10-01", "CAH10"]);
+    });
+    it("handles level-2 and level-1 codes and normalises case", () => {
+        expect((0, heMappings_1.cahAncestors)("cah10-01")).toEqual(["CAH10-01", "CAH10"]);
+        expect((0, heMappings_1.cahAncestors)("CAH11")).toEqual(["CAH11"]);
+    });
+    it("returns a malformed code as itself and nothing for blank", () => {
+        expect((0, heMappings_1.cahAncestors)("X1")).toEqual(["X1"]);
+        expect((0, heMappings_1.cahAncestors)("")).toEqual([]);
+    });
+});
+describe("costCentreForCah", () => {
+    it("prefers the most specific mapping", () => {
+        expect((0, heMappings_1.costCentreForCah)("CAH10-01-07")).toBe("118");
+        expect((0, heMappings_1.costCentreForCah)("CAH10-02-01")).toBe("115");
+        expect((0, heMappings_1.costCentreForCah)("CAH15-02-01")).toBe("129");
+    });
+    it("falls back to the level-1 mapping", () => {
+        expect((0, heMappings_1.costCentreForCah)("CAH11-01-05")).toBe("121");
+    });
+    it("has no cost centre for combined studies or unknown codes", () => {
+        expect((0, heMappings_1.costCentreForCah)("CAH23-01-01")).toBeUndefined();
+        expect((0, heMappings_1.costCentreForCah)(undefined)).toBeUndefined();
+        expect((0, heMappings_1.costCentreForCah)("CAH99")).toBeUndefined();
+    });
+    it("maps only to cost centres that exist", () => {
+        Object.values(heMappings_1.CAH_TO_COST_CENTRE).forEach((cc) => expect(heMappings_1.HESA_COST_CENTRES[cc]).toBeDefined());
+    });
+});
+describe("bresSectorForLabel", () => {
+    it("matches Nomis labels with their numeric prefix and SIC letters", () => {
+        expect((0, heMappings_1.bresSectorForLabel)("10 : Information & communication (J)")).toBe("ict");
+        expect((0, heMappings_1.bresSectorForLabel)("18 : Arts, entertainment, recreation & other services (R,S,T and U)")).toBe("arts");
+        expect((0, heMappings_1.bresSectorForLabel)("Transport & storage (inc postal)")).toBe("transport");
+    });
+    it("maps every broad industrial group label Nomis NM_189_1 served in 2026", () => {
+        const labels = ["1 : Agriculture, forestry & fishing (A)", "2 : Mining, quarrying & utilities (B,D and E)", "3 : Manufacturing (C)",
+            "4 : Construction (F)", "5 : Motor trades (Part G)", "6 : Wholesale (Part G)", "7 : Retail (Part G)",
+            "8 : Transport & storage (inc postal) (H)", "9 : Accommodation & food services (I)", "10 : Information & communication (J)",
+            "11 : Financial & insurance (K)", "12 : Property (L)", "13 : Professional, scientific & technical (M)",
+            "14 : Business administration & support services (N)", "15 : Public administration & defence (O)", "16 : Education (P)",
+            "17 : Health (Q)", "18 : Arts, entertainment, recreation & other services (R,S,T and U)"];
+        expect(new Set(labels.map(heMappings_1.bresSectorForLabel))).toEqual(new Set(Object.keys(heMappings_1.BRES_SECTORS)));
+    });
+    it("treats 'and' like '&'", () => {
+        expect((0, heMappings_1.bresSectorForLabel)("Agriculture, forestry and fishing")).toBe("agriculture");
+    });
+    it("is undefined for anything else", () => {
+        expect((0, heMappings_1.bresSectorForLabel)("Total")).toBeUndefined();
+        expect((0, heMappings_1.bresSectorForLabel)("")).toBeUndefined();
+    });
+});
+describe("career category sectors", () => {
+    it("covers every careers library category with known sectors", () => {
+        lmiCategories_1.CAREER_LIBRARY_CATEGORIES.forEach((c) => {
+            expect(heMappings_1.CAREER_CATEGORY_SECTORS[c]?.length).toBeGreaterThan(0);
+            heMappings_1.CAREER_CATEGORY_SECTORS[c].forEach((s) => expect(heMappings_1.BRES_SECTORS[s]).toBeDefined());
+        });
+    });
+    it("de-duplicates in order", () => {
+        expect((0, heMappings_1.sectorsForCategories)(["Technology & Computing", "Media & Communications"])).toEqual(["ict", "arts"]);
+        expect((0, heMappings_1.sectorsForCategories)(["Unknown"])).toEqual([]);
+    });
+});
+//# sourceMappingURL=heMappings.test.js.map

package/lib/heMappings.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heMappings.test.js","sourceRoot":"","sources":["../src/heMappings.test.ts"],"names":[],"mappings":"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"}