@autobusal/providers 1.43.10 → 1.44.1

package/package.json

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

package/types/promotions.ts

@@ -0,0 +1,71 @@
+/**
+ * Promotions - the strip under the mobile app's search form.
+ *
+ * Claude - 2026-09-12. Two shapes, because the admin and the app want
+ * different things: the ADMIN edits every locale at once (`Record<string,
+ * string>`), while the app is sent one language, already resolved.
+ */
+
+/** One locale map, e.g. `{ en: "Summer sale", it: "Saldi estivi" }`. */
+export type LocalizedField = Record<string, string>;
+
+/** A row in the admin's list. */
+export interface PromotionRowData {
+    id: number;
+    /** the English title, or empty when the promotion is only a picture */
+    title: string;
+    link: string | null;
+    image_url: string | null;
+    /** d/m/Y, or null for "from now" / "until I say" */
+    starts_at: string | null;
+    ends_at: string | null;
+    position: number;
+    enabled: boolean;
+    /** switched on AND inside its dates today - what the phone would show now */
+    live: boolean;
+}
+
+/** One promotion as the form edits it. */
+export interface PromotionData {
+    id: number;
+    title: LocalizedField;
+    text: LocalizedField;
+    cta: LocalizedField;
+    link: string | null;
+    image_url: string | null;
+    starts_at: string | null;
+    ends_at: string | null;
+    position: number;
+    enabled: boolean;
+}
+
+/**
+ * What the form posts. The localized fields travel as ONE JSON-encoded
+ * object each - never bracket-notation array fields, which the brands' BFF
+ * proxy turns into the literal string "Array".
+ */
+export interface PromotionSaveData {
+    title: string;
+    text: string;
+    cta: string;
+    link: string;
+    starts_at: string;
+    ends_at: string;
+    position: string;
+    enabled: string;
+    image?: File;
+    image_remove?: string;
+}
+
+/**
+ * What the PUBLIC settings payload carries: already narrowed to the
+ * promotions live today, already in the reader's language.
+ */
+export interface PublicPromotion {
+    id: number;
+    image_url: string | null;
+    link: string | null;
+    title: string;
+    text: string;
+    cta: string;
+}

package/types/routes.ts

@@ -148,6 +148,24 @@ export interface FoundData extends Omit<RouteData, 'locations' | 'id'> {
   // must read "missing" as unknown, never as direct.
   stops_count?: number
 
+  /**
+   * How many seats are still on sale on this departure.
+   *
+   * Edited: Claude - Date: 2026-09-16
+   *
+   * NOT `trip.available_seats`, which is the coach's CAPACITY - the search
+   * subtracts what every brand has sold and what the operator holds back
+   * before deciding whether to offer the departure at all, and this is that
+   * answer (Routes\Search\Buses::removeOccupied). Reading the capacity
+   * instead announced 49 free seats on a coach with 49 sold, which is the
+   * one number on a result card nobody would think to doubt.
+   *
+   * Optional: an external-provider offer has no seat count of ours, and an
+   * older API does not send this at all - in both cases the card shows
+   * nothing rather than guessing.
+   */
+  seats_left?: number
+
   /**
    * Claude - 2026-08-29 (audit A3-02h)
    *

package/types/settings.ts

@@ -1,3 +1,5 @@
+import { PublicPromotion } from './promotions';
+
 export interface SettingsData {
   // Edited: Ferjolt Ozuni - Date: 2026-08-03
   // The earliest bookable date as the SERVER reckons it, d/m/Y. The date
@@ -37,6 +39,12 @@ export interface SettingsData {
   // the same public settings payload.
   launch_artwork?: string | null
 
+  // Claude - 2026-09-12: the promotions under the app's search form, already
+  // narrowed to the ones live today and resolved to this request's language.
+  // Always present, possibly empty - an empty list means "fall back to the
+  // single `banner` below", which is how an older app build keeps working.
+  promotions?: PublicPromotion[]
+
   // Edited: Ferjolt Ozuni - Date: 2026-08-01
   // Present ONLY while the brand is under construction - obtapi omits it
   // entirely on a live site, so its presence is the switch itself and there