placementt-core 1.400.1144 → 1.400.1145

package/lib/activities.d.ts

@@ -13,3 +13,12 @@ export declare function resolveActivities(activities: {
 }, overrides?: InstituteData["activityOverrides"]): {
     [id: string]: ExternalActivity;
 };
+/** Ids of the careers hubs an institute has an approved link with. */
+export declare function approvedCareersHubIds(institute?: Pick<InstituteData, "careersHubLinks">): string[];
+/**
+ * The activityOverrides that apply when `institute` views activities. A hub uses its own.
+ * A school linked to careers hubs inherits each approved hub's overrides, so its staff,
+ * employers and alumni see the hub's wording and not the global one; anything the school
+ * sets itself wins. Pass the hubs named by approvedCareersHubIds(institute).
+ */
+export declare function combineActivityOverrides(institute?: Pick<InstituteData, "activityOverrides">, hubs?: (Pick<InstituteData, "activityOverrides"> | undefined)[]): InstituteData["activityOverrides"];

package/lib/activities.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveActivities = resolveActivities;
+exports.approvedCareersHubIds = approvedCareersHubIds;
+exports.combineActivityOverrides = combineActivityOverrides;
 /**
  * Applies a hub's activityOverrides to a set of public activities. Every read path
  * (frontend and backend) must pass fetched externalActivities through this before
@@ -26,4 +28,23 @@ function resolveActivities(activities, overrides) {
             }];
     }));
 }
+/** Ids of the careers hubs an institute has an approved link with. */
+function approvedCareersHubIds(institute) {
+    return Object.entries(institute?.careersHubLinks || {})
+        .filter(([, link]) => link.status === "approved")
+        .map(([hubId]) => hubId);
+}
+/**
+ * The activityOverrides that apply when `institute` views activities. A hub uses its own.
+ * A school linked to careers hubs inherits each approved hub's overrides, so its staff,
+ * employers and alumni see the hub's wording and not the global one; anything the school
+ * sets itself wins. Pass the hubs named by approvedCareersHubIds(institute).
+ */
+function combineActivityOverrides(institute, hubs = []) {
+    const combined = {};
+    [...hubs.map((hub) => hub?.activityOverrides), institute?.activityOverrides].forEach((overrides) => Object.entries(overrides || {}).forEach(([id, override]) => {
+        combined[id] = { ...combined[id], ...override };
+    }));
+    return Object.keys(combined).length ? combined : undefined;
+}
 //# sourceMappingURL=activities.js.map

package/lib/activities.js.map

@@ -1 +1 @@
-{"version":3,"file":"activities.js","sourceRoot":"","sources":["../src/activities.ts"],"names":[],"mappings":";;AAWA,8CAgBC;AAzBD;;;;;;;;GAQG;AACH,SAAgB,iBAAiB,CAC7B,UAA4C,EAC5C,SAA8C;IAE9C,IAAI,CAAC,SAAS;QAAE,OAAO,UAAU,CAAC;IAClC,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE;QACxE,MAAM,QAAQ,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;QAC/B,IAAI,CAAC,QAAQ;YAAE,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACrC,OAAO,CAAC,EAAE,EAAE;gBACR,GAAG,QAAQ;gBACX,GAAG,CAAC,QAAQ,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChE,GAAG,CAAC,QAAQ,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAC,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClF,GAAG,CAAC,QAAQ,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,KAAK;aACvC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC,CAAC;AACR,CAAC"}
+{"version":3,"file":"activities.js","sourceRoot":"","sources":["../src/activities.ts"],"names":[],"mappings":";;AAWA,8CAgBC;AAGD,sDAIC;AAQD,4DAUC;AAlDD;;;;;;;;GAQG;AACH,SAAgB,iBAAiB,CAC7B,UAA4C,EAC5C,SAA8C;IAE9C,IAAI,CAAC,SAAS;QAAE,OAAO,UAAU,CAAC;IAClC,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE;QACxE,MAAM,QAAQ,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;QAC/B,IAAI,CAAC,QAAQ;YAAE,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACrC,OAAO,CAAC,EAAE,EAAE;gBACR,GAAG,QAAQ;gBACX,GAAG,CAAC,QAAQ,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChE,GAAG,CAAC,QAAQ,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAC,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClF,GAAG,CAAC,QAAQ,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,KAAK;aACvC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC,CAAC;AACR,CAAC;AAED,sEAAsE;AACtE,SAAgB,qBAAqB,CAAC,SAAkD;IACpF,OAAO,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,eAAe,IAAI,EAAE,CAAC;SAClD,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC;SAChD,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,wBAAwB,CACpC,SAAoD,EACpD,OAA+D,EAAE;IAEjE,MAAM,QAAQ,GAAoD,EAAE,CAAC;IACrE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,iBAAiB,CAAC,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,CAC/F,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE;QACvD,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,EAAE,GAAG,QAAQ,EAAC,CAAC;IAClD,CAAC,CAAC,CAAC,CAAC;IACR,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/D,CAAC"}

package/lib/activities.test.d.ts

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

package/lib/activities.test.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const activities_1 = require("./activities");
+const link = (status) => ({ exists: true, invited: "2026-09-01", status });
+describe("approvedCareersHubIds", () => {
+    it("returns only hubs the school has an approved link with", () => {
+        expect((0, activities_1.approvedCareersHubIds)({ careersHubLinks: {
+                solent: link("approved"),
+                surrey: link("invited"),
+                sutherland: link("declined"),
+            } })).toEqual(["solent"]);
+    });
+    it("returns nothing for an institute with no links", () => {
+        expect((0, activities_1.approvedCareersHubIds)({})).toEqual([]);
+        expect((0, activities_1.approvedCareersHubIds)(undefined)).toEqual([]);
+    });
+});
+describe("combineActivityOverrides", () => {
+    it("gives a hub its own overrides", () => {
+        expect((0, activities_1.combineActivityOverrides)({ activityOverrides: { a: { title: "Networking Activity" } } }))
+            .toEqual({ a: { title: "Networking Activity" } });
+    });
+    it("gives a linked school its hub's overrides", () => {
+        expect((0, activities_1.combineActivityOverrides)({}, [{ activityOverrides: { a: { title: "Employer Workshop", disabled: false }, b: { disabled: true } } }]))
+            .toEqual({ a: { title: "Employer Workshop", disabled: false }, b: { disabled: true } });
+    });
+    it("lets the school's own override win, field by field", () => {
+        expect((0, activities_1.combineActivityOverrides)({ activityOverrides: { a: { description: "School wording" } } }, [{ activityOverrides: { a: { title: "Hub title", description: "Hub wording" } } }])).toEqual({ a: { title: "Hub title", description: "School wording" } });
+    });
+    it("returns undefined when nothing is overridden", () => {
+        expect((0, activities_1.combineActivityOverrides)({}, [undefined, {}])).toBeUndefined();
+    });
+    it("feeds resolveActivities so a school sees the hub's rename and disable", () => {
+        const activities = {
+            a: { title: "CV/Personal Statements", description: "", color: "#000", activityType: "other" },
+            b: { title: "Short Placement", description: "", color: "#000", activityType: "workExperience" },
+        };
+        const resolved = (0, activities_1.resolveActivities)(activities, (0, activities_1.combineActivityOverrides)({}, [{ activityOverrides: {
+                    a: { title: "Employer Workshop" },
+                    b: { disabled: true },
+                } }]));
+        expect(resolved.a.title).toBe("Employer Workshop");
+        expect(resolved.b.disabled).toBe(true);
+    });
+});
+//# sourceMappingURL=activities.test.js.map

package/lib/activities.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activities.test.js","sourceRoot":"","sources":["../src/activities.test.ts"],"names":[],"mappings":";;AAAA,6CAAgG;AAGhG,MAAM,IAAI,GAAG,CAAC,MAAuC,EAAE,EAAE,CAAC,CAAC,EAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAC,CAAC,CAAC;AAE1G,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAC9D,MAAM,CAAC,IAAA,kCAAqB,EAAC,EAAC,eAAe,EAAE;gBAC3C,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC;gBACxB,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC;gBACvB,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC;aAC/B,EAA2C,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,IAAA,kCAAqB,EAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC9C,MAAM,CAAC,IAAA,kCAAqB,EAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,IAAA,qCAAwB,EAAC,EAAC,iBAAiB,EAAE,EAAC,CAAC,EAAE,EAAC,KAAK,EAAE,qBAAqB,EAAC,EAAC,EAAC,CAAC,CAAC;aACrF,OAAO,CAAC,EAAC,CAAC,EAAE,EAAC,KAAK,EAAE,qBAAqB,EAAC,EAAC,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,IAAA,qCAAwB,EAAC,EAAE,EAAE,CAAC,EAAC,iBAAiB,EAAE,EAAC,CAAC,EAAE,EAAC,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,KAAK,EAAC,EAAE,CAAC,EAAE,EAAC,QAAQ,EAAE,IAAI,EAAC,EAAC,EAAC,CAAC,CAAC,CAAC;aAC/H,OAAO,CAAC,EAAC,CAAC,EAAE,EAAC,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,KAAK,EAAC,EAAE,CAAC,EAAE,EAAC,QAAQ,EAAE,IAAI,EAAC,EAAC,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,IAAA,qCAAwB,EAC3B,EAAC,iBAAiB,EAAE,EAAC,CAAC,EAAE,EAAC,WAAW,EAAE,gBAAgB,EAAC,EAAC,EAAC,EACzD,CAAC,EAAC,iBAAiB,EAAE,EAAC,CAAC,EAAE,EAAC,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAC,EAAC,EAAC,CAAC,CAC/E,CAAC,CAAC,OAAO,CAAC,EAAC,CAAC,EAAE,EAAC,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAC,EAAC,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,IAAA,qCAAwB,EAAC,EAAE,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC7E,MAAM,UAAU,GAAqC;YACjD,CAAC,EAAE,EAAC,KAAK,EAAE,wBAAwB,EAAE,WAAW,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAC;YAC3F,CAAC,EAAE,EAAC,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAC;SAChG,CAAC;QACF,MAAM,QAAQ,GAAG,IAAA,8BAAiB,EAAC,UAAU,EAAE,IAAA,qCAAwB,EAAC,EAAE,EAAE,CAAC,EAAC,iBAAiB,EAAE;oBAC7F,CAAC,EAAE,EAAC,KAAK,EAAE,mBAAmB,EAAC;oBAC/B,CAAC,EAAE,EAAC,QAAQ,EAAE,IAAI,EAAC;iBACtB,EAAC,CAAC,CAAC,CAAC,CAAC;QACN,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACnD,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/package.json

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

package/src/activities.test.ts

@@ -0,0 +1,55 @@
+import {approvedCareersHubIds, combineActivityOverrides, resolveActivities} from "./activities";
+import {ExternalActivity, InstituteData} from "./typeDefinitions";
+
+const link = (status: "invited"|"approved"|"declined") => ({exists: true, invited: "2026-09-01", status});
+
+describe("approvedCareersHubIds", () => {
+    it("returns only hubs the school has an approved link with", () => {
+        expect(approvedCareersHubIds({careersHubLinks: {
+            solent: link("approved"),
+            surrey: link("invited"),
+            sutherland: link("declined"),
+        }} as Pick<InstituteData, "careersHubLinks">)).toEqual(["solent"]);
+    });
+
+    it("returns nothing for an institute with no links", () => {
+        expect(approvedCareersHubIds({})).toEqual([]);
+        expect(approvedCareersHubIds(undefined)).toEqual([]);
+    });
+});
+
+describe("combineActivityOverrides", () => {
+    it("gives a hub its own overrides", () => {
+        expect(combineActivityOverrides({activityOverrides: {a: {title: "Networking Activity"}}}))
+            .toEqual({a: {title: "Networking Activity"}});
+    });
+
+    it("gives a linked school its hub's overrides", () => {
+        expect(combineActivityOverrides({}, [{activityOverrides: {a: {title: "Employer Workshop", disabled: false}, b: {disabled: true}}}]))
+            .toEqual({a: {title: "Employer Workshop", disabled: false}, b: {disabled: true}});
+    });
+
+    it("lets the school's own override win, field by field", () => {
+        expect(combineActivityOverrides(
+            {activityOverrides: {a: {description: "School wording"}}},
+            [{activityOverrides: {a: {title: "Hub title", description: "Hub wording"}}}],
+        )).toEqual({a: {title: "Hub title", description: "School wording"}});
+    });
+
+    it("returns undefined when nothing is overridden", () => {
+        expect(combineActivityOverrides({}, [undefined, {}])).toBeUndefined();
+    });
+
+    it("feeds resolveActivities so a school sees the hub's rename and disable", () => {
+        const activities: {[id: string]: ExternalActivity} = {
+            a: {title: "CV/Personal Statements", description: "", color: "#000", activityType: "other"},
+            b: {title: "Short Placement", description: "", color: "#000", activityType: "workExperience"},
+        };
+        const resolved = resolveActivities(activities, combineActivityOverrides({}, [{activityOverrides: {
+            a: {title: "Employer Workshop"},
+            b: {disabled: true},
+        }}]));
+        expect(resolved.a.title).toBe("Employer Workshop");
+        expect(resolved.b.disabled).toBe(true);
+    });
+});

package/src/activities.ts

@@ -26,3 +26,28 @@ export function resolveActivities(
         }];
     }));
 }
+
+/** Ids of the careers hubs an institute has an approved link with. */
+export function approvedCareersHubIds(institute?: Pick<InstituteData, "careersHubLinks">): string[] {
+    return Object.entries(institute?.careersHubLinks || {})
+        .filter(([, link]) => link.status === "approved")
+        .map(([hubId]) => hubId);
+}
+
+/**
+ * The activityOverrides that apply when `institute` views activities. A hub uses its own.
+ * A school linked to careers hubs inherits each approved hub's overrides, so its staff,
+ * employers and alumni see the hub's wording and not the global one; anything the school
+ * sets itself wins. Pass the hubs named by approvedCareersHubIds(institute).
+ */
+export function combineActivityOverrides(
+    institute?: Pick<InstituteData, "activityOverrides">,
+    hubs: (Pick<InstituteData, "activityOverrides">|undefined)[] = [],
+): InstituteData["activityOverrides"] {
+    const combined: NonNullable<InstituteData["activityOverrides"]> = {};
+    [...hubs.map((hub) => hub?.activityOverrides), institute?.activityOverrides].forEach((overrides) =>
+        Object.entries(overrides || {}).forEach(([id, override]) => {
+            combined[id] = {...combined[id], ...override};
+        }));
+    return Object.keys(combined).length ? combined : undefined;
+}