placementt-core 1.400.999 → 1.400.1000

package/lib/index.d.ts

@@ -11,6 +11,7 @@ export * from "./surveys/types";
 export * from "./surveys/registry";
 export * from "./surveys/schedule";
 export * from "./skillsResolver";
+export * from "./productResolver";
 export * from "./emailSections";
 export * from "./exportTransformers";
 export * from "./compassExport";

package/lib/index.js

@@ -31,6 +31,7 @@ __exportStar(require("./surveys/types"), exports);
 __exportStar(require("./surveys/registry"), exports);
 __exportStar(require("./surveys/schedule"), exports);
 __exportStar(require("./skillsResolver"), exports);
+__exportStar(require("./productResolver"), exports);
 __exportStar(require("./emailSections"), exports);
 __exportStar(require("./exportTransformers"), exports);
 __exportStar(require("./compassExport"), exports);

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AACA,sDAAoC;AACpC,gEAA8C;AAC9C,0DAAwC;AACxC,2DAAyC;AACzC,kDAAgC;AAChC,uDAAqC;AACrC,4DAA0C;AAC1C,2DAAyC;AAEzC,oDAAkC;AAClC,kDAAgC;AAChC,qDAAmC;AACnC,qDAAmC;AACnC,mDAAiC;AACjC,kDAAgC;AAChC,uDAAqC;AACrC,kDAAgC;AAChC,2DAAyC;AACzC,uDAAqC;AACrC,iDAA+B;AAC/B,8CAA4B;AAC5B,0CAAwB;AACxB,yCAAuB;AACvB,4DAA0C;AAC1C,kDAAgC;AAChC,iDAA+B;AAC/B,2CAAyB;AACzB,4DAA0C;AAC1C,oEAAiD;AACjD,yEAAuD;AACvD,kEAAgD;AAChD,kEAAgD;AAChD,oEAAkD;AAClD,yGAAuF;AACvF,0GAAwF;AACxF,+FAA6E;AAC7E,4DAA0C;AAC1C,oEAAkD;AAClD,gEAA8C;AAC9C,2EAAyD;AACzD,6CAA2B;AAC3B,+CAA6B;AAC7B,8CAA4B;AAC5B,6DAAuE;AAA9D,2IAAA,OAAO,OAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AACA,sDAAoC;AACpC,gEAA8C;AAC9C,0DAAwC;AACxC,2DAAyC;AACzC,kDAAgC;AAChC,uDAAqC;AACrC,4DAA0C;AAC1C,2DAAyC;AAEzC,oDAAkC;AAClC,kDAAgC;AAChC,qDAAmC;AACnC,qDAAmC;AACnC,mDAAiC;AACjC,oDAAkC;AAClC,kDAAgC;AAChC,uDAAqC;AACrC,kDAAgC;AAChC,2DAAyC;AACzC,uDAAqC;AACrC,iDAA+B;AAC/B,8CAA4B;AAC5B,0CAAwB;AACxB,yCAAuB;AACvB,4DAA0C;AAC1C,kDAAgC;AAChC,iDAA+B;AAC/B,2CAAyB;AACzB,4DAA0C;AAC1C,oEAAiD;AACjD,yEAAuD;AACvD,kEAAgD;AAChD,kEAAgD;AAChD,oEAAkD;AAClD,yGAAuF;AACvF,0GAAwF;AACxF,+FAA6E;AAC7E,4DAA0C;AAC1C,oEAAkD;AAClD,gEAA8C;AAC9C,2EAAyD;AACzD,6CAA2B;AAC3B,+CAA6B;AAC7B,8CAA4B;AAC5B,6DAAuE;AAA9D,2IAAA,OAAO,OAAuB"}

package/lib/productResolver.d.ts

@@ -0,0 +1,53 @@
+import { InstituteData } from "./typeDefinitions";
+/**
+ * Which products an institute actually has.
+ *
+ * The flags on InstituteData are typed `boolean | undefined`, which reads as
+ * "absent means off". Four of them mean the opposite: `network`, `careersEvents`,
+ * `trackExtracurriculars` and `skillsAssessmentsProduct` are tested `!== false`
+ * across the app, so an institute that has never touched the toggle has them ON.
+ * Three of those are also sub-flags that only apply when `employerEvents` (or the
+ * careersHub package) is switched on.
+ *
+ * Every surface used to re-derive those rules by hand, and they had drifted:
+ * the student home rendered skills cards on `skillsAssessmentsProduct !== false`
+ * with no parent check, while UserProfile required the parent — so a student saw
+ * skills on their dashboard that staff could not see on their profile. Wex was
+ * opt-in for staff (`workExperience &&`) and opt-out for students (`!== false`).
+ *
+ * This is the single answer. Nav, home, student surfaces and the backend all read
+ * it, so they cannot disagree about what a customer bought. Dependency-free.
+ */
+/** The product a surface can gate on. */
+export type ProductKey = "wex" | "network" | "events" | "skills" | "activities" | "destinations" | "alumni";
+export type ResolvedProducts = Record<ProductKey, boolean> & {
+    /** Package shape, so callers stop testing `package ===` themselves. */
+    isTrust: boolean;
+    isHub: boolean;
+    isHubSchool: boolean;
+    /** An approved careersHubLinks entry — a school inside someone else's hub. */
+    hubLinked: boolean;
+    /** Ids of the hubs this institute has accepted. Empty unless hubLinked. */
+    hubIds: string[];
+    /** Products resolved true, in display order. `length` drives the home's
+     * single-product vs multi-product layout. */
+    enabled: ProductKey[];
+};
+/** Just enough of InstituteData to resolve, so callers can pass partials
+ * (a trust school row, a customer-success record) without casting. */
+export type ProductResolverInput = Partial<Pick<InstituteData, "package" | "workExperience" | "employerEvents" | "network" | "careersEvents" | "skillsAssessmentsProduct" | "trackExtracurriculars" | "destinationTracking" | "alumniManagement" | "careersHubLinks">>;
+/**
+ * Resolve an institute's products.
+ *
+ * @param {ProductResolverInput} [institute] the institute, or a partial of it.
+ * @param {object} [options] extra context.
+ * @param {ProductResolverInput[]} [options.trustSchools] schools beneath a trust.
+ *  A trust shows a product when any of its schools has it, matching the nav's
+ *  existing destinations rule.
+ * @return {ResolvedProducts} what this institute has.
+ */
+export declare function resolveProduct(institute?: ProductResolverInput, options?: {
+    trustSchools?: ProductResolverInput[];
+}): ResolvedProducts;
+/** Human labels, for checklists, settings and the trust product strip. */
+export declare const PRODUCT_LABELS: Record<ProductKey, string>;

package/lib/productResolver.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PRODUCT_LABELS = void 0;
+exports.resolveProduct = resolveProduct;
+const PRODUCT_ORDER = ["wex", "destinations", "events", "skills", "activities", "network", "alumni"];
+/** Opt-out flag: undefined means on, only an explicit `false` switches it off. */
+const on = (flag) => flag !== false;
+/**
+ * Resolve an institute's products.
+ *
+ * @param {ProductResolverInput} [institute] the institute, or a partial of it.
+ * @param {object} [options] extra context.
+ * @param {ProductResolverInput[]} [options.trustSchools] schools beneath a trust.
+ *  A trust shows a product when any of its schools has it, matching the nav's
+ *  existing destinations rule.
+ * @return {ResolvedProducts} what this institute has.
+ */
+function resolveProduct(institute, options) {
+    const i = institute || {};
+    const pkg = i.package;
+    const isTrust = pkg === "institutes-two";
+    const isHub = pkg === "careersHub";
+    const isHubSchool = pkg === "careersSchool";
+    // Hub and hub-school accounts don't run their own work experience or skills;
+    // they consume the hub's events and employer network.
+    const runsOwnStudents = !isHub && !isHubSchool;
+    // `employerEvents` is the billing container the events, skills and
+    // extracurricular modules hang off. A hub gets the events module by package.
+    const eventsContainer = Boolean(i.employerEvents) || isHub;
+    const schools = options?.trustSchools || [];
+    /** A trust has a product if it has it itself, or any of its schools does. */
+    const orSchools = (self, pick) => self || (isTrust && schools.some(pick));
+    const wex = orSchools(runsOwnStudents && i.workExperience === true, (s) => s.workExperience === true);
+    const destinations = orSchools(i.destinationTracking === true, (s) => s.destinationTracking === true);
+    const alumni = orSchools(i.alumniManagement === true, (s) => s.alumniManagement === true);
+    const events = orSchools(eventsContainer && on(i.careersEvents), (s) => Boolean(s.employerEvents) && on(s.careersEvents));
+    const skills = orSchools(runsOwnStudents && eventsContainer && on(i.skillsAssessmentsProduct), (s) => Boolean(s.employerEvents) && on(s.skillsAssessmentsProduct));
+    const activities = orSchools(runsOwnStudents && eventsContainer && on(i.trackExtracurriculars), (s) => Boolean(s.employerEvents) && on(s.trackExtracurriculars));
+    // Opt-out and ungated: every institute gets the employer network unless it is
+    // explicitly switched off. Matches Institutes.tsx and the staff home today.
+    const network = on(i.network);
+    const hubIds = Object.entries(i.careersHubLinks || {})
+        .filter(([, link]) => link?.status === "approved")
+        .map(([oId]) => oId);
+    const products = { wex, network, events, skills, activities, destinations, alumni };
+    return {
+        ...products,
+        isTrust,
+        isHub,
+        isHubSchool,
+        hubLinked: hubIds.length > 0,
+        hubIds,
+        enabled: PRODUCT_ORDER.filter((k) => products[k]),
+    };
+}
+/** Human labels, for checklists, settings and the trust product strip. */
+exports.PRODUCT_LABELS = {
+    wex: "Work experience",
+    destinations: "Destinations",
+    events: "Events",
+    skills: "Skills",
+    activities: "Activities",
+    network: "Employer network",
+    alumni: "Alumni",
+};
+//# sourceMappingURL=productResolver.js.map

package/lib/productResolver.js.map

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

package/lib/productResolver.test.d.ts

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

package/lib/productResolver.test.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const productResolver_1 = require("./productResolver");
+/**
+ * The defaults are the point of these tests. Four flags are opt-out, so a refactor
+ * that "tidies" `!== false` into a truthy check would silently switch four products
+ * off for every institute that has never touched the toggle — which is most of them.
+ */
+describe("resolveProduct", () => {
+    describe("opt-out defaults", () => {
+        it("gives a bare institute the employer network", () => {
+            expect((0, productResolver_1.resolveProduct)({ package: "institutes-one" }).network).toBe(true);
+        });
+        it("switches the network off only on an explicit false", () => {
+            expect((0, productResolver_1.resolveProduct)({ network: false }).network).toBe(false);
+            expect((0, productResolver_1.resolveProduct)({ network: undefined }).network).toBe(true);
+        });
+        it("turns on events, skills and activities when employerEvents is set and the sub-flags are undefined", () => {
+            const p = (0, productResolver_1.resolveProduct)({ package: "institutes-one", employerEvents: true });
+            expect(p.events).toBe(true);
+            expect(p.skills).toBe(true);
+            expect(p.activities).toBe(true);
+        });
+        it("lets each sub-flag be switched off independently", () => {
+            const p = (0, productResolver_1.resolveProduct)({
+                package: "institutes-one",
+                employerEvents: true,
+                careersEvents: false,
+                trackExtracurriculars: false,
+            });
+            expect(p.events).toBe(false);
+            expect(p.activities).toBe(false);
+            expect(p.skills).toBe(true);
+        });
+    });
+    describe("sub-flags need their parent", () => {
+        it("does not give skills or activities to a school without employerEvents", () => {
+            const p = (0, productResolver_1.resolveProduct)({ package: "institutes-one", workExperience: true });
+            expect(p.skills).toBe(false);
+            expect(p.activities).toBe(false);
+            expect(p.events).toBe(false);
+        });
+        it("does not resurrect them from an explicit true on the sub-flag alone", () => {
+            const p = (0, productResolver_1.resolveProduct)({
+                package: "institutes-one",
+                skillsAssessmentsProduct: true,
+                trackExtracurriculars: true,
+            });
+            expect(p.skills).toBe(false);
+            expect(p.activities).toBe(false);
+        });
+    });
+    describe("opt-in products", () => {
+        it("leaves wex, destinations and alumni off by default", () => {
+            const p = (0, productResolver_1.resolveProduct)({ package: "institutes-one" });
+            expect(p.wex).toBe(false);
+            expect(p.destinations).toBe(false);
+            expect(p.alumni).toBe(false);
+        });
+        it("turns them on when explicitly true", () => {
+            const p = (0, productResolver_1.resolveProduct)({
+                package: "institutes-one",
+                workExperience: true,
+                destinationTracking: true,
+                alumniManagement: true,
+            });
+            expect(p.wex).toBe(true);
+            expect(p.destinations).toBe(true);
+            expect(p.alumni).toBe(true);
+        });
+    });
+    describe("packages", () => {
+        it("gives a careersHub events without employerEvents, but no wex or skills", () => {
+            const p = (0, productResolver_1.resolveProduct)({ package: "careersHub" });
+            expect(p.events).toBe(true);
+            expect(p.isHub).toBe(true);
+            expect(p.wex).toBe(false);
+            expect(p.skills).toBe(false);
+            expect(p.activities).toBe(false);
+        });
+        it("does not give a careersHub school its own wex even with the flag set", () => {
+            const p = (0, productResolver_1.resolveProduct)({ package: "careersSchool", workExperience: true });
+            expect(p.wex).toBe(false);
+            expect(p.isHubSchool).toBe(true);
+        });
+        it("rolls a trust's products up from its schools", () => {
+            const p = (0, productResolver_1.resolveProduct)({ package: "institutes-two" }, {
+                trustSchools: [
+                    { destinationTracking: true },
+                    { employerEvents: true, careersEvents: false },
+                ],
+            });
+            expect(p.isTrust).toBe(true);
+            expect(p.destinations).toBe(true);
+            expect(p.skills).toBe(true); // sub-flag undefined at the school
+            expect(p.events).toBe(false); // explicitly off at the only events school
+            expect(p.wex).toBe(false);
+        });
+        it("does not roll schools up for a non-trust", () => {
+            const p = (0, productResolver_1.resolveProduct)({ package: "institutes-one" }, {
+                trustSchools: [{ destinationTracking: true }],
+            });
+            expect(p.destinations).toBe(false);
+        });
+    });
+    describe("hub links", () => {
+        it("counts only approved links", () => {
+            const p = (0, productResolver_1.resolveProduct)({
+                careersHubLinks: {
+                    hubA: { exists: true, invited: "2026-01-01", status: "approved" },
+                    hubB: { exists: true, invited: "2026-01-01", status: "invited" },
+                    hubC: { exists: true, invited: "2026-01-01", status: "declined" },
+                },
+            });
+            expect(p.hubLinked).toBe(true);
+            expect(p.hubIds).toEqual(["hubA"]);
+        });
+        it("is not hub-linked with no links", () => {
+            expect((0, productResolver_1.resolveProduct)({}).hubLinked).toBe(false);
+        });
+    });
+    describe("enabled", () => {
+        it("lists products in display order and drives the layout mode", () => {
+            const skillsOnly = (0, productResolver_1.resolveProduct)({
+                package: "institutes-one",
+                employerEvents: true,
+                careersEvents: false,
+                network: false,
+            });
+            expect(skillsOnly.enabled).toEqual(["skills", "activities"]);
+            const fullStack = (0, productResolver_1.resolveProduct)({
+                package: "institutes-one",
+                workExperience: true,
+                employerEvents: true,
+                destinationTracking: true,
+                alumniManagement: true,
+            });
+            expect(fullStack.enabled).toEqual(["wex", "destinations", "events", "skills", "activities", "network", "alumni"]);
+        });
+    });
+});
+//# sourceMappingURL=productResolver.test.js.map

package/lib/productResolver.test.js.map

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

package/package.json

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

package/src/index.ts

@@ -13,6 +13,7 @@ export * from "./surveys/types";
 export * from "./surveys/registry";
 export * from "./surveys/schedule";
 export * from "./skillsResolver";
+export * from "./productResolver";
 export * from "./emailSections";
 export * from "./exportTransformers";
 export * from "./compassExport";

package/src/productResolver.test.ts

@@ -0,0 +1,156 @@
+import {resolveProduct} from "./productResolver";
+
+/**
+ * The defaults are the point of these tests. Four flags are opt-out, so a refactor
+ * that "tidies" `!== false` into a truthy check would silently switch four products
+ * off for every institute that has never touched the toggle — which is most of them.
+ */
+describe("resolveProduct", () => {
+    describe("opt-out defaults", () => {
+        it("gives a bare institute the employer network", () => {
+            expect(resolveProduct({package: "institutes-one"}).network).toBe(true);
+        });
+
+        it("switches the network off only on an explicit false", () => {
+            expect(resolveProduct({network: false}).network).toBe(false);
+            expect(resolveProduct({network: undefined}).network).toBe(true);
+        });
+
+        it("turns on events, skills and activities when employerEvents is set and the sub-flags are undefined", () => {
+            const p = resolveProduct({package: "institutes-one", employerEvents: true});
+            expect(p.events).toBe(true);
+            expect(p.skills).toBe(true);
+            expect(p.activities).toBe(true);
+        });
+
+        it("lets each sub-flag be switched off independently", () => {
+            const p = resolveProduct({
+                package: "institutes-one",
+                employerEvents: true,
+                careersEvents: false,
+                trackExtracurriculars: false,
+            });
+            expect(p.events).toBe(false);
+            expect(p.activities).toBe(false);
+            expect(p.skills).toBe(true);
+        });
+    });
+
+    describe("sub-flags need their parent", () => {
+        it("does not give skills or activities to a school without employerEvents", () => {
+            const p = resolveProduct({package: "institutes-one", workExperience: true});
+            expect(p.skills).toBe(false);
+            expect(p.activities).toBe(false);
+            expect(p.events).toBe(false);
+        });
+
+        it("does not resurrect them from an explicit true on the sub-flag alone", () => {
+            const p = resolveProduct({
+                package: "institutes-one",
+                skillsAssessmentsProduct: true,
+                trackExtracurriculars: true,
+            });
+            expect(p.skills).toBe(false);
+            expect(p.activities).toBe(false);
+        });
+    });
+
+    describe("opt-in products", () => {
+        it("leaves wex, destinations and alumni off by default", () => {
+            const p = resolveProduct({package: "institutes-one"});
+            expect(p.wex).toBe(false);
+            expect(p.destinations).toBe(false);
+            expect(p.alumni).toBe(false);
+        });
+
+        it("turns them on when explicitly true", () => {
+            const p = resolveProduct({
+                package: "institutes-one",
+                workExperience: true,
+                destinationTracking: true,
+                alumniManagement: true,
+            });
+            expect(p.wex).toBe(true);
+            expect(p.destinations).toBe(true);
+            expect(p.alumni).toBe(true);
+        });
+    });
+
+    describe("packages", () => {
+        it("gives a careersHub events without employerEvents, but no wex or skills", () => {
+            const p = resolveProduct({package: "careersHub"});
+            expect(p.events).toBe(true);
+            expect(p.isHub).toBe(true);
+            expect(p.wex).toBe(false);
+            expect(p.skills).toBe(false);
+            expect(p.activities).toBe(false);
+        });
+
+        it("does not give a careersHub school its own wex even with the flag set", () => {
+            const p = resolveProduct({package: "careersSchool", workExperience: true});
+            expect(p.wex).toBe(false);
+            expect(p.isHubSchool).toBe(true);
+        });
+
+        it("rolls a trust's products up from its schools", () => {
+            const p = resolveProduct({package: "institutes-two"}, {
+                trustSchools: [
+                    {destinationTracking: true},
+                    {employerEvents: true, careersEvents: false},
+                ],
+            });
+            expect(p.isTrust).toBe(true);
+            expect(p.destinations).toBe(true);
+            expect(p.skills).toBe(true);      // sub-flag undefined at the school
+            expect(p.events).toBe(false);     // explicitly off at the only events school
+            expect(p.wex).toBe(false);
+        });
+
+        it("does not roll schools up for a non-trust", () => {
+            const p = resolveProduct({package: "institutes-one"}, {
+                trustSchools: [{destinationTracking: true}],
+            });
+            expect(p.destinations).toBe(false);
+        });
+    });
+
+    describe("hub links", () => {
+        it("counts only approved links", () => {
+            const p = resolveProduct({
+                careersHubLinks: {
+                    hubA: {exists: true, invited: "2026-01-01", status: "approved"},
+                    hubB: {exists: true, invited: "2026-01-01", status: "invited"},
+                    hubC: {exists: true, invited: "2026-01-01", status: "declined"},
+                },
+            });
+            expect(p.hubLinked).toBe(true);
+            expect(p.hubIds).toEqual(["hubA"]);
+        });
+
+        it("is not hub-linked with no links", () => {
+            expect(resolveProduct({}).hubLinked).toBe(false);
+        });
+    });
+
+    describe("enabled", () => {
+        it("lists products in display order and drives the layout mode", () => {
+            const skillsOnly = resolveProduct({
+                package: "institutes-one",
+                employerEvents: true,
+                careersEvents: false,
+                network: false,
+            });
+            expect(skillsOnly.enabled).toEqual(["skills", "activities"]);
+
+            const fullStack = resolveProduct({
+                package: "institutes-one",
+                workExperience: true,
+                employerEvents: true,
+                destinationTracking: true,
+                alumniManagement: true,
+            });
+            expect(fullStack.enabled).toEqual(
+                ["wex", "destinations", "events", "skills", "activities", "network", "alumni"]);
+        });
+    });
+});

package/src/productResolver.ts

@@ -0,0 +1,145 @@
+import {InstituteData} from "./typeDefinitions";
+
+/**
+ * Which products an institute actually has.
+ *
+ * The flags on InstituteData are typed `boolean | undefined`, which reads as
+ * "absent means off". Four of them mean the opposite: `network`, `careersEvents`,
+ * `trackExtracurriculars` and `skillsAssessmentsProduct` are tested `!== false`
+ * across the app, so an institute that has never touched the toggle has them ON.
+ * Three of those are also sub-flags that only apply when `employerEvents` (or the
+ * careersHub package) is switched on.
+ *
+ * Every surface used to re-derive those rules by hand, and they had drifted:
+ * the student home rendered skills cards on `skillsAssessmentsProduct !== false`
+ * with no parent check, while UserProfile required the parent — so a student saw
+ * skills on their dashboard that staff could not see on their profile. Wex was
+ * opt-in for staff (`workExperience &&`) and opt-out for students (`!== false`).
+ *
+ * This is the single answer. Nav, home, student surfaces and the backend all read
+ * it, so they cannot disagree about what a customer bought. Dependency-free.
+ */
+
+/** The product a surface can gate on. */
+export type ProductKey =
+    "wex"|"network"|"events"|"skills"|"activities"|"destinations"|"alumni";
+
+export type ResolvedProducts = Record<ProductKey, boolean> & {
+    /** Package shape, so callers stop testing `package ===` themselves. */
+    isTrust: boolean,
+    isHub: boolean,
+    isHubSchool: boolean,
+    /** An approved careersHubLinks entry — a school inside someone else's hub. */
+    hubLinked: boolean,
+    /** Ids of the hubs this institute has accepted. Empty unless hubLinked. */
+    hubIds: string[],
+    /** Products resolved true, in display order. `length` drives the home's
+     * single-product vs multi-product layout. */
+    enabled: ProductKey[],
+};
+
+/** Just enough of InstituteData to resolve, so callers can pass partials
+ * (a trust school row, a customer-success record) without casting. */
+export type ProductResolverInput = Partial<Pick<InstituteData,
+    "package"|"workExperience"|"employerEvents"|"network"|"careersEvents"|
+    "skillsAssessmentsProduct"|"trackExtracurriculars"|"destinationTracking"|
+    "alumniManagement"|"careersHubLinks">>;
+
+const PRODUCT_ORDER: ProductKey[] =
+    ["wex", "destinations", "events", "skills", "activities", "network", "alumni"];
+
+/** Opt-out flag: undefined means on, only an explicit `false` switches it off. */
+const on = (flag?: boolean) => flag !== false;
+
+/**
+ * Resolve an institute's products.
+ *
+ * @param {ProductResolverInput} [institute] the institute, or a partial of it.
+ * @param {object} [options] extra context.
+ * @param {ProductResolverInput[]} [options.trustSchools] schools beneath a trust.
+ *  A trust shows a product when any of its schools has it, matching the nav's
+ *  existing destinations rule.
+ * @return {ResolvedProducts} what this institute has.
+ */
+export function resolveProduct(
+    institute?: ProductResolverInput,
+    options?: {trustSchools?: ProductResolverInput[]},
+): ResolvedProducts {
+    const i = institute || {};
+    const pkg = i.package;
+
+    const isTrust = pkg === "institutes-two";
+    const isHub = pkg === "careersHub";
+    const isHubSchool = pkg === "careersSchool";
+
+    // Hub and hub-school accounts don't run their own work experience or skills;
+    // they consume the hub's events and employer network.
+    const runsOwnStudents = !isHub && !isHubSchool;
+
+    // `employerEvents` is the billing container the events, skills and
+    // extracurricular modules hang off. A hub gets the events module by package.
+    const eventsContainer = Boolean(i.employerEvents) || isHub;
+
+    const schools = options?.trustSchools || [];
+    /** A trust has a product if it has it itself, or any of its schools does. */
+    const orSchools = (
+        self: boolean,
+        pick: (s: ProductResolverInput) => boolean,
+    ) => self || (isTrust && schools.some(pick));
+
+    const wex = orSchools(
+        runsOwnStudents && i.workExperience === true,
+        (s) => s.workExperience === true);
+
+    const destinations = orSchools(
+        i.destinationTracking === true,
+        (s) => s.destinationTracking === true);
+
+    const alumni = orSchools(
+        i.alumniManagement === true,
+        (s) => s.alumniManagement === true);
+
+    const events = orSchools(
+        eventsContainer && on(i.careersEvents),
+        (s) => Boolean(s.employerEvents) && on(s.careersEvents));
+
+    const skills = orSchools(
+        runsOwnStudents && eventsContainer && on(i.skillsAssessmentsProduct),
+        (s) => Boolean(s.employerEvents) && on(s.skillsAssessmentsProduct));
+
+    const activities = orSchools(
+        runsOwnStudents && eventsContainer && on(i.trackExtracurriculars),
+        (s) => Boolean(s.employerEvents) && on(s.trackExtracurriculars));
+
+    // Opt-out and ungated: every institute gets the employer network unless it is
+    // explicitly switched off. Matches Institutes.tsx and the staff home today.
+    const network = on(i.network);
+
+    const hubIds = Object.entries(i.careersHubLinks || {})
+        .filter(([, link]) => link?.status === "approved")
+        .map(([oId]) => oId);
+
+    const products: Record<ProductKey, boolean> =
+        {wex, network, events, skills, activities, destinations, alumni};
+
+    return {
+        ...products,
+        isTrust,
+        isHub,
+        isHubSchool,
+        hubLinked: hubIds.length > 0,
+        hubIds,
+        enabled: PRODUCT_ORDER.filter((k) => products[k]),
+    };
+}
+
+/** Human labels, for checklists, settings and the trust product strip. */
+export const PRODUCT_LABELS: Record<ProductKey, string> = {
+    wex: "Work experience",
+    destinations: "Destinations",
+    events: "Events",
+    skills: "Skills",
+    activities: "Activities",
+    network: "Employer network",
+    alumni: "Alumni",
+};