placementt-core 11.0.533 → 11.0.892

package/lib/tasksAndTips.js

@@ -12,6 +12,22 @@ const firebaseQuery = new firebaseQuery_1.default;
 const providerTips = {};
 const studentTips = {};
 const instituteTips = {
+    addSchools: {
+        callback: async (user, institute, schools) => {
+            if (!(0, util_1.getAccess)(user, "addSchools") || (institute === null || institute === void 0 ? void 0 : institute.package) !== "institutes-two")
+                return;
+            if (Object.keys(schools).length < 2) {
+                return {
+                    title: "Add your schools",
+                    message: "Add your schools. These will show up in the 'Cohorts' tab where you can assign cohorts of students to them.",
+                    link: "/institutes/organisation/overview",
+                    buttonTitle: "Add schools",
+                    dismissible: true
+                };
+            }
+            return;
+        },
+    },
     createCohort: {
         callback: async (user) => {
             if (!(0, util_1.getAccess)(user, "createCohorts"))
@@ -129,9 +145,207 @@ const instituteTips = {
 };
 //  Accept a cohort to any task
 const instituteTasks = {
+    invalidStaffEmails: {
+        callback: async ({ user, cohorts }) => {
+            if (!(0, util_1.getAccess)(user, "viewStaff") || !Array.isArray(cohorts))
+                return;
+            const staffCount = (await firebaseQuery.getCount(["users"], [(0, firestore_1.where)("oId", "==", user.oId), (0, firestore_1.where)("userType", "==", "Staff"), (0, firestore_1.where)("flags", "array-contains", "userEmailFailed")]));
+            if (staffCount > 0) {
+                return {
+                    dismissible: false,
+                    severity: "error",
+                    title: `${staffCount} staff have invalid emails.`,
+                    message: `${staffCount} staff accounts have invalid email addresses. Delete and reupload these users.`,
+                    link: "/institutes/organisation/staff/all",
+                };
+            }
+            return;
+        },
+    },
+    approveAlumniConversation: {
+        callback: async ({ user, organisation, schools }) => {
+            if (!schools) {
+                if (!organisation.alumniConversations)
+                    return;
+                const convos = (await firebaseQuery.getCount(["alumniConversations"], [(0, firestore_1.where)("oId", "==", user.oId), (0, firestore_1.where)("open", "==", true), (0, firestore_1.where)("delivered", "==", "pending")]));
+                if (convos > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "info",
+                        title: `${convos} alumni conversation message${convos > 1 ? "s" : ""} needs approval.`,
+                        message: `There are ${convos} message${convos > 1 ? "s" : ""} to alumni for you to review and release.`,
+                        link: "/institutes/network/alumni/conversations",
+                    };
+                }
+                return;
+            }
+            if (!Array.isArray(schools)) {
+                // One school
+                const convos = (await firebaseQuery.getCount(["alumniConversations"], [(0, firestore_1.where)("oId", "==", user.oId), (0, firestore_1.where)("schoolId", "==", schools.id), (0, firestore_1.where)("open", "==", true), (0, firestore_1.where)("delivered", "==", "pending")]));
+                if (convos > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "info",
+                        title: `${convos} alumni conversation message${convos > 1 ? "s" : ""} needs approval.`,
+                        message: `There are ${convos} message${convos > 1 ? "s" : ""} to alumni for you to review and release.`,
+                        link: `/institutes/network/alumni/conversations/${schools.id}`,
+                    };
+                }
+                return;
+            }
+            const items = await Promise.all(schools.map(async ([id, school]) => {
+                if (!school.alumniConversations)
+                    return;
+                const convos = (await firebaseQuery.getCount(["alumniConversations"], [(0, firestore_1.where)("oId", "==", user.oId), (0, firestore_1.where)("schoolId", "==", id), (0, firestore_1.where)("open", "==", true), (0, firestore_1.where)("delivered", "==", "pending")]));
+                if (convos > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "info",
+                        title: `${convos} alumni conversation message${convos > 1 ? "s" : ""} needs approval.`,
+                        message: `${school.name}, has ${convos} outstanding alumni message${convos > 1 ? "s" : ""} to approve. Click to view.`,
+                        link: `/institutes/network/alumni/conversations/${school.id}`,
+                    };
+                }
+                return;
+            }));
+            return items.filter((v) => v);
+        },
+    },
+    invalidStudentEmails: {
+        callback: async ({ user, cohorts }) => {
+            if (!(0, util_1.getAccess)(user, "viewStudents") || user.viewStudents === "none")
+                return;
+            if (!Array.isArray(cohorts)) {
+                const studentCount = (await firebaseQuery.getCount(["users"], [(0, firestore_1.where)("oId", "==", user.oId), (0, firestore_1.where)("userType", "==", "Students"), (0, firestore_1.where)("cohort", "==", cohorts.id), (0, firestore_1.where)("flags", "array-contains", "userEmailFailed")]));
+                if (studentCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "error",
+                        title: `${studentCount} students have invalid emails.`,
+                        message: `${studentCount} student accounts have invalid email addresses. Delete and reupload these users.`,
+                        link: `/institutes/cohorts/${cohorts.id}/students`,
+                    };
+                }
+                return;
+            }
+            const items = await Promise.all(cohorts.map(async ([id, cohort]) => {
+                const studentCount = (await firebaseQuery.getCount(["users"], [(0, firestore_1.where)("oId", "==", user.oId), (0, firestore_1.where)("userType", "==", "Students"), (0, firestore_1.where)("cohort", "==", id), (0, firestore_1.where)("flags", "array-contains", "userEmailFailed")]));
+                if (studentCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "error",
+                        title: `${studentCount} students have invalid emails.`,
+                        message: `Your cohort, ${cohort.name}, has ${studentCount} student accounts with invalid email addresses. Delete and reupload these users.`,
+                        link: `/institutes/cohorts/${id}/students`,
+                    };
+                }
+                return;
+            }));
+            return items.filter((v) => v);
+        },
+    },
+    outstandingReminders: {
+        callback: async ({ user, cohorts }) => {
+            if (!Array.isArray(cohorts)) {
+                const reminderCount = (await firebaseQuery.getCount(["reminders"], [(0, firestore_1.where)("oId", "==", user.oId), (0, firestore_1.where)("uid", "==", user.id), (0, firestore_1.where)("dueDate", "<=", (0, util_2.convertDate)(new Date(), "dbstring")), (0, firestore_1.where)("cohort", "==", cohorts.id), (0, firestore_1.where)("status", "==", "upcoming")]));
+                if (reminderCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "primary",
+                        title: `You have ${reminderCount} reminder${reminderCount > 1 ? "s" : ""}.`,
+                        message: `You have ${reminderCount} outstanding placement reminder${reminderCount > 1 ? "s" : ""}. Click to view.`,
+                        link: `/institutes/cohorts/${cohorts.id}/placements`,
+                    };
+                }
+                return;
+            }
+            const items = await Promise.all(cohorts.map(async ([id, cohort]) => {
+                const reminderCount = (await firebaseQuery.getCount(["reminders"], [(0, firestore_1.where)("oId", "==", user.oId), (0, firestore_1.where)("uid", "==", user.id), (0, firestore_1.where)("dueDate", "<=", (0, util_2.convertDate)(new Date(), "dbstring")), (0, firestore_1.where)("cohort", "==", id), (0, firestore_1.where)("status", "==", "upcoming")]));
+                if (reminderCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "primary",
+                        title: `You have ${reminderCount} reminder${reminderCount > 1 ? "s" : ""}.`,
+                        message: `Your cohort, ${cohort.name}, has ${reminderCount} outstanding placement reminder${reminderCount > 1 ? "s" : ""}. Click to view.`,
+                        link: `/institutes/cohorts/${id}/placements`,
+                    };
+                }
+                return;
+            }));
+            return items.filter((v) => v);
+        },
+    },
+    invalidParentEmails: {
+        callback: async ({ user, cohorts }) => {
+            if (!(0, util_1.getAccess)(user, "signOffPlacements") || user.viewStudents === "none")
+                return;
+            if (!Array.isArray(cohorts)) {
+                const placementCount = (await firebaseQuery.getCount(["placements"], [(0, firestore_1.where)("oId", "==", user.oId), (0, firestore_1.where)("cohort", "==", cohorts.id), (0, firestore_1.where)("flags", "array-contains", "parentEmailFailed")]));
+                if (placementCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "error",
+                        title: `${placementCount} placements have invalid parent emails.`,
+                        message: `Your cohort '${cohorts.name}' has placements with invalid parent emails. Click to view these placements.`,
+                        link: `/institutes/cohorts/${cohorts.id}/placements?id=upcoming`,
+                    };
+                }
+                return;
+            }
+            const items = await Promise.all(cohorts.map(async ([id, cohort]) => {
+                const placementCount = (await firebaseQuery.getCount(["placements"], [(0, firestore_1.where)("oId", "==", user.oId), (0, firestore_1.where)("cohort", "==", id), (0, firestore_1.where)("flags", "array-contains", "parentEmailFailed")]));
+                if (placementCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "error",
+                        title: `${placementCount} placements in '${cohort.name}' have invalid parent emails.`,
+                        message: `Your cohort '${cohort.name}' has placements with invalid parent emails. Click to view these placements.`,
+                        link: `/institutes/cohorts/${id}/placements?id=upcoming`,
+                        buttonTitle: "Review placements",
+                    };
+                }
+                return;
+            }));
+            return items.filter((v) => v);
+        },
+    },
+    invalidProviderEmails: {
+        callback: async ({ user, cohorts }) => {
+            if (!(0, util_1.getAccess)(user, "signOffPlacements") || user.viewStudents === "none")
+                return;
+            if (!Array.isArray(cohorts)) {
+                const placementCount = (await firebaseQuery.getCount(["placements"], [(0, firestore_1.where)("oId", "==", user.oId), (0, firestore_1.where)("cohort", "==", cohorts.id), (0, firestore_1.where)("flags", "array-contains", "providerEmailFailed")]));
+                if (placementCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "error",
+                        title: `${placementCount} placements have invalid provider emails.`,
+                        message: `Your cohort '${cohorts.name}' has placements with invalid provider emails. Click to view these placements.`,
+                        link: `/institutes/cohorts/${cohorts.id}/placements?id=upcoming`,
+                    };
+                }
+                return;
+            }
+            const items = await Promise.all(cohorts.map(async ([id, cohort]) => {
+                const placementCount = (await firebaseQuery.getCount(["placements"], [(0, firestore_1.where)("oId", "==", user.oId), (0, firestore_1.where)("cohort", "==", id), (0, firestore_1.where)("flags", "array-contains", "providerEmailFailed")]));
+                if (placementCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "error",
+                        title: `${placementCount} placements in '${cohort.name}' have invalid provider emails.`,
+                        message: `Your cohort '${cohort.name}' has placements with invalid provider emails. Click to view these placements.`,
+                        link: `/institutes/cohorts/${id}/placements?id=upcoming`,
+                        buttonTitle: "Review placements",
+                    };
+                }
+                return;
+            }));
+            return items.filter((v) => v);
+        },
+    },
     requiredStage: {
-        callback: async (user, _, cohorts) => {
-            if (!(0, util_1.getAccess)(user, "signOffPlacements"))
+        callback: async ({ user, cohorts }) => {
+            if (!(0, util_1.getAccess)(user, "signOffPlacements") || user.viewStudents === "none")
                 return;
             if (!Array.isArray(cohorts)) {
                 const placementCount = (await firebaseQuery.getCount(["placements"], [(0, firestore_1.where)("oId", "==", user.oId), (0, firestore_1.where)("cohort", "==", cohorts.id), (0, firestore_1.where)("reqUserType", "==", user.userType)]));
@@ -164,8 +378,8 @@ const instituteTasks = {
         },
     },
     verifyInsurance: {
-        callback: async (user, _, cohorts) => {
-            if (!(0, util_1.getAccess)(user, "verifyInsurance"))
+        callback: async ({ user, cohorts }) => {
+            if (!(0, util_1.getAccess)(user, "verifyInsurance") || user.viewStudents === "none")
                 return;
             if (!Array.isArray(cohorts)) {
                 const placementCount = (await firebaseQuery.getCount(["placements"], [(0, firestore_1.where)("oId", "==", user.oId), (0, firestore_1.where)("cohort", "==", cohorts.id), (0, firestore_1.where)("insurance", "==", "awaitingReview")]));
@@ -198,8 +412,8 @@ const instituteTasks = {
         },
     },
     verifyDbsCheck: {
-        callback: async (user, _, cohorts) => {
-            if (!(0, util_1.getAccess)(user, "verifyDbsChecks"))
+        callback: async ({ user, cohorts }) => {
+            if (!(0, util_1.getAccess)(user, "verifyDbsChecks") || user.viewStudents === "none")
                 return;
             if (!Array.isArray(cohorts)) {
                 const placementCount = (await firebaseQuery.getCount(["placements"], [(0, firestore_1.where)("oId", "==", user.oId), (0, firestore_1.where)("cohort", "==", cohorts.id), (0, firestore_1.where)("dbsCheck", "==", "awaitingReview")]));
@@ -232,8 +446,8 @@ const instituteTasks = {
         },
     },
     verifyRiskAssessment: {
-        callback: async (user, _, cohorts) => {
-            if (!(0, util_1.getAccess)(user, "verifyRiskAssessments"))
+        callback: async ({ user, cohorts }) => {
+            if (!(0, util_1.getAccess)(user, "verifyRiskAssessments") || user.viewStudents === "none")
                 return;
             if (!Array.isArray(cohorts)) {
                 const placementCount = (await firebaseQuery.getCount(["placements"], [(0, firestore_1.where)("oId", "==", user.oId), (0, firestore_1.where)("cohort", "==", cohorts.id), (0, firestore_1.where)("riskAssessment", "==", "awaitingReview")]));
@@ -266,9 +480,9 @@ const instituteTasks = {
         },
     },
     missingParentEmail: {
-        callback: async (user, _, cohorts) => {
+        callback: async ({ user, cohorts }) => {
             var _a, _b, _c;
-            if (!(0, util_1.getAccess)(user, "editStudents"))
+            if (!(0, util_1.getAccess)(user, "editStudents") || user.viewStudents === "none")
                 return;
             if (!Array.isArray(cohorts)) {
                 const requiresParents = Boolean(cohorts.workflow.find((node) => node.userType === "Parent"));
@@ -316,9 +530,9 @@ const instituteTasks = {
         },
     },
     inactiveStudents: {
-        callback: async (user, _, cohorts) => {
+        callback: async ({ user, cohorts }) => {
             var _a, _b, _c;
-            if (!(0, util_1.getAccess)(user, "activateStudents"))
+            if (!(0, util_1.getAccess)(user, "activateStudents") || user.viewStudents === "none")
                 return;
             if (!Array.isArray(cohorts)) {
                 const constraints = [(0, firestore_1.where)("oId", "==", user.oId), (0, firestore_1.where)("cohort", "==", cohorts.id), (0, firestore_1.where)("status", "==", "inactive")];
@@ -351,7 +565,7 @@ const instituteTasks = {
                         title: `${studentCount} students in '${cohort.name}' are inactive.`,
                         message: `Your cohort '${cohort.name}' has inactive students. Activate them to enable them to use the platform.`,
                         link: `/institutes/cohorts/${cohort.id}/students?status=inactive`,
-                        buttonTitle: "Review placements",
+                        buttonTitle: "Review students",
                     };
                 }
                 return;
@@ -360,10 +574,10 @@ const instituteTasks = {
         },
     },
     uploadStudents: {
-        callback: async (user, _, cohorts) => {
+        callback: async ({ user, cohorts }) => {
             if (!Array.isArray(cohorts))
                 return;
-            if (!(0, util_1.getAccess)(user, "addStudents"))
+            if (!(0, util_1.getAccess)(user, "addStudents") || user.viewStudents === "none")
                 return;
             if (user.product !== "institutes")
                 return;
@@ -389,7 +603,7 @@ const instituteTasks = {
         },
     },
     inactiveStaff: {
-        callback: async (user, _, cohorts) => {
+        callback: async ({ user, cohorts }) => {
             if (!(0, util_1.getAccess)(user, "addStaff"))
                 return;
             if (!Array.isArray(cohorts) || user.product === "students")
@@ -411,16 +625,16 @@ const instituteTasks = {
         },
     },
     overdueStage: {
-        callback: async (user, _, cohort) => {
-            console.log(user, cohort);
+        callback: async ({ user, cohorts }) => {
+            console.log(user, cohorts);
             return undefined;
         },
     },
     approveExternalPlacement: {
-        callback: async (user, _, cohort) => {
+        callback: async ({ user, cohorts }) => {
             if (!(0, util_1.getAccess)(user, "verifyListings"))
                 return;
-            if (!Array.isArray(cohort))
+            if (!Array.isArray(cohorts))
                 return;
             const externalCount = await firebaseQuery.getCount(["placementListings"], [(0, firestore_1.where)(`savedBy.${user.oId}.exists`, "==", true), (0, firestore_1.where)(`savedBy.${user.oId}.status`, "==", "uploaded"), (0, firestore_1.where)("mapConsent", "==", "institute")]);
             console.log("EXT", externalCount);
@@ -442,14 +656,13 @@ const studentTasks = {
     completeOnboarding: {
         callback: async (user) => {
             const placementsWithoutOnboarding = await firebaseQuery.getDocsWhere("placements", [(0, firestore_1.where)("uid", "==", user.id), (0, firestore_1.where)("onboarding.deadline", "<=", (0, util_2.convertDate)(new Date(), "dbstring")), (0, firestore_1.where)("onboarding.completed.submitted", "==", false)]);
-            console.log("placementsWithoutONboarding", placementsWithoutOnboarding);
             if (Object.keys(placementsWithoutOnboarding).length === 0)
                 return;
             const items = Object.entries(placementsWithoutOnboarding).map(([k, placement]) => ({
                 dismissible: false,
                 severity: "primary",
-                title: `Complete required onboarding documents for ${placement.name}`,
-                message: `${placement.name} has requested you to complete some onboarding documents.`,
+                title: `Complete onboarding for ${placement.name}`,
+                message: `Review onboarding for your placement starting on ${(0, util_2.convertDate)(placement.startDate, "visual")}`,
                 link: `/${user.product}/placements/${k}`,
                 buttonTitle: "View onboarding",
             }));
@@ -457,116 +670,364 @@ const studentTasks = {
         },
     }
 };
-const providerTasks = {
-    requestedVisibleAddresses: {
-        callback: async (user) => {
-            const accessRequests = await firebaseQuery.getCount("users", [(0, firestore_1.where)("oId", "==", user.oId), (0, firestore_1.where)("product", "==", "providers"), (0, firestore_1.orderBy)("requestedVisibleAddresses")]);
-            if (accessRequests === 0)
-                return;
-            if (accessRequests === 1) {
-                const userRequestingAccess = Object.entries(await firebaseQuery.getDocsWhere("users", [(0, firestore_1.where)("oId", "==", user.oId), (0, firestore_1.where)("product", "==", "providers"), (0, firestore_1.orderBy)("requestedVisibleAddresses")]) || {})[0];
-                return {
-                    dismissible: false,
-                    severity: "primary",
-                    title: `${userRequestingAccess[1].details.forename} ${userRequestingAccess[1].details.surname} has requested access to view addresses.`,
-                    message: `Click to review the addresses and grant access to the user.`,
-                    link: `/${user.product}/users/${userRequestingAccess[0]}`,
-                    buttonTitle: "View request",
-                };
-            }
-            return {
-                dismissible: false,
-                severity: "warning",
-                title: `Multiple users have requested access to view addresses.`,
-                message: `Click to review the addresses and grant access to the user.`,
-                link: `/${user.product}/organisation/staff/all`,
-                buttonTitle: "View request",
-            };
-        },
-    },
-    requestedVisiblePlacementListings: {
-        callback: async (user) => {
-            const accessRequests = await firebaseQuery.getCount("users", [(0, firestore_1.where)("oId", "==", user.oId), (0, firestore_1.where)("product", "==", "providers"), (0, firestore_1.orderBy)("requestedVisibleListings")]);
-            if (accessRequests === 0)
-                return;
-            if (accessRequests === 1) {
-                const userRequestingAccess = Object.entries(await firebaseQuery.getDocsWhere("users", [(0, firestore_1.where)("oId", "==", user.oId), (0, firestore_1.where)("product", "==", "providers"), (0, firestore_1.orderBy)("requestedVisibleListings")]) || {})[0];
-                return {
-                    dismissible: false,
-                    severity: "primary",
-                    title: `${userRequestingAccess[1].details.forename} ${userRequestingAccess[1].details.surname} has requested access to view placement listings.`,
-                    message: `Click to review the placement listings and grant access to the user.`,
-                    link: `/${user.product}/users/${userRequestingAccess[0]}`,
-                    buttonTitle: "View request",
-                };
-            }
-            return {
-                dismissible: false,
-                severity: "warning",
-                title: `Multiple users have requested access to view placement listings.`,
-                message: `Click to review the placement listings and grant access to the user.`,
-                link: `/${user.product}/organisation/staff/all`,
-                buttonTitle: "View request",
-            };
-        },
-    },
-    applicationRequireReview: {
-        callback: async (user) => {
-            const applicationCount = await firebaseQuery.getCount("applications", [(0, firestore_1.where)("providerId", "==", user.oId), (0, firestore_1.where)("reqUserType", "==", "Staff"), (0, firestore_1.where)("status", "==", "submitted")]);
-            if (applicationCount === 0)
-                return;
-            return {
-                dismissible: false,
-                severity: "primary",
-                title: `${applicationCount} applications require your review.`,
-                message: `Click to view ${applicationCount} that require your attention.`,
-                link: `/${user.product}/placementListings/applicants`,
-                buttonTitle: "View applications",
-            };
-        },
-    },
-    completeStudentDocs: {
-        callback: async (user) => {
-            return {};
-        },
-    },
-    reviewOnboarding: {
-        callback: async (user) => {
-            return {};
-        },
-    },
-    completeListing: {
-        callback: async (user) => {
-            return {};
-        },
-    },
-    completeAddress: {
-        callback: async (user) => {
-            return {};
-        },
-    },
-    registrationRequests: {
-        callback: async (user) => {
-            return {};
-        },
-    },
-    placementStarting: {
-        callback: async (user) => {
-            return {};
-        },
-    },
-    completeFeedback: {
-        callback: async (user) => {
-            return {};
-        },
-    },
-    setUpFeedback: {
-        callback: async (user) => {
-            return {};
-        },
-    },
-};
-const getTips = async (user, organisation) => {
+// const providerTasks:ProviderTaskObject = {
+//     requestedVisibleAddresses: {
+//         callback: async (user) => {
+//             if (!getAccess(user, "addStaff")) return;
+//             const accessRequests = await firebaseQuery.getCount("users", [where("oId", "==", user.oId), where("product", "==", "providers"), orderBy("requestedVisibleAddresses")]) - ((Array.isArray(user?.requestedVisibleAddresses) && user?.requestedVisibleAddresses.length > 0) ? 1 : 0);
+//             if (accessRequests === 0) return;
+//             if (accessRequests === 1) {
+//                 const userRequestingAccess = Object.entries(await firebaseQuery.getDocsWhere("users", [where("product", "==", "providers"), where("oId", "==", user.oId), orderBy("requestedVisibleAddresses")]) || {})[0] as [string, UserData];
+//                 return {
+//                     dismissible: false,
+//                     severity: "primary",
+//                     title: `${userRequestingAccess[1].details.forename} ${userRequestingAccess[1].details.surname} has requested access to view addresses.`,
+//                     message: `Click to review the addresses and grant access to the user.`,
+//                     link: `/${user.product}/users/${userRequestingAccess[0]}`,
+//                     buttonTitle: "View request",
+//                 } as TaskQueryReturnObject;
+//         }
+//             return {
+//                 dismissible: false,
+//                 severity: "warning",
+//                 title: `Multiple users have requested access to view addresses.`,
+//                 message: `Click to review the addresses and grant access to the user.`,
+//                 link: `/${user.product}/organisation/staff/all`,
+//                 buttonTitle: "View request",
+//             } as TaskQueryReturnObject;
+//         },
+//     },
+//     requestedVisiblePlacementListings: {
+//         callback: async (user) => {
+//             if (!getAccess(user, "addStaff")) return;
+//             const accessRequests = await firebaseQuery.getCount("users", [where("oId", "==", user.oId), where("product", "==", "providers"), orderBy("requestedVisibleListings")])- ((Array.isArray(user?.requestedVisibleListings) && user?.requestedVisibleListings.length > 0) ? 1 : 0);;
+//             if (accessRequests === 0) return;
+//             if (accessRequests === 1) {
+//                 const userRequestingAccess = Object.entries(await firebaseQuery.getDocsWhere("users", [where("oId", "==", user.oId), where("product", "==", "providers"), orderBy("requestedVisibleListings")]) || {})[0] as [string, UserData];
+//                 return {
+//                     dismissible: false,
+//                     severity: "primary",
+//                     title: `${userRequestingAccess[1].details.forename} ${userRequestingAccess[1].details.surname} has requested access to view placement listings.`,
+//                     message: `Click to review the placement listings and grant access to the user.`,
+//                     link: `/${user.product}/users/${userRequestingAccess[0]}`,
+//                     buttonTitle: "View request",
+//                 } as TaskQueryReturnObject;
+//         }
+//             return {
+//                 dismissible: false,
+//                 severity: "warning",
+//                 title: `Multiple users have requested access to view placement listings.`,
+//                 message: `Click to review the placement listings and grant access to the user.`,
+//                 link: `/${user.product}/organisation/staff/all`,
+//                 buttonTitle: "View request",
+//             } as TaskQueryReturnObject;
+//         },
+//     },
+//     applicationRequireReview: {
+//         callback: async (user) => {
+//             const constraints = [where("providerId", "==", user.oId), where("reqUserType", "==", "Staff"), where("status", "==", "submitted")];
+//             if (user.userGroup !== "admin") {
+//                 if (!user.viewPlacementListings || user.viewPlacementListings === "none") return;
+//                 if (!user.viewAddresses || user.viewAddresses === "none") return;
+//                 if (user.viewPlacementListings === "request") {
+//                     if (!user.visibleListings || user.visibleListings?.length === 0) return;
+//                     constraints.push(where("listingId", 'in', user.visibleListings));
+//                 } else {
+//                     // viewPlacementListings must be 'all'
+//                     if (user.viewAddresses === "request") {
+//                         if (!user.visibleAddresses || user.visibleAddresses?.length === 0) return;
+//                         constraints.push(where("addressId", 'in', user.visibleAddresses));
+//                     }
+//                 }
+//             }
+//             const applicationCount = await firebaseQuery.getCount("applications", constraints);
+//             if (applicationCount === 0) return;
+//             return {
+//                 dismissible: false,
+//                 severity: "primary",
+//                 title: `${applicationCount} applications require your review.`,
+//                 message: `Click to view ${applicationCount} that require your attention.`,
+//                 link: `/${user.product}/placementListings/applicants`,
+//                 buttonTitle: "View applications",
+//             } as TaskQueryReturnObject;
+//         },
+//     },
+//     completeStudentDocs: {
+//         callback: async (user) => {
+//             return;
+//             return {} as TaskQueryReturnObject;
+//         },
+//     },
+//     reviewOnboarding: {
+//         callback: async (user) => {
+//             const constraints = [where("providerId", "==", user.oId), where("onboarding.completed.accepted", "==", false), where("onboarding.completed.submitted", "==", true), where("endDate", ">=", dateToString(new Date()))]
+//             if (user.userGroup !== "admin") {
+//                 if (!user.viewPlacementListings || user.viewPlacementListings === "none") return;
+//                 if (!user.viewAddresses || user.viewAddresses === "none") return;
+//                 if (user.viewPlacementListings === "request") {
+//                     if (!user.visibleListings || user.visibleListings?.length === 0) return;
+//                     constraints.push(where("placementId", 'in', user.visibleListings));
+//                 } else {
+//                     // viewPlacementListings must be 'all'
+//                     if (user.viewAddresses === "request") {
+//                         if (!user.visibleAddresses || user.visibleAddresses?.length === 0) return;
+//                         constraints.push(where("addressId", 'in', user.visibleAddresses));
+//                     }
+//                 }
+//             }
+//             const toReview = await firebaseQuery.getCount("placements", constraints);
+//             if (toReview === 0) return;
+//             if (toReview === 1) {
+//                 const placement = Object.entries(await firebaseQuery.getDocsWhere("placements", constraints) || {})[0] as [string, StudentPlacementData];
+//                 const student = await firebaseQuery.getDocData(["users", placement[1].uid]) as UserData;
+//                 return {
+//                     dismissible: false,
+//                     severity: "primary",
+//                     title: `${student.details.forename} ${student.details.surname} has completed their onboarding for their placement from ${convertDate(placement[1].startDate, "visual")} to ${convertDate(placement[1].endDate, "visual")}`,
+//                     message: `Click to view the placement and review the onboarding.`,
+//                     link: `/${user.product}/placements/${placement[0]}`,
+//                     buttonTitle: "View",
+//                 } as TaskQueryReturnObject;
+//         }
+//             return {
+//                 dismissible: false,
+//                 severity: "primary",
+//                 title: `${toReview} student have completed their onboarding.`,
+//                 message: `Click to view your placements and approve completed onboarding`,
+//                 link: `/${user.product}/placementListings/placements`,
+//                 buttonTitle: "View placements",
+//             } as TaskQueryReturnObject;
+//         },
+//     },
+//     uploadOnboarding: {
+//         callback: async (user) => {
+//             const constraints = [where("providerId", "==", user.oId), where("onboarding", "==", null), where("endDate", ">=", dateToString(new Date()))];
+//             if (user.userGroup !== "admin") {
+//                 if (!user.viewPlacementListings || user.viewPlacementListings === "none") return;
+//                 if (!user.viewAddresses || user.viewAddresses === "none") return;
+//                 if (user.viewPlacementListings === "request") {
+//                     if (!user.visibleListings || user.visibleListings?.length === 0) return;
+//                     constraints.push(where("placementId", 'in', user.visibleListings));
+//                 } else {
+//                     // viewPlacementListings must be 'all'
+//                     if (user.viewAddresses === "request") {
+//                         if (!user.visibleAddresses || user.visibleAddresses?.length === 0) return;
+//                         constraints.push(where("addressId", 'in', user.visibleAddresses));
+//                     }
+//                 }
+//             }
+//             const withoutOnboarding = await firebaseQuery.getCount("placements", constraints);
+//             if (withoutOnboarding === 0) return;
+//             if (withoutOnboarding === 1) {
+//                 const placement = Object.entries(await firebaseQuery.getDocsWhere("placements", constraints) || {})[0] as [string, StudentPlacementData];
+//                 const student = await firebaseQuery.getDocData(["users", placement[1].uid]) as UserData;
+//                 return {
+//                     dismissible: false,
+//                     severity: "primary",
+//                     title: `Send onboarding documents to ${student.details.forename} ${student.details.surname}'s placement from ${convertDate(placement[1].startDate, "visual")} to ${convertDate(placement[1].endDate, "visual")}`,
+//                     message: `Click to view the placement and add or dismiss onboarding reminders.`,
+//                     link: `/${user.product}/placements/${placement[0]}`,
+//                     buttonTitle: "View",
+//                 } as TaskQueryReturnObject;
+//         }
+//             return {
+//                 dismissible: false,
+//                 severity: "primary",
+//                 title: `Set up onboarding for ${withoutOnboarding} placements to prepare yourself and your students.`,
+//                 message: `Click to view your placements and add or dismiss onboarding reminders.`,
+//                 link: `/${user.product}/placementListings/placements`,
+//                 buttonTitle: "View placements",
+//             } as TaskQueryReturnObject;
+//         },
+//     },
+//     completeListing: {
+//         callback: async (user) => {
+//             const constraints = [where("providerId", "==", user.oId), where("status", "==", "draft")];
+//             if (user.userGroup !== "admin") {
+//                 if (!user.viewPlacementListings || user.viewPlacementListings === "none") return;
+//                 if (!user.viewAddresses || user.viewAddresses === "none") return;
+//                 if (user.viewPlacementListings === "request") {
+//                     if (!user.visibleListings || user.visibleListings?.length === 0) return;
+//                     constraints.push(where(documentId(), 'in', user.visibleListings));
+//                 } else {
+//                     // viewPlacementListings must be 'all'
+//                     if (user.viewAddresses === "request") {
+//                         if (!user.visibleAddresses || user.visibleAddresses?.length === 0) return;
+//                         constraints.push(where("addressId", 'in', user.visibleAddresses));
+//                     }
+//                 }
+//             }
+//             const incompleteListings = await firebaseQuery.getCount("placementListings", constraints);
+//             if (incompleteListings === 0) return;
+//             if (incompleteListings === 1) {
+//                 const incompleteListing = Object.entries(await firebaseQuery.getDocsWhere("placementListings", constraints) || {})[0] as [string, PlacementListing];
+//                 const address = incompleteListing[1].addressId ? await firebaseQuery.getDocData(["addresses", incompleteListing[1].addressId]) as OrganisationAddress : undefined;
+//                 return {
+//                     dismissible: false,
+//                     severity: "info",
+//                     title: `Your listing '${incompleteListing[1].title || "unnamed"}' at ${address ? `${address["address-line1"]}, ${address.postal_code.toUpperCase()}, ${capitaliseWords(camelCaseToNormal(address.country))}` : "unknown address"} requires more information before publishing.`,
+//                     message: `Click to complete and publish the placement listing.`,
+//                     link: `/${user.product}/addListing/${incompleteListing[0]}`,
+//                     buttonTitle: "View listing",
+//                 } as TaskQueryReturnObject;
+//         }
+//             return {
+//                 dismissible: false,
+//                 severity: "info",
+//                 title: `You have ${incompleteListings} draft listings waiting to be published.`,
+//                 message: `Click to review and publish the placement listings.`,
+//                 link: `/${user.product}/placementListings/listings`,
+//                 buttonTitle: "View listings",
+//             } as TaskQueryReturnObject;
+//         },
+//     },
+//     completeAddress: {
+//         callback: async (user) => {
+//             const constraints = [where("product", "==", "providers"), where("oId", "==", user.oId), where("stage", "!=", "complete")];
+//             if (user.userGroup !== "admin") {
+//                 if (!user.viewAddresses || user.viewAddresses === "none") return;
+//                 if (user.viewAddresses === "request") {
+//                     if (!user.visibleAddresses || user.visibleAddresses?.length === 0) return;
+//                     constraints.push(where("addressId", 'in', user.visibleAddresses));
+//                 }
+//             }
+//             const incompleteAddresses = await firebaseQuery.getCount("addresses", constraints);
+//             if (incompleteAddresses === 0) return;
+//             if (incompleteAddresses === 1) {
+//                 const address = Object.entries(await firebaseQuery.getDocsWhere("addresses", constraints) || {})[0] as [string, OrganisationAddress];
+//                 return {
+//                     dismissible: false,
+//                     severity: "info",
+//                     title: `Your address: ${address[1]["address-line1"]}, ${address[1].postal_code.toUpperCase()}, ${capitaliseWords(camelCaseToNormal(address[1].country))} is currently incomplete.`,
+//                     message: `Click to complete the addresses.`,
+//                     link: `/${user.product}/addAddress/${address[0]}`,
+//                     buttonTitle: "View address",
+//                 } as TaskQueryReturnObject;
+//         }
+//             return {
+//                 dismissible: false,
+//                 severity: "info",
+//                 title: `You have ${incompleteAddresses} draft addresses waiting to be published.`,
+//                 message: `Click to review the addresses.`,
+//                 link: `/${user.product}/organisation/addresses`,
+//                 buttonTitle: "View addresses",
+//             } as TaskQueryReturnObject;
+//         },
+//     },
+//     registrationRequests: {
+//         callback: async (user) => {
+//             if (!getAccess(user, "addStaff")) return;
+//             const regRequests = await firebaseQuery.getCount("requests", [where("product", "==", user.product), where("oId", "==", user.oId)]);
+//             if (regRequests === 0) return;
+//             if (regRequests === 1) {
+//                 const request = Object.entries(await firebaseQuery.getDocsWhere("requests", [where("product", "==", user.product), where("oId", "==", user.oId)]) || {})[0] as [string, RegistrationRequest];
+//                 return {
+//                     dismissible: false,
+//                     severity: "primary",
+//                     title: `${request[1].forename} ${request[1].surname} has requested to access your organisation.`,
+//                     message: `Click to review these request.`,
+//                     link: `/${user.product}/organisation/staff/requests`,
+//                     buttonTitle: "View requests",
+//                 } as TaskQueryReturnObject;
+//         }
+//             return {
+//                 dismissible: false,
+//                 severity: "primary",
+//                 title: `${regRequests} people have requested to register with your organisation.`,
+//                 message: `Click to review these requests.`,
+//                 link: `/${user.product}/organisation/staff/requests`,
+//                 buttonTitle: "View requests",
+//             } as TaskQueryReturnObject;
+//         },
+//     },
+//     activateStaff: {
+//         callback: async (user) => {
+//             if (!getAccess(user, "addStaff")) return;
+//             const inactiveAccounts = await firebaseQuery.getCount("users", [where("product", "==", user.product), where("oId", "==", user.oId), where("status", "==", "inactive")]);
+//             if (inactiveAccounts === 0) return;
+//             if (inactiveAccounts === 1) {
+//                 const account = Object.entries(await firebaseQuery.getDocsWhere("users", [where("product", "==", user.product), where("oId", "==", user.oId), where("status", "==", "inactive")]) || {})[0] as [string, UserData];
+//                 return {
+//                     dismissible: false,
+//                     severity: "info",
+//                     title: `Activate ${account[1].details.forename} ${account[1].details.surname}'s staff account.`,
+//                     message: "Activate this account to give the user access to Placementt.",
+//                     link: `/${user.product}/organisation/staff/all`,
+//                     buttonTitle: "View accounts",
+//                 } as TaskQueryReturnObject;
+//         }
+//             return {
+//                 dismissible: false,
+//                 severity: "info",
+//                 title: `${inactiveAccounts} staff have inactive active accounts.`,
+//                 message: "Activate these accounts to give the user access to Placementt.",
+//                 link: `/${user.product}/organisation/staff/all`,
+//                 buttonTitle: "View accounts",
+//             } as TaskQueryReturnObject;
+//         },
+//     },
+//     placementStarting: {
+//         callback: async (user) => {
+//             const sevenDaysInFuture = new Date();
+//             sevenDaysInFuture.setDate(sevenDaysInFuture.getDate() + 7)
+//             const constraints = [where("providerId", "==", user.oId), where("startDate", "<=", convertDate(sevenDaysInFuture, "dbstring")), where("startDate", ">", dateToString(new Date()))];
+//             if (user.userGroup !== "admin") {
+//                 if (!user.viewPlacementListings || user.viewPlacementListings === "none") return;
+//                 if (!user.viewAddresses || user.viewAddresses === "none") return;
+//                 if (user.viewPlacementListings === "request") {
+//                     if (!user.visibleListings || user.visibleListings?.length === 0) return;
+//                     constraints.push(where(documentId(), 'in', user.visibleListings));
+//                 } else {
+//                     // viewPlacementListings must be 'all'
+//                     if (user.viewAddresses === "request") {
+//                         if (!user.visibleAddresses || user.visibleAddresses?.length === 0) return;
+//                         constraints.push(where("addressId", 'in', user.visibleAddresses));
+//                     }
+//                 }
+//             }
+//             const placementsStartingSoon = await firebaseQuery.getCount("placements", constraints);
+//             if (placementsStartingSoon === 0) return;
+//             if (placementsStartingSoon === 1) {
+//                 const placement = Object.entries(await firebaseQuery.getDocsWhere("placements", constraints) || {})[0] as [string, StudentPlacementData];
+//                 const student = placement[1].uid ? await firebaseQuery.getDocData(["users", placement[1].uid]) as UserData : {
+//                     details: {
+//                         forename: placement[1].studentForename,
+//                         surname: placement[1].studentSurname,
+//                     }
+//                 };
+//                 return {
+//                     dismissible: false,
+//                     severity: "success",
+//                     title: `${student.details.forename} ${student.details.surname}'s placement from ${convertDate(placement[1].startDate, "visual")} to ${convertDate(placement[1].endDate, "visual")} is starting in less than a week.`,
+//                     message: `Click to view the placement and acquaint yourself with the student.`,
+//                     link: `/${user.product}/placements/${placement[0]}`,
+//                     buttonTitle: "View",
+//                 } as TaskQueryReturnObject;
+//         }
+//             return {
+//                 dismissible: false,
+//                 severity: "success",
+//                 title: `${placementsStartingSoon} placements starting soon.`,
+//                 message: `Click to view scheduled placements.`,
+//                 link: `/${user.product}/placementListings/placements`,
+//                 buttonTitle: "View placements",
+//             } as TaskQueryReturnObject;
+//         },
+//     },
+//     completeFeedback: {
+//         callback: async (user) => {
+//             return;
+//             return {} as TaskQueryReturnObject;
+//         },
+//     },
+//     setUpFeedback: {
+//         callback: async (user) => {
+//             return;
+//             return {} as TaskQueryReturnObject;
+//         },
+//     },
+// }
+const getTips = async (user, organisation, addresses) => {
     const tipsObject = {
         providers: providerTips,
         institutes: instituteTips,
@@ -574,7 +1035,11 @@ const getTips = async (user, organisation) => {
     };
     const includedItems = Object.entries(tipsObject[user.product]).filter(([k]) => { var _a; return !((_a = user.dismissedTips) === null || _a === void 0 ? void 0 : _a.includes(k)); });
     const processedTips = await includedItems.reduce(async (acc, [itemName, item]) => {
-        const queryResult = await item.callback(user, organisation);
+        const callbackParams = [user, organisation];
+        if ((itemName === "addAddresses" || itemName === "addSchools") && addresses) {
+            callbackParams.push(addresses);
+        }
+        const queryResult = await item.callback(...callbackParams);
         if (!queryResult)
             return await acc;
         const queryResultArray = Array.isArray(queryResult) ? queryResult : [queryResult];
@@ -585,16 +1050,16 @@ const getTips = async (user, organisation) => {
     return processedTips;
 };
 exports.getTips = getTips;
-const getTasks = async (user, organisation, cohort) => {
+const getTasks = async ({ user, organisation, cohort, school }) => {
     // Cohort is either a specific one or all.
     if (user.product === "institutes" && user.userType === "Staff" && organisation) {
-        return await getInstituteTasks(user, organisation, cohort);
+        return await getInstituteTasks({ user, organisation, cohort, school });
     }
     if (user.product === "students" || user.userType === "Students") {
         return await getStudentTasks(user, organisation, cohort);
     }
     if (user.product === "providers" && organisation) {
-        return await getProviderTasks(user, organisation);
+        // return await getProviderTasks(user, organisation);
     }
     return [];
 };
@@ -611,47 +1076,55 @@ const getStudentTasks = async (user, organisation, cohort) => {
     }, Promise.resolve([]));
     return processedTasks;
 };
-const getProviderTasks = async (user, organisation, cohort) => {
-    const processedTasks = await Object.entries(providerTasks).reduce(async (acc, [itemName, item]) => {
-        const queryResult = await item.callback(user);
-        if (!queryResult)
-            return await acc;
-        const queryResultArray = Array.isArray(queryResult) ? queryResult : [queryResult];
-        const results = queryResultArray.map((r) => ({ itemName: itemName, ...r }));
-        (await acc).push(...results);
-        return await acc;
-    }, Promise.resolve([]));
-    return processedTasks;
-};
-const getInstituteTasks = async (user, organisation, cohort) => {
-    var _a;
+// const getProviderTasks = async (user: UserData, organisation: InstituteData|ProviderData, cohort?: CohortData):Promise<(TaskQueryReturnObject)[]> => {
+//     const processedTasks = await Object.entries(providerTasks).reduce(async (acc, [itemName, item]) => {
+//         const queryResult = await item.callback(user);
+//         if (!queryResult) return await acc;
+//         const queryResultArray = Array.isArray(queryResult) ? queryResult : [queryResult];
+//         const results = queryResultArray.map((r) => ({itemName: itemName as ProviderTaskNames, ...r}));
+//         (await acc).push(...results);
+//         return await acc;
+//     }, Promise.resolve<TaskQueryReturnObject[]>([]));
+//     return processedTasks;};
+const getInstituteTasks = async ({ user, organisation, cohort, school }) => {
     let fCohort = cohort;
-    if (!fCohort) {
-        // get all associated cohorts.
-        if (user.viewCohorts === "none")
+    let fSchool = school;
+    const getCohortsOrSchoolsIfNotProvided = async (type) => {
+        var _a;
+        if (user[`view${type}`] === "none")
             return ([]);
-        if (user.userGroup === "admin" || user.viewCohorts === "all") {
-            const cohorts = await firebaseQuery.getDocsWhere("cohorts", [(0, firestore_1.where)("product", "==", user.product), (0, firestore_1.where)("oId", "==", user.oId), (0, firestore_1.where)("stage", "==", "created")]);
-            fCohort = Object.entries(cohorts);
+        if (user.userGroup === "admin" || user[`view${type}`] === "all") {
+            const constraints = [(0, firestore_1.where)("oId", "==", user.oId)];
+            if (type === "cohorts") {
+                constraints.push((0, firestore_1.where)("product", "==", user.product), (0, firestore_1.where)("stage", "==", "created"));
+            }
+            const cohorts = await firebaseQuery.getDocsWhere(type, constraints);
+            return Object.entries(cohorts);
         }
-        if (user.viewCohorts === "some") {
-            const cohorts = await ((_a = user.visibleCohorts) === null || _a === void 0 ? void 0 : _a.split(",").reduce(async (acc, cohortId) => {
-                const cohort = await firebaseQuery.getDocData(["cohorts", cohortId]);
-                if (cohort.stage !== "created") {
+        if (user[`view${type}`] === "some") {
+            const items = await ((_a = user[`visible${type}s`]) === null || _a === void 0 ? void 0 : _a.reduce(async (acc, itemId) => {
+                const item = await firebaseQuery.getDocData([type, itemId]);
+                if (type === "cohorts" && item.stage !== "created") {
                     return acc;
                 }
-                acc[cohortId] = cohort;
+                acc[itemId] = item;
                 return acc;
             }, Promise.resolve([])));
-            fCohort = cohorts;
+            return items;
         }
+    };
+    if (!fCohort) {
+        fCohort = await getCohortsOrSchoolsIfNotProvided("cohorts");
+    }
+    if (!fSchool) {
+        fSchool = await getCohortsOrSchoolsIfNotProvided("schools");
     }
     const processedTasks = await Object.entries(instituteTasks).reduce(async (acc, [itemName, item]) => {
         if (!fCohort) {
             console.log("No cohorts to retrieve tasks for");
             return ([]);
         }
-        const queryResult = await item.callback(user, organisation, fCohort);
+        const queryResult = await item.callback({ user, organisation, cohorts: fCohort, schools: fSchool });
         if (!queryResult)
             return await acc;
         const queryResultArray = Array.isArray(queryResult) ? queryResult : [queryResult];