@openinc/parse-server-opendash 4.0.28 → 4.0.29

package/dist/features/openservice/schedules/calendarSync/functions/eventToSchedule.d.ts

@@ -1,7 +1,7 @@
 import { GraphEventResponse } from "../types/Event.js";
 export type ScheduleCronTimestamp = {
-    startData: Date;
-    endData?: Date;
+    startDate: Date;
+    endDate?: Date;
     number: number;
     unit: "days" | "weeks" | "months";
 };

package/dist/features/openservice/schedules/calendarSync/functions/eventToSchedule.js

@@ -29,29 +29,26 @@ function eventToSchedule(event) {
         ? pattern.interval
         : 1;
     // Prefer explicit range.startDate, fallback to event.start.dateTime
-    let startData;
+    let startDate;
     if (range?.startDate) {
         // range.startDate is YYYY-MM-DD
-        startData = new Date(range.startDate + "T00:00:00Z");
+        startDate = new Date(range.startDate + "T00:00:00Z");
     }
     else if (event.start?.dateTime) {
-        startData = new Date(event.start.dateTime);
+        startDate = new Date(event.start.dateTime);
     }
     // For end, prefer range.endDate. If range.type === 'noEnd' leave undefined.
-    let endData;
+    let endDate;
     if (range?.type === "endDate" && range?.endDate) {
-        endData = new Date(range.endDate + "T00:00:00Z");
+        endDate = new Date(range.endDate + "T00:00:00Z");
     }
-    else if (event.end?.dateTime) {
-        endData = new Date(event.end.dateTime);
-    }
-    if (!startData)
+    if (!startDate)
         return undefined;
     return {
         schedule_type: "timestamp",
         timestamp: {
-            startData,
-            endData,
+            startDate,
+            endDate,
             number: interval,
             unit,
         },

package/dist/features/openservice/schedules/calendarSync/functions/scheduleToEvent.js

@@ -1,10 +1,16 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.scheduleToEvent = scheduleToEvent;
+const dayjs_1 = __importDefault(require("dayjs"));
 async function scheduleToEvent(schedule) {
     console.log("Converting Schedule to Event...");
     try {
-        await schedule.fetchWithInclude("template");
+        await schedule.fetchWithInclude(["template"], {
+            useMasterKey: true,
+        });
     }
     catch (error) {
         console.error("Error fetching template:", error);
@@ -16,19 +22,21 @@ async function scheduleToEvent(schedule) {
     const end = scheduleCron?.timestamp?.endDate ?? templateCron?.timestamp?.endDate;
     const interval = scheduleCron?.timestamp?.number ?? templateCron?.timestamp?.number;
     const unit = scheduleCron?.timestamp?.unit ?? templateCron?.timestamp?.unit;
-    if (!start || !end || !interval || !unit) {
+    if (!start || !interval || !unit) {
         console.log("Insufficient data to create event from schedule.");
         return;
     }
+    const description = schedule.get("description");
     const event = {
         subject: schedule.get("title"),
+        body: { contentType: "Text", content: description ?? "" },
         start: {
             // for single-day/all-day events we use date-only; keep full ISO otherwise
             dateTime: start.toISOString().slice(0, 19),
             timeZone: "UTC",
         },
         end: {
-            dateTime: end.toISOString().slice(0, 19),
+            dateTime: (0, dayjs_1.default)(start).add(1, "day").toISOString().slice(0, 19),
             timeZone: "UTC",
         },
         isAllDay: true,
@@ -65,22 +73,29 @@ async function scheduleToEvent(schedule) {
         pattern = null;
     }
     if (pattern) {
-        event.recurrence = {
-            pattern,
-            range: {
+        const range = end
+            ? {
                 type: "endDate",
                 startDate: toDateOnly(start),
                 endDate: toDateOnly(end),
-            },
+            }
+            : {
+                type: "noEnd",
+                startDate: toDateOnly(start),
+            };
+        event.recurrence = {
+            pattern,
+            range,
         };
-        // if event is all-day, set start/end to date-only values (Graph expects dates)
+        // if event is all-day, set start/end to date-only values (Graph expects dates) => always true for schedules
         if (event.isAllDay) {
             event.start.dateTime = toDateOnly(start);
             // Graph's endDate in event object is exclusive for all-day events; keep as provided for recurrence range
             // Set end to next day to represent an all-day event that begins and ends the same day
             const endForEvent = new Date(start);
             endForEvent.setUTCDate(endForEvent.getUTCDate() + 1);
-            event.end.dateTime = toDateOnly(endForEvent);
+            if (event.end)
+                event.end.dateTime = toDateOnly(endForEvent);
         }
     }
     console.log("Schedule converted to Event:", event);

package/dist/features/openservice/schedules/calendarSync/service/CalendarManager.d.ts

@@ -3,7 +3,11 @@ import { GraphEvent, GraphEventResponse } from "../types/Event.js";
  * Manager for calendar operations via Microsoft Graph API
  */
 export declare class CalendarManager {
-    isValid: boolean;
+    tenantID: string;
+    clientID: string;
+    clientSecret: string;
+    userMail: string;
+    get isValid(): true | string;
     private getAccess;
     /**
      * Create a new event in the calendar
@@ -17,13 +21,14 @@ export declare class CalendarManager {
      * @param event The updated event data
      * @returns
      */
-    updateEvent(eventId: string, event: Partial<GraphEvent>): Promise<unknown>;
+    updateEvent(eventId: string, event: Partial<GraphEvent>): Promise<GraphEventResponse | undefined>;
     /**
      * Delete an event from the calendar
      * @param eventId The ID of the event to delete
      * @returns whether the deletion was successful
      */
     deleteEvent(eventId: string): Promise<boolean | undefined>;
+    fetchEvent(eventId: string): Promise<GraphEventResponse | null>;
     /**
      * Fetch all events in calendar
      * @returns the list of events
@@ -31,4 +36,18 @@ export declare class CalendarManager {
     fetchEvents(): Promise<{
         value: GraphEventResponse[];
     } | undefined>;
+    /**
+     * Fetch changed events since the last delta sync.
+     * On the first call (no deltaLink), returns all current events and a deltaLink
+     * for subsequent incremental calls.
+     * @param deltaLink token from the previous call; omit for the initial full sync
+     */
+    fetchDelta(deltaLink?: string): Promise<{
+        events: (GraphEventResponse & {
+            "@removed"?: {
+                reason: string;
+            };
+        })[];
+        deltaLink: string;
+    } | null>;
 }

package/dist/features/openservice/schedules/calendarSync/service/CalendarManager.js

@@ -2,26 +2,40 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CalendarManager = void 0;
 const index_js_1 = require("../../../../config/index.js");
-const tenantID = index_js_1.ConfigInstance.getInstance().get("MICROSOFT_TENANT_ID");
-const clientID = index_js_1.ConfigInstance.getInstance().get("MICROSOFT_CLIENT_ID");
-const clientSecret = index_js_1.ConfigInstance.getInstance().get("MICROSOFT_CLIENT_SECRET");
-const userMail = index_js_1.ConfigInstance.getInstance().get("MICROSOFT_USER_EMAIL");
 /**
  * Manager for calendar operations via Microsoft Graph API
  */
 class CalendarManager {
-    isValid = !!(tenantID && clientID && clientSecret && userMail);
+    tenantID = index_js_1.ConfigInstance.getInstance().get("MICROSOFT_TENANT_ID") ||
+        index_js_1.ConfigInstance.getInstance().get("OI_MICROSOFT_TENANT_ID");
+    clientID = index_js_1.ConfigInstance.getInstance().get("MICROSOFT_CLIENT_ID") ||
+        index_js_1.ConfigInstance.getInstance().get("OI_MICROSOFT_APP_ID");
+    clientSecret = index_js_1.ConfigInstance.getInstance().get("MICROSOFT_CLIENT_SECRET") ||
+        index_js_1.ConfigInstance.getInstance().get("OI_MICROSOFT_CLIENT_SECRET");
+    userMail = index_js_1.ConfigInstance.getInstance().get("MICROSOFT_USER_EMAIL") ||
+        index_js_1.ConfigInstance.getInstance().get("OI_MICROSOFT_USER_EMAIL");
+    get isValid() {
+        if (!this.tenantID)
+            return "Missing Microsoft Tenant ID";
+        if (!this.clientID)
+            return "Missing Microsoft Client ID";
+        if (!this.clientSecret)
+            return "Missing Microsoft Client Secret";
+        if (!this.userMail)
+            return "Missing Microsoft User Email";
+        return true;
+    }
     async getAccess() {
-        if (!this.isValid)
+        if (this.isValid !== true)
             return null;
         console.log("Getting access token...");
         try {
             const params = new URLSearchParams();
-            params.append("client_id", clientID);
-            params.append("client_secret", clientSecret);
+            params.append("client_id", this.clientID);
+            params.append("client_secret", this.clientSecret);
             params.append("scope", "https://graph.microsoft.com/.default");
             params.append("grant_type", "client_credentials");
-            const response = await fetch(`https://login.microsoftonline.com/${tenantID}/oauth2/v2.0/token`, {
+            const response = await fetch(`https://login.microsoftonline.com/${this.tenantID}/oauth2/v2.0/token`, {
                 method: "POST",
                 headers: {
                     "Content-Type": "application/x-www-form-urlencoded",
@@ -43,12 +57,15 @@ class CalendarManager {
      * @returns the created event response
      */
     async createEvent(event) {
-        if (!userMail || !tenantID || !clientID || !clientSecret)
+        if (!this.userMail ||
+            !this.tenantID ||
+            !this.clientID ||
+            !this.clientSecret)
             return;
         const accessData = await this.getAccess();
         if (!accessData?.access_token)
             return;
-        const res = await fetch(`https://graph.microsoft.com/v1.0/users/${encodeURIComponent(userMail)}/events`, {
+        const res = await fetch(`https://graph.microsoft.com/v1.0/users/${encodeURIComponent(this.userMail)}/events`, {
             method: "POST",
             headers: {
                 Authorization: `Bearer ${accessData.access_token}`,
@@ -70,7 +87,7 @@ class CalendarManager {
         const accessData = await this.getAccess();
         if (!accessData?.access_token)
             return;
-        const res = await fetch(`https://graph.microsoft.com/v1.0/users/${encodeURIComponent(userMail)}/events/${eventId}`, {
+        const res = await fetch(`https://graph.microsoft.com/v1.0/users/${encodeURIComponent(this.userMail)}/events/${eventId}`, {
             method: "PATCH",
             headers: {
                 Authorization: `Bearer ${accessData.access_token}`,
@@ -78,7 +95,7 @@ class CalendarManager {
             },
             body: JSON.stringify(event),
         });
-        const data = await res.json();
+        const data = (await res.json());
         console.log("Event update response:", data);
         return data;
     }
@@ -92,7 +109,7 @@ class CalendarManager {
         if (!accessData?.access_token)
             return;
         // on successful deletion, Microsoft Graph returns 204 No Content, so no JSON to parse
-        const res = await fetch(`https://graph.microsoft.com/v1.0/users/${encodeURIComponent(userMail)}/events/${eventId}`, {
+        const res = await fetch(`https://graph.microsoft.com/v1.0/users/${encodeURIComponent(this.userMail)}/events/${eventId}`, {
             method: "DELETE",
             headers: {
                 Authorization: `Bearer ${accessData.access_token}`,
@@ -101,6 +118,15 @@ class CalendarManager {
         console.log("Event deletion response:", res);
         return res.ok;
     }
+    async fetchEvent(eventId) {
+        const accessData = await this.getAccess();
+        if (!accessData?.access_token)
+            return null;
+        const res = await fetch(`https://graph.microsoft.com/v1.0/users/${encodeURIComponent(this.userMail)}/events/${eventId}`, { headers: { Authorization: `Bearer ${accessData.access_token}` } });
+        if (!res.ok)
+            return null;
+        return (await res.json());
+    }
     /**
      * Fetch all events in calendar
      * @returns the list of events
@@ -109,7 +135,7 @@ class CalendarManager {
         const accessData = await this.getAccess();
         if (!accessData?.access_token)
             return;
-        const res = await fetch(`https://graph.microsoft.com/v1.0/users/${encodeURIComponent(userMail)}/events`, {
+        const res = await fetch(`https://graph.microsoft.com/v1.0/users/${encodeURIComponent(this.userMail)}/events`, {
             method: "GET",
             headers: {
                 Authorization: `Bearer ${accessData.access_token}`,
@@ -119,5 +145,38 @@ class CalendarManager {
         console.log("Calendar events:", data);
         return data;
     }
+    /**
+     * Fetch changed events since the last delta sync.
+     * On the first call (no deltaLink), returns all current events and a deltaLink
+     * for subsequent incremental calls.
+     * @param deltaLink token from the previous call; omit for the initial full sync
+     */
+    async fetchDelta(deltaLink) {
+        const accessData = await this.getAccess();
+        if (!accessData?.access_token)
+            return null;
+        const events = [];
+        let nextUrl = deltaLink || // treat empty string same as missing
+            `https://graph.microsoft.com/v1.0/users/${encodeURIComponent(this.userMail)}/events/delta`;
+        let newDeltaLink = "";
+        while (nextUrl) {
+            const res = await fetch(nextUrl, {
+                headers: { Authorization: `Bearer ${accessData.access_token}` },
+            });
+            if (!res.ok) {
+                console.error(`[CalendarManager] fetchDelta HTTP ${res.status}:`, await res.text());
+                return null;
+            }
+            const data = (await res.json());
+            events.push(...(data.value ?? []));
+            nextUrl = data["@odata.nextLink"];
+            if (data["@odata.deltaLink"])
+                newDeltaLink = data["@odata.deltaLink"];
+        }
+        console.log("Delta fetch result:", { events, newDeltaLink });
+        if (!newDeltaLink)
+            return null;
+        return { events, deltaLink: newDeltaLink };
+    }
 }
 exports.CalendarManager = CalendarManager;

package/dist/features/openservice/schedules/calendarSync/service/CalendarSyncPoller.d.ts

@@ -0,0 +1,17 @@
+export declare class CalendarSyncPoller {
+    private manager;
+    private timer;
+    /**
+     * Start polling the Microsoft Calendar delta feed.
+     * @param intervalMs polling interval in milliseconds (default: 5 minutes)
+     */
+    start(intervalMs?: number): void;
+    stop(): void;
+    private poll;
+    private processEvent;
+    private updateScheduleFromEvent;
+    private createScheduleFromEvent;
+    private handleDeleted;
+    private loadDeltaLink;
+    private saveDeltaLink;
+}

package/dist/features/openservice/schedules/calendarSync/service/CalendarSyncPoller.js

@@ -0,0 +1,165 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CalendarSyncPoller = void 0;
+const node_1 = __importDefault(require("parse/node"));
+const eventToSchedule_js_1 = require("../functions/eventToSchedule.js");
+const calendarMetaHelper_js_1 = require("./calendarMetaHelper.js");
+const CalendarManager_js_1 = require("./CalendarManager.js");
+const index_js_1 = require("../../../../../types/index.js");
+const DELTA_LINK_CONFIG_KEY = "microsoftCalendarDeltaLink";
+class CalendarSyncPoller {
+    manager = new CalendarManager_js_1.CalendarManager();
+    timer = null;
+    /**
+     * Start polling the Microsoft Calendar delta feed.
+     * @param intervalMs polling interval in milliseconds (default: 5 minutes)
+     */
+    start(intervalMs = 5 * 60 * 1000) {
+        if (this.manager.isValid !== true) {
+            console.log("[CalendarSyncPoller] Not started — missing Microsoft credentials.", this.manager.isValid);
+            return;
+        }
+        this.poll().catch(console.error);
+        this.timer = setInterval(() => this.poll().catch(console.error), intervalMs);
+    }
+    stop() {
+        if (this.timer)
+            clearInterval(this.timer);
+    }
+    async poll() {
+        console.log("[CalendarSyncPoller] Polling calendar delta...");
+        const deltaLink = await this.loadDeltaLink();
+        const result = await this.manager.fetchDelta(deltaLink ?? undefined);
+        if (!result) {
+            console.log("[CalendarSyncPoller] Failed to fetch calendar delta.");
+            return;
+        }
+        for (const event of result.events) {
+            try {
+                await this.processEvent(event);
+            }
+            catch (err) {
+                console.error("[CalendarSyncPoller] Error processing event:", event.id, err);
+            }
+        }
+        await this.saveDeltaLink(result.deltaLink);
+    }
+    async processEvent(event) {
+        if (event["@removed"]) {
+            await this.handleDeleted(event.id);
+            return;
+        }
+        const metaEntry = await (0, calendarMetaHelper_js_1.findCalendarMetaByEventId)(event.id);
+        if (metaEntry) {
+            const storedChangeKey = metaEntry.get("values")?.microsoftCalendarChangeKey;
+            // Skip if we caused this change (our write already stored this changeKey)
+            if (event.changeKey && storedChangeKey === event.changeKey)
+                return;
+            await this.updateScheduleFromEvent(metaEntry, event);
+        }
+        else {
+            // Delta responses omit most properties; fetch the full event before creating a schedule
+            const fullEvent = await this.manager.fetchEvent(event.id);
+            if (!fullEvent)
+                return;
+            await this.createScheduleFromEvent(fullEvent);
+        }
+    }
+    async updateScheduleFromEvent(metaEntry, event) {
+        const scheduleId = metaEntry.get("entryObjectId");
+        if (!scheduleId)
+            return;
+        // Delta responses omit most fields; fetch the full event for title/body/cron
+        const fullEvent = await this.manager.fetchEvent(event.id) ?? event;
+        const schedule = await new node_1.default.Query(index_js_1.Maintenance_Schedule).get(scheduleId, { useMasterKey: true });
+        if (fullEvent.subject)
+            schedule.set("title", fullEvent.subject);
+        if (fullEvent.bodyPreview)
+            schedule.set("description", fullEvent.bodyPreview);
+        const cronData = (0, eventToSchedule_js_1.eventToSchedule)(fullEvent);
+        if (cronData)
+            schedule.set("cron", cronData);
+        // useMasterKey prevents afterSaveHook from re-syncing back to calendar
+        await schedule.save(null, { useMasterKey: true });
+        if (event.changeKey) {
+            await (0, calendarMetaHelper_js_1.updateCalendarChangeKey)(metaEntry, event.changeKey, fullEvent);
+        }
+    }
+    async createScheduleFromEvent(event) {
+        const parsed = parseEventSubject(event.subject);
+        if (!parsed) {
+            console.log(`[CalendarSyncPoller] Skipping event "${event.subject}" (${event.id}) — subject does not match expected format: '"<source>" - <title>'.`);
+            return;
+        }
+        const source = await new node_1.default.Query(index_js_1.Source)
+            .equalTo("name", parsed.sourceName)
+            .first({ useMasterKey: true });
+        if (!source) {
+            console.log(`[CalendarSyncPoller] Skipping event "${event.subject}" (${event.id}) — no Source found with name "${parsed.sourceName}".`);
+            return;
+        }
+        const schedule = new index_js_1.Maintenance_Schedule();
+        schedule.set("title", event.subject);
+        schedule.set("source", source);
+        schedule.set("enabled", true);
+        schedule.set("tenant", source.get("tenant"));
+        if (event.bodyPreview)
+            schedule.set("description", event.bodyPreview);
+        const cronData = (0, eventToSchedule_js_1.eventToSchedule)(event);
+        if (cronData)
+            schedule.set("cron", cronData);
+        // useMasterKey prevents afterSaveHook from syncing back to calendar
+        await schedule.save(null, { useMasterKey: true });
+        await (0, calendarMetaHelper_js_1.saveCalendarMeta)(schedule.id, event.id, event.changeKey, source.get("tenant"), event);
+        console.log(`[CalendarSyncPoller] Created schedule "${event.subject}" for source "${parsed.sourceName}" from calendar event ${event.id}.`);
+    }
+    async handleDeleted(eventId) {
+        const metaEntry = await (0, calendarMetaHelper_js_1.findCalendarMetaByEventId)(eventId);
+        if (!metaEntry)
+            return;
+        const scheduleId = metaEntry.get("entryObjectId");
+        if (scheduleId) {
+            try {
+                const schedule = await new node_1.default.Query(index_js_1.Maintenance_Schedule).get(scheduleId, { useMasterKey: true });
+                // Disable rather than delete to preserve execution history
+                schedule.set("enabled", false);
+                await schedule.save(null, { useMasterKey: true });
+            }
+            catch (err) {
+                console.error("[CalendarSyncPoller] Could not disable schedule for deleted event:", scheduleId, err);
+            }
+        }
+        await metaEntry.destroy({ useMasterKey: true });
+    }
+    async loadDeltaLink() {
+        try {
+            const config = await node_1.default.Config.get({ useMasterKey: true });
+            return config.get(DELTA_LINK_CONFIG_KEY) || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async saveDeltaLink(link) {
+        await node_1.default.Config.save({ [DELTA_LINK_CONFIG_KEY]: link }, { useMasterKey: true });
+    }
+}
+exports.CalendarSyncPoller = CalendarSyncPoller;
+// Parses the source name out of an Outlook-originated event subject.
+// Expected format for externally-created events: "<source.name>" - <anything>
+// Quotes around the source name are optional.
+function parseEventSubject(subject) {
+    if (!subject)
+        return null;
+    const separatorIdx = subject.indexOf(" - ");
+    if (separatorIdx === -1)
+        return null;
+    const rawSource = subject.slice(0, separatorIdx).trim();
+    if (!rawSource)
+        return null;
+    const sourceName = rawSource.replace(/^"(.*)"$/, "$1");
+    return { sourceName };
+}

package/dist/features/openservice/schedules/calendarSync/service/calendarMetaHelper.d.ts

@@ -0,0 +1,36 @@
+import { Meta_Entry, Tenant } from "../../../../../types/index.js";
+import { MetaConfig } from "../../../../../types/custom/MetaField.js";
+import { GraphEventResponse } from "../types/Event.js";
+export declare const CALENDAR_SYNC_CONTEXT: string;
+export interface CalendarEventSnapshot {
+    id: string;
+    subject?: string;
+    start: {
+        dateTime: string;
+        timeZone: string;
+    };
+    end: {
+        dateTime: string;
+        timeZone: string;
+    };
+    isAllDay?: boolean;
+    isCancelled?: boolean;
+    body?: {
+        contentType?: string;
+        content?: string;
+    };
+    recurrence?: GraphEventResponse["recurrence"];
+    location?: {
+        displayName?: string;
+    };
+}
+export interface CalendarMetaValues {
+    microsoftCalendarEventId: string;
+    microsoftCalendarChangeKey?: string;
+    microsoftCalendarEvent?: CalendarEventSnapshot;
+}
+export declare const CalendarMetaConfig: MetaConfig;
+export declare function findCalendarMetaForSchedule(scheduleId: string): Promise<Meta_Entry | null>;
+export declare function findCalendarMetaByEventId(eventId: string): Promise<Meta_Entry | null>;
+export declare function saveCalendarMeta(scheduleId: string, eventId: string, changeKey?: string, tenant?: Tenant, event?: GraphEventResponse): Promise<Meta_Entry>;
+export declare function updateCalendarChangeKey(entry: Meta_Entry, changeKey: string, event?: GraphEventResponse): Promise<void>;

package/dist/features/openservice/schedules/calendarSync/service/calendarMetaHelper.js

@@ -0,0 +1,89 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CalendarMetaConfig = exports.CALENDAR_SYNC_CONTEXT = void 0;
+exports.findCalendarMetaForSchedule = findCalendarMetaForSchedule;
+exports.findCalendarMetaByEventId = findCalendarMetaByEventId;
+exports.saveCalendarMeta = saveCalendarMeta;
+exports.updateCalendarChangeKey = updateCalendarChangeKey;
+const node_1 = __importDefault(require("parse/node"));
+const index_js_1 = require("../../../../../types/index.js");
+exports.CALENDAR_SYNC_CONTEXT = JSON.stringify([
+    "schedule",
+    "sync",
+    "microsoft",
+]);
+function toEventSnapshot(event) {
+    return {
+        id: event.id,
+        subject: event.subject,
+        start: event.start,
+        end: event.end,
+        isAllDay: event.isAllDay,
+        isCancelled: event.isCancelled,
+        body: event.body
+            ? { contentType: event.body.contentType, content: event.body.content }
+            : undefined,
+        recurrence: event.recurrence ?? undefined,
+        location: event.location?.displayName
+            ? { displayName: event.location.displayName }
+            : undefined,
+    };
+}
+exports.CalendarMetaConfig = {
+    fields: [
+        {
+            name: "microsoftCalendarEventId",
+            type: "string",
+            label: "Microsoft Calendar Event ID",
+        },
+        {
+            name: "microsoftCalendarChangeKey",
+            type: "string",
+            label: "Microsoft Calendar Change Key",
+        },
+    ],
+};
+async function findCalendarMetaForSchedule(scheduleId) {
+    return ((await new node_1.default.Query(index_js_1.Meta_Entry)
+        .equalTo("context", exports.CALENDAR_SYNC_CONTEXT)
+        .equalTo("entryClassName", index_js_1.Maintenance_Schedule.className)
+        .equalTo("entryObjectId", scheduleId)
+        .first({ useMasterKey: true })) ?? null);
+}
+async function findCalendarMetaByEventId(eventId) {
+    return ((await new node_1.default.Query(index_js_1.Meta_Entry)
+        .equalTo("context", exports.CALENDAR_SYNC_CONTEXT)
+        .equalTo("entryClassName", index_js_1.Maintenance_Schedule.className)
+        // @ts-expect-error
+        .equalTo("values.microsoftCalendarEventId", eventId)
+        .first({ useMasterKey: true })) ?? null);
+}
+async function saveCalendarMeta(scheduleId, eventId, changeKey, tenant, event) {
+    let entry = await findCalendarMetaForSchedule(scheduleId);
+    if (!entry) {
+        entry = new index_js_1.Meta_Entry();
+        entry.set("context", exports.CALENDAR_SYNC_CONTEXT);
+        entry.set("entryClassName", index_js_1.Maintenance_Schedule.className);
+        entry.set("entryObjectId", scheduleId);
+        entry.set("tenant", tenant);
+        entry.set("config", {});
+    }
+    const values = { microsoftCalendarEventId: eventId };
+    if (changeKey)
+        values.microsoftCalendarChangeKey = changeKey;
+    if (event)
+        values.microsoftCalendarEvent = toEventSnapshot(event);
+    entry.set("values", values);
+    return entry.save(null, { useMasterKey: true });
+}
+async function updateCalendarChangeKey(entry, changeKey, event) {
+    entry.set("values", {
+        ...entry.get("values"),
+        microsoftCalendarChangeKey: changeKey,
+        ...(event ? { microsoftCalendarEvent: toEventSnapshot(event) } : {}),
+    });
+    await entry.save(null, { useMasterKey: true });
+}

package/dist/features/openservice/schedules/calendarSync/types/Event.d.ts

@@ -60,7 +60,7 @@ export type GraphEvent = {
     subject?: string;
     body?: ItemBody;
     start: DateTimeTimeZone;
-    end: DateTimeTimeZone;
+    end?: DateTimeTimeZone;
     location?: Location;
     attendees?: Attendee[];
     isAllDay?: boolean;

package/dist/features/openservice/schedules/initSchedulesFeature.js

@@ -6,8 +6,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.initSchedulesFeature = initSchedulesFeature;
 const node_1 = __importDefault(require("parse/node"));
 const index_js_1 = require("../../../types/index.js");
+const CalendarSyncPoller_js_1 = require("./calendarSync/service/CalendarSyncPoller.js");
 async function initSchedulesFeature() {
     updateFiinishedSchedules();
+    new CalendarSyncPoller_js_1.CalendarSyncPoller().start(1000 * 60);
 }
 async function updateFiinishedSchedules() {
     const executionsToUpdate = await new node_1.default.Query(index_js_1.Maintenance_Schedule_Execution)

package/dist/hooks/Maintenance_Schedule.js

@@ -6,12 +6,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.init = init;
 const node_1 = __importDefault(require("parse/node"));
 const scheduleToEvent_1 = require("../features/openservice/schedules/calendarSync/functions/scheduleToEvent");
+const calendarMetaHelper_1 = require("../features/openservice/schedules/calendarSync/service/calendarMetaHelper");
 const CalendarManager_1 = require("../features/openservice/schedules/calendarSync/service/CalendarManager");
 const schema_1 = require("../features/schema");
 const types_1 = require("../types");
 async function init() {
     (0, schema_1.beforeSaveHook)(types_1.Maintenance_Schedule, async (request) => {
-        const { object, original, user } = request;
         await (0, schema_1.defaultHandler)(request);
         // await defaultAclHandler(request, { allowCustomACL: true });
     });
@@ -51,7 +51,7 @@ async function init() {
         }
     });
     (0, schema_1.beforeDeleteHook)(types_1.Maintenance_Schedule, async (request) => {
-        const { object, original, user, master } = request;
+        const { object } = request;
         const scheduleFetched = await object?.fetchWithInclude(["template", "source"], {
             useMasterKey: true,
         });
@@ -60,9 +60,13 @@ async function init() {
         if (source)
             template?.relation("sources").remove(source);
         await template?.save(null, { useMasterKey: true });
-        // Delete associated calendar event
-        if (object.get("meta")?.microsoftCalendarEventId) {
-            await new CalendarManager_1.CalendarManager().deleteEvent(object.get("meta")?.microsoftCalendarEventId);
+        const metaEntry = await (0, calendarMetaHelper_1.findCalendarMetaForSchedule)(object.id);
+        if (metaEntry) {
+            const eventId = metaEntry.get("values")?.microsoftCalendarEventId;
+            if (eventId) {
+                await new CalendarManager_1.CalendarManager().deleteEvent(eventId);
+            }
+            await metaEntry.destroy({ useMasterKey: true });
         }
     });
 }
@@ -89,11 +93,14 @@ async function updateCalendarEvent(schedule) {
     if (!event)
         return;
     const calendarManager = new CalendarManager_1.CalendarManager();
-    const meta = schedule.get("meta") || {};
-    const microsoftCalendarEventId = meta.microsoftCalendarEventId;
-    if (microsoftCalendarEventId) {
+    const metaEntry = await (0, calendarMetaHelper_1.findCalendarMetaForSchedule)(schedule.id);
+    const eventId = metaEntry?.get("values")?.microsoftCalendarEventId;
+    if (eventId) {
         console.log("Updating schedule in calendar...");
-        await calendarManager.updateEvent(microsoftCalendarEventId, event);
+        const updatedEvent = await calendarManager.updateEvent(eventId, event);
+        if (updatedEvent?.changeKey && metaEntry) {
+            await (0, calendarMetaHelper_1.updateCalendarChangeKey)(metaEntry, updatedEvent.changeKey, updatedEvent);
+        }
     }
     else {
         await addToCalendar(schedule);
@@ -110,12 +117,7 @@ async function addToCalendar(schedule) {
         return;
     const calendarManager = new CalendarManager_1.CalendarManager();
     const createdEvent = await calendarManager.createEvent(event);
-    if (createdEvent && createdEvent.id) {
-        const existingMeta = schedule.get("meta") || {};
-        schedule.set("meta", {
-            ...existingMeta,
-            microsoftCalendarEventId: createdEvent.id,
-        });
-        await schedule.save(null, { useMasterKey: true });
+    if (createdEvent?.id) {
+        await (0, calendarMetaHelper_1.saveCalendarMeta)(schedule.id, createdEvent.id, createdEvent.changeKey, schedule.get("tenant"), createdEvent);
     }
 }

package/dist/types/Meta_Config.d.ts

@@ -1,19 +1,20 @@
 import Parse from "parse/node";
 import type { Tenant } from "./Tenant";
+import { MetaConfig } from "./custom/MetaField";
 export interface Meta_ConfigAttributes {
     id: string;
     objectId: string;
     createdAt: Date;
     updatedAt: Date;
-    config: any;
+    config: MetaConfig;
     context?: string | undefined;
     tenant?: Tenant | undefined;
 }
 export declare class Meta_Config extends Parse.Object<Meta_ConfigAttributes> {
     static className: string;
     constructor(data?: Partial<Meta_ConfigAttributes>);
-    get config(): any;
-    set config(value: any);
+    get config(): MetaConfig;
+    set config(value: MetaConfig);
     get context(): string | undefined;
     set context(value: string | undefined);
     get tenant(): Tenant | undefined;

package/dist/types/Meta_Entry.d.ts

@@ -1,12 +1,13 @@
 import Parse from "parse/node";
 import type { Meta_Config } from "./Meta_Config";
 import type { Tenant } from "./Tenant";
+import { MetaConfig } from "./custom/MetaField";
 export interface Meta_EntryAttributes {
     id: string;
     objectId: string;
     createdAt: Date;
     updatedAt: Date;
-    config?: any | undefined;
+    config?: MetaConfig | undefined;
     context?: string | undefined;
     entryClassName?: string | undefined;
     entryObjectId?: string | undefined;
@@ -17,8 +18,8 @@ export interface Meta_EntryAttributes {
 export declare class Meta_Entry extends Parse.Object<Meta_EntryAttributes> {
     static className: string;
     constructor(data?: Partial<Meta_EntryAttributes>);
-    get config(): any | undefined;
-    set config(value: any | undefined);
+    get config(): MetaConfig | undefined;
+    set config(value: MetaConfig | undefined);
     get context(): string | undefined;
     set context(value: string | undefined);
     get entryClassName(): string | undefined;

package/dist/types/custom/MetaField.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Base properties shared by all meta field types
+ */
+export type MetaFieldBaseConfig = {
+    name: string;
+    label: string;
+    placeholder?: string;
+    help?: string;
+    required?: boolean;
+    /** Default value for the field */
+    defaultValue?: any;
+};
+/**
+ * String field type with optional validation
+ */
+export type MetaFieldString = MetaFieldBaseConfig & {
+    type: "string";
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    multiline?: boolean;
+};
+/**
+ * Number field type with min/max constraints
+ */
+export type MetaFieldNumber = MetaFieldBaseConfig & {
+    type: "number";
+    min?: number;
+    max?: number;
+    step?: number;
+    unit?: string;
+};
+/**
+ * Boolean field type (checkbox/switch)
+ */
+export type MetaFieldBoolean = MetaFieldBaseConfig & {
+    type: "boolean";
+    defaultValue?: boolean;
+};
+/**
+ * Date field type with optional date range constraints
+ */
+export type MetaFieldDate = MetaFieldBaseConfig & {
+    type: "date";
+    minDate?: Date;
+    maxDate?: Date;
+    includeTime?: boolean;
+};
+/**
+ * Select field type with predefined options
+ */
+export type MetaFieldSelect = MetaFieldBaseConfig & {
+    type: "select";
+    options: Array<{
+        label: string;
+        value: string;
+        disabled?: boolean;
+    }>;
+    /** Optional grouping for select options */
+    groups?: Array<{
+        label: string;
+        options: Array<{
+            label: string;
+            value: string;
+            disabled?: boolean;
+        }>;
+    }>;
+    multiple?: boolean;
+    defaultValue?: string | string[];
+};
+/**
+ * Parse select field type for selecting Parse objects
+ */
+export type MetaFieldSelectParse = MetaFieldBaseConfig & {
+    type: "select_parse";
+    className: string;
+    display?: string;
+    multiple?: boolean;
+    defaultValue?: string | string[];
+};
+/**
+ * Array of all available field types
+ */
+export declare const META_FIELD_TYPES: readonly ["string", "number", "boolean", "date", "select", "select_parse"];
+/**
+ * Literal type for field types derived from the array
+ */
+export type MetaFieldTypes = (typeof META_FIELD_TYPES)[number];
+/**
+ * Mapped type for accessing MetaField types by their string literal
+ * @example MetaFieldMap["string"] => MetaFieldString
+ */
+export type MetaFieldMap = {
+    string: MetaFieldString;
+    number: MetaFieldNumber;
+    boolean: MetaFieldBoolean;
+    date: MetaFieldDate;
+    select: MetaFieldSelect;
+    select_parse: MetaFieldSelectParse;
+};
+/**
+ * Union type of all specific meta field types
+ */
+export type MetaFieldConfig = MetaFieldString | MetaFieldNumber | MetaFieldBoolean | MetaFieldDate | MetaFieldSelect | MetaFieldSelectParse;
+/**
+ * Helper type to extract specific field type from MetaField union
+ */
+export type MetaFieldOfType<T extends MetaFieldTypes> = Extract<MetaFieldConfig, {
+    type: T;
+}>;
+/**
+ * Type guard to check if a field is of a specific type
+ */
+export declare function isMetaFieldType<T extends MetaFieldTypes>(field: MetaFieldConfig, type: T): field is MetaFieldOfType<T>;
+export type MetaConfig = {
+    fields: MetaFieldConfig[];
+};

package/dist/types/custom/MetaField.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.META_FIELD_TYPES = void 0;
+exports.isMetaFieldType = isMetaFieldType;
+/**
+ * Array of all available field types
+ */
+exports.META_FIELD_TYPES = [
+    "string",
+    "number",
+    "boolean",
+    "date",
+    "select",
+    "select_parse",
+];
+/**
+ * Type guard to check if a field is of a specific type
+ */
+function isMetaFieldType(field, type) {
+    return field.type === type;
+}

package/dist/types/index.d.ts

@@ -140,6 +140,8 @@ export { Maintenance_Schedule_Step } from "./Maintenance_Schedule_Step";
 export type { Maintenance_Schedule_StepAttributes } from "./Maintenance_Schedule_Step";
 export { Maintenance_Schedule_Template } from "./Maintenance_Schedule_Template";
 export type { Maintenance_Schedule_TemplateAttributes } from "./Maintenance_Schedule_Template";
+export { Maintenance_SourceMeta } from "./Maintenance_SourceMeta";
+export type { Maintenance_SourceMetaAttributes } from "./Maintenance_SourceMeta";
 export { Maintenance_Source_File } from "./Maintenance_Source_File";
 export type { Maintenance_Source_FileAttributes } from "./Maintenance_Source_File";
 export { Maintenance_Ticket } from "./Maintenance_Ticket";

package/dist/types/index.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MES_OrderPlan = exports.MES_Order = exports.MES_Article = exports.Log = exports.Language = exports.Knowledge_Video = exports.Knowledge_DocumentPage = exports.Knowledge_Document = exports.Knowledge_ChatMessage = exports.Knowledge_Chat = exports.Knowledge_Category = exports.Knowledge_Article = exports.GTFS_Wheelchair_Boarding = exports.GTFS_Wheelchair_Accessible = exports.GTFS_Trip = exports.GTFS_Stop_Times = exports.GTFS_Stop = exports.GTFS_Route_Type = exports.GTFS_Route = exports.GTFS_Location_Type = exports.GTFS_Level = exports.GTFS_Direction = exports.GTFS_Calendar = exports.GTFS_Bikes_Allowed = exports.GTFS_Agency = exports.EMS_ChargePoint = exports.Documentation_Document = exports.Documentation_Config = exports.Documentation_Category = exports.Dashboard = exports.Core_Token = exports.Core_Email = exports.Contact = exports.Config = exports.Company = exports.Changelog = exports.BDE_WorkTime = exports.BDE_WorkOrder = exports.BDE_Unit = exports.BDE_Result = exports.BDE_Page = exports.BDE_ListEntry = exports.BDE_List = exports.BDE_Form = exports.BDE_Article = exports.Attachment = exports.Assets = exports.AlarmWebhook = exports.AlarmAction = exports.Alarm = void 0;
-exports.RAG_Data = exports.Push = exports.Permission = exports.OWPlcItem = exports.OWPlcDevice = exports.Notification_Setting = exports.Notification = exports.NavigationItem = exports.NavigationGroup = exports.Monitoring_Slideshow = exports.Monitoring_ReportImage = exports.Monitoring_ParseTableSensor = exports.Monitoring_Jobs = exports.Monitoring_DataHierachies = exports.Meta_Entry = exports.Meta_Config = exports.Maintenance_Ticket_Title = exports.Maintenance_Ticket_Source = exports.Maintenance_Ticket_QR_Code = exports.Maintenance_Ticket_Project = exports.Maintenance_Ticket_Material = exports.Maintenance_Ticket_Kanban_State_Current = exports.Maintenance_Ticket_Kanban_State = exports.Maintenance_Ticket_Issuecategory = exports.Maintenance_Ticket_FormConfig = exports.Maintenance_Ticket_Data = exports.Maintenance_Ticket_Assignment = exports.Maintenance_Ticket = exports.Maintenance_Source_File = exports.Maintenance_Schedule_Template = exports.Maintenance_Schedule_Step = exports.Maintenance_Schedule_Execution_Step = exports.Maintenance_Schedule_Execution = exports.Maintenance_Schedule = exports.Maintenance_Restriction = exports.Maintenance_Project = exports.Maintenance_Priority = exports.Maintenance_Order = exports.Maintenance_Message = exports.Maintenance_Media = exports.Maintenance_Kanban_State = exports.Maintenance_Item = exports.Maintenance_Issuecategory = exports.Maintenance_Frequency = exports.Maintenance_Duedate = exports.Maintenance_Downtime = exports.Mail_Groups = exports.MailTemplate = exports.ML_DataSelection = exports.MIAAS_MDSEndpoint = void 0;
-exports.WidgetPreset = exports.Widget = exports.WebPush = exports.VirtualKPI = exports.User_Setting = exports.UserData = exports.TenantTrustedDomain = exports.TenantMeta = exports.Tenant = exports.Spreadsheet_Workbook = exports.SourceMeta = exports.Source = exports.Share = exports.Report = exports.RAG_Request = exports.RAG_Questions = exports.RAG_Prompts = exports.RAG_Meta = exports.RAG_Interview = void 0;
+exports.Push = exports.Permission = exports.OWPlcItem = exports.OWPlcDevice = exports.Notification_Setting = exports.Notification = exports.NavigationItem = exports.NavigationGroup = exports.Monitoring_Slideshow = exports.Monitoring_ReportImage = exports.Monitoring_ParseTableSensor = exports.Monitoring_Jobs = exports.Monitoring_DataHierachies = exports.Meta_Entry = exports.Meta_Config = exports.Maintenance_Ticket_Title = exports.Maintenance_Ticket_Source = exports.Maintenance_Ticket_QR_Code = exports.Maintenance_Ticket_Project = exports.Maintenance_Ticket_Material = exports.Maintenance_Ticket_Kanban_State_Current = exports.Maintenance_Ticket_Kanban_State = exports.Maintenance_Ticket_Issuecategory = exports.Maintenance_Ticket_FormConfig = exports.Maintenance_Ticket_Data = exports.Maintenance_Ticket_Assignment = exports.Maintenance_Ticket = exports.Maintenance_Source_File = exports.Maintenance_SourceMeta = exports.Maintenance_Schedule_Template = exports.Maintenance_Schedule_Step = exports.Maintenance_Schedule_Execution_Step = exports.Maintenance_Schedule_Execution = exports.Maintenance_Schedule = exports.Maintenance_Restriction = exports.Maintenance_Project = exports.Maintenance_Priority = exports.Maintenance_Order = exports.Maintenance_Message = exports.Maintenance_Media = exports.Maintenance_Kanban_State = exports.Maintenance_Item = exports.Maintenance_Issuecategory = exports.Maintenance_Frequency = exports.Maintenance_Duedate = exports.Maintenance_Downtime = exports.Mail_Groups = exports.MailTemplate = exports.ML_DataSelection = exports.MIAAS_MDSEndpoint = void 0;
+exports.WidgetPreset = exports.Widget = exports.WebPush = exports.VirtualKPI = exports.User_Setting = exports.UserData = exports.TenantTrustedDomain = exports.TenantMeta = exports.Tenant = exports.Spreadsheet_Workbook = exports.SourceMeta = exports.Source = exports.Share = exports.Report = exports.RAG_Request = exports.RAG_Questions = exports.RAG_Prompts = exports.RAG_Meta = exports.RAG_Interview = exports.RAG_Data = void 0;
 var Alarm_1 = require("./Alarm");
 Object.defineProperty(exports, "Alarm", { enumerable: true, get: function () { return Alarm_1.Alarm; } });
 var AlarmAction_1 = require("./AlarmAction");
@@ -145,6 +145,8 @@ var Maintenance_Schedule_Step_1 = require("./Maintenance_Schedule_Step");
 Object.defineProperty(exports, "Maintenance_Schedule_Step", { enumerable: true, get: function () { return Maintenance_Schedule_Step_1.Maintenance_Schedule_Step; } });
 var Maintenance_Schedule_Template_1 = require("./Maintenance_Schedule_Template");
 Object.defineProperty(exports, "Maintenance_Schedule_Template", { enumerable: true, get: function () { return Maintenance_Schedule_Template_1.Maintenance_Schedule_Template; } });
+var Maintenance_SourceMeta_1 = require("./Maintenance_SourceMeta");
+Object.defineProperty(exports, "Maintenance_SourceMeta", { enumerable: true, get: function () { return Maintenance_SourceMeta_1.Maintenance_SourceMeta; } });
 var Maintenance_Source_File_1 = require("./Maintenance_Source_File");
 Object.defineProperty(exports, "Maintenance_Source_File", { enumerable: true, get: function () { return Maintenance_Source_File_1.Maintenance_Source_File; } });
 var Maintenance_Ticket_1 = require("./Maintenance_Ticket");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openinc/parse-server-opendash",
-  "version": "4.0.28",
+  "version": "4.0.29",
   "description": "Parse Server Cloud Code for open.INC Stack.",
   "packageManager": "pnpm@10.33.0",
   "keywords": [