placementt-core 1.400.1112 → 1.400.1114

package/lib/callables/index.d.ts

@@ -10,3 +10,4 @@ export * from "./studentLaunches";
 export * from "./billing";
 export * from "./hubImpactReport";
 export * from "./e2e";
+export * from "./wonde";

package/lib/callables/index.js

@@ -26,4 +26,5 @@ __exportStar(require("./studentLaunches"), exports);
 __exportStar(require("./billing"), exports);
 __exportStar(require("./hubImpactReport"), exports);
 __exportStar(require("./e2e"), exports);
+__exportStar(require("./wonde"), 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;AACrB,oDAAkC;AAClC,4CAA0B;AAC1B,oDAAkC;AAClC,wCAAsB"}
+{"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,oDAAkC;AAClC,4CAA0B;AAC1B,oDAAkC;AAClC,wCAAsB;AACtB,0CAAwB"}

package/lib/callables/registry.d.ts

@@ -11,6 +11,28 @@ import { z } from "zod";
  * equals the sum of the group key counts.
  */
 export declare const allCallables: {
+    "wonde-requestConnection": {
+        request: z.ZodObject<{
+            oId: z.ZodString;
+            itManagerName: z.ZodString;
+            itManagerEmail: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            oId: string;
+            itManagerName: string;
+            itManagerEmail: string;
+        }, {
+            oId: string;
+            itManagerName: string;
+            itManagerEmail: string;
+        }>;
+        response: z.ZodObject<{
+            taskId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            taskId: string;
+        }, {
+            taskId: string;
+        }>;
+    };
     "e2e-redeemSignInLink": {
         request: z.ZodObject<{
             token: z.ZodString;
@@ -2555,4 +2577,28 @@ export declare const callableGroups: {
             }>;
         };
     };
+    wondeCallables: {
+        "wonde-requestConnection": {
+            request: z.ZodObject<{
+                oId: z.ZodString;
+                itManagerName: z.ZodString;
+                itManagerEmail: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                oId: string;
+                itManagerName: string;
+                itManagerEmail: string;
+            }, {
+                oId: string;
+                itManagerName: string;
+                itManagerEmail: string;
+            }>;
+            response: z.ZodObject<{
+                taskId: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                taskId: string;
+            }, {
+                taskId: string;
+            }>;
+        };
+    };
 };

package/lib/callables/registry.js

@@ -14,6 +14,7 @@ const billing_1 = require("./billing");
 const jobRoles_1 = require("./jobRoles");
 const hubImpactReport_1 = require("./hubImpactReport");
 const e2e_1 = require("./e2e");
+const wonde_1 = require("./wonde");
 /**
  * The single source of truth for every typed callable. Add a feature group's
  * spread here and its callables are automatically covered by:
@@ -39,7 +40,8 @@ exports.allCallables = {
     ...jobRoles_1.jobRolesCallables,
     ...hubImpactReport_1.hubImpactReportCallables,
     ...e2e_1.e2eCallables,
+    ...wonde_1.wondeCallables,
 };
 /** The per-group maps, exported so tests can assert no key collisions. */
-exports.callableGroups = { destinationsConfigCallables: destinationsConfig_1.destinationsConfigCallables, placementCallables: placement_1.placementCallables, eventsCallables: events_1.eventsCallables, surveyCallables: surveys_1.surveyCallables, checksCallables: checks_1.checksCallables, benchmarksCallables: benchmarks_1.benchmarksCallables, apprenticeshipsCallables: apprenticeships_1.apprenticeshipsCallables, heCallables: he_1.heCallables, studentLaunchCallables: studentLaunches_1.studentLaunchCallables, billingCallables: billing_1.billingCallables, jobRolesCallables: jobRoles_1.jobRolesCallables, hubImpactReportCallables: hubImpactReport_1.hubImpactReportCallables, e2eCallables: e2e_1.e2eCallables };
+exports.callableGroups = { destinationsConfigCallables: destinationsConfig_1.destinationsConfigCallables, placementCallables: placement_1.placementCallables, eventsCallables: events_1.eventsCallables, surveyCallables: surveys_1.surveyCallables, checksCallables: checks_1.checksCallables, benchmarksCallables: benchmarks_1.benchmarksCallables, apprenticeshipsCallables: apprenticeships_1.apprenticeshipsCallables, heCallables: he_1.heCallables, studentLaunchCallables: studentLaunches_1.studentLaunchCallables, billingCallables: billing_1.billingCallables, jobRolesCallables: jobRoles_1.jobRolesCallables, hubImpactReportCallables: hubImpactReport_1.hubImpactReportCallables, e2eCallables: e2e_1.e2eCallables, wondeCallables: wonde_1.wondeCallables };
 //# sourceMappingURL=registry.js.map

package/lib/callables/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/callables/registry.ts"],"names":[],"mappings":";;;AAEA,6DAAiE;AACjE,2CAA+C;AAC/C,qCAAyC;AACzC,uCAA0C;AAC1C,qCAAyC;AACzC,6CAAiD;AACjD,uDAA2D;AAC3D,6BAAiC;AACjC,uDAAyD;AACzD,uCAA2C;AAC3C,yCAA6C;AAC7C,uDAA2D;AAC3D,+BAAmC;AAEnC;;;;;;;;;;GAUG;AACU,QAAA,YAAY,GAAG;IACxB,GAAG,gDAA2B;IAC9B,GAAG,8BAAkB;IACrB,GAAG,wBAAe;IAClB,GAAG,yBAAe;IAClB,GAAG,wBAAe;IAClB,GAAG,gCAAmB;IACtB,GAAG,0CAAwB;IAC3B,GAAG,gBAAW;IACd,GAAG,wCAAsB;IACzB,GAAG,0BAAgB;IACnB,GAAG,4BAAiB;IACpB,GAAG,0CAAwB;IAC3B,GAAG,kBAAY;CACM,CAAC;AAiB1B,0EAA0E;AAC7D,QAAA,cAAc,GAAG,EAAC,2BAA2B,EAA3B,gDAA2B,EAAE,kBAAkB,EAAlB,8BAAkB,EAAE,eAAe,EAAf,wBAAe,EAAE,eAAe,EAAf,yBAAe,EAAE,eAAe,EAAf,wBAAe,EAAE,mBAAmB,EAAnB,gCAAmB,EAAE,wBAAwB,EAAxB,0CAAwB,EAAE,WAAW,EAAX,gBAAW,EAAE,sBAAsB,EAAtB,wCAAsB,EAAE,gBAAgB,EAAhB,0BAAgB,EAAE,iBAAiB,EAAjB,4BAAiB,EAAE,wBAAwB,EAAxB,0CAAwB,EAAE,YAAY,EAAZ,kBAAY,EAAC,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/callables/registry.ts"],"names":[],"mappings":";;;AAEA,6DAAiE;AACjE,2CAA+C;AAC/C,qCAAyC;AACzC,uCAA0C;AAC1C,qCAAyC;AACzC,6CAAiD;AACjD,uDAA2D;AAC3D,6BAAiC;AACjC,uDAAyD;AACzD,uCAA2C;AAC3C,yCAA6C;AAC7C,uDAA2D;AAC3D,+BAAmC;AACnC,mCAAuC;AAEvC;;;;;;;;;;GAUG;AACU,QAAA,YAAY,GAAG;IACxB,GAAG,gDAA2B;IAC9B,GAAG,8BAAkB;IACrB,GAAG,wBAAe;IAClB,GAAG,yBAAe;IAClB,GAAG,wBAAe;IAClB,GAAG,gCAAmB;IACtB,GAAG,0CAAwB;IAC3B,GAAG,gBAAW;IACd,GAAG,wCAAsB;IACzB,GAAG,0BAAgB;IACnB,GAAG,4BAAiB;IACpB,GAAG,0CAAwB;IAC3B,GAAG,kBAAY;IACf,GAAG,sBAAc;CACI,CAAC;AAiB1B,0EAA0E;AAC7D,QAAA,cAAc,GAAG,EAAC,2BAA2B,EAA3B,gDAA2B,EAAE,kBAAkB,EAAlB,8BAAkB,EAAE,eAAe,EAAf,wBAAe,EAAE,eAAe,EAAf,yBAAe,EAAE,eAAe,EAAf,wBAAe,EAAE,mBAAmB,EAAnB,gCAAmB,EAAE,wBAAwB,EAAxB,0CAAwB,EAAE,WAAW,EAAX,gBAAW,EAAE,sBAAsB,EAAtB,wCAAsB,EAAE,gBAAgB,EAAhB,0BAAgB,EAAE,iBAAiB,EAAjB,4BAAiB,EAAE,wBAAwB,EAAxB,0CAAwB,EAAE,YAAY,EAAZ,kBAAY,EAAE,cAAc,EAAd,sBAAc,EAAC,CAAC"}

package/lib/callables/wonde.d.ts

@@ -0,0 +1,35 @@
+import { z } from "zod";
+/**
+ * Contracts for the Wonde connection request
+ * (`Placementt-Backend/functions/src/wonde.ts`).
+ *
+ * Wonde only approves a connection once the school's IT manager signs it off, so
+ * the school gives us their details and we raise the request with Wonde. Nothing
+ * is emailed from the platform: the request lands as a support task.
+ */
+export declare const wondeCallables: {
+    "wonde-requestConnection": {
+        request: z.ZodObject<{
+            /** The school the connection is for. */
+            oId: z.ZodString;
+            itManagerName: z.ZodString;
+            itManagerEmail: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            oId: string;
+            itManagerName: string;
+            itManagerEmail: string;
+        }, {
+            oId: string;
+            itManagerName: string;
+            itManagerEmail: string;
+        }>;
+        response: z.ZodObject<{
+            /** supportTasks/{id} raised, or the open one it updated. */
+            taskId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            taskId: string;
+        }, {
+            taskId: string;
+        }>;
+    };
+};

package/lib/callables/wonde.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wondeCallables = void 0;
+const zod_1 = require("zod");
+/**
+ * Contracts for the Wonde connection request
+ * (`Placementt-Backend/functions/src/wonde.ts`).
+ *
+ * Wonde only approves a connection once the school's IT manager signs it off, so
+ * the school gives us their details and we raise the request with Wonde. Nothing
+ * is emailed from the platform: the request lands as a support task.
+ */
+exports.wondeCallables = {
+    "wonde-requestConnection": {
+        request: zod_1.z.object({
+            /** The school the connection is for. */
+            oId: zod_1.z.string().min(1),
+            itManagerName: zod_1.z.string().trim().min(1).max(200),
+            itManagerEmail: zod_1.z.string().trim().email().max(320),
+        }),
+        response: zod_1.z.object({
+            /** supportTasks/{id} raised, or the open one it updated. */
+            taskId: zod_1.z.string(),
+        }),
+    },
+};
+//# sourceMappingURL=wonde.js.map

package/lib/callables/wonde.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wonde.js","sourceRoot":"","sources":["../../src/callables/wonde.ts"],"names":[],"mappings":";;;AAAA,6BAAsB;AAGtB;;;;;;;GAOG;AACU,QAAA,cAAc,GAAG;IAC1B,yBAAyB,EAAE;QACvB,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC;YACd,wCAAwC;YACxC,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACtB,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;YAChD,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;SACrD,CAAC;QACF,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,4DAA4D;YAC5D,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;SACrB,CAAC;KACL;CACoB,CAAC"}

package/lib/hooks.d.ts

@@ -245,7 +245,7 @@ type NewUserPaginatorParams = {
     view: "list" | "table";
     filters?: FilterObject;
     institute: InstituteData;
-    userType: "Staff" | "Students";
+    userType: "Staff" | "Students" | "Leavers";
     initialSort?: string;
     trustSchoolsIDs?: string[];
 };

package/lib/hooks.js

@@ -2235,7 +2235,10 @@ function useUserUploadHandler({ product, oId, event, eventId, userType, user, on
     const [emptyCellsWarning, setEmptyCellsWarning] = (0, react_1.useState)(false);
     const [alert, setAlert] = (0, react_1.useState)();
     const { execute } = (0, firebase_1.useExecuteCallableJob)({ user: user });
-    const requiredFields = ["forename", "surname", "email"];
+    // Students also need a year group: Destinations, Development and the careers
+    // calendar are all set up per year group, and a CSV is the only way a school
+    // without Wonde gets one onto its students.
+    const requiredFields = ["forename", "surname", "email", ...(userType === "Students" ? [constants_1.STUDENT_YEAR_FIELD] : [])];
     const checkData = (userData) => {
         setAlert(undefined);
         userData = userData.filter((u) => Object.entries(u).some(([, v]) => v));
@@ -2268,15 +2271,14 @@ function useUserUploadHandler({ product, oId, event, eventId, userType, user, on
                 setAlert({ msg: "Data cannot be uploaded in unnamed columns.", severity: "error" });
                 return false;
             }
-            for (const field in user) {
-                if (!user[field]) {
-                    if (requiredFields.includes(field)) {
-                        setAlert({ msg: "All users must contain " + requiredFields.join(", "), severity: "error" });
-                        emptyRequiredCell = true;
-                    }
-                    emptyOptionalCell = true;
-                }
+            // Checked against the list rather than the row's keys, so a required
+            // column missing from the upload altogether fails too.
+            if (requiredFields.some((field) => !user[field])) {
+                setAlert({ msg: "All users must contain " + requiredFields.map((f) => f === constants_1.STUDENT_YEAR_FIELD ? "year group" : f).join(", "), severity: "error" });
+                emptyRequiredCell = true;
             }
+            if (Object.values(user).some((v) => !v))
+                emptyOptionalCell = true;
             // Add more test cases
         }
         if (emptyRequiredCell) {