idoc-logs-react 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Philippe Boinnard
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,84 @@
+# idoc-logs-react
+
+Log client for the **IDOC.Logs** centralizing server: batched HTTPS shipping, global error capture, breadcrumbs, and React bindings.
+
+The browser counterpart of [IDOC.Logs.Nlog](https://www.nuget.org/packages/IDOC.Logs.Nlog) (the C#/NLog client). Entries are sent to the server's `POST /api/logs/client` endpoint, authenticated by a per-application API key.
+
+## Installation
+
+```
+npm install idoc-logs-react
+```
+
+## Quick start
+
+```ts
+// main.tsx — once, at startup
+import { initIdocLogs } from "idoc-logs-react";
+
+initIdocLogs({
+  url: "https://logs.example.com:5001",
+  apiKey: "<clé API générée dans l'admin du serveur>",
+  version: "1.4.0",
+});
+```
+
+That's it — unhandled errors (`window.onerror`) and unhandled promise rejections are now reported automatically, with breadcrumbs.
+
+### Logging manually
+
+```ts
+import { idocLogs } from "idoc-logs-react";
+
+idocLogs.info("Panier", "Commande validée");
+idocLogs.error("Panier", "Échec du paiement", err);
+```
+
+### React error boundary
+
+```tsx
+import { IdocLogsErrorBoundary } from "idoc-logs-react/react";
+
+<IdocLogsErrorBoundary fallback={(err, reset) => <ErreurPage onRetry={reset} />}>
+  <App />
+</IdocLogsErrorBoundary>
+```
+
+Render errors are reported as **Fatal** with the React component stack.
+
+```tsx
+import { useIdocLogger } from "idoc-logs-react/react";
+
+const logs = useIdocLogger();
+logs.warn("Profil", "Avatar introuvable, fallback utilisé");
+```
+
+## Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `url` | — | Base URL of the log server (e.g. `https://logs.example.com:5001`) |
+| `apiKey` | — | Per-application API key (generated in the server admin) |
+| `version` | `null` | Application version attached to each entry |
+| `niveauEnvoi` | `"Info"` | Minimum level actually sent. Lower levels only feed breadcrumbs. |
+| `captureGlobale` | `true` | Hook `window.onerror` / `unhandledrejection` |
+| `breadcrumbsMax` | `30` | Breadcrumb circular buffer size |
+| `flushIntervalleMs` | `5000` | Batch flush interval |
+| `flushMaxEntrees` | `20` | Batch size triggering an immediate flush |
+
+## Behaviour
+
+- **Batching** — entries are queued and flushed every 5 s or every 20 entries (50 max per request, the server limit).
+- **Page close** — pending entries are flushed with `fetch(keepalive: true)` on `pagehide`/`visibilitychange`, which unlike `sendBeacon` supports the `X-Api-Key` header.
+- **Failure** — if the server is unreachable or rejects the batch, entries are re-queued (bounded at 200) and a 30-second backoff applies. Logging never blocks nor throws — same philosophy as the NLog target.
+- **Breadcrumbs & context** — every log call (any level) feeds a circular buffer. `Error`/`Fatal` entries carry a `Contexte` JSON with the breadcrumbs, current URL, screen size and language. The server adds the source IP and User-Agent.
+- **Levels** — NLog names: `Trace`, `Debug`, `Info`, `Warn`, `Error`, `Fatal`.
+
+## Server-side setup
+
+1. Generate an API key for your application in the log server admin (Applications page).
+2. Add your web app's origin to `"CORS origines autorisées"` in the server's `Resources/configuration.json`.
+
+## License
+
+MIT

package/dist/chunk-TM735D27.js

@@ -0,0 +1,154 @@
+// src/breadcrumbs.ts
+var buffer = [];
+var taille = 30;
+function configurerBreadcrumbs(max) {
+  taille = max;
+  buffer = [];
+}
+function empiler(niveau, logger, message) {
+  if (buffer.length >= taille) buffer.shift();
+  buffer.push({ horodatage: /* @__PURE__ */ new Date(), niveau, logger, message });
+}
+function formatHeure(d) {
+  const p = (n, l = 2) => String(n).padStart(l, "0");
+  return `${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}.${p(d.getMilliseconds(), 3)}`;
+}
+function instantane() {
+  return buffer.map((b) => `${formatHeure(b.horodatage)} [${b.niveau}] ${b.logger} \u2014 ${b.message}`);
+}
+
+// src/transport.ts
+var FILE_MAX = 200;
+var url = "";
+var apiKey = "";
+var flushMaxEntrees = 20;
+var timer = null;
+var file = [];
+var envoiEnCours = false;
+var backoffJusqua = 0;
+function configurerTransport(options) {
+  url = options.url.replace(/\/+$/, "") + "/api/logs/client";
+  apiKey = options.apiKey;
+  flushMaxEntrees = options.flushMaxEntrees;
+  if (timer) clearInterval(timer);
+  timer = setInterval(() => void flush(), options.flushIntervalleMs);
+  if (typeof window !== "undefined") {
+    window.addEventListener("pagehide", () => void flush(true));
+    document.addEventListener("visibilitychange", () => {
+      if (document.visibilityState === "hidden") void flush(true);
+    });
+  }
+}
+function envoyer(entree) {
+  if (file.length >= FILE_MAX) file.shift();
+  file.push(entree);
+  if (file.length >= flushMaxEntrees) void flush();
+}
+async function flush(keepalive = false) {
+  if (envoiEnCours || file.length === 0 || !url) return;
+  if (Date.now() < backoffJusqua && !keepalive) return;
+  const lot = file.splice(0, 50);
+  envoiEnCours = true;
+  try {
+    const r\u00E9ponse = await fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Api-Key": apiKey },
+      body: JSON.stringify(lot),
+      keepalive
+    });
+    if (!r\u00E9ponse.ok && r\u00E9ponse.status !== 429) {
+      file = [...lot, ...file].slice(0, FILE_MAX);
+      backoffJusqua = Date.now() + 3e4;
+    }
+  } catch {
+    file = [...lot, ...file].slice(0, FILE_MAX);
+    backoffJusqua = Date.now() + 3e4;
+  } finally {
+    envoiEnCours = false;
+  }
+  if (file.length >= flushMaxEntrees && Date.now() >= backoffJusqua) void flush();
+}
+
+// src/types.ts
+var NIVEAUX = ["Trace", "Debug", "Info", "Warn", "Error", "Fatal"];
+function rangNiveau(niveau) {
+  return NIVEAUX.indexOf(niveau);
+}
+
+// src/core.ts
+var initialis\u00E9 = false;
+var version = null;
+var rangEnvoi = rangNiveau("Info");
+function initIdocLogs(options) {
+  version = options.version ?? null;
+  rangEnvoi = rangNiveau(options.niveauEnvoi ?? "Info");
+  configurerBreadcrumbs(options.breadcrumbsMax ?? 30);
+  configurerTransport({
+    url: options.url,
+    apiKey: options.apiKey,
+    flushIntervalleMs: options.flushIntervalleMs ?? 5e3,
+    flushMaxEntrees: options.flushMaxEntrees ?? 20
+  });
+  if (options.captureGlobale !== false) activerCaptureGlobale();
+  initialis\u00E9 = true;
+}
+function log(niveau, logger, message, exception) {
+  empiler(niveau, logger, message);
+  if (!initialis\u00E9 || rangNiveau(niveau) < rangEnvoi) return;
+  const estErreur = rangNiveau(niveau) >= rangNiveau("Error");
+  envoyer({
+    Horodatage: (/* @__PURE__ */ new Date()).toISOString(),
+    Niveau: niveau,
+    Logger: logger,
+    Message: message,
+    Exception: formaterException(exception),
+    Version: version,
+    Contexte: estErreur ? construireContexte() : null
+  });
+}
+function formaterException(exception) {
+  if (exception == null) return null;
+  if (exception instanceof Error)
+    return exception.stack ?? `${exception.name}: ${exception.message}`;
+  return String(exception);
+}
+function construireContexte() {
+  return JSON.stringify({
+    Breadcrumbs: instantane(),
+    Url: typeof location !== "undefined" ? location.href : null,
+    Ecran: typeof screen !== "undefined" ? `${screen.width}x${screen.height}` : null,
+    Langue: typeof navigator !== "undefined" ? navigator.language : null
+  });
+}
+var idocLogs = {
+  trace: (logger, message) => log("Trace", logger, message),
+  debug: (logger, message) => log("Debug", logger, message),
+  info: (logger, message) => log("Info", logger, message),
+  warn: (logger, message, exception) => log("Warn", logger, message, exception),
+  error: (logger, message, exception) => log("Error", logger, message, exception),
+  fatal: (logger, message, exception) => log("Fatal", logger, message, exception)
+};
+
+// src/capture.ts
+var activ\u00E9e = false;
+function activerCaptureGlobale() {
+  if (activ\u00E9e || typeof window === "undefined") return;
+  activ\u00E9e = true;
+  window.addEventListener("error", (event) => {
+    if (event.error == null && event.message === "") return;
+    log("Fatal", "window", event.message || "Erreur non g\xE9r\xE9e", event.error);
+  });
+  window.addEventListener("unhandledrejection", (event) => {
+    const raison = event.reason;
+    const message = raison instanceof Error ? raison.message : String(raison);
+    log("Error", "window", `Promesse rejet\xE9e non g\xE9r\xE9e : ${message}`, raison);
+  });
+}
+
+export {
+  activerCaptureGlobale,
+  initIdocLogs,
+  log,
+  idocLogs
+};
+//# sourceMappingURL=chunk-TM735D27.js.map

package/dist/chunk-TM735D27.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/breadcrumbs.ts","../src/transport.ts","../src/types.ts","../src/core.ts","../src/capture.ts"],"sourcesContent":["import type { Niveau } from \"./types\";\n\ninterface Breadcrumb {\n  horodatage: Date;\n  niveau: Niveau;\n  logger: string;\n  message: string;\n}\n\nlet buffer: Breadcrumb[] = [];\nlet taille = 30;\n\nexport function configurerBreadcrumbs(max: number): void {\n  taille = max;\n  buffer = [];\n}\n\nexport function empiler(niveau: Niveau, logger: string, message: string): void {\n  if (buffer.length >= taille) buffer.shift();\n  buffer.push({ horodatage: new Date(), niveau, logger, message });\n}\n\nfunction formatHeure(d: Date): string {\n  const p = (n: number, l = 2) => String(n).padStart(l, \"0\");\n  return `${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}.${p(d.getMilliseconds(), 3)}`;\n}\n\n/** Instantané du buffer, au format aligné sur la target NLog C#. */\nexport function instantane(): string[] {\n  return buffer.map(b => `${formatHeure(b.horodatage)} [${b.niveau}] ${b.logger} — ${b.message}`);\n}\n","import type { LogClientPayload } from \"./types\";\n\n// File d'attente bornée : au-delà, les entrées les plus anciennes sont abandonnées\n// (même philosophie que la target NLog : ne jamais bloquer ni faire gonfler la mémoire).\nconst FILE_MAX = 200;\n\nlet url = \"\";\nlet apiKey = \"\";\nlet flushMaxEntrees = 20;\nlet timer: ReturnType<typeof setInterval> | null = null;\nlet file: LogClientPayload[] = [];\nlet envoiEnCours = false;\nlet backoffJusqua = 0;\n\nexport function configurerTransport(options: {\n  url: string;\n  apiKey: string;\n  flushIntervalleMs: number;\n  flushMaxEntrees: number;\n}): void {\n  url = options.url.replace(/\\/+$/, \"\") + \"/api/logs/client\";\n  apiKey = options.apiKey;\n  flushMaxEntrees = options.flushMaxEntrees;\n\n  if (timer) clearInterval(timer);\n  timer = setInterval(() => void flush(), options.flushIntervalleMs);\n\n  if (typeof window !== \"undefined\") {\n    // fetch keepalive survit à la fermeture de la page (contrairement à un fetch\n    // classique) et, contrairement à sendBeacon, permet le header X-Api-Key.\n    window.addEventListener(\"pagehide\", () => void flush(true));\n    document.addEventListener(\"visibilitychange\", () => {\n      if (document.visibilityState === \"hidden\") void flush(true);\n    });\n  }\n}\n\nexport function envoyer(entree: LogClientPayload): void {\n  if (file.length >= FILE_MAX) file.shift();\n  file.push(entree);\n  if (file.length >= flushMaxEntrees) void flush();\n}\n\nasync function flush(keepalive = false): Promise<void> {\n  if (envoiEnCours || file.length === 0 || !url) return;\n  if (Date.now() < backoffJusqua && !keepalive) return;\n\n  // Lots de 50 max (limite serveur) ; keepalive limite le corps à ~64 Ko,\n  // on reste prudent avec un lot unique dans ce cas.\n  const lot = file.splice(0, 50);\n  envoiEnCours = true;\n  try {\n    const réponse = await fetch(url, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\", \"X-Api-Key\": apiKey },\n      body: JSON.stringify(lot),\n      keepalive,\n    });\n    if (!réponse.ok && réponse.status !== 429) {\n      // Clé invalide ou erreur serveur : on remet le lot, backoff 30 s.\n      file = [...lot, ...file].slice(0, FILE_MAX);\n      backoffJusqua = Date.now() + 30_000;\n    }\n  } catch {\n    // Serveur injoignable : abandon silencieux du réseau, backoff 30 s.\n    file = [...lot, ...file].slice(0, FILE_MAX);\n    backoffJusqua = Date.now() + 30_000;\n  } finally {\n    envoiEnCours = false;\n  }\n\n  if (file.length >= flushMaxEntrees && Date.now() >= backoffJusqua) void flush();\n}\n","/** Niveaux NLog, dans l'ordre croissant de sévérité. */\nexport type Niveau = \"Trace\" | \"Debug\" | \"Info\" | \"Warn\" | \"Error\" | \"Fatal\";\n\nexport const NIVEAUX: readonly Niveau[] = [\"Trace\", \"Debug\", \"Info\", \"Warn\", \"Error\", \"Fatal\"];\n\nexport function rangNiveau(niveau: Niveau): number {\n  return NIVEAUX.indexOf(niveau);\n}\n\n/** Entrée telle qu'attendue par POST /api/logs/client (PascalCase côté serveur). */\nexport interface LogClientPayload {\n  Horodatage: string;\n  Niveau: Niveau;\n  Logger: string;\n  Message: string;\n  Exception: string | null;\n  Version: string | null;\n  Contexte: string | null;\n}\n\nexport interface IdocLogsOptions {\n  /** URL de base du serveur de logs, ex. \"https://logs.example.com:5001\". */\n  url: string;\n  /** Clé API de l'application (générée dans l'admin du serveur de logs). */\n  apiKey: string;\n  /** Nom de l'application (informatif : le serveur impose celui associé à la clé). */\n  application?: string;\n  /** Version de l'application, jointe à chaque entrée. */\n  version?: string;\n  /** Niveau minimum réellement envoyé au serveur (défaut : \"Info\").\n   *  Les niveaux inférieurs alimentent uniquement les breadcrumbs. */\n  niveauEnvoi?: Niveau;\n  /** Brancher window.onerror / unhandledrejection (défaut : true). */\n  captureGlobale?: boolean;\n  /** Taille du buffer de breadcrumbs (défaut : 30). */\n  breadcrumbsMax?: number;\n  /** Intervalle de flush du lot en millisecondes (défaut : 5000). */\n  flushIntervalleMs?: number;\n  /** Taille de lot déclenchant un flush immédiat (défaut : 20). */\n  flushMaxEntrees?: number;\n}\n","import { configurerBreadcrumbs, empiler, instantane } from \"./breadcrumbs\";\nimport { configurerTransport, envoyer } from \"./transport\";\nimport { activerCaptureGlobale } from \"./capture\";\nimport { rangNiveau, type IdocLogsOptions, type Niveau } from \"./types\";\n\nlet initialisé = false;\nlet version: string | null = null;\nlet rangEnvoi = rangNiveau(\"Info\");\n\n/** Initialise le client. À appeler une fois au démarrage de l'application. */\nexport function initIdocLogs(options: IdocLogsOptions): void {\n  version = options.version ?? null;\n  rangEnvoi = rangNiveau(options.niveauEnvoi ?? \"Info\");\n\n  configurerBreadcrumbs(options.breadcrumbsMax ?? 30);\n  configurerTransport({\n    url: options.url,\n    apiKey: options.apiKey,\n    flushIntervalleMs: options.flushIntervalleMs ?? 5000,\n    flushMaxEntrees: options.flushMaxEntrees ?? 20,\n  });\n\n  if (options.captureGlobale !== false) activerCaptureGlobale();\n  initialisé = true;\n}\n\nexport function log(niveau: Niveau, logger: string, message: string, exception?: unknown): void {\n  empiler(niveau, logger, message);\n  if (!initialisé || rangNiveau(niveau) < rangEnvoi) return;\n\n  const estErreur = rangNiveau(niveau) >= rangNiveau(\"Error\");\n  envoyer({\n    Horodatage: new Date().toISOString(),\n    Niveau: niveau,\n    Logger: logger,\n    Message: message,\n    Exception: formaterException(exception),\n    Version: version,\n    Contexte: estErreur ? construireContexte() : null,\n  });\n}\n\nfunction formaterException(exception: unknown): string | null {\n  if (exception == null) return null;\n  if (exception instanceof Error)\n    return exception.stack ?? `${exception.name}: ${exception.message}`;\n  return String(exception);\n}\n\n/** Contexte joint aux erreurs : breadcrumbs et état de la page,\n *  l'équivalent navigateur du contexte process de la target NLog. */\nfunction construireContexte(): string {\n  return JSON.stringify({\n    Breadcrumbs: instantane(),\n    Url: typeof location !== \"undefined\" ? location.href : null,\n    Ecran: typeof screen !== \"undefined\" ? `${screen.width}x${screen.height}` : null,\n    Langue: typeof navigator !== \"undefined\" ? navigator.language : null,\n  });\n}\n\nexport const idocLogs = {\n  trace: (logger: string, message: string) => log(\"Trace\", logger, message),\n  debug: (logger: string, message: string) => log(\"Debug\", logger, message),\n  info: (logger: string, message: string) => log(\"Info\", logger, message),\n  warn: (logger: string, message: string, exception?: unknown) => log(\"Warn\", logger, message, exception),\n  error: (logger: string, message: string, exception?: unknown) => log(\"Error\", logger, message, exception),\n  fatal: (logger: string, message: string, exception?: unknown) => log(\"Fatal\", logger, message, exception),\n};\n","import { log } from \"./core\";\n\nlet activée = false;\n\n/** Branche la capture des erreurs non gérées du navigateur.\n *  Appelée automatiquement par initIdocLogs sauf captureGlobale: false. */\nexport function activerCaptureGlobale(): void {\n  if (activée || typeof window === \"undefined\") return;\n  activée = true;\n\n  window.addEventListener(\"error\", event => {\n    // Les erreurs de chargement de ressource (img, script…) n'ont pas de message d'erreur JS.\n    if (event.error == null && event.message === \"\" ) return;\n    log(\"Fatal\", \"window\", event.message || \"Erreur non gérée\", event.error);\n  });\n\n  window.addEventListener(\"unhandledrejection\", event => {\n    const raison = event.reason;\n    const message = raison instanceof Error ? raison.message : String(raison);\n    log(\"Error\", \"window\", `Promesse rejetée non gérée : ${message}`, raison);\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/core-xTdevcDU.d.cts

@@ -0,0 +1,47 @@
+/** Niveaux NLog, dans l'ordre croissant de sévérité. */
+type Niveau = "Trace" | "Debug" | "Info" | "Warn" | "Error" | "Fatal";
+/** Entrée telle qu'attendue par POST /api/logs/client (PascalCase côté serveur). */
+interface LogClientPayload {
+    Horodatage: string;
+    Niveau: Niveau;
+    Logger: string;
+    Message: string;
+    Exception: string | null;
+    Version: string | null;
+    Contexte: string | null;
+}
+interface IdocLogsOptions {
+    /** URL de base du serveur de logs, ex. "https://logs.example.com:5001". */
+    url: string;
+    /** Clé API de l'application (générée dans l'admin du serveur de logs). */
+    apiKey: string;
+    /** Nom de l'application (informatif : le serveur impose celui associé à la clé). */
+    application?: string;
+    /** Version de l'application, jointe à chaque entrée. */
+    version?: string;
+    /** Niveau minimum réellement envoyé au serveur (défaut : "Info").
+     *  Les niveaux inférieurs alimentent uniquement les breadcrumbs. */
+    niveauEnvoi?: Niveau;
+    /** Brancher window.onerror / unhandledrejection (défaut : true). */
+    captureGlobale?: boolean;
+    /** Taille du buffer de breadcrumbs (défaut : 30). */
+    breadcrumbsMax?: number;
+    /** Intervalle de flush du lot en millisecondes (défaut : 5000). */
+    flushIntervalleMs?: number;
+    /** Taille de lot déclenchant un flush immédiat (défaut : 20). */
+    flushMaxEntrees?: number;
+}
+
+/** Initialise le client. À appeler une fois au démarrage de l'application. */
+declare function initIdocLogs(options: IdocLogsOptions): void;
+declare function log(niveau: Niveau, logger: string, message: string, exception?: unknown): void;
+declare const idocLogs: {
+    trace: (logger: string, message: string) => void;
+    debug: (logger: string, message: string) => void;
+    info: (logger: string, message: string) => void;
+    warn: (logger: string, message: string, exception?: unknown) => void;
+    error: (logger: string, message: string, exception?: unknown) => void;
+    fatal: (logger: string, message: string, exception?: unknown) => void;
+};
+
+export { type IdocLogsOptions as I, type LogClientPayload as L, type Niveau as N, initIdocLogs as a, idocLogs as i, log as l };

package/dist/core-xTdevcDU.d.ts

@@ -0,0 +1,47 @@
+/** Niveaux NLog, dans l'ordre croissant de sévérité. */
+type Niveau = "Trace" | "Debug" | "Info" | "Warn" | "Error" | "Fatal";
+/** Entrée telle qu'attendue par POST /api/logs/client (PascalCase côté serveur). */
+interface LogClientPayload {
+    Horodatage: string;
+    Niveau: Niveau;
+    Logger: string;
+    Message: string;
+    Exception: string | null;
+    Version: string | null;
+    Contexte: string | null;
+}
+interface IdocLogsOptions {
+    /** URL de base du serveur de logs, ex. "https://logs.example.com:5001". */
+    url: string;
+    /** Clé API de l'application (générée dans l'admin du serveur de logs). */
+    apiKey: string;
+    /** Nom de l'application (informatif : le serveur impose celui associé à la clé). */
+    application?: string;
+    /** Version de l'application, jointe à chaque entrée. */
+    version?: string;
+    /** Niveau minimum réellement envoyé au serveur (défaut : "Info").
+     *  Les niveaux inférieurs alimentent uniquement les breadcrumbs. */
+    niveauEnvoi?: Niveau;
+    /** Brancher window.onerror / unhandledrejection (défaut : true). */
+    captureGlobale?: boolean;
+    /** Taille du buffer de breadcrumbs (défaut : 30). */
+    breadcrumbsMax?: number;
+    /** Intervalle de flush du lot en millisecondes (défaut : 5000). */
+    flushIntervalleMs?: number;
+    /** Taille de lot déclenchant un flush immédiat (défaut : 20). */
+    flushMaxEntrees?: number;
+}
+
+/** Initialise le client. À appeler une fois au démarrage de l'application. */
+declare function initIdocLogs(options: IdocLogsOptions): void;
+declare function log(niveau: Niveau, logger: string, message: string, exception?: unknown): void;
+declare const idocLogs: {
+    trace: (logger: string, message: string) => void;
+    debug: (logger: string, message: string) => void;
+    info: (logger: string, message: string) => void;
+    warn: (logger: string, message: string, exception?: unknown) => void;
+    error: (logger: string, message: string, exception?: unknown) => void;
+    fatal: (logger: string, message: string, exception?: unknown) => void;
+};
+
+export { type IdocLogsOptions as I, type LogClientPayload as L, type Niveau as N, initIdocLogs as a, idocLogs as i, log as l };

package/dist/index.cjs

@@ -0,0 +1,183 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  activerCaptureGlobale: () => activerCaptureGlobale,
+  idocLogs: () => idocLogs,
+  initIdocLogs: () => initIdocLogs,
+  log: () => log
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/breadcrumbs.ts
+var buffer = [];
+var taille = 30;
+function configurerBreadcrumbs(max) {
+  taille = max;
+  buffer = [];
+}
+function empiler(niveau, logger, message) {
+  if (buffer.length >= taille) buffer.shift();
+  buffer.push({ horodatage: /* @__PURE__ */ new Date(), niveau, logger, message });
+}
+function formatHeure(d) {
+  const p = (n, l = 2) => String(n).padStart(l, "0");
+  return `${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}.${p(d.getMilliseconds(), 3)}`;
+}
+function instantane() {
+  return buffer.map((b) => `${formatHeure(b.horodatage)} [${b.niveau}] ${b.logger} \u2014 ${b.message}`);
+}
+
+// src/transport.ts
+var FILE_MAX = 200;
+var url = "";
+var apiKey = "";
+var flushMaxEntrees = 20;
+var timer = null;
+var file = [];
+var envoiEnCours = false;
+var backoffJusqua = 0;
+function configurerTransport(options) {
+  url = options.url.replace(/\/+$/, "") + "/api/logs/client";
+  apiKey = options.apiKey;
+  flushMaxEntrees = options.flushMaxEntrees;
+  if (timer) clearInterval(timer);
+  timer = setInterval(() => void flush(), options.flushIntervalleMs);
+  if (typeof window !== "undefined") {
+    window.addEventListener("pagehide", () => void flush(true));
+    document.addEventListener("visibilitychange", () => {
+      if (document.visibilityState === "hidden") void flush(true);
+    });
+  }
+}
+function envoyer(entree) {
+  if (file.length >= FILE_MAX) file.shift();
+  file.push(entree);
+  if (file.length >= flushMaxEntrees) void flush();
+}
+async function flush(keepalive = false) {
+  if (envoiEnCours || file.length === 0 || !url) return;
+  if (Date.now() < backoffJusqua && !keepalive) return;
+  const lot = file.splice(0, 50);
+  envoiEnCours = true;
+  try {
+    const r\u00E9ponse = await fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Api-Key": apiKey },
+      body: JSON.stringify(lot),
+      keepalive
+    });
+    if (!r\u00E9ponse.ok && r\u00E9ponse.status !== 429) {
+      file = [...lot, ...file].slice(0, FILE_MAX);
+      backoffJusqua = Date.now() + 3e4;
+    }
+  } catch {
+    file = [...lot, ...file].slice(0, FILE_MAX);
+    backoffJusqua = Date.now() + 3e4;
+  } finally {
+    envoiEnCours = false;
+  }
+  if (file.length >= flushMaxEntrees && Date.now() >= backoffJusqua) void flush();
+}
+
+// src/capture.ts
+var activ\u00E9e = false;
+function activerCaptureGlobale() {
+  if (activ\u00E9e || typeof window === "undefined") return;
+  activ\u00E9e = true;
+  window.addEventListener("error", (event) => {
+    if (event.error == null && event.message === "") return;
+    log("Fatal", "window", event.message || "Erreur non g\xE9r\xE9e", event.error);
+  });
+  window.addEventListener("unhandledrejection", (event) => {
+    const raison = event.reason;
+    const message = raison instanceof Error ? raison.message : String(raison);
+    log("Error", "window", `Promesse rejet\xE9e non g\xE9r\xE9e : ${message}`, raison);
+  });
+}
+
+// src/types.ts
+var NIVEAUX = ["Trace", "Debug", "Info", "Warn", "Error", "Fatal"];
+function rangNiveau(niveau) {
+  return NIVEAUX.indexOf(niveau);
+}
+
+// src/core.ts
+var initialis\u00E9 = false;
+var version = null;
+var rangEnvoi = rangNiveau("Info");
+function initIdocLogs(options) {
+  version = options.version ?? null;
+  rangEnvoi = rangNiveau(options.niveauEnvoi ?? "Info");
+  configurerBreadcrumbs(options.breadcrumbsMax ?? 30);
+  configurerTransport({
+    url: options.url,
+    apiKey: options.apiKey,
+    flushIntervalleMs: options.flushIntervalleMs ?? 5e3,
+    flushMaxEntrees: options.flushMaxEntrees ?? 20
+  });
+  if (options.captureGlobale !== false) activerCaptureGlobale();
+  initialis\u00E9 = true;
+}
+function log(niveau, logger, message, exception) {
+  empiler(niveau, logger, message);
+  if (!initialis\u00E9 || rangNiveau(niveau) < rangEnvoi) return;
+  const estErreur = rangNiveau(niveau) >= rangNiveau("Error");
+  envoyer({
+    Horodatage: (/* @__PURE__ */ new Date()).toISOString(),
+    Niveau: niveau,
+    Logger: logger,
+    Message: message,
+    Exception: formaterException(exception),
+    Version: version,
+    Contexte: estErreur ? construireContexte() : null
+  });
+}
+function formaterException(exception) {
+  if (exception == null) return null;
+  if (exception instanceof Error)
+    return exception.stack ?? `${exception.name}: ${exception.message}`;
+  return String(exception);
+}
+function construireContexte() {
+  return JSON.stringify({
+    Breadcrumbs: instantane(),
+    Url: typeof location !== "undefined" ? location.href : null,
+    Ecran: typeof screen !== "undefined" ? `${screen.width}x${screen.height}` : null,
+    Langue: typeof navigator !== "undefined" ? navigator.language : null
+  });
+}
+var idocLogs = {
+  trace: (logger, message) => log("Trace", logger, message),
+  debug: (logger, message) => log("Debug", logger, message),
+  info: (logger, message) => log("Info", logger, message),
+  warn: (logger, message, exception) => log("Warn", logger, message, exception),
+  error: (logger, message, exception) => log("Error", logger, message, exception),
+  fatal: (logger, message, exception) => log("Fatal", logger, message, exception)
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  activerCaptureGlobale,
+  idocLogs,
+  initIdocLogs,
+  log
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/breadcrumbs.ts","../src/transport.ts","../src/capture.ts","../src/types.ts","../src/core.ts"],"sourcesContent":["export { initIdocLogs, idocLogs, log } from \"./core\";\nexport { activerCaptureGlobale } from \"./capture\";\nexport type { IdocLogsOptions, Niveau, LogClientPayload } from \"./types\";\n","import type { Niveau } from \"./types\";\n\ninterface Breadcrumb {\n  horodatage: Date;\n  niveau: Niveau;\n  logger: string;\n  message: string;\n}\n\nlet buffer: Breadcrumb[] = [];\nlet taille = 30;\n\nexport function configurerBreadcrumbs(max: number): void {\n  taille = max;\n  buffer = [];\n}\n\nexport function empiler(niveau: Niveau, logger: string, message: string): void {\n  if (buffer.length >= taille) buffer.shift();\n  buffer.push({ horodatage: new Date(), niveau, logger, message });\n}\n\nfunction formatHeure(d: Date): string {\n  const p = (n: number, l = 2) => String(n).padStart(l, \"0\");\n  return `${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}.${p(d.getMilliseconds(), 3)}`;\n}\n\n/** Instantané du buffer, au format aligné sur la target NLog C#. */\nexport function instantane(): string[] {\n  return buffer.map(b => `${formatHeure(b.horodatage)} [${b.niveau}] ${b.logger} — ${b.message}`);\n}\n","import type { LogClientPayload } from \"./types\";\n\n// File d'attente bornée : au-delà, les entrées les plus anciennes sont abandonnées\n// (même philosophie que la target NLog : ne jamais bloquer ni faire gonfler la mémoire).\nconst FILE_MAX = 200;\n\nlet url = \"\";\nlet apiKey = \"\";\nlet flushMaxEntrees = 20;\nlet timer: ReturnType<typeof setInterval> | null = null;\nlet file: LogClientPayload[] = [];\nlet envoiEnCours = false;\nlet backoffJusqua = 0;\n\nexport function configurerTransport(options: {\n  url: string;\n  apiKey: string;\n  flushIntervalleMs: number;\n  flushMaxEntrees: number;\n}): void {\n  url = options.url.replace(/\\/+$/, \"\") + \"/api/logs/client\";\n  apiKey = options.apiKey;\n  flushMaxEntrees = options.flushMaxEntrees;\n\n  if (timer) clearInterval(timer);\n  timer = setInterval(() => void flush(), options.flushIntervalleMs);\n\n  if (typeof window !== \"undefined\") {\n    // fetch keepalive survit à la fermeture de la page (contrairement à un fetch\n    // classique) et, contrairement à sendBeacon, permet le header X-Api-Key.\n    window.addEventListener(\"pagehide\", () => void flush(true));\n    document.addEventListener(\"visibilitychange\", () => {\n      if (document.visibilityState === \"hidden\") void flush(true);\n    });\n  }\n}\n\nexport function envoyer(entree: LogClientPayload): void {\n  if (file.length >= FILE_MAX) file.shift();\n  file.push(entree);\n  if (file.length >= flushMaxEntrees) void flush();\n}\n\nasync function flush(keepalive = false): Promise<void> {\n  if (envoiEnCours || file.length === 0 || !url) return;\n  if (Date.now() < backoffJusqua && !keepalive) return;\n\n  // Lots de 50 max (limite serveur) ; keepalive limite le corps à ~64 Ko,\n  // on reste prudent avec un lot unique dans ce cas.\n  const lot = file.splice(0, 50);\n  envoiEnCours = true;\n  try {\n    const réponse = await fetch(url, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\", \"X-Api-Key\": apiKey },\n      body: JSON.stringify(lot),\n      keepalive,\n    });\n    if (!réponse.ok && réponse.status !== 429) {\n      // Clé invalide ou erreur serveur : on remet le lot, backoff 30 s.\n      file = [...lot, ...file].slice(0, FILE_MAX);\n      backoffJusqua = Date.now() + 30_000;\n    }\n  } catch {\n    // Serveur injoignable : abandon silencieux du réseau, backoff 30 s.\n    file = [...lot, ...file].slice(0, FILE_MAX);\n    backoffJusqua = Date.now() + 30_000;\n  } finally {\n    envoiEnCours = false;\n  }\n\n  if (file.length >= flushMaxEntrees && Date.now() >= backoffJusqua) void flush();\n}\n","import { log } from \"./core\";\n\nlet activée = false;\n\n/** Branche la capture des erreurs non gérées du navigateur.\n *  Appelée automatiquement par initIdocLogs sauf captureGlobale: false. */\nexport function activerCaptureGlobale(): void {\n  if (activée || typeof window === \"undefined\") return;\n  activée = true;\n\n  window.addEventListener(\"error\", event => {\n    // Les erreurs de chargement de ressource (img, script…) n'ont pas de message d'erreur JS.\n    if (event.error == null && event.message === \"\" ) return;\n    log(\"Fatal\", \"window\", event.message || \"Erreur non gérée\", event.error);\n  });\n\n  window.addEventListener(\"unhandledrejection\", event => {\n    const raison = event.reason;\n    const message = raison instanceof Error ? raison.message : String(raison);\n    log(\"Error\", \"window\", `Promesse rejetée non gérée : ${message}`, raison);\n  });\n}\n","/** Niveaux NLog, dans l'ordre croissant de sévérité. */\nexport type Niveau = \"Trace\" | \"Debug\" | \"Info\" | \"Warn\" | \"Error\" | \"Fatal\";\n\nexport const NIVEAUX: readonly Niveau[] = [\"Trace\", \"Debug\", \"Info\", \"Warn\", \"Error\", \"Fatal\"];\n\nexport function rangNiveau(niveau: Niveau): number {\n  return NIVEAUX.indexOf(niveau);\n}\n\n/** Entrée telle qu'attendue par POST /api/logs/client (PascalCase côté serveur). */\nexport interface LogClientPayload {\n  Horodatage: string;\n  Niveau: Niveau;\n  Logger: string;\n  Message: string;\n  Exception: string | null;\n  Version: string | null;\n  Contexte: string | null;\n}\n\nexport interface IdocLogsOptions {\n  /** URL de base du serveur de logs, ex. \"https://logs.example.com:5001\". */\n  url: string;\n  /** Clé API de l'application (générée dans l'admin du serveur de logs). */\n  apiKey: string;\n  /** Nom de l'application (informatif : le serveur impose celui associé à la clé). */\n  application?: string;\n  /** Version de l'application, jointe à chaque entrée. */\n  version?: string;\n  /** Niveau minimum réellement envoyé au serveur (défaut : \"Info\").\n   *  Les niveaux inférieurs alimentent uniquement les breadcrumbs. */\n  niveauEnvoi?: Niveau;\n  /** Brancher window.onerror / unhandledrejection (défaut : true). */\n  captureGlobale?: boolean;\n  /** Taille du buffer de breadcrumbs (défaut : 30). */\n  breadcrumbsMax?: number;\n  /** Intervalle de flush du lot en millisecondes (défaut : 5000). */\n  flushIntervalleMs?: number;\n  /** Taille de lot déclenchant un flush immédiat (défaut : 20). */\n  flushMaxEntrees?: number;\n}\n","import { configurerBreadcrumbs, empiler, instantane } from \"./breadcrumbs\";\nimport { configurerTransport, envoyer } from \"./transport\";\nimport { activerCaptureGlobale } from \"./capture\";\nimport { rangNiveau, type IdocLogsOptions, type Niveau } from \"./types\";\n\nlet initialisé = false;\nlet version: string | null = null;\nlet rangEnvoi = rangNiveau(\"Info\");\n\n/** Initialise le client. À appeler une fois au démarrage de l'application. */\nexport function initIdocLogs(options: IdocLogsOptions): void {\n  version = options.version ?? null;\n  rangEnvoi = rangNiveau(options.niveauEnvoi ?? \"Info\");\n\n  configurerBreadcrumbs(options.breadcrumbsMax ?? 30);\n  configurerTransport({\n    url: options.url,\n    apiKey: options.apiKey,\n    flushIntervalleMs: options.flushIntervalleMs ?? 5000,\n    flushMaxEntrees: options.flushMaxEntrees ?? 20,\n  });\n\n  if (options.captureGlobale !== false) activerCaptureGlobale();\n  initialisé = true;\n}\n\nexport function log(niveau: Niveau, logger: string, message: string, exception?: unknown): void {\n  empiler(niveau, logger, message);\n  if (!initialisé || rangNiveau(niveau) < rangEnvoi) return;\n\n  const estErreur = rangNiveau(niveau) >= rangNiveau(\"Error\");\n  envoyer({\n    Horodatage: new Date().toISOString(),\n    Niveau: niveau,\n    Logger: logger,\n    Message: message,\n    Exception: formaterException(exception),\n    Version: version,\n    Contexte: estErreur ? construireContexte() : null,\n  });\n}\n\nfunction formaterException(exception: unknown): string | null {\n  if (exception == null) return null;\n  if (exception instanceof Error)\n    return exception.stack ?? `${exception.name}: ${exception.message}`;\n  return String(exception);\n}\n\n/** Contexte joint aux erreurs : breadcrumbs et état de la page,\n *  l'équivalent navigateur du contexte process de la target NLog. */\nfunction construireContexte(): string {\n  return JSON.stringify({\n    Breadcrumbs: instantane(),\n    Url: typeof location !== \"undefined\" ? location.href : null,\n    Ecran: typeof screen !== \"undefined\" ? `${screen.width}x${screen.height}` : null,\n    Langue: typeof navigator !== \"undefined\" ? navigator.language : null,\n  });\n}\n\nexport const idocLogs = {\n  trace: (logger: string, message: string) => log(\"Trace\", logger, message),\n  debug: (logger: string, message: string) => log(\"Debug\", logger, message),\n  info: (logger: string, message: string) => log(\"Info\", logger, message),\n  warn: (logger: string, message: string, exception?: unknown) => log(\"Warn\", logger, message, exception),\n  error: (logger: string, message: string, exception?: unknown) => log(\"Error\", logger, message, exception),\n  fatal: (logger: string, message: string, exception?: unknown) => log(\"Fatal\", logger, message, exception),\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACSA,IAAI,SAAuB,CAAC;AAC5B,IAAI,SAAS;AAEN,SAAS,sBAAsB,KAAmB;AACvD,WAAS;AACT,WAAS,CAAC;AACZ;AAEO,SAAS,QAAQ,QAAgB,QAAgB,SAAuB;AAC7E,MAAI,OAAO,UAAU,OAAQ,QAAO,MAAM;AAC1C,SAAO,KAAK,EAAE,YAAY,oBAAI,KAAK,GAAG,QAAQ,QAAQ,QAAQ,CAAC;AACjE;AAEA,SAAS,YAAY,GAAiB;AACpC,QAAM,IAAI,CAAC,GAAW,IAAI,MAAM,OAAO,CAAC,EAAE,SAAS,GAAG,GAAG;AACzD,SAAO,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,gBAAgB,GAAG,CAAC,CAAC;AAClG;AAGO,SAAS,aAAuB;AACrC,SAAO,OAAO,IAAI,OAAK,GAAG,YAAY,EAAE,UAAU,CAAC,KAAK,EAAE,MAAM,KAAK,EAAE,MAAM,WAAM,EAAE,OAAO,EAAE;AAChG;;;AC1BA,IAAM,WAAW;AAEjB,IAAI,MAAM;AACV,IAAI,SAAS;AACb,IAAI,kBAAkB;AACtB,IAAI,QAA+C;AACnD,IAAI,OAA2B,CAAC;AAChC,IAAI,eAAe;AACnB,IAAI,gBAAgB;AAEb,SAAS,oBAAoB,SAK3B;AACP,QAAM,QAAQ,IAAI,QAAQ,QAAQ,EAAE,IAAI;AACxC,WAAS,QAAQ;AACjB,oBAAkB,QAAQ;AAE1B,MAAI,MAAO,eAAc,KAAK;AAC9B,UAAQ,YAAY,MAAM,KAAK,MAAM,GAAG,QAAQ,iBAAiB;AAEjE,MAAI,OAAO,WAAW,aAAa;AAGjC,WAAO,iBAAiB,YAAY,MAAM,KAAK,MAAM,IAAI,CAAC;AAC1D,aAAS,iBAAiB,oBAAoB,MAAM;AAClD,UAAI,SAAS,oBAAoB,SAAU,MAAK,MAAM,IAAI;AAAA,IAC5D,CAAC;AAAA,EACH;AACF;AAEO,SAAS,QAAQ,QAAgC;AACtD,MAAI,KAAK,UAAU,SAAU,MAAK,MAAM;AACxC,OAAK,KAAK,MAAM;AAChB,MAAI,KAAK,UAAU,gBAAiB,MAAK,MAAM;AACjD;AAEA,eAAe,MAAM,YAAY,OAAsB;AACrD,MAAI,gBAAgB,KAAK,WAAW,KAAK,CAAC,IAAK;AAC/C,MAAI,KAAK,IAAI,IAAI,iBAAiB,CAAC,UAAW;AAI9C,QAAM,MAAM,KAAK,OAAO,GAAG,EAAE;AAC7B,iBAAe;AACf,MAAI;AACF,UAAM,eAAU,MAAM,MAAM,KAAK;AAAA,MAC/B,QAAQ;AAAA,MACR,SAAS,EAAE,gBAAgB,oBAAoB,aAAa,OAAO;AAAA,MACnE,MAAM,KAAK,UAAU,GAAG;AAAA,MACxB;AAAA,IACF,CAAC;AACD,QAAI,CAAC,aAAQ,MAAM,aAAQ,WAAW,KAAK;AAEzC,aAAO,CAAC,GAAG,KAAK,GAAG,IAAI,EAAE,MAAM,GAAG,QAAQ;AAC1C,sBAAgB,KAAK,IAAI,IAAI;AAAA,IAC/B;AAAA,EACF,QAAQ;AAEN,WAAO,CAAC,GAAG,KAAK,GAAG,IAAI,EAAE,MAAM,GAAG,QAAQ;AAC1C,oBAAgB,KAAK,IAAI,IAAI;AAAA,EAC/B,UAAE;AACA,mBAAe;AAAA,EACjB;AAEA,MAAI,KAAK,UAAU,mBAAmB,KAAK,IAAI,KAAK,cAAe,MAAK,MAAM;AAChF;;;ACtEA,IAAI,eAAU;AAIP,SAAS,wBAA8B;AAC5C,MAAI,gBAAW,OAAO,WAAW,YAAa;AAC9C,iBAAU;AAEV,SAAO,iBAAiB,SAAS,WAAS;AAExC,QAAI,MAAM,SAAS,QAAQ,MAAM,YAAY,GAAK;AAClD,QAAI,SAAS,UAAU,MAAM,WAAW,0BAAoB,MAAM,KAAK;AAAA,EACzE,CAAC;AAED,SAAO,iBAAiB,sBAAsB,WAAS;AACrD,UAAM,SAAS,MAAM;AACrB,UAAM,UAAU,kBAAkB,QAAQ,OAAO,UAAU,OAAO,MAAM;AACxE,QAAI,SAAS,UAAU,yCAAgC,OAAO,IAAI,MAAM;AAAA,EAC1E,CAAC;AACH;;;AClBO,IAAM,UAA6B,CAAC,SAAS,SAAS,QAAQ,QAAQ,SAAS,OAAO;AAEtF,SAAS,WAAW,QAAwB;AACjD,SAAO,QAAQ,QAAQ,MAAM;AAC/B;;;ACFA,IAAI,kBAAa;AACjB,IAAI,UAAyB;AAC7B,IAAI,YAAY,WAAW,MAAM;AAG1B,SAAS,aAAa,SAAgC;AAC3D,YAAU,QAAQ,WAAW;AAC7B,cAAY,WAAW,QAAQ,eAAe,MAAM;AAEpD,wBAAsB,QAAQ,kBAAkB,EAAE;AAClD,sBAAoB;AAAA,IAClB,KAAK,QAAQ;AAAA,IACb,QAAQ,QAAQ;AAAA,IAChB,mBAAmB,QAAQ,qBAAqB;AAAA,IAChD,iBAAiB,QAAQ,mBAAmB;AAAA,EAC9C,CAAC;AAED,MAAI,QAAQ,mBAAmB,MAAO,uBAAsB;AAC5D,oBAAa;AACf;AAEO,SAAS,IAAI,QAAgB,QAAgB,SAAiB,WAA2B;AAC9F,UAAQ,QAAQ,QAAQ,OAAO;AAC/B,MAAI,CAAC,mBAAc,WAAW,MAAM,IAAI,UAAW;AAEnD,QAAM,YAAY,WAAW,MAAM,KAAK,WAAW,OAAO;AAC1D,UAAQ;AAAA,IACN,aAAY,oBAAI,KAAK,GAAE,YAAY;AAAA,IACnC,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,SAAS;AAAA,IACT,WAAW,kBAAkB,SAAS;AAAA,IACtC,SAAS;AAAA,IACT,UAAU,YAAY,mBAAmB,IAAI;AAAA,EAC/C,CAAC;AACH;AAEA,SAAS,kBAAkB,WAAmC;AAC5D,MAAI,aAAa,KAAM,QAAO;AAC9B,MAAI,qBAAqB;AACvB,WAAO,UAAU,SAAS,GAAG,UAAU,IAAI,KAAK,UAAU,OAAO;AACnE,SAAO,OAAO,SAAS;AACzB;AAIA,SAAS,qBAA6B;AACpC,SAAO,KAAK,UAAU;AAAA,IACpB,aAAa,WAAW;AAAA,IACxB,KAAK,OAAO,aAAa,cAAc,SAAS,OAAO;AAAA,IACvD,OAAO,OAAO,WAAW,cAAc,GAAG,OAAO,KAAK,IAAI,OAAO,MAAM,KAAK;AAAA,IAC5E,QAAQ,OAAO,cAAc,cAAc,UAAU,WAAW;AAAA,EAClE,CAAC;AACH;AAEO,IAAM,WAAW;AAAA,EACtB,OAAO,CAAC,QAAgB,YAAoB,IAAI,SAAS,QAAQ,OAAO;AAAA,EACxE,OAAO,CAAC,QAAgB,YAAoB,IAAI,SAAS,QAAQ,OAAO;AAAA,EACxE,MAAM,CAAC,QAAgB,YAAoB,IAAI,QAAQ,QAAQ,OAAO;AAAA,EACtE,MAAM,CAAC,QAAgB,SAAiB,cAAwB,IAAI,QAAQ,QAAQ,SAAS,SAAS;AAAA,EACtG,OAAO,CAAC,QAAgB,SAAiB,cAAwB,IAAI,SAAS,QAAQ,SAAS,SAAS;AAAA,EACxG,OAAO,CAAC,QAAgB,SAAiB,cAAwB,IAAI,SAAS,QAAQ,SAAS,SAAS;AAC1G;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,7 @@
+export { I as IdocLogsOptions, L as LogClientPayload, N as Niveau, i as idocLogs, a as initIdocLogs, l as log } from './core-xTdevcDU.cjs';
+
+/** Branche la capture des erreurs non gérées du navigateur.
+ *  Appelée automatiquement par initIdocLogs sauf captureGlobale: false. */
+declare function activerCaptureGlobale(): void;
+
+export { activerCaptureGlobale };

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { I as IdocLogsOptions, L as LogClientPayload, N as Niveau, i as idocLogs, a as initIdocLogs, l as log } from './core-xTdevcDU.js';
+
+/** Branche la capture des erreurs non gérées du navigateur.
+ *  Appelée automatiquement par initIdocLogs sauf captureGlobale: false. */
+declare function activerCaptureGlobale(): void;
+
+export { activerCaptureGlobale };

package/dist/index.js

@@ -0,0 +1,13 @@
+import {
+  activerCaptureGlobale,
+  idocLogs,
+  initIdocLogs,
+  log
+} from "./chunk-TM735D27.js";
+export {
+  activerCaptureGlobale,
+  idocLogs,
+  initIdocLogs,
+  log
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/react.cjs

@@ -0,0 +1,160 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/react.tsx
+var react_exports = {};
+__export(react_exports, {
+  IdocLogsErrorBoundary: () => IdocLogsErrorBoundary,
+  useIdocLogger: () => useIdocLogger
+});
+module.exports = __toCommonJS(react_exports);
+var import_react = require("react");
+
+// src/breadcrumbs.ts
+var buffer = [];
+var taille = 30;
+function empiler(niveau, logger, message) {
+  if (buffer.length >= taille) buffer.shift();
+  buffer.push({ horodatage: /* @__PURE__ */ new Date(), niveau, logger, message });
+}
+function formatHeure(d) {
+  const p = (n, l = 2) => String(n).padStart(l, "0");
+  return `${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}.${p(d.getMilliseconds(), 3)}`;
+}
+function instantane() {
+  return buffer.map((b) => `${formatHeure(b.horodatage)} [${b.niveau}] ${b.logger} \u2014 ${b.message}`);
+}
+
+// src/transport.ts
+var FILE_MAX = 200;
+var url = "";
+var apiKey = "";
+var flushMaxEntrees = 20;
+var file = [];
+var envoiEnCours = false;
+var backoffJusqua = 0;
+function envoyer(entree) {
+  if (file.length >= FILE_MAX) file.shift();
+  file.push(entree);
+  if (file.length >= flushMaxEntrees) void flush();
+}
+async function flush(keepalive = false) {
+  if (envoiEnCours || file.length === 0 || !url) return;
+  if (Date.now() < backoffJusqua && !keepalive) return;
+  const lot = file.splice(0, 50);
+  envoiEnCours = true;
+  try {
+    const r\u00E9ponse = await fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Api-Key": apiKey },
+      body: JSON.stringify(lot),
+      keepalive
+    });
+    if (!r\u00E9ponse.ok && r\u00E9ponse.status !== 429) {
+      file = [...lot, ...file].slice(0, FILE_MAX);
+      backoffJusqua = Date.now() + 3e4;
+    }
+  } catch {
+    file = [...lot, ...file].slice(0, FILE_MAX);
+    backoffJusqua = Date.now() + 3e4;
+  } finally {
+    envoiEnCours = false;
+  }
+  if (file.length >= flushMaxEntrees && Date.now() >= backoffJusqua) void flush();
+}
+
+// src/types.ts
+var NIVEAUX = ["Trace", "Debug", "Info", "Warn", "Error", "Fatal"];
+function rangNiveau(niveau) {
+  return NIVEAUX.indexOf(niveau);
+}
+
+// src/core.ts
+var initialis\u00E9 = false;
+var version = null;
+var rangEnvoi = rangNiveau("Info");
+function log(niveau, logger, message, exception) {
+  empiler(niveau, logger, message);
+  if (!initialis\u00E9 || rangNiveau(niveau) < rangEnvoi) return;
+  const estErreur = rangNiveau(niveau) >= rangNiveau("Error");
+  envoyer({
+    Horodatage: (/* @__PURE__ */ new Date()).toISOString(),
+    Niveau: niveau,
+    Logger: logger,
+    Message: message,
+    Exception: formaterException(exception),
+    Version: version,
+    Contexte: estErreur ? construireContexte() : null
+  });
+}
+function formaterException(exception) {
+  if (exception == null) return null;
+  if (exception instanceof Error)
+    return exception.stack ?? `${exception.name}: ${exception.message}`;
+  return String(exception);
+}
+function construireContexte() {
+  return JSON.stringify({
+    Breadcrumbs: instantane(),
+    Url: typeof location !== "undefined" ? location.href : null,
+    Ecran: typeof screen !== "undefined" ? `${screen.width}x${screen.height}` : null,
+    Langue: typeof navigator !== "undefined" ? navigator.language : null
+  });
+}
+var idocLogs = {
+  trace: (logger, message) => log("Trace", logger, message),
+  debug: (logger, message) => log("Debug", logger, message),
+  info: (logger, message) => log("Info", logger, message),
+  warn: (logger, message, exception) => log("Warn", logger, message, exception),
+  error: (logger, message, exception) => log("Error", logger, message, exception),
+  fatal: (logger, message, exception) => log("Fatal", logger, message, exception)
+};
+
+// src/react.tsx
+var IdocLogsErrorBoundary = class extends import_react.Component {
+  constructor() {
+    super(...arguments);
+    this.state = { error: null };
+    this.r\u00E9initialiser = () => this.setState({ error: null });
+  }
+  static getDerivedStateFromError(error) {
+    return { error };
+  }
+  componentDidCatch(error, info) {
+    const pile = info.componentStack ? `
+Composants :${info.componentStack}` : "";
+    log("Fatal", this.props.logger ?? "react", `${error.message}${pile}`, error);
+  }
+  render() {
+    const { error } = this.state;
+    if (error === null) return this.props.children;
+    const { fallback } = this.props;
+    if (typeof fallback === "function") return fallback(error, this.r\u00E9initialiser);
+    return fallback ?? null;
+  }
+};
+function useIdocLogger() {
+  return idocLogs;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  IdocLogsErrorBoundary,
+  useIdocLogger
+});
+//# sourceMappingURL=react.cjs.map

package/dist/react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react.tsx","../src/breadcrumbs.ts","../src/transport.ts","../src/types.ts","../src/core.ts"],"sourcesContent":["import { Component, type ErrorInfo, type ReactNode } from \"react\";\nimport { idocLogs, log } from \"./core\";\n\ninterface ErrorBoundaryProps {\n  /** Nom du logger utilisé pour les erreurs capturées (défaut : \"react\"). */\n  logger?: string;\n  /** Rendu de repli affiché après une erreur. Peut être un nœud ou une fonction recevant l'erreur. */\n  fallback?: ReactNode | ((error: Error, réinitialiser: () => void) => ReactNode);\n  children: ReactNode;\n}\n\ninterface ErrorBoundaryState {\n  error: Error | null;\n}\n\n/** Error boundary React : les erreurs de rendu sont envoyées au centralisateur\n *  (niveau Fatal, avec la pile de composants), puis le fallback est affiché. */\nexport class IdocLogsErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {\n  state: ErrorBoundaryState = { error: null };\n\n  static getDerivedStateFromError(error: Error): ErrorBoundaryState {\n    return { error };\n  }\n\n  componentDidCatch(error: Error, info: ErrorInfo): void {\n    const pile = info.componentStack ? `\\nComposants :${info.componentStack}` : \"\";\n    log(\"Fatal\", this.props.logger ?? \"react\", `${error.message}${pile}`, error);\n  }\n\n  private réinitialiser = () => this.setState({ error: null });\n\n  render(): ReactNode {\n    const { error } = this.state;\n    if (error === null) return this.props.children;\n\n    const { fallback } = this.props;\n    if (typeof fallback === \"function\") return fallback(error, this.réinitialiser);\n    return fallback ?? null;\n  }\n}\n\n/** Accès au logger depuis les composants. Simple ré-export stable : le client\n *  est un singleton module, aucun contexte React n'est nécessaire. */\nexport function useIdocLogger(): typeof idocLogs {\n  return idocLogs;\n}\n","import type { Niveau } from \"./types\";\n\ninterface Breadcrumb {\n  horodatage: Date;\n  niveau: Niveau;\n  logger: string;\n  message: string;\n}\n\nlet buffer: Breadcrumb[] = [];\nlet taille = 30;\n\nexport function configurerBreadcrumbs(max: number): void {\n  taille = max;\n  buffer = [];\n}\n\nexport function empiler(niveau: Niveau, logger: string, message: string): void {\n  if (buffer.length >= taille) buffer.shift();\n  buffer.push({ horodatage: new Date(), niveau, logger, message });\n}\n\nfunction formatHeure(d: Date): string {\n  const p = (n: number, l = 2) => String(n).padStart(l, \"0\");\n  return `${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}.${p(d.getMilliseconds(), 3)}`;\n}\n\n/** Instantané du buffer, au format aligné sur la target NLog C#. */\nexport function instantane(): string[] {\n  return buffer.map(b => `${formatHeure(b.horodatage)} [${b.niveau}] ${b.logger} — ${b.message}`);\n}\n","import type { LogClientPayload } from \"./types\";\n\n// File d'attente bornée : au-delà, les entrées les plus anciennes sont abandonnées\n// (même philosophie que la target NLog : ne jamais bloquer ni faire gonfler la mémoire).\nconst FILE_MAX = 200;\n\nlet url = \"\";\nlet apiKey = \"\";\nlet flushMaxEntrees = 20;\nlet timer: ReturnType<typeof setInterval> | null = null;\nlet file: LogClientPayload[] = [];\nlet envoiEnCours = false;\nlet backoffJusqua = 0;\n\nexport function configurerTransport(options: {\n  url: string;\n  apiKey: string;\n  flushIntervalleMs: number;\n  flushMaxEntrees: number;\n}): void {\n  url = options.url.replace(/\\/+$/, \"\") + \"/api/logs/client\";\n  apiKey = options.apiKey;\n  flushMaxEntrees = options.flushMaxEntrees;\n\n  if (timer) clearInterval(timer);\n  timer = setInterval(() => void flush(), options.flushIntervalleMs);\n\n  if (typeof window !== \"undefined\") {\n    // fetch keepalive survit à la fermeture de la page (contrairement à un fetch\n    // classique) et, contrairement à sendBeacon, permet le header X-Api-Key.\n    window.addEventListener(\"pagehide\", () => void flush(true));\n    document.addEventListener(\"visibilitychange\", () => {\n      if (document.visibilityState === \"hidden\") void flush(true);\n    });\n  }\n}\n\nexport function envoyer(entree: LogClientPayload): void {\n  if (file.length >= FILE_MAX) file.shift();\n  file.push(entree);\n  if (file.length >= flushMaxEntrees) void flush();\n}\n\nasync function flush(keepalive = false): Promise<void> {\n  if (envoiEnCours || file.length === 0 || !url) return;\n  if (Date.now() < backoffJusqua && !keepalive) return;\n\n  // Lots de 50 max (limite serveur) ; keepalive limite le corps à ~64 Ko,\n  // on reste prudent avec un lot unique dans ce cas.\n  const lot = file.splice(0, 50);\n  envoiEnCours = true;\n  try {\n    const réponse = await fetch(url, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\", \"X-Api-Key\": apiKey },\n      body: JSON.stringify(lot),\n      keepalive,\n    });\n    if (!réponse.ok && réponse.status !== 429) {\n      // Clé invalide ou erreur serveur : on remet le lot, backoff 30 s.\n      file = [...lot, ...file].slice(0, FILE_MAX);\n      backoffJusqua = Date.now() + 30_000;\n    }\n  } catch {\n    // Serveur injoignable : abandon silencieux du réseau, backoff 30 s.\n    file = [...lot, ...file].slice(0, FILE_MAX);\n    backoffJusqua = Date.now() + 30_000;\n  } finally {\n    envoiEnCours = false;\n  }\n\n  if (file.length >= flushMaxEntrees && Date.now() >= backoffJusqua) void flush();\n}\n","/** Niveaux NLog, dans l'ordre croissant de sévérité. */\nexport type Niveau = \"Trace\" | \"Debug\" | \"Info\" | \"Warn\" | \"Error\" | \"Fatal\";\n\nexport const NIVEAUX: readonly Niveau[] = [\"Trace\", \"Debug\", \"Info\", \"Warn\", \"Error\", \"Fatal\"];\n\nexport function rangNiveau(niveau: Niveau): number {\n  return NIVEAUX.indexOf(niveau);\n}\n\n/** Entrée telle qu'attendue par POST /api/logs/client (PascalCase côté serveur). */\nexport interface LogClientPayload {\n  Horodatage: string;\n  Niveau: Niveau;\n  Logger: string;\n  Message: string;\n  Exception: string | null;\n  Version: string | null;\n  Contexte: string | null;\n}\n\nexport interface IdocLogsOptions {\n  /** URL de base du serveur de logs, ex. \"https://logs.example.com:5001\". */\n  url: string;\n  /** Clé API de l'application (générée dans l'admin du serveur de logs). */\n  apiKey: string;\n  /** Nom de l'application (informatif : le serveur impose celui associé à la clé). */\n  application?: string;\n  /** Version de l'application, jointe à chaque entrée. */\n  version?: string;\n  /** Niveau minimum réellement envoyé au serveur (défaut : \"Info\").\n   *  Les niveaux inférieurs alimentent uniquement les breadcrumbs. */\n  niveauEnvoi?: Niveau;\n  /** Brancher window.onerror / unhandledrejection (défaut : true). */\n  captureGlobale?: boolean;\n  /** Taille du buffer de breadcrumbs (défaut : 30). */\n  breadcrumbsMax?: number;\n  /** Intervalle de flush du lot en millisecondes (défaut : 5000). */\n  flushIntervalleMs?: number;\n  /** Taille de lot déclenchant un flush immédiat (défaut : 20). */\n  flushMaxEntrees?: number;\n}\n","import { configurerBreadcrumbs, empiler, instantane } from \"./breadcrumbs\";\nimport { configurerTransport, envoyer } from \"./transport\";\nimport { activerCaptureGlobale } from \"./capture\";\nimport { rangNiveau, type IdocLogsOptions, type Niveau } from \"./types\";\n\nlet initialisé = false;\nlet version: string | null = null;\nlet rangEnvoi = rangNiveau(\"Info\");\n\n/** Initialise le client. À appeler une fois au démarrage de l'application. */\nexport function initIdocLogs(options: IdocLogsOptions): void {\n  version = options.version ?? null;\n  rangEnvoi = rangNiveau(options.niveauEnvoi ?? \"Info\");\n\n  configurerBreadcrumbs(options.breadcrumbsMax ?? 30);\n  configurerTransport({\n    url: options.url,\n    apiKey: options.apiKey,\n    flushIntervalleMs: options.flushIntervalleMs ?? 5000,\n    flushMaxEntrees: options.flushMaxEntrees ?? 20,\n  });\n\n  if (options.captureGlobale !== false) activerCaptureGlobale();\n  initialisé = true;\n}\n\nexport function log(niveau: Niveau, logger: string, message: string, exception?: unknown): void {\n  empiler(niveau, logger, message);\n  if (!initialisé || rangNiveau(niveau) < rangEnvoi) return;\n\n  const estErreur = rangNiveau(niveau) >= rangNiveau(\"Error\");\n  envoyer({\n    Horodatage: new Date().toISOString(),\n    Niveau: niveau,\n    Logger: logger,\n    Message: message,\n    Exception: formaterException(exception),\n    Version: version,\n    Contexte: estErreur ? construireContexte() : null,\n  });\n}\n\nfunction formaterException(exception: unknown): string | null {\n  if (exception == null) return null;\n  if (exception instanceof Error)\n    return exception.stack ?? `${exception.name}: ${exception.message}`;\n  return String(exception);\n}\n\n/** Contexte joint aux erreurs : breadcrumbs et état de la page,\n *  l'équivalent navigateur du contexte process de la target NLog. */\nfunction construireContexte(): string {\n  return JSON.stringify({\n    Breadcrumbs: instantane(),\n    Url: typeof location !== \"undefined\" ? location.href : null,\n    Ecran: typeof screen !== \"undefined\" ? `${screen.width}x${screen.height}` : null,\n    Langue: typeof navigator !== \"undefined\" ? navigator.language : null,\n  });\n}\n\nexport const idocLogs = {\n  trace: (logger: string, message: string) => log(\"Trace\", logger, message),\n  debug: (logger: string, message: string) => log(\"Debug\", logger, message),\n  info: (logger: string, message: string) => log(\"Info\", logger, message),\n  warn: (logger: string, message: string, exception?: unknown) => log(\"Warn\", logger, message, exception),\n  error: (logger: string, message: string, exception?: unknown) => log(\"Error\", logger, message, exception),\n  fatal: (logger: string, message: string, exception?: unknown) => log(\"Fatal\", logger, message, exception),\n};\n"],"mappings":"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","names":[]}

package/dist/react.d.cts

@@ -0,0 +1,27 @@
+import { Component, ReactNode, ErrorInfo } from 'react';
+import { i as idocLogs } from './core-xTdevcDU.cjs';
+
+interface ErrorBoundaryProps {
+    /** Nom du logger utilisé pour les erreurs capturées (défaut : "react"). */
+    logger?: string;
+    /** Rendu de repli affiché après une erreur. Peut être un nœud ou une fonction recevant l'erreur. */
+    fallback?: ReactNode | ((error: Error, réinitialiser: () => void) => ReactNode);
+    children: ReactNode;
+}
+interface ErrorBoundaryState {
+    error: Error | null;
+}
+/** Error boundary React : les erreurs de rendu sont envoyées au centralisateur
+ *  (niveau Fatal, avec la pile de composants), puis le fallback est affiché. */
+declare class IdocLogsErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    state: ErrorBoundaryState;
+    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+    componentDidCatch(error: Error, info: ErrorInfo): void;
+    private réinitialiser;
+    render(): ReactNode;
+}
+/** Accès au logger depuis les composants. Simple ré-export stable : le client
+ *  est un singleton module, aucun contexte React n'est nécessaire. */
+declare function useIdocLogger(): typeof idocLogs;
+
+export { IdocLogsErrorBoundary, useIdocLogger };

package/dist/react.d.ts

@@ -0,0 +1,27 @@
+import { Component, ReactNode, ErrorInfo } from 'react';
+import { i as idocLogs } from './core-xTdevcDU.js';
+
+interface ErrorBoundaryProps {
+    /** Nom du logger utilisé pour les erreurs capturées (défaut : "react"). */
+    logger?: string;
+    /** Rendu de repli affiché après une erreur. Peut être un nœud ou une fonction recevant l'erreur. */
+    fallback?: ReactNode | ((error: Error, réinitialiser: () => void) => ReactNode);
+    children: ReactNode;
+}
+interface ErrorBoundaryState {
+    error: Error | null;
+}
+/** Error boundary React : les erreurs de rendu sont envoyées au centralisateur
+ *  (niveau Fatal, avec la pile de composants), puis le fallback est affiché. */
+declare class IdocLogsErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    state: ErrorBoundaryState;
+    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+    componentDidCatch(error: Error, info: ErrorInfo): void;
+    private réinitialiser;
+    render(): ReactNode;
+}
+/** Accès au logger depuis les composants. Simple ré-export stable : le client
+ *  est un singleton module, aucun contexte React n'est nécessaire. */
+declare function useIdocLogger(): typeof idocLogs;
+
+export { IdocLogsErrorBoundary, useIdocLogger };

package/dist/react.js

@@ -0,0 +1,37 @@
+import {
+  idocLogs,
+  log
+} from "./chunk-TM735D27.js";
+
+// src/react.tsx
+import { Component } from "react";
+var IdocLogsErrorBoundary = class extends Component {
+  constructor() {
+    super(...arguments);
+    this.state = { error: null };
+    this.r\u00E9initialiser = () => this.setState({ error: null });
+  }
+  static getDerivedStateFromError(error) {
+    return { error };
+  }
+  componentDidCatch(error, info) {
+    const pile = info.componentStack ? `
+Composants :${info.componentStack}` : "";
+    log("Fatal", this.props.logger ?? "react", `${error.message}${pile}`, error);
+  }
+  render() {
+    const { error } = this.state;
+    if (error === null) return this.props.children;
+    const { fallback } = this.props;
+    if (typeof fallback === "function") return fallback(error, this.r\u00E9initialiser);
+    return fallback ?? null;
+  }
+};
+function useIdocLogger() {
+  return idocLogs;
+}
+export {
+  IdocLogsErrorBoundary,
+  useIdocLogger
+};
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react.tsx"],"sourcesContent":["import { Component, type ErrorInfo, type ReactNode } from \"react\";\nimport { idocLogs, log } from \"./core\";\n\ninterface ErrorBoundaryProps {\n  /** Nom du logger utilisé pour les erreurs capturées (défaut : \"react\"). */\n  logger?: string;\n  /** Rendu de repli affiché après une erreur. Peut être un nœud ou une fonction recevant l'erreur. */\n  fallback?: ReactNode | ((error: Error, réinitialiser: () => void) => ReactNode);\n  children: ReactNode;\n}\n\ninterface ErrorBoundaryState {\n  error: Error | null;\n}\n\n/** Error boundary React : les erreurs de rendu sont envoyées au centralisateur\n *  (niveau Fatal, avec la pile de composants), puis le fallback est affiché. */\nexport class IdocLogsErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {\n  state: ErrorBoundaryState = { error: null };\n\n  static getDerivedStateFromError(error: Error): ErrorBoundaryState {\n    return { error };\n  }\n\n  componentDidCatch(error: Error, info: ErrorInfo): void {\n    const pile = info.componentStack ? `\\nComposants :${info.componentStack}` : \"\";\n    log(\"Fatal\", this.props.logger ?? \"react\", `${error.message}${pile}`, error);\n  }\n\n  private réinitialiser = () => this.setState({ error: null });\n\n  render(): ReactNode {\n    const { error } = this.state;\n    if (error === null) return this.props.children;\n\n    const { fallback } = this.props;\n    if (typeof fallback === \"function\") return fallback(error, this.réinitialiser);\n    return fallback ?? null;\n  }\n}\n\n/** Accès au logger depuis les composants. Simple ré-export stable : le client\n *  est un singleton module, aucun contexte React n'est nécessaire. */\nexport function useIdocLogger(): typeof idocLogs {\n  return idocLogs;\n}\n"],"mappings":";;;;;;AAAA,SAAS,iBAAiD;AAiBnD,IAAM,wBAAN,cAAoC,UAAkD;AAAA,EAAtF;AAAA;AACL,iBAA4B,EAAE,OAAO,KAAK;AAW1C,SAAQ,qBAAgB,MAAM,KAAK,SAAS,EAAE,OAAO,KAAK,CAAC;AAAA;AAAA,EAT3D,OAAO,yBAAyB,OAAkC;AAChE,WAAO,EAAE,MAAM;AAAA,EACjB;AAAA,EAEA,kBAAkB,OAAc,MAAuB;AACrD,UAAM,OAAO,KAAK,iBAAiB;AAAA,cAAiB,KAAK,cAAc,KAAK;AAC5E,QAAI,SAAS,KAAK,MAAM,UAAU,SAAS,GAAG,MAAM,OAAO,GAAG,IAAI,IAAI,KAAK;AAAA,EAC7E;AAAA,EAIA,SAAoB;AAClB,UAAM,EAAE,MAAM,IAAI,KAAK;AACvB,QAAI,UAAU,KAAM,QAAO,KAAK,MAAM;AAEtC,UAAM,EAAE,SAAS,IAAI,KAAK;AAC1B,QAAI,OAAO,aAAa,WAAY,QAAO,SAAS,OAAO,KAAK,kBAAa;AAC7E,WAAO,YAAY;AAAA,EACrB;AACF;AAIO,SAAS,gBAAiC;AAC/C,SAAO;AACT;","names":[]}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "idoc-logs-react",
+  "version": "1.0.0",
+  "description": "Client de logs pour le centralisateur IDOC.Logs : capture d'exceptions globales, breadcrumbs, envoi par lots vers l'endpoint HTTPS d'ingestion. Bindings React inclus.",
+  "author": "Philippe Boinnard",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "require": "./dist/react.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "logging",
+    "error-tracking",
+    "breadcrumbs",
+    "react",
+    "nlog",
+    "idoc"
+  ],
+  "peerDependencies": {
+    "react": ">=17"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2"
+  }
+}