placementt-core 1.400.1092 → 1.400.1093

package/lib/featureMarketing.d.ts

@@ -0,0 +1,148 @@
+import { InstituteData } from "./typeDefinitions";
+import { ResolvedProducts } from "./productResolver";
+/**
+ * Feature marketing: the things a customer already pays for but has never set
+ * up, and whether now is the time to tell them about one.
+ *
+ * Every feature has a wizard behind a tab that nobody finds, and the way a
+ * school learns it exists is an email in the right month with a card on the
+ * dashboard that says the same thing. This module is the registry those two
+ * surfaces share, and the detectors that decide "set up" from the database
+ * rather than from whether anyone opened the last email.
+ *
+ * "Adopted" means ever set up, never "built for this year". A school whose
+ * aspiration surveys ran last year and are not built for this one is not a
+ * marketing prospect, it is a school with a yearly step outstanding, and that
+ * is onboarding's to chase (onboardingPathways.ts, state `yearMissing`).
+ * Marketing pitches `unconfigured` and nothing else.
+ *
+ * It is deliberately pure. Adoption is judged from the institute document plus
+ * a handful of counts the caller fetches, and each entry says which counts it
+ * needs (`needs`) so the backend cron fetches nothing a feature does not ask
+ * for. Campaign state, cooling-off and sending live in the backend; the
+ * dashboard reads the campaign it is handed. Neither side works adoption out
+ * for itself.
+ */
+/** Every feature the engine can market. Stable keys: they name campaign documents. */
+export type FeatureMarketingKey = "wexCohort" | "alumni" | "leavers" | "aspirations" | "parents" | "skills" | "activities" | "careersLibrary" | "guidance" | "events" | "employerPortal";
+export declare const FEATURE_MARKETING_KEYS: FeatureMarketingKey[];
+/**
+ * Counts a detector may need that are not on the institute document. The
+ * backend fetches only the ones the features under consideration list in
+ * `needs`; a missing count reads as zero, so a feature whose count was not
+ * fetched is judged not adopted, never the other way round.
+ */
+export type FeatureMarketingCounts = {
+    /** `cohorts` where oId. Work experience has been run at least once. */
+    cohorts?: number;
+    /** `parents` where oId. The parent database exists once anyone is in it. */
+    parents?: number;
+    /** `alumni` where oId. Likewise for alumni. */
+    alumni?: number;
+    /** `externalEvents` where oId. */
+    events?: number;
+    /** `providerContacts` where savedBy.{oId}.exists and uid set: employers in
+     * the network who hold a provider account. */
+    linkedProviders?: number;
+    /** `users` where oId and lmiViews != null: students who have opened a job
+     * profile in the careers library. */
+    careersLibraryViewers?: number;
+};
+export type FeatureMarketingCountKey = keyof FeatureMarketingCounts;
+export type FeatureMarketingContext = {
+    institute: InstituteData;
+    products: ResolvedProducts;
+    counts: FeatureMarketingCounts;
+    now?: Date;
+};
+/** A window in which a campaign for the feature may START. "MM-DD" inclusive
+ * at both ends; wraps the year boundary when start > end. A touch already in
+ * flight carries on past the end of the window. */
+export type FeatureMarketingSeason = {
+    start: string;
+    end: string;
+};
+export type FeatureMarketingEntry = {
+    key: FeatureMarketingKey;
+    /** What staff call it, on the card and in the subject line. */
+    label: string;
+    /** One line on what setting it up gets them. */
+    description: string;
+    /** The counts `adopted` reads. Anything not listed is not fetched. */
+    needs: FeatureMarketingCountKey[];
+    /** Whether this account has the feature at all. A feature nobody pays for
+     * is not marketed, and neither is one an account type cannot run. */
+    offered: (ctx: FeatureMarketingContext) => boolean;
+    /** Whether it has been set up, from the database and nothing else. */
+    adopted: (ctx: FeatureMarketingContext) => boolean;
+    /** When it is worth pitching. Empty means any time. */
+    seasons: FeatureMarketingSeason[];
+    /** Tie-break between features in season together. Lower goes first. */
+    priority: number;
+    /** Where the call to action lands, under the org's url prefix. */
+    path: string;
+    /** Brevo template ids, one per touch, in sending order. The first is the
+     * pitch, the rest are follow-ups sent only while the feature is still not
+     * adopted. `BREVO_TEMPLATE_UNSET` means the template has not been made
+     * yet and that touch is skipped, not sent blank. */
+    templateIds: number[];
+};
+/** Placeholder for a Brevo template that has not been created yet. */
+export declare const BREVO_TEMPLATE_UNSET = 0;
+/** Days after the campaign starts that each touch goes out. Index-matched to
+ * `templateIds`; a feature with fewer templates just stops sooner. */
+export declare const FEATURE_MARKETING_TOUCH_DELAYS_DAYS: number[];
+/**
+ * Whether a date falls inside any of a feature's seasons.
+ *
+ * @param {FeatureMarketingSeason[]} seasons the feature's windows; none means always.
+ * @param {Date} [now] the date to test.
+ * @return {boolean} whether a campaign could start today.
+ */
+export declare const inFeatureMarketingSeason: (seasons: FeatureMarketingSeason[], now?: Date) => boolean;
+/**
+ * The registry, in the order a school is asked about them when two are in
+ * season together. Work experience first because it is the product most
+ * schools bought; the careers-year programmes next in the order the September
+ * setup asks; the employer side last because it needs the network to exist.
+ */
+export declare const FEATURE_MARKETING: FeatureMarketingEntry[];
+export declare const FEATURE_MARKETING_BY_KEY: Record<FeatureMarketingKey, FeatureMarketingEntry>;
+/**
+ * Which counts to fetch before judging an institute, given only what is on its
+ * document. Features the account does not have are skipped, so a hub is never
+ * charged a cohort count for a product it cannot run.
+ *
+ * @param {InstituteData} institute the institute.
+ * @param {ResolvedProducts} products its resolved products.
+ * @return {FeatureMarketingCountKey[]} the counts the offered features read.
+ */
+export declare const featureMarketingCountsNeeded: (institute: InstituteData, products: ResolvedProducts) => FeatureMarketingCountKey[];
+/** Where one feature stands for an institute. */
+export type FeatureAdoption = {
+    key: FeatureMarketingKey;
+    label: string;
+    offered: boolean;
+    adopted: boolean;
+    inSeason: boolean;
+    /** Offered, not adopted and in season: a campaign could start today. */
+    candidate: boolean;
+};
+/**
+ * Every feature in the registry, judged for one institute.
+ *
+ * The report is the whole truth in one place: the backend picks a campaign
+ * from `candidate`, the admin panel shows adoption per feature, and a test can
+ * assert on any one line without re-running the detectors.
+ *
+ * @param {FeatureMarketingContext} ctx the institute, its products and counts.
+ * @return {FeatureAdoption[]} one line per feature, in registry order.
+ */
+export declare const evaluateFeatureAdoption: (ctx: FeatureMarketingContext) => FeatureAdoption[];
+/**
+ * The features a campaign could start for today, best first.
+ *
+ * @param {FeatureMarketingContext} ctx the institute, its products and counts.
+ * @return {FeatureMarketingEntry[]} candidates in priority order.
+ */
+export declare const featureMarketingCandidates: (ctx: FeatureMarketingContext) => FeatureMarketingEntry[];

package/lib/featureMarketing.js

@@ -0,0 +1,243 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.featureMarketingCandidates = exports.evaluateFeatureAdoption = exports.featureMarketingCountsNeeded = exports.FEATURE_MARKETING_BY_KEY = exports.FEATURE_MARKETING = exports.inFeatureMarketingSeason = exports.FEATURE_MARKETING_TOUCH_DELAYS_DAYS = exports.BREVO_TEMPLATE_UNSET = exports.FEATURE_MARKETING_KEYS = void 0;
+const activityLogging_1 = require("./activityLogging");
+exports.FEATURE_MARKETING_KEYS = [
+    "wexCohort", "alumni", "leavers", "aspirations", "parents", "skills",
+    "activities", "careersLibrary", "guidance", "events", "employerPortal",
+];
+/** Placeholder for a Brevo template that has not been created yet. */
+exports.BREVO_TEMPLATE_UNSET = 0;
+/** Days after the campaign starts that each touch goes out. Index-matched to
+ * `templateIds`; a feature with fewer templates just stops sooner. */
+exports.FEATURE_MARKETING_TOUCH_DELAYS_DAYS = [0, 7, 21];
+const mmdd = (date) => `${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")}`;
+/**
+ * Whether a date falls inside any of a feature's seasons.
+ *
+ * @param {FeatureMarketingSeason[]} seasons the feature's windows; none means always.
+ * @param {Date} [now] the date to test.
+ * @return {boolean} whether a campaign could start today.
+ */
+const inFeatureMarketingSeason = (seasons, now = new Date()) => {
+    if (!seasons.length)
+        return true;
+    const today = mmdd(now);
+    return seasons.some(({ start, end }) => start <= end ? (today >= start && today <= end) : (today >= start || today <= end));
+};
+exports.inFeatureMarketingSeason = inFeatureMarketingSeason;
+/** The careers-programme features are set up by the school that runs the
+ * students. A trust, a hub and a hub school all drive somebody else's. */
+const runsOwnCareers = ({ products }) => products.runsOwnStudents && !products.isTrust;
+const destinationsSetUp = (institute) => Boolean(institute.destinationsConfig?.setupCompletedAt);
+/**
+ * The registry, in the order a school is asked about them when two are in
+ * season together. Work experience first because it is the product most
+ * schools bought; the careers-year programmes next in the order the September
+ * setup asks; the employer side last because it needs the network to exist.
+ */
+exports.FEATURE_MARKETING = [
+    {
+        key: "wexCohort",
+        label: "Work Experience Cohort",
+        description: "Create a recurring group and we'll make the cohort, chase the forms and collect the feedback every year.",
+        needs: ["cohorts"],
+        offered: (ctx) => ctx.products.wex && runsOwnCareers(ctx),
+        adopted: ({ institute, counts }) => Object.keys(institute.cohortConfig || {}).length > 0 || (counts.cohorts || 0) > 0,
+        // Two runs at it: November, once the careers year is bedded in, and
+        // January for a school that let it slide over Christmas. Later than
+        // that and there is no time to get the placements sorted.
+        seasons: [{ start: "11-01", end: "11-30" }, { start: "01-01", end: "01-31" }],
+        priority: 10,
+        path: "/cohorts",
+        templateIds: [exports.BREVO_TEMPLATE_UNSET, exports.BREVO_TEMPLATE_UNSET, exports.BREVO_TEMPLATE_UNSET],
+    },
+    {
+        key: "aspirations",
+        label: "Career Aspiration Surveys",
+        description: "What students want to do next, tracked across the year and compared against where they end up.",
+        needs: [],
+        offered: (ctx) => ctx.products.destinations && runsOwnCareers(ctx),
+        adopted: ({ institute }) => destinationsSetUp(institute) && Boolean(institute.destinationsConfig?.aspirations?.enabled),
+        seasons: [{ start: "09-01", end: "10-31" }, { start: "01-05", end: "02-15" }],
+        priority: 20,
+        path: "/destinations",
+        templateIds: [exports.BREVO_TEMPLATE_UNSET, exports.BREVO_TEMPLATE_UNSET, exports.BREVO_TEMPLATE_UNSET],
+    },
+    {
+        key: "guidance",
+        label: "1:1 Careers Guidance",
+        description: "Guidance meetings and careers conversations, scheduled per year group and recorded for Gatsby.",
+        needs: [],
+        offered: (ctx) => (ctx.products.skills || ctx.products.activities) && runsOwnCareers(ctx),
+        adopted: ({ institute }) => Boolean(institute.guidanceConfig?.setupCompletedAt),
+        seasons: [{ start: "09-01", end: "11-30" }],
+        priority: 30,
+        path: "/development/guidance",
+        templateIds: [exports.BREVO_TEMPLATE_UNSET, exports.BREVO_TEMPLATE_UNSET, exports.BREVO_TEMPLATE_UNSET],
+    },
+    {
+        key: "skills",
+        label: "Skills Tracking",
+        description: "Skills surveys for students, and for the parents and employers who see them at work.",
+        needs: [],
+        offered: (ctx) => ctx.products.skills && runsOwnCareers(ctx),
+        adopted: ({ institute }) => Boolean(institute.skillsAssessments),
+        seasons: [{ start: "09-01", end: "10-15" }, { start: "01-05", end: "02-15" }],
+        priority: 40,
+        path: "/development/assessments",
+        templateIds: [exports.BREVO_TEMPLATE_UNSET, exports.BREVO_TEMPLATE_UNSET, exports.BREVO_TEMPLATE_UNSET],
+    },
+    {
+        key: "activities",
+        label: "Extracurricular Activities",
+        description: "Let students log what they do outside lessons and reflect on the skills it built.",
+        needs: [],
+        offered: (ctx) => ctx.products.activities && runsOwnCareers(ctx),
+        // Launched at least once. A lapsed launch is a "set up this year" card,
+        // which the careers-year prompt already handles; it is not a pitch.
+        adopted: ({ institute, now }) => (0, activityLogging_1.activityLoggingState)(institute, now) !== "unconfigured",
+        seasons: [{ start: "09-01", end: "10-31" }, { start: "01-05", end: "01-31" }],
+        priority: 50,
+        path: "/development/activities",
+        templateIds: [exports.BREVO_TEMPLATE_UNSET, exports.BREVO_TEMPLATE_UNSET, exports.BREVO_TEMPLATE_UNSET],
+    },
+    {
+        key: "careersLibrary",
+        label: "Careers Library",
+        description: "Job profiles with real pay, prospects and routes in, for students to browse on their own.",
+        needs: ["careersLibraryViewers"],
+        offered: (ctx) => ctx.products.destinations && runsOwnCareers(ctx),
+        // There is no switch to flip for the library, so "set up" is students
+        // using it: a school that has told a year group about it will have views.
+        adopted: ({ counts }) => (counts.careersLibraryViewers || 0) > 0,
+        seasons: [],
+        priority: 60,
+        path: "/destinations",
+        templateIds: [exports.BREVO_TEMPLATE_UNSET, exports.BREVO_TEMPLATE_UNSET, exports.BREVO_TEMPLATE_UNSET],
+    },
+    {
+        key: "parents",
+        label: "Parent Network",
+        description: "Ask every parent whether they'd help with careers events, and build the database from the answers.",
+        needs: ["parents"],
+        // The parent database hangs off employer events; it has no flag of its
+        // own, so "offered" is the container and "adopted" is anyone being in it.
+        offered: (ctx) => ctx.products.employerEvents && runsOwnCareers(ctx),
+        adopted: ({ counts }) => (counts.parents || 0) > 0,
+        seasons: [{ start: "09-01", end: "10-31" }],
+        priority: 70,
+        path: "/network/parents",
+        templateIds: [exports.BREVO_TEMPLATE_UNSET, exports.BREVO_TEMPLATE_UNSET, exports.BREVO_TEMPLATE_UNSET],
+    },
+    {
+        key: "leavers",
+        label: "Leaver Tracking",
+        description: "Destinations for the years that leave you, from intentions in spring through to the October census.",
+        needs: [],
+        offered: (ctx) => ctx.products.destinations && runsOwnCareers(ctx),
+        adopted: ({ institute }) => destinationsSetUp(institute) && Boolean(institute.destinationsConfig?.leavers?.enabled),
+        // March: the intentions form has to go out before the leavers leave.
+        seasons: [{ start: "03-01", end: "03-31" }],
+        priority: 80,
+        path: "/destinations/leavers",
+        templateIds: [exports.BREVO_TEMPLATE_UNSET, exports.BREVO_TEMPLATE_UNSET, exports.BREVO_TEMPLATE_UNSET],
+    },
+    {
+        key: "alumni",
+        label: "Alumni Database",
+        description: "Keep in touch with leavers each year and find out how they'd like to come back and help.",
+        needs: ["alumni"],
+        offered: (ctx) => ctx.products.alumni && runsOwnCareers(ctx),
+        adopted: ({ counts }) => (counts.alumni || 0) > 0,
+        // Before the leavers go, and again once they have settled.
+        seasons: [{ start: "05-01", end: "07-15" }, { start: "09-15", end: "10-31" }],
+        priority: 90,
+        path: "/network/alumni",
+        templateIds: [exports.BREVO_TEMPLATE_UNSET, exports.BREVO_TEMPLATE_UNSET, exports.BREVO_TEMPLATE_UNSET],
+    },
+    {
+        key: "events",
+        label: "Careers Events",
+        description: "Add an event, invite the right employers from your network and track who turns up.",
+        needs: ["events"],
+        offered: (ctx) => ctx.products.events && !ctx.products.isTrust,
+        adopted: ({ counts }) => (counts.events || 0) > 0,
+        seasons: [],
+        priority: 100,
+        path: "/events",
+        templateIds: [exports.BREVO_TEMPLATE_UNSET, exports.BREVO_TEMPLATE_UNSET, exports.BREVO_TEMPLATE_UNSET],
+    },
+    {
+        key: "employerPortal",
+        label: "Employer Accounts",
+        description: "Let employers sign up, keep their own details current and find your events themselves.",
+        needs: ["linkedProviders"],
+        offered: (ctx) => ctx.products.network && !ctx.products.isTrust,
+        // Either door counts: the public page is the employer side switched on
+        // from the school's end, a linked provider is an employer who came in.
+        adopted: ({ institute, counts }) => Boolean(institute.publicEventPage) || (counts.linkedProviders || 0) > 0,
+        seasons: [],
+        priority: 110,
+        path: "/network/overview#employerSettings",
+        templateIds: [exports.BREVO_TEMPLATE_UNSET, exports.BREVO_TEMPLATE_UNSET, exports.BREVO_TEMPLATE_UNSET],
+    },
+];
+exports.FEATURE_MARKETING_BY_KEY = Object.fromEntries(exports.FEATURE_MARKETING.map((f) => [f.key, f]));
+/**
+ * Which counts to fetch before judging an institute, given only what is on its
+ * document. Features the account does not have are skipped, so a hub is never
+ * charged a cohort count for a product it cannot run.
+ *
+ * @param {InstituteData} institute the institute.
+ * @param {ResolvedProducts} products its resolved products.
+ * @return {FeatureMarketingCountKey[]} the counts the offered features read.
+ */
+const featureMarketingCountsNeeded = (institute, products) => {
+    const ctx = { institute, products, counts: {} };
+    const needed = new Set();
+    exports.FEATURE_MARKETING.filter((f) => f.offered(ctx)).forEach((f) => f.needs.forEach((n) => needed.add(n)));
+    return Array.from(needed);
+};
+exports.featureMarketingCountsNeeded = featureMarketingCountsNeeded;
+/**
+ * Every feature in the registry, judged for one institute.
+ *
+ * The report is the whole truth in one place: the backend picks a campaign
+ * from `candidate`, the admin panel shows adoption per feature, and a test can
+ * assert on any one line without re-running the detectors.
+ *
+ * @param {FeatureMarketingContext} ctx the institute, its products and counts.
+ * @return {FeatureAdoption[]} one line per feature, in registry order.
+ */
+const evaluateFeatureAdoption = (ctx) => {
+    const now = ctx.now || new Date();
+    return exports.FEATURE_MARKETING.map((f) => {
+        const offered = f.offered(ctx);
+        const adopted = offered && f.adopted(ctx);
+        const inSeason = (0, exports.inFeatureMarketingSeason)(f.seasons, now);
+        return {
+            key: f.key,
+            label: f.label,
+            offered,
+            adopted,
+            inSeason,
+            candidate: offered && !adopted && inSeason,
+        };
+    });
+};
+exports.evaluateFeatureAdoption = evaluateFeatureAdoption;
+/**
+ * The features a campaign could start for today, best first.
+ *
+ * @param {FeatureMarketingContext} ctx the institute, its products and counts.
+ * @return {FeatureMarketingEntry[]} candidates in priority order.
+ */
+const featureMarketingCandidates = (ctx) => {
+    const candidates = new Set((0, exports.evaluateFeatureAdoption)(ctx).filter((a) => a.candidate).map((a) => a.key));
+    return exports.FEATURE_MARKETING
+        .filter((f) => candidates.has(f.key))
+        .sort((a, b) => a.priority - b.priority);
+};
+exports.featureMarketingCandidates = featureMarketingCandidates;
+//# sourceMappingURL=featureMarketing.js.map

package/lib/featureMarketing.js.map

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

package/lib/featureMarketing.test.d.ts

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

package/lib/featureMarketing.test.js

@@ -0,0 +1,223 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+jest.mock("firebase/firestore", () => ({ where: jest.fn() }));
+jest.mock("./firebase/firebaseQuery", () => ({ __esModule: true, default: class {
+    } }));
+const productResolver_1 = require("./productResolver");
+const featureMarketing_1 = require("./featureMarketing");
+/**
+ * The detectors read the database and nothing else, so every test is a school
+ * document plus a few counts, and the question is only ever "does this read as
+ * set up". Season tests pin the date so a run in July does not disagree with
+ * one in January.
+ */
+const OCTOBER = new Date("2026-10-06T09:00:00Z");
+const JANUARY = new Date("2027-01-20T09:00:00Z");
+const MARCH = new Date("2027-03-10T09:00:00Z");
+const JUNE = new Date("2027-06-10T09:00:00Z");
+/** A school that has bought everything and set up nothing. */
+const school = (overrides = {}) => ({
+    name: "Calder Park Academy",
+    package: "institutes-one",
+    workExperience: true,
+    employerEvents: true,
+    destinationTracking: true,
+    alumniManagement: true,
+    ...overrides,
+});
+const ctx = (institute, counts = {}, now = OCTOBER, parentCount = counts.parents || 0) => ({
+    institute,
+    products: (0, productResolver_1.resolveProducts)(institute, { parentCount }),
+    counts,
+    now,
+});
+const adoption = (c, key) => (0, featureMarketing_1.evaluateFeatureAdoption)(c).find((a) => a.key === key);
+describe("registry", () => {
+    it("lists every key exactly once, in the order the keys constant gives", () => {
+        expect(featureMarketing_1.FEATURE_MARKETING.map((f) => f.key).sort()).toEqual([...featureMarketing_1.FEATURE_MARKETING_KEYS].sort());
+        expect(new Set(featureMarketing_1.FEATURE_MARKETING.map((f) => f.key)).size).toBe(featureMarketing_1.FEATURE_MARKETING.length);
+        featureMarketing_1.FEATURE_MARKETING_KEYS.forEach((k) => expect(featureMarketing_1.FEATURE_MARKETING_BY_KEY[k].key).toBe(k));
+    });
+    it("gives every feature a distinct priority, so two in season never tie", () => {
+        const priorities = featureMarketing_1.FEATURE_MARKETING.map((f) => f.priority);
+        expect(new Set(priorities).size).toBe(priorities.length);
+    });
+    it("gives every feature a template per touch, no more touches than there are delays", () => {
+        featureMarketing_1.FEATURE_MARKETING.forEach((f) => {
+            expect(f.templateIds.length).toBeGreaterThan(0);
+            expect(f.templateIds.length).toBeLessThanOrEqual(featureMarketing_1.FEATURE_MARKETING_TOUCH_DELAYS_DAYS.length);
+        });
+    });
+    it("only lists counts a detector can actually read", () => {
+        const known = ["cohorts", "parents", "alumni", "events", "linkedProviders", "careersLibraryViewers"];
+        featureMarketing_1.FEATURE_MARKETING.forEach((f) => f.needs.forEach((n) => expect(known).toContain(n)));
+    });
+});
+describe("inFeatureMarketingSeason", () => {
+    it("is always in season with no windows", () => {
+        expect((0, featureMarketing_1.inFeatureMarketingSeason)([], JUNE)).toBe(true);
+    });
+    it("is inclusive at both ends", () => {
+        const season = [{ start: "09-01", end: "10-31" }];
+        expect((0, featureMarketing_1.inFeatureMarketingSeason)(season, new Date("2026-09-01T00:00:00"))).toBe(true);
+        expect((0, featureMarketing_1.inFeatureMarketingSeason)(season, new Date("2026-10-31T23:00:00"))).toBe(true);
+        expect((0, featureMarketing_1.inFeatureMarketingSeason)(season, new Date("2026-11-01T00:00:00"))).toBe(false);
+        expect((0, featureMarketing_1.inFeatureMarketingSeason)(season, new Date("2026-08-31T00:00:00"))).toBe(false);
+    });
+    it("wraps the year boundary when start is after end", () => {
+        const season = [{ start: "12-01", end: "03-31" }];
+        expect((0, featureMarketing_1.inFeatureMarketingSeason)(season, new Date("2026-12-15T00:00:00"))).toBe(true);
+        expect((0, featureMarketing_1.inFeatureMarketingSeason)(season, new Date("2027-02-01T00:00:00"))).toBe(true);
+        expect((0, featureMarketing_1.inFeatureMarketingSeason)(season, new Date("2027-04-01T00:00:00"))).toBe(false);
+        expect((0, featureMarketing_1.inFeatureMarketingSeason)(season, new Date("2026-11-30T00:00:00"))).toBe(false);
+    });
+});
+describe("offered", () => {
+    it("offers a fully bought school every feature", () => {
+        const report = (0, featureMarketing_1.evaluateFeatureAdoption)(ctx(school()));
+        expect(report.every((a) => a.offered)).toBe(true);
+    });
+    it("does not offer what the school has not bought", () => {
+        const report = (0, featureMarketing_1.evaluateFeatureAdoption)(ctx(school({
+            workExperience: false, destinationTracking: false, alumniManagement: false,
+        })));
+        const offered = report.filter((a) => a.offered).map((a) => a.key);
+        expect(offered).not.toContain("wexCohort");
+        expect(offered).not.toContain("aspirations");
+        expect(offered).not.toContain("leavers");
+        expect(offered).not.toContain("careersLibrary");
+        expect(offered).not.toContain("alumni");
+        // Still hanging off employerEvents.
+        expect(offered).toEqual(expect.arrayContaining(["skills", "activities", "guidance", "parents", "events", "employerPortal"]));
+    });
+    it("offers a hub only the employer side", () => {
+        const hub = school({ package: "careersHub" });
+        const offered = (0, featureMarketing_1.evaluateFeatureAdoption)(ctx(hub)).filter((a) => a.offered).map((a) => a.key);
+        expect(offered.sort()).toEqual(["employerPortal", "events"]);
+    });
+    it("offers a trust nothing: its schools run the programmes", () => {
+        const trust = school({ package: "institutes-two" });
+        expect((0, featureMarketing_1.evaluateFeatureAdoption)(ctx(trust)).some((a) => a.offered)).toBe(false);
+    });
+    it("never marks something adopted that is not offered", () => {
+        const hub = school({ package: "careersHub", skillsAssessments: true, cohortConfig: { g: { name: "Y10" } } });
+        const report = (0, featureMarketing_1.evaluateFeatureAdoption)(ctx(hub, { cohorts: 3 }));
+        report.filter((a) => !a.offered).forEach((a) => expect(a.adopted).toBe(false));
+    });
+});
+describe("adopted", () => {
+    const expectAdopted = (key, c, value) => expect(adoption(c, key).adopted).toBe(value);
+    it("work experience: a recurring group or any cohort ever", () => {
+        expectAdopted("wexCohort", ctx(school()), false);
+        expectAdopted("wexCohort", ctx(school({ cohortConfig: { g: { name: "Year 10" } } })), true);
+        expectAdopted("wexCohort", ctx(school(), { cohorts: 1 }), true);
+    });
+    it("aspirations and leavers: destinations set up with that programme enabled", () => {
+        const half = school({ destinationsConfig: { setupCompletedAt: "2026-09-02", aspirations: { enabled: true } } });
+        expectAdopted("aspirations", ctx(half), true);
+        expectAdopted("leavers", ctx(half), false);
+        // Enabled but the wizard was never finished does not count.
+        const unfinished = school({ destinationsConfig: { aspirations: { enabled: true }, leavers: { enabled: true } } });
+        expectAdopted("aspirations", ctx(unfinished), false);
+        expectAdopted("leavers", ctx(unfinished), false);
+    });
+    it("guidance and skills: their setup flags", () => {
+        expectAdopted("guidance", ctx(school()), false);
+        expectAdopted("guidance", ctx(school({ guidanceConfig: { setupCompletedAt: "2026-09-02" } })), true);
+        expectAdopted("skills", ctx(school()), false);
+        expectAdopted("skills", ctx(school({ skillsAssessments: true })), true);
+    });
+    it("activities: launched at least once, even if that launch has lapsed", () => {
+        expectAdopted("activities", ctx(school()), false);
+        const lapsed = school({ activityLogging: {
+                setupCompletedAt: "2025-09-02", launchedYear: "2025-26", yearGroups: { "Year 9": true },
+            } });
+        expectAdopted("activities", ctx(lapsed, {}, OCTOBER), true);
+        // Set up but launched to nobody is not set up.
+        const nobody = school({ activityLogging: { setupCompletedAt: "2026-09-02", launchedYear: "2026-27", yearGroups: {} } });
+        expectAdopted("activities", ctx(nobody), false);
+    });
+    it("counts: parents, alumni, events, employer accounts and library viewers", () => {
+        expectAdopted("parents", ctx(school()), false);
+        expectAdopted("parents", ctx(school(), { parents: 12 }), true);
+        expectAdopted("alumni", ctx(school(), { alumni: 1 }), true);
+        expectAdopted("events", ctx(school(), { events: 1 }), true);
+        expectAdopted("careersLibrary", ctx(school(), { careersLibraryViewers: 1 }), true);
+        expectAdopted("employerPortal", ctx(school(), { linkedProviders: 1 }), true);
+    });
+    it("employer accounts: the public events page counts too", () => {
+        expectAdopted("employerPortal", ctx(school()), false);
+        expectAdopted("employerPortal", ctx(school({ publicEventPage: true })), true);
+    });
+    it("reads a count that was not fetched as not adopted", () => {
+        expectAdopted("alumni", ctx(school(), {}), false);
+    });
+});
+describe("featureMarketingCountsNeeded", () => {
+    it("asks for every count a full school's detectors read", () => {
+        const s = school();
+        expect((0, featureMarketing_1.featureMarketingCountsNeeded)(s, (0, productResolver_1.resolveProducts)(s)).sort())
+            .toEqual(["alumni", "careersLibraryViewers", "cohorts", "events", "linkedProviders", "parents"]);
+    });
+    it("asks a hub for nothing about students", () => {
+        const hub = school({ package: "careersHub" });
+        expect((0, featureMarketing_1.featureMarketingCountsNeeded)(hub, (0, productResolver_1.resolveProducts)(hub)).sort())
+            .toEqual(["events", "linkedProviders"]);
+    });
+    it("asks a trust for nothing", () => {
+        const trust = school({ package: "institutes-two" });
+        expect((0, featureMarketing_1.featureMarketingCountsNeeded)(trust, (0, productResolver_1.resolveProducts)(trust))).toEqual([]);
+    });
+});
+describe("candidates", () => {
+    it("are offered, not adopted and in season, best first", () => {
+        const keys = (0, featureMarketing_1.featureMarketingCandidates)(ctx(school(), {}, OCTOBER)).map((f) => f.key);
+        // October: no work experience (November, January), no leavers (March).
+        expect(keys).not.toContain("wexCohort");
+        expect(keys).not.toContain("leavers");
+        expect(keys).toEqual(["aspirations", "guidance", "skills", "activities", "careersLibrary", "parents", "alumni", "events", "employerPortal"]);
+    });
+    it("moves with the calendar", () => {
+        const january = (0, featureMarketing_1.featureMarketingCandidates)(ctx(school(), {}, JANUARY)).map((f) => f.key);
+        expect(january[0]).toBe("wexCohort");
+        expect(january).not.toContain("leavers");
+        expect(january).not.toContain("parents");
+        expect(january).not.toContain("guidance");
+        const march = (0, featureMarketing_1.featureMarketingCandidates)(ctx(school(), {}, MARCH)).map((f) => f.key);
+        expect(march).toContain("leavers");
+        expect(march).not.toContain("wexCohort");
+    });
+    it("drops what has been set up", () => {
+        const done = school({ skillsAssessments: true, guidanceConfig: { setupCompletedAt: "2026-09-02" } });
+        const keys = (0, featureMarketing_1.featureMarketingCandidates)(ctx(done, { events: 4, parents: 30 }, OCTOBER)).map((f) => f.key);
+        expect(keys).toEqual(["aspirations", "activities", "careersLibrary", "alumni", "employerPortal"]);
+    });
+    it("never pitches something set up in a past year and not built for this one", () => {
+        // Everything configured, nothing provisioned this year, an old activity
+        // launch that has lapsed, one cohort from last year. That is a school
+        // with yearly steps outstanding, which is onboarding's job, not a pitch.
+        const lastYear = school({
+            cohortConfig: { g: { name: "Year 10" } },
+            skillsAssessments: true,
+            guidanceConfig: { setupCompletedAt: "2025-09-02" },
+            destinationsConfig: { setupCompletedAt: "2025-09-02", aspirations: { enabled: true }, leavers: { enabled: true } },
+            activityLogging: { setupCompletedAt: "2025-09-02", launchedYear: "2025-26", yearGroups: { "Year 9": true } },
+        });
+        const keys = (0, featureMarketing_1.featureMarketingCandidates)(ctx(lastYear, { cohorts: 1 }, OCTOBER)).map((f) => f.key);
+        ["wexCohort", "aspirations", "leavers", "skills", "guidance", "activities"]
+            .forEach((k) => expect(keys).not.toContain(k));
+    });
+    it("is empty for a school with everything running", () => {
+        const done = school({
+            cohortConfig: { g: { name: "Year 10" } },
+            skillsAssessments: true,
+            publicEventPage: true,
+            guidanceConfig: { setupCompletedAt: "2026-09-02" },
+            destinationsConfig: { setupCompletedAt: "2026-09-02", aspirations: { enabled: true }, leavers: { enabled: true } },
+            activityLogging: { setupCompletedAt: "2026-09-02", launchedYear: "2026-27", yearGroups: { "Year 9": true } },
+        });
+        const counts = { parents: 5, alumni: 5, events: 5, careersLibraryViewers: 5 };
+        expect((0, featureMarketing_1.featureMarketingCandidates)(ctx(done, counts, JUNE))).toEqual([]);
+    });
+});
+//# sourceMappingURL=featureMarketing.test.js.map