@platform-modules/foreign-ministry 1.3.276 → 1.3.286

package/src/helpers/evaluation-eligibility.utils.ts

@@ -0,0 +1,36 @@
+/**
+ * Whether evaluations are still open for a setting's month range.
+ * `evaluation_end_date` is the last calendar day (1–31) of each month in the range.
+ */
+export function isEvaluationEligibilityWindowOpen(
+  fromMonth: number,
+  toMonth: number,
+  evaluationEndDay: number,
+  referenceDate: Date = new Date()
+): boolean {
+  const month = referenceDate.getUTCMonth() + 1;
+  const day = referenceDate.getUTCDate();
+  if (month < fromMonth || month > toMonth) return false;
+  if (!Number.isFinite(evaluationEndDay) || evaluationEndDay < 1 || evaluationEndDay > 31) return false;
+  return day <= evaluationEndDay;
+}
+
+export function parseEvaluationEndDay(input: unknown): number | null {
+  if (input == null || input === '') return null;
+  const n = typeof input === 'number' ? input : parseInt(String(input).trim(), 10);
+  if (!Number.isFinite(n) || n < 1 || n > 31) return null;
+  return Math.floor(n);
+}
+
+export function parseMonthRange(
+  fromInput: unknown,
+  toInput: unknown
+): { from_month: number; to_month: number } | null {
+  const from_month = typeof fromInput === 'number' ? fromInput : parseInt(String(fromInput).trim(), 10);
+  const to_month = typeof toInput === 'number' ? toInput : parseInt(String(toInput).trim(), 10);
+  if (!Number.isFinite(from_month) || !Number.isFinite(to_month)) return null;
+  if (!Number.isInteger(from_month) || !Number.isInteger(to_month)) return null;
+  if (from_month < 1 || from_month > 12 || to_month < 1 || to_month > 12) return null;
+  if (from_month > to_month) return null;
+  return { from_month, to_month };
+}