@happychef/algorithm 1.2.32 → 1.3.2

package/getAvailableTimeblocks.js

@@ -1,158 +1,158 @@
-// getAvailableTimeblocks.js
-
-const { timeblocksAvailable } = require('./processing/timeblocksAvailable');
-const { parseTime, getMealTypeByTime } = require('./tableHelpers');
-
-/**
- * Parses a time string in "HH:MM" format into a Date object on a specific date.
- * @param {string} dateStr - The date string in "YYYY-MM-DD" format.
- * @param {string} timeStr - Time string in "HH:MM" format.
- * @param {string} timeZone - The IANA time zone identifier (not used, kept for compatibility).
- * @returns {Date} Date object representing the time on the specified date.
- */
-function parseDateTimeInTimeZone(dateStr, timeStr, timeZone) {
-  const [year, month, day] = dateStr.split('-').map(Number);
-  const [hours, minutes] = timeStr.split(':').map(Number);
-
-  // Create a simple date object for the given date and time
-  // This represents the local time on that date
-  return new Date(year, month - 1, day, hours, minutes);
-}
-
-/**
- * Gets the available time blocks or shifts for a reservation, considering 'uurOpVoorhand' and 'dagenInToekomst'.
- * @param {Object} data - The main data object containing settings and meal information.
- * @param {string} dateStr - The date string in "YYYY-MM-DD" format.
- * @param {Array} reservations - An array of reservation objects.
- * @param {number} guests - The number of guests for the reservation.
- * @param {Array} blockedSlots - Optional array of blocked time slots to exclude.
- * @param {string|null} giftcard - Optional giftcard to filter times by meal.
- * @param {boolean} isAdmin - Optional flag to bypass time restrictions for admin users.
- * @returns {Object} - Returns a pruned object of available time blocks or shifts, or an empty object if out of range.
- */
-function getAvailableTimeblocks(data, dateStr, reservations, guests, blockedSlots = [], giftcard = null, isAdmin = false, duration = null) {
-  // Get 'uurOpVoorhand' from general settings
-  let uurOpVoorhand = 0;
-  if (
-    data['general-settings'] &&
-    data['general-settings'].uurOpVoorhand &&
-    parseInt(data['general-settings'].uurOpVoorhand, 10) >= 0
-  ) {
-    uurOpVoorhand = parseInt(data['general-settings'].uurOpVoorhand, 10);
-  }
-
-  // Get 'dagenInToekomst' from general settings
-  let dagenInToekomst = 90; // Default if not defined
-  if (
-    data['general-settings'] &&
-    data['general-settings'].dagenInToekomst &&
-    parseInt(data['general-settings'].dagenInToekomst, 10) > 0
-  ) {
-    dagenInToekomst = parseInt(data['general-settings'].dagenInToekomst, 10);
-  }
-
-  // Time zone for CEST/CET (Europe/Amsterdam)
-  const timeZone = 'Europe/Amsterdam';
-
-  // Current date/time in local timezone (system time)
-  // Note: We assume the server is running in the correct timezone
-  const now = new Date();
-  const currentTimeInTimeZone = now;
-
-  // Calculate the maximum allowed date
-  const maxAllowedDate = new Date(currentTimeInTimeZone.getTime());
-  maxAllowedDate.setDate(maxAllowedDate.getDate() + dagenInToekomst);
-  maxAllowedDate.setHours(23, 59, 59, 999);
-
-  // Parse the target date (just the date part, no time)
-  const [year, month, day] = dateStr.split('-').map(Number);
-  const targetDateInTimeZone = new Date(year, month - 1, day);
-
-  // Check if targetDateInTimeZone is within dagenInToekomst (skip for admin)
-  if (!isAdmin && targetDateInTimeZone > maxAllowedDate) {
-    // Out of allowed range, return empty object
-    return {};
-  }
-
-  // Check if the target date is today in the specified time zone
-  const isToday =
-    currentTimeInTimeZone.toDateString() === targetDateInTimeZone.toDateString();
-
-  // Get available time blocks or shifts
-  const availableTimeblocks = timeblocksAvailable(data, dateStr, reservations, guests, blockedSlots, giftcard, isAdmin, duration);
-
-  // If the date is today and uurOpVoorhand is greater than zero, prune time blocks (skip for admin)
-  if (!isAdmin && isToday && uurOpVoorhand >= 0) {
-    const cutoffTime = new Date(currentTimeInTimeZone.getTime());
-    cutoffTime.setHours(cutoffTime.getHours() + uurOpVoorhand);
-
-    for (const [key, value] of Object.entries(availableTimeblocks)) {
-      let timeStr = key;
-
-      const timeBlockDateTime = parseDateTimeInTimeZone(dateStr, timeStr, timeZone);
-
-      if (timeBlockDateTime < cutoffTime) {
-        delete availableTimeblocks[key];
-      }
-    }
-  }
-
-  // Apply last booking time filter (lunchStop, dinerStop, ontbijtStop) - skip for admin
-  // IMPORTANT: This filter should only apply to TODAY, just like uurOpVoorhand
-  // The filter compares CURRENT TIME in Brussels against the stop time,
-  // not the reservation time slot against the stop time
-  if (!isAdmin && isToday) {
-    const settings = data?.['general-settings'] || {};
-    const breakfastStop = settings.ontbijtStop || null;
-    const lunchStop = settings.lunchStop || null;
-    const dinnerStop = settings.dinerStop || null;
-
-    // Only apply if at least one stop time is configured
-    if (breakfastStop || lunchStop || dinnerStop) {
-      // Get current time in Brussels timezone (in minutes since midnight)
-      // Using Intl.DateTimeFormat for reliable timezone conversion
-      const formatter = new Intl.DateTimeFormat('en-US', {
-        timeZone: 'Europe/Brussels',
-        hour: '2-digit',
-        minute: '2-digit',
-        hour12: false,
-      });
-      const parts = formatter.formatToParts(now);
-      const timeParts = Object.fromEntries(parts.map(p => [p.type, p.value]));
-      const currentTimeMinutes = parseInt(timeParts.hour, 10) * 60 + parseInt(timeParts.minute, 10);
-
-      // Check if current time has passed any stop times
-      const breakfastStopMinutes = breakfastStop ? parseTime(breakfastStop) : null;
-      const lunchStopMinutes = lunchStop ? parseTime(lunchStop) : null;
-      const dinnerStopMinutes = dinnerStop ? parseTime(dinnerStop) : null;
-
-      const breakfastStopped = breakfastStopMinutes !== null && currentTimeMinutes >= breakfastStopMinutes;
-      const lunchStopped = lunchStopMinutes !== null && currentTimeMinutes >= lunchStopMinutes;
-      const dinnerStopped = dinnerStopMinutes !== null && currentTimeMinutes >= dinnerStopMinutes;
-
-      // Remove ALL slots of a meal type if current time >= stop time for that meal
-      for (const time in availableTimeblocks) {
-        const mealType = getMealTypeByTime(time);
-        let shouldRemove = false;
-
-        if (mealType === 'breakfast' && breakfastStopped) {
-          shouldRemove = true;
-        } else if (mealType === 'lunch' && lunchStopped) {
-          shouldRemove = true;
-        } else if (mealType === 'dinner' && dinnerStopped) {
-          shouldRemove = true;
-        }
-
-        if (shouldRemove) {
-          delete availableTimeblocks[time];
-        }
-      }
-    }
-  }
-
-  return availableTimeblocks;
-}
-
-module.exports = {
-  getAvailableTimeblocks,
-};
+// getAvailableTimeblocks.js
+
+const { timeblocksAvailable } = require('./processing/timeblocksAvailable');
+const { parseTime, getMealTypeByTime } = require('./tableHelpers');
+
+/**
+ * Parses a time string in "HH:MM" format into a Date object on a specific date.
+ * @param {string} dateStr - The date string in "YYYY-MM-DD" format.
+ * @param {string} timeStr - Time string in "HH:MM" format.
+ * @param {string} timeZone - The IANA time zone identifier (not used, kept for compatibility).
+ * @returns {Date} Date object representing the time on the specified date.
+ */
+function parseDateTimeInTimeZone(dateStr, timeStr, timeZone) {
+  const [year, month, day] = dateStr.split('-').map(Number);
+  const [hours, minutes] = timeStr.split(':').map(Number);
+
+  // Create a simple date object for the given date and time
+  // This represents the local time on that date
+  return new Date(year, month - 1, day, hours, minutes);
+}
+
+/**
+ * Gets the available time blocks or shifts for a reservation, considering 'uurOpVoorhand' and 'dagenInToekomst'.
+ * @param {Object} data - The main data object containing settings and meal information.
+ * @param {string} dateStr - The date string in "YYYY-MM-DD" format.
+ * @param {Array} reservations - An array of reservation objects.
+ * @param {number} guests - The number of guests for the reservation.
+ * @param {Array} blockedSlots - Optional array of blocked time slots to exclude.
+ * @param {string|null} giftcard - Optional giftcard to filter times by meal.
+ * @param {boolean} isAdmin - Optional flag to bypass time restrictions for admin users.
+ * @returns {Object} - Returns a pruned object of available time blocks or shifts, or an empty object if out of range.
+ */
+function getAvailableTimeblocks(data, dateStr, reservations, guests, blockedSlots = [], giftcard = null, isAdmin = false, duration = null) {
+  // Get 'uurOpVoorhand' from general settings
+  let uurOpVoorhand = 0;
+  if (
+    data['general-settings'] &&
+    data['general-settings'].uurOpVoorhand &&
+    parseInt(data['general-settings'].uurOpVoorhand, 10) >= 0
+  ) {
+    uurOpVoorhand = parseInt(data['general-settings'].uurOpVoorhand, 10);
+  }
+
+  // Get 'dagenInToekomst' from general settings
+  let dagenInToekomst = 90; // Default if not defined
+  if (
+    data['general-settings'] &&
+    data['general-settings'].dagenInToekomst &&
+    parseInt(data['general-settings'].dagenInToekomst, 10) > 0
+  ) {
+    dagenInToekomst = parseInt(data['general-settings'].dagenInToekomst, 10);
+  }
+
+  // Time zone for CEST/CET (Europe/Amsterdam)
+  const timeZone = 'Europe/Amsterdam';
+
+  // Current date/time in local timezone (system time)
+  // Note: We assume the server is running in the correct timezone
+  const now = new Date();
+  const currentTimeInTimeZone = now;
+
+  // Calculate the maximum allowed date
+  const maxAllowedDate = new Date(currentTimeInTimeZone.getTime());
+  maxAllowedDate.setDate(maxAllowedDate.getDate() + dagenInToekomst);
+  maxAllowedDate.setHours(23, 59, 59, 999);
+
+  // Parse the target date (just the date part, no time)
+  const [year, month, day] = dateStr.split('-').map(Number);
+  const targetDateInTimeZone = new Date(year, month - 1, day);
+
+  // Check if targetDateInTimeZone is within dagenInToekomst (skip for admin)
+  if (!isAdmin && targetDateInTimeZone > maxAllowedDate) {
+    // Out of allowed range, return empty object
+    return {};
+  }
+
+  // Check if the target date is today in the specified time zone
+  const isToday =
+    currentTimeInTimeZone.toDateString() === targetDateInTimeZone.toDateString();
+
+  // Get available time blocks or shifts
+  const availableTimeblocks = timeblocksAvailable(data, dateStr, reservations, guests, blockedSlots, giftcard, isAdmin, duration);
+
+  // If the date is today and uurOpVoorhand is greater than zero, prune time blocks (skip for admin)
+  if (!isAdmin && isToday && uurOpVoorhand >= 0) {
+    const cutoffTime = new Date(currentTimeInTimeZone.getTime());
+    cutoffTime.setHours(cutoffTime.getHours() + uurOpVoorhand);
+
+    for (const [key, value] of Object.entries(availableTimeblocks)) {
+      let timeStr = key;
+
+      const timeBlockDateTime = parseDateTimeInTimeZone(dateStr, timeStr, timeZone);
+
+      if (timeBlockDateTime < cutoffTime) {
+        delete availableTimeblocks[key];
+      }
+    }
+  }
+
+  // Apply last booking time filter (lunchStop, dinerStop, ontbijtStop) - skip for admin
+  // IMPORTANT: This filter should only apply to TODAY, just like uurOpVoorhand
+  // The filter compares CURRENT TIME in Brussels against the stop time,
+  // not the reservation time slot against the stop time
+  if (!isAdmin && isToday) {
+    const settings = data?.['general-settings'] || {};
+    const breakfastStop = settings.ontbijtStop || null;
+    const lunchStop = settings.lunchStop || null;
+    const dinnerStop = settings.dinerStop || null;
+
+    // Only apply if at least one stop time is configured
+    if (breakfastStop || lunchStop || dinnerStop) {
+      // Get current time in Brussels timezone (in minutes since midnight)
+      // Using Intl.DateTimeFormat for reliable timezone conversion
+      const formatter = new Intl.DateTimeFormat('en-US', {
+        timeZone: 'Europe/Brussels',
+        hour: '2-digit',
+        minute: '2-digit',
+        hour12: false,
+      });
+      const parts = formatter.formatToParts(now);
+      const timeParts = Object.fromEntries(parts.map(p => [p.type, p.value]));
+      const currentTimeMinutes = parseInt(timeParts.hour, 10) * 60 + parseInt(timeParts.minute, 10);
+
+      // Check if current time has passed any stop times
+      const breakfastStopMinutes = breakfastStop ? parseTime(breakfastStop) : null;
+      const lunchStopMinutes = lunchStop ? parseTime(lunchStop) : null;
+      const dinnerStopMinutes = dinnerStop ? parseTime(dinnerStop) : null;
+
+      const breakfastStopped = breakfastStopMinutes !== null && currentTimeMinutes >= breakfastStopMinutes;
+      const lunchStopped = lunchStopMinutes !== null && currentTimeMinutes >= lunchStopMinutes;
+      const dinnerStopped = dinnerStopMinutes !== null && currentTimeMinutes >= dinnerStopMinutes;
+
+      // Remove ALL slots of a meal type if current time >= stop time for that meal
+      for (const time in availableTimeblocks) {
+        const mealType = getMealTypeByTime(time);
+        let shouldRemove = false;
+
+        if (mealType === 'breakfast' && breakfastStopped) {
+          shouldRemove = true;
+        } else if (mealType === 'lunch' && lunchStopped) {
+          shouldRemove = true;
+        } else if (mealType === 'dinner' && dinnerStopped) {
+          shouldRemove = true;
+        }
+
+        if (shouldRemove) {
+          delete availableTimeblocks[time];
+        }
+      }
+    }
+  }
+
+  return availableTimeblocks;
+}
+
+module.exports = {
+  getAvailableTimeblocks,
+};

package/getDateClosingReasons.js

@@ -0,0 +1,193 @@
+// getDateClosingReasons.js
+//
+// Diagnostic function that identifies the KEY reason a date is closed.
+// Runs the same pipeline as Calendar.js's computeFinalTimeblocksCount,
+// but sequentially tracks which stage eliminates all remaining slots.
+//
+// IMPORTANT: This pipeline must stay in sync with Calendar.js's
+// computeFinalTimeblocksCount. If that pipeline changes, update this too.
+
+const { timeblocksAvailable } = require('./processing/timeblocksAvailable');
+const { getAvailableTimeblocks } = require('./getAvailableTimeblocks');
+const { getDataByDateAndMealWithExceptions } = require('./restaurant_data/exceptions');
+const { getDataByDateAndMeal } = require('./restaurant_data/openinghours');
+const { filterTimeblocksByMaxGroups } = require('./filters/maxGroupsFilter');
+const { filterTimeblocksByMaxArrivals } = require('./filters/maxArrivalsFilter');
+const { filterTimeblocksByStopTimes } = require('./filters/timeFilter');
+const { getAvailableTimeblocksWithTableCheck } = require('./simulateTableAssignment');
+
+/**
+ * Checks if a date is within the allowed future range defined by dagenInToekomst.
+ * Copied from isDateAvailable.js since it is not exported.
+ */
+function isDateWithinAllowedRange(data, dateStr) {
+  let dagenInToekomst = 90;
+  if (
+    data['general-settings'] &&
+    data['general-settings'].dagenInToekomst &&
+    parseInt(data['general-settings'].dagenInToekomst, 10) > 0
+  ) {
+    dagenInToekomst = parseInt(data['general-settings'].dagenInToekomst, 10);
+  }
+
+  const timeZone = 'Europe/Amsterdam';
+
+  const now = new Date();
+  const currentTimeInTimeZone = new Date(
+    now.toLocaleString('en-US', { timeZone: timeZone })
+  );
+
+  const maxAllowedDate = new Date(currentTimeInTimeZone.getTime());
+  maxAllowedDate.setDate(maxAllowedDate.getDate() + dagenInToekomst);
+  maxAllowedDate.setHours(23, 59, 59, 999);
+
+  const [year, month, day] = dateStr.split('-').map(Number);
+  const targetDate = new Date(Date.UTC(year, month - 1, day));
+  const targetDateInTimeZone = new Date(
+    targetDate.toLocaleString('en-US', { timeZone: timeZone })
+  );
+
+  return targetDateInTimeZone <= maxAllowedDate;
+}
+
+/**
+ * Diagnoses why a date has no available timeblocks.
+ * Runs the same pipeline as Calendar.js's computeFinalTimeblocksCount,
+ * but tracks at which stage slots go to zero to identify the key closing reason.
+ *
+ * @param {Object} data - Restaurant data object
+ * @param {string} dateStr - Date in "YYYY-MM-DD" format
+ * @param {Array} reservations - Existing reservations
+ * @param {number} guests - Number of guests for the reservation
+ * @param {Array} blockedSlots - Blocked time slots
+ * @param {string|null} giftcard - Selected giftcard or null
+ * @param {number|null} duration - Custom duration or null
+ * @param {string|null} zitplaats - Selected seating area or null
+ * @returns {Array<{type: string}>} Array of reason objects (typically single-element)
+ */
+function getDateClosingReasons(data, dateStr, reservations, guests, blockedSlots = [], giftcard = null, duration = null, zitplaats = null) {
+  const reasons = [];
+
+  // --- Stage 0: Date out of range ---
+  if (!isDateWithinAllowedRange(data, dateStr)) {
+    reasons.push({ type: 'DATE_OUT_OF_RANGE' });
+    return reasons;
+  }
+
+  // --- Stage 1: Opening hours & exceptions ---
+  // Check if any meal is open for this day (with exceptions applied)
+  const mealTypes = ['breakfast', 'lunch', 'dinner'];
+  let anyMealOpenWithExceptions = false;
+  let anyMealOpenWithoutExceptions = false;
+
+  for (const mealType of mealTypes) {
+    const withExceptions = getDataByDateAndMealWithExceptions(data, dateStr, mealType);
+    if (withExceptions) {
+      anyMealOpenWithExceptions = true;
+    }
+
+    const withoutExceptions = getDataByDateAndMeal(data, dateStr, mealType);
+    if (withoutExceptions) {
+      anyMealOpenWithoutExceptions = true;
+    }
+  }
+
+  if (!anyMealOpenWithExceptions) {
+    if (anyMealOpenWithoutExceptions) {
+      // Meals are enabled in base opening hours but closed by exception rule
+      reasons.push({ type: 'EXCEPTION_CLOSURE' });
+    } else {
+      // No meals enabled at all for this day of the week
+      reasons.push({ type: 'OPENING_HOURS_DISABLED' });
+    }
+    return reasons;
+  }
+
+  // --- Stage 2: Base capacity (0 reservations, no blocked slots, no giftcard) ---
+  // Tests if the restaurant has enough base capacity for the group size
+  const baseTbs = timeblocksAvailable(data, dateStr, [], guests, [], null, false, duration);
+  if (Object.keys(baseTbs).length === 0) {
+    reasons.push({ type: 'CAPACITY_INSUFFICIENT' });
+    return reasons;
+  }
+
+  // --- Stage 3: With real reservations (no blocked slots, no giftcard) ---
+  // Tests if existing bookings have filled all capacity
+  const withResTbs = timeblocksAvailable(data, dateStr, reservations, guests, [], null, false, duration);
+  if (Object.keys(withResTbs).length === 0) {
+    reasons.push({ type: 'CAPACITY_REACHED' });
+    return reasons;
+  }
+
+  // --- Stage 4: With giftcard filter (if applicable) ---
+  if (giftcard) {
+    const withGcTbs = timeblocksAvailable(data, dateStr, reservations, guests, [], giftcard, false, duration);
+    if (Object.keys(withGcTbs).length === 0) {
+      reasons.push({ type: 'GIFTCARD_MISMATCH' });
+      return reasons;
+    }
+  }
+
+  // --- Stage 5: With blocked slots ---
+  // Full timeblocksAvailable call (capacity + giftcard + blocked slots)
+  const fullTbs = timeblocksAvailable(data, dateStr, reservations, guests, blockedSlots, giftcard, false, duration);
+  if (Object.keys(fullTbs).length === 0) {
+    reasons.push({ type: 'BLOCKED_SLOTS' });
+    return reasons;
+  }
+
+  // --- Stage 6: getAvailableTimeblocks (adds today-only filters: uurOpVoorhand + stop times) ---
+  let tbs = getAvailableTimeblocks(data, dateStr, reservations, guests, blockedSlots, giftcard, false, duration);
+  if (Object.keys(tbs).length === 0) {
+    reasons.push({ type: 'TODAY_TIME_RESTRICTION' });
+    return reasons;
+  }
+
+  // --- Stage 7: Max groups filter ---
+  tbs = filterTimeblocksByMaxGroups(data, dateStr, tbs, reservations, guests);
+  if (Object.keys(tbs).length === 0) {
+    reasons.push({ type: 'MAX_GROUPS' });
+    return reasons;
+  }
+
+  // --- Stage 8: Max arrivals filter ---
+  tbs = filterTimeblocksByMaxArrivals(data, dateStr, tbs, reservations, guests);
+  if (Object.keys(tbs).length === 0) {
+    reasons.push({ type: 'MAX_ARRIVALS' });
+    return reasons;
+  }
+
+  // --- Stage 9: Table assignment (if enabled) ---
+  const tableSettings = data?.['table-settings'] || {};
+  const isTableAssignmentEnabled =
+    tableSettings.isInstalled === true && tableSettings.assignmentMode === 'automatic';
+
+  if (isTableAssignmentEnabled) {
+    const tableTbs = getAvailableTimeblocksWithTableCheck(data, dateStr, tbs, guests, reservations, zitplaats, duration);
+    if (Object.keys(tableTbs).length === 0) {
+      reasons.push({ type: 'TABLE_PLAN' });
+      return reasons;
+    }
+
+    // Re-apply max arrivals after table check (matching Calendar pipeline)
+    tbs = filterTimeblocksByMaxArrivals(data, dateStr, tableTbs, reservations, guests);
+    if (Object.keys(tbs).length === 0) {
+      reasons.push({ type: 'MAX_ARRIVALS' });
+      return reasons;
+    }
+  }
+
+  // --- Stage 10: Stop times filter ---
+  tbs = filterTimeblocksByStopTimes(tbs, data, dateStr);
+  if (Object.keys(tbs).length === 0) {
+    reasons.push({ type: 'TODAY_TIME_RESTRICTION' });
+    return reasons;
+  }
+
+  // If we get here, the date is actually available (reasons array is empty)
+  return reasons;
+}
+
+module.exports = {
+  getDateClosingReasons,
+};