@autobusal/providers 1.21.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).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autobusal/providers",
-  "version": "1.21.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'> {