Ajoute l’analytics Kauri à mon site monsaas.com.

Avant toute modification, cherche « k.js » et « data-site » dans le projet : si la balise Kauri est déjà présente, ne l’ajoute pas une seconde fois.

1. Ajoute la balise sur toutes les pages :
   - Vite ou HTML statique : dans le <head> d’index.html, juste avant </head> :
     <script defer src="https://kauridata.app/k.js" data-site="ks_TA_CLE_DE_SITE"></script>
   - Next.js (App Router) : dans app/layout.tsx, ajoute
     import Script from "next/script";
     puis, dans <body>, après {children} :
     <Script src="https://kauridata.app/k.js" data-site="ks_TA_CLE_DE_SITE" {...(process.env.NODE_ENV === "development" && { "data-debug": "" })} strategy="afterInteractive" />
   Pour passer du local à la production sans modifier le code, lis l’origine de Kauri (https://kauridata.app) dans une variable d’environnement (NEXT_PUBLIC_KAURI_URL ou VITE_KAURI_URL) au lieu de l’écrire en dur dans src :
--- a/index.html
+++ b/index.html
@@ <head> @@
-    <script defer src="<origine de Kauri>/k.js" …></script>
+    <script defer src="%VITE_KAURI_URL%/k.js" …></script>
--- a/app/layout.tsx
+++ b/app/layout.tsx
@@ <body> @@
-        <Script src="<origine de Kauri>/k.js" … />
+        <Script src={`${process.env.NEXT_PUBLIC_KAURI_URL}/k.js`} … />
   Sans ces variables, l’app se comporte comme avant.

2. Pour que mes visites de développement arrivent (la balise ignore localhost sinon), ajoute l’attribut data-debug en développement seulement, jamais en production, et jamais d’après l’URL de Kauri :
   - Next.js : c’est la partie {...(process.env.NODE_ENV === "development" && { "data-debug": "" })} de la balise ci-dessus.
   - Vite : ajoute l’attribut data-debug uniquement quand le serveur de développement tourne (pas au build), par exemple avec ce plugin :
--- a/vite.config.ts
+++ b/vite.config.ts
@@ plugins @@
+  {
+    name: "kauri-debug",
+    transformIndexHtml: (html, ctx) =>
+      ctx.server ? html.replace(/<script\b(?=[^>]*\bdata-site=)/, "<script data-debug") : html,
+  },

3. Si le projet a une CSP (en-tête ou balise Content-Security-Policy), ajoute https://kauridata.app à script-src (chargement de k.js) et à connect-src (envoi des pages vues), seulement quand l’origine de Kauri est configurée :
--- a/<fichier de la CSP>
+++ b/<fichier de la CSP>
@@ Content-Security-Policy @@
-  script-src 'self';
-  connect-src 'self';
+  script-src 'self' https://kauridata.app;
+  connect-src 'self' https://kauridata.app;
   Sans CSP, n’en crée pas.

4. Là où le widget de paiement est ouvert, passe l’identifiant visiteur dans le champ de référence (partnerId pour KkiaPay) :
     partnerId: window.kauri?.visitorId?.() ?? ""
   Si partnerId sert déjà à autre chose (identifiant de commande, par exemple), ne le modifie pas : mes abonnements payés doivent continuer d’être livrés. Passe à l’étape 5.

5. Chemin de secours, seulement si partnerId est déjà pris : attribue le paiement par l’API d’attribution de Kauri.
   - À la création de commande, envoie l’identifiant visiteur (window.kauri?.visitorId?.() ?? null) avec la commande. Côté serveur, ne le stocke que s’il respecte /^kv_[0-9A-Za-z]{22}$/, sinon null. Un identifiant absent ou invalide ne doit jamais faire échouer la création de la commande :
--- a/<code client qui crée la commande>
+++ b/<code client qui crée la commande>
@@ corps de la requête @@
+  visitorId: window.kauri?.visitorId?.() ?? null,
--- a/<route de création de commande>
+++ b/<route de création de commande>
@@ création de commande @@
+  const kauriVisitorId = /^kv_[0-9A-Za-z]{22}$/.test(body.visitorId) ? body.visitorId : null;
   await db.order.create({ data: { ...order,
+    kauriVisitorId,
   } });
   - Dans le webhook de paiement, après la vérification de signature (inchangée), appelle POST https://kauridata.app/api/v1/attribution avec l’en-tête authorization: Bearer <KAURI_SITE_SECRET> et le corps { visitorId, transactionId }. Appel non bloquant (after() ou équivalent), AbortSignal.timeout(3000), erreurs avalées et journalisées sans le secret. Un paiement échoué est attribué lui aussi, mais réponds 200 sans livrer : le webhook ne doit pas traiter l’échec comme une livraison, pour qu’un client qui réessaie soit encore activé :
--- a/<route du webhook de paiement>
+++ b/<route du webhook de paiement>
@@ après la vérification de signature @@
+  if (process.env.KAURI_URL && process.env.KAURI_SITE_SECRET && order?.kauriVisitorId) {
+    after(() =>
+      fetch(`${process.env.KAURI_URL}/api/v1/attribution`, {
+        method: "POST",
+        headers: { "content-type": "application/json", authorization: `Bearer ${process.env.KAURI_SITE_SECRET}` },
+        body: JSON.stringify({ visitorId: order.kauriVisitorId, transactionId }),
+        signal: AbortSignal.timeout(3000),
+      }).catch((e) => console.error("kauri attribution", e?.name)),
+    );
+  }
+  if (paiementEchoue) return new Response(null, { status: 200 }); // attribué, mais sans livrer
   await fulfillOrder(order);
   - Variables : KAURI_URL=https://kauridata.app, KAURI_SITE_ID=<demande-le-moi : je le copie depuis Kauri, Réglages > Agrégateur de paiement>, et KAURI_SITE_SECRET (secret serveur du site, côté serveur uniquement : jamais dans une variable NEXT_PUBLIC_ ou VITE_, jamais journalisé). Tu ne connais pas le secret : demande-moi KAURI_SITE_SECRET ; je le copie depuis Kauri (Réglages > Agrégateur de paiement) et je le mets moi-même dans le .env, sans le coller dans cette conversation. Sans ces variables, l’app se comporte comme avant.

6. Tester un paiement en local : KkiaPay ne peut pas joindre localhost. Expose ton serveur local par un tunnel (ngrok, cloudflared) pour recevoir le webhook de KkiaPay, puis fais-le suivre à Kauri en mode relais (relaie le corps brut avec l’en-tête x-kkiapay-secret) : voir « Ton webhook KkiaPay est déjà utilisé par ton serveur ? » à l’étape 3 de l’installation Kauri.

7. Ne modifie rien d’autre. Montre-moi le diff avant d’appliquer.

8. Après le déploiement, vérifie : ouvre https://monsaas.com puis exécute window.kauri.visitorId() dans la console du navigateur. Il doit renvoyer un identifiant qui commence par kv_ (null en local sans l’attribut data-debug).