@nicomatic/logger 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,56 @@
-# Temporary Holding Version
+# `@nicomatic/logger`
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Package npm de logging JSON unifié pour les services Nicomatic (JS/TS).
+
+Prérequis consommateur : **Node.js ≥ 20**.
+
+## Installation
+
+```bash
+pnpm add @nicomatic/logger
+# ou : npm install @nicomatic/logger
+# ou : yarn add @nicomatic/logger
+```
+
+Package **public** sur [npmjs](https://www.npmjs.com/) (scope `@nicomatic`).
+
+## Publication (maintainers)
+
+Prérequis : compte npm membre de l’org `@nicomatic`, puis `npm login`.
+
+```bash
+just check
+npm publish
+```
+
+## Développement
+
+Prérequis : [Nix](https://nixos.org/) (flakes). Optionnel : [direnv](https://direnv.net/) + [nix-direnv](https://github.com/nix-community/nix-direnv) pour entrer automatiquement dans le shell.
+
+```bash
+direnv allow          # une fois, si direnv est installé
+# sinon : nix develop
+just setup
+just check            # test + typecheck + build
+```
+
+## API minimale
+
+```ts
+import { createLogger } from "@nicomatic/logger";
+
+const log = createLogger({
+  service: "app-web",
+  env: "dev",
+  version: "0.1.0",
+});
+
+log.info({ message: "hello", traceId: "abc" });
+```
+
+## Spec (M1)
+
+- Schéma JSON : [`schemas/log-event.schema.json`](schemas/log-event.schema.json)
+- Exemples : [`schemas/examples/`](schemas/examples/)
+- ADR format : [`docs/adr/0001-format-de-log-unifie.md`](docs/adr/0001-format-de-log-unifie.md)
+- ADR RGPD / sécurité (NMTC-106) : [`docs/adr/0002-rgpd-securite-capture-logs.md`](docs/adr/0002-rgpd-securite-capture-logs.md)

package/dist/index.cjs

@@ -0,0 +1,67 @@
+"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 index_exports = {};
+__export(index_exports, {
+  createLogger: () => createLogger
+});
+module.exports = __toCommonJS(index_exports);
+var SCHEMA_VERSION = "1.0";
+function normalizeFields(input) {
+  if (typeof input === "string") {
+    return { message: input };
+  }
+  return input;
+}
+function createLogger(options, bindings = {}) {
+  const logAt = (level) => (input) => {
+    const fields = normalizeFields(input);
+    const { message, level: _ignoredLevel, ...rest } = fields;
+    const event = {
+      schemaVersion: SCHEMA_VERSION,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      level,
+      service: options.service,
+      env: options.env,
+      version: options.version,
+      message,
+      ...bindings,
+      ...rest
+    };
+    process.stdout.write(`${JSON.stringify(event)}
+`);
+  };
+  return {
+    trace: logAt("trace"),
+    debug: logAt("debug"),
+    info: logAt("info"),
+    warn: logAt("warn"),
+    error: logAt("error"),
+    fatal: logAt("fatal"),
+    child(childBindings) {
+      return createLogger(options, { ...bindings, ...childBindings });
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createLogger
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type {\n  CreateLoggerOptions,\n  LogFields,\n  LogLevel,\n  Logger,\n} from \"./types.js\";\n\nexport type {\n  CreateLoggerOptions,\n  LogError,\n  LogFields,\n  LogLevel,\n  LogRequest,\n  LogResponse,\n  Logger,\n} from \"./types.js\";\n\nconst SCHEMA_VERSION = \"1.0\";\n\nfunction normalizeFields(input: LogFields | string): LogFields {\n  if (typeof input === \"string\") {\n    return { message: input };\n  }\n  return input;\n}\n\nexport function createLogger(\n  options: CreateLoggerOptions,\n  bindings: Record<string, unknown> = {},\n): Logger {\n  const logAt =\n    (level: LogLevel) =>\n    (input: LogFields | string): void => {\n      const fields = normalizeFields(input);\n      const { message, level: _ignoredLevel, ...rest } = fields;\n\n      const event = {\n        schemaVersion: SCHEMA_VERSION,\n        timestamp: new Date().toISOString(),\n        level,\n        service: options.service,\n        env: options.env,\n        version: options.version,\n        message,\n        ...bindings,\n        ...rest,\n      };\n\n      process.stdout.write(`${JSON.stringify(event)}\\n`);\n    };\n\n  return {\n    trace: logAt(\"trace\"),\n    debug: logAt(\"debug\"),\n    info: logAt(\"info\"),\n    warn: logAt(\"warn\"),\n    error: logAt(\"error\"),\n    fatal: logAt(\"fatal\"),\n    child(childBindings: Record<string, unknown>): Logger {\n      return createLogger(options, { ...bindings, ...childBindings });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAiBA,IAAM,iBAAiB;AAEvB,SAAS,gBAAgB,OAAsC;AAC7D,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,EAAE,SAAS,MAAM;AAAA,EAC1B;AACA,SAAO;AACT;AAEO,SAAS,aACd,SACA,WAAoC,CAAC,GAC7B;AACR,QAAM,QACJ,CAAC,UACD,CAAC,UAAoC;AACnC,UAAM,SAAS,gBAAgB,KAAK;AACpC,UAAM,EAAE,SAAS,OAAO,eAAe,GAAG,KAAK,IAAI;AAEnD,UAAM,QAAQ;AAAA,MACZ,eAAe;AAAA,MACf,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,MAClC;AAAA,MACA,SAAS,QAAQ;AAAA,MACjB,KAAK,QAAQ;AAAA,MACb,SAAS,QAAQ;AAAA,MACjB;AAAA,MACA,GAAG;AAAA,MACH,GAAG;AAAA,IACL;AAEA,YAAQ,OAAO,MAAM,GAAG,KAAK,UAAU,KAAK,CAAC;AAAA,CAAI;AAAA,EACnD;AAEF,SAAO;AAAA,IACL,OAAO,MAAM,OAAO;AAAA,IACpB,OAAO,MAAM,OAAO;AAAA,IACpB,MAAM,MAAM,MAAM;AAAA,IAClB,MAAM,MAAM,MAAM;AAAA,IAClB,OAAO,MAAM,OAAO;AAAA,IACpB,OAAO,MAAM,OAAO;AAAA,IACpB,MAAM,eAAgD;AACpD,aAAO,aAAa,SAAS,EAAE,GAAG,UAAU,GAAG,cAAc,CAAC;AAAA,IAChE;AAAA,EACF;AACF;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,49 @@
+type LogLevel = "trace" | "debug" | "info" | "warn" | "error" | "fatal";
+type CreateLoggerOptions = {
+    service: string;
+    env: string;
+    version: string;
+};
+type LogRequest = {
+    method?: string;
+    url?: string;
+    status?: number;
+    durationMs?: number;
+    userId?: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+    bodyTruncated?: boolean;
+};
+type LogResponse = {
+    body?: unknown;
+};
+type LogError = {
+    type?: string;
+    message?: string;
+    stack?: string;
+    code?: string | number;
+    cause?: unknown;
+};
+type LogFields = {
+    message: string;
+    level?: LogLevel;
+    traceId?: string;
+    correlationId?: string;
+    request?: LogRequest;
+    response?: LogResponse;
+    error?: LogError | null;
+    [key: string]: unknown;
+};
+type Logger = {
+    trace: (fields: LogFields | string) => void;
+    debug: (fields: LogFields | string) => void;
+    info: (fields: LogFields | string) => void;
+    warn: (fields: LogFields | string) => void;
+    error: (fields: LogFields | string) => void;
+    fatal: (fields: LogFields | string) => void;
+    child: (bindings: Record<string, unknown>) => Logger;
+};
+
+declare function createLogger(options: CreateLoggerOptions, bindings?: Record<string, unknown>): Logger;
+
+export { type CreateLoggerOptions, type LogError, type LogFields, type LogLevel, type LogRequest, type LogResponse, type Logger, createLogger };

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+type LogLevel = "trace" | "debug" | "info" | "warn" | "error" | "fatal";
+type CreateLoggerOptions = {
+    service: string;
+    env: string;
+    version: string;
+};
+type LogRequest = {
+    method?: string;
+    url?: string;
+    status?: number;
+    durationMs?: number;
+    userId?: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+    bodyTruncated?: boolean;
+};
+type LogResponse = {
+    body?: unknown;
+};
+type LogError = {
+    type?: string;
+    message?: string;
+    stack?: string;
+    code?: string | number;
+    cause?: unknown;
+};
+type LogFields = {
+    message: string;
+    level?: LogLevel;
+    traceId?: string;
+    correlationId?: string;
+    request?: LogRequest;
+    response?: LogResponse;
+    error?: LogError | null;
+    [key: string]: unknown;
+};
+type Logger = {
+    trace: (fields: LogFields | string) => void;
+    debug: (fields: LogFields | string) => void;
+    info: (fields: LogFields | string) => void;
+    warn: (fields: LogFields | string) => void;
+    error: (fields: LogFields | string) => void;
+    fatal: (fields: LogFields | string) => void;
+    child: (bindings: Record<string, unknown>) => Logger;
+};
+
+declare function createLogger(options: CreateLoggerOptions, bindings?: Record<string, unknown>): Logger;
+
+export { type CreateLoggerOptions, type LogError, type LogFields, type LogLevel, type LogRequest, type LogResponse, type Logger, createLogger };

package/dist/index.js

@@ -0,0 +1,42 @@
+// src/index.ts
+var SCHEMA_VERSION = "1.0";
+function normalizeFields(input) {
+  if (typeof input === "string") {
+    return { message: input };
+  }
+  return input;
+}
+function createLogger(options, bindings = {}) {
+  const logAt = (level) => (input) => {
+    const fields = normalizeFields(input);
+    const { message, level: _ignoredLevel, ...rest } = fields;
+    const event = {
+      schemaVersion: SCHEMA_VERSION,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      level,
+      service: options.service,
+      env: options.env,
+      version: options.version,
+      message,
+      ...bindings,
+      ...rest
+    };
+    process.stdout.write(`${JSON.stringify(event)}
+`);
+  };
+  return {
+    trace: logAt("trace"),
+    debug: logAt("debug"),
+    info: logAt("info"),
+    warn: logAt("warn"),
+    error: logAt("error"),
+    fatal: logAt("fatal"),
+    child(childBindings) {
+      return createLogger(options, { ...bindings, ...childBindings });
+    }
+  };
+}
+export {
+  createLogger
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type {\n  CreateLoggerOptions,\n  LogFields,\n  LogLevel,\n  Logger,\n} from \"./types.js\";\n\nexport type {\n  CreateLoggerOptions,\n  LogError,\n  LogFields,\n  LogLevel,\n  LogRequest,\n  LogResponse,\n  Logger,\n} from \"./types.js\";\n\nconst SCHEMA_VERSION = \"1.0\";\n\nfunction normalizeFields(input: LogFields | string): LogFields {\n  if (typeof input === \"string\") {\n    return { message: input };\n  }\n  return input;\n}\n\nexport function createLogger(\n  options: CreateLoggerOptions,\n  bindings: Record<string, unknown> = {},\n): Logger {\n  const logAt =\n    (level: LogLevel) =>\n    (input: LogFields | string): void => {\n      const fields = normalizeFields(input);\n      const { message, level: _ignoredLevel, ...rest } = fields;\n\n      const event = {\n        schemaVersion: SCHEMA_VERSION,\n        timestamp: new Date().toISOString(),\n        level,\n        service: options.service,\n        env: options.env,\n        version: options.version,\n        message,\n        ...bindings,\n        ...rest,\n      };\n\n      process.stdout.write(`${JSON.stringify(event)}\\n`);\n    };\n\n  return {\n    trace: logAt(\"trace\"),\n    debug: logAt(\"debug\"),\n    info: logAt(\"info\"),\n    warn: logAt(\"warn\"),\n    error: logAt(\"error\"),\n    fatal: logAt(\"fatal\"),\n    child(childBindings: Record<string, unknown>): Logger {\n      return createLogger(options, { ...bindings, ...childBindings });\n    },\n  };\n}\n"],"mappings":";AAiBA,IAAM,iBAAiB;AAEvB,SAAS,gBAAgB,OAAsC;AAC7D,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,EAAE,SAAS,MAAM;AAAA,EAC1B;AACA,SAAO;AACT;AAEO,SAAS,aACd,SACA,WAAoC,CAAC,GAC7B;AACR,QAAM,QACJ,CAAC,UACD,CAAC,UAAoC;AACnC,UAAM,SAAS,gBAAgB,KAAK;AACpC,UAAM,EAAE,SAAS,OAAO,eAAe,GAAG,KAAK,IAAI;AAEnD,UAAM,QAAQ;AAAA,MACZ,eAAe;AAAA,MACf,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,MAClC;AAAA,MACA,SAAS,QAAQ;AAAA,MACjB,KAAK,QAAQ;AAAA,MACb,SAAS,QAAQ;AAAA,MACjB;AAAA,MACA,GAAG;AAAA,MACH,GAAG;AAAA,IACL;AAEA,YAAQ,OAAO,MAAM,GAAG,KAAK,UAAU,KAAK,CAAC;AAAA,CAAI;AAAA,EACnD;AAEF,SAAO;AAAA,IACL,OAAO,MAAM,OAAO;AAAA,IACpB,OAAO,MAAM,OAAO;AAAA,IACpB,MAAM,MAAM,MAAM;AAAA,IAClB,MAAM,MAAM,MAAM;AAAA,IAClB,OAAO,MAAM,OAAO;AAAA,IACpB,OAAO,MAAM,OAAO;AAAA,IACpB,MAAM,eAAgD;AACpD,aAAO,aAAa,SAAS,EAAE,GAAG,UAAU,GAAG,cAAc,CAAC;AAAA,IAChE;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -1,6 +1,45 @@
 {
   "name": "@nicomatic/logger",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Logger JSON unifié pour les services Nicomatic (JS/TS)",
+  "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"
+    }
+  },
+  "files": [
+    "dist",
+    "schemas"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": ["esbuild"]
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.2",
+    "vitest": "^3.0.8"
+  }
+}

package/schemas/examples/invalid/bad-timestamp.json

@@ -0,0 +1,9 @@
+{
+  "schemaVersion": "1.0",
+  "timestamp": "30/10/2026 22:15",
+  "level": "info",
+  "service": "app-web",
+  "env": "prod",
+  "version": "2.4.1",
+  "message": "request completed"
+}

package/schemas/examples/invalid/forbidden-header.json

@@ -0,0 +1,17 @@
+{
+  "schemaVersion": "1.0",
+  "timestamp": "2026-10-30T22:15:03.512Z",
+  "level": "info",
+  "service": "app-web",
+  "env": "prod",
+  "version": "2.4.1",
+  "message": "request completed",
+  "request": {
+    "method": "POST",
+    "url": "/api/orders",
+    "status": 201,
+    "headers": {
+      "authorization": "Bearer secret-token"
+    }
+  }
+}

package/schemas/examples/invalid/missing-required-fields.json

@@ -0,0 +1,6 @@
+{
+  "schemaVersion": "1.0",
+  "timestamp": "2026-10-30T22:15:03.512Z",
+  "level": "info",
+  "message": "incomplete event"
+}

package/schemas/examples/invalid/missing-schema-version.json

@@ -0,0 +1,8 @@
+{
+  "timestamp": "2026-10-30T22:15:03.512Z",
+  "level": "info",
+  "service": "app-web",
+  "env": "prod",
+  "version": "2.4.1",
+  "message": "request completed"
+}

package/schemas/examples/invalid/unknown-level.json

@@ -0,0 +1,9 @@
+{
+  "schemaVersion": "1.0",
+  "timestamp": "2026-10-30T22:15:03.512Z",
+  "level": "verbose",
+  "service": "app-web",
+  "env": "prod",
+  "version": "2.4.1",
+  "message": "request completed"
+}

package/schemas/examples/valid/diagnostic-body-redacted.json

@@ -0,0 +1,33 @@
+{
+  "schemaVersion": "1.0",
+  "timestamp": "2026-11-07T18:05:00.000Z",
+  "level": "error",
+  "service": "app-web",
+  "env": "prod",
+  "version": "2.4.1",
+  "message": "request failed",
+  "traceId": "6d014f5799d56fc8c5e0141f2a2a6958",
+  "request": {
+    "method": "POST",
+    "url": "/api/profile",
+    "status": 500,
+    "durationMs": 120,
+    "userId": "u_5678",
+    "headers": {
+      "content-type": "application/json",
+      "user-agent": "Mozilla/5.0"
+    },
+    "body": {
+      "displayName": "Ada",
+      "email": "[REDACTED]",
+      "password": "[REDACTED]",
+      "token": "[REDACTED]"
+    },
+    "bodyTruncated": false
+  },
+  "error": {
+    "type": "InternalServerError",
+    "message": "unexpected failure",
+    "code": 500
+  }
+}

package/schemas/examples/valid/error-with-stack.json

@@ -0,0 +1,27 @@
+{
+  "schemaVersion": "1.0",
+  "timestamp": "2026-10-30T22:16:11.004Z",
+  "level": "error",
+  "service": "app-web",
+  "env": "prod",
+  "version": "2.4.1",
+  "message": "unhandled exception",
+  "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",
+  "correlationId": "c0a8012e-7f3d-4a8b-9b1e-2f6d5c3e9a10",
+  "request": {
+    "method": "GET",
+    "url": "/api/orders/O-5521",
+    "status": 500,
+    "durationMs": 18
+  },
+  "error": {
+    "type": "Error",
+    "message": "database connection refused",
+    "stack": "Error: database connection refused\n    at Query.run (db.js:10:5)",
+    "code": "ECONNREFUSED",
+    "cause": {
+      "type": "Error",
+      "message": "connect ECONNREFUSED 127.0.0.1:5432"
+    }
+  }
+}

package/schemas/examples/valid/login-redacted.json

@@ -0,0 +1,22 @@
+{
+  "schemaVersion": "1.0",
+  "timestamp": "2026-11-07T18:00:00.000Z",
+  "level": "info",
+  "service": "auth-api",
+  "env": "prod",
+  "version": "1.2.0",
+  "message": "login attempt completed",
+  "traceId": "5cf03e4688c45eb7b4df030e1f1f5847",
+  "correlationId": "login-req-9f2a",
+  "request": {
+    "method": "POST",
+    "url": "/auth/login",
+    "status": 401,
+    "durationMs": 18,
+    "headers": {
+      "content-type": "application/json",
+      "user-agent": "Mozilla/5.0"
+    }
+  },
+  "error": null
+}

package/schemas/examples/valid/message-only.json

@@ -0,0 +1,9 @@
+{
+  "schemaVersion": "1.0",
+  "timestamp": "2026-10-30T22:17:00.000Z",
+  "level": "debug",
+  "service": "worker-billing",
+  "env": "staging",
+  "version": "1.0.0",
+  "message": "job started"
+}

package/schemas/examples/valid/request-completed.json

@@ -0,0 +1,36 @@
+{
+  "schemaVersion": "1.0",
+  "timestamp": "2026-10-30T22:15:03.512Z",
+  "level": "info",
+  "service": "app-web",
+  "env": "prod",
+  "version": "2.4.1",
+  "message": "request completed",
+  "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",
+  "correlationId": "c0a8012e-7f3d-4a8b-9b1e-2f6d5c3e9a10",
+  "request": {
+    "method": "POST",
+    "url": "/api/orders",
+    "status": 201,
+    "durationMs": 42,
+    "userId": "u_1234",
+    "headers": {
+      "user-agent": "Mozilla/5.0",
+      "content-type": "application/json"
+    },
+    "body": {
+      "productId": "P-88",
+      "quantity": 3,
+      "customer": {
+        "email": "[REDACTED]"
+      }
+    },
+    "bodyTruncated": false
+  },
+  "response": {
+    "body": {
+      "orderId": "O-5521"
+    }
+  },
+  "error": null
+}

package/schemas/log-event.schema.json

@@ -0,0 +1,157 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://nicomatic.local/schemas/log-event.schema.json",
+  "title": "Nicomatic unified log event",
+  "description": "Format JSON unifié des logs Nicomatic (schemaVersion 1.0). Voir docs/adr/0001-format-de-log-unifie.md.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "schemaVersion",
+    "timestamp",
+    "level",
+    "service",
+    "env",
+    "version",
+    "message"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "type": "string",
+      "const": "1.0",
+      "description": "Version du schéma de log (majeur.mineur)."
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Horodatage ISO 8601 en UTC (ex. 2026-10-30T22:15:03.512Z)."
+    },
+    "level": {
+      "type": "string",
+      "enum": ["trace", "debug", "info", "warn", "error", "fatal"]
+    },
+    "service": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Identifiant du service émetteur (label Loki)."
+    },
+    "env": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Environnement (ex. dev, staging, prod) — label Loki."
+    },
+    "version": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Version déployée du service."
+    },
+    "message": {
+      "type": "string",
+      "description": "Message humain court décrivant l'événement."
+    },
+    "traceId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Identifiant de trace (W3C trace-id ou équivalent)."
+    },
+    "correlationId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Identifiant de corrélation métier / requête."
+    },
+    "request": {
+      "$ref": "#/$defs/request"
+    },
+    "response": {
+      "$ref": "#/$defs/response"
+    },
+    "error": {
+      "oneOf": [
+        { "type": "null" },
+        { "$ref": "#/$defs/error" }
+      ]
+    }
+  },
+  "$defs": {
+    "request": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "method": {
+          "type": "string",
+          "minLength": 1
+        },
+        "url": {
+          "type": "string",
+          "minLength": 1
+        },
+        "status": {
+          "type": "integer",
+          "minimum": 100,
+          "maximum": 599
+        },
+        "durationMs": {
+          "type": "number",
+          "minimum": 0
+        },
+        "userId": {
+          "type": "string"
+        },
+        "headers": {
+          "type": "object",
+          "description": "Headers en liste blanche uniquement (jamais Authorization, Cookie, Set-Cookie).",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "propertyNames": {
+            "enum": [
+              "accept",
+              "accept-language",
+              "content-type",
+              "content-length",
+              "user-agent",
+              "x-request-id",
+              "x-forwarded-for",
+              "x-forwarded-proto",
+              "x-correlation-id",
+              "traceparent",
+              "tracestate"
+            ]
+          }
+        },
+        "body": true,
+        "bodyTruncated": {
+          "type": "boolean"
+        }
+      }
+    },
+    "response": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "body": true
+      }
+    },
+    "error": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "type": {
+          "type": "string"
+        },
+        "message": {
+          "type": "string"
+        },
+        "stack": {
+          "type": "string"
+        },
+        "code": {
+          "oneOf": [
+            { "type": "string" },
+            { "type": "number" }
+          ]
+        },
+        "cause": true
+      }
+    }
+  }
+}