@autobusal/utilities 1.6.0 → 1.7.0

package/date.tsx

@@ -102,4 +102,41 @@ export const futureDate = (days: number): string => {
   dayAfter.setDate(today.getDate() + days);
 
   return prepareDate(dayAfter);
-};
+};
+/**
+ * A prepared d/m/Y date as the API's own Y-m-d.
+ *
+ * Claude - 2026-11-03. The calendar fields post d/m/Y, which the endpoints
+ * built for them validate with date_format:d/m/Y; the ones that take a plain
+ * `date` (a recorded payout, a settlement) read "31/12/2026" the American
+ * way and refuse it. Convert at the edge; anything that is not a prepared
+ * date is passed through untouched.
+ */
+export const isoDate = (prepared?: string | null): string => {
+  if (!isPreparedDate(prepared)) {
+    return prepared ?? '';
+  }
+
+  const [ day, month, year ] = String(prepared).split('/');
+
+  return `${ year }-${ month }-${ day }`;
+};
+
+/**
+ * The other direction: a date input's yyyy-mm-dd as the d/m/Y most obtapi
+ * list filters parse (Carbon::createFromFormat('d/m/Y')).
+ *
+ * Claude - 2026-11-04 (dashboard simplification, wave 7). The shared Filters
+ * toolbar writes native date inputs (yyyy-mm-dd) into the URL; the invoice
+ * and API-log endpoints still read d/m/Y. Anything that is not yyyy-mm-dd -
+ * an old d/m/Y bookmark, an empty value - passes through untouched.
+ */
+export const dmyDate = (value?: string | null): string => {
+  const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value ?? '');
+
+  if (match === null) {
+    return value ?? '';
+  }
+
+  return `${ match[3] }/${ match[2] }/${ match[1] }`;
+};

package/form.tsx

@@ -94,4 +94,4 @@ export const Display = (err: (FieldError | Merge<FieldError, FieldErrorsImpl<any
       { err.message as string }
     </Error>
   );
-}
+}

package/index.ts

@@ -1,5 +1,6 @@
-import { createDate, prepareDate, isPreparedDate, getFormattedShort, getDayParts, differenceYears, futureDate } from './date';
+import { createDate, prepareDate, isPreparedDate, isoDate, dmyDate, getFormattedShort, getDayParts, differenceYears, futureDate } from './date';
 import { Validate, Display } from './form';
+import { serverErrors } from './serverErrors';
 import { error, notify, success } from './notify';
 import { getAllowed, getLanguages, getPayments } from './options';
 import { getSex, getOptionsSex } from './passengers';
@@ -12,12 +13,15 @@ export {
   sanitizeHtml,
   Validate,
   Display,
+  serverErrors,
   error,
   notify,
   success,
   createDate,
   prepareDate,
   isPreparedDate,
+  isoDate,
+  dmyDate,
   getFormattedShort,
   getDayParts,
   differenceYears,

package/package.json

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

package/serverErrors.ts

@@ -0,0 +1,27 @@
+/**
+ * The field errors of a failed save, keyed by field.
+ *
+ * Claude - 2026-11-03 (dashboard simplification, wave 0). Laravel answers a
+ * rejected form with 422 and `{ message, errors: { field: [text] } }`; the
+ * API client toasts the message and the fields stayed silent, so the admin
+ * had to guess which of forty inputs the server meant. Pure: an Axios error
+ * in, a flat map out (the first message per field - one is enough under an
+ * input), an empty map for anything that is not a 422. Viewer takes it as
+ * `errors` and puts each message under its own field.
+ *
+ * A nested Laravel key (title.en) is passed through unchanged -
+ * react-hook-form resolves dotted names itself.
+ */
+export const serverErrors = (error: unknown): Record<string, string> => {
+  const response = (error as { response?: { status?: number, data?: { errors?: Record<string, string[] | string> } } } | null | undefined)?.response;
+
+  if (response === undefined || response.status !== 422 || response.data?.errors === undefined || response.data.errors === null) {
+    return {};
+  }
+
+  return Object.fromEntries(
+    Object.entries(response.data.errors)
+      .map(([ field, messages ]) => [ field, Array.isArray(messages) ? String(messages[0] ?? '') : String(messages) ])
+      .filter(([ , message ]) => message !== '')
+  );
+};