Cours Vibe coding avec Claude Code · Module 12: Clone de Medium

Applaudissements et surlignages : une limite côté serveur et /rewind

11 min de lecture
Dans cette leçon10

La chronique a ses premiers lecteurs. Ils veulent montrer à l'auteur que le texte leur a plu et surligner la phrase à laquelle ils reviendront après le quart. Dans cette leçon, tu ajoutes les deux : un bouton d'applaudissements et le surlignage de passages. Les deux fonctions ont l'air minces et ont chacune un piège qu'on ne voit pas au premier clic.

Ce que tu vas apprendre

  • exiger une limite côté serveur, pas seulement dans le bouton, et la vérifier avec la commande curl ;
  • lire un bouton qui monte tout de suite et revient en arrière quand le serveur refuse ;
  • compter la sélection depuis le début du bloc, et non depuis le morceau de texte où la souris a commencé ;
  • annuler un essai raté avec /rewind, au lieu d'ajouter un énième rustine.

Demande pour Claude Code : applaudissements

Dans notre clone, un lecteur peut applaudir jusqu'à 50 fois sous un même article. Le nombre est arbitraire, ce qui compte, c'est qui le surveille. Le bouton dans le navigateur n'est qu'une demande : n'importe qui peut envoyer une requête sans passer par la page, ne serait-ce qu'avec la commande curl. C'est pourquoi la règle est vérifiée par le serveur, comme la serrure de la leçon 8_3.

Demande pour Claude Code :

Ajoute les applaudissements sur la page d'article /articles/[id].
Un lecteur peut applaudir de 1 à 50 fois sous un même article. La
route POST /api/articles/[id]/clap enregistre un applaudissement et
rejette le 51e avec le code 409. Reconnais le lecteur par un cookie,
nous n'avons pas encore de connexion. Garde les données en mémoire
du serveur. Le bouton components/ClapButton.tsx monte le compteur
tout de suite, et quand le serveur refuse ou que le réseau échoue,
il le fait revenir et affiche un message.
Ce sera fini quand un test Vitest montre le retour du compteur après
une réponse 409, et qu'une boucle curl montre 409 au 51e applaudissement.

Le code 409, selon MDN, signifie un conflit entre la requête et l'état actuel de la ressource : le lecteur demande un applaudissement que l'état de l'article n'autorise plus.

Ce que Claude a écrit : la route avec sa limite

Ouvre lib/claps.ts dans Cursor. Le cœur de la limite tient en une fonction :

// lib/claps.ts
export function addClap(articleId: string, readerId: string): ClapResult | null {
  const { total, mine } = getClaps(articleId, readerId);
  if (mine >= MAX_CLAPS) return null;
  store.totals.set(articleId, total + 1);
  store.byReader.set(`${articleId}:${readerId}`, mine + 1);
  return { total: total + 1, mine: mine + 1 };
}

ClapResult est composé de deux nombres : les applaudissements de tous les lecteurs et ceux de ce lecteur seul. Le type et la constante MAX_CLAPS se trouvent dans un fichier à part, lib/clapRules.ts, car le bouton les importe aussi. null signifie "limite épuisée", et store est fait de deux tables en mémoire du serveur. Ouvre maintenant la route :

// app/api/articles/[id]/clap/route.ts
export async function POST(_request: Request, { params }: { params: Promise<{ id: string }> }) {
  const { id } = await params;
  if (!getArticle(id)) {
    return Response.json({ error: "Cet article n'existe pas" }, { status: 404 });
  }
  const readerId = await getOrCreateReaderId();
  const result = addClap(id, readerId);
  if (!result) {
    return Response.json({ error: `Limite de ${MAX_CLAPS} applaudissements`, ...getClaps(id, readerId) }, { status: 409 });
  }
  return Response.json(result);
}

Dans Next.js 16, params est une promesse, donc la première ligne est await params, comme dans la documentation des Route Handlers. getOrCreateReaderId, de lib/reader.ts, lit le cookie reader avec await cookies(), et quand il n'existe pas, en pose un nouveau avec un identifiant de crypto.randomUUID(). La documentation de Next.js autorise justement à poser des cookies dans les Route Handlers et les Server Functions. Garde en tête que le cookie distingue des navigateurs, pas des personnes : qui le supprime applaudit à nouveau. Un vrai lecteur, seule la connexion le donnera, comme dans la leçon 8_5.

Ce que Claude a écrit : un bouton qui sait reculer

Ouvre components/ClapButton.tsx. Le clic monte le compteur avant que le serveur réponde. C'est une mise à jour optimiste : tu supposes le succès pour que le bouton réagisse tout de suite, et tu ranges derrière toi quand il n'y a pas eu de succès :

// components/ClapButton.tsx
async function clap() {
  if (limitReached) return;
  setError("");
  setClaps((c) => ({ total: c.total + 1, mine: c.mine + 1 }));
  const ok = await fetch(`/api/articles/${articleId}/clap`, { method: "POST" })
    .then((res) => res.ok)
    .catch(() => false);
  if (!ok) {
    setClaps((c) => ({ total: c.total - 1, mine: c.mine - 1 }));
    setError("L'applaudissement n'est pas arrivé au serveur. Le compteur est revenu.");
  }
}

limitReached vaut claps.mine >= MAX_CLAPS, et la même condition désactive le bouton par disabled. Les lignes décisives sont celles avec then et catch. MDN le dit sans détour : la promesse de fetch() n'est rejetée que sur une erreur réseau ou une mauvaise adresse, et une réponse avec un code d'erreur arrive comme un succès ordinaire, donc il faut vérifier Response.ok. La version de l'agent n'avait que .catch(...) avec le retour en arrière. Chez nous, elle a passé lint et tsc, et le test avec une réponse 409 a échoué avec le message Unable to find role="alert" : le compteur était monté et le message n'était jamais apparu.

Épreuve : le 51e applaudissement

Un bouton désactivé après 50 clics ne prouve encore rien, car personne d'autre que lui ne questionne le serveur. Demande à Claude une boucle qui applaudit 51 fois avec un seul cookie, et lance-la avec npm run dev en marche :

for i in $(seq 1 51); do echo "$i $(curl -s -w ' %{http_code}' -X POST -c jar.txt -b jar.txt localhost:3000/api/articles/a3/clap)"; done | tail -3

Les options -c et -b enregistrent le cookie dans le fichier jar.txt et le renvoient à chaque requête, donc le serveur voit un seul lecteur, et tail -3 garde les trois dernières lignes. Chez nous, ça a donné :

49 {"total":94,"mine":49} 200
50 {"total":95,"mine":50} 200
51 {"error":"Limite de 50 applaudissements","total":95,"mine":50} 409

L'article partait de 45 applaudissements issus des données d'exemple, d'où 95. Le nombre en fin de ligne est le code de la réponse : 50 fois 200 et une fois 409.

Surlignages : une demande qui a dérapé

Un surlignage, ce sont deux nombres : où il commence et où il finit. La demande courte "Ajoute le surlignage du texte sélectionné, rends les surlignages avec <mark>" aboutit facilement à du code qui prend les nombres directement dans la sélection du navigateur : range.startOffset et range.endOffset. Le premier surlignage sort bien. Le deuxième, après le premier dans le même paragraphe, atterrit au mauvais endroit.

La cause, MDN la donne : startOffset compte les caractères depuis le début du nœud de texte où commence la sélection, pas depuis le début du paragraphe. Après le premier surlignage, le paragraphe est déjà trois nœuds : le texte avant <mark>, le texte dedans et le texte après. Dans le paragraphe "Léa voit la mer" avec "voit" surligné, le mot "mer" commence dans le troisième nœud à la position 4, et dans le texte du bloc à la position 12. Chez nous, le test a affiché expected { start: 4, end: 7 } to deeply equal { start: 12, end: 15 }.

/rewind au lieu d'une quatrième rustine

La tentation est d'écrire "corrige les offsets", puis "ça ne marche pas avec deux paragraphes", puis "maintenant le premier est cassé". Chaque rustine ajoute une exception à une mauvaise idée. Quand les corrections commencent à rafistoler les corrections précédentes, annule tout l'essai. Tape /rewind ou appuie deux fois sur Esc avec le champ vide, choisis la demande avec le surlignage et l'option "Restore code and conversation". Le code et la conversation reviennent à l'état d'avant cette demande, et son texte revient dans le champ, prêt à être corrigé. La limite de la leçon 0_6 reste : un fichier modifié uniquement par une commande du terminal, /rewind ne le suit pas, et pour revenir à l'état du dernier commit, tu passes par Git. La nouvelle demande nomme tout de suite le piège :

Ajoute le surlignage dans components/HighlightableArticle.tsx. Un
surlignage vit dans un seul bloc : start et end comptés depuis le
début du texte du bloc, pas depuis le nœud où commence la sélection.
Ignore la sélection sur plusieurs blocs et le surlignage qui en
chevauche un autre. Les fonctions dans lib/highlights.ts avec des
tests Vitest, y compris pour une sélection après un <mark> existant.

Ce que Claude a écrit : des nombres depuis le début du bloc

Ouvre lib/highlights.ts. TextRange est une paire start et end, et la fonction la compte depuis le début du bloc :

// lib/highlights.ts
export function offsetsInBlock(block: HTMLElement, range: Range): TextRange | null {
  if (!block.contains(range.startContainer) || !block.contains(range.endContainer)) return null;
  const before = document.createRange();
  before.selectNodeContents(block);
  before.setEnd(range.startContainer, range.startOffset);
  const start = before.toString().length;
  const end = start + range.toString().length;
  return end > start ? { start, end } : null;
}

La première ligne rejette une sélection qui sort du bloc. Ensuite naît une plage auxiliaire, du début du bloc au début de la sélection. selectNodeContents englobe tout le contenu du bloc, setEnd le raccourcit jusqu'à l'endroit où commence la sélection, et toString(), selon MDN, renvoie le texte de la plage. La longueur de ce texte est start, quel que soit le nombre de balises <mark> rencontrées en chemin. Le dessin découpe le texte en morceaux selon les surlignages :

// lib/highlights.ts
const sorted = [...highlights].sort((a, b) => a.start - b.start);

Les surlignages arrivent dans les props, et sort modifie le tableau sur place. La version highlights.sort(...) aurait réorganisé les données du parent pendant le rendu. Chez nous, elle a passé lint et tsc, et seul un test l'a attrapée (expected +0 to be 7). Les morceaux vont dans un <mark> ou un <span> avec la clé seg.start, c'est-à-dire la position du morceau dans le texte.

La revue du capitaine

  1. Limite à deux endroits. Cherche MAX_CLAPS dans le projet : il doit se trouver dans lib/claps.ts et dans le bouton. disabled seul n'est pas une serrure. L'erreur typique de l'agent est une limite uniquement dans le bouton, car la demande n'en parlait qu'en une phrase.
  2. res.ok. Le retour du compteur doit réagir au refus du serveur, pas seulement à un réseau coupé.
  3. await params. La route et la page lisent params avec await.
  4. Mémoire du serveur. Chez nous, de simples tables déclarées dans le module ne fonctionnaient pas : après trois applaudissements par curl, la page de l'article affichait toujours 120 et "Les tiens : 0/50", dans next dev comme dans next start. La route et la page recevaient des copies séparées du module, c'est pourquoi lib/claps.ts garde ses tables sur globalThis.
  5. Copie avant le tri. Cherche .sort( : devant chacun se trouve [....

Étape suivante

Quand les tests, la boucle curl et le navigateur sont d'accord, demande un commit "Applaudissements et surlignages". Puis les réponses des lecteurs sous l'article, avec un seul niveau d'imbrication, comme l'arbre de commentaires de la leçon 4_2. Ajoute à la demande le nom du type : ArticleResponse, pas Response. Le type intégré Response de l'API Fetch existe déjà, et un type à toi du même nom le masque. Chez nous, une route avec interface Response dans le même fichier n'a pas passé tsc : Type 'Response' is missing the following properties from type 'Response': id, parentId. Deux fois le même mot dans un message, c'est le signe que les noms se sont heurtés. Dans l'éditeur ci-dessous t'attend un article avec le bouton et le surlignage : bascule les versions de l'agent, applaudis près du "serveur qui refuse" et surligne un mot après un surlignage existant.

Retiens ceci : la cloche du pont sonne autant de fois que le permet le maître d'équipage, pas autant que quelqu'un tire sur la corde, et un bon équipage sait faire demi-tour avant de s'écraser sur le récif.

Code de cette leçon : App.jsx
// Applaudissements et surlignages en miniature : faux serveur avec limite et comptage depuis le début du bloc
import { useState } from 'react';

const MAX_CLAPS = 50;
const BLOCKS = [
  { id: 'b1', text: "La tempête est arrivée de nuit, et l'équipage dormait après un long quart." },
  { id: 'b2', text: "Nous avons ferlé les voiles avant que les vagues ne grossissent. Chacun savait où se tenir." },
];

// Faux serveur : une mémoire comme les tables sur globalThis dans le projet
const server = { total: 45, mine: 0 };

function fakeFetch(options) {
  return new Promise((resolve) => {
    setTimeout(() => {
      if (options.refuse) return resolve({ ok: false, status: 503 });
      if (!options.limitOnlyInButton && server.mine >= MAX_CLAPS) return resolve({ ok: false, status: 409 });
      server.total += 1;
      server.mine += 1;
      resolve({ ok: true, status: 200 });
    }, 300);
  });
}

// Correctif : on compte depuis le début du bloc grâce à une plage auxiliaire
function offsetsInBlock(block, range, agentBug) {
  if (!block.contains(range.startContainer) || !block.contains(range.endContainer)) return null;
  if (agentBug) return { start: range.startOffset, end: range.endOffset }; // compte depuis le nœud, pas depuis le bloc
  const before = document.createRange();
  before.selectNodeContents(block);
  before.setEnd(range.startContainer, range.startOffset);
  const start = before.toString().length;
  const end = start + range.toString().length;
  return end > start ? { start, end } : null;
}

function overlaps(a, b) {
  return a.start < b.end && b.start < a.end;
}

function splitText(text, highlights) {
  const sorted = [...highlights].sort((a, b) => a.start - b.start); // une copie, pas les props
  const segments = [];
  let pos = 0;
  for (const h of sorted) {
    if (h.start > pos) segments.push({ start: pos, text: text.slice(pos, h.start), highlighted: false });
    segments.push({ start: h.start, text: text.slice(h.start, h.end), highlighted: true });
    pos = h.end;
  }
  if (pos < text.length) segments.push({ start: pos, text: text.slice(pos), highlighted: false });
  return segments;
}

let nextId = 1;

export default function App() {
  const [claps, setClaps] = useState({ total: server.total, mine: server.mine });
  const [error, setError] = useState('');
  const [serverView, setServerView] = useState({ ...server });
  const [refuse, setRefuse] = useState(false);
  const [onlyCatch, setOnlyCatch] = useState(false);
  const [limitOnlyInButton, setLimitOnlyInButton] = useState(false);
  const [startOffsetBug, setStartOffsetBug] = useState(false);
  const [highlights, setHighlights] = useState([]);
  const [note, setNote] = useState('');

  async function clap() {
    if (claps.mine >= MAX_CLAPS) return;
    setError('');
    setClaps((c) => ({ total: c.total + 1, mine: c.mine + 1 }));
    const res = await fakeFetch({ refuse, limitOnlyInButton });
    setServerView({ ...server });
    // La version de l'agent avec .catch seul ne fait pas revenir le compteur quand le serveur répond par un code d'erreur
    if (!res.ok && !onlyCatch) {
      setClaps((c) => ({ total: c.total - 1, mine: c.mine - 1 }));
      setError("L'applaudissement n'est pas arrivé au serveur (" + res.status + "). Le compteur est revenu.");
    }
  }

  async function bypassButton() {
    const res = await fakeFetch({ refuse: false, limitOnlyInButton });
    setServerView({ ...server });
    setNote('Requête sans passer par le bouton : ' + res.status);
  }

  function skipTo49() {
    server.total += 49 - server.mine;
    server.mine = 49;
    setServerView({ ...server });
    setClaps({ total: server.total, mine: server.mine });
    setNote('Tu as déjà 49 applaudissements. Applaudis encore deux fois.');
  }

  function handleMouseUp() {
    const selection = window.getSelection();
    if (!selection || selection.isCollapsed) return;
    const range = selection.getRangeAt(0);
    const node = range.startContainer;
    const element = node.nodeType === 1 ? node : node.parentElement;
    const blockEl = element && element.closest('[data-block-id]');
    if (!blockEl) return;
    const offsets = offsetsInBlock(blockEl, range, startOffsetBug);
    if (!offsets) {
      setNote("La sélection dépasse un paragraphe : je l'ignore.");
      return;
    }
    const blockId = blockEl.dataset.blockId;
    if (highlights.some((h) => h.blockId === blockId && overlaps(h, offsets))) {
      setNote("La sélection chevauche un surlignage existant : je l'ignore.");
    } else {
      setHighlights((prev) => [...prev, { id: 'h' + nextId++, blockId, ...offsets }]);
      setNote('Surlignage : start ' + offsets.start + ', end ' + offsets.end + ' dans le bloc ' + blockId);
    }
    selection.removeAllRanges();
  }

  return (
    <div className="min-h-screen bg-gray-50 p-4 text-gray-900">
      <article onMouseUp={handleMouseUp} className="mx-auto max-w-xl space-y-3 rounded-xl bg-white p-4 shadow-sm">
        <h1 className="text-2xl font-bold">Comment survivre à une tempête en Atlantique</h1>
        {BLOCKS.map((block) => (
          <p key={block.id} data-block-id={block.id} className="leading-relaxed">
            {splitText(block.text, highlights.filter((h) => h.blockId === block.id)).map((seg) =>
              seg.highlighted ? (
                <mark key={seg.start} className="bg-yellow-200">{seg.text}</mark>
              ) : (
                <span key={seg.start}>{seg.text}</span>
              ),
            )}
          </p>
        ))}
        <div className="flex flex-wrap items-center gap-3">
          <button
            type="button"
            onClick={clap}
            disabled={claps.mine >= MAX_CLAPS}
            className="rounded-full border border-gray-400 px-4 py-2 font-semibold disabled:opacity-50"
          >
            Bravo
          </button>
          <span>{claps.total}</span>
          <span className="text-sm text-gray-500">Les tiens : {claps.mine}/{MAX_CLAPS}</span>
          {error && <span role="alert" className="text-sm text-red-700">{error}</span>}
        </div>
      </article>

      <div className="mx-auto mt-3 max-w-xl space-y-2 rounded-xl bg-gray-900 p-4 text-sm text-white">
        <p>Le serveur retient : au total <strong>{serverView.total}</strong>, les tiens <strong>{serverView.mine}</strong></p>
        <div className="flex flex-wrap gap-2">
          <button type="button" onClick={skipTo49} className="rounded bg-gray-700 px-3 py-1">
            Avancer à 49 applaudissements
          </button>
          <button type="button" onClick={bypassButton} className="rounded bg-gray-700 px-3 py-1">
            Envoyer un applaudissement sans passer par le bouton (comme curl)
          </button>
        </div>
        {note && <p className="text-amber-300">{note}</p>}
        <label className="flex items-center gap-2">
          <input type="checkbox" checked={refuse} onChange={(e) => setRefuse(e.target.checked)} />
          Le serveur refuse (code 503)
        </label>
        <label className="flex items-center gap-2">
          <input type="checkbox" checked={onlyCatch} onChange={(e) => setOnlyCatch(e.target.checked)} />
          Bug de l&apos;agent : .catch seul, sans vérifier res.ok
        </label>
        <label className="flex items-center gap-2">
          <input type="checkbox" checked={limitOnlyInButton} onChange={(e) => setLimitOnlyInButton(e.target.checked)} />
          Bug de l&apos;agent : limite seulement dans le bouton
        </label>
        <label className="flex items-center gap-2">
          <input type="checkbox" checked={startOffsetBug} onChange={(e) => setStartOffsetBug(e.target.checked)} />
          Bug de l&apos;agent : range.startOffset au lieu de compter depuis le début du bloc
        </label>
      </div>
    </div>
  );
}

Tu as repéré une erreur dans cette leçon ?

Teste tes connaissances

Réponds aux questions de cette leçon. Choisis une réponse pour voir tout de suite si elle est correcte.

  1. 1. Que signifie le fait que ClapButton monte le compteur d'applaudissements de façon optimiste ?

  2. 2. Où, dans Captain's Chronicle, la limite d'applaudissements d'un lecteur doit-elle être vérifiée ?

Voici 2 des 6 questions de cette leçon. Réponds aux autres dans le jeu.

Tâches pratiques dans le jeu

  • Tri horizontal

    Ordonne sur une seule ligne la lecture de l'identifiant de l'article dans une route Next.js 16 :

  • Clique dans l'ordre

    Clique sur les éléments pour construire le début du surlignage à partir de la plage auxiliaire before :

  • Éditeur de code

    Composant d'interaction d'applaudissement

  • Tri vertical

    Ordonne ce qui arrive au surlignage dans la version corrigée de la leçon :

  • Tri horizontal

    Ordonne sur une seule ligne le tri des surlignages sans modifier le tableau venu des props :

  • Éditeur de code

    Interface de commentaires

  • Tri vertical

    Ordonne l'annulation d'un essai raté avec les surlignages :

  • Clique dans l'ordre

    Clique sur les éléments pour construire la réponse de la route à un applaudissement au-delà de la limite :

  • Clique dans l'ordre

    Clique sur les éléments pour construire le retour du compteur après le refus du serveur :

  1. QuestionCompteur optimiste
  2. QuestionQui surveille la limite d'applaudissements
  3. Remets dans l'ordreLire params dans la route
  4. Clique dans l'ordreDébut du surlignage depuis le début du bloc
  5. Exercice de codePratique : Bouton d'applaudissement
  6. QuestionRéponse 409 et .catch seul
  7. Remets dans l'ordreLe surlignage pas à pas
  8. QuestionOffset compté depuis le nœud
  9. Remets dans l'ordreTrier une copie des surlignages
  10. Exercice de codePratique : section des réponses
  11. QuestionTroisième rustine des surlignages
  12. QuestionNom du type de réponse
  13. Remets dans l'ordreAnnuler avec /rewind
  14. Clique dans l'ordreRéponse 409 de la route
  15. Clique dans l'ordreRetour du compteur

Articles utiles