@autobusal/providers 1.20.0 → 1.22.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 1.22.0
+
+**Flexible Ticket, and the `policies` rename.**
+
+- `PolicyData` is now `InformationData`, and its field `policies` is `information` — the route's free-text box is luggage, pets, boarding and ID, and never was cancellation terms. Calling it Policies invited operators to type terms into it that would then contradict the terms actually sold.
+- `RouteData.policies_en|sq` → `information_en|sq`.
+- `RouteData` gains `refund_hours` / `reschedule_hours`: the operator's own notice windows, in hours before departure. **Internal** — they reach the operator's route form and the admin, never a public payload. `null` means "not offered on this line", which is why they are nullable rather than 0.
+- New `FlexOffer`, the response of `GET /api/orders/flex`. Its hours are already resolved to the **stricter** leg of a return trip, so they are the numbers that will be enforced. Either may be null on its own — an operator who will reschedule but not refund is a real case.
+
 All notable changes to `@autobusal/providers` are documented here. This project
 adheres to [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
@@ -7,6 +16,12 @@ adheres to [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and
 > Note: 1.8.0 through 1.11.0 were published without changelog entries. The
 > gap is left as-is rather than reconstructed after the fact.
 
+## 1.21.0
+
+`SettingsData.today` — the earliest bookable date as the server reckons it,
+handed to the calendar at startup so the picker stops flooring on the buyer's
+device clock.
+
 ## 1.20.0
 
 `FoundData.departs_in` — minutes until departure, for same-day searches only,

package/Setup/Preload.tsx

@@ -1,4 +1,4 @@
-import { JsonLd } from '@autobusal/common';
+import { JsonLd, setServerToday } from '@autobusal/common';
 import { SettingsData } from '../types/settings';
 import { useSystemTheme } from '@autobusal/hooks';
 
@@ -15,6 +15,14 @@ interface Props {
 // fallback rendered above the router; a page's own <Meta title=...> renders
 // deeper in the tree and correctly overrides it once data loads.
 const Preload = ({ data, children }: Props): JSX.Element => {
+  // Edited: Ferjolt Ozuni - Date: 2026-08-03
+  // Hand the booking calendar the SERVER's idea of today, before anything
+  // renders one. Without it the picker floors on the buyer's device clock -
+  // so somebody in Shanghai on the 5th could not select the 4th for an
+  // Italian coach that had not left yet, on a date the server would have
+  // sold them quite happily.
+  setServerToday(data.today);
+
   // we arrange the font family names before inserting them
   const fontTitle = data.theme.fontFamily.title.replace(/ /g, '+');
   const fontContent = data.theme.fontFamily.content.replace(/ /g, '+');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autobusal/providers",
-  "version": "1.20.0",
+  "version": "1.22.0",
   "author": "Ferjolt Ozuni",
   "type": "module",
   "main": "index.ts"

package/types/routes.ts

@@ -31,8 +31,16 @@ export interface RouteData {
   language: string
   template: string
   searchable: number
-  policies_en: string
-  policies_sq: string
+  information_en: string
+  information_sq: string
+
+  // Edited: Ferjolt Ozuni - Date: 2026-08-03
+  // The operator's own notice windows, in hours before departure, for
+  // Flexible Ticket. INTERNAL - they reach the operator's own route form and
+  // the admin, never a public payload. `null` is "not offered on this line",
+  // which is why they are nullable rather than 0.
+  refund_hours: number | null
+  reschedule_hours: number | null
 }
 
 export interface AvailableData {
@@ -93,9 +101,27 @@ export interface FeatureData {
   image?: string[]
 }
 
-export interface PolicyData {
+export interface InformationData {
   id: number
-  policies: string
+  information: string
+}
+
+/**
+ * The Flexible Ticket offer for one booking (GET /api/orders/flex).
+ *
+ * Edited: Ferjolt Ozuni - Date: 2026-08-03
+ *
+ * The hours here are already resolved to the STRICTER leg of a return trip,
+ * so they are the numbers that will actually be enforced. Either may be null
+ * on its own: an operator who will reschedule but not refund is a real case,
+ * and the checkout has to be able to say so rather than imply both.
+ */
+export interface FlexOffer {
+  available: boolean
+  price?: number
+  price_display?: string
+  refund_hours?: number | null
+  reschedule_hours?: number | null
 }
 
 export interface FoundData extends Omit<RouteData, 'locations' | 'id'> {

package/types/settings.ts

@@ -1,4 +1,10 @@
 export interface SettingsData {
+  // Edited: Ferjolt Ozuni - Date: 2026-08-03
+  // The earliest bookable date as the SERVER reckons it, d/m/Y. The date
+  // picker floors on this rather than on the browser's clock, which is the
+  // buyer's clock and says nothing about where they are travelling.
+  today?: string
+
   url: string
 
   // Edited: Ferjolt Ozuni - Date: 2026-08-01