@ciq-dev/neoiq-foundation-node 1.0.0 → 1.0.1-beta.0

package/dist/observability.js

@@ -1,246 +0,0 @@
-"use strict";
-/**
- * OpenTelemetry initialization for Node.js services.
- *
- * Follows Groundcover Integration Guide - Option 2 (Via OTEL Collector)
- *
- * Flow: App → OpenTelemetry SDK → OTEL Collector → Groundcover
- *
- * Environment Variables:
- *   OTEL_EXPORTER_OTLP_ENDPOINT: Collector URL (default: cluster OTEL Collector)
- *   OTEL_SERVICE_NAME: Service name
- *   OTEL_SERVICE_VERSION: Service version (default: 1.0.0)
- *   OTEL_ENVIRONMENT: Deployment environment (default: development)
- *
- * Usage:
- *   import { init, logger, getMeter } from '@commerceiq/neoiq-foundation-node';
- *
- *   init({ serviceName: 'my-service' });
- *
- *   logger.info({ action: 'startup' }, 'Service started');
- *
- *   const meter = getMeter('my-service');
- *   const counter = meter.createCounter('requests_total');
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SpanStatusCode = exports.logger = exports.als = void 0;
-exports.init = init;
-exports.getTracer = getTracer;
-exports.getMeter = getMeter;
-exports.getRequestContext = getRequestContext;
-exports.runWithContext = runWithContext;
-exports.getTraceContext = getTraceContext;
-exports.shutdown = shutdown;
-const sdk_node_1 = require("@opentelemetry/sdk-node");
-const auto_instrumentations_node_1 = require("@opentelemetry/auto-instrumentations-node");
-const exporter_trace_otlp_grpc_1 = require("@opentelemetry/exporter-trace-otlp-grpc");
-const exporter_metrics_otlp_grpc_1 = require("@opentelemetry/exporter-metrics-otlp-grpc");
-const sdk_metrics_1 = require("@opentelemetry/sdk-metrics");
-const resources_1 = require("@opentelemetry/resources");
-const semantic_conventions_1 = require("@opentelemetry/semantic-conventions");
-const api_1 = require("@opentelemetry/api");
-Object.defineProperty(exports, "SpanStatusCode", { enumerable: true, get: function () { return api_1.SpanStatusCode; } });
-const pino_1 = __importDefault(require("pino"));
-const async_hooks_1 = require("async_hooks");
-// -----------------------------------------------------------------------------
-// Configuration
-// -----------------------------------------------------------------------------
-// Default OTEL Collector endpoint (per Groundcover guide - Kubernetes internal)
-const DEFAULT_OTEL_COLLECTOR = 'http://otel-stack-deployment-collector.observability.svc.cluster.local:4317';
-exports.als = new async_hooks_1.AsyncLocalStorage();
-// -----------------------------------------------------------------------------
-// Module State
-// -----------------------------------------------------------------------------
-let sdk = null;
-let meterProvider = null;
-let baseLogger;
-let serviceName = 'unknown';
-let initialized = false;
-// -----------------------------------------------------------------------------
-// Initialization
-// -----------------------------------------------------------------------------
-/**
- * Initialize OpenTelemetry SDK with traces and metrics.
- *
- * Sends telemetry to OTEL Collector which forwards to Groundcover.
- * Call this at the very start of your application, before other imports.
- *
- * @example
- *   init({ serviceName: 'canvas-weaver' });
- */
-function init(options) {
-    if (initialized) {
-        console.warn('[neoiq-foundation-node] Already initialized, skipping...');
-        return;
-    }
-    const { serviceName: svcName, serviceVersion = process.env.OTEL_SERVICE_VERSION || '1.0.0', environment = process.env.OTEL_ENVIRONMENT || 'development', otlpEndpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT || DEFAULT_OTEL_COLLECTOR, logLevel = process.env.LOG_LEVEL || 'info', metricsIntervalMs = 5000, // 5 seconds per Groundcover guide
-     } = options;
-    serviceName = svcName;
-    // 1. Create Resource (attached to all telemetry)
-    const resource = (0, resources_1.resourceFromAttributes)({
-        [semantic_conventions_1.ATTR_SERVICE_NAME]: serviceName,
-        [semantic_conventions_1.ATTR_SERVICE_VERSION]: serviceVersion,
-        'deployment.environment': environment,
-    });
-    // 2. Setup Metrics Exporter (per Groundcover guide)
-    const metricExporter = new exporter_metrics_otlp_grpc_1.OTLPMetricExporter({ url: otlpEndpoint });
-    const metricReader = new sdk_metrics_1.PeriodicExportingMetricReader({
-        exporter: metricExporter,
-        exportIntervalMillis: metricsIntervalMs,
-    });
-    meterProvider = new sdk_metrics_1.MeterProvider({
-        resource,
-        readers: [metricReader],
-    });
-    api_1.metrics.setGlobalMeterProvider(meterProvider);
-    // 3. Setup Trace Exporter
-    const traceExporter = new exporter_trace_otlp_grpc_1.OTLPTraceExporter({ url: otlpEndpoint });
-    // 4. Initialize NodeSDK with auto-instrumentation
-    sdk = new sdk_node_1.NodeSDK({
-        resource,
-        traceExporter,
-        instrumentations: [
-            (0, auto_instrumentations_node_1.getNodeAutoInstrumentations)({
-                // Disable fs instrumentation (too noisy)
-                '@opentelemetry/instrumentation-fs': { enabled: false },
-            }),
-        ],
-    });
-    sdk.start();
-    // 5. Setup Pino logger with trace context injection
-    baseLogger = (0, pino_1.default)({
-        level: logLevel,
-        base: {
-            service: serviceName,
-            version: serviceVersion,
-            env: environment,
-        },
-        mixin: () => {
-            // Inject trace context into every log (correlates logs with traces in Groundcover)
-            const span = api_1.trace.getActiveSpan();
-            const ctx = exports.als.getStore();
-            const spanContext = span?.spanContext();
-            return {
-                traceId: spanContext?.traceId || ctx?.traceId,
-                spanId: spanContext?.spanId || ctx?.spanId,
-                correlationId: ctx?.correlationId,
-            };
-        },
-        formatters: {
-            level: (label) => ({ level: label }),
-        },
-        transport: environment === 'development'
-            ? { target: 'pino-pretty', options: { colorize: true } }
-            : undefined,
-    });
-    baseLogger.info({
-        endpoint: otlpEndpoint,
-        metricsInterval: `${metricsIntervalMs}ms`,
-    }, `OpenTelemetry initialized. Sending to OTEL Collector.`);
-    initialized = true;
-}
-// -----------------------------------------------------------------------------
-// Logger API
-// -----------------------------------------------------------------------------
-/**
- * Structured logger with automatic trace context injection.
- * All logs include traceId, spanId, and correlationId when available.
- */
-exports.logger = {
-    info: (obj, msg) => baseLogger?.info(obj, msg),
-    error: (obj, msg) => baseLogger?.error(obj, msg),
-    warn: (obj, msg) => baseLogger?.warn(obj, msg),
-    debug: (obj, msg) => baseLogger?.debug(obj, msg),
-    child: (bindings) => baseLogger?.child(bindings),
-};
-// -----------------------------------------------------------------------------
-// Tracer API
-// -----------------------------------------------------------------------------
-/**
- * Get a tracer instance for creating spans.
- *
- * @param name - Tracer name (defaults to service name)
- *
- * @example
- *   const tracer = getTracer();
- *   tracer.startActiveSpan('db.query', (span) => {
- *     // ... do work
- *     span.end();
- *   });
- */
-function getTracer(name) {
-    return api_1.trace.getTracer(name || serviceName);
-}
-// -----------------------------------------------------------------------------
-// Meter API
-// -----------------------------------------------------------------------------
-/**
- * Get a meter instance for creating metrics.
- * Metrics are exported to OTEL Collector → Groundcover.
- *
- * @param name - Meter name (typically service name)
- * @param version - Meter version (default: 1.0.0)
- *
- * @example
- *   const meter = getMeter('canvas-weaver');
- *   const counter = meter.createCounter('http.requests.total');
- *   counter.add(1, { method: 'GET', route: '/api/reports' });
- *
- *   const histogram = meter.createHistogram('http.request.duration');
- *   histogram.record(150, { method: 'GET', route: '/api/reports' });
- */
-function getMeter(name, version = '1.0.0') {
-    return api_1.metrics.getMeter(name, version);
-}
-// -----------------------------------------------------------------------------
-// Context Helpers
-// -----------------------------------------------------------------------------
-/**
- * Get current request context from AsyncLocalStorage.
- */
-function getRequestContext() {
-    return exports.als.getStore();
-}
-/**
- * Run a function with a specific context (for manual context propagation).
- */
-function runWithContext(ctx, fn) {
-    return exports.als.run(ctx, fn);
-}
-/**
- * Get current trace context as a dictionary.
- * Useful for logging or passing to external systems.
- */
-function getTraceContext() {
-    const span = api_1.trace.getActiveSpan();
-    if (!span)
-        return {};
-    const ctx = span.spanContext();
-    return {
-        traceId: ctx.traceId,
-        spanId: ctx.spanId,
-    };
-}
-// -----------------------------------------------------------------------------
-// Shutdown
-// -----------------------------------------------------------------------------
-/**
- * Gracefully shutdown OTEL providers.
- * Call this on application shutdown to flush pending telemetry.
- */
-async function shutdown() {
-    if (!initialized)
-        return;
-    try {
-        await meterProvider?.shutdown();
-        await sdk?.shutdown();
-        console.log('[neoiq-foundation-node] OTEL shutdown complete');
-    }
-    catch (error) {
-        console.error('[neoiq-foundation-node] Error during shutdown:', error);
-    }
-}
-//# sourceMappingURL=observability.js.map

package/dist/observability.js.map

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

package/dist/plugin.d.ts

@@ -1,40 +0,0 @@
-/**
- * Fastify Observability Plugin
- *
- * Automatically handles:
- * - Correlation ID extraction/generation (x-request-id header)
- * - OpenTelemetry trace context propagation
- * - Request/response logging with trace context
- * - HTTP server metrics (request count, duration)
- *
- * Usage:
- *   import { observabilityPlugin } from '@commerceiq/neoiq-foundation-node';
- *   app.register(observabilityPlugin, { serviceName: 'my-service' });
- */
-import { FastifyPluginAsync } from 'fastify';
-import { Span } from '@opentelemetry/api';
-interface PluginRequestContext {
-    correlationId: string;
-    traceId: string;
-    spanId: string;
-    startTime: number;
-}
-export interface PluginOptions {
-    /**
-     * Service name for metrics (required).
-     */
-    serviceName: string;
-    /**
-     * Routes to exclude from tracing/metrics (e.g., ['/health']).
-     */
-    excludeRoutes?: string[];
-}
-declare module 'fastify' {
-    interface FastifyRequest {
-        __span?: Span;
-        __requestContext?: PluginRequestContext;
-    }
-}
-export declare const observabilityPlugin: FastifyPluginAsync<PluginOptions>;
-export {};
-//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,kBAAkB,EAAgC,MAAM,SAAS,CAAC;AAG3E,OAAO,EAA+C,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAOvF,UAAU,oBAAoB;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAGD,OAAO,QAAQ,SAAS,CAAC;IACvB,UAAU,cAAc;QACtB,MAAM,CAAC,EAAE,IAAI,CAAC;QACd,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;KACzC;CACF;AA8LD,eAAO,MAAM,mBAAmB,mCAG9B,CAAC"}

package/dist/plugin.js

@@ -1,176 +0,0 @@
-"use strict";
-/**
- * Fastify Observability Plugin
- *
- * Automatically handles:
- * - Correlation ID extraction/generation (x-request-id header)
- * - OpenTelemetry trace context propagation
- * - Request/response logging with trace context
- * - HTTP server metrics (request count, duration)
- *
- * Usage:
- *   import { observabilityPlugin } from '@commerceiq/neoiq-foundation-node';
- *   app.register(observabilityPlugin, { serviceName: 'my-service' });
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.observabilityPlugin = void 0;
-const fastify_plugin_1 = __importDefault(require("fastify-plugin"));
-const crypto_1 = require("crypto");
-const api_1 = require("@opentelemetry/api");
-const observability_1 = require("./observability");
-// -----------------------------------------------------------------------------
-// Plugin Implementation
-// -----------------------------------------------------------------------------
-const plugin = async (fastify, options) => {
-    const { serviceName, excludeRoutes = ['/health', '/health/'] } = options;
-    const tracer = api_1.trace.getTracer('neoiq-foundation-node');
-    // Setup metrics (per Groundcover guide)
-    const meter = (0, observability_1.getMeter)(serviceName);
-    const requestCounter = meter.createCounter('http.server.requests.total', {
-        description: 'Total number of HTTP requests',
-    });
-    const requestDuration = meter.createHistogram('http.server.request.duration', {
-        description: 'HTTP request duration in milliseconds',
-        unit: 'ms',
-    });
-    const requestErrors = meter.createCounter('http.server.requests.errors', {
-        description: 'Total number of HTTP request errors',
-    });
-    // ---------------------------------------------------------------------------
-    // ON REQUEST - Extract context, start span
-    // ---------------------------------------------------------------------------
-    fastify.addHook('onRequest', (request, reply, done) => {
-        // Skip health checks
-        if (excludeRoutes.some((route) => request.url.startsWith(route))) {
-            done();
-            return;
-        }
-        // 1. Extract or generate correlation ID from x-request-id header
-        const correlationId = request.headers['x-request-id'] || (0, crypto_1.randomUUID)();
-        // 2. Set correlation ID in response header
-        reply.header('x-request-id', correlationId);
-        // 3. Extract parent trace context from incoming headers (W3C traceparent)
-        const parentContext = api_1.propagation.extract(api_1.context.active(), request.headers);
-        // 4. Start a new span for this request
-        const span = tracer.startSpan(`${request.method} ${request.routeOptions?.url || request.url}`, {
-            kind: 1, // SpanKind.SERVER
-            attributes: {
-                'http.method': request.method,
-                'http.url': request.url,
-                'http.route': request.routeOptions?.url || request.url,
-                'http.user_agent': request.headers['user-agent'] || '',
-                'http.correlation_id': correlationId,
-            },
-        }, parentContext);
-        // 5. Get trace/span IDs
-        const spanContext = span.spanContext();
-        const traceId = spanContext.traceId;
-        const spanId = spanContext.spanId;
-        // 6. Store context
-        const requestContext = {
-            correlationId,
-            traceId,
-            spanId,
-            startTime: Date.now(),
-        };
-        request.__span = span;
-        request.__requestContext = requestContext;
-        // 7. Run in AsyncLocalStorage context
-        observability_1.als.run({ correlationId, traceId, spanId }, () => {
-            observability_1.logger.info({
-                correlationId,
-                traceId,
-                spanId,
-                method: request.method,
-                url: request.url,
-                route: request.routeOptions?.url,
-                userAgent: request.headers['user-agent'],
-            }, 'Request received');
-            done();
-        });
-    });
-    // ---------------------------------------------------------------------------
-    // ON RESPONSE - End span, record metrics
-    // ---------------------------------------------------------------------------
-    fastify.addHook('onResponse', (request, reply, done) => {
-        const ctx = request.__requestContext;
-        const span = request.__span;
-        if (!ctx) {
-            done();
-            return;
-        }
-        const durationMs = Date.now() - ctx.startTime;
-        const route = request.routeOptions?.url || request.url;
-        const labels = {
-            method: request.method,
-            route,
-            status_code: String(reply.statusCode),
-        };
-        // Run in context for proper log correlation
-        observability_1.als.run({ correlationId: ctx.correlationId, traceId: ctx.traceId, spanId: ctx.spanId }, () => {
-            // Log response
-            observability_1.logger.info({
-                correlationId: ctx.correlationId,
-                traceId: ctx.traceId,
-                spanId: ctx.spanId,
-                method: request.method,
-                url: request.url,
-                route,
-                statusCode: reply.statusCode,
-                durationMs,
-            }, 'Request completed');
-            // Record metrics (per Groundcover guide)
-            requestCounter.add(1, labels);
-            requestDuration.record(durationMs, labels);
-            if (reply.statusCode >= 400) {
-                requestErrors.add(1, labels);
-            }
-            // End span
-            if (span) {
-                span.setStatus({
-                    code: reply.statusCode < 400 ? api_1.SpanStatusCode.OK : api_1.SpanStatusCode.ERROR,
-                });
-                span.setAttribute('http.status_code', reply.statusCode);
-                span.setAttribute('http.response_time_ms', durationMs);
-                span.end();
-            }
-            done();
-        });
-    });
-    // ---------------------------------------------------------------------------
-    // ON ERROR - Record exception on span
-    // ---------------------------------------------------------------------------
-    fastify.addHook('onError', (request, reply, error, done) => {
-        const ctx = request.__requestContext;
-        const span = request.__span;
-        if (!ctx) {
-            done();
-            return;
-        }
-        observability_1.als.run({ correlationId: ctx.correlationId, traceId: ctx.traceId, spanId: ctx.spanId }, () => {
-            observability_1.logger.error({
-                correlationId: ctx.correlationId,
-                traceId: ctx.traceId,
-                spanId: ctx.spanId,
-                method: request.method,
-                url: request.url,
-                error: error.message,
-                stack: error.stack,
-            }, 'Request failed');
-            if (span) {
-                span.setStatus({ code: api_1.SpanStatusCode.ERROR, message: error.message });
-                span.recordException(error);
-            }
-            done();
-        });
-    });
-};
-// Export plugin
-exports.observabilityPlugin = (0, fastify_plugin_1.default)(plugin, {
-    name: 'neoiq-observability',
-    fastify: '4.x',
-});
-//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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