@dev.smartpricing/message-composer-layer 4.3.2-chat.0 → 4.4.1-next.0

package/app/queries/messageGroups.ts

@@ -1,4 +1,5 @@
 import { useQuery, useMutation, useQueryCache } from '@pinia/colada'
+import type { MaybeRefOrGetter } from 'vue'
 import type {
   DuplicateMessageGroupBody,
   MessageGroup,
@@ -9,6 +10,16 @@ import { messageGroupsApi } from '~/api'
 import type { ListMessageGroupsOptions } from '~/api/messageGroups'
 
 // QUERIES
+
+/**
+ * Colada merges `{ ...defaults, ...options }`, so forwarding `enabled: undefined`
+ * overrides its default `true` and silently disables the query: it then only
+ * runs on an explicit `refetch` (the library's 15 s poll, mutation invalidations).
+ * Forward `enabled` only when the caller set it.
+ */
+function enabledOption(enabled?: MaybeRefOrGetter<boolean>) {
+  return enabled === undefined ? {} : { enabled }
+}
 /**
  * One page of the server-side filtered list, in the Laravel envelope (ADR 0012).
  * The previous page stays as placeholder data while the next one loads, so
@@ -23,7 +34,7 @@ export function useMessageGroupListQuery(
     query: () => messageGroupsApi.list(toValue(options)),
     staleTime: 0,
     placeholderData: (previousData) => previousData,
-    enabled: queryOptions.enabled,
+    ...enabledOption(queryOptions.enabled),
   })
 }
 
@@ -35,7 +46,7 @@ export function useMessageGroupQuery(
     key: () => ['message-groups', toValue(id)],
     query: () => messageGroupsApi.getById(toValue(id)),
     staleTime: 2 * 60 * 1000,
-    enabled: queryOptions.enabled,
+    ...enabledOption(queryOptions.enabled),
   })
 }
 

package/app/types/tracking.ts

@@ -2,6 +2,9 @@ import type { MessageGroupProduct } from '@dev.smartpricing/message-composer-uti
 
 export type MessagesKind = 'email' | 'whatsapp'
 
+/** The step an operator was on when leaving the Message Send Flow. */
+export type MessageSendFlowStep = 'message' | 'parameters'
+
 export interface MessageActionProperties {
   message_name: string
   languages: string[]
@@ -164,4 +167,14 @@ export interface TrackingEventMap {
     to_recipients: number
     language: string
   }
+
+  // === Message Send Flow (spec #67) ===
+  'send_flow.confirm': {
+    message_name: string
+    message_category: string
+    language: string
+    parameters_count: number
+  }
+  'send_flow.cancel': { step: MessageSendFlowStep }
+  'send_flow.error': { code: string }
 }

package/app/utils/testIds.const.ts

@@ -761,3 +761,26 @@ export const messageGroupSelectTestIds = {
 
 /** @deprecated Use `messageGroupSelectTestIds` instead */
 export const templateSelectTestIds = messageGroupSelectTestIds
+
+export const messageSendFlowTestIds = {
+  root: 'message-send-flow-root',
+  stepper: 'message-send-flow-stepper',
+  alert: 'message-send-flow-alert',
+  picker: 'message-send-flow-picker',
+  languageGroup: 'message-send-flow-language-group',
+  parametersForm: 'message-send-flow-parameters-form',
+  /** One per visible key; the key is on `data-parameter`. */
+  parameterInput: 'message-send-flow-parameter-input',
+  noParameters: 'message-send-flow-no-parameters',
+  /** Right panel, present on every step, holding the channel preview. */
+  previewPanel: 'message-send-flow-preview-panel',
+  preview: 'message-send-flow-preview',
+  /** The compiled email of the Preview step (`render_type` email_v1). */
+  emailPreview: 'message-send-flow-email-preview',
+  /** The Cancel/Back/Next/Confirm bar, inline or teleported to `actionsTo`. */
+  actions: 'message-send-flow-actions',
+  back: 'message-send-flow-back',
+  next: 'message-send-flow-next',
+  cancel: 'message-send-flow-cancel',
+  confirm: 'message-send-flow-confirm',
+} as const

package/i18n/locales/de.ts

@@ -58,7 +58,9 @@ export default {
     messageGroupSelect: {
       inactive_tooltip:
         'Diese Nachrichtengruppe enthält nicht genehmigte oder fehlende Nachrichten',
+      not_sendable_tooltip: 'Diese Nachrichtengruppe enthält keine genehmigten Nachrichten',
       hide_inactive: 'Inaktive ausblenden',
+      hide_not_sendable: 'Nicht sendbare ausblenden',
       load_more: 'Mehr laden',
     },
     view_less: 'Weniger anzeigen',
@@ -854,6 +856,42 @@ export default {
       send_message: 'Nachricht senden',
     },
   },
+  send_flow: {
+    actions: {
+      back: 'Zurück',
+      cancel: 'Abbrechen',
+      confirm: 'Bestätigen',
+      next: 'Weiter',
+    },
+    errors: {
+      COMPILE_FAILED:
+        'Die Nachricht konnte nicht vorbereitet werden. Bitte versuchen Sie es erneut.',
+      MISSING_PARAMETERS: 'Füllen Sie alle Parameter aus, bevor Sie bestätigen.',
+      NOT_SENDABLE:
+        '„{name}“ hat keine genehmigte Nachricht und kann nicht gesendet werden. Wählen Sie eine andere Nachrichtengruppe.',
+      TEMPLATE_NOT_APPROVED:
+        'Diese Nachricht wurde von Meta nicht genehmigt und kann nicht gesendet werden.',
+      TEMPLATE_NOT_SUBMITTED:
+        'Diese Nachricht wurde nicht bei Meta eingereicht und kann nicht gesendet werden.',
+    },
+    language: {
+      approved: 'Genehmigt',
+      approved_count: 'Genehmigte Sprachen für {name}: {count}',
+      not_sendable: 'Nicht sendbar ({status})',
+    },
+    no_parameters: 'Diese Nachricht hat keine auszufüllenden Parameter.',
+    not_sendable_hint: 'Ausgegraute Nachrichtengruppen haben keine genehmigte Nachricht.',
+    questions: {
+      language: 'In welcher Sprache?',
+      message: 'Welche Nachricht möchten Sie senden?',
+      parameters: 'Parameter ausfüllen',
+      preview: 'Das erhält der Gast',
+    },
+    steps: {
+      message: { description: 'Sendbare Nachrichtengruppe auswählen', title: 'Nachricht' },
+      parameters: { description: 'Felder ausfüllen', title: 'Parameter' },
+    },
+  },
   status: {
     approved: 'Genehmigt',
     draft: 'Entwurf',

package/i18n/locales/en.ts

@@ -56,7 +56,9 @@ export default {
     translation_failed: 'Translation failed',
     messageGroupSelect: {
       inactive_tooltip: 'This message group has unapproved or missing messages',
+      not_sendable_tooltip: 'This message group has no approved messages',
       hide_inactive: 'Hide inactive',
+      hide_not_sendable: 'Hide not sendable',
       load_more: 'Load more',
     },
     view_less: 'View less',
@@ -843,6 +845,39 @@ export default {
       send_message: 'Send message',
     },
   },
+  send_flow: {
+    actions: {
+      back: 'Back',
+      cancel: 'Cancel',
+      confirm: 'Confirm',
+      next: 'Next',
+    },
+    errors: {
+      COMPILE_FAILED: 'The message could not be prepared. Please try again.',
+      MISSING_PARAMETERS: 'Fill in every parameter before confirming.',
+      NOT_SENDABLE:
+        '"{name}" has no approved message and cannot be sent. Pick another message group.',
+      TEMPLATE_NOT_APPROVED: 'This message has not been approved by Meta and cannot be sent.',
+      TEMPLATE_NOT_SUBMITTED: 'This message has not been submitted to Meta and cannot be sent.',
+    },
+    language: {
+      approved: 'Approved',
+      approved_count: 'Approved languages for {name}: {count}',
+      not_sendable: 'Not sendable ({status})',
+    },
+    no_parameters: 'This message has no parameters to fill in.',
+    not_sendable_hint: 'Greyed-out message groups have no approved message.',
+    questions: {
+      language: 'In which language?',
+      message: 'Which message do you want to send?',
+      parameters: 'Fill in the parameters',
+      preview: 'This is what the guest will receive',
+    },
+    steps: {
+      message: { description: 'Pick a sendable message group', title: 'Message' },
+      parameters: { description: 'Fill in the blanks', title: 'Parameters' },
+    },
+  },
   status: {
     approved: 'Approved',
     draft: 'Draft',

package/i18n/locales/es.ts

@@ -57,7 +57,9 @@ export default {
     translation_failed: 'La traducción ha fallado',
     messageGroupSelect: {
       inactive_tooltip: 'Este grupo de mensajes tiene mensajes no aprobados o faltantes',
+      not_sendable_tooltip: 'Este grupo de mensajes no tiene mensajes aprobados',
       hide_inactive: 'Ocultar inactivos',
+      hide_not_sendable: 'Ocultar no enviables',
       load_more: 'Cargar más',
     },
     view_less: 'Ver menos',
@@ -852,6 +854,40 @@ export default {
       send_message: 'Enviar mensaje',
     },
   },
+  send_flow: {
+    actions: {
+      back: 'Atrás',
+      cancel: 'Cancelar',
+      confirm: 'Confirmar',
+      next: 'Siguiente',
+    },
+    errors: {
+      COMPILE_FAILED: 'No se ha podido preparar el mensaje. Inténtelo de nuevo.',
+      MISSING_PARAMETERS: 'Rellene todos los parámetros antes de confirmar.',
+      NOT_SENDABLE:
+        '"{name}" no tiene ningún mensaje aprobado y no se puede enviar. Elija otro grupo de mensajes.',
+      TEMPLATE_NOT_APPROVED: 'Meta no ha aprobado este mensaje y no se puede enviar.',
+      TEMPLATE_NOT_SUBMITTED:
+        'Este mensaje no se ha enviado a Meta para su aprobación y no se puede enviar.',
+    },
+    language: {
+      approved: 'Aprobado',
+      approved_count: 'Idiomas aprobados para {name}: {count}',
+      not_sendable: 'No se puede enviar ({status})',
+    },
+    no_parameters: 'Este mensaje no tiene parámetros que rellenar.',
+    not_sendable_hint: 'Los grupos de mensajes en gris no tienen ningún mensaje aprobado.',
+    questions: {
+      language: '¿En qué idioma?',
+      message: '¿Qué mensaje quiere enviar?',
+      parameters: 'Rellenar los parámetros',
+      preview: 'Esto es lo que recibirá el huésped',
+    },
+    steps: {
+      message: { description: 'Elegir un grupo de mensajes que se pueda enviar', title: 'Mensaje' },
+      parameters: { description: 'Rellenar los campos', title: 'Parámetros' },
+    },
+  },
   status: {
     approved: 'Aprobado',
     draft: 'Borrador',

package/i18n/locales/fr.ts

@@ -57,7 +57,9 @@ export default {
     translation_failed: 'Échec de la traduction',
     messageGroupSelect: {
       inactive_tooltip: 'Ce groupe de messages contient des messages non approuvés ou manquants',
+      not_sendable_tooltip: 'Ce groupe de messages ne contient aucun message approuvé',
       hide_inactive: 'Masquer inactifs',
+      hide_not_sendable: 'Masquer non envoyables',
       load_more: 'Charger plus',
     },
     view_less: 'Afficher moins',
@@ -856,6 +858,39 @@ export default {
       send_message: 'Envoyer le message',
     },
   },
+  send_flow: {
+    actions: {
+      back: 'Retour',
+      cancel: 'Annuler',
+      confirm: 'Confirmer',
+      next: 'Suivant',
+    },
+    errors: {
+      COMPILE_FAILED: 'Le message n’a pas pu être préparé. Veuillez réessayer.',
+      MISSING_PARAMETERS: 'Renseignez tous les paramètres avant de confirmer.',
+      NOT_SENDABLE:
+        '« {name} » n’a aucun message approuvé et ne peut pas être envoyé. Choisissez un autre groupe de messages.',
+      TEMPLATE_NOT_APPROVED: 'Ce message n’a pas été approuvé par Meta et ne peut pas être envoyé.',
+      TEMPLATE_NOT_SUBMITTED: 'Ce message n’a pas été soumis à Meta et ne peut pas être envoyé.',
+    },
+    language: {
+      approved: 'Approuvé',
+      approved_count: 'Langues approuvées pour {name} : {count}',
+      not_sendable: 'Non envoyable ({status})',
+    },
+    no_parameters: 'Ce message n’a aucun paramètre à renseigner.',
+    not_sendable_hint: 'Les groupes de messages grisés n’ont aucun message approuvé.',
+    questions: {
+      language: 'Dans quelle langue ?',
+      message: 'Quel message voulez-vous envoyer ?',
+      parameters: 'Renseignez les paramètres',
+      preview: 'Voici ce que le client recevra',
+    },
+    steps: {
+      message: { description: 'Choisissez un groupe de messages envoyable', title: 'Message' },
+      parameters: { description: 'Remplissez les champs', title: 'Paramètres' },
+    },
+  },
   status: {
     approved: 'Approuvé',
     draft: 'Brouillon',

package/i18n/locales/it.ts

@@ -56,7 +56,9 @@ export default {
     translation_failed: 'Traduzione non riuscita',
     messageGroupSelect: {
       inactive_tooltip: 'Questo gruppo di messaggi contiene messaggi non approvati o mancanti',
+      not_sendable_tooltip: 'Questo gruppo di messaggi non contiene messaggi approvati',
       hide_inactive: 'Nascondi inattivi',
+      hide_not_sendable: 'Nascondi non inviabili',
       load_more: 'Carica altri',
     },
     view_less: 'Mostra meno',
@@ -849,6 +851,41 @@ export default {
       send_message: 'Invia messaggio',
     },
   },
+  send_flow: {
+    actions: {
+      back: 'Indietro',
+      cancel: 'Annulla',
+      confirm: 'Conferma',
+      next: 'Avanti',
+    },
+    errors: {
+      COMPILE_FAILED: 'Non è stato possibile preparare il messaggio. Riprova.',
+      MISSING_PARAMETERS: 'Compila tutti i parametri prima di confermare.',
+      NOT_SENDABLE:
+        '"{name}" non ha nessun messaggio approvato e non può essere inviato. Scegli un altro gruppo di messaggi.',
+      TEMPLATE_NOT_APPROVED:
+        'Questo messaggio non è stato approvato da Meta e non può essere inviato.',
+      TEMPLATE_NOT_SUBMITTED:
+        'Questo messaggio non è stato sottoposto a Meta e non può essere inviato.',
+    },
+    language: {
+      approved: 'Approvato',
+      approved_count: 'Lingue approvate per {name}: {count}',
+      not_sendable: 'Non inviabile ({status})',
+    },
+    no_parameters: 'Questo messaggio non ha parametri da compilare.',
+    not_sendable_hint: 'I gruppi di messaggi in grigio non hanno nessun messaggio approvato.',
+    questions: {
+      language: 'In quale lingua?',
+      message: 'Quale messaggio vuoi inviare?',
+      parameters: 'Compila i parametri',
+      preview: 'Ecco cosa riceverà l’ospite',
+    },
+    steps: {
+      message: { description: 'Scegli un gruppo di messaggi inviabile', title: 'Messaggio' },
+      parameters: { description: 'Compila i campi', title: 'Parametri' },
+    },
+  },
   status: {
     approved: 'Approvato',
     draft: 'Bozza',

package/nuxt.config.ts

@@ -1,9 +1,6 @@
 export default defineNuxtConfig({
   compatibilityDate: '2025-07-15',
   ssr: false,
-  experimental: {
-    viteEnvironmentApi: true,
-  },
   devtools: { enabled: true },
   imports: {
     dirs: ['stores', 'queries'],
@@ -57,9 +54,11 @@ export default defineNuxtConfig({
   runtimeConfig: {
     public: {
       COMPOSER_API_URL: '',
+      // BACKEND_BASE_URL, PLATFORM_URL and CSRF_COOKIE_NAME are declared by
+      // platform-layer (extended above); the host sets them once for both.
       BACKEND_BASE_URL: '',
       PLATFORM_URL: '',
-      ENV_CSRF_COOKIE_NAME: 'smt_csrf',
+      CSRF_COOKIE_NAME: '',
     },
   },
 })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dev.smartpricing/message-composer-layer",
-  "version": "4.3.2-chat.0",
+  "version": "4.4.1-next.0",
   "private": false,
   "type": "module",
   "main": "./nuxt.config.ts",
@@ -12,7 +12,6 @@
     "app.config.ts"
   ],
   "dependencies": {
-    "@dev.smartpricing/platform-layer": "^0.0.23",
     "@formkit/drag-and-drop": "^0.5.3",
     "@pinia/colada": "^1.3.0",
     "@tiptap/extension-character-count": "^3.23.4",
@@ -36,9 +35,10 @@
     "vue-router": "^5.0.7",
     "vue3-emoji-picker": "^1.1.8",
     "zod": "^4.4.3",
-    "@dev.smartpricing/message-composer-utils": "4.3.2-chat.0"
+    "@dev.smartpricing/message-composer-utils": "4.4.1-next.0"
   },
   "devDependencies": {
+    "@dev.smartpricing/platform-layer": "^0.0.23",
     "@nuxt/eslint": "^1.15.2",
     "@nuxt/test-utils": "^4.0.3",
     "@playwright/test": "^1.60.0",
@@ -48,6 +48,7 @@
     "vue-tsc": "^3.2.9"
   },
   "peerDependencies": {
+    "@dev.smartpricing/platform-layer": ">=0.0.20",
     "nuxt-ui-layer": ">=1.3.0"
   },
   "scripts": {