@skediprof/telemetry 1.0.0

package/dist/_state.d.ts

@@ -0,0 +1,6 @@
+import type { NodeSDK } from '@opentelemetry/sdk-node';
+export declare function setSDK(instance: NodeSDK | null): void;
+export declare function getSDK(): NodeSDK | null;
+export declare function setInitialized(value: boolean): void;
+export declare function isInitialized(): boolean;
+//# sourceMappingURL=_state.d.ts.map

package/dist/_state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_state.d.ts","sourceRoot":"","sources":["../src/_state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAKvD,wBAAgB,MAAM,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAErD;AAED,wBAAgB,MAAM,IAAI,OAAO,GAAG,IAAI,CAEvC;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAEnD;AAED,wBAAgB,aAAa,IAAI,OAAO,CAEvC"}

package/dist/_state.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setSDK = setSDK;
+exports.getSDK = getSDK;
+exports.setInitialized = setInitialized;
+exports.isInitialized = isInitialized;
+let sdk = null;
+let initialized = false;
+function setSDK(instance) {
+    sdk = instance;
+}
+function getSDK() {
+    return sdk;
+}
+function setInitialized(value) {
+    initialized = value;
+}
+function isInitialized() {
+    return initialized;
+}
+//# sourceMappingURL=_state.js.map

package/dist/_state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_state.js","sourceRoot":"","sources":["../src/_state.ts"],"names":[],"mappings":";;AAOA,wBAEC;AAED,wBAEC;AAED,wCAEC;AAED,sCAEC;AAjBD,IAAI,GAAG,GAAmB,IAAI,CAAC;AAC/B,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB,SAAgB,MAAM,CAAC,QAAwB;IAC7C,GAAG,GAAG,QAAQ,CAAC;AACjB,CAAC;AAED,SAAgB,MAAM;IACpB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAgB,cAAc,CAAC,KAAc;IAC3C,WAAW,GAAG,KAAK,CAAC;AACtB,CAAC;AAED,SAAgB,aAAa;IAC3B,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,7 @@
+import type { TraceContext } from './types';
+/**
+ * Retorna o contexto de trace ativo (se houver).
+ * Usado para injetar traceId/spanId nos logs (Winston/Pino).
+ */
+export declare function getTraceContext(): TraceContext | null;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAcrD"}

package/dist/context.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTraceContext = getTraceContext;
+const api_1 = require("@opentelemetry/api");
+/**
+ * Retorna o contexto de trace ativo (se houver).
+ * Usado para injetar traceId/spanId nos logs (Winston/Pino).
+ */
+function getTraceContext() {
+    const span = api_1.trace.getActiveSpan();
+    if (!span)
+        return null;
+    const ctx = span.spanContext();
+    if (!ctx.traceId || ctx.traceId === '00000000000000000000000000000000') {
+        return null;
+    }
+    return {
+        traceId: ctx.traceId,
+        spanId: ctx.spanId,
+        traceFlags: ctx.traceFlags,
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":";;AAOA,0CAcC;AArBD,4CAA2C;AAG3C;;;GAGG;AACH,SAAgB,eAAe;IAC7B,MAAM,IAAI,GAAG,WAAK,CAAC,aAAa,EAAE,CAAC;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAC/B,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,KAAK,kCAAkC,EAAE,CAAC;QACvE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,UAAU,EAAE,GAAG,CAAC,UAAU;KAC3B,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { initTelemetry, withTelemetry } from './init';
+export { createCounter, createHistogram, createGauge } from './metrics';
+export { getTraceContext } from './context';
+export { shutdownTelemetry } from './shutdown';
+export type { TelemetryConfig, TraceContext } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shutdownTelemetry = exports.getTraceContext = exports.createGauge = exports.createHistogram = exports.createCounter = exports.withTelemetry = exports.initTelemetry = void 0;
+var init_1 = require("./init");
+Object.defineProperty(exports, "initTelemetry", { enumerable: true, get: function () { return init_1.initTelemetry; } });
+Object.defineProperty(exports, "withTelemetry", { enumerable: true, get: function () { return init_1.withTelemetry; } });
+var metrics_1 = require("./metrics");
+Object.defineProperty(exports, "createCounter", { enumerable: true, get: function () { return metrics_1.createCounter; } });
+Object.defineProperty(exports, "createHistogram", { enumerable: true, get: function () { return metrics_1.createHistogram; } });
+Object.defineProperty(exports, "createGauge", { enumerable: true, get: function () { return metrics_1.createGauge; } });
+var context_1 = require("./context");
+Object.defineProperty(exports, "getTraceContext", { enumerable: true, get: function () { return context_1.getTraceContext; } });
+var shutdown_1 = require("./shutdown");
+Object.defineProperty(exports, "shutdownTelemetry", { enumerable: true, get: function () { return shutdown_1.shutdownTelemetry; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,+BAAsD;AAA7C,qGAAA,aAAa,OAAA;AAAE,qGAAA,aAAa,OAAA;AACrC,qCAAwE;AAA/D,wGAAA,aAAa,OAAA;AAAE,0GAAA,eAAe,OAAA;AAAE,sGAAA,WAAW,OAAA;AACpD,qCAA4C;AAAnC,0GAAA,eAAe,OAAA;AACxB,uCAA+C;AAAtC,6GAAA,iBAAiB,OAAA"}

package/dist/init.d.ts

@@ -0,0 +1,11 @@
+import type { TelemetryConfig } from './types';
+/**
+ * Inicializa toda a stack de telemetria (traces + metrics).
+ * DEVE ser chamado ANTES de qualquer import de framework (Express, Firebase).
+ */
+export declare function initTelemetry(config: TelemetryConfig): void;
+/**
+ * Wrapper para Cloud Functions que faz init no cold start e flush apos cada invocacao.
+ */
+export declare function withTelemetry<TArgs extends unknown[], TReturn>(config: TelemetryConfig, handler: (...args: TArgs) => Promise<TReturn>): (...args: TArgs) => Promise<TReturn>;
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAM/C;;;GAGG;AAIH,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAqE3D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,SAAS,OAAO,EAAE,EACvB,OAAO,EAEP,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,GAC5C,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,CAetC"}

package/dist/init.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initTelemetry = initTelemetry;
+exports.withTelemetry = withTelemetry;
+const sdk_node_1 = require("@opentelemetry/sdk-node");
+const exporter_trace_otlp_http_1 = require("@opentelemetry/exporter-trace-otlp-http");
+const exporter_metrics_otlp_http_1 = require("@opentelemetry/exporter-metrics-otlp-http");
+const sdk_metrics_1 = require("@opentelemetry/sdk-metrics");
+const resources_1 = require("@opentelemetry/resources");
+const semantic_conventions_1 = require("@opentelemetry/semantic-conventions");
+const instrumentations_1 = require("./instrumentations");
+const _state_1 = require("./_state");
+const shutdown_1 = require("./shutdown");
+// AIDEV: OTLP/HTTP (not gRPC) — Cloud Functions kill persistent gRPC connections
+// on cold start. Do not switch to gRPC exporter. See ADR-002.
+const DEFAULT_ENDPOINT = 'https://otlp.nr-data.net:4318';
+/**
+ * Inicializa toda a stack de telemetria (traces + metrics).
+ * DEVE ser chamado ANTES de qualquer import de framework (Express, Firebase).
+ */
+// AIDEV: initTelemetry MUST be called before any Express/Firebase import.
+// OTel auto-instrumentation works via monkey-patching — if modules are
+// imported first, the patches don't apply.
+function initTelemetry(config) {
+    if ((0, _state_1.isInitialized)()) {
+        console.warn('[@skediprof/telemetry] Already initialized, skipping.');
+        return;
+    }
+    if (process.env.TELEMETRY_ENABLED === 'false') {
+        console.log('[@skediprof/telemetry] Disabled via TELEMETRY_ENABLED=false');
+        (0, _state_1.setInitialized)(true);
+        return;
+    }
+    const environment = config.environment || process.env.NODE_ENV || 'production';
+    const endpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT ||
+        config.otlpEndpoint ||
+        DEFAULT_ENDPOINT;
+    const apiKey = config.apiKey || process.env.NEW_RELIC_LICENSE_KEY;
+    const runtime = config.runtime || 'server';
+    const metricInterval = config.metricExportInterval || (runtime === 'function' ? 10000 : 60000);
+    if (!apiKey) {
+        console.warn('[@skediprof/telemetry] No API key found. Set NEW_RELIC_LICENSE_KEY or pass apiKey in config. Telemetry disabled.');
+        (0, _state_1.setInitialized)(true);
+        return;
+    }
+    // AIDEV: New Relic OTLP requires header 'api-key' (not 'Authorization: Bearer').
+    const headers = { 'api-key': apiKey };
+    const resource = (0, resources_1.resourceFromAttributes)({
+        [semantic_conventions_1.ATTR_SERVICE_NAME]: config.serviceName,
+        [semantic_conventions_1.ATTR_SERVICE_VERSION]: config.serviceVersion || '0.0.0',
+        [semantic_conventions_1.ATTR_DEPLOYMENT_ENVIRONMENT_NAME]: environment,
+    });
+    const traceExporter = new exporter_trace_otlp_http_1.OTLPTraceExporter({
+        url: `${endpoint}/v1/traces`,
+        headers,
+    });
+    const metricExporter = new exporter_metrics_otlp_http_1.OTLPMetricExporter({
+        url: `${endpoint}/v1/metrics`,
+        headers,
+    });
+    const metricReader = new sdk_metrics_1.PeriodicExportingMetricReader({
+        exporter: metricExporter,
+        exportIntervalMillis: metricInterval,
+    });
+    const sdk = new sdk_node_1.NodeSDK({
+        resource,
+        traceExporter,
+        metricReader,
+        instrumentations: (0, instrumentations_1.buildInstrumentations)(config),
+    });
+    sdk.start();
+    (0, _state_1.setSDK)(sdk);
+    (0, _state_1.setInitialized)(true);
+    console.log(`[@skediprof/telemetry] Initialized for "${config.serviceName}" (${runtime}/${environment})`);
+}
+/**
+ * Wrapper para Cloud Functions que faz init no cold start e flush apos cada invocacao.
+ */
+function withTelemetry(config, handler) {
+    const functionConfig = {
+        ...config,
+        runtime: 'function',
+        metricExportInterval: config.metricExportInterval || 10000,
+    };
+    return async (...args) => {
+        initTelemetry(functionConfig);
+        try {
+            return await handler(...args);
+        }
+        finally {
+            await (0, shutdown_1.shutdownTelemetry)();
+        }
+    };
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"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"}

package/dist/instrumentations.d.ts

@@ -0,0 +1,6 @@
+import { HttpInstrumentation } from '@opentelemetry/instrumentation-http';
+import { ExpressInstrumentation } from '@opentelemetry/instrumentation-express';
+import { GrpcInstrumentation } from '@opentelemetry/instrumentation-grpc';
+import type { TelemetryConfig } from './types';
+export declare function buildInstrumentations(config: TelemetryConfig): (HttpInstrumentation | ExpressInstrumentation | GrpcInstrumentation)[];
+//# sourceMappingURL=instrumentations.d.ts.map

package/dist/instrumentations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentations.d.ts","sourceRoot":"","sources":["../src/instrumentations.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,0EAsB5D"}

package/dist/instrumentations.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildInstrumentations = buildInstrumentations;
+// AIDEV: Health check endpoints (/health, /ping) are filtered from HTTP
+// instrumentation to reduce trace noise — same pattern as whatsapp-bot's newrelic.js.
+const instrumentation_http_1 = require("@opentelemetry/instrumentation-http");
+const instrumentation_express_1 = require("@opentelemetry/instrumentation-express");
+const instrumentation_grpc_1 = require("@opentelemetry/instrumentation-grpc");
+function buildInstrumentations(config) {
+    const instrumentations = [];
+    if (config.autoInstrumentHttp !== false) {
+        instrumentations.push(new instrumentation_http_1.HttpInstrumentation({
+            ignoreIncomingRequestHook: (req) => {
+                const url = req.url || '';
+                return url === '/health' || url === '/ping';
+            },
+        }));
+        instrumentations.push(new instrumentation_express_1.ExpressInstrumentation());
+    }
+    if (config.autoInstrumentFirestore !== false) {
+        // AIDEV: Firestore uses gRPC internally — instrumenting gRPC captures
+        // Firestore operations as spans (rpc.service = google.firestore.v1.Firestore).
+        instrumentations.push(new instrumentation_grpc_1.GrpcInstrumentation());
+    }
+    return instrumentations;
+}
+//# sourceMappingURL=instrumentations.js.map

package/dist/instrumentations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentations.js","sourceRoot":"","sources":["../src/instrumentations.ts"],"names":[],"mappings":";;AAOA,sDAsBC;AA7BD,wEAAwE;AACxE,sFAAsF;AACtF,8EAA0E;AAC1E,oFAAgF;AAChF,8EAA0E;AAG1E,SAAgB,qBAAqB,CAAC,MAAuB;IAC3D,MAAM,gBAAgB,GAAG,EAAE,CAAC;IAE5B,IAAI,MAAM,CAAC,kBAAkB,KAAK,KAAK,EAAE,CAAC;QACxC,gBAAgB,CAAC,IAAI,CACnB,IAAI,0CAAmB,CAAC;YACtB,yBAAyB,EAAE,CAAC,GAAG,EAAE,EAAE;gBACjC,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC;gBAC1B,OAAO,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,OAAO,CAAC;YAC9C,CAAC;SACF,CAAC,CACH,CAAC;QACF,gBAAgB,CAAC,IAAI,CAAC,IAAI,gDAAsB,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,MAAM,CAAC,uBAAuB,KAAK,KAAK,EAAE,CAAC;QAC7C,sEAAsE;QACtE,+EAA+E;QAC/E,gBAAgB,CAAC,IAAI,CAAC,IAAI,0CAAmB,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC"}

package/dist/metrics.d.ts

@@ -0,0 +1,19 @@
+import type { Counter, Histogram, ObservableGauge } from '@opentelemetry/api';
+/**
+ * Cria um contador (incrementa monotonicamente).
+ * Ex: total de aulas criadas, mensagens enviadas.
+ *
+ * Convencao de nome: skedi.<dominio>.<metrica>
+ */
+export declare function createCounter(name: string, description: string): Counter;
+/**
+ * Cria um histograma (distribuicao de valores).
+ * Ex: latencia de API, tamanho de payload.
+ */
+export declare function createHistogram(name: string, description: string, unit?: string): Histogram;
+/**
+ * Cria um gauge observavel (valor instantaneo via callback).
+ * Uso: gauge.addCallback((result) => result.observe(valor, atributos));
+ */
+export declare function createGauge(name: string, description: string): ObservableGauge;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAS9E;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAExE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,MAAM,GACZ,SAAS,CAEX;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,eAAe,CAEjB"}

package/dist/metrics.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCounter = createCounter;
+exports.createHistogram = createHistogram;
+exports.createGauge = createGauge;
+const api_1 = require("@opentelemetry/api");
+const METER_NAME = '@skediprof/telemetry';
+const METER_VERSION = '1.0.0';
+function getMeter() {
+    return api_1.metrics.getMeter(METER_NAME, METER_VERSION);
+}
+/**
+ * Cria um contador (incrementa monotonicamente).
+ * Ex: total de aulas criadas, mensagens enviadas.
+ *
+ * Convencao de nome: skedi.<dominio>.<metrica>
+ */
+function createCounter(name, description) {
+    return getMeter().createCounter(name, { description });
+}
+/**
+ * Cria um histograma (distribuicao de valores).
+ * Ex: latencia de API, tamanho de payload.
+ */
+function createHistogram(name, description, unit) {
+    return getMeter().createHistogram(name, { description, unit });
+}
+/**
+ * Cria um gauge observavel (valor instantaneo via callback).
+ * Uso: gauge.addCallback((result) => result.observe(valor, atributos));
+ */
+function createGauge(name, description) {
+    return getMeter().createObservableGauge(name, { description });
+}
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":";;AAgBA,sCAEC;AAMD,0CAMC;AAMD,kCAKC;AAzCD,4CAA6C;AAG7C,MAAM,UAAU,GAAG,sBAAsB,CAAC;AAC1C,MAAM,aAAa,GAAG,OAAO,CAAC;AAE9B,SAAS,QAAQ;IACf,OAAO,aAAO,CAAC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AACrD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,IAAY,EAAE,WAAmB;IAC7D,OAAO,QAAQ,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAC7B,IAAY,EACZ,WAAmB,EACnB,IAAa;IAEb,OAAO,QAAQ,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,SAAgB,WAAW,CACzB,IAAY,EACZ,WAAmB;IAEnB,OAAO,QAAQ,EAAE,CAAC,qBAAqB,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;AACjE,CAAC"}

package/dist/shutdown.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Faz flush de todos os spans/metricas pendentes e encerra exporters.
+ * CRITICO para Cloud Functions — sem isso, dados podem ser perdidos.
+ *
+ * Timeout padrao: 5000ms (evita travar o shutdown do processo).
+ */
+export declare function shutdownTelemetry(): Promise<void>;
+//# sourceMappingURL=shutdown.d.ts.map

package/dist/shutdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../src/shutdown.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AAKH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAsBvD"}

package/dist/shutdown.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shutdownTelemetry = shutdownTelemetry;
+const _state_1 = require("./_state");
+const SHUTDOWN_TIMEOUT_MS = 5000;
+/**
+ * Faz flush de todos os spans/metricas pendentes e encerra exporters.
+ * CRITICO para Cloud Functions — sem isso, dados podem ser perdidos.
+ *
+ * Timeout padrao: 5000ms (evita travar o shutdown do processo).
+ */
+// AIDEV: shutdownTelemetry MUST reset initialized state so that withTelemetry
+// can re-init on Cloud Function warm starts. Without this, the second invocation
+// on a warm instance would skip init (isInitialized=true) but the SDK is already
+// shut down, resulting in zero telemetry.
+async function shutdownTelemetry() {
+    const sdk = (0, _state_1.getSDK)();
+    if (!sdk || !(0, _state_1.isInitialized)()) {
+        return;
+    }
+    try {
+        await Promise.race([
+            sdk.shutdown(),
+            new Promise((_, reject) => setTimeout(() => reject(new Error('Shutdown timed out')), SHUTDOWN_TIMEOUT_MS)),
+        ]);
+    }
+    catch (err) {
+        console.error('[@skediprof/telemetry] Shutdown error:', err);
+    }
+    finally {
+        (0, _state_1.setSDK)(null);
+        (0, _state_1.setInitialized)(false);
+    }
+}
+//# sourceMappingURL=shutdown.js.map

package/dist/shutdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.js","sourceRoot":"","sources":["../src/shutdown.ts"],"names":[],"mappings":";;AAcA,8CAsBC;AApCD,qCAAyE;AAEzE,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAEjC;;;;;GAKG;AACH,8EAA8E;AAC9E,iFAAiF;AACjF,iFAAiF;AACjF,0CAA0C;AACnC,KAAK,UAAU,iBAAiB;IACrC,MAAM,GAAG,GAAG,IAAA,eAAM,GAAE,CAAC;IACrB,IAAI,CAAC,GAAG,IAAI,CAAC,IAAA,sBAAa,GAAE,EAAE,CAAC;QAC7B,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,CAAC;YACjB,GAAG,CAAC,QAAQ,EAAE;YACd,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAC9B,UAAU,CACR,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC,EAC7C,mBAAmB,CACpB,CACF;SACF,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,GAAG,CAAC,CAAC;IAC/D,CAAC;YAAS,CAAC;QACT,IAAA,eAAM,EAAC,IAAI,CAAC,CAAC;QACb,IAAA,uBAAc,EAAC,KAAK,CAAC,CAAC;IACxB,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,53 @@
+export interface TelemetryConfig {
+    /**
+     * Nome do servico (aparece no New Relic como entity name).
+     * Ex: 'zico', 'skedi-students-imdb', 'ms-skedi-notifications'
+     */
+    serviceName: string;
+    /**
+     * Versao do servico (opcional). Default: '0.0.0'
+     */
+    serviceVersion?: string;
+    /**
+     * Ambiente: 'production' | 'development' | 'staging'
+     * Default: process.env.NODE_ENV || 'production'
+     */
+    environment?: string;
+    /**
+     * Endpoint OTLP. Default: 'https://otlp.nr-data.net:4318'
+     * Sobrescrito por OTEL_EXPORTER_OTLP_ENDPOINT se definido.
+     */
+    otlpEndpoint?: string;
+    /**
+     * API key do New Relic. Default: process.env.NEW_RELIC_LICENSE_KEY
+     */
+    apiKey?: string;
+    /**
+     * Habilitar auto-instrumentation de HTTP/Express.
+     * Default: true
+     */
+    autoInstrumentHttp?: boolean;
+    /**
+     * Habilitar auto-instrumentation de Firestore/gRPC.
+     * Default: true
+     */
+    autoInstrumentFirestore?: boolean;
+    /**
+     * Tipo de runtime (afeta estrategia de flush/shutdown).
+     * - 'server': Cloud Run, servidor persistente (flush periodico)
+     * - 'function': Cloud Functions (flush agressivo a cada invocacao)
+     * Default: 'server'
+     */
+    runtime?: 'server' | 'function';
+    /**
+     * Intervalo de export de metricas em ms.
+     * Default: 60000 (1 min) para server, 10000 (10s) para function
+     */
+    metricExportInterval?: number;
+}
+export interface TraceContext {
+    traceId: string;
+    spanId: string;
+    traceFlags: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IAEhC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@skediprof/telemetry",
+  "version": "1.0.0",
+  "description": "Shared OpenTelemetry library for Skedi microservices",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.218.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.218.0",
+    "@opentelemetry/instrumentation-express": "^0.66.0",
+    "@opentelemetry/instrumentation-grpc": "^0.218.0",
+    "@opentelemetry/instrumentation-http": "^0.218.0",
+    "@opentelemetry/resources": "^2.7.1",
+    "@opentelemetry/sdk-metrics": "^2.7.1",
+    "@opentelemetry/sdk-node": "^0.218.0",
+    "@opentelemetry/sdk-trace-node": "^2.7.1",
+    "@opentelemetry/semantic-conventions": "^1.29.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.16",
+    "typescript": "^5.4.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Skedi-Prof/otel-skedi-lib.git"
+  }
+}