@autobusal/utilities 1.5.4 → 1.5.5

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 1.5.5 (2026-08-29)
+
+- New isPreparedDate(): whether a string is a d/m/Y date the app can work with - createDate turns anything else into an Invalid Date, which is how the search URL's literal 'none' produced a January calendar.
+
 ## 1.5.4 (2026-08-28)
 
 - DisplayStatus renders status 4 (awaiting approval) as a badge instead of a blank cell in the admin agent/visitor/API-consumer lists (sweep #61).

package/date.tsx

@@ -6,6 +6,43 @@ export const createDate = (prepared: string): Date => {
   return new Date(Date.UTC(Number(data[2]), Number(data[1]) - 1, Number(data[0])));
 };
 
+/**
+ * Whether a string is a d/m/Y date this app can actually work with.
+ *
+ * Claude - Date: 2026-08-29
+ *
+ * `createDate` splits on "/" and feeds the pieces to Date.UTC, so anything
+ * that is not a date at all produces an Invalid Date rather than an error -
+ * and a calendar built from one renders January of nothing. The literal
+ * "none" the search URL carries for "no return leg" is exactly that, which
+ * is how the round-trip picker came to open on January instead of the
+ * outbound's month.
+ */
+export const isPreparedDate = (value?: string | null): boolean => {
+  if (!value) {
+    return false;
+  }
+
+  const parts = value.split('/');
+
+  if (parts.length !== 3) {
+    return false;
+  }
+
+  const [ day, month, year ] = parts.map(Number);
+
+  if (!day || !month || !year) {
+    return false;
+  }
+
+  const date = new Date(Date.UTC(year, month - 1, day));
+
+  // round-trips through Date so 31/02/2026 is refused as well as "none"
+  return date.getUTCFullYear() === year
+    && date.getUTCMonth() === month - 1
+    && date.getUTCDate() === day;
+};
+
 export const prepareDate = (date: Date): string => {
   const day = date.getDate();
   const month = date.getMonth() + 1;

package/index.ts

@@ -1,4 +1,4 @@
-import { createDate, prepareDate, getFormattedShort, getDayParts, differenceYears, futureDate } from './date';
+import { createDate, prepareDate, isPreparedDate, getFormattedShort, getDayParts, differenceYears, futureDate } from './date';
 import { Validate, Display } from './form';
 import { error, notify, success } from './notify';
 import { getAllowed, getLanguages, getPayments } from './options';
@@ -17,6 +17,7 @@ export {
   success,
   createDate,
   prepareDate,
+  isPreparedDate,
   getFormattedShort,
   getDayParts,
   differenceYears,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autobusal/utilities",
-  "version": "1.5.4",
+  "version": "1.5.5",
   "author": "Ferjolt Ozuni",
   "type": "module",
   "main": "index.ts",