sunrise-cms/handlers/api-get/milestoneICS.ts

/* eslint-disable unicorn/filename-case */

import ical, { ICalEventData, ICalEventStatus } from "ical-generator";

import {
    getWorkOrderMilestones,
    WorkOrderMilestoneFilters
} from "../../helpers/lotOccupancyDB/getWorkOrderMilestones.js";

import type { RequestHandler } from "express";

import * as configFunctions from "../../helpers/functions.config.js";

const timeStringSplitRegex = /[ :-]/;

function escapeHTML(stringToEscape: string) {
    return stringToEscape.replace(
        /[^\d A-Za-z]/g,
        (c) => "&#" + c.codePointAt(0) + ";"
    );
}

export const handler: RequestHandler = (request, response) => {
    const urlRoot =
        "http://" +
        request.hostname +
        (configFunctions.getProperty("application.httpPort") === 80
            ? ""
            : ":" + configFunctions.getProperty("application.httpPort")) +
        configFunctions.getProperty("reverseProxy.urlPrefix");

    const workOrderMilestoneFilters: WorkOrderMilestoneFilters = {
        workOrderTypeIds: request.query.workOrderTypeIds as string,
        workOrderMilestoneTypeIds: request.query
            .workOrderMilestoneTypeIds as string
    };

    if (request.query.workOrderId) {
        workOrderMilestoneFilters.workOrderId = request.query
            .workOrderId as string;
    } else {
        workOrderMilestoneFilters.workOrderMilestoneDateFilter = "recent";
    }

    const workOrderMilestones = getWorkOrderMilestones(
        workOrderMilestoneFilters,
        { includeWorkOrders: true, orderBy: "date" }
    );

    const calendar = ical({
        name: "Work Order Milestone Calendar",
        url: urlRoot + "/workOrders"
    });

    if (request.query.workOrderId && workOrderMilestones.length > 0) {
        calendar.name("Work Order #" + workOrderMilestones[0].workOrder.workOrderNumber);
        calendar.url(urlRoot + "/workOrders/" + workOrderMilestones[0].workOrderId);
    }

    calendar.prodId({
        company: "cityssm.github.io",
        product: configFunctions.getProperty("application.applicationName")
    });

    for (const milestone of workOrderMilestones) {
        const milestoneTimePieces = (
            milestone.workOrderMilestoneDateString +
            " " +
            milestone.workOrderMilestoneTimeString
        ).split(timeStringSplitRegex);

        const milestoneDate = new Date(
            Number.parseInt(milestoneTimePieces[0], 10),
            Number.parseInt(milestoneTimePieces[1], 10) - 1,
            Number.parseInt(milestoneTimePieces[2], 10),
            Number.parseInt(milestoneTimePieces[3], 10),
            Number.parseInt(milestoneTimePieces[4], 10)
        );

        // Build summary (title in Outlook)

        let summary = (
            milestone.workOrderMilestoneTypeId
                ? milestone.workOrderMilestoneType
                : milestone.workOrderMilestoneDescription
        ).trim();

        if (milestone.workOrder.workOrderLotOccupancies.length > 0) {
            let occupantCount = 0;

            for (const lotOccupancy of milestone.workOrder
                .workOrderLotOccupancies) {
                for (const occupant of lotOccupancy.lotOccupancyOccupants) {
                    occupantCount += 1;

                    if (occupantCount === 1) {
                        if (summary !== "") {
                            summary += ": ";
                        }

                        summary += occupant.occupantName;
                    }
                }
            }

            if (occupantCount > 1) {
                summary += " plus " + (occupantCount - 1);
            }
        }

        // Build URL

        const workOrderURL = urlRoot + "/workOrders/" + milestone.workOrderId;

        // Create event

        const eventData: ICalEventData = {
            start: milestoneDate,
            created: new Date(milestone.recordCreate_timeMillis),
            stamp: new Date(milestone.recordCreate_timeMillis),
            lastModified: new Date(
                Math.max(
                    milestone.recordUpdate_timeMillis,
                    milestone.workOrder.recordUpdate_timeMillis
                )
            ),
            allDay: !milestone.workOrderMilestoneTime,
            summary,
            url: workOrderURL
        };

        const calendarEvent = calendar.createEvent(eventData);

        // Build description

        let descriptionHTML =
            "<h1>Milestone Description</h1>" +
            "<p>" +
            escapeHTML(milestone.workOrderMilestoneDescription) +
            "</p>" +
            "<h2>Work Order #" +
            milestone.workOrder.workOrderNumber +
            "</h2>" +
            ("<p>" +
                escapeHTML(milestone.workOrder.workOrderDescription) +
                "</p>") +
            ('<p><a href="' + workOrderURL + '">' + workOrderURL + "</a></p>");

        if (milestone.workOrder.workOrderLotOccupancies.length > 0) {
            descriptionHTML +=
                "<h2>Related " +
                escapeHTML(configFunctions.getProperty("aliases.occupancies")) +
                "</h2>" +
                '<table border="1"><thead><tr>' +
                ("<th>" +
                    escapeHTML(
                        configFunctions.getProperty("aliases.occupancy")
                    ) +
                    " Type</th>") +
                ("<th>" +
                    escapeHTML(configFunctions.getProperty("aliases.lot")) +
                    "</th>") +
                "<th>Start Date</th>" +
                "<th>End Date</th>" +
                ("<th>" +
                    escapeHTML(
                        configFunctions.getProperty("aliases.occupants")
                    ) +
                    "</th>") +
                "</tr></thead>" +
                "<tbody>";

            for (const occupancy of milestone.workOrder
                .workOrderLotOccupancies) {
                descriptionHTML +=
                    "<tr>" +
                    ("<td>" +
                        '<a href="' +
                        urlRoot +
                        "/lotOccupancies/" +
                        occupancy.lotOccupancyId +
                        '">' +
                        escapeHTML(occupancy.occupancyType) +
                        "</a></td>") +
                    ("<td>" +
                        (occupancy.lotName
                            ? escapeHTML(occupancy.lotName)
                            : "(Not Set)") +
                        "</td>") +
                    ("<td>" + occupancy.occupancyStartDateString + "</td>") +
                    "<td>" +
                    (occupancy.occupancyEndDate
                        ? occupancy.occupancyEndDateString
                        : "(No End Date)") +
                    "</td>" +
                    "<td>";

                for (const occupant of occupancy.lotOccupancyOccupants) {
                    descriptionHTML +=
                        escapeHTML(occupant.occupantName) + "<br />";
                }

                descriptionHTML += "</td>" + "</tr>";
            }

            descriptionHTML += "</tbody></table>";
        }

        if (milestone.workOrder.workOrderLots.length > 0) {
            descriptionHTML +=
                "<h2>Related " +
                escapeHTML(configFunctions.getProperty("aliases.lots")) +
                "</h2>" +
                '<table border="1"><thead><tr>' +
                ("<th>" +
                    escapeHTML(configFunctions.getProperty("aliases.lot")) +
                    " Type</th>") +
                ("<th>" +
                    escapeHTML(configFunctions.getProperty("aliases.map")) +
                    "</th>") +
                ("<th>" +
                    escapeHTML(configFunctions.getProperty("aliases.lot")) +
                    " Type" +
                    "</th>") +
                "<th>Status</th>" +
                "</tr></thead>" +
                "<tbody>";

            for (const lot of milestone.workOrder.workOrderLots) {
                descriptionHTML +=
                    "<tr>" +
                    ("<td>" +
                        '<a href="' +
                        urlRoot +
                        "/lots/" +
                        lot.lotId +
                        '">' +
                        escapeHTML(lot.lotName) +
                        "</a></td>") +
                    ("<td>" + escapeHTML(lot.mapName) + "</td>") +
                    ("<td>" + escapeHTML(lot.lotType) + "</td>") +
                    ("<td>" + escapeHTML(lot.lotStatus) + "</td>") +
                    "</tr>";
            }

            descriptionHTML += "</tbody></table>";
        }

        calendarEvent.description({
            plain: workOrderURL,
            html: descriptionHTML
        });

        // Set status

        if (milestone.workOrderMilestoneCompletionDate) {
            calendarEvent.status(ICalEventStatus.CONFIRMED);
        }

        // Add categories

        if (milestone.workOrderMilestoneTypeId) {
            calendarEvent.createCategory({
                name: milestone.workOrderMilestoneType
            });

            calendarEvent.createCategory({
                name: milestone.workOrder.workOrderType
            });
        }

        // Set location

        if (milestone.workOrder.workOrderLots.length > 0) {
            const lotNames = [];

            for (const lot of milestone.workOrder.workOrderLots) {
                lotNames.push(lot.mapName + ": " + lot.lotName);
            }

            calendarEvent.location(lotNames.join(", "));
        }

        // Set organizer / attendees

        if (milestone.workOrder.workOrderLotOccupancies.length > 0) {
            let organizerSet = false;
            for (const lotOccupancy of milestone.workOrder
                .workOrderLotOccupancies) {
                for (const occupant of lotOccupancy.lotOccupancyOccupants) {
                    if (organizerSet) {
                        calendarEvent.createAttendee({
                            name: occupant.occupantName,
                            email: "no-reply@127.0.0.1"
                        });
                    } else {
                        calendarEvent.organizer({
                            name: occupant.occupantName,
                            email: "no-reply@127.0.0.1"
                        });
                        organizerSet = true;
                    }
                }
            }
        } else {
            calendarEvent.organizer({
                name: milestone.recordCreate_userName,
                email: "no-reply@127.0.0.1"
            });
        }
    }

    calendar.serve(response);
};

export default handler;