@lystech/core 3.0.120 → 3.0.122

package/bin/check-routes.cjs

@@ -0,0 +1,141 @@
+#!/usr/bin/env node
+
+/* =====================================================================
+   LES ROUTES DE BASE SONT-ELLES BRANCHÉES DANS CETTE APPLICATION ?
+
+   Le serveur écrit des adresses dans les courriels qu'il envoie — lien
+   d'activation d'un compte, lien de réinitialisation de mot de passe.
+   Il les construit sur le domaine de l'application CONCERNÉE, pour que
+   le client reste chez le commerçant plutôt que d'atterrir sur la
+   console d'administration.
+
+   Rien ne vérifiait que l'application savait les recevoir. Résultat vu
+   en production : un client s'inscrit, clique son lien, et tombe sur
+   une page ENTIÈREMENT BLANCHE — React Router ne trouve pas de route,
+   ne rend rien, ne dit rien. Six applications avaient le trou, et la
+   réinitialisation de mot de passe était morte partout sans que
+   personne l'ait signalé.
+
+   Ce script transforme la consigne en vérification. Il lit le code des
+   routes et dit ce qui manque.
+
+   Usage :   npx @lystech/core check-routes
+             npx @lystech/core check-routes --ci     (sort en erreur)
+   ===================================================================== */
+
+const fs = require("fs");
+const path = require("path");
+
+const CI = process.argv.includes("--ci");
+
+/* Les adresses que le serveur peut écrire dans un courriel, et ce qui
+   suffit pour les couvrir. `lystechAuthRoutes()` les couvre toutes. */
+const ATTENDU = [
+  {
+    nom: "Activation d'un compte",
+    /* DEUX FORMES, parce que le serveur en écrit deux. L'app Finance
+       reçoit `/activate?token=` sur son propre domaine ; toutes les
+       autres reçoivent `/account/activation/:token`. Exiger une seule
+       forme signalerait Finance à tort — et un vérificateur qui crie au
+       loup finit par ne plus être lu. */
+    motifs: [
+      /account\/activation\/:token/,
+      /lystechAuthRoutes/,
+      /path=["'`]\/activate["'`]/,
+    ],
+    pourquoi:
+      "un nouveau client clique le lien de son courriel d'inscription",
+  },
+  {
+    nom: "Réinitialisation de mot de passe",
+    motifs: [
+      /account\/reset-password\/:token/,
+      /lystechAuthRoutes/,
+      /path=["'`]\/reset["'`]/,
+    ],
+    pourquoi: "un client qui a oublié son mot de passe demande un lien",
+  },
+];
+
+const REPLI = {
+  nom: "Page de repli (route inconnue)",
+  motifs: [/path=["'`]\*["'`]/],
+  pourquoi:
+    "sans elle, une route manquante est une page blanche muette — c'est ce qui a caché le défaut pendant des mois",
+};
+
+function fichiersDeRoutes(racine) {
+  const dossier = path.join(racine, "src");
+  if (!fs.existsSync(dossier)) return [];
+  const trouves = [];
+  const visiter = (d, profondeur) => {
+    if (profondeur > 4) return;
+    for (const e of fs.readdirSync(d, { withFileTypes: true })) {
+      if (e.name === "node_modules" || e.name.startsWith(".")) continue;
+      const p = path.join(d, e.name);
+      if (e.isDirectory()) visiter(p, profondeur + 1);
+      else if (/\.(tsx|jsx)$/.test(e.name)) {
+        const texte = fs.readFileSync(p, "utf8");
+        /* On ne garde que les fichiers qui DÉCLARENT des routes : chercher
+           partout produirait des faux positifs sur de simples liens. */
+        if (texte.includes("<Routes") || texte.includes("<Route ")) {
+          trouves.push({ chemin: p, texte });
+        }
+      }
+    }
+  };
+  visiter(dossier, 0);
+  return trouves;
+}
+
+function main() {
+  const racine = process.cwd();
+  const nom = (() => {
+    try {
+      return JSON.parse(
+        fs.readFileSync(path.join(racine, "package.json"), "utf8"),
+      ).name;
+    } catch {
+      return path.basename(racine);
+    }
+  })();
+
+  const fichiers = fichiersDeRoutes(racine);
+  if (!fichiers.length) {
+    console.log(`\n  ${nom} : aucun fichier de routes trouvé — rien à vérifier.\n`);
+    return 0;
+  }
+
+  const tout = fichiers.map((f) => f.texte).join("\n");
+  const manquants = [];
+
+  console.log(`\n  ROUTES DE BASE — ${nom}`);
+  console.log(`  ${fichiers.length} fichier(s) de routes lu(s)\n`);
+
+  for (const cible of [...ATTENDU, REPLI]) {
+    const ok = cible.motifs.some((m) => m.test(tout));
+    console.log(`   ${ok ? "OK  " : "MANQUE"}  ${cible.nom}`);
+    if (!ok) {
+      console.log(`           ${cible.pourquoi}`);
+      manquants.push(cible);
+    }
+  }
+
+  if (!manquants.length) {
+    console.log("\n  Tout est branché.\n");
+    return 0;
+  }
+
+  console.log("\n  À AJOUTER dans le <Routes> de l'application :\n");
+  console.log('    import { lystechAuthRoutes, LystechNotFoundPage } from "@lystech/core";');
+  console.log("");
+  console.log("    <Routes>");
+  console.log("      {lystechAuthRoutes()}");
+  console.log("      ... vos routes ...");
+  console.log('      <Route path="*" element={<LystechNotFoundPage />} />');
+  console.log("    </Routes>\n");
+
+  return CI ? 1 : 0;
+}
+
+process.exit(main());

package/dist/index.d.ts

@@ -511,11 +511,21 @@ export declare function InstallPwaButton({ size, visible, forceVisible, text, kn
  */
 export declare function LoadingCircle(): JSX.Element;
 
+/** Les adresses que le serveur peut écrire dans un courriel. */
+export declare const LYSTECH_AUTH_ROUTE_PATHS: readonly ["/account/activation/:token", "/account/reset-password/:token"];
+
 export declare const LYSTECH_CORE_VERSION: any;
 
+export declare function lystechAuthRoutes(): JSX.Element[];
+
 declare function LystechCoreProvider({ children, organization, shouldRedirectAfterLogin, loginRedirectRoute, queryClient, usePushNotifications, useProgressiveWebAppFeatures, useThemeProvider, quickGoogleLoginButtonStyle, enableGoogleQuickLoginButton, showGoogleQuickLoginButton, useGoogleAutoSelect, debugMode, showAskPermissionsButtons, hideSupportButton, supportButtonVariant, onPackageUpdated, triggerOnFirstInstallPackageCallback, packageVersionStorageKey, }: Props): JSX.Element;
 export default LystechCoreProvider;
 
+export declare function LystechNotFoundPage({ homePath, homeLabel, }?: {
+    homePath?: string;
+    homeLabel?: string;
+}): JSX.Element;
+
 declare type MessageParams = {
     type: "error" | "success" | "warning";
     message: string;