placementt-core 1.400.1079 → 1.400.1081

package/lib/activityLogging.d.ts

@@ -0,0 +1,67 @@
+import { ActivityLoggingConfig, InstituteData } from "./typeDefinitions";
+/**
+ * Whether a student can log activities, and whether we may email them about it.
+ *
+ * Two different switches are easy to confuse here, so they are named apart:
+ *
+ * - `trackExtracurriculars` is the PRODUCT. Absent means on, which is right for
+ *   staff: a school that has never touched the switch still gets the Activities
+ *   area, its analytics and its Gatsby reporting.
+ * - `activityLogging` is the LAUNCH. It is what a school says to its students, and
+ *   absent means nothing has been said. A feature that appears in a pupil's account
+ *   unannounced gets used by nobody and asked about by everybody, so a year group
+ *   sees activity logging only once the school has launched it to them.
+ *
+ * The launch is per year group and, unless the school says otherwise, per academic
+ * year: last year's Year 11 is not this year's Year 11, and a school introducing it
+ * to each new cohort in assembly should not find it already live.
+ */
+/** Does the school have the Activities area at all? Absent means yes. */
+export declare const activityLoggingProductOn: (institute?: Pick<InstituteData, "trackExtracurriculars">) => boolean;
+/**
+ * Does the stored launch still count today?
+ *
+ * A launch is made for one academic year. With `rollOver` on it carries forward
+ * forever; without it, September spends it.
+ *
+ * @param {ActivityLoggingConfig} [config] the school's launch.
+ * @param {Date} [now] the date to judge it against.
+ * @return {boolean} whether the year groups below are live.
+ */
+export declare const activityLaunchCurrent: (config?: ActivityLoggingConfig, now?: Date) => boolean;
+/**
+ * The year groups activity logging is live for right now.
+ *
+ * @param {InstituteData} [institute] the school.
+ * @param {Date} [now] the date to judge the launch against.
+ * @return {string[]} the year group tags, empty when nothing is live.
+ */
+export declare const activityLoggingLiveYearGroups: (institute?: InstituteData, now?: Date) => string[];
+/**
+ * Can THIS student log activities, and may we email them about it?
+ *
+ * The one gate every student-facing surface asks. A student with no year group on
+ * their record is not in a launched year group, so the answer is no — which is the
+ * safe way round: they see nothing rather than being shown something their school
+ * hasn't announced.
+ *
+ * @param {InstituteData} [institute] their school.
+ * @param {string} [yearGroup] their year group tag, as their record holds it.
+ * @param {Date} [now] the date to judge the launch against.
+ * @return {boolean} whether activity logging is live for them.
+ */
+export declare const activityLoggingLive: (institute?: InstituteData, yearGroup?: string, now?: Date) => boolean;
+/** Where a school's activity logging stands, in the vocabulary the careers year
+ * setup uses for every other programme. */
+export type ActivityLoggingState = "unconfigured" | "needsLaunch" | "live";
+/**
+ * Has this school launched activity logging, and does the launch still stand?
+ *
+ * The three answers are the three different things to do about it: ask the setup
+ * questions, re-launch a year that has rolled over, or nothing.
+ *
+ * @param {InstituteData} [institute] the school.
+ * @param {Date} [now] the date to judge the launch against.
+ * @return {ActivityLoggingState} what is left to do.
+ */
+export declare const activityLoggingState: (institute?: InstituteData, now?: Date) => ActivityLoggingState;

package/lib/activityLogging.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.activityLoggingState = exports.activityLoggingLive = exports.activityLoggingLiveYearGroups = exports.activityLaunchCurrent = exports.activityLoggingProductOn = void 0;
+const schedule_1 = require("./surveys/schedule");
+/**
+ * Whether a student can log activities, and whether we may email them about it.
+ *
+ * Two different switches are easy to confuse here, so they are named apart:
+ *
+ * - `trackExtracurriculars` is the PRODUCT. Absent means on, which is right for
+ *   staff: a school that has never touched the switch still gets the Activities
+ *   area, its analytics and its Gatsby reporting.
+ * - `activityLogging` is the LAUNCH. It is what a school says to its students, and
+ *   absent means nothing has been said. A feature that appears in a pupil's account
+ *   unannounced gets used by nobody and asked about by everybody, so a year group
+ *   sees activity logging only once the school has launched it to them.
+ *
+ * The launch is per year group and, unless the school says otherwise, per academic
+ * year: last year's Year 11 is not this year's Year 11, and a school introducing it
+ * to each new cohort in assembly should not find it already live.
+ */
+/** Does the school have the Activities area at all? Absent means yes. */
+const activityLoggingProductOn = (institute) => institute?.trackExtracurriculars !== false;
+exports.activityLoggingProductOn = activityLoggingProductOn;
+/**
+ * Does the stored launch still count today?
+ *
+ * A launch is made for one academic year. With `rollOver` on it carries forward
+ * forever; without it, September spends it.
+ *
+ * @param {ActivityLoggingConfig} [config] the school's launch.
+ * @param {Date} [now] the date to judge it against.
+ * @return {boolean} whether the year groups below are live.
+ */
+const activityLaunchCurrent = (config, now = new Date()) => {
+    if (!config?.launchedYear)
+        return false;
+    return Boolean(config.rollOver) || config.launchedYear === (0, schedule_1.academicYearOf)(now);
+};
+exports.activityLaunchCurrent = activityLaunchCurrent;
+/**
+ * The year groups activity logging is live for right now.
+ *
+ * @param {InstituteData} [institute] the school.
+ * @param {Date} [now] the date to judge the launch against.
+ * @return {string[]} the year group tags, empty when nothing is live.
+ */
+const activityLoggingLiveYearGroups = (institute, now = new Date()) => {
+    if (!(0, exports.activityLoggingProductOn)(institute))
+        return [];
+    const config = institute?.activityLogging;
+    if (!(0, exports.activityLaunchCurrent)(config, now))
+        return [];
+    return Object.entries(config?.yearGroups || {}).filter(([, on]) => on).map(([yg]) => yg);
+};
+exports.activityLoggingLiveYearGroups = activityLoggingLiveYearGroups;
+/**
+ * Can THIS student log activities, and may we email them about it?
+ *
+ * The one gate every student-facing surface asks. A student with no year group on
+ * their record is not in a launched year group, so the answer is no — which is the
+ * safe way round: they see nothing rather than being shown something their school
+ * hasn't announced.
+ *
+ * @param {InstituteData} [institute] their school.
+ * @param {string} [yearGroup] their year group tag, as their record holds it.
+ * @param {Date} [now] the date to judge the launch against.
+ * @return {boolean} whether activity logging is live for them.
+ */
+const activityLoggingLive = (institute, yearGroup, now = new Date()) => {
+    if (!yearGroup)
+        return false;
+    if (!(0, exports.activityLoggingProductOn)(institute))
+        return false;
+    const config = institute?.activityLogging;
+    if (!(0, exports.activityLaunchCurrent)(config, now))
+        return false;
+    return config?.yearGroups?.[yearGroup] === true;
+};
+exports.activityLoggingLive = activityLoggingLive;
+/**
+ * Has this school launched activity logging, and does the launch still stand?
+ *
+ * The three answers are the three different things to do about it: ask the setup
+ * questions, re-launch a year that has rolled over, or nothing.
+ *
+ * @param {InstituteData} [institute] the school.
+ * @param {Date} [now] the date to judge the launch against.
+ * @return {ActivityLoggingState} what is left to do.
+ */
+const activityLoggingState = (institute, now = new Date()) => {
+    const config = institute?.activityLogging;
+    // Never answered, or answered and launched to nobody — both leave a school with
+    // the questions still to answer.
+    if (!config?.setupCompletedAt || !Object.values(config.yearGroups || {}).some(Boolean))
+        return "unconfigured";
+    if ((0, exports.activityLoggingLiveYearGroups)(institute, now).length)
+        return "live";
+    return "needsLaunch";
+};
+exports.activityLoggingState = activityLoggingState;
+//# sourceMappingURL=activityLogging.js.map

package/lib/activityLogging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activityLogging.js","sourceRoot":"","sources":["../src/activityLogging.ts"],"names":[],"mappings":";;;AACA,iDAAkD;AAElD;;;;;;;;;;;;;;;;GAgBG;AAEH,yEAAyE;AAClE,MAAM,wBAAwB,GAAG,CAAC,SAAwD,EAAW,EAAE,CAC1G,SAAS,EAAE,qBAAqB,KAAK,KAAK,CAAC;AADlC,QAAA,wBAAwB,4BACU;AAE/C;;;;;;;;;GASG;AACI,MAAM,qBAAqB,GAAG,CAAC,MAA8B,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE,EAAW,EAAE;IAC/F,IAAI,CAAC,MAAM,EAAE,YAAY;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,YAAY,KAAK,IAAA,yBAAc,EAAC,GAAG,CAAC,CAAC;AACnF,CAAC,CAAC;AAHW,QAAA,qBAAqB,yBAGhC;AAEF;;;;;;GAMG;AACI,MAAM,6BAA6B,GAAG,CAAC,SAAyB,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE,EAAY,EAAE;IACnG,IAAI,CAAC,IAAA,gCAAwB,EAAC,SAAS,CAAC;QAAE,OAAO,EAAE,CAAC;IACpD,MAAM,MAAM,GAAG,SAAS,EAAE,eAAe,CAAC;IAC1C,IAAI,CAAC,IAAA,6BAAqB,EAAC,MAAM,EAAE,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACnD,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;AAC7F,CAAC,CAAC;AALW,QAAA,6BAA6B,iCAKxC;AAEF;;;;;;;;;;;;GAYG;AACI,MAAM,mBAAmB,GAAG,CAAC,SAAyB,EAAE,SAAkB,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE,EAAW,EAAE;IAC5G,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7B,IAAI,CAAC,IAAA,gCAAwB,EAAC,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC;IACvD,MAAM,MAAM,GAAG,SAAS,EAAE,eAAe,CAAC;IAC1C,IAAI,CAAC,IAAA,6BAAqB,EAAC,MAAM,EAAE,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACtD,OAAO,MAAM,EAAE,UAAU,EAAE,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;AACpD,CAAC,CAAC;AANW,QAAA,mBAAmB,uBAM9B;AAMF;;;;;;;;;GASG;AACI,MAAM,oBAAoB,GAAG,CAAC,SAAyB,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE,EAAwB,EAAE;IACtG,MAAM,MAAM,GAAG,SAAS,EAAE,eAAe,CAAC;IAC1C,gFAAgF;IAChF,iCAAiC;IACjC,IAAI,CAAC,MAAM,EAAE,gBAAgB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,cAAc,CAAC;IAC9G,IAAI,IAAA,qCAA6B,EAAC,SAAS,EAAE,GAAG,CAAC,CAAC,MAAM;QAAE,OAAO,MAAM,CAAC;IACxE,OAAO,aAAa,CAAC;AACzB,CAAC,CAAC;AAPW,QAAA,oBAAoB,wBAO/B"}

package/lib/activityLogging.test.d.ts

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

package/lib/activityLogging.test.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const activityLogging_1 = require("./activityLogging");
+// 1 September is the academic-year boundary the whole platform uses, so a launch
+// made in one year is spent the moment the next one starts.
+const IN_2026_27 = new Date("2026-10-01T09:00:00Z");
+const IN_2027_28 = new Date("2027-10-01T09:00:00Z");
+// The August before 2026-27 starts: still the 2025-26 academic year.
+const AUGUST_2026 = new Date("2026-08-20T09:00:00Z");
+const school = (overrides = {}) => ({
+    name: "Calder Park Academy",
+    ...overrides,
+});
+const launched = (yearGroups, extra = {}) => school({ activityLogging: {
+        setupCompletedAt: "2026-09-02T10:00:00Z",
+        launchedYear: "2026-27",
+        yearGroups,
+        ...extra,
+    } });
+describe("activityLoggingProductOn", () => {
+    it("is on when the flag is absent, because staff have the area by default", () => {
+        expect((0, activityLogging_1.activityLoggingProductOn)(school())).toBe(true);
+    });
+    it("is on when explicitly true", () => {
+        expect((0, activityLogging_1.activityLoggingProductOn)(school({ trackExtracurriculars: true }))).toBe(true);
+    });
+    it("is off only when explicitly false", () => {
+        expect((0, activityLogging_1.activityLoggingProductOn)(school({ trackExtracurriculars: false }))).toBe(false);
+    });
+});
+describe("activityLaunchCurrent", () => {
+    it("is false with nothing launched", () => {
+        expect((0, activityLogging_1.activityLaunchCurrent)(undefined, IN_2026_27)).toBe(false);
+        expect((0, activityLogging_1.activityLaunchCurrent)({ yearGroups: { "Year 12": true } }, IN_2026_27)).toBe(false);
+    });
+    it("holds within the year it was launched for", () => {
+        expect((0, activityLogging_1.activityLaunchCurrent)({ launchedYear: "2026-27" }, IN_2026_27)).toBe(true);
+    });
+    it("is spent by the next academic year", () => {
+        expect((0, activityLogging_1.activityLaunchCurrent)({ launchedYear: "2026-27" }, IN_2027_28)).toBe(false);
+    });
+    it("carries forward when the school asked it to", () => {
+        expect((0, activityLogging_1.activityLaunchCurrent)({ launchedYear: "2026-27", rollOver: true }, IN_2027_28)).toBe(true);
+    });
+    it("counts August as the year that is ending, not the one about to start", () => {
+        expect((0, activityLogging_1.activityLaunchCurrent)({ launchedYear: "2025-26" }, AUGUST_2026)).toBe(true);
+        expect((0, activityLogging_1.activityLaunchCurrent)({ launchedYear: "2026-27" }, AUGUST_2026)).toBe(false);
+    });
+});
+describe("activityLoggingLive", () => {
+    it("is live for a launched year group", () => {
+        expect((0, activityLogging_1.activityLoggingLive)(launched({ "Year 12": true }), "Year 12", IN_2026_27)).toBe(true);
+    });
+    it("is not live for a year group left out of the launch", () => {
+        expect((0, activityLogging_1.activityLoggingLive)(launched({ "Year 12": true }), "Year 9", IN_2026_27)).toBe(false);
+    });
+    it("is not live for a year group switched off", () => {
+        expect((0, activityLogging_1.activityLoggingLive)(launched({ "Year 12": false }), "Year 12", IN_2026_27)).toBe(false);
+    });
+    it("is not live for a student with no year group on their record", () => {
+        expect((0, activityLogging_1.activityLoggingLive)(launched({ "Year 12": true }), undefined, IN_2026_27)).toBe(false);
+    });
+    it("stops at the new academic year unless the launch rolls over", () => {
+        expect((0, activityLogging_1.activityLoggingLive)(launched({ "Year 12": true }), "Year 12", IN_2027_28)).toBe(false);
+        expect((0, activityLogging_1.activityLoggingLive)(launched({ "Year 12": true }, { rollOver: true }), "Year 12", IN_2027_28)).toBe(true);
+    });
+    it("is never live when the product itself is off, whatever the launch says", () => {
+        const off = launched({ "Year 12": true });
+        off.trackExtracurriculars = false;
+        expect((0, activityLogging_1.activityLoggingLive)(off, "Year 12", IN_2026_27)).toBe(false);
+    });
+    it("matches the school's own year tag verbatim rather than normalising it", () => {
+        expect((0, activityLogging_1.activityLoggingLive)(launched({ "Yr 12 (KS5)": true }), "Yr 12 (KS5)", IN_2026_27)).toBe(true);
+        expect((0, activityLogging_1.activityLoggingLive)(launched({ "Yr 12 (KS5)": true }), "Year 12", IN_2026_27)).toBe(false);
+    });
+});
+describe("activityLoggingLiveYearGroups", () => {
+    it("lists only the year groups switched on", () => {
+        expect((0, activityLogging_1.activityLoggingLiveYearGroups)(launched({ "Year 9": true, "Year 10": false, "Year 12": true }), IN_2026_27))
+            .toEqual(["Year 9", "Year 12"]);
+    });
+    it("is empty once the launch is spent", () => {
+        expect((0, activityLogging_1.activityLoggingLiveYearGroups)(launched({ "Year 9": true }), IN_2027_28)).toEqual([]);
+    });
+});
+describe("activityLoggingState", () => {
+    it("is unconfigured before the school has answered the setup", () => {
+        expect((0, activityLogging_1.activityLoggingState)(school(), IN_2026_27)).toBe("unconfigured");
+    });
+    it("is unconfigured when setup was answered but nobody was launched to", () => {
+        expect((0, activityLogging_1.activityLoggingState)(launched({ "Year 9": false }), IN_2026_27)).toBe("unconfigured");
+    });
+    it("is live while a launch stands", () => {
+        expect((0, activityLogging_1.activityLoggingState)(launched({ "Year 9": true }), IN_2026_27)).toBe("live");
+    });
+    it("asks for a new launch once the year has rolled over", () => {
+        expect((0, activityLogging_1.activityLoggingState)(launched({ "Year 9": true }), IN_2027_28)).toBe("needsLaunch");
+    });
+    it("stays live across years when the school said it should", () => {
+        expect((0, activityLogging_1.activityLoggingState)(launched({ "Year 9": true }, { rollOver: true }), IN_2027_28)).toBe("live");
+    });
+});
+//# sourceMappingURL=activityLogging.test.js.map

package/lib/activityLogging.test.js.map

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

package/lib/callables/activityLogging.d.ts

@@ -0,0 +1,58 @@
+import { z } from "zod";
+/**
+ * Contract for launching activity logging to students
+ * (`Placementt-Backend/functions/src/activityLogging.ts`).
+ *
+ * Launching is a callable rather than a client write for one reason: it emails
+ * pupils. Which year groups a school has told about activity logging decides who
+ * gets that email, so the list and the send have to be the same act, checked in one
+ * place — a client that could write the year groups itself could mail a school's
+ * whole roll by editing one document.
+ */
+export declare const activityLoggingCallables: {
+    "activityLogging-launchActivityLogging": {
+        request: z.ZodObject<{
+            oId: z.ZodString;
+            /** Every year group tag the school wants live, exactly as its MIS writes
+             * them. The stored map is replaced by this list, so a tag left out is a
+             * year group switched off. */
+            yearGroups: z.ZodArray<z.ZodString, "many">;
+            /** Whether the launch carries into each new academic year, or has to be
+             * made again every September. */
+            rollOver: z.ZodOptional<z.ZodBoolean>;
+            /** Skip the announcement email. For a school switching a year group off,
+             * correcting a tag, or turning rollOver on and off — none of which is
+             * news a pupil needs. Newly launched year groups are emailed otherwise. */
+            silent: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            oId: string;
+            yearGroups: string[];
+            silent?: boolean | undefined;
+            rollOver?: boolean | undefined;
+        }, {
+            oId: string;
+            yearGroups: string[];
+            silent?: boolean | undefined;
+            rollOver?: boolean | undefined;
+        }>;
+        response: z.ZodObject<{
+            launched: z.ZodBoolean;
+            academicYear: z.ZodString;
+            /** Year groups live after this call. */
+            yearGroups: z.ZodArray<z.ZodString, "many">;
+            /** How many students were emailed. Zero on a silent launch, and on one
+             * that only switched year groups off. */
+            emailed: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            yearGroups: string[];
+            academicYear: string;
+            launched: boolean;
+            emailed: number;
+        }, {
+            yearGroups: string[];
+            academicYear: string;
+            launched: boolean;
+            emailed: number;
+        }>;
+    };
+};

package/lib/callables/activityLogging.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.activityLoggingCallables = void 0;
+const zod_1 = require("zod");
+/**
+ * Contract for launching activity logging to students
+ * (`Placementt-Backend/functions/src/activityLogging.ts`).
+ *
+ * Launching is a callable rather than a client write for one reason: it emails
+ * pupils. Which year groups a school has told about activity logging decides who
+ * gets that email, so the list and the send have to be the same act, checked in one
+ * place — a client that could write the year groups itself could mail a school's
+ * whole roll by editing one document.
+ */
+exports.activityLoggingCallables = {
+    "activityLogging-launchActivityLogging": {
+        request: zod_1.z.object({
+            oId: zod_1.z.string(),
+            /** Every year group tag the school wants live, exactly as its MIS writes
+             * them. The stored map is replaced by this list, so a tag left out is a
+             * year group switched off. */
+            yearGroups: zod_1.z.array(zod_1.z.string()),
+            /** Whether the launch carries into each new academic year, or has to be
+             * made again every September. */
+            rollOver: zod_1.z.boolean().optional(),
+            /** Skip the announcement email. For a school switching a year group off,
+             * correcting a tag, or turning rollOver on and off — none of which is
+             * news a pupil needs. Newly launched year groups are emailed otherwise. */
+            silent: zod_1.z.boolean().optional(),
+        }),
+        response: zod_1.z.object({
+            launched: zod_1.z.boolean(),
+            academicYear: zod_1.z.string(),
+            /** Year groups live after this call. */
+            yearGroups: zod_1.z.array(zod_1.z.string()),
+            /** How many students were emailed. Zero on a silent launch, and on one
+             * that only switched year groups off. */
+            emailed: zod_1.z.number(),
+        }),
+    },
+};
+//# sourceMappingURL=activityLogging.js.map

package/lib/callables/activityLogging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activityLogging.js","sourceRoot":"","sources":["../../src/callables/activityLogging.ts"],"names":[],"mappings":";;;AAAA,6BAAsB;AAGtB;;;;;;;;;GASG;AACU,QAAA,wBAAwB,GAAG;IACpC,uCAAuC,EAAE;QACrC,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC;YACd,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;YACf;;0CAE8B;YAC9B,UAAU,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;YAC/B;6CACiC;YACjC,QAAQ,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YAChC;;uFAE2E;YAC3E,MAAM,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SACjC,CAAC;QACF,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,QAAQ,EAAE,OAAC,CAAC,OAAO,EAAE;YACrB,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE;YACxB,wCAAwC;YACxC,UAAU,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;YAC/B;qDACyC;YACzC,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;SACtB,CAAC;KACL;CACoB,CAAC"}

package/lib/callables/index.d.ts

@@ -6,3 +6,5 @@ export * from "./events";
 export * from "./jobRoles";
 export * from "./apprenticeships";
 export * from "./he";
+export * from "./nextSteps";
+export * from "./activityLogging";

package/lib/callables/index.js

@@ -22,4 +22,6 @@ __exportStar(require("./events"), exports);
 __exportStar(require("./jobRoles"), exports);
 __exportStar(require("./apprenticeships"), exports);
 __exportStar(require("./he"), exports);
+__exportStar(require("./nextSteps"), exports);
+__exportStar(require("./activityLogging"), exports);
 //# sourceMappingURL=index.js.map

package/lib/callables/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/callables/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,6CAA2B;AAC3B,uDAAqC;AACrC,8CAA4B;AAC5B,2CAAyB;AACzB,6CAA2B;AAC3B,oDAAkC;AAClC,uCAAqB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/callables/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,6CAA2B;AAC3B,uDAAqC;AACrC,8CAA4B;AAC5B,2CAAyB;AACzB,6CAA2B;AAC3B,oDAAkC;AAClC,uCAAqB;AACrB,8CAA4B;AAC5B,oDAAkC"}