@jbctechsolutions/mcp-office365 2.5.1

package/dist/graph/mappers/utils.js

@@ -0,0 +1,186 @@
+/**
+ * Copyright (c) 2026 JBC Tech Solutions, LLC
+ * Licensed under the MIT License. See LICENSE file in the project root.
+ */
+/**
+ * Utility functions for mappers.
+ */
+/**
+ * Hashes a string ID to a numeric ID.
+ *
+ * Graph API uses string UUIDs while our row types use numeric IDs.
+ * This creates a deterministic numeric ID from a string.
+ *
+ * Note: There's a small chance of collision, but it's acceptable
+ * for our use case (display purposes only, not database operations).
+ */
+export function hashStringToNumber(str) {
+    let hash = 0;
+    for (let i = 0; i < str.length; i++) {
+        const char = str.charCodeAt(i);
+        hash = ((hash << 5) - hash) + char;
+        hash = hash & hash; // Convert to 32-bit integer
+    }
+    // Ensure positive number
+    return Math.abs(hash);
+}
+/**
+ * Parses an ISO date string to a Unix timestamp (seconds).
+ */
+export function isoToTimestamp(isoDate) {
+    if (isoDate == null) {
+        return null;
+    }
+    try {
+        const date = new Date(isoDate);
+        if (isNaN(date.getTime())) {
+            return null;
+        }
+        // Return seconds since epoch (not milliseconds)
+        return Math.floor(date.getTime() / 1000);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * UTC-equivalent timezone identifiers from the Graph API.
+ * Graph may return "UTC", "Etc/GMT", or similar values.
+ */
+const UTC_TIMEZONES = new Set(['utc', 'etc/gmt', 'etc/gmt+0', 'etc/gmt-0', 'gmt']);
+/**
+ * Parses a Graph DateTimeTimeZone object to a Unix timestamp.
+ *
+ * Graph API returns datetime strings WITHOUT a Z suffix (e.g. "2026-02-23T16:00:00.0000000")
+ * alongside a separate timeZone field (e.g. "UTC"). JavaScript's Date constructor treats
+ * strings without Z or offset as local time, so we must append Z when the timezone is UTC.
+ */
+export function dateTimeTimeZoneToTimestamp(dt) {
+    if (dt?.dateTime == null) {
+        return null;
+    }
+    try {
+        let dateStr = dt.dateTime;
+        // If the timeZone indicates UTC and the string doesn't already have an offset,
+        // append Z so Date parses it as UTC rather than local time.
+        const tz = dt.timeZone?.toLowerCase();
+        if (tz != null && UTC_TIMEZONES.has(tz) && !/[Zz]$|[+-]\d{2}:\d{2}$/.test(dateStr)) {
+            dateStr += 'Z';
+        }
+        const date = new Date(dateStr);
+        if (isNaN(date.getTime())) {
+            return null;
+        }
+        return Math.floor(date.getTime() / 1000);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Maps Graph importance to a priority number.
+ */
+export function importanceToPriority(importance) {
+    switch (importance?.toLowerCase()) {
+        case 'high':
+            return 1;
+        case 'low':
+            return -1;
+        default:
+            return 0;
+    }
+}
+/**
+ * Maps Graph flag status to a number.
+ */
+export function flagStatusToNumber(flag) {
+    switch (flag?.flagStatus?.toLowerCase()) {
+        case 'flagged':
+            return 1;
+        case 'complete':
+            return 2;
+        default:
+            return 0;
+    }
+}
+/**
+ * Extracts email address from a Graph EmailAddress object.
+ */
+export function extractEmailAddress(recipient) {
+    return recipient?.emailAddress?.address ?? null;
+}
+/**
+ * Extracts display name from a Graph EmailAddress object.
+ */
+export function extractDisplayName(recipient) {
+    return recipient?.emailAddress?.name ?? null;
+}
+/**
+ * Formats recipients array to a comma-separated string.
+ */
+export function formatRecipients(recipients) {
+    if (recipients == null || recipients.length === 0) {
+        return null;
+    }
+    return recipients
+        .map((r) => r.emailAddress?.name ?? r.emailAddress?.address ?? '')
+        .filter((s) => s.length > 0)
+        .join(', ');
+}
+/**
+ * Formats recipients array to email addresses string.
+ */
+export function formatRecipientAddresses(recipients) {
+    if (recipients == null || recipients.length === 0) {
+        return null;
+    }
+    return recipients
+        .map((r) => r.emailAddress?.address ?? '')
+        .filter((s) => s.length > 0)
+        .join(', ');
+}
+/**
+ * Converts a Unix timestamp (seconds since 1970) to an ISO 8601 string in UTC.
+ *
+ * Unlike appleTimestampToIso (which adds the Apple epoch offset),
+ * this treats the input as a standard Unix timestamp.
+ */
+export function unixTimestampToIso(timestamp) {
+    if (timestamp == null) {
+        return null;
+    }
+    return new Date(timestamp * 1000).toISOString();
+}
+/**
+ * Converts a Unix timestamp (seconds since 1970) to an ISO 8601 string
+ * in the system's local timezone with offset (e.g. "2026-02-23T10:00:00.000-05:00").
+ *
+ * This makes dates human-readable at a glance while remaining unambiguous.
+ */
+export function unixTimestampToLocalIso(timestamp) {
+    if (timestamp == null) {
+        return null;
+    }
+    const date = new Date(timestamp * 1000);
+    const offsetMinutes = date.getTimezoneOffset();
+    const sign = offsetMinutes <= 0 ? '+' : '-';
+    const absOffset = Math.abs(offsetMinutes);
+    const offsetHours = String(Math.floor(absOffset / 60)).padStart(2, '0');
+    const offsetMins = String(absOffset % 60).padStart(2, '0');
+    // Build local date components
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    const day = String(date.getDate()).padStart(2, '0');
+    const hours = String(date.getHours()).padStart(2, '0');
+    const minutes = String(date.getMinutes()).padStart(2, '0');
+    const seconds = String(date.getSeconds()).padStart(2, '0');
+    const ms = String(date.getMilliseconds()).padStart(3, '0');
+    return `${year}-${month}-${day}T${hours}:${minutes}:${seconds}.${ms}${sign}${offsetHours}:${offsetMins}`;
+}
+/**
+ * Creates a Graph content path from an entity type and ID.
+ */
+export function createGraphContentPath(type, id) {
+    return `graph-${type}:${id}`;
+}
+//# sourceMappingURL=utils.js.map

package/dist/graph/mappers/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/graph/mappers/utils.ts"],"names":[],"mappings":"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"}