@tekkare/romulus 0.1.106 → 0.1.108

package/dist/module.json

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

@@ -46,6 +46,14 @@ const props = withDefaults(
     /** Nombre d'elements que la vue tient a l'ecran, s'il est connu. */
     scopeCount?: number | null
     submitting?: boolean
+    /**
+     * `edit` prefixe le formulaire avec une alerte existante et retire le
+     * choix de la vue : changer de vue voudrait dire recapturer une requete,
+     * ce qui n'est possible que depuis la page. On en cree une autre.
+     */
+    mode?: 'create' | 'edit'
+    /** Alerte a modifier, en mode `edit`. */
+    initial?: Partial<RmAlertDraft>
     lang?: 'fr' | 'en'
   }>(),
   {
@@ -54,6 +62,8 @@ const props = withDefaults(
     fields: () => [],
     scopeCount: null,
     submitting: false,
+    mode: 'create',
+    initial: undefined,
     lang: 'fr',
   },
 )
@@ -102,6 +112,8 @@ const FR = {
   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',
+  save: 'Enregistrer',
+  reseed: 'Changer les champs suivis repart d’une nouvelle référence : vous ne serez prévenu que de ce qui bouge ensuite.',
   cancel: 'Annuler',
   baseline:
     'À la création, la référence est capturée sans rien signaler : vous ne serez prévenu que de ce qui bouge ensuite.',
@@ -141,6 +153,8 @@ const EN = {
   cadenceHint:
     'A cap, not a rhythm: nothing goes out when nothing moved, and detection follows the data.',
   submit: 'Create the alert',
+  save: 'Save',
+  reseed: 'Changing the watched fields restarts from a new baseline: you are only told about what moves afterwards.',
   cancel: 'Cancel',
   baseline:
     'On creation the baseline is captured silently: you are only told about what moves afterwards.',
@@ -165,16 +179,23 @@ const selectedView = computed(
   () => viewOptions.value.find((option) => option.id === selectedViewId.value) ?? viewOptions.value[0],
 )
 
-const title = ref(props.viewTitle)
-const triggers = ref<RmAlertTrigger[]>(['appeared'])
-const watchedFields = ref<string[]>([])
+const editing = computed(() => props.mode === 'edit')
+
+const title = ref(props.initial?.title ?? props.viewTitle)
+const triggers = ref<RmAlertTrigger[]>(props.initial?.triggers ?? ['appeared'])
+const watchedFields = ref<string[]>(
+  (props.initial?.watchedFields ?? []).filter((field) => field !== RM_ALERT_ANY_FIELD),
+)
 /** Surveiller le document entier plutot qu'une liste de champs. */
-const anyField = ref(false)
-const emailOn = ref(false)
-const cadence = ref<RmAlertCadence>('weekly')
+const anyField = ref(!!props.initial?.watchedFields?.includes(RM_ALERT_ANY_FIELD))
+const emailOn = ref(!!props.initial?.channels?.includes('email'))
+const cadence = ref<RmAlertCadence>(props.initial?.cadence ?? 'weekly')
+
+/** Champs suivis au chargement, pour dire quand la reference va repartir. */
+const initialFields = JSON.stringify([...(props.initial?.watchedFields ?? [])].sort())
 
 /** Titre libre des que l'utilisateur y touche : on ne l'ecrase plus. */
-const titleTouched = ref(false)
+const titleTouched = ref(props.mode === 'edit')
 
 watch(
   () => props.viewTitle,
@@ -235,6 +256,21 @@ const valid = computed(
   () => title.value.trim().length > 0 && triggers.value.length > 0 && !missingFields.value,
 )
 
+/**
+ * Les champs suivis ont bouge depuis l'ouverture.
+ *
+ * C'est le seul changement qui fait repartir l'alerte d'une nouvelle
+ * reference cote API : le hachage ne couvre plus les memes valeurs.
+ */
+const fieldsChanged = computed(() => {
+  const next = anyField.value
+    ? [RM_ALERT_ANY_FIELD]
+    : watchesChanges.value
+      ? watchedFields.value
+      : []
+  return JSON.stringify([...next].sort()) !== initialFields
+})
+
 function submit() {
   if (!valid.value) return
   emit('submit', {
@@ -268,7 +304,7 @@ function submit() {
       "
     />
 
-    <div class="rm-alert-form__view">
+    <div v-if="!editing" class="rm-alert-form__view">
       <p class="rm-alert-form__label">{{ T.view }}</p>
       <p class="rm-alert-form__hint">
         <!-- L'avertissement sur l'application ne vaut que pour une vue deja
@@ -297,6 +333,11 @@ function submit() {
       <p v-if="!selectedViewId" class="rm-alert-form__hint">{{ T.screenNote }}</p>
     </div>
 
+    <p v-else class="rm-alert-form__view-name">
+      <RmIcon name="BookmarkSimple" :size="14" />
+      {{ T.view }} : {{ viewTitle }}
+    </p>
+
     <fieldset class="rm-alert-form__group">
       <legend class="rm-alert-form__label">{{ T.triggers }}</legend>
       <p class="rm-alert-form__hint">{{ T.triggersHint }}</p>
@@ -352,9 +393,12 @@ function submit() {
       </div>
     </fieldset>
 
-    <p class="rm-alert-form__baseline">
+    <p
+      v-if="!editing || fieldsChanged"
+      class="rm-alert-form__baseline"
+    >
       <RmIcon name="Info" :size="14" />
-      {{ T.baseline }}
+      {{ editing ? T.reseed : T.baseline }}
     </p>
 
     <div class="rm-alert-form__actions">
@@ -365,7 +409,7 @@ function submit() {
         :disabled="!valid || submitting"
         :loading="submitting"
       >
-        {{ T.submit }}
+        {{ editing ? T.save : T.submit }}
       </RmButton>
     </div>
   </form>

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.106",
+  "version": "0.1.108",
   "description": "Romulus Design System - Nuxt module by Tekkare",
   "license": "MIT",
   "type": "module",