@autobusal/providers 1.43.9 → 1.44.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autobusal/providers",
-  "version": "1.43.9",
+  "version": "1.44.0",
   "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/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
@@ -30,6 +32,19 @@ export interface SettingsData {
   // been - Meta then falls back to the homepage hero as it always did.
   share_image?: string | null
 
+  // Claude - 2026-09-12: the mobile app's launch artwork (1080x2400 WebP,
+  // uploaded on the admin's Visual tab), or null when the brand has not
+  // set one - the app then shows the artwork compiled into it. The web
+  // frontend does not render this; it travels here because the app reads
+  // 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