@amimpact/willy-utils 4.14.0 → 4.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@amimpact/willy-utils",
-    "version": "4.14.0",
+    "version": "4.15.0",
     "description": "Javascript utils",
     "scripts": {
         "publish:prerelease": "npm version prerelease --preid beta && npm publish --tag beta",

package/src/date.ts

@@ -7,7 +7,7 @@ import {
     subDays,
 } from 'date-fns';
 import { nl } from 'date-fns/locale';
-import { TZDate } from '@date-fns/tz';
+import { TZDate, tzOffset } from '@date-fns/tz';
 import { parse as parseISO } from './includes/tinyduration';
 
 /**
@@ -293,6 +293,47 @@ export const formatNewDate = (dateObject: CraftDate) => {
     return new Date(parsed);
 };
 
+/**
+ * Een datum met tijdzone zoals teruggegeven door externe APIs (bijv. Microsoft Graph).
+ */
+export interface DateTimeWithZone {
+    dateTime: string;
+    timeZone: string;
+}
+
+/**
+ * Parseert een DateTimeWithZone object naar een TZDate in de lokale tijdzone van de browser.
+ *
+ * TZDate gebruikt de timeZone parameter alleen voor de getters, niet voor het parsen
+ * van de string. Daardoor wordt een string zonder timezone-aanduiding altijd als lokale
+ * tijd geïnterpreteerd. Om de string correct te interpreteren in de opgegeven tijdzone:
+ * 1. Parseer de string naïef als UTC (via 'Z' suffix) als referentiedatum
+ * 2. Bepaal de UTC-offset van de opgegeven tijdzone op dat moment via tzOffset
+ * 3. Corrigeer de timestamp: UTC = lokale tijd - offset
+ * 4. Maak een TZDate in de lokale tijdzone van de browser
+ *
+ * Retourneert null als de dateTime string ongeldig is of de timeZone onbekend is.
+ *
+ * @param {DateTimeWithZone} dateTimeWithZone - Object met dateTime string en timeZone
+ * @returns {TZDate | null}
+ */
+export const parseDateTimeWithZone = (dateTimeWithZone: DateTimeWithZone): TZDate | null => {
+    try {
+        const localTimeZone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+        const naiveUtc = new Date(dateTimeWithZone.dateTime + 'Z');
+
+        if (isNaN(naiveUtc.getTime())) {
+            return null;
+        }
+
+        const offsetMinutes = tzOffset(dateTimeWithZone.timeZone, naiveUtc);
+        const utcMs = naiveUtc.getTime() - offsetMinutes * 60 * 1000;
+        return new TZDate(utcMs, localTimeZone);
+    } catch {
+        return null;
+    }
+};
+
 /**
  * Convert datum
  * @param {Date} date

package/src/index.ts

@@ -6,6 +6,7 @@ import {
     formatSecondsToHumanReadableTime,
     formatUTCDate,
     parseISODuration,
+    parseDateTimeWithZone,
 } from './date';
 import { convertObjectToFormData } from './form';
 import {
@@ -14,7 +15,7 @@ import {
     checkForScrollbars,
     convertHexToRGBA,
     downloadFile,
-    getNestedSet,
+    getTree,
     getUrlsFromString,
     isEmpty,
     isHoverableDevice,
@@ -50,7 +51,7 @@ export {
     formatNewDate,
     formatSecondsToHumanReadableTime,
     formatUTCDate,
-    getNestedSet,
+    getTree,
     getParents,
     getUrlsFromString,
     isAsset,
@@ -65,6 +66,7 @@ export {
     isValidEmail,
     observeResize,
     parseISODuration,
+    parseDateTimeWithZone,
     readCookie,
     slugify,
     wrap,

package/src/misc.ts

@@ -105,17 +105,37 @@ export const downloadFile = (data: any, fileName: string) => {
         fileLink.setAttribute('download', fileName);
         document.body.appendChild(fileLink);
         fileLink.click();
+        // direct opruimen
+        document.body.removeChild(fileLink);
+        if (!isValidUrl(data)) {
+            // ook de object URL vrijgeven
+            window.URL.revokeObjectURL(fileURL);
+        }
     }
 };
 
 /**
- * Flat structure array ombouwen naar een array met children
- * @param {array} entries
- * @param {number} level
- * @param {number | string} left
- * @param {number | string} right
+ * Detecteert of items een nested-set structuur (lft/rgt) hebben
+ *
+ * @param {unknown[]} entries
+ * @returns {boolean}
  */
-export const getNestedSet = (entries: any[] = [], level: number = 1, left: any, right: any) => {
+const hasNestedSetFields = (entries: unknown[]): boolean => {
+    if (entries.length === 0) return false;
+    const first = entries[0] as Record<string, unknown>;
+    return 'lft' in first && 'rgt' in first;
+};
+
+/**
+ * Bouwt een boom op basis van nested-set velden (lft, rgt, level)
+ *
+ * @param {any[]} entries - Platte lijst met lft, rgt en level properties
+ * @param {number} level - Huidig level om te filteren
+ * @param {number | string} left - Linker grens
+ * @param {number | string} right - Rechter grens
+ * @returns {any[]}
+ */
+const buildNestedSetTree = (entries: any[] = [], level: number = 1, left?: any, right?: any): any[] => {
     return entries
         .filter((item) => {
             return (
@@ -127,7 +147,7 @@ export const getNestedSet = (entries: any[] = [], level: number = 1, left: any,
         .map((item) => {
             const returnItem = item;
 
-            returnItem['children'] = getNestedSet(
+            returnItem['children'] = buildNestedSetTree(
                 entries,
                 parseFloat(item.level) + 1,
                 parseFloat(item.lft),
@@ -138,6 +158,40 @@ export const getNestedSet = (entries: any[] = [], level: number = 1, left: any,
         });
 };
 
+/**
+ * Bouwt een boom op basis van parentId velden (id, parentId)
+ *
+ * @param {any[]} entries - Platte lijst met id en parentId properties
+ * @param {string | number | null} parent - parentId van de root
+ * @returns {any[] | undefined}
+ */
+const buildParentIdTree = (entries: any[] = [], parent: string | number | null): any[] | undefined => {
+    const t: Record<string, any> = {};
+    entries.forEach((o) =>
+        ((t[o.parentId] ??= {}).children ??= []).push(Object.assign((t[o.id] ??= {}), o)),
+    );
+    return t[`${parent}`]?.children;
+};
+
+/**
+ * Platte array omzetten naar een boom met children.
+ * Detecteert automatisch of de data nested-set velden (lft/rgt) bevat
+ * of parentId-gebaseerd is en kiest het juiste algoritme.
+ *
+ * @param {any[]} entries - Platte lijst van items
+ * @param {string | number | null} parent - parentId van de root (alleen gebruikt bij parentId-modus)
+ * @returns {any[]}
+ */
+export const getTree = (entries: any[] = [], parent: string | number | null = null): any[] => {
+    if (entries.length === 0) return [];
+
+    if (hasNestedSetFields(entries)) {
+        return buildNestedSetTree(entries);
+    }
+
+    return buildParentIdTree(entries, parent) || [];
+};
+
 /**
  * Urls uit een string halen
  * @param {string} content - html
@@ -257,18 +311,24 @@ export const isValidUrl = (urlString: any) => {
 /**
  * Resize observer; checkt of een HTML element zijn dimensies veranderen
  * en zodra dat gebeurt wordt de callback functie gecalled.
+ * Retourneert de observer zodat callers deze kunnen disconnecten bij cleanup.
  *
- * @param {HTMLElement} el
+ * @param {HTMLElement} element
  * @param {Function} callback
+ * @returns {ResizeObserver | null} - De observer instantie, of null als het element niet bestaat
  */
-export const observeResize = (element: HTMLElement, callback: Function) => {
+export const observeResize = (element: HTMLElement, callback: Function): ResizeObserver | null => {
+    if (!element) {
+        return null;
+    }
+
     const resizeObserver = new ResizeObserver(() => {
         callback(element);
     });
 
-    if (element) {
-        resizeObserver.observe(element);
-    }
+    resizeObserver.observe(element);
+
+    return resizeObserver;
 };
 
 /**