@pisell/pisellos 2.2.299 → 2.2.300

package/dist/modules/ResourcePlanner/planner.d.ts

@@ -1,5 +1,5 @@
 import type { AvailabilityProjection, AvailabilityProjectionInput, AvailabilityQuery, AvailabilityQueryResult, AvailabilitySelectionValidationParams, AvailabilitySelectionValidationResult, GetProductTimeRangesRequest, GetProductTimeRangesRuntimeOptions, ProductTimeRangeGroup } from './types';
 export declare function createAvailabilityProjection(input: AvailabilityProjectionInput): AvailabilityProjection;
 export declare function getProductTimeRanges(projection: AvailabilityProjection, request?: GetProductTimeRangesRequest, runtimeOptions?: GetProductTimeRangesRuntimeOptions): ProductTimeRangeGroup[];
-export declare function queryAvailabilityProjection(projection: AvailabilityProjection, request: AvailabilityQuery): AvailabilityQueryResult;
-export declare function validateAvailabilitySelection(projection: AvailabilityProjection, params: AvailabilitySelectionValidationParams): AvailabilitySelectionValidationResult;
+export declare function queryAvailabilityProjection(projection: AvailabilityProjection, request: AvailabilityQuery, runtimeOptions?: GetProductTimeRangesRuntimeOptions): AvailabilityQueryResult;
+export declare function validateAvailabilitySelection(projection: AvailabilityProjection, params: AvailabilitySelectionValidationParams, runtimeOptions?: GetProductTimeRangesRuntimeOptions): AvailabilitySelectionValidationResult;

package/dist/modules/ResourcePlanner/planner.js

@@ -175,8 +175,70 @@ function addLeadWindow(base, unit, unitType, _timezoneName) {
   if (unitType === 'hours') return addLocalHours(base, unit);
   return addLocalMinutes(base, unit);
 }
+function normalizedWindowContainsRange(windows, candidateRange, timezoneName) {
+  return windows.some(function (window) {
+    var normalized = normalizeAbsoluteRange(window, timezoneName);
+    return Boolean(normalized && contains(normalized, candidateRange));
+  });
+}
+function normalizedWindowsContainDate(windows, date, timezoneName) {
+  return windows.some(function (window) {
+    var normalized = normalizeAbsoluteRange(window, timezoneName);
+    return Boolean(normalized && formatDate(normalized.start, timezoneName) === date);
+  });
+}
+function isRangeFromExcludedWindows(params) {
+  var candidateDate = formatDate(params.candidateRange.start, params.timezoneName);
+  var hasNormalWindowOnDate = normalizedWindowsContainDate(params.normalWindows, candidateDate, params.timezoneName);
+  var hasExcludedWindowOnDate = normalizedWindowsContainDate(params.excludedWindows, candidateDate, params.timezoneName);
+  if (!hasNormalWindowOnDate && hasExcludedWindowOnDate) return true;
+  return !normalizedWindowContainsRange(params.normalWindows, params.candidateRange, params.timezoneName) && normalizedWindowContainsRange(params.excludedWindows, params.candidateRange, params.timezoneName);
+}
+function isCandidateFromExcludedScheduleDate(params) {
+  var projection = params.projection,
+    product = params.product,
+    candidate = params.candidate,
+    candidateRange = params.candidateRange;
+  var operatingHours = projection.meta.defaults.operatingHours;
+  if (isRangeFromExcludedWindows({
+    normalWindows: operatingHours.windows,
+    excludedWindows: operatingHours.excludedWindows || [],
+    candidateRange: candidateRange,
+    timezoneName: projection.meta.timezone
+  })) {
+    return true;
+  }
+  if (product.kind !== 'session' && product.kind !== 'venue_slot') {
+    return false;
+  }
+  if (candidate.source !== 'session_schedule') {
+    var hasNormalRule = (product.sessionRules || []).some(function (rule) {
+      return matchesScheduleRuleDate(rule, candidate.date, projection.meta.timezone);
+    });
+    var hasExcludedOverrideRule = (product.sessionRules || []).some(function (rule) {
+      return !matchesScheduleRuleDate(rule, candidate.date, projection.meta.timezone) && matchesScheduleRuleDate(rule, candidate.date, projection.meta.timezone, true);
+    });
+    return !hasNormalRule && hasExcludedOverrideRule;
+  }
+  var candidateDateRange = {
+    startDate: candidate.date,
+    endDate: candidate.date
+  };
+  var candidateIdentity = getProductTimeRangeIdentity(candidate);
+  var normalRanges = getSessionRangesForProduct(projection, product, candidateDateRange);
+  if (normalRanges.some(function (range) {
+    return getProductTimeRangeIdentity(range) === candidateIdentity;
+  })) {
+    return false;
+  }
+  return getSessionRangesForProduct(projection, product, candidateDateRange, true).some(function (range) {
+    return getProductTimeRangeIdentity(range) === candidateIdentity;
+  });
+}
 function evaluateCandidateTimeGate(params) {
-  var product = params.product,
+  var projection = params.projection,
+    product = params.product,
+    candidate = params.candidate,
     candidateRange = params.candidateRange,
     evaluationContext = params.evaluationContext,
     timezoneName = params.timezoneName;
@@ -188,6 +250,18 @@ function evaluateCandidateTimeGate(params) {
       conflictCode: 'past'
     };
   }
+  if (evaluationContext.allowExcludedScheduleDateOverride && isCandidateFromExcludedScheduleDate({
+    projection: projection,
+    product: product,
+    candidate: candidate,
+    candidateRange: candidateRange
+  })) {
+    return {
+      status: 'unavailable',
+      reasonCodes: ['schedule_excluded_date'],
+      conflictCode: 'schedule_excluded_date'
+    };
+  }
   var policy = product.cutOffPolicy;
   if (!policy) return null;
   if (resolveCutOffPolicyIssue(policy)) {
@@ -334,7 +408,8 @@ function normalizeCoverage(input) {
   };
 }
 function normalizeResourceWindow(resource, coverage, timezoneName) {
-  return mergeRanges((resource.windows || []).map(function (window) {
+  var includeExcludedWindows = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
+  return mergeRanges([].concat(_toConsumableArray(resource.windows || []), _toConsumableArray(includeExcludedWindows ? resource.excludedWindows || [] : [])).map(function (window) {
     return normalizeAbsoluteRange(window, timezoneName);
   }).filter(function (window) {
     return Boolean(window);
@@ -407,12 +482,15 @@ function normalizeResources(resources) {
       capacity: Math.max(1, Number(resource.capacity || 1) || 1),
       windows: (resource.windows || []).map(function (window) {
         return _objectSpread({}, window);
+      }),
+      excludedWindows: (resource.excludedWindows || []).map(function (window) {
+        return _objectSpread({}, window);
       })
     });
   });
 }
 function normalizeOperatingHours(params) {
-  var _params$input, _params$input2, _params$input3;
+  var _params$input, _params$input2, _params$input3, _params$input4;
   var fallbackWindows = enumerateDates(params.dateRange.startDate, params.dateRange.endDate).map(function (date) {
     var start = toDateTimeInDate(date, params.businessHours.startTime, params.timezoneName);
     var end = toDateTimeInDate(date, params.businessHours.endTime, params.timezoneName);
@@ -430,26 +508,32 @@ function normalizeOperatingHours(params) {
       endAt: formatDateTime(range.end, params.timezoneName, params.fixedOffsetMinutes)
     };
   });
-  var windows = mergeRanges(sourceWindows.map(function (window) {
-    return normalizeAbsoluteRange(window, params.timezoneName);
-  }).filter(function (window) {
-    return Boolean(window);
-  }).map(function (window) {
-    return clipRange(window, params.coverage);
-  }).filter(function (window) {
-    return Boolean(window);
-  })).map(function (range) {
-    return {
-      startAt: formatDateTime(range.start, params.timezoneName, params.fixedOffsetMinutes),
-      endAt: formatDateTime(range.end, params.timezoneName, params.fixedOffsetMinutes)
-    };
-  });
-  return {
-    source: ((_params$input = params.input) === null || _params$input === void 0 ? void 0 : _params$input.source) || params.fallbackSource,
-    scheduleIds: uniqById(((_params$input2 = params.input) === null || _params$input2 === void 0 ? void 0 : _params$input2.scheduleIds) || []),
-    missingScheduleIds: uniqById(((_params$input3 = params.input) === null || _params$input3 === void 0 ? void 0 : _params$input3.missingScheduleIds) || []),
-    windows: windows
+  var normalizeWindows = function normalizeWindows(source) {
+    return mergeRanges(source.map(function (window) {
+      return normalizeAbsoluteRange(window, params.timezoneName);
+    }).filter(function (window) {
+      return Boolean(window);
+    }).map(function (window) {
+      return clipRange(window, params.coverage);
+    }).filter(function (window) {
+      return Boolean(window);
+    })).map(function (range) {
+      return {
+        startAt: formatDateTime(range.start, params.timezoneName, params.fixedOffsetMinutes),
+        endAt: formatDateTime(range.end, params.timezoneName, params.fixedOffsetMinutes)
+      };
+    });
   };
+  var windows = normalizeWindows(sourceWindows);
+  var excludedWindows = normalizeWindows(((_params$input = params.input) === null || _params$input === void 0 ? void 0 : _params$input.excludedWindows) || []);
+  return _objectSpread({
+    source: ((_params$input2 = params.input) === null || _params$input2 === void 0 ? void 0 : _params$input2.source) || params.fallbackSource,
+    scheduleIds: uniqById(((_params$input3 = params.input) === null || _params$input3 === void 0 ? void 0 : _params$input3.scheduleIds) || []),
+    missingScheduleIds: uniqById(((_params$input4 = params.input) === null || _params$input4 === void 0 ? void 0 : _params$input4.missingScheduleIds) || []),
+    windows: windows
+  }, excludedWindows.length > 0 ? {
+    excludedWindows: excludedWindows
+  } : {});
 }
 function matchesRequirementGroup(requirementGroup, resource, product) {
   var _requirementGroup$res;
@@ -759,11 +843,12 @@ function resolveProjectionDateRange(projection, requestDateRange) {
   };
 }
 function buildOperatingRanges(projection, dateRange) {
+  var includeExcludedWindows = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
   var coverage = {
     start: toDateStart(dateRange.startDate, projection.meta.timezone),
     end: toDateEnd(nextDate(dateRange.endDate), projection.meta.timezone)
   };
-  return mergeRanges(projection.meta.defaults.operatingHours.windows.map(function (window) {
+  return mergeRanges([].concat(_toConsumableArray(projection.meta.defaults.operatingHours.windows), _toConsumableArray(includeExcludedWindows ? projection.meta.defaults.operatingHours.excludedWindows || [] : [])).map(function (window) {
     return normalizeAbsoluteRange(window, projection.meta.timezone);
   }).filter(function (window) {
     return Boolean(window);
@@ -774,12 +859,13 @@ function buildOperatingRanges(projection, dateRange) {
   }));
 }
 function buildResourceWindowIndex(projection) {
+  var includeExcludedWindows = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
   var coverage = {
     start: toDateTime(projection.meta.coverage.startAt, projection.meta.timezone),
     end: toDateTime(projection.meta.coverage.endAt, projection.meta.timezone)
   };
   return new Map(projection.resources.map(function (resource) {
-    return [String(resource.id), normalizeResourceWindow(resource, coverage, projection.meta.timezone)];
+    return [String(resource.id), normalizeResourceWindow(resource, coverage, projection.meta.timezone, includeExcludedWindows)];
   }));
 }
 function buildGroupWorkingRanges(params) {
@@ -801,7 +887,7 @@ function buildGroupWorkingRanges(params) {
     return !filteredResourceIdSet || filteredResourceIdSet.has(String(resource.id));
   }).map(function (resource) {
     var _params$resourceWindo;
-    var windows = ((_params$resourceWindo = params.resourceWindowIndex) === null || _params$resourceWindo === void 0 ? void 0 : _params$resourceWindo.get(String(resource.id))) || normalizeResourceWindow(resource, coverage, projection.meta.timezone);
+    var windows = ((_params$resourceWindo = params.resourceWindowIndex) === null || _params$resourceWindo === void 0 ? void 0 : _params$resourceWindo.get(String(resource.id))) || normalizeResourceWindow(resource, coverage, projection.meta.timezone, params.includeExcludedWindows === true);
     return windows.map(function (window) {
       return clipRange(window, coverage);
     }).filter(function (window) {
@@ -848,11 +934,12 @@ function buildGroupWorkingRanges(params) {
   return mergeRanges(satisfiedRanges);
 }
 function materializeScheduleRules(rules, dateRange, timezoneName, fixedOffsetMinutes) {
+  var allowExcludedScheduleDates = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : false;
   var dates = enumerateDates(dateRange.startDate, dateRange.endDate);
   var seen = new Map();
   rules.forEach(function (rule) {
     dates.forEach(function (date) {
-      if (!matchesScheduleRuleDate(rule, date, timezoneName)) return;
+      if (!matchesScheduleRuleDate(rule, date, timezoneName, allowExcludedScheduleDates)) return;
       var start = toDateTimeInDate(date, rule.startTime, timezoneName);
       var end = toDateTimeInDate(date, rule.endTime, timezoneName);
       if (end <= start) end = toDateTimeInDate(nextDate(date, timezoneName), rule.endTime, timezoneName);
@@ -885,8 +972,9 @@ function materializeScheduleRules(rules, dateRange, timezoneName, fixedOffsetMin
 }
 function matchesScheduleRuleDate(rule, date, _timezoneName) {
   var _rule$includeDates, _rule$excludeDates;
+  var allowExcludedScheduleDate = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
   if ((_rule$includeDates = rule.includeDates) !== null && _rule$includeDates !== void 0 && _rule$includeDates.includes(date)) return true;
-  if ((_rule$excludeDates = rule.excludeDates) !== null && _rule$excludeDates !== void 0 && _rule$excludeDates.includes(date)) return false;
+  if (!allowExcludedScheduleDate && (_rule$excludeDates = rule.excludeDates) !== null && _rule$excludeDates !== void 0 && _rule$excludeDates.includes(date)) return false;
   if (rule.startDate && date < rule.startDate) return false;
   if (rule.endDate && date > rule.endDate) return false;
   if (rule.mode === 'designation') {
@@ -942,6 +1030,7 @@ function buildGroupResourceIndex(params) {
 }
 function getSessionRangesForProduct(projection, product, dateRange) {
   var _extractFixedOffsetMi2;
+  var allowExcludedScheduleDates = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
   var fixedOffsetMinutes = (_extractFixedOffsetMi2 = extractFixedOffsetMinutes(projection.meta.now)) !== null && _extractFixedOffsetMi2 !== void 0 ? _extractFixedOffsetMi2 : captureRuntimeOffsetMinutes();
   var ranges = (product.sessionRanges || []).map(function (range) {
     var _range$scheduleRefs2;
@@ -967,7 +1056,7 @@ function getSessionRangesForProduct(projection, product, dateRange) {
       primaryScheduleRef: (_range$scheduleRefs2 = range.scheduleRefs) === null || _range$scheduleRefs2 === void 0 ? void 0 : _range$scheduleRefs2[0]
     };
   }).filter(Boolean);
-  var ruleRanges = materializeScheduleRules(product.sessionRules || [], dateRange, projection.meta.timezone, fixedOffsetMinutes);
+  var ruleRanges = materializeScheduleRules(product.sessionRules || [], dateRange, projection.meta.timezone, fixedOffsetMinutes, allowExcludedScheduleDates);
   return dedupeProductRanges([].concat(_toConsumableArray(ranges), _toConsumableArray(ruleRanges.map(function (range) {
     return _objectSpread(_objectSpread({}, range), {}, {
       key: "".concat(String(product.id), ":").concat(range.startAt, ":").concat(range.endAt),
@@ -1022,7 +1111,8 @@ export function getProductTimeRanges(projection) {
   var dateRange = resolveProjectionDateRange(projection, request.dateRange);
   var slotStepMinutes = projection.meta.defaults.slotStepMinutes;
   var fixedOffsetMinutes = (_extractFixedOffsetMi3 = extractFixedOffsetMinutes(projection.meta.now)) !== null && _extractFixedOffsetMi3 !== void 0 ? _extractFixedOffsetMi3 : captureRuntimeOffsetMinutes();
-  var resourceWindowIndex = buildResourceWindowIndex(projection);
+  var allowExcludedScheduleDateOverride = runtimeOptions.allowExcludedScheduleDateOverride === true;
+  var resourceWindowIndex = buildResourceWindowIndex(projection, allowExcludedScheduleDateOverride);
   var filteredProductIdSet = (_request$productIds = request.productIds) !== null && _request$productIds !== void 0 && _request$productIds.length ? new Set(request.productIds.map(String)) : null;
   return projection.products.filter(function (product) {
     return !filteredProductIdSet || filteredProductIdSet.has(String(product.id));
@@ -1037,7 +1127,7 @@ export function getProductTimeRanges(projection) {
       };
     }
     if (product.kind === 'session' || product.kind === 'venue_slot') {
-      var fixedRanges = getSessionRangesForProduct(projection, product, dateRange);
+      var fixedRanges = getSessionRangesForProduct(projection, product, dateRange, allowExcludedScheduleDateOverride);
       var customRanges = [];
       var customDurationMinutes = resolveRequestedSessionDurationMinutes(product, request, runtimeOptions.allowSessionCustomRanges === true);
       var _requestedStartTimes = resolveRequestedDurationStartTimes(product, request, runtimeOptions.allowSessionCustomRanges === true);
@@ -1059,7 +1149,7 @@ export function getProductTimeRanges(projection) {
     var requiredGroups = (product.requirementGroups || []).filter(function (group) {
       return group.required !== false;
     });
-    var operatingRanges = buildOperatingRanges(projection, dateRange);
+    var operatingRanges = buildOperatingRanges(projection, dateRange, allowExcludedScheduleDateOverride);
     var operatingEndAt = dateRange.startDate === dateRange.endDate && operatingRanges.length > 0 ? formatDateTime(Math.max.apply(Math, _toConsumableArray(operatingRanges.map(function (range) {
       return range.end;
     }))), projection.meta.timezone, fixedOffsetMinutes) : undefined;
@@ -1071,7 +1161,8 @@ export function getProductTimeRanges(projection) {
         dateRange: dateRange,
         resourceIds: request.resourceIds,
         partySize: normalizedPartySize,
-        resourceWindowIndex: resourceWindowIndex
+        resourceWindowIndex: resourceWindowIndex,
+        includeExcludedWindows: allowExcludedScheduleDateOverride
       });
     }).reduce(function (current, ranges) {
       return current === null ? ranges : intersectRangeLists(current, ranges);
@@ -1353,7 +1444,8 @@ function buildEvaluationContext(params) {
     evaluatedAt: evaluatedAt,
     evaluatedAtMs: evaluatedAt,
     resourceIdSet: (_params$resourceIds2 = params.resourceIds) !== null && _params$resourceIds2 !== void 0 && _params$resourceIds2.length ? new Set(params.resourceIds.map(String)) : null,
-    selectionsByGroupKey: selectionsByGroupKey
+    selectionsByGroupKey: selectionsByGroupKey,
+    allowExcludedScheduleDateOverride: params.allowExcludedScheduleDateOverride === true
   };
 }
 function summarizeStatuses(statuses) {
@@ -1525,7 +1617,8 @@ function evaluateCandidateSummary(projection, candidate, request) {
   var evaluationContext = request.evaluationContext || buildEvaluationContext({
     projection: projection,
     evaluatedAt: request.evaluatedAt,
-    resourceIds: request.resourceIds
+    resourceIds: request.resourceIds,
+    allowExcludedScheduleDateOverride: request.allowExcludedScheduleDateOverride
   });
   var requestedPartySize = normalizePartySize(request.partySize);
   var requiredGroups = (product.requirementGroups || []).filter(function (group) {
@@ -1543,7 +1636,9 @@ function evaluateCandidateSummary(projection, candidate, request) {
     });
   });
   var gate = evaluateCandidateTimeGate({
+    projection: projection,
     product: product,
+    candidate: candidate,
     candidateRange: candidateRange,
     evaluationContext: evaluationContext,
     timezoneName: projection.meta.timezone
@@ -1598,7 +1693,8 @@ function evaluateCandidate(projection, candidate, request) {
     projection: projection,
     evaluatedAt: request.evaluatedAt,
     resourceIds: request.resourceIds,
-    requirementSelections: request.requirementSelections
+    requirementSelections: request.requirementSelections,
+    allowExcludedScheduleDateOverride: request.allowExcludedScheduleDateOverride
   });
   var requestedPartySize = normalizePartySize(request.partySize);
   var partySize = requestedPartySize !== null && requestedPartySize !== void 0 ? requestedPartySize : 1;
@@ -1621,6 +1717,12 @@ function evaluateCandidate(projection, candidate, request) {
     var options = matchedResources.map(function (resource) {
       var _request$cellIndex, _resource$raw2;
       var matchedCell = aggregateMatchedCells(product.id, requirementGroup.id, resource.id, candidateRange, ((_request$cellIndex = request.cellIndex) === null || _request$cellIndex === void 0 ? void 0 : _request$cellIndex.get([String(product.id), requirementGroup.id, String(resource.id)].join(':'))) || []);
+      var isExcludedScheduleDate = evaluationContext.allowExcludedScheduleDateOverride && isRangeFromExcludedWindows({
+        normalWindows: resource.windows || [],
+        excludedWindows: resource.excludedWindows || [],
+        candidateRange: candidateRange,
+        timezoneName: projection.meta.timezone
+      });
       if (!matchedCell) {
         var _resource$raw;
         var _isPast = candidateRange.endMs <= evaluationContext.evaluatedAtMs;
@@ -1632,7 +1734,7 @@ function evaluateCandidate(projection, candidate, request) {
           resourceType: resource.resourceType,
           status: _isPast ? 'past' : 'unavailable',
           maxPartySize: 0,
-          reasonCodes: _isPast ? ['past'] : ['outside_resource_window']
+          reasonCodes: _isPast ? ['past'] : [].concat(_toConsumableArray(isExcludedScheduleDate ? ['schedule_excluded_date'] : []), ['outside_resource_window'])
         };
       }
       var remainingCapacity = matchedCell.remainingCapacity;
@@ -1640,6 +1742,7 @@ function evaluateCandidate(projection, candidate, request) {
       var isPast = candidateRange.endMs <= evaluationContext.evaluatedAtMs;
       var maxPartySize = isPast ? 0 : Math.max(0, remainingCapacity || 0);
       var requiredCapacity = resolveRequiredCapacity(requirementGroup, product, requestedPartySize);
+      var reasonCodes = Array.from(new Set([].concat(_toConsumableArray(matchedCell.reasonCodes), _toConsumableArray(isExcludedScheduleDate ? ['schedule_excluded_date'] : []))));
       var status = function () {
         if (isPast) return 'past';
         if (matchedCell.status === 'unavailable') return 'unavailable';
@@ -1657,7 +1760,7 @@ function evaluateCandidate(projection, candidate, request) {
         remainingCapacity: remainingCapacity,
         maxCapacity: maxCapacity,
         maxPartySize: maxPartySize,
-        reasonCodes: isPast ? Array.from(new Set([].concat(_toConsumableArray(matchedCell.reasonCodes), ['past']))) : matchedCell.reasonCodes,
+        reasonCodes: isPast ? Array.from(new Set([].concat(reasonCodes, ['past']))) : reasonCodes,
         matchedCell: matchedCell
       };
     });
@@ -1715,7 +1818,9 @@ function evaluateCandidate(projection, candidate, request) {
     return group.status;
   });
   var gate = evaluateCandidateTimeGate({
+    projection: projection,
     product: product,
+    candidate: candidate,
     candidateRange: candidateRange,
     evaluationContext: evaluationContext,
     timezoneName: projection.meta.timezone
@@ -1804,6 +1909,7 @@ function assertRangesWithinProjection(projection, ranges) {
 }
 export function queryAvailabilityProjection(projection, request) {
   var _extractFixedOffsetMi6, _request$productIds2;
+  var runtimeOptions = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
   var normalizedPartySize = normalizePartySize(request.partySize);
   var evaluatedAt = formatDateTime(localDateToScalar(new Date()), projection.meta.timezone, (_extractFixedOffsetMi6 = extractFixedOffsetMinutes(projection.meta.now)) !== null && _extractFixedOffsetMi6 !== void 0 ? _extractFixedOffsetMi6 : captureRuntimeOffsetMinutes());
   if (request.target === 'time') {
@@ -1826,7 +1932,8 @@ export function queryAvailabilityProjection(projection, request) {
   var evaluationContext = buildEvaluationContext({
     projection: projection,
     evaluatedAt: evaluatedAt,
-    resourceIds: request.resourceIds
+    resourceIds: request.resourceIds,
+    allowExcludedScheduleDateOverride: runtimeOptions.allowExcludedScheduleDateOverride
   });
   if (request.target === 'time') {
     var candidates = dedupeProductRanges(request.candidates);
@@ -1914,7 +2021,8 @@ export function queryAvailabilityProjection(projection, request) {
     resourceIds: request.resourceIds,
     partySize: normalizedPartySize
   }, {
-    evaluatedAt: evaluatedAt
+    evaluatedAt: evaluatedAt,
+    allowExcludedScheduleDateOverride: runtimeOptions.allowExcludedScheduleDateOverride
   });
   var candidateGroupMap = new Map(candidateGroups.map(function (group) {
     return [String(group.productId), group];
@@ -2092,6 +2200,7 @@ function summarizeProductStatus(statuses) {
 }
 export function validateAvailabilitySelection(projection, params) {
   var _extractFixedOffsetMi7;
+  var runtimeOptions = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
   var normalizedPartySize = normalizePartySize(params.partySize);
   var normalizedBookingCount = normalizeBookingCount(params.bookingCount);
   assertRangesWithinProjection(projection, [params.candidate]);
@@ -2112,14 +2221,15 @@ export function validateAvailabilitySelection(projection, params) {
     evaluationContext: buildEvaluationContext({
       projection: projection,
       evaluatedAt: evaluatedAt,
-      requirementSelections: params.requirementSelections
+      requirementSelections: params.requirementSelections,
+      allowExcludedScheduleDateOverride: runtimeOptions.allowExcludedScheduleDateOverride
     })
   });
   var conflicts = [];
   if (evaluated.gate) {
     conflicts.push({
       code: evaluated.gate.conflictCode,
-      message: evaluated.gate.status === 'past' ? '候选时间已过期' : '候选时间不满足预订时间门禁',
+      message: evaluated.gate.conflictCode === 'past' ? '候选时间已过期' : evaluated.gate.conflictCode === 'schedule_excluded_date' ? '候选日期已被日程排除' : '候选时间不满足预订时间门禁',
       reasonCodes: evaluated.gate.reasonCodes,
       productId: params.candidate.productId,
       candidateKey: params.candidate.key

package/dist/modules/ResourcePlanner/types.d.ts

@@ -101,6 +101,9 @@ export interface AvailabilityOperatingHoursSnapshot {
     scheduleIds: AvailabilityId[];
     missingScheduleIds: AvailabilityId[];
     windows: AvailabilityResourceWindow[];
+    /** Schedule windows omitted only because their date is excluded. POS may use
+     * these to surface an unavailable, manually selectable candidate. */
+    excludedWindows?: AvailabilityResourceWindow[];
 }
 export interface AvailabilityResource {
     id: AvailabilityId;
@@ -110,6 +113,8 @@ export interface AvailabilityResource {
     resourceType: AvailabilityResourceType;
     capacity: number;
     windows: AvailabilityResourceWindow[];
+    /** Resource work windows omitted only by an excluded schedule date. */
+    excludedWindows?: AvailabilityResourceWindow[];
     raw?: Record<string, any>;
 }
 export interface AvailabilityOccupancy extends AvailabilityAbsoluteRange {
@@ -252,6 +257,11 @@ export interface GetProductTimeRangesRuntimeOptions {
      * disabled.
      */
     allowSessionCustomRanges?: boolean;
+    /**
+     * Internal POS capability: materialize candidates whose schedule date was
+     * explicitly excluded, while availability evaluation keeps them unavailable.
+     */
+    allowExcludedScheduleDateOverride?: boolean;
 }
 export interface QueryAvailabilityBaseRequest {
     productIds?: AvailabilityId[];