@tekkare/romulus 0.1.107 → 0.1.109

package/dist/module.json

@@ -4,7 +4,7 @@
   "compatibility": {
     "nuxt": ">=3.16.0"
   },
-  "version": "0.1.106",
+  "version": "0.1.108",
   "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/components/AlertForm.vue

@@ -54,6 +54,11 @@ const props = withDefaults(
     mode?: 'create' | 'edit'
     /** Alerte a modifier, en mode `edit`. */
     initial?: Partial<RmAlertDraft>
+    /**
+     * Le mode d'essai est ouvert cote API : la cadence courte apparait. Hors
+     * de la, elle n'existe pas a l'ecran.
+     */
+    testCadence?: boolean
     lang?: 'fr' | 'en'
   }>(),
   {
@@ -64,6 +69,7 @@ const props = withDefaults(
     submitting: false,
     mode: 'create',
     initial: undefined,
+    testCadence: false,
     lang: 'fr',
   },
 )
@@ -109,6 +115,7 @@ const FR = {
   daily: 'Quotidienne (un envoi par jour au plus)',
   weekly: 'Hebdomadaire (un envoi par semaine au plus)',
   monthly: 'Mensuelle (un envoi par mois au plus)',
+  test5: 'Toutes les 5 minutes (mode essai)',
   cadenceHint:
     'Un plafond, pas un rythme : rien ne part quand rien n’a bougé, et la détection suit celle des données.',
   submit: 'Créer l’alerte',
@@ -150,6 +157,7 @@ const EN = {
   daily: 'Daily (at most one a day)',
   weekly: 'Weekly (at most one a week)',
   monthly: 'Monthly (at most one a month)',
+  test5: 'Every 5 minutes (test mode)',
   cadenceHint:
     'A cap, not a rhythm: nothing goes out when nothing moved, and detection follows the data.',
   submit: 'Create the alert',
@@ -246,6 +254,9 @@ const cadenceOptions = computed(() => [
   { value: 'monthly' as const, label: T.value.monthly },
   { value: 'weekly' as const, label: T.value.weekly },
   { value: 'daily' as const, label: T.value.daily },
+  ...(props.testCadence
+    ? [{ value: 'test5' as const, label: T.value.test5 }]
+    : []),
 ])
 
 const cadenceLabel = computed(

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

@@ -6,8 +6,13 @@
  * importer un `.vue`. Meme raison que pour `utils/export.ts`.
  */
 export type RmAlertStatus = 'seeding' | 'active' | 'paused' | 'stale' | 'failing';
-/** Plafond d'envoi du mail, jamais une promesse de frequence. */
-export type RmAlertCadence = 'daily' | 'weekly' | 'monthly';
+/**
+ * Plafond d'envoi du mail, jamais une promesse de frequence.
+ *
+ * `test5` n'est pas un produit : c'est le mode d'essai (cinq minutes), qui
+ * n'apparait que si l'API dit l'avoir ouvert.
+ */
+export type RmAlertCadence = 'daily' | 'weekly' | 'monthly' | 'test5';
 /**
  * Surveiller le document entier plutot qu'une liste de champs. Les champs
  * d'ingestion (horodatage, date de collecte) restent exclus cote moteur,
@@ -37,8 +42,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.109",
   "description": "Romulus Design System - Nuxt module by Tekkare",
   "license": "MIT",
   "type": "module",