@happychef/algorithm 1.3.0 → 1.4.0

package/getDateClosingReasons.js

@@ -1,193 +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,
-};
+// 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,
+};