@tekkare/romulus 0.1.107 → 0.1.108

package/dist/module.json

@@ -4,7 +4,7 @@
   "compatibility": {
     "nuxt": ">=3.16.0"
   },
-  "version": "0.1.106",
+  "version": "0.1.107",
   "builder": {
     "@nuxt/module-builder": "0.8.4",
     "unbuild": "2.0.0"

package/dist/runtime/components/AlertCard.vue

@@ -75,6 +75,22 @@ const FR = {
       "La vue a changé sans que la requête de l'alerte suive. Ouvrez la page surveillée pour la réarmer.",
     failing: 'Le dernier passage a été refusé, la référence précédente est conservée.',
   },
+  refusal: {
+    too_broad: (n: string, max: string) =>
+      `Cette vue est trop large pour être surveillée : ${n} documents, alors qu’une alerte en suit ${max} au maximum. Resserrez le périmètre de la vue, sur une marque ou une molécule par exemple.`,
+    collapse: (n: string) =>
+      `Les résultats se sont effondrés (${n} documents restants) : c’est un incident sur les données, pas une nouvelle. Rien n’a été signalé, l’alerte reprendra au prochain passage sain.`,
+    growth: (n: string) =>
+      `Les résultats ont brutalement augmenté (${n} documents) : c’est un incident sur les données, pas une nouvelle. Rien n’a été signalé.`,
+    id_overlap: (n: string) =>
+      `Les documents suivis ne sont plus reconnus (${n} retrouvés) : la source a probablement été réindexée. Rien n’a été signalé pour éviter d’annoncer tout le périmètre comme nouveau.`,
+    field_sweep: (n: string) =>
+      `Un même champ a changé sur ${n} documents d’un coup : c’est une modification de la source, pas une actualité. Rien n’a été signalé.`,
+    shard_failure:
+      'La source n’a répondu que partiellement. Rien n’a été signalé : un résultat incomplet se lit comme une disparition générale.',
+    es_error:
+      'La source n’a pas répondu. Rien n’a été signalé, l’alerte réessaiera au prochain passage.',
+  },
   reseeded: 'La vue a changé, l’alerte est repartie d’une nouvelle référence le',
 }
 
@@ -112,19 +128,63 @@ const EN = {
       "The view changed and the alert's query did not follow. Open the watched page to re-arm it.",
     failing: 'The last run was refused; the previous baseline is kept.',
   },
+  refusal: {
+    too_broad: (n: string, max: string) =>
+      `This view is too wide to watch: ${n} documents, where an alert tracks at most ${max}. Narrow the view, to one brand or molecule for instance.`,
+    collapse: (n: string) =>
+      `Results collapsed (${n} documents left): that is a data incident, not news. Nothing was reported; the alert resumes on the next healthy run.`,
+    growth: (n: string) =>
+      `Results grew abruptly (${n} documents): that is a data incident, not news. Nothing was reported.`,
+    id_overlap: (n: string) =>
+      `The tracked documents are no longer recognised (${n} found again): the source was probably reindexed. Nothing was reported, to avoid announcing the whole scope as new.`,
+    field_sweep: (n: string) =>
+      `One field changed on ${n} documents at once: that is a change to the source, not news. Nothing was reported.`,
+    shard_failure:
+      'The source only answered partially. Nothing was reported: an incomplete result reads like a mass disappearance.',
+    es_error: 'The source did not answer. Nothing was reported; the alert will retry.',
+  },
   reseeded: 'The view changed, the alert restarted from a new baseline on',
 }
 
 const T = computed(() => (props.lang === 'en' ? EN : FR))
 
+/** Nombres ecrits comme on les lit : 19 751, pas 19751. */
+const number = (value: number) =>
+  new Intl.NumberFormat(props.lang === 'en' ? 'en-GB' : 'fr-FR').format(value)
+
+/**
+ * Pourquoi le dernier passage a ete refuse, dit en clair.
+ *
+ * Le moteur garde son message brut (il nomme des shards et des index) ; la
+ * carte, elle, part de la CAUSE et ecrit sa propre phrase. Faute de cause
+ * connue, le message brut reste, valant mieux que rien.
+ */
+const refusal = computed<string | null>(() => {
+  const kind = props.alert.lastErrorKind
+  if (!kind) return props.alert.lastError ?? null
+
+  const sentences = T.value.refusal as Record<string, any>
+  const sentence = sentences[kind]
+  if (!sentence) return props.alert.lastError ?? null
+  if (typeof sentence === 'string') return sentence
+
+  const count = number(props.alert.lastErrorCount ?? 0)
+  return kind === 'too_broad'
+    ? sentence(count, number(props.alert.maxTracked ?? 10000))
+    : sentence(count)
+})
+
 /** Les etats qui demandent une explication, pas seulement une pastille. */
 const notice = computed(() => {
   const status = props.alert.status
   if (status === 'active') return null
+  // Un refus explique se suffit : redoubler « le dernier passage a ete
+  // refuse » avec « cette vue est trop large » dit deux fois la meme chose.
+  const text = status === 'failing' && refusal.value ? refusal.value : T.value.notice[status]
   return {
     tone: status === 'stale' || status === 'failing' ? 'warn' : 'info',
-    text: T.value.notice[status],
-    detail: status === 'failing' ? props.alert.lastError : null,
+    text,
+    detail: null as string | null,
   }
 })
 

package/dist/runtime/utils/alerts.d.ts

@@ -37,8 +37,18 @@ export interface RmAlert {
     trackedCount?: number;
     /** Evenements pas encore lus. */
     unreadCount?: number;
-    /** Message du dernier passage refuse. */
+    /** Message brut du dernier passage refuse. Repli, quand la cause est inconnue. */
     lastError?: string | null;
+    /**
+     * Cause du refus, telle que le moteur la nomme. C'est elle qui choisit la
+     * phrase affichee : un message technique en anglais n'a rien a faire sous
+     * les yeux d'un utilisateur.
+     */
+    lastErrorKind?: string | null;
+    /** Chiffre sur lequel le refus porte (documents trouves, retrouves...). */
+    lastErrorCount?: number | null;
+    /** Plafond de documents qu'une alerte peut suivre. */
+    maxTracked?: number | null;
     lastRunAt?: string | null;
     /** Date de la derniere remise a zero de la reference, s'il y en a eu une. */
     reseededAt?: string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tekkare/romulus",
-  "version": "0.1.107",
+  "version": "0.1.108",
   "description": "Romulus Design System - Nuxt module by Tekkare",
   "license": "MIT",
   "type": "module",