@autobusal/providers 1.24.0 → 1.27.0

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 1.27.0
+
+### Added
+
+- `LabelSettings.sms` (BulkGate: status, credentials, sender) and
+  `SettingsData.addons.sms` — the paid per-order confirmation. Both optional,
+  so an older payload cannot crash a checkout.
+## 1.26.0
+
+### Added
+
+- `FoundData.arrival_offset` — whole days between boarding and arriving, for
+  the overnight marker on result cards. Optional: external-provider offers do
+  not report one, and a missing value must read as same-day rather than
+  invent a day.
+
+## 1.25.0
+
+### Added
+
+- `LabelSettings.whatsapp.alert_template_name` / `alert_template_language` —
+  the separate approved template the route+date broadcast composer sends
+  through. Optional: a brand can confirm purchases over WhatsApp without ever
+  broadcasting, and Meta approves a template for a stated purpose, so service
+  alerts cannot reuse the confirmation one.
+
 ## 1.24.0
 
 **New `Setup/commerce.ts` — the booking funnel, pushed to the dataLayer.**

package/package.json

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

package/types/routes.ts

@@ -146,6 +146,19 @@ export interface FoundData extends Omit<RouteData, 'locations' | 'id'> {
   // another timezone, and "leaves in 20 minutes" must not be wrong.
   departs_in?: number | null
 
+  /**
+   * Edited: Ferjolt Ozuni - Date: 2026-08-05
+   * Whole days between boarding and arriving - 0 for a trip that arrives the
+   * same day, 1 for one arriving the next morning. Counted server-side from
+   * the timetable's own midnight markers, never guessed from the two clock
+   * times: a coach leaving 23:00 and arriving 07:00 is indistinguishable
+   * from one running backwards unless the timetable says which.
+   *
+   * Optional because external-provider offers do not report one; the card
+   * must read a missing value as same-day rather than invent a day.
+   */
+  arrival_offset?: number
+
   // The operator's subscription priority, as obtapi already sends it.
   // Used only as a tiebreak in the "recommended" ordering - see
   // routes-order's Found/refine.ts. Absent on external-provider offers.

package/types/settings.ts

@@ -40,6 +40,15 @@ export interface SettingsData {
   addons?: {
     whatsapp: { available: boolean, price: number }
     telegram: { available: boolean, price: number }
+
+    /**
+     * Edited: Ferjolt Ozuni - Date: 2026-08-05
+     * The paid per-order CONFIRMATION by SMS. Route alerts over SMS are
+     * free and reach every passenger who gave a phone number, so nothing
+     * gates them - this only answers whether a confirmation text may be
+     * bought. Optional so an older payload cannot crash the checkout.
+     */
+    sms?: { available: boolean, price: number }
   }
 
   // Edited: Ferjolt Ozuni - Date: 2026-07-31
@@ -217,9 +226,36 @@ export interface LabelSettings {
     access_token?: string
     template_name?: string
     template_language?: string
+
+    /**
+     * Edited: Ferjolt Ozuni - Date: 2026-08-05
+     * The separate approved template used by the route+date broadcast
+     * composer. Optional: a brand can confirm purchases without ever
+     * broadcasting, and Meta approves a template for a stated purpose, so
+     * service alerts cannot reuse the confirmation one.
+     */
+    alert_template_name?: string
+    alert_template_language?: string
     display_phone?: string
   }
 
+  /**
+   * Edited: Ferjolt Ozuni - Date: 2026-08-05
+   * BulkGate, for SMS. `status` is only ever 'disabled' or 'dedicated' -
+   * deliberately no 'main': the other channels let a whitelabel borrow the
+   * main brand's connection, and SMS costs money per message, so borrowing
+   * would mean one brand running up another's bill. `credit` is captured
+   * from a live check on save, not entered by hand.
+   */
+  sms?: {
+    status: 'disabled' | 'dedicated'
+    application_id?: string
+    application_token?: string
+    sender?: string
+    sender_value?: string
+    credit?: string
+  }
+
   // Edited: Ferjolt Ozuni - Date: 2026-07-29
   // Admin-managed footer social-share links (public preferences.social
   // above is populated from this) - distinct from `social` above, which