@abyss-project/commons-front-core 7.0.0 → 8.0.0

package/README.md

@@ -25,6 +25,30 @@ pnpm add @abyss-project/commons-front-core
 
 Voir la [documentation produit](https://docs.abyss-project.fr/abyss-project) pour les guides d'utilisation, la configuration du Core, les exemples d'appel et la référence des permissions.
 
+## RUM
+
+Le RUM navigateur d'un front (SDK `@abyss-project/monitor-browser`, peer `^1.2.0`) se démarre par `AbyssRumProvider`, monté **sous** `AbyssCookieConsentProvider` et, quand le front en a un, sous `AuthProvider` :
+
+```tsx
+<AbyssErrorBoundary appName="abyss-cloud">
+  <AuthProvider client={authClient}>
+    <AbyssCookieConsentProvider consentVersion={COOKIE_CONSENT_VERSION} isAuthenticated={isAuthenticated}>
+      <AbyssRumProvider config={buildRumOptions()}>
+        <App />
+      </AbyssRumProvider>
+    </AbyssCookieConsentProvider>
+  </AuthProvider>
+</AbyssErrorBoundary>
+```
+
+- **`config` est requise** (raison de la majeure 8.0.0 : aucun front ne peut oublier son RUM). `config={null}` désactive le RUM explicitement : rien n'est installé. Elle reçoit les options de `AbyssRum.init` (`apiUrl`, `proxyUrl`, `applicationId`, `token`, `release`, `instrumentedOrigins`, `routeResolver`…), sauf `consent`, que le provider fournit.
+- **Une seule initialisation.** `AbyssRum.init` est appelé au premier commit avec une `config` non nulle, une fois, StrictMode compris. Une `config` qui change ensuite est **ignorée** : le SDK vit autant que la page.
+- **Consentement.** Le replay exige la catégorie analytics de `AbyssCookieConsentProvider`, relue à chaque décision du SDK : un consentement donné ou retiré après le démarrage est suivi. Sans provider de consentement, analytics vaut refusé.
+- **Acteur.** Sous `AuthProvider`, l'acteur de la session est l'id de l'utilisateur connecté, `null` à la déconnexion, inchangé pendant le chargement de la session. Sans `AuthProvider`, aucun acteur.
+- **`feedbackTicket`** (`intakeSlug`, `internalTicketSectionId`, `appName`, `sessionUrl(sessionId, offsetMs)`) : chaque retour utilisateur enregistré par Monitor devient un ticket Internal Tickets, par l'intake public d'abyss-console (`fileInternalTicketIntake`, peer `@abyss-project/console` `^12.4.0`, configuré par `AbyssConsoleCore.setConfig` du front). Titre `[<appName>] Retour utilisateur` ; description : le message, l'e-mail, la route et le lien vers la session. Le déclarant est l'e-mail saisi, sinon celui de l'utilisateur connecté ; un retour anonyme sans e-mail ne crée aucun ticket et reste dans Monitor. Un échec de création est journalisé (`console.warn`) et avalé.
+- **`onFeedbackSent`** : rappel du front, appelé pour chaque retour enregistré, après le ticket (créé, sauté ou en échec).
+- **Erreurs de rendu.** `AbyssErrorBoundary` envoie l'erreur qu'il attrape à `AbyssRum.captureError(error, { source: 'error-boundary' })` ; sans RUM démarré, l'appel ne fait rien.
+
 ## Support
 
 Pour toute demande, ouvrir un ticket depuis [l'application Abyss](https://app.abyss-project.fr/dashboard/account/tickets/create).

package/catalog/playwright.ci.config.ts

@@ -0,0 +1,29 @@
+import { dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+import { defineConfig } from '@playwright/test';
+import baseConfig from './playwright.config';
+import { catalogPort } from './catalog-port';
+
+// CI run of the catalog checks (`catalog:test:ci`, job `front-core-catalog`): the built catalog
+// (`catalog-dist/`, built by the script just before) served by `vite preview`, instead of the dev
+// server, which transforms every module on demand and makes a shared runner miss its timeouts.
+// Only the specs that carry criteria 15 and 16 run (responsive, mobile-shell): the captures are a
+// human review, produced locally by `catalog:test`, so neither their spec nor the teardown that
+// indexes them runs here.
+const port = catalogPort();
+const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+
+export default defineConfig({
+  ...baseConfig,
+  testIgnore: ['**/captures.spec.ts'],
+  globalTeardown: undefined,
+  workers: 4,
+  webServer: {
+    command: 'pnpm exec vite preview --config catalog/vite.config.ts',
+    cwd: packageRoot,
+    url: `http://127.0.0.1:${port}`,
+    reuseExistingServer: false,
+    timeout: 60_000,
+    env: { CATALOG_PORT: String(port) },
+  },
+});

package/catalog/vite.config.ts

@@ -3,7 +3,10 @@ import { defineConfig } from 'vite';
 import react from '@vitejs/plugin-react';
 import { catalogPort } from './catalog-port';
 
-// The catalog of the design system components: a dev server only, never built nor published.
+// The catalog of the design system components, never published. Served by the dev server
+// (`catalog`, `catalog:test`), or built into `catalog-dist/` and served by `vite preview` for the
+// CI run (`catalog:test:ci`): the dev server transforms every module on demand, too slow on a
+// shared runner.
 const port = catalogPort();
 
 const MAIN_CORE_SOURCE = resolve(__dirname, '../../abyss_main_core/src');
@@ -23,5 +26,7 @@ export default defineConfig({
     ],
   },
   optimizeDeps: { exclude: ['@abyss-project/main'] },
+  build: { outDir: resolve(__dirname, '../catalog-dist'), emptyOutDir: true },
   server: { port, strictPort: true, host: '127.0.0.1' },
+  preview: { port, strictPort: true, host: '127.0.0.1' },
 });