@generazioneai/telemetry 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog — @generazioneai/telemetry
 
+## 0.2.0 — 2026-11-10
+
+«Via gli interruttori» (decisione del 2026-11-10): niente `TELEMETRY_MODE`, la telemetria è accesa se c'è un endpoint
+(`OTEL_EXPORTER_OTLP_ENDPOINT`, di serie il collector del cluster; vuota = spenta). In sviluppo locale l'endpoint di serie è vuoto e
+`TELEMETRY_MODE=off` conta ancora; altrove si ignora con un avviso. **Non pubblicata.**
+
 ## 0.1.0 — 2026-10-25
 Prima versione (treno 3+4, O1; ADR-013, spec «Fondamenta enterprise» §5.2, decisioni 31, 32, 35).
 - `@generazioneai/telemetry/register`: SDK OpenTelemetry Node (tracce e metriche OTLP/HTTP; HTTP, pg, ioredis, Prisma), spento di serie (`TELEMETRY_MODE=off`).

package/README.md

@@ -20,8 +20,8 @@ TelemetryModule.forRoot({ service: 'hr' })
 
 | Variabile | Valori | Di serie |
 |---|---|---|
-| `TELEMETRY_MODE` | `off` \| `on` | `off`: il processo non carica l'SDK, nessuna connessione |
-| `OTEL_EXPORTER_OTLP_ENDPOINT` | base OTLP/HTTP | `http://otel-collector.observability:4318`; **vuota = spento** |
+| `OTEL_EXPORTER_OTLP_ENDPOINT` | base OTLP/HTTP | `http://otel-collector.observability:4318` (in sviluppo locale: vuota); **vuota = spento** (il processo non carica l'SDK, nessuna connessione) |
+| `TELEMETRY_MODE` | `on` | 0.2 (decisione del 2026-11-10): accesa se c'è l'endpoint. `off` conta solo in sviluppo locale e nei test (`SKILLERA_ENV` `dev`/`local` o `NODE_ENV` `development`/`test`, fuori da un cluster); altrove si ignora con un avviso |
 | `OTEL_SERVICE_NAME` | nome | `name` del `package.json` (senza scope) |
 | `SKILLERA_ENV` | | → `deployment.environment` |
 | `LOG_FORMAT` | `text` \| `json` | `text` |

package/dist/config.d.ts

@@ -9,8 +9,10 @@ export interface TelemetryConfig {
     metricIntervalMs: number;
 }
 /**
- * - `TELEMETRY_MODE=on` accende (di serie `off`: il processo non carica nulla, non apre connessioni);
- * - `OTEL_EXPORTER_OTLP_ENDPOINT`: base OTLP/HTTP (di serie quella del collector nel cluster); **vuota = spento**;
+ * 0.2 (via gli interruttori, 2026-11-10): accesa se c'è dove mandare (un endpoint), senza interruttore.
+ * - `OTEL_EXPORTER_OTLP_ENDPOINT`: base OTLP/HTTP; **vuota = spento** (il processo non carica nulla, non apre connessioni).
+ *   Di serie quella del collector nel cluster; in sviluppo locale (`isLocalDevEnv`) di serie vuota, cioè spenta;
+ * - `TELEMETRY_MODE=off` spegne solo in sviluppo locale e nei test; altrove si ignora con un avviso;
  * - `OTEL_SERVICE_NAME`, altrimenti il `name` del `package.json` del processo;
  * - `SKILLERA_ENV` → `deployment.environment`;
  * - `TELEMETRY_SAMPLE_RATIO` (0..1, di serie 1: il campionamento in coda lo fa il collector);

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,qBAAqB,6CAA6C,CAAC;AAEhF,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAWD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,eAAe,CAahF"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qBAAqB,6CAA6C,CAAC;AAEhF,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAWD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,eAAe,CAehF"}

package/dist/config.js

@@ -4,6 +4,7 @@ exports.DEFAULT_OTLP_ENDPOINT = void 0;
 exports.readConfig = readConfig;
 const fs_1 = require("fs");
 const path_1 = require("path");
+const final_mode_1 = require("./final-mode");
 exports.DEFAULT_OTLP_ENDPOINT = 'http://otel-collector.observability:4318';
 function packageName() {
     try {
@@ -15,8 +16,10 @@ function packageName() {
     }
 }
 /**
- * - `TELEMETRY_MODE=on` accende (di serie `off`: il processo non carica nulla, non apre connessioni);
- * - `OTEL_EXPORTER_OTLP_ENDPOINT`: base OTLP/HTTP (di serie quella del collector nel cluster); **vuota = spento**;
+ * 0.2 (via gli interruttori, 2026-11-10): accesa se c'è dove mandare (un endpoint), senza interruttore.
+ * - `OTEL_EXPORTER_OTLP_ENDPOINT`: base OTLP/HTTP; **vuota = spento** (il processo non carica nulla, non apre connessioni).
+ *   Di serie quella del collector nel cluster; in sviluppo locale (`isLocalDevEnv`) di serie vuota, cioè spenta;
+ * - `TELEMETRY_MODE=off` spegne solo in sviluppo locale e nei test; altrove si ignora con un avviso;
  * - `OTEL_SERVICE_NAME`, altrimenti il `name` del `package.json` del processo;
  * - `SKILLERA_ENV` → `deployment.environment`;
  * - `TELEMETRY_SAMPLE_RATIO` (0..1, di serie 1: il campionamento in coda lo fa il collector);
@@ -24,10 +27,12 @@ function packageName() {
  */
 function readConfig(env = process.env) {
     const rawEndpoint = env.OTEL_EXPORTER_OTLP_ENDPOINT;
-    const endpoint = (rawEndpoint === undefined ? exports.DEFAULT_OTLP_ENDPOINT : rawEndpoint).trim().replace(/\/+$/, '');
+    const fallback = (0, final_mode_1.isLocalDevEnv)(env) ? '' : exports.DEFAULT_OTLP_ENDPOINT;
+    const endpoint = (rawEndpoint === undefined ? fallback : rawEndpoint).trim().replace(/\/+$/, '');
     const ratio = Number(env.TELEMETRY_SAMPLE_RATIO ?? '1');
+    const mode = (0, final_mode_1.finalMode)({ name: 'TELEMETRY_MODE', final: 'on', allowed: ['on', 'off'], requested: env.TELEMETRY_MODE, env });
     return {
-        enabled: (env.TELEMETRY_MODE ?? 'off').toLowerCase() === 'on' && endpoint !== '',
+        enabled: mode === 'on' && endpoint !== '',
         endpoint,
         serviceName: env.OTEL_SERVICE_NAME?.trim() || packageName() || 'unknown-service',
         environment: env.SKILLERA_ENV,

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;AAgCA,gCAaC;AA7CD,2BAAkC;AAClC,+BAA4B;AAEf,QAAA,qBAAqB,GAAG,0CAA0C,CAAC;AAYhF,SAAS,WAAW;IAClB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,IAAA,WAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAA0B,CAAC;QAC9G,OAAO,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC7D,MAAM,WAAW,GAAG,GAAG,CAAC,2BAA2B,CAAC;IACpD,MAAM,QAAQ,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,6BAAqB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC9G,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,sBAAsB,IAAI,GAAG,CAAC,CAAC;IACxD,OAAO;QACL,OAAO,EAAE,CAAC,GAAG,CAAC,cAAc,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,KAAK,IAAI,IAAI,QAAQ,KAAK,EAAE;QAChF,QAAQ;QACR,WAAW,EAAE,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,IAAI,WAAW,EAAE,IAAI,iBAAiB;QAChF,WAAW,EAAE,GAAG,CAAC,YAAY;QAC7B,cAAc,EAAE,GAAG,CAAC,mBAAmB;QACvC,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzE,gBAAgB,EAAE,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC,MAAM;KACjH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;AAmCA,gCAeC;AAlDD,2BAAkC;AAClC,+BAA4B;AAC5B,6CAAwD;AAE3C,QAAA,qBAAqB,GAAG,0CAA0C,CAAC;AAYhF,SAAS,WAAW;IAClB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,IAAA,WAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAA0B,CAAC;QAC9G,OAAO,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC7D,MAAM,WAAW,GAAG,GAAG,CAAC,2BAA2B,CAAC;IACpD,MAAM,QAAQ,GAAG,IAAA,0BAAa,EAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,6BAAqB,CAAC;IACjE,MAAM,QAAQ,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACjG,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,sBAAsB,IAAI,GAAG,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,IAAA,sBAAS,EAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,CAAU,EAAE,SAAS,EAAE,GAAG,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC;IACrI,OAAO;QACL,OAAO,EAAE,IAAI,KAAK,IAAI,IAAI,QAAQ,KAAK,EAAE;QACzC,QAAQ;QACR,WAAW,EAAE,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,IAAI,WAAW,EAAE,IAAI,iBAAiB;QAChF,WAAW,EAAE,GAAG,CAAC,YAAY;QAC7B,cAAc,EAAE,GAAG,CAAC,mBAAmB;QACvC,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzE,gBAAgB,EAAE,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC,MAAM;KACjH,CAAC;AACJ,CAAC"}

package/dist/final-mode.d.ts

@@ -0,0 +1,23 @@
+/** `true` solo in sviluppo locale o nei test: l'unico caso in cui le vecchie modalità contano ancora. */
+export declare function isLocalDevEnv(env?: NodeJS.ProcessEnv): boolean;
+export interface FinalModeOptions<T extends string> {
+    /** Nome della variabile (per l'avviso). */
+    name: string;
+    /** Il valore finale, quello che vale fuori dallo sviluppo locale. */
+    final: T;
+    /** I valori che lo sviluppo locale può ancora chiedere (il finale compreso). */
+    allowed: readonly T[];
+    /** Il valore chiesto (opzione o env); vuoto/assente = il finale. */
+    requested?: string | null;
+    env?: NodeJS.ProcessEnv;
+    /** Default `console.warn`. */
+    warn?: (message: string) => void;
+}
+/** Per i test: dimentica gli avvisi già dati. */
+export declare function resetFinalModeWarnings(): void;
+/**
+ * Il valore effettivo di una vecchia modalità: il finale, tranne in sviluppo locale dove si rispetta il valore chiesto (se è
+ * uno degli ammessi). Un valore sconosciuto o fuori posto non fa mai fallire l'avvio: vale il finale, con un avviso.
+ */
+export declare function finalMode<T extends string>(o: FinalModeOptions<T>): T;
+//# sourceMappingURL=final-mode.d.ts.map

package/dist/final-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"final-mode.d.ts","sourceRoot":"","sources":["../src/final-mode.ts"],"names":[],"mappings":"AAYA,yGAAyG;AACzG,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAM3E;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM;IAChD,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,KAAK,EAAE,CAAC,CAAC;IACT,gFAAgF;IAChF,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;IACtB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAID,iDAAiD;AACjD,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAQD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,CAmBrE"}

package/dist/final-mode.js

@@ -0,0 +1,56 @@
+"use strict";
+// Valori finali fissi delle vecchie modalità di rilascio (decisione del CTO del 2026-11-10, «via gli interruttori»).
+//
+// Le variabili che sceglievano off/log/shadow/enforce (AUTHZ_ENFORCE_MODE, AUTHZ_INTERNAL_AUTH_MODE, AUTHZ_KEY_POLICY, …) non
+// scelgono più nulla: vale sempre il comportamento finale. Resta UNA via di fuga, solo per lo sviluppo locale e i test
+// (D-E del censimento): lì il valore dell'env (o dell'opzione) si rispetta ancora. In ogni altro ambiente un valore diverso
+// dal finale si ignora con un avviso, una volta per variabile e valore: mai un crash all'avvio.
+//
+// Sviluppo locale = nessun `KUBERNETES_SERVICE_HOST` (mai dentro un cluster) E (`SKILLERA_ENV` è `dev`/`local`, oppure
+// `SKILLERA_ENV` manca e `NODE_ENV` è `development`/`test`). Uno `SKILLERA_ENV` diverso (stg, prod, …) chiude sempre la via.
+//
+// Copia identica in authz, gateway-kit, events, telemetry e crypto (pacchetti pubblicati a parte, senza dipendenze fra loro).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLocalDevEnv = isLocalDevEnv;
+exports.resetFinalModeWarnings = resetFinalModeWarnings;
+exports.finalMode = finalMode;
+/** `true` solo in sviluppo locale o nei test: l'unico caso in cui le vecchie modalità contano ancora. */
+function isLocalDevEnv(env = process.env) {
+    if ((env.KUBERNETES_SERVICE_HOST ?? '').trim())
+        return false;
+    const skilleraEnv = (env.SKILLERA_ENV ?? '').trim().toLowerCase();
+    if (skilleraEnv)
+        return skilleraEnv === 'dev' || skilleraEnv === 'local';
+    const nodeEnv = (env.NODE_ENV ?? '').trim().toLowerCase();
+    return nodeEnv === 'development' || nodeEnv === 'test';
+}
+const warned = new Set();
+/** Per i test: dimentica gli avvisi già dati. */
+function resetFinalModeWarnings() {
+    warned.clear();
+}
+function warnOnce(key, message, warn) {
+    if (warned.has(key))
+        return;
+    warned.add(key);
+    (warn ?? ((m) => console.warn(m)))(message);
+}
+/**
+ * Il valore effettivo di una vecchia modalità: il finale, tranne in sviluppo locale dove si rispetta il valore chiesto (se è
+ * uno degli ammessi). Un valore sconosciuto o fuori posto non fa mai fallire l'avvio: vale il finale, con un avviso.
+ */
+function finalMode(o) {
+    const raw = (o.requested ?? '').toString().trim().toLowerCase();
+    if (!raw || raw === o.final)
+        return o.final;
+    const env = o.env ?? process.env;
+    if (!o.allowed.includes(raw)) {
+        warnOnce(`${o.name}|${raw}`, `[via-interruttori] ${o.name}=«${raw}» sconosciuto: vale «${o.final}» (ammessi solo in sviluppo locale: ${o.allowed.join(', ')})`, o.warn);
+        return o.final;
+    }
+    if (isLocalDevEnv(env))
+        return raw;
+    warnOnce(`${o.name}|${raw}`, `[via-interruttori] ${o.name}=«${raw}» ignorato: fuori dallo sviluppo locale vale sempre «${o.final}» (decisione 2026-11-10, via gli interruttori)`, o.warn);
+    return o.final;
+}
+//# sourceMappingURL=final-mode.js.map

package/dist/final-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"final-mode.js","sourceRoot":"","sources":["../src/final-mode.ts"],"names":[],"mappings":";AAAA,qHAAqH;AACrH,EAAE;AACF,8HAA8H;AAC9H,uHAAuH;AACvH,4HAA4H;AAC5H,gGAAgG;AAChG,EAAE;AACF,uHAAuH;AACvH,6HAA6H;AAC7H,EAAE;AACF,8HAA8H;;AAG9H,sCAMC;AAmBD,wDAEC;AAYD,8BAmBC;AA3DD,yGAAyG;AACzG,SAAgB,aAAa,CAAC,MAAyB,OAAO,CAAC,GAAG;IAChE,IAAI,CAAC,GAAG,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QAAE,OAAO,KAAK,CAAC;IAC7D,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClE,IAAI,WAAW;QAAE,OAAO,WAAW,KAAK,KAAK,IAAI,WAAW,KAAK,OAAO,CAAC;IACzE,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1D,OAAO,OAAO,KAAK,aAAa,IAAI,OAAO,KAAK,MAAM,CAAC;AACzD,CAAC;AAgBD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;AAEjC,iDAAiD;AACjD,SAAgB,sBAAsB;IACpC,MAAM,CAAC,KAAK,EAAE,CAAC;AACjB,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW,EAAE,OAAe,EAAE,IAA0B;IACxE,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO;IAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC,IAAI,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,SAAgB,SAAS,CAAmB,CAAsB;IAChE,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChE,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC,KAAK,CAAC;IAC5C,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACjC,IAAI,CAAE,CAAC,CAAC,OAA6B,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACpD,QAAQ,CACN,GAAG,CAAC,CAAC,IAAI,IAAI,GAAG,EAAE,EAClB,sBAAsB,CAAC,CAAC,IAAI,KAAK,GAAG,wBAAwB,CAAC,CAAC,KAAK,uCAAuC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EACjI,CAAC,CAAC,IAAI,CACP,CAAC;QACF,OAAO,CAAC,CAAC,KAAK,CAAC;IACjB,CAAC;IACD,IAAI,aAAa,CAAC,GAAG,CAAC;QAAE,OAAO,GAAQ,CAAC;IACxC,QAAQ,CACN,GAAG,CAAC,CAAC,IAAI,IAAI,GAAG,EAAE,EAClB,sBAAsB,CAAC,CAAC,IAAI,KAAK,GAAG,wDAAwD,CAAC,CAAC,KAAK,gDAAgD,EACnJ,CAAC,CAAC,IAAI,CACP,CAAC;IACF,OAAO,CAAC,CAAC,KAAK,CAAC;AACjB,CAAC"}

package/dist/register.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.telemetry = void 0;
 /**
- * `import '@generazioneai/telemetry/register';` come PRIMA riga di `main.ts`. Con `TELEMETRY_MODE=off` (di serie) non fa nulla.
+ * `import '@generazioneai/telemetry/register';` come PRIMA riga di `main.ts`. Senza endpoint (`OTEL_EXPORTER_OTLP_ENDPOINT` vuota, o in sviluppo locale senza la variabile) non fa nulla.
  * Non installa gestori di segnali: lo spegnimento ordinato lo fa `TelemetryModule` (o `beforeExit`).
  */
 const sdk_1 = require("./sdk");

package/dist/sdk.d.ts

@@ -8,7 +8,7 @@ export interface TelemetryHandle {
     shutdown(): Promise<void>;
 }
 /**
- * Avvia l'SDK se la configurazione lo chiede (`TELEMETRY_MODE=on` e un endpoint). Idempotente. Va chiamato prima che
+ * Avvia l'SDK se la configurazione lo chiede (un endpoint; `TELEMETRY_MODE=off` conta solo in sviluppo locale). Idempotente. Va chiamato prima che
  * l'applicazione carichi `http`, `pg`, `ioredis`: per questo `@generazioneai/telemetry/register` è il primo import di `main.ts`.
  * Tutti gli span passano dal `SanitizingSpanExporter` (lista bianca degli attributi) prima di uscire.
  */

package/dist/sdk.js

@@ -26,7 +26,7 @@ function optional(load) {
     }
 }
 /**
- * Avvia l'SDK se la configurazione lo chiede (`TELEMETRY_MODE=on` e un endpoint). Idempotente. Va chiamato prima che
+ * Avvia l'SDK se la configurazione lo chiede (un endpoint; `TELEMETRY_MODE=off` conta solo in sviluppo locale). Idempotente. Va chiamato prima che
  * l'applicazione carichi `http`, `pg`, `ioredis`: per questo `@generazioneai/telemetry/register` è il primo import di `main.ts`.
  * Tutti gli span passano dal `SanitizingSpanExporter` (lista bianca degli attributi) prima di uscire.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@generazioneai/telemetry",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Osservabilità comune dei servizi Node (ADR-013): OpenTelemetry con esportazione OTLP, JsonLogger con trace_id, span dei comandi NATS con traceparent negli header, attributi a lista bianca e redazione dei dati personali.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",