placementt-core 1.400.979 → 1.400.981

package/lib/callables/__tests__/registry.test.d.ts

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

package/lib/callables/__tests__/registry.test.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const zod_1 = require("zod");
+const registry_1 = require("../registry");
+/**
+ * Self-consistency checks for the callable registry. These run inside
+ * placementt-core with no backend dependency. The cross-repo check (every
+ * contract maps to a real backend `onCall`) lives in the backend repo, which
+ * can import `allCallables` and scan its own source.
+ */
+describe("callable registry", () => {
+    const names = Object.keys(registry_1.allCallables);
+    it("has no name collisions across feature groups", () => {
+        const groupKeyCount = Object.values(registry_1.callableGroups)
+            .reduce((sum, group) => sum + Object.keys(group).length, 0);
+        // If two groups declared the same name, the spread in registry.ts would
+        // silently drop one and the merged count would be lower than the sum.
+        expect(names.length).toBe(groupKeyCount);
+    });
+    it("names every callable as `<module>-<export>`", () => {
+        for (const name of names) {
+            expect(name).toMatch(/^[a-zA-Z]+-[a-zA-Z]+$/);
+        }
+    });
+    it("gives every callable a request and response zod schema", () => {
+        for (const name of names) {
+            const contract = registry_1.allCallables[name];
+            expect(contract.request).toBeInstanceOf(zod_1.z.ZodType);
+            expect(contract.response).toBeInstanceOf(zod_1.z.ZodType);
+        }
+    });
+});
+//# sourceMappingURL=registry.test.js.map

package/lib/callables/__tests__/registry.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.test.js","sourceRoot":"","sources":["../../../src/callables/__tests__/registry.test.ts"],"names":[],"mappings":";;AAAA,6BAAsB;AACtB,0CAAyD;AAEzD;;;;;GAKG;AACH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,uBAAY,CAAC,CAAC;IAExC,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACpD,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,yBAAc,CAAC;aAC9C,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAChE,wEAAwE;QACxE,sEAAsE;QACtE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACnD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;QAClD,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAC9D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,uBAAY,CAAC,IAAiC,CAAC,CAAC;YACjE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,OAAC,CAAC,OAAO,CAAC,CAAC;YACnD,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,cAAc,CAAC,OAAC,CAAC,OAAO,CAAC,CAAC;QACxD,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/lib/callables/aspirations.d.ts

@@ -0,0 +1,32 @@
+import { z } from "zod";
+/**
+ * Contracts for the `aspirations` backend module
+ * (`Placementt-Backend/functions/src/aspirations.ts`).
+ */
+export declare const aspirationCallables: {
+    "aspirations-createAspirationCycle": {
+        request: z.ZodObject<{
+            oId: z.ZodString;
+            yearGroupsIncluded: z.ZodArray<z.ZodNumber, "many">;
+            scheduledSendDate: z.ZodString;
+            closeAfterDays: z.ZodOptional<z.ZodNumber>;
+            emailTemplateId: z.ZodOptional<z.ZodString>;
+            students: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            oId: string;
+            yearGroupsIncluded: number[];
+            scheduledSendDate: string;
+            students?: string | undefined;
+            closeAfterDays?: number | undefined;
+            emailTemplateId?: string | undefined;
+        }, {
+            oId: string;
+            yearGroupsIncluded: number[];
+            scheduledSendDate: string;
+            students?: string | undefined;
+            closeAfterDays?: number | undefined;
+            emailTemplateId?: string | undefined;
+        }>;
+        response: z.ZodAny;
+    };
+};

package/lib/callables/aspirations.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.aspirationCallables = void 0;
+const zod_1 = require("zod");
+/**
+ * Contracts for the `aspirations` backend module
+ * (`Placementt-Backend/functions/src/aspirations.ts`).
+ */
+exports.aspirationCallables = {
+    "aspirations-createAspirationCycle": {
+        request: zod_1.z.object({
+            oId: zod_1.z.string(),
+            yearGroupsIncluded: zod_1.z.array(zod_1.z.number()),
+            scheduledSendDate: zod_1.z.string(), // ISO string
+            closeAfterDays: zod_1.z.number().optional(),
+            emailTemplateId: zod_1.z.string().optional(),
+            students: zod_1.z.string().optional(), // JSON-serialised DataViewerSelectionBackend
+        }),
+        // TODO: tighten once the return shape is confirmed.
+        response: zod_1.z.any(),
+    },
+};
+//# sourceMappingURL=aspirations.js.map

package/lib/callables/aspirations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aspirations.js","sourceRoot":"","sources":["../../src/callables/aspirations.ts"],"names":[],"mappings":";;;AAAA,6BAAsB;AAGtB;;;GAGG;AACU,QAAA,mBAAmB,GAAG;IAC/B,mCAAmC,EAAE;QACjC,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC;YACd,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;YACf,kBAAkB,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;YACvC,iBAAiB,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE,aAAa;YAC5C,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACrC,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACtC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,6CAA6C;SACjF,CAAC;QACF,oDAAoD;QACpD,QAAQ,EAAE,OAAC,CAAC,GAAG,EAAE;KACpB;CACoB,CAAC"}

package/lib/callables/events.d.ts

@@ -0,0 +1,47 @@
+import { z } from "zod";
+/**
+ * Contracts for the `events` backend module
+ * (`Placementt-Backend/functions/src/events.ts`).
+ */
+export declare const eventsCallables: {
+    "events-searchSchool": {
+        request: z.ZodObject<{
+            oId: z.ZodString;
+            query: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            query: string;
+            oId: string;
+        }, {
+            query: string;
+            oId: string;
+        }>;
+        response: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            geohash: z.ZodOptional<z.ZodString>;
+            "address-line1": z.ZodOptional<z.ZodString>;
+            "address-line2": z.ZodOptional<z.ZodString>;
+            postal_code: z.ZodOptional<z.ZodString>;
+            locality: z.ZodOptional<z.ZodString>;
+            country: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            name?: string | undefined;
+            "address-line1"?: string | undefined;
+            "address-line2"?: string | undefined;
+            country?: string | undefined;
+            locality?: string | undefined;
+            postal_code?: string | undefined;
+            geohash?: string | undefined;
+        }, {
+            id: string;
+            name?: string | undefined;
+            "address-line1"?: string | undefined;
+            "address-line2"?: string | undefined;
+            country?: string | undefined;
+            locality?: string | undefined;
+            postal_code?: string | undefined;
+            geohash?: string | undefined;
+        }>, "many">;
+    };
+};

package/lib/callables/events.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eventsCallables = void 0;
+const zod_1 = require("zod");
+/**
+ * Contracts for the `events` backend module
+ * (`Placementt-Backend/functions/src/events.ts`).
+ */
+exports.eventsCallables = {
+    "events-searchSchool": {
+        request: zod_1.z.object({
+            oId: zod_1.z.string(),
+            query: zod_1.z.string(),
+        }),
+        // Example of a fully-modelled response: an array of matched schools.
+        response: zod_1.z.array(zod_1.z.object({
+            id: zod_1.z.string(),
+            name: zod_1.z.string().optional(),
+            geohash: zod_1.z.string().optional(),
+            "address-line1": zod_1.z.string().optional(),
+            "address-line2": zod_1.z.string().optional(),
+            postal_code: zod_1.z.string().optional(),
+            locality: zod_1.z.string().optional(),
+            country: zod_1.z.string().optional(),
+        })),
+    },
+};
+//# sourceMappingURL=events.js.map

package/lib/callables/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/callables/events.ts"],"names":[],"mappings":";;;AAAA,6BAAsB;AAGtB;;;GAGG;AACU,QAAA,eAAe,GAAG;IAC3B,qBAAqB,EAAE;QACnB,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC;YACd,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;YACf,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;SACpB,CAAC;QACF,qEAAqE;QACrE,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC;YACvB,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE;YACd,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC3B,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACtC,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACtC,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAClC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC/B,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACjC,CAAC,CAAC;KACN;CACoB,CAAC"}

package/lib/callables/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./types";
+export * from "./registry";
+export * from "./aspirations";
+export * from "./placement";
+export * from "./events";

package/lib/callables/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./registry"), exports);
+__exportStar(require("./aspirations"), exports);
+__exportStar(require("./placement"), exports);
+__exportStar(require("./events"), exports);
+//# sourceMappingURL=index.js.map

package/lib/callables/index.js.map

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

package/lib/callables/placement.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+/**
+ * Contracts for the `placement` backend module
+ * (`Placementt-Backend/functions/src/placements.ts`).
+ */
+export declare const placementCallables: {
+    "placement-propose": {
+        request: z.ZodObject<{
+            data: z.ZodAny;
+            studentId: z.ZodOptional<z.ZodString>;
+            isDraft: z.ZodBoolean;
+            inSchool: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            isDraft: boolean;
+            data?: any;
+            inSchool?: boolean | undefined;
+            studentId?: string | undefined;
+        }, {
+            isDraft: boolean;
+            data?: any;
+            inSchool?: boolean | undefined;
+            studentId?: string | undefined;
+        }>;
+        response: z.ZodAny;
+    };
+};

package/lib/callables/placement.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.placementCallables = void 0;
+const zod_1 = require("zod");
+/**
+ * Contracts for the `placement` backend module
+ * (`Placementt-Backend/functions/src/placements.ts`).
+ */
+exports.placementCallables = {
+    "placement-propose": {
+        request: zod_1.z.object({
+            // Placement payload (StudentPlacementData | ProviderStudentPlacementData
+            // & { additionalNeeds? }). Left as z.any() for now - model the nested
+            // placement shape here when you want the call site checked in full.
+            data: zod_1.z.any(),
+            studentId: zod_1.z.string().optional(),
+            isDraft: zod_1.z.boolean(),
+            inSchool: zod_1.z.boolean().optional(),
+        }),
+        // TODO: tighten once the return shape is confirmed.
+        response: zod_1.z.any(),
+    },
+};
+//# sourceMappingURL=placement.js.map

package/lib/callables/placement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"placement.js","sourceRoot":"","sources":["../../src/callables/placement.ts"],"names":[],"mappings":";;;AAAA,6BAAsB;AAGtB;;;GAGG;AACU,QAAA,kBAAkB,GAAG;IAC9B,mBAAmB,EAAE;QACjB,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC;YACd,yEAAyE;YACzE,sEAAsE;YACtE,oEAAoE;YACpE,IAAI,EAAE,OAAC,CAAC,GAAG,EAAE;YACb,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAChC,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;YACpB,QAAQ,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SACnC,CAAC;QACF,oDAAoD;QACpD,QAAQ,EAAE,OAAC,CAAC,GAAG,EAAE;KACpB;CACoB,CAAC"}

package/lib/callables/registry.d.ts

@@ -0,0 +1,204 @@
+import { z } from "zod";
+/**
+ * The single source of truth for every typed callable. Add a feature group's
+ * spread here and its callables are automatically covered by:
+ *   - client typing (`executeCallable` keys off this),
+ *   - backend request validation (`allCallables[name].request.parse(...)`),
+ *   - the cross-repo completeness test.
+ *
+ * Names must be globally unique. A collision across groups would be silently
+ * overwritten by the spread, so the registry test asserts the merged key count
+ * equals the sum of the group key counts.
+ */
+export declare const allCallables: {
+    "events-searchSchool": {
+        request: z.ZodObject<{
+            oId: z.ZodString;
+            query: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            query: string;
+            oId: string;
+        }, {
+            query: string;
+            oId: string;
+        }>;
+        response: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            geohash: z.ZodOptional<z.ZodString>;
+            "address-line1": z.ZodOptional<z.ZodString>;
+            "address-line2": z.ZodOptional<z.ZodString>;
+            postal_code: z.ZodOptional<z.ZodString>;
+            locality: z.ZodOptional<z.ZodString>;
+            country: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            name?: string | undefined;
+            "address-line1"?: string | undefined;
+            "address-line2"?: string | undefined;
+            country?: string | undefined;
+            locality?: string | undefined;
+            postal_code?: string | undefined;
+            geohash?: string | undefined;
+        }, {
+            id: string;
+            name?: string | undefined;
+            "address-line1"?: string | undefined;
+            "address-line2"?: string | undefined;
+            country?: string | undefined;
+            locality?: string | undefined;
+            postal_code?: string | undefined;
+            geohash?: string | undefined;
+        }>, "many">;
+    };
+    "placement-propose": {
+        request: z.ZodObject<{
+            data: z.ZodAny;
+            studentId: z.ZodOptional<z.ZodString>;
+            isDraft: z.ZodBoolean;
+            inSchool: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            isDraft: boolean;
+            data?: any;
+            inSchool?: boolean | undefined;
+            studentId?: string | undefined;
+        }, {
+            isDraft: boolean;
+            data?: any;
+            inSchool?: boolean | undefined;
+            studentId?: string | undefined;
+        }>;
+        response: z.ZodAny;
+    };
+    "aspirations-createAspirationCycle": {
+        request: z.ZodObject<{
+            oId: z.ZodString;
+            yearGroupsIncluded: z.ZodArray<z.ZodNumber, "many">;
+            scheduledSendDate: z.ZodString;
+            closeAfterDays: z.ZodOptional<z.ZodNumber>;
+            emailTemplateId: z.ZodOptional<z.ZodString>;
+            students: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            oId: string;
+            yearGroupsIncluded: number[];
+            scheduledSendDate: string;
+            students?: string | undefined;
+            closeAfterDays?: number | undefined;
+            emailTemplateId?: string | undefined;
+        }, {
+            oId: string;
+            yearGroupsIncluded: number[];
+            scheduledSendDate: string;
+            students?: string | undefined;
+            closeAfterDays?: number | undefined;
+            emailTemplateId?: string | undefined;
+        }>;
+        response: z.ZodAny;
+    };
+};
+/** Every registered callable name. */
+export type CallableName = keyof typeof allCallables;
+/**
+ * Request/response static types per callable, inferred from the zod schemas.
+ * `executeCallable` and the backend handlers both read from this, so neither
+ * side restates a callable's shape.
+ */
+export type CallableContracts = {
+    [K in CallableName]: {
+        request: z.infer<(typeof allCallables)[K]["request"]>;
+        response: z.infer<(typeof allCallables)[K]["response"]>;
+    };
+};
+/** The per-group maps, exported so tests can assert no key collisions. */
+export declare const callableGroups: {
+    aspirationCallables: {
+        "aspirations-createAspirationCycle": {
+            request: z.ZodObject<{
+                oId: z.ZodString;
+                yearGroupsIncluded: z.ZodArray<z.ZodNumber, "many">;
+                scheduledSendDate: z.ZodString;
+                closeAfterDays: z.ZodOptional<z.ZodNumber>;
+                emailTemplateId: z.ZodOptional<z.ZodString>;
+                students: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                oId: string;
+                yearGroupsIncluded: number[];
+                scheduledSendDate: string;
+                students?: string | undefined;
+                closeAfterDays?: number | undefined;
+                emailTemplateId?: string | undefined;
+            }, {
+                oId: string;
+                yearGroupsIncluded: number[];
+                scheduledSendDate: string;
+                students?: string | undefined;
+                closeAfterDays?: number | undefined;
+                emailTemplateId?: string | undefined;
+            }>;
+            response: z.ZodAny;
+        };
+    };
+    placementCallables: {
+        "placement-propose": {
+            request: z.ZodObject<{
+                data: z.ZodAny;
+                studentId: z.ZodOptional<z.ZodString>;
+                isDraft: z.ZodBoolean;
+                inSchool: z.ZodOptional<z.ZodBoolean>;
+            }, "strip", z.ZodTypeAny, {
+                isDraft: boolean;
+                data?: any;
+                inSchool?: boolean | undefined;
+                studentId?: string | undefined;
+            }, {
+                isDraft: boolean;
+                data?: any;
+                inSchool?: boolean | undefined;
+                studentId?: string | undefined;
+            }>;
+            response: z.ZodAny;
+        };
+    };
+    eventsCallables: {
+        "events-searchSchool": {
+            request: z.ZodObject<{
+                oId: z.ZodString;
+                query: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                query: string;
+                oId: string;
+            }, {
+                query: string;
+                oId: string;
+            }>;
+            response: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodOptional<z.ZodString>;
+                geohash: z.ZodOptional<z.ZodString>;
+                "address-line1": z.ZodOptional<z.ZodString>;
+                "address-line2": z.ZodOptional<z.ZodString>;
+                postal_code: z.ZodOptional<z.ZodString>;
+                locality: z.ZodOptional<z.ZodString>;
+                country: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                name?: string | undefined;
+                "address-line1"?: string | undefined;
+                "address-line2"?: string | undefined;
+                country?: string | undefined;
+                locality?: string | undefined;
+                postal_code?: string | undefined;
+                geohash?: string | undefined;
+            }, {
+                id: string;
+                name?: string | undefined;
+                "address-line1"?: string | undefined;
+                "address-line2"?: string | undefined;
+                country?: string | undefined;
+                locality?: string | undefined;
+                postal_code?: string | undefined;
+                geohash?: string | undefined;
+            }>, "many">;
+        };
+    };
+};

package/lib/callables/registry.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.callableGroups = exports.allCallables = void 0;
+const aspirations_1 = require("./aspirations");
+const placement_1 = require("./placement");
+const events_1 = require("./events");
+/**
+ * The single source of truth for every typed callable. Add a feature group's
+ * spread here and its callables are automatically covered by:
+ *   - client typing (`executeCallable` keys off this),
+ *   - backend request validation (`allCallables[name].request.parse(...)`),
+ *   - the cross-repo completeness test.
+ *
+ * Names must be globally unique. A collision across groups would be silently
+ * overwritten by the spread, so the registry test asserts the merged key count
+ * equals the sum of the group key counts.
+ */
+exports.allCallables = {
+    ...aspirations_1.aspirationCallables,
+    ...placement_1.placementCallables,
+    ...events_1.eventsCallables,
+};
+/** The per-group maps, exported so tests can assert no key collisions. */
+exports.callableGroups = { aspirationCallables: aspirations_1.aspirationCallables, placementCallables: placement_1.placementCallables, eventsCallables: events_1.eventsCallables };
+//# sourceMappingURL=registry.js.map

package/lib/callables/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/callables/registry.ts"],"names":[],"mappings":";;;AAEA,+CAAkD;AAClD,2CAA+C;AAC/C,qCAAyC;AAEzC;;;;;;;;;;GAUG;AACU,QAAA,YAAY,GAAG;IACxB,GAAG,iCAAmB;IACtB,GAAG,8BAAkB;IACrB,GAAG,wBAAe;CACG,CAAC;AAiB1B,0EAA0E;AAC7D,QAAA,cAAc,GAAG,EAAC,mBAAmB,EAAnB,iCAAmB,EAAE,kBAAkB,EAAlB,8BAAkB,EAAE,eAAe,EAAf,wBAAe,EAAC,CAAC"}

package/lib/callables/types.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+/**
+ * One callable's contract. `request` validates/derives the payload the client
+ * sends; `response` validates/derives what the handler returns. Both the client
+ * (`executeCallable`) and the backend handler derive their static types from
+ * these schemas, so each callable's shape is written exactly once.
+ *
+ * Tighten `response` from `z.any()` to a concrete schema as you confirm each
+ * function's return shape - `any` keeps `res.data` untyped (today's behaviour)
+ * so migrating a callable never breaks its existing response consumers.
+ */
+export type CallableContract = {
+    request: z.ZodTypeAny;
+    response: z.ZodTypeAny;
+};
+/**
+ * A group of callables, keyed by their fully-qualified deployed name
+ * (`<module>-<export>`, e.g. `aspirations-createAspirationCycle`). Feature
+ * files declare a group and `satisfies CallableGroup`; `registry.ts` merges
+ * them into the single `allCallables` source of truth.
+ */
+export type CallableGroup = Record<`${string}-${string}`, CallableContract>;

package/lib/callables/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/lib/callables/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/callables/types.ts"],"names":[],"mappings":""}

package/lib/constants.d.ts

@@ -148,6 +148,17 @@ export declare const skillLabelColours: {
     "Work Readiness": string;
     "Career Development": string;
 };
+/**
+ * Resolves the display colour for a skill label. The colour is stored on the
+ * label document (`color`), seeded via the admin "Seed skill labels & colours"
+ * action; it falls back to the institute's brand colour, then PRIMARY_COLOUR.
+ * No category → colour lookup — the colour lives on the data.
+ */
+export declare function skillColour(label?: {
+    color?: string;
+}, institute?: {
+    color?: string;
+}): string;
 export declare const skillAssessmentSchedule: {
     [key in "yearStart" | "yearEnd" | "eachTerm" | "preWorkExperience" | "postWorkExperience" | "employerInteraction" | "extracurricularActivity"]: {
         title: string;

package/lib/constants.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.leadStageSchema = exports.commSchema = exports.DEFAULT_SURVEY_RULE = exports.surveyRuleLabel = exports.surveyRuleToMMDD = exports.surveyRuleToDate = exports.resolveNthWeekday = exports.currentAcademicStartYear = exports.academicCalendarYear = exports.SURVEY_MONTHS = exports.SURVEY_WEEKDAYS = exports.SURVEY_ORDINALS = exports.skillAssessmentSchedule = exports.skillLabelColours = exports.equalexLearningOutcomes = exports.gatsbyBenchmarks = exports.externalActivityTypes = exports.MISQueryParams = exports.emailTemplates = exports.defaultApplicantWorkflow = exports.mobileCountryCodes = exports.ERROR_COLOR = exports.SUCCESS_COLOR = exports.WARNING_COLOR = exports.INFO_COLOR = exports.INFOBACKGROUNDCOLOR = exports.INFOTEXTCOLOR = exports.WARNINGBACKGROUNDCOLOR = exports.WARNINGTEXTCOLOR = exports.SUCCESSBACKGROUNDCOLOR = exports.SUCCESSTEXTCOLOR = exports.ERRORBACKGROUNDCOLOR = exports.ERRORTEXTCOLOR = exports.STUDENT_COLOUR = exports.PROVIDER_COLOUR = exports.INSTITUTE_COLOUR = exports.SECONDARY_COLOUR = exports.LOGO_TERTIARY_COLOUR = exports.LOGO_SECONDARY_COLOUR = exports.PRIMARY_COLOUR = exports.DEFAULT_ACTIVITY_REFLECTION_FORM = exports.DEFAULT_ACTIVITY_REFLECTION_FORM_ID = exports.sampleTargets = exports.flagCodes = exports.defaultStudentWorkflow = exports.defaultInstituteWorkflow = exports.sectorColours = exports.providerSectors = exports.countryList = exports.providerCodes = void 0;
 exports.JOB_VALUES = exports.CAREER_INTEREST_CATEGORIES = exports.SIC_SECTIONS = exports.SOC_MAJOR_GROUPS = exports.DESTINATION_CODES = exports.careersHubSchoolOnboardingEmailTemplates = exports.emailCampaignFullStatuses = exports.emailCampaignSummaryStatuses = exports.leadStageOrder = void 0;
+exports.skillColour = skillColour;
 /* eslint-disable max-len */
 exports.providerCodes = {
     soleTrader: {
@@ -1013,6 +1014,15 @@ exports.skillLabelColours = {
     ["Work Readiness"]: "#f5c842",
     ["Career Development"]: "#c41d7f",
 };
+/**
+ * Resolves the display colour for a skill label. The colour is stored on the
+ * label document (`color`), seeded via the admin "Seed skill labels & colours"
+ * action; it falls back to the institute's brand colour, then PRIMARY_COLOUR.
+ * No category → colour lookup — the colour lives on the data.
+ */
+function skillColour(label, institute) {
+    return label?.color || institute?.color || exports.PRIMARY_COLOUR;
+}
 exports.skillAssessmentSchedule = {
     yearStart: {
         title: "Start of Academic Year",