placementt-core 1.400.985 → 1.400.987

package/lib/surveys/schedule.js

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * surveys/schedule.ts — resolving survey schedules to concrete dates.
+ *
+ * Home of the relative survey-date rules ("first Monday of June") that were
+ * previously in constants.ts, plus the slot→date and academic-year helpers that
+ * provisionDueSkillsSurveys (skillsAssessments.ts) and destinationsProvisionCron
+ * (aspirations.ts) each had their own copy of.
+ *
+ * A rule is year-agnostic; it resolves into a concrete date for a given academic
+ * year (each September) via surveyRuleToMMDD / surveyRuleToDate.
+ *
+ * ── One academic-year boundary: 1 September ───────────────────────────────────
+ * Everything here derives the academic year the same way — currentAcademicStartYear,
+ * and academicYearOf which labels it. September to August is one academic year.
+ *
+ * This is a deliberate correction. Pre-engine code had two boundaries: the year
+ * LABEL flipped in August (skillsAcademicYear in skillsAssessments.ts, and the
+ * inline `sendMonth >= 8` in createAspirationCycle) while rule resolution flipped
+ * in September (destinationsStartYear). So a survey sent in August was labelled with
+ * the year ahead of the one it was scheduled from. Two consequences for the rollout:
+ *  • the migration scripts must RE-DERIVE academicYear from scheduledSendDate with
+ *    academicYearOf rather than copying the stored label, or August-dated cycles
+ *    (leaver results-day checkpoints ~29 Aug especially) land in the wrong year;
+ *  • the two legacy derivations must be replaced by academicYearOf when their
+ *    callers move onto the engine, so new writes agree with migrated ones.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSlotDueOn = exports.resolveSlotsForYear = exports.slotMMDDForYear = exports.mmddToISO = exports.surveyRuleToMMDD = exports.surveyRuleToDate = exports.resolveNthWeekday = exports.normaliseAcademicYear = exports.academicYearSlashLabel = exports.academicYearOf = exports.academicYearLabel = exports.currentAcademicStartYear = exports.academicCalendarYear = exports.toMMDD = void 0;
+const pad2 = (n) => String(n).padStart(2, "0");
+/** "MM-DD" for a date, in local time — the format survey slots are stored in. */
+const toMMDD = (date = new Date()) => `${pad2(date.getMonth() + 1)}-${pad2(date.getDate())}`;
+exports.toMMDD = toMMDD;
+/**
+ * Academic years run September→August. Given the year a school year STARTS in
+ * (e.g. 2026 for "2026/27"), return the calendar year the given month falls in:
+ * September–December sit in the start year; January–August roll into the next.
+ */
+const academicCalendarYear = (month, academicStartYear) => month >= 9 ? academicStartYear : academicStartYear + 1;
+exports.academicCalendarYear = academicCalendarYear;
+/**
+ * The academic year a date falls within, as the START year. From September onwards
+ * we are in a new academic year (getMonth() is 0-indexed, so >= 8 is September).
+ * Matches DestinationsSetup.currentStartYear and destinationsStartYear.
+ */
+const currentAcademicStartYear = (date = new Date()) => date.getMonth() >= 8 ? date.getFullYear() : date.getFullYear() - 1;
+exports.currentAcademicStartYear = currentAcademicStartYear;
+/** Hyphen academic-year label from a start year, e.g. 2026 → "2026-27". */
+const academicYearLabel = (startYear) => `${startYear}-${String(startYear + 1).slice(-2)}`;
+exports.academicYearLabel = academicYearLabel;
+/**
+ * The academic-year LABEL for a date, hyphen form (e.g. "2026-27"). Uses the single
+ * 1 September boundary, so it always agrees with currentAcademicStartYear: a date in
+ * August belongs to the academic year that is ending, not the one about to start.
+ */
+const academicYearOf = (date = new Date()) => (0, exports.academicYearLabel)((0, exports.currentAcademicStartYear)(date));
+exports.academicYearOf = academicYearOf;
+/** Slash academic-year label from a start year, e.g. 2026 → "2026/27". The form
+ * legacy leaverGroups and DestinationsConfig.lastProvisionedYear use. */
+const academicYearSlashLabel = (startYear) => `${startYear}/${String(startYear + 1).slice(-2)}`;
+exports.academicYearSlashLabel = academicYearSlashLabel;
+/** Convert either academic-year form to the other's separator, e.g. "2026/27" → "2026-27". */
+const normaliseAcademicYear = (year) => year.replace("/", "-");
+exports.normaliseAcademicYear = normaliseAcademicYear;
+/**
+ * Resolve a rule to a concrete Date in a specific CALENDAR year+month, e.g.
+ * ("first", Monday, June 2027). "last" walks back from the month's final day.
+ */
+const resolveNthWeekday = (calendarYear, month, ordinal, weekday) => {
+    if (ordinal === "last") {
+        const lastDay = new Date(calendarYear, month, 0).getDate(); // day 0 of next month
+        for (let d = lastDay; d >= 1; d--) {
+            const date = new Date(calendarYear, month - 1, d);
+            if (date.getDay() === weekday)
+                return date;
+        }
+        return new Date(calendarYear, month - 1, lastDay);
+    }
+    const nth = { first: 1, second: 2, third: 3, fourth: 4 }[ordinal];
+    let count = 0;
+    const daysInMonth = new Date(calendarYear, month, 0).getDate();
+    for (let d = 1; d <= daysInMonth; d++) {
+        const date = new Date(calendarYear, month - 1, d);
+        if (date.getDay() === weekday && ++count === nth)
+            return date;
+    }
+    // Fewer than `nth` occurrences (e.g. a 5th Monday) — fall back to the last one.
+    return (0, exports.resolveNthWeekday)(calendarYear, month, "last", weekday);
+};
+exports.resolveNthWeekday = resolveNthWeekday;
+/** Resolve a rule to the concrete Date for the academic year starting in academicStartYear. */
+const surveyRuleToDate = (rule, academicStartYear) => (0, exports.resolveNthWeekday)((0, exports.academicCalendarYear)(rule.month, academicStartYear), rule.month, rule.ordinal, rule.weekday);
+exports.surveyRuleToDate = surveyRuleToDate;
+/** Resolve a rule to an "MM-DD" string for the academic year starting in academicStartYear. */
+const surveyRuleToMMDD = (rule, academicStartYear) => {
+    const d = (0, exports.surveyRuleToDate)(rule, academicStartYear);
+    return `${pad2(d.getMonth() + 1)}-${pad2(d.getDate())}`;
+};
+exports.surveyRuleToMMDD = surveyRuleToMMDD;
+/**
+ * "MM-DD" → the ISO datetime it falls on in the given academic year, at 08:00 UTC
+ * (when sends fire). Returns "" for a malformed or non-existent date (e.g. "02-30"),
+ * which callers treat as "skip this slot". Lifted verbatim from aspirations.ts.
+ */
+const mmddToISO = (mmdd, academicStartYear) => {
+    if (!/^\d{2}-\d{2}$/.test(mmdd || ""))
+        return "";
+    const [mm, dd] = mmdd.split("-").map(Number);
+    const year = (0, exports.academicCalendarYear)(mm, academicStartYear);
+    const d = new Date(Date.UTC(year, mm - 1, dd, 8, 0, 0));
+    if (d.getUTCMonth() !== mm - 1 || d.getUTCDate() !== dd)
+        return "";
+    return d.toISOString();
+};
+exports.mmddToISO = mmddToISO;
+/**
+ * The MM-DD a slot fires on in a given academic year. A `rule` is the source of
+ * truth and is re-resolved; a slot with no rule keeps its fixed sendMMDD.
+ */
+const slotMMDDForYear = (slot, academicStartYear) => slot.rule ? (0, exports.surveyRuleToMMDD)(slot.rule, academicStartYear) : slot.sendMMDD;
+exports.slotMMDDForYear = slotMMDDForYear;
+/**
+ * Resolve a year's programme of slots to concrete dates, dropping any whose date
+ * doesn't exist. Replaces the per-caller `refreshSlot` in provisionDueSkillsSurveys
+ * and the inline slot loop in _provisionDestinationsYear.
+ *
+ * Slots are returned in send order. Disabled slots are INCLUDED (with enabled:false)
+ * so provisioning still creates their cycle with autoSend off — staff can see the
+ * survey on the timeline and send it by hand.
+ */
+const resolveSlotsForYear = (slots, academicStartYear) => (slots || [])
+    .map((slot) => {
+    const sendMMDD = (0, exports.slotMMDDForYear)(slot, academicStartYear);
+    return { ...slot, sendMMDD, sendISO: (0, exports.mmddToISO)(sendMMDD, academicStartYear), enabled: slot.enabled !== false };
+})
+    .filter((slot) => Boolean(slot.sendISO))
+    .sort((a, b) => a.sendISO.localeCompare(b.sendISO));
+exports.resolveSlotsForYear = resolveSlotsForYear;
+/**
+ * Is this slot's send day the given date? Compares MM-DD, resolving any rule against
+ * the academic year `date` sits in, which is how the daily crons decide what to fire.
+ *
+ * Deliberately ignores `enabled`: a disabled slot is still "due" (its cycle gets
+ * provisioned) — whether it SENDS is the cycle's autoSend flag, checked by the cron.
+ */
+const isSlotDueOn = (slot, date = new Date()) => (0, exports.slotMMDDForYear)(slot, (0, exports.currentAcademicStartYear)(date)) === (0, exports.toMMDD)(date);
+exports.isSlotDueOn = isSlotDueOn;
+//# sourceMappingURL=schedule.js.map

package/lib/surveys/schedule.js.map

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

package/lib/surveys/schedule.test.d.ts

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

package/lib/surveys/schedule.test.js

@@ -0,0 +1,240 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const registry_1 = require("./registry");
+const schedule_1 = require("./schedule");
+const types_1 = require("./types");
+describe("resolveNthWeekday", () => {
+    // June 2027: 1st is a Tuesday, so Mondays are 7, 14, 21, 28.
+    it("finds the first Monday of a month", () => {
+        expect((0, schedule_1.resolveNthWeekday)(2027, 6, "first", 1).getDate()).toEqual(7);
+    });
+    it("finds the last Monday of a month", () => {
+        expect((0, schedule_1.resolveNthWeekday)(2027, 6, "last", 1).getDate()).toEqual(28);
+    });
+    it("falls back to the last occurrence when there is no nth", () => {
+        // Only four Mondays in June 2027 — a "fourth" resolves to the 28th, and so
+        // must anything asking for more.
+        expect((0, schedule_1.resolveNthWeekday)(2027, 6, "fourth", 1).getDate()).toEqual(28);
+    });
+    it("handles February in a leap year", () => {
+        // Feb 2028 has 29 days; the 29th is a Tuesday, so the last Tuesday is the 29th.
+        expect((0, schedule_1.resolveNthWeekday)(2028, 2, "last", 2).getDate()).toEqual(29);
+    });
+    it("handles February in a non-leap year", () => {
+        // Feb 2027 ends on Sunday the 28th.
+        expect((0, schedule_1.resolveNthWeekday)(2027, 2, "last", 0).getDate()).toEqual(28);
+    });
+});
+describe("academic year boundaries", () => {
+    it("puts autumn months in the start year and spring months in the next", () => {
+        expect((0, schedule_1.academicCalendarYear)(9, 2026)).toEqual(2026);
+        expect((0, schedule_1.academicCalendarYear)(12, 2026)).toEqual(2026);
+        expect((0, schedule_1.academicCalendarYear)(1, 2026)).toEqual(2027);
+        expect((0, schedule_1.academicCalendarYear)(8, 2026)).toEqual(2027);
+    });
+    it("rolls the start year over in September", () => {
+        expect((0, schedule_1.currentAcademicStartYear)(new Date(2026, 7, 31))).toEqual(2025); // 31 Aug
+        expect((0, schedule_1.currentAcademicStartYear)(new Date(2026, 8, 1))).toEqual(2026); // 1 Sep
+    });
+    it("rolls the year LABEL over on the same 1 September boundary", () => {
+        expect((0, schedule_1.academicYearOf)(new Date(2026, 6, 31))).toEqual("2025-26"); // 31 Jul
+        expect((0, schedule_1.academicYearOf)(new Date(2026, 7, 1))).toEqual("2025-26"); // 1 Aug
+        expect((0, schedule_1.academicYearOf)(new Date(2026, 7, 31))).toEqual("2025-26"); // 31 Aug
+        expect((0, schedule_1.academicYearOf)(new Date(2026, 8, 1))).toEqual("2026-27"); // 1 Sep
+        expect((0, schedule_1.academicYearOf)(new Date(2026, 11, 31))).toEqual("2026-27"); // 31 Dec
+    });
+    it("labels every date with the year its start year labels", () => {
+        // The single boundary means these two can never disagree — the property the
+        // pre-engine August/September split broke for August sends.
+        [new Date(2026, 7, 29), new Date(2026, 8, 1), new Date(2027, 0, 15), new Date(2027, 5, 7)]
+            .forEach((date) => expect((0, schedule_1.academicYearOf)(date)).toEqual((0, schedule_1.academicYearLabel)((0, schedule_1.currentAcademicStartYear)(date))));
+    });
+    it("formats both label styles", () => {
+        expect((0, schedule_1.academicYearLabel)(2026)).toEqual("2026-27");
+        expect((0, schedule_1.academicYearSlashLabel)(2026)).toEqual("2026/27");
+        expect((0, schedule_1.normaliseAcademicYear)("2026/27")).toEqual("2026-27");
+        expect((0, schedule_1.normaliseAcademicYear)("2026-27")).toEqual("2026-27");
+    });
+});
+describe("surveyRuleToMMDD", () => {
+    it("resolves a rule into the right calendar year for the academic year", () => {
+        // "first Monday of June" for 2026/27 lands in June 2027.
+        expect((0, schedule_1.surveyRuleToDate)({ ordinal: "first", weekday: 1, month: 6 }, 2026).getFullYear()).toEqual(2027);
+        expect((0, schedule_1.surveyRuleToMMDD)({ ordinal: "first", weekday: 1, month: 6 }, 2026)).toEqual("06-07");
+    });
+    it("keeps an autumn rule inside the start year", () => {
+        // "first Monday of September" for 2026/27 is 7 September 2026.
+        expect((0, schedule_1.surveyRuleToDate)({ ordinal: "first", weekday: 1, month: 9 }, 2026).getFullYear()).toEqual(2026);
+        expect((0, schedule_1.surveyRuleToMMDD)({ ordinal: "first", weekday: 1, month: 9 }, 2026)).toEqual("09-07");
+    });
+    it("zero-pads single-digit months and days", () => {
+        expect((0, schedule_1.surveyRuleToMMDD)({ ordinal: "first", weekday: 5, month: 1 }, 2026)).toEqual("01-01"); // 1 Jan 2027 is a Friday
+    });
+});
+describe("mmddToISO", () => {
+    it("sends at 08:00 UTC on the day", () => {
+        expect((0, schedule_1.mmddToISO)("09-15", 2026)).toEqual("2026-09-15T08:00:00.000Z");
+    });
+    it("crosses the year boundary for spring dates", () => {
+        expect((0, schedule_1.mmddToISO)("06-15", 2026)).toEqual("2027-06-15T08:00:00.000Z");
+    });
+    it("returns empty for dates that don't exist", () => {
+        expect((0, schedule_1.mmddToISO)("02-30", 2026)).toEqual("");
+        expect((0, schedule_1.mmddToISO)("13-01", 2026)).toEqual("");
+        expect((0, schedule_1.mmddToISO)("6-15", 2026)).toEqual("");
+        expect((0, schedule_1.mmddToISO)("", 2026)).toEqual("");
+    });
+    it("accepts 29 February only in a leap year", () => {
+        expect((0, schedule_1.mmddToISO)("02-29", 2027)).toEqual("2028-02-29T08:00:00.000Z");
+        expect((0, schedule_1.mmddToISO)("02-29", 2026)).toEqual("");
+    });
+});
+describe("resolveSlotsForYear", () => {
+    const rule = { rule: { ordinal: "first", weekday: 1, month: 6 }, sendMMDD: "06-01", label: "Summer" };
+    const legacy = { sendMMDD: "10-01", label: "Autumn" };
+    it("re-resolves a rule and leaves a legacy sendMMDD-only slot alone", () => {
+        const [autumn, summer] = (0, schedule_1.resolveSlotsForYear)([rule, legacy], 2026);
+        expect(autumn.sendMMDD).toEqual("10-01");
+        expect(summer.sendMMDD).toEqual("06-07"); // rule wins over the stale 06-01
+    });
+    it("returns slots in send order across the academic year", () => {
+        expect((0, schedule_1.resolveSlotsForYear)([rule, legacy], 2026).map((s) => s.label)).toEqual(["Autumn", "Summer"]);
+    });
+    it("includes disabled slots, flagged", () => {
+        const slots = (0, schedule_1.resolveSlotsForYear)([{ sendMMDD: "10-01", enabled: false }, { sendMMDD: "11-01" }], 2026);
+        expect(slots.map((s) => s.enabled)).toEqual([false, true]);
+    });
+    it("drops slots whose date doesn't exist", () => {
+        expect((0, schedule_1.resolveSlotsForYear)([{ sendMMDD: "02-30" }, { sendMMDD: "11-01" }], 2026)).toHaveLength(1);
+    });
+    it("handles no slots", () => {
+        expect((0, schedule_1.resolveSlotsForYear)(undefined, 2026)).toEqual([]);
+    });
+});
+describe("isSlotDueOn", () => {
+    it("is due on the rule's resolved date, not the stale stored one", () => {
+        const slot = { rule: { ordinal: "first", weekday: 1, month: 6 }, sendMMDD: "06-01" };
+        expect((0, schedule_1.isSlotDueOn)(slot, new Date(2027, 5, 7))).toEqual(true); // 7 Jun 2027
+        expect((0, schedule_1.isSlotDueOn)(slot, new Date(2027, 5, 1))).toEqual(false);
+    });
+    it("is due on a legacy slot's fixed date", () => {
+        expect((0, schedule_1.isSlotDueOn)({ sendMMDD: "10-01" }, new Date(2026, 9, 1))).toEqual(true);
+    });
+    it("ignores `enabled` — a disabled slot is still due, and simply doesn't auto-send", () => {
+        expect((0, schedule_1.isSlotDueOn)({ sendMMDD: "10-01", enabled: false }, new Date(2026, 9, 1))).toEqual(true);
+    });
+    it("agrees with toMMDD", () => {
+        const date = new Date(2026, 8, 3);
+        expect((0, schedule_1.isSlotDueOn)({ sendMMDD: (0, schedule_1.toMMDD)(date) }, date)).toEqual(true);
+    });
+});
+describe("survey registry", () => {
+    it("describes every kind", () => {
+        expect(Object.keys(registry_1.SURVEY_KINDS).sort()).toEqual([...types_1.SURVEY_KINDS_LIST].sort());
+    });
+    it.each(types_1.SURVEY_KINDS_LIST)("%s is fully described", (kind) => {
+        const def = registry_1.SURVEY_KINDS[kind];
+        expect(def.kind).toEqual(kind);
+        expect(def.label).toBeTruthy();
+        expect(["account", "magicLink"]).toContain(def.authMode);
+        expect(["rater", "fallback", "none"]).toContain(def.parentMode);
+        expect(def.raters.students || def.raters.parents || def.raters.employers || def.raters.trustedContact).toEqual(true);
+        expect(def.legacy.collectionLink).toBeTruthy();
+        expect(def.formPath({ kind, requestId: "abc" })).toContain("abc");
+    });
+    it.each(types_1.SURVEY_KINDS_LIST)("%s has invite copy for every rater it asks", (kind) => {
+        const def = registry_1.SURVEY_KINDS[kind];
+        const audiences = [
+            def.raters.students ? "student" : undefined,
+            def.raters.parents ? "parent" : undefined,
+            def.raters.employers ? "employer" : undefined,
+            def.raters.trustedContact ? "trustedContact" : undefined,
+        ].filter(Boolean);
+        const ctx = { instituteName: "Test School", forename: "Sam", studentForename: "Alex", studentSurname: "Doe", surveyLabel: def.label };
+        audiences.forEach((audience) => {
+            const copy = (0, registry_1.surveyEmailCopy)(kind, audience, "invite");
+            expect(copy).toBeDefined();
+            expect(copy?.subject(ctx)).toBeTruthy();
+            expect(copy?.body(ctx)).toBeTruthy();
+            expect(copy?.button).toBeTruthy();
+        });
+    });
+    it("has unique message types across kinds", () => {
+        const all = types_1.SURVEY_KINDS_LIST.flatMap((k) => Object.values(registry_1.SURVEY_KINDS[k].messageTypes));
+        expect(new Set(all).size).toEqual(all.length);
+    });
+    it("orders the leaver thread and supersedes forwards only", () => {
+        expect(registry_1.SURVEY_THREADS.leaver).toEqual(["leaverIntentions", "leaverResults", "leaverChristmas"]);
+        expect((0, registry_1.supersedingSurveyKinds)("leaverIntentions")).toEqual(["leaverResults", "leaverChristmas"]);
+        expect((0, registry_1.supersedingSurveyKinds)("leaverResults")).toEqual(["leaverChristmas"]);
+        expect((0, registry_1.supersedingSurveyKinds)("leaverChristmas")).toEqual([]);
+    });
+    it("derives the same supersession lists the hand-written constants held", () => {
+        // notifications/leavers.ts SUPERSEDES_INTENTIONS / SUPERSEDES_RESULTS.
+        expect((0, registry_1.legacySupersedingMessageTypes)("leaverIntentions")).toEqual([
+            "leaverResultsInvite", "leaverResultsReminder", "leaverChristmasInvite", "leaverChristmasReminder",
+        ]);
+        expect((0, registry_1.legacySupersedingMessageTypes)("leaverResults")).toEqual([
+            "leaverChristmasInvite", "leaverChristmasReminder",
+        ]);
+        expect((0, registry_1.legacySupersedingMessageTypes)("leaverChristmas")).toEqual([]);
+    });
+    it("supersedes nothing for kinds outside a thread", () => {
+        expect((0, registry_1.supersedingMessageTypes)("aspirations")).toEqual([]);
+        expect((0, registry_1.supersedingMessageTypes)("skills")).toEqual([]);
+        expect((0, registry_1.supersedingMessageTypes)("alumniCheckIn")).toEqual([]);
+    });
+    it("gives thread kinds new-format supersession lists too", () => {
+        expect((0, registry_1.supersedingMessageTypes)("leaverResults")).toEqual([
+            "surveyLeaverChristmasInvite", "surveyLeaverChristmasReminder",
+        ]);
+    });
+    it("keeps the migrated wording of the emails it replaces", () => {
+        const ctx = { instituteName: "Test School", forename: "Sam" };
+        expect((0, registry_1.surveyEmailCopy)("aspirations", "student", "invite")?.subject(ctx))
+            .toEqual("Test School — share your career aspirations");
+        expect((0, registry_1.surveyEmailCopy)("leaverIntentions", "student", "invite")?.subject(ctx))
+            .toEqual("Test School — tell us your next step");
+        expect((0, registry_1.surveyEmailCopy)("leaverResults", "student", "invite")?.title(ctx))
+            .toEqual("Congratulations on finishing!");
+        expect((0, registry_1.surveyEmailCopy)("leaverChristmas", "student", "invite")?.button).toEqual("Quick check-in");
+        expect((0, registry_1.surveyEmailCopy)("alumniCheckIn", "student", "invite")?.secondaryButton?.title)
+            .toEqual("I'm in the same place");
+        expect((0, registry_1.surveyEmailCopy)("skills", "student", "invite")?.subject(ctx))
+            .toEqual("[Action Required] Complete Skills Assessment");
+    });
+    it("has no reminder for the kinds that never sent one", () => {
+        expect((0, registry_1.surveyEmailCopy)("skills", "student", "reminder")).toBeUndefined();
+        expect((0, registry_1.surveyEmailCopy)("alumniCheckIn", "student", "reminder")).toBeUndefined();
+        expect(registry_1.SURVEY_KINDS.skills.reminderAfterDays).toBeUndefined();
+        expect(registry_1.SURVEY_KINDS.alumniCheckIn.reminderAfterDays).toBeUndefined();
+    });
+    it("keeps today's reminder cadences", () => {
+        expect(registry_1.SURVEY_KINDS.aspirations.reminderAfterDays).toEqual(14);
+        expect(registry_1.SURVEY_KINDS.leaverIntentions.reminderAfterDays).toEqual(14);
+        expect(registry_1.SURVEY_KINDS.leaverResults.reminderAfterDays).toEqual(7);
+        expect(registry_1.SURVEY_KINDS.leaverChristmas.reminderAfterDays).toEqual(7);
+    });
+    it("falls back to the shared parent template only for parent raters", () => {
+        expect((0, registry_1.surveyEmailCopy)("aspirations", "parent", "invite")?.button).toEqual("Complete the form");
+        // Skills overrides it with its own pre-existing wording.
+        expect((0, registry_1.surveyEmailCopy)("skills", "parent", "invite")?.button).toEqual("Complete Assessment");
+        // Alumni check-ins contact the trusted contact as a fallback, never as a rater.
+        expect((0, registry_1.surveyEmailCopy)("alumniCheckIn", "parent", "invite")).toBeUndefined();
+    });
+    it("builds the legacy URLs live emails already point at", () => {
+        expect(registry_1.SURVEY_KINDS.aspirations.legacyFormPath?.({ kind: "aspirations", requestId: "r1" }))
+            .toEqual("/app/destinations/students/form/r1");
+        expect(registry_1.SURVEY_KINDS.leaverIntentions.legacyFormPath?.({ kind: "leaverIntentions", requestId: "r1" }))
+            .toEqual("/institutes/leaver/r1");
+        expect(registry_1.SURVEY_KINDS.leaverResults.legacyFormPath?.({ kind: "leaverResults", requestId: "r1", token: "t1" }))
+            .toEqual("/leaverCheckpoint/r1/resultsDay/t1");
+        expect(registry_1.SURVEY_KINDS.alumniCheckIn.legacyFormPath?.({ kind: "alumniCheckIn", requestId: "r1", alumniId: "a1", token: "t1" }))
+            .toEqual("/alumniCheckIn/a1/t1");
+        expect(registry_1.SURVEY_KINDS.skills.legacyFormPath?.({ kind: "skills", requestId: "r1", rater: "students", assessmentId: "s1" }))
+            .toEqual("/institutes/skills/s1");
+        expect(registry_1.SURVEY_KINDS.skills.legacyFormPath?.({ kind: "skills", requestId: "r1", rater: "parents", oId: "o1", assessmentId: "s1", externalKey: "k1" }))
+            .toEqual("/skillsRequest/o1/s1/k1");
+    });
+});
+//# sourceMappingURL=schedule.test.js.map

package/lib/surveys/schedule.test.js.map

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

package/lib/surveys/types.d.ts

@@ -0,0 +1,204 @@
+/**
+ * surveys/types.ts — the unified survey engine's data model.
+ *
+ * One shape for every student/alumni survey CareerThread sends: skills surveys,
+ * careers aspiration surveys (Form A), leaver transition forms + their post-leaving
+ * checkpoints (Form B), and annual alumni check-ins. Each is a `SurveyKind`; the
+ * behavioural differences between them live in the registry (./registry), not in
+ * the data model.
+ *
+ * Firestore:
+ *   surveyCycles/{cycleId}    — one scheduled SEND to one cohort
+ *   surveyRequests/{requestId} — one PERSON inside one cycle
+ *
+ * These supersede aspirationCycles/aspirationRequests, leaverGroups/leaverRequests,
+ * skillsAssessmentRequests, and the per-Alumni check-in fields. Migration mapping is
+ * documented per field below and in SURVEY_UNIFICATION_PLAN.md §3.2.
+ */
+import type { SurveyDateRule } from "../typeDefinitions";
+/**
+ * The six survey kinds the engine serves. The three leaver kinds are separate
+ * kinds that share a `threadKey`, so a leaver's journey is three cycles/requests
+ * rather than one request doc with inline checkpoint state.
+ */
+export type SurveyKind = "skills" | "aspirations" | "leaverIntentions" | "leaverResults" | "leaverChristmas" | "alumniCheckIn";
+/** Every SurveyKind as a runtime array — for iteration, validation and registry tests. */
+export declare const SURVEY_KINDS_LIST: SurveyKind[];
+/** Who can answer a survey. Mirrors SkillRater plus the alumni trusted-contact fallback. */
+export type SurveyRaterType = "students" | "parents" | "employers" | "trustedContact";
+/** Which rater tracks a cycle asks for. Replaces SkillAssessmentRequest's
+ * requestStudents/requestParents/requestEmployers trio and carries a slot's
+ * `parents` toggle onto the cycle it provisions. */
+export type SurveyRaters = {
+    students?: boolean;
+    parents?: boolean;
+    employers?: boolean;
+};
+/**
+ * One scheduled survey in an annual programme — the unified replacement for
+ * SkillsSurveySlot and AspirationSurveySlot (both are now aliases of this).
+ *
+ * `rule` (when present) is the source of truth: a relative rule like "first Monday
+ * of June", resolved to a concrete date for each academic year at provision time.
+ * `sendMMDD` ("MM-DD") is the materialised date for the current academic year, and
+ * the sole value on legacy slots created before rules existed; provisioning keeps it
+ * in step with `rule`.
+ */
+export type SurveySlot = {
+    sendMMDD: string;
+    rule?: SurveyDateRule;
+    label?: string;
+    /** Ask the student themselves. Absent = true (legacy aspiration slots had no flags). */
+    students?: boolean;
+    /** Ask the parent as well. Available on every kind whose registry entry allows a parent rater. */
+    parents?: boolean;
+    /** The per-survey auto-send switch. Absent = enabled; false means the cron
+     * provisions/keeps the cycle but never sends it without staff action. */
+    enabled?: boolean;
+};
+export type SurveyCycleStatus = "draft" | "scheduled" | "sending" | "active" | "closed";
+export type SurveyRequestStatus = "pending" | "sent" | "completed" | "bounced";
+/** Who submitted a response, as passed to submitSurveyResponse. */
+export type SurveySubmittedBy = "student" | "parent" | "employer" | "staff" | "trustedContact";
+/**
+ * One send to one cohort — AspirationCycle generalised across kinds.
+ *
+ * Legacy status mapping: LeaverGroup.stage "created"/"review" → "draft",
+ * "scheduled" → "scheduled", "sent" → "active", "archived" → "closed";
+ * SkillAssessmentRequest.status "draft"/"scheduled" map directly and "sent" → "active".
+ *
+ * Stored in collection: surveyCycles
+ */
+export type SurveyCycle = {
+    oId: string;
+    kind: SurveyKind;
+    /** e.g. "2026-27". Always the hyphen form here — see academicYearOf in ./schedule.
+     * Legacy leaverGroups used the slash form ("2026/27") and are converted on migration. */
+    academicYear: string;
+    /** The single year group this cycle targets. Absent for alumni check-in cycles,
+     * which are institute-wide. Replaces AspirationCycle.yearGroupsIncluded. */
+    yearGroup?: number;
+    /** SkillsMapping.id ("all" for the All students group) — skills cycles only. */
+    groupId?: string;
+    /** Chains the cycles of one journey: the three leaver kinds for a cohort share
+     * one threadKey (the pre-migration leaverGroups id). Also the supersession key. */
+    threadKey?: string;
+    status: SurveyCycleStatus;
+    /** Staff-facing name. From SkillAssessmentRequest.title / LeaverGroup.title;
+     * derived from the kind label + slot label for cycles that had none. */
+    title?: string;
+    description?: string;
+    /** ISO datetime — when invites fire. */
+    scheduledSendDate: string;
+    /** ISO datetime — form links expire. Defaults to scheduledSendDate + closeAfterDays. */
+    closeDate?: string;
+    /** Default 21. */
+    closeAfterDays?: number;
+    /** False = the cron never sends this cycle; staff must press send. Set from the
+     * provisioning slot's `enabled` flag and toggled by setSurveyAutoSend. */
+    autoSend: boolean;
+    /** Which rater tracks this cycle asks for. Absent = students only. */
+    raters?: SurveyRaters;
+    /** ISO — staff heads-up guards, so each fires at most once per cycle. */
+    headsUp7SentAt?: string;
+    headsUp1SentAt?: string;
+    /** ISO — when invites actually fired. */
+    sentAt?: string;
+    closedAt?: string;
+    /** ISO — day-N reminder fire time. */
+    reminderSentAt?: string;
+    /** Count at send time. */
+    totalInvited: number;
+    /** Incremented on each completion. */
+    totalResponded: number;
+    /** Staff uid, or "system" for cron-provisioned cycles. */
+    createdBy: string;
+    createdAt: string;
+    /** Optional custom email template; falls back to the registry copy. */
+    emailTemplateId?: string;
+    /** JSON-serialised DataViewerSelectionBackend — the staff-picked recipients, or
+     * the rule to re-resolve them at send. Was `studentSelection` on AspirationCycle
+     * and `students` on SkillAssessmentRequest / LeaverGroup. */
+    studentSelection?: string;
+    /** True on auto-provisioned cycles — requests are fanned out from studentSelection
+     * when emails fire, not at creation, so the cohort tracks the live roster. */
+    resolveRecipientsAtSend?: boolean;
+    /** Created by surveyCron from institute config rather than by staff. */
+    autoProvisioned?: boolean;
+    /** Pre-aggregated response data for the dashboard: AspirationAggregates,
+     * LeaverAggregates or a kind-specific shape. Typed per kind by the engine's
+     * handler map — the aggregate shapes themselves are unchanged. */
+    aggregates?: unknown;
+    /** Kind-specific cycle settings that don't generalise, e.g. leaverIntentions'
+     * allStudentsLeave or a skills cycle's group name. Read only by that kind's handler. */
+    kindConfig?: {
+        [key: string]: unknown;
+    };
+};
+/**
+ * One person inside one cycle — AspirationRequest generalised, with the leaver
+ * magic-link fields and a parent track folded in.
+ *
+ * `status`/`completed` are the STUDENT (or, for alumniCheckIn, the alumnus's) track.
+ * `completed` stays a denormalised boolean so the compound queries and Algolia
+ * facets the staff pages rely on keep working unchanged.
+ *
+ * Skills employer raters are NOT mirrored here: per plan decision D4 they remain
+ * tracked solely as skillAssessments docs, which stay the skills response store.
+ *
+ * Stored in collection: surveyRequests
+ */
+export type SurveyRequest = {
+    oId: string;
+    cycleId: string;
+    kind: SurveyKind;
+    academicYear: string;
+    /** Student uid — matched against context.auth.uid on account-auth kinds.
+     * Absent on alumniCheckIn requests for alumni with no linked account. */
+    uid?: string;
+    /** alumni/{alumniId} — set on alumniCheckIn requests, and on leaver requests
+     * once the leaver opted in and an Alumni record was created. */
+    alumniId?: string;
+    /** Copied from the cycle so a request can be resolved without reading it. */
+    threadKey?: string;
+    /** MIS school ID. */
+    schoolId?: string;
+    forename: string;
+    /** Optional — legacy requests predate this field. */
+    surname?: string;
+    email: string;
+    /** Post-leaving contact address; where invites go once the school email dies. */
+    personalEmail?: string;
+    yearGroup?: number;
+    status: SurveyRequestStatus;
+    completed: boolean;
+    /** ISO — when the invite was emailed. */
+    sentAt?: string;
+    completedAt?: string;
+    /** ISO — staff manual resend guard (1 resend/hour). */
+    lastResentAt?: string;
+    /** Magic-link auth for kinds whose registry authMode is "magicLink".
+     * Alumni linkCode/linkCodeExpiry migrate onto these fields. */
+    token?: string;
+    tokenExpiry?: string;
+    /** The kind's response payload: AspirationEntry, LeaverTransitionData,
+     * LeaverCheckpointResponse, CheckInEntry, or a skills score map. Left unknown
+     * here so core stays free of per-kind unions; narrowed by the kind's handler. */
+    response?: unknown;
+    /** True when a staff member submitted on the person's behalf. */
+    completedByStaff?: boolean;
+    completedByStaffId?: string;
+    /** Set when a newer survey to this person made chasing this one pointless
+     * (plan decision D8). Reminders stop; the staff timeline renders it "skipped". */
+    supersededAt?: string;
+    supersededByCycleId?: string;
+    parentEmail?: string;
+    parentStatus?: SurveyRequestStatus;
+    parentCompleted?: boolean;
+    parentSentAt?: string;
+    parentCompletedAt?: string;
+    parentResponse?: unknown;
+    /** Magic-link token for the parent's copy of the form — parents never have accounts. */
+    parentToken?: string;
+    parentTokenExpiry?: string;
+};