fix: midnight roll (#484)

* refactor: extract utilities and types

* refactor: extract and simplify progress bar logic

* refactor: duration validation handles midnight

* fix: prevent stale event loader

* refactor: consider next event in timer invalidation

* refactor: reload changes on changed roll target

* refactor: timer load accounts for midnight

* fix: issues with midnight on roll

* refactor: prevent stale secondary event

apps/server/src/utils/parserUtils.ts

@@ -0,0 +1,77 @@
+import fs from 'fs';
+import { dayInMs } from 'ontime-utils';
+
+/**
+ * @description Ensures variable is string, it skips object types
+ * @param {any} val - variable to convert
+ * @param {string} [fallback=''] - fallback value
+ * @returns {string} - value as string or fallback if not possible
+ */
+export const makeString = (val: any, fallback = ''): string => {
+  if (typeof val === 'string') return val;
+  else if (val == null || val.constructor === Object) return fallback;
+  return val.toString();
+};
+
+/**
+ * @description Delete file from system
+ * @param {string} file - reference to file
+ */
+export const deleteFile = async (file) => {
+  // delete a file
+  fs.unlink(file, (err) => {
+    if (err) {
+      console.log(err);
+    }
+  });
+};
+
+/**
+ * @description Delete file from system
+ * @param {string} file - reference to file
+ * @returns {boolean} - whether file is valid JSON
+ */
+export const validateFile = (file) => {
+  try {
+    JSON.parse(fs.readFileSync(file, 'utf-8'));
+    return true;
+  } catch (err) {
+    return false;
+  }
+};
+
+/**
+ * @description Verifies if object is empty
+ * @param {object} obj
+ */
+export const isEmptyObject = (obj: object) => {
+  if (typeof obj === 'object' && obj !== null && !Array.isArray(obj)) {
+    return Object.keys(obj).length === 0;
+  }
+  throw new Error('Variable is not an object');
+};
+
+/**
+ * @description Merges two objects, suppressing undefined keys
+ * @param {object} a
+ * @param {object} b
+ */
+export const mergeObject = (a, b) => {
+  const merged = {};
+  Object.keys({ ...a, ...b }).map((key) => {
+    merged[key] = typeof b[key] === 'undefined' ? a[key] : b[key];
+  });
+  return merged;
+};
+
+/**
+ * @description Removes undefined
+ * @param {object} obj
+ */
+export const removeUndefined = (obj: object) => {
+  const patched = {};
+  Object.keys({ ...obj })
+    .filter((key) => typeof obj[key] !== 'undefined')
+    .map((key) => (patched[key] = obj[key]));
+  return patched;
+};