@ciq-dev/neoiq-foundation-node 1.0.1-beta.2 → 1.0.1-beta.3

package/dist/tracing-Cv-Y3fZx.mjs

@@ -0,0 +1,196 @@
+import { createRequire } from "module";
+import { NodeSDK } from "@opentelemetry/sdk-node";
+import { getNodeAutoInstrumentations } from "@opentelemetry/auto-instrumentations-node";
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-grpc";
+import { resourceFromAttributes } from "@opentelemetry/resources";
+import { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } from "@opentelemetry/semantic-conventions";
+import { SpanStatusCode as SpanStatusCode$1, context as context$1, propagation as propagation$1, trace as trace$1 } from "@opentelemetry/api";
+import { ParentBasedSampler, TraceIdRatioBasedSampler } from "@opentelemetry/sdk-trace-base";
+import { z } from "zod";
+
+//#region rolldown:runtime
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+//#endregion
+//#region src/config.ts
+const AutoInstrumentationConfigSchema = z.object({
+	http: z.boolean().default(true),
+	fastify: z.boolean().default(true),
+	express: z.boolean().default(true),
+	mongodb: z.boolean().default(true),
+	pg: z.boolean().default(true),
+	mysql: z.boolean().default(true),
+	redis: z.boolean().default(true),
+	ioredis: z.boolean().default(true),
+	grpc: z.boolean().default(true),
+	fs: z.boolean().default(false),
+	dns: z.boolean().default(false)
+}).partial();
+const FeaturesConfigSchema = z.object({
+	tracing: z.boolean().default(true),
+	metrics: z.boolean().default(true),
+	logging: z.boolean().default(true),
+	autoInstrumentation: AutoInstrumentationConfigSchema.default({})
+}).partial();
+const DEFAULT_OTEL_ENDPOINT = "http://otel-stack-deployment-collector.observability.svc.cluster.local:4317";
+const OtelConfigSchema = z.object({
+	endpoint: z.string().default(process.env.OTEL_EXPORTER_OTLP_ENDPOINT || DEFAULT_OTEL_ENDPOINT),
+	metricsIntervalMs: z.number().min(1e3).default(5e3),
+	traceSampleRate: z.number().min(0).max(1).default(1)
+});
+const LoggingConfigSchema = z.object({
+	level: z.enum([
+		"debug",
+		"info",
+		"warn",
+		"error"
+	]).default("info"),
+	prettyPrint: z.boolean().optional()
+}).partial();
+const RequestLoggingConfigSchema = z.object({
+	logHeaders: z.boolean().default(true),
+	logBody: z.boolean().default(false),
+	logResponseBody: z.boolean().default(false),
+	maxBodySize: z.number().default(10 * 1024),
+	redactHeaders: z.array(z.string()).optional()
+}).partial();
+const RedactionConfigSchema = z.object({ additionalPaths: z.array(z.string()).default([]) }).partial();
+const ShutdownConfigSchema = z.object({
+	flushOnCrash: z.boolean().default(false),
+	flushTimeoutMs: z.number().min(100).default(5e3)
+}).partial();
+const FoundationConfigSchema = z.object({
+	serviceName: z.string().min(1, "serviceName is required"),
+	serviceVersion: z.string().default(process.env.SERVICE_VERSION || "1.0.0"),
+	environment: z.enum([
+		"development",
+		"staging",
+		"qa",
+		"production"
+	]).default([
+		"development",
+		"staging",
+		"qa",
+		"production"
+	].includes(process.env.NODE_ENV ?? "") ? process.env.NODE_ENV : "development"),
+	features: FeaturesConfigSchema.default({}),
+	otel: OtelConfigSchema.default({}),
+	logging: LoggingConfigSchema.default({}),
+	requestLogging: RequestLoggingConfigSchema.default({}),
+	redaction: RedactionConfigSchema.default({}),
+	shutdown: ShutdownConfigSchema.default({})
+});
+/** Parse and validate configuration */
+function parseConfig(input) {
+	const result = FoundationConfigSchema.safeParse(input);
+	if (!result.success) {
+		const errors = result.error.errors.map((e) => `  - ${e.path.join(".")}: ${e.message}`).join("\n");
+		throw new Error(`Invalid foundation configuration:\n${errors}`);
+	}
+	return result.data;
+}
+/** Get default OTEL endpoint */
+function getDefaultOtelEndpoint() {
+	return process.env.OTEL_EXPORTER_OTLP_ENDPOINT || DEFAULT_OTEL_ENDPOINT;
+}
+
+//#endregion
+//#region src/features/tracing.ts
+let sdk = null;
+let isInitialized = false;
+const MONITORED_MODULES = [
+	"pg",
+	"mongodb",
+	"ioredis",
+	"mysql2",
+	"express",
+	"@grpc/grpc-js"
+];
+function warnPreloadedModules() {
+	if (typeof __require === "undefined" || typeof __require.cache === "undefined") return;
+	for (const mod of MONITORED_MODULES) try {
+		const resolved = __require.resolve(mod);
+		if (__require.cache[resolved]) console.warn(`[neoiq-foundation] "${mod}" was imported before tracing init. Auto-instrumentation may not work for this module. Use node -r @ciq-dev/neoiq-foundation-node/bootstrap or call createFoundation() first.`);
+	} catch {}
+}
+/** Initialize OpenTelemetry tracing */
+function setupTracing(options) {
+	if (isInitialized) {
+		console.warn("[neoiq-foundation] Tracing already initialized");
+		return;
+	}
+	warnPreloadedModules();
+	const { serviceName, serviceVersion, environment, endpoint = getDefaultOtelEndpoint(), sampleRate, autoInstrumentation = {} } = options;
+	const resource = resourceFromAttributes({
+		[ATTR_SERVICE_NAME]: serviceName,
+		[ATTR_SERVICE_VERSION]: serviceVersion,
+		"deployment.environment": environment
+	});
+	const traceExporter = new OTLPTraceExporter({ url: endpoint });
+	const instrumentationConfig = buildInstrumentationConfig(autoInstrumentation);
+	const sampler = sampleRate !== void 0 && sampleRate < 1 ? new ParentBasedSampler({ root: new TraceIdRatioBasedSampler(sampleRate) }) : void 0;
+	sdk = new NodeSDK({
+		resource,
+		traceExporter,
+		sampler,
+		instrumentations: [getNodeAutoInstrumentations(instrumentationConfig)]
+	});
+	sdk.start();
+	isInitialized = true;
+}
+function buildInstrumentationConfig(config) {
+	const mapping = {
+		http: "@opentelemetry/instrumentation-http",
+		fastify: "@opentelemetry/instrumentation-fastify",
+		express: "@opentelemetry/instrumentation-express",
+		mongodb: "@opentelemetry/instrumentation-mongodb",
+		pg: "@opentelemetry/instrumentation-pg",
+		mysql: "@opentelemetry/instrumentation-mysql",
+		redis: "@opentelemetry/instrumentation-redis",
+		ioredis: "@opentelemetry/instrumentation-ioredis",
+		grpc: "@opentelemetry/instrumentation-grpc",
+		fs: "@opentelemetry/instrumentation-fs",
+		dns: "@opentelemetry/instrumentation-dns"
+	};
+	const result = {};
+	for (const [key, instrumentationName] of Object.entries(mapping)) {
+		const userSetting = config[key];
+		const defaultValue = key !== "fs" && key !== "dns";
+		result[instrumentationName] = { enabled: userSetting ?? defaultValue };
+	}
+	return result;
+}
+/** Shutdown tracing gracefully */
+async function shutdownTracing() {
+	if (!sdk) return;
+	try {
+		await sdk.shutdown();
+		isInitialized = false;
+		sdk = null;
+	} catch (error) {
+		console.error("[neoiq-foundation] Error shutting down tracing:", error);
+		throw error;
+	}
+}
+function getTracer(name) {
+	return trace$1.getTracer(name);
+}
+function getActiveSpan() {
+	return trace$1.getActiveSpan();
+}
+function getTraceContext() {
+	const span = trace$1.getActiveSpan();
+	if (!span) return {};
+	const ctx = span.spanContext();
+	return {
+		traceId: ctx.traceId,
+		spanId: ctx.spanId
+	};
+}
+function isTracingEnabled() {
+	return isInitialized;
+}
+
+//#endregion
+export { AutoInstrumentationConfigSchema, FeaturesConfigSchema, FoundationConfigSchema, LoggingConfigSchema, OtelConfigSchema, RedactionConfigSchema, RequestLoggingConfigSchema, ShutdownConfigSchema, SpanStatusCode$1 as SpanStatusCode, context$1 as context, getActiveSpan, getDefaultOtelEndpoint, getTraceContext, getTracer, isTracingEnabled, parseConfig, propagation$1 as propagation, setupTracing, shutdownTracing, trace$1 as trace };
+//# sourceMappingURL=tracing-Cv-Y3fZx.mjs.map

package/dist/tracing-Cv-Y3fZx.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing-Cv-Y3fZx.mjs","names":["input: FoundationConfigInput","sdk: NodeSDK | null","options: TracingOptions","config: AutoInstrumentationConfig","mapping: Record<string, string>","result: Record<string, { enabled: boolean }>","name: string"],"sources":["../src/config.ts","../src/features/tracing.ts"],"sourcesContent":["/**\n * Foundation Configuration with Zod Validation\n */\n\nimport { z } from 'zod';\n\n// Auto-Instrumentation Config\nexport const AutoInstrumentationConfigSchema = z\n  .object({\n    http: z.boolean().default(true),\n    fastify: z.boolean().default(true),\n    express: z.boolean().default(true),\n    mongodb: z.boolean().default(true),\n    pg: z.boolean().default(true),\n    mysql: z.boolean().default(true),\n    redis: z.boolean().default(true),\n    ioredis: z.boolean().default(true),\n    grpc: z.boolean().default(true),\n    fs: z.boolean().default(false),\n    dns: z.boolean().default(false),\n  })\n  .partial();\n\nexport type AutoInstrumentationConfig = z.infer<typeof AutoInstrumentationConfigSchema>;\n\n// Features Config\nexport const FeaturesConfigSchema = z\n  .object({\n    tracing: z.boolean().default(true),\n    metrics: z.boolean().default(true),\n    logging: z.boolean().default(true),\n    autoInstrumentation: AutoInstrumentationConfigSchema.default({}),\n  })\n  .partial();\n\nexport type FeaturesConfig = z.infer<typeof FeaturesConfigSchema>;\n\n// OTEL Config\nconst DEFAULT_OTEL_ENDPOINT =\n  'http://otel-stack-deployment-collector.observability.svc.cluster.local:4317';\n\nexport const OtelConfigSchema = z.object({\n  endpoint: z\n    .string()\n    .default(process.env.OTEL_EXPORTER_OTLP_ENDPOINT || DEFAULT_OTEL_ENDPOINT),\n  metricsIntervalMs: z.number().min(1000).default(5000),\n  traceSampleRate: z.number().min(0).max(1).default(1.0),\n});\n\nexport type OtelConfig = z.infer<typeof OtelConfigSchema>;\n\n// Logging Config\nexport const LoggingConfigSchema = z\n  .object({\n    level: z.enum(['debug', 'info', 'warn', 'error']).default('info'),\n    prettyPrint: z.boolean().optional(),\n  })\n  .partial();\n\nexport type LoggingConfig = z.infer<typeof LoggingConfigSchema>;\n\n// Request Logging Config\nexport const RequestLoggingConfigSchema = z\n  .object({\n    logHeaders: z.boolean().default(true),\n    logBody: z.boolean().default(false),\n    logResponseBody: z.boolean().default(false),\n    maxBodySize: z.number().default(10 * 1024),\n    redactHeaders: z.array(z.string()).optional(),\n  })\n  .partial();\n\nexport type RequestLoggingConfig = z.infer<typeof RequestLoggingConfigSchema>;\n\n// Redaction Config\nexport const RedactionConfigSchema = z\n  .object({\n    additionalPaths: z.array(z.string()).default([]),\n  })\n  .partial();\n\nexport type RedactionConfig = z.infer<typeof RedactionConfigSchema>;\n\n// Shutdown Config\nexport const ShutdownConfigSchema = z\n  .object({\n    /** Flush telemetry on uncaughtException / unhandledRejection before process exits */\n    flushOnCrash: z.boolean().default(false),\n    /** Grace period (ms) for flushing before forcing exit */\n    flushTimeoutMs: z.number().min(100).default(5000),\n  })\n  .partial();\n\nexport type ShutdownConfig = z.infer<typeof ShutdownConfigSchema>;\n\n// Main Foundation Config\nexport const FoundationConfigSchema = z.object({\n  serviceName: z.string().min(1, 'serviceName is required'),\n  serviceVersion: z.string().default(process.env.SERVICE_VERSION || '1.0.0'),\n  environment: z\n    .enum(['development', 'staging', 'qa', 'production'])\n    .default(\n      (['development', 'staging', 'qa', 'production'].includes(process.env.NODE_ENV ?? '')\n        ? (process.env.NODE_ENV as 'development' | 'staging' | 'qa' | 'production')\n        : 'development'),\n    ),\n  features: FeaturesConfigSchema.default({}),\n  otel: OtelConfigSchema.default({}),\n  logging: LoggingConfigSchema.default({}),\n  requestLogging: RequestLoggingConfigSchema.default({}),\n  redaction: RedactionConfigSchema.default({}),\n  shutdown: ShutdownConfigSchema.default({}),\n});\n\nexport type FoundationConfig = z.infer<typeof FoundationConfigSchema>;\n\nexport type FoundationConfigInput = z.input<typeof FoundationConfigSchema> & {\n  serviceName: string;\n};\n\n/** Parse and validate configuration */\nexport function parseConfig(input: FoundationConfigInput): FoundationConfig {\n  const result = FoundationConfigSchema.safeParse(input);\n\n  if (!result.success) {\n    const errors = result.error.errors\n      .map((e) => `  - ${e.path.join('.')}: ${e.message}`)\n      .join('\\n');\n    throw new Error(`Invalid foundation configuration:\\n${errors}`);\n  }\n\n  return result.data;\n}\n\n/** Get default OTEL endpoint */\nexport function getDefaultOtelEndpoint(): string {\n  return process.env.OTEL_EXPORTER_OTLP_ENDPOINT || DEFAULT_OTEL_ENDPOINT;\n}\n","/**\n * OpenTelemetry Tracing Setup\n */\n\nimport { NodeSDK } from '@opentelemetry/sdk-node';\nimport { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';\nimport { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-grpc';\nimport { resourceFromAttributes } from '@opentelemetry/resources';\nimport { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } from '@opentelemetry/semantic-conventions';\nimport { trace, context, propagation, SpanStatusCode, type Tracer } from '@opentelemetry/api';\nimport { TraceIdRatioBasedSampler, ParentBasedSampler } from '@opentelemetry/sdk-trace-base';\nimport { type AutoInstrumentationConfig, getDefaultOtelEndpoint } from '../config';\n\nexport interface TracingOptions {\n  serviceName: string;\n  serviceVersion: string;\n  environment: string;\n  endpoint?: string;\n  sampleRate?: number;\n  autoInstrumentation?: AutoInstrumentationConfig;\n}\n\nlet sdk: NodeSDK | null = null;\nlet isInitialized = false;\n\nconst MONITORED_MODULES = ['pg', 'mongodb', 'ioredis', 'mysql2', 'express', '@grpc/grpc-js'];\n\nfunction warnPreloadedModules(): void {\n  // require.resolve / require.cache are only available in CJS contexts\n  if (typeof require === 'undefined' || typeof require.cache === 'undefined') return;\n\n  for (const mod of MONITORED_MODULES) {\n    try {\n      const resolved = require.resolve(mod);\n      if (require.cache[resolved]) {\n        console.warn(\n          `[neoiq-foundation] \"${mod}\" was imported before tracing init. ` +\n            'Auto-instrumentation may not work for this module. ' +\n            'Use node -r @ciq-dev/neoiq-foundation-node/bootstrap or call createFoundation() first.',\n        );\n      }\n    } catch {\n      // Module not installed — no warning needed\n    }\n  }\n}\n\n/** Initialize OpenTelemetry tracing */\nexport function setupTracing(options: TracingOptions): void {\n  if (isInitialized) {\n    console.warn('[neoiq-foundation] Tracing already initialized');\n    return;\n  }\n\n  warnPreloadedModules();\n\n  const {\n    serviceName,\n    serviceVersion,\n    environment,\n    endpoint = getDefaultOtelEndpoint(),\n    sampleRate,\n    autoInstrumentation = {},\n  } = options;\n\n  const resource = resourceFromAttributes({\n    [ATTR_SERVICE_NAME]: serviceName,\n    [ATTR_SERVICE_VERSION]: serviceVersion,\n    'deployment.environment': environment,\n  });\n\n  const traceExporter = new OTLPTraceExporter({ url: endpoint });\n  const instrumentationConfig = buildInstrumentationConfig(autoInstrumentation);\n\n  const sampler =\n    sampleRate !== undefined && sampleRate < 1.0\n      ? new ParentBasedSampler({ root: new TraceIdRatioBasedSampler(sampleRate) })\n      : undefined;\n\n  sdk = new NodeSDK({\n    resource,\n    traceExporter,\n    sampler,\n    instrumentations: [getNodeAutoInstrumentations(instrumentationConfig)],\n  });\n\n  sdk.start();\n  isInitialized = true;\n}\n\nfunction buildInstrumentationConfig(\n  config: AutoInstrumentationConfig\n): Record<string, { enabled: boolean }> {\n  const mapping: Record<string, string> = {\n    http: '@opentelemetry/instrumentation-http',\n    fastify: '@opentelemetry/instrumentation-fastify',\n    express: '@opentelemetry/instrumentation-express',\n    mongodb: '@opentelemetry/instrumentation-mongodb',\n    pg: '@opentelemetry/instrumentation-pg',\n    mysql: '@opentelemetry/instrumentation-mysql',\n    redis: '@opentelemetry/instrumentation-redis',\n    ioredis: '@opentelemetry/instrumentation-ioredis',\n    grpc: '@opentelemetry/instrumentation-grpc',\n    fs: '@opentelemetry/instrumentation-fs',\n    dns: '@opentelemetry/instrumentation-dns',\n  };\n\n  const result: Record<string, { enabled: boolean }> = {};\n  for (const [key, instrumentationName] of Object.entries(mapping)) {\n    const userSetting = config[key as keyof AutoInstrumentationConfig];\n    const defaultValue = key !== 'fs' && key !== 'dns';\n    result[instrumentationName] = { enabled: userSetting ?? defaultValue };\n  }\n  return result;\n}\n\n/** Shutdown tracing gracefully */\nexport async function shutdownTracing(): Promise<void> {\n  if (!sdk) return;\n  try {\n    await sdk.shutdown();\n    isInitialized = false;\n    sdk = null;\n  } catch (error) {\n    console.error('[neoiq-foundation] Error shutting down tracing:', error);\n    throw error;\n  }\n}\n\nexport function getTracer(name: string): Tracer {\n  return trace.getTracer(name);\n}\n\nexport function getActiveSpan(): ReturnType<typeof trace.getActiveSpan> {\n  return trace.getActiveSpan();\n}\n\nexport function getTraceContext(): { traceId?: string; spanId?: string } {\n  const span = trace.getActiveSpan();\n  if (!span) return {};\n  const ctx = span.spanContext();\n  return { traceId: ctx.traceId, spanId: ctx.spanId };\n}\n\nexport function isTracingEnabled(): boolean {\n  return isInitialized;\n}\n\nexport { trace, context, propagation, SpanStatusCode };\nexport type { Tracer };\n"],"mappings":"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"}

package/dist/tracing-DM5OFo7l.js

@@ -0,0 +1,316 @@
+"use strict";
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+const __opentelemetry_sdk_node = __toESM(require("@opentelemetry/sdk-node"));
+const __opentelemetry_auto_instrumentations_node = __toESM(require("@opentelemetry/auto-instrumentations-node"));
+const __opentelemetry_exporter_trace_otlp_grpc = __toESM(require("@opentelemetry/exporter-trace-otlp-grpc"));
+const __opentelemetry_resources = __toESM(require("@opentelemetry/resources"));
+const __opentelemetry_semantic_conventions = __toESM(require("@opentelemetry/semantic-conventions"));
+const __opentelemetry_api = __toESM(require("@opentelemetry/api"));
+const __opentelemetry_sdk_trace_base = __toESM(require("@opentelemetry/sdk-trace-base"));
+const zod = __toESM(require("zod"));
+
+//#region src/config.ts
+const AutoInstrumentationConfigSchema = zod.z.object({
+	http: zod.z.boolean().default(true),
+	fastify: zod.z.boolean().default(true),
+	express: zod.z.boolean().default(true),
+	mongodb: zod.z.boolean().default(true),
+	pg: zod.z.boolean().default(true),
+	mysql: zod.z.boolean().default(true),
+	redis: zod.z.boolean().default(true),
+	ioredis: zod.z.boolean().default(true),
+	grpc: zod.z.boolean().default(true),
+	fs: zod.z.boolean().default(false),
+	dns: zod.z.boolean().default(false)
+}).partial();
+const FeaturesConfigSchema = zod.z.object({
+	tracing: zod.z.boolean().default(true),
+	metrics: zod.z.boolean().default(true),
+	logging: zod.z.boolean().default(true),
+	autoInstrumentation: AutoInstrumentationConfigSchema.default({})
+}).partial();
+const DEFAULT_OTEL_ENDPOINT = "http://otel-stack-deployment-collector.observability.svc.cluster.local:4317";
+const OtelConfigSchema = zod.z.object({
+	endpoint: zod.z.string().default(process.env.OTEL_EXPORTER_OTLP_ENDPOINT || DEFAULT_OTEL_ENDPOINT),
+	metricsIntervalMs: zod.z.number().min(1e3).default(5e3),
+	traceSampleRate: zod.z.number().min(0).max(1).default(1)
+});
+const LoggingConfigSchema = zod.z.object({
+	level: zod.z.enum([
+		"debug",
+		"info",
+		"warn",
+		"error"
+	]).default("info"),
+	prettyPrint: zod.z.boolean().optional()
+}).partial();
+const RequestLoggingConfigSchema = zod.z.object({
+	logHeaders: zod.z.boolean().default(true),
+	logBody: zod.z.boolean().default(false),
+	logResponseBody: zod.z.boolean().default(false),
+	maxBodySize: zod.z.number().default(10 * 1024),
+	redactHeaders: zod.z.array(zod.z.string()).optional()
+}).partial();
+const RedactionConfigSchema = zod.z.object({ additionalPaths: zod.z.array(zod.z.string()).default([]) }).partial();
+const ShutdownConfigSchema = zod.z.object({
+	flushOnCrash: zod.z.boolean().default(false),
+	flushTimeoutMs: zod.z.number().min(100).default(5e3)
+}).partial();
+const FoundationConfigSchema = zod.z.object({
+	serviceName: zod.z.string().min(1, "serviceName is required"),
+	serviceVersion: zod.z.string().default(process.env.SERVICE_VERSION || "1.0.0"),
+	environment: zod.z.enum([
+		"development",
+		"staging",
+		"qa",
+		"production"
+	]).default([
+		"development",
+		"staging",
+		"qa",
+		"production"
+	].includes(process.env.NODE_ENV ?? "") ? process.env.NODE_ENV : "development"),
+	features: FeaturesConfigSchema.default({}),
+	otel: OtelConfigSchema.default({}),
+	logging: LoggingConfigSchema.default({}),
+	requestLogging: RequestLoggingConfigSchema.default({}),
+	redaction: RedactionConfigSchema.default({}),
+	shutdown: ShutdownConfigSchema.default({})
+});
+/** Parse and validate configuration */
+function parseConfig(input) {
+	const result = FoundationConfigSchema.safeParse(input);
+	if (!result.success) {
+		const errors = result.error.errors.map((e) => `  - ${e.path.join(".")}: ${e.message}`).join("\n");
+		throw new Error(`Invalid foundation configuration:\n${errors}`);
+	}
+	return result.data;
+}
+/** Get default OTEL endpoint */
+function getDefaultOtelEndpoint() {
+	return process.env.OTEL_EXPORTER_OTLP_ENDPOINT || DEFAULT_OTEL_ENDPOINT;
+}
+
+//#endregion
+//#region src/features/tracing.ts
+let sdk = null;
+let isInitialized = false;
+const MONITORED_MODULES = [
+	"pg",
+	"mongodb",
+	"ioredis",
+	"mysql2",
+	"express",
+	"@grpc/grpc-js"
+];
+function warnPreloadedModules() {
+	if (typeof require === "undefined" || typeof require.cache === "undefined") return;
+	for (const mod of MONITORED_MODULES) try {
+		const resolved = require.resolve(mod);
+		if (require.cache[resolved]) console.warn(`[neoiq-foundation] "${mod}" was imported before tracing init. Auto-instrumentation may not work for this module. Use node -r @ciq-dev/neoiq-foundation-node/bootstrap or call createFoundation() first.`);
+	} catch {}
+}
+/** Initialize OpenTelemetry tracing */
+function setupTracing(options) {
+	if (isInitialized) {
+		console.warn("[neoiq-foundation] Tracing already initialized");
+		return;
+	}
+	warnPreloadedModules();
+	const { serviceName, serviceVersion, environment, endpoint = getDefaultOtelEndpoint(), sampleRate, autoInstrumentation = {} } = options;
+	const resource = (0, __opentelemetry_resources.resourceFromAttributes)({
+		[__opentelemetry_semantic_conventions.ATTR_SERVICE_NAME]: serviceName,
+		[__opentelemetry_semantic_conventions.ATTR_SERVICE_VERSION]: serviceVersion,
+		"deployment.environment": environment
+	});
+	const traceExporter = new __opentelemetry_exporter_trace_otlp_grpc.OTLPTraceExporter({ url: endpoint });
+	const instrumentationConfig = buildInstrumentationConfig(autoInstrumentation);
+	const sampler = sampleRate !== void 0 && sampleRate < 1 ? new __opentelemetry_sdk_trace_base.ParentBasedSampler({ root: new __opentelemetry_sdk_trace_base.TraceIdRatioBasedSampler(sampleRate) }) : void 0;
+	sdk = new __opentelemetry_sdk_node.NodeSDK({
+		resource,
+		traceExporter,
+		sampler,
+		instrumentations: [(0, __opentelemetry_auto_instrumentations_node.getNodeAutoInstrumentations)(instrumentationConfig)]
+	});
+	sdk.start();
+	isInitialized = true;
+}
+function buildInstrumentationConfig(config) {
+	const mapping = {
+		http: "@opentelemetry/instrumentation-http",
+		fastify: "@opentelemetry/instrumentation-fastify",
+		express: "@opentelemetry/instrumentation-express",
+		mongodb: "@opentelemetry/instrumentation-mongodb",
+		pg: "@opentelemetry/instrumentation-pg",
+		mysql: "@opentelemetry/instrumentation-mysql",
+		redis: "@opentelemetry/instrumentation-redis",
+		ioredis: "@opentelemetry/instrumentation-ioredis",
+		grpc: "@opentelemetry/instrumentation-grpc",
+		fs: "@opentelemetry/instrumentation-fs",
+		dns: "@opentelemetry/instrumentation-dns"
+	};
+	const result = {};
+	for (const [key, instrumentationName] of Object.entries(mapping)) {
+		const userSetting = config[key];
+		const defaultValue = key !== "fs" && key !== "dns";
+		result[instrumentationName] = { enabled: userSetting ?? defaultValue };
+	}
+	return result;
+}
+/** Shutdown tracing gracefully */
+async function shutdownTracing() {
+	if (!sdk) return;
+	try {
+		await sdk.shutdown();
+		isInitialized = false;
+		sdk = null;
+	} catch (error) {
+		console.error("[neoiq-foundation] Error shutting down tracing:", error);
+		throw error;
+	}
+}
+function getTracer(name) {
+	return __opentelemetry_api.trace.getTracer(name);
+}
+function getActiveSpan() {
+	return __opentelemetry_api.trace.getActiveSpan();
+}
+function getTraceContext() {
+	const span = __opentelemetry_api.trace.getActiveSpan();
+	if (!span) return {};
+	const ctx = span.spanContext();
+	return {
+		traceId: ctx.traceId,
+		spanId: ctx.spanId
+	};
+}
+function isTracingEnabled() {
+	return isInitialized;
+}
+
+//#endregion
+Object.defineProperty(exports, 'AutoInstrumentationConfigSchema', {
+  enumerable: true,
+  get: function () {
+    return AutoInstrumentationConfigSchema;
+  }
+});
+Object.defineProperty(exports, 'FeaturesConfigSchema', {
+  enumerable: true,
+  get: function () {
+    return FeaturesConfigSchema;
+  }
+});
+Object.defineProperty(exports, 'FoundationConfigSchema', {
+  enumerable: true,
+  get: function () {
+    return FoundationConfigSchema;
+  }
+});
+Object.defineProperty(exports, 'LoggingConfigSchema', {
+  enumerable: true,
+  get: function () {
+    return LoggingConfigSchema;
+  }
+});
+Object.defineProperty(exports, 'OtelConfigSchema', {
+  enumerable: true,
+  get: function () {
+    return OtelConfigSchema;
+  }
+});
+Object.defineProperty(exports, 'RedactionConfigSchema', {
+  enumerable: true,
+  get: function () {
+    return RedactionConfigSchema;
+  }
+});
+Object.defineProperty(exports, 'RequestLoggingConfigSchema', {
+  enumerable: true,
+  get: function () {
+    return RequestLoggingConfigSchema;
+  }
+});
+Object.defineProperty(exports, 'ShutdownConfigSchema', {
+  enumerable: true,
+  get: function () {
+    return ShutdownConfigSchema;
+  }
+});
+Object.defineProperty(exports, '__toESM', {
+  enumerable: true,
+  get: function () {
+    return __toESM;
+  }
+});
+Object.defineProperty(exports, 'getActiveSpan', {
+  enumerable: true,
+  get: function () {
+    return getActiveSpan;
+  }
+});
+Object.defineProperty(exports, 'getDefaultOtelEndpoint', {
+  enumerable: true,
+  get: function () {
+    return getDefaultOtelEndpoint;
+  }
+});
+Object.defineProperty(exports, 'getTraceContext', {
+  enumerable: true,
+  get: function () {
+    return getTraceContext;
+  }
+});
+Object.defineProperty(exports, 'getTracer', {
+  enumerable: true,
+  get: function () {
+    return getTracer;
+  }
+});
+Object.defineProperty(exports, 'isTracingEnabled', {
+  enumerable: true,
+  get: function () {
+    return isTracingEnabled;
+  }
+});
+Object.defineProperty(exports, 'parseConfig', {
+  enumerable: true,
+  get: function () {
+    return parseConfig;
+  }
+});
+Object.defineProperty(exports, 'setupTracing', {
+  enumerable: true,
+  get: function () {
+    return setupTracing;
+  }
+});
+Object.defineProperty(exports, 'shutdownTracing', {
+  enumerable: true,
+  get: function () {
+    return shutdownTracing;
+  }
+});
+//# sourceMappingURL=tracing-DM5OFo7l.js.map

package/dist/tracing-DM5OFo7l.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing-DM5OFo7l.js","names":["input: FoundationConfigInput","sdk: NodeSDK | null","options: TracingOptions","config: AutoInstrumentationConfig","mapping: Record<string, string>","result: Record<string, { enabled: boolean }>","name: string"],"sources":["../src/config.ts","../src/features/tracing.ts"],"sourcesContent":["/**\n * Foundation Configuration with Zod Validation\n */\n\nimport { z } from 'zod';\n\n// Auto-Instrumentation Config\nexport const AutoInstrumentationConfigSchema = z\n  .object({\n    http: z.boolean().default(true),\n    fastify: z.boolean().default(true),\n    express: z.boolean().default(true),\n    mongodb: z.boolean().default(true),\n    pg: z.boolean().default(true),\n    mysql: z.boolean().default(true),\n    redis: z.boolean().default(true),\n    ioredis: z.boolean().default(true),\n    grpc: z.boolean().default(true),\n    fs: z.boolean().default(false),\n    dns: z.boolean().default(false),\n  })\n  .partial();\n\nexport type AutoInstrumentationConfig = z.infer<typeof AutoInstrumentationConfigSchema>;\n\n// Features Config\nexport const FeaturesConfigSchema = z\n  .object({\n    tracing: z.boolean().default(true),\n    metrics: z.boolean().default(true),\n    logging: z.boolean().default(true),\n    autoInstrumentation: AutoInstrumentationConfigSchema.default({}),\n  })\n  .partial();\n\nexport type FeaturesConfig = z.infer<typeof FeaturesConfigSchema>;\n\n// OTEL Config\nconst DEFAULT_OTEL_ENDPOINT =\n  'http://otel-stack-deployment-collector.observability.svc.cluster.local:4317';\n\nexport const OtelConfigSchema = z.object({\n  endpoint: z\n    .string()\n    .default(process.env.OTEL_EXPORTER_OTLP_ENDPOINT || DEFAULT_OTEL_ENDPOINT),\n  metricsIntervalMs: z.number().min(1000).default(5000),\n  traceSampleRate: z.number().min(0).max(1).default(1.0),\n});\n\nexport type OtelConfig = z.infer<typeof OtelConfigSchema>;\n\n// Logging Config\nexport const LoggingConfigSchema = z\n  .object({\n    level: z.enum(['debug', 'info', 'warn', 'error']).default('info'),\n    prettyPrint: z.boolean().optional(),\n  })\n  .partial();\n\nexport type LoggingConfig = z.infer<typeof LoggingConfigSchema>;\n\n// Request Logging Config\nexport const RequestLoggingConfigSchema = z\n  .object({\n    logHeaders: z.boolean().default(true),\n    logBody: z.boolean().default(false),\n    logResponseBody: z.boolean().default(false),\n    maxBodySize: z.number().default(10 * 1024),\n    redactHeaders: z.array(z.string()).optional(),\n  })\n  .partial();\n\nexport type RequestLoggingConfig = z.infer<typeof RequestLoggingConfigSchema>;\n\n// Redaction Config\nexport const RedactionConfigSchema = z\n  .object({\n    additionalPaths: z.array(z.string()).default([]),\n  })\n  .partial();\n\nexport type RedactionConfig = z.infer<typeof RedactionConfigSchema>;\n\n// Shutdown Config\nexport const ShutdownConfigSchema = z\n  .object({\n    /** Flush telemetry on uncaughtException / unhandledRejection before process exits */\n    flushOnCrash: z.boolean().default(false),\n    /** Grace period (ms) for flushing before forcing exit */\n    flushTimeoutMs: z.number().min(100).default(5000),\n  })\n  .partial();\n\nexport type ShutdownConfig = z.infer<typeof ShutdownConfigSchema>;\n\n// Main Foundation Config\nexport const FoundationConfigSchema = z.object({\n  serviceName: z.string().min(1, 'serviceName is required'),\n  serviceVersion: z.string().default(process.env.SERVICE_VERSION || '1.0.0'),\n  environment: z\n    .enum(['development', 'staging', 'qa', 'production'])\n    .default(\n      (['development', 'staging', 'qa', 'production'].includes(process.env.NODE_ENV ?? '')\n        ? (process.env.NODE_ENV as 'development' | 'staging' | 'qa' | 'production')\n        : 'development'),\n    ),\n  features: FeaturesConfigSchema.default({}),\n  otel: OtelConfigSchema.default({}),\n  logging: LoggingConfigSchema.default({}),\n  requestLogging: RequestLoggingConfigSchema.default({}),\n  redaction: RedactionConfigSchema.default({}),\n  shutdown: ShutdownConfigSchema.default({}),\n});\n\nexport type FoundationConfig = z.infer<typeof FoundationConfigSchema>;\n\nexport type FoundationConfigInput = z.input<typeof FoundationConfigSchema> & {\n  serviceName: string;\n};\n\n/** Parse and validate configuration */\nexport function parseConfig(input: FoundationConfigInput): FoundationConfig {\n  const result = FoundationConfigSchema.safeParse(input);\n\n  if (!result.success) {\n    const errors = result.error.errors\n      .map((e) => `  - ${e.path.join('.')}: ${e.message}`)\n      .join('\\n');\n    throw new Error(`Invalid foundation configuration:\\n${errors}`);\n  }\n\n  return result.data;\n}\n\n/** Get default OTEL endpoint */\nexport function getDefaultOtelEndpoint(): string {\n  return process.env.OTEL_EXPORTER_OTLP_ENDPOINT || DEFAULT_OTEL_ENDPOINT;\n}\n","/**\n * OpenTelemetry Tracing Setup\n */\n\nimport { NodeSDK } from '@opentelemetry/sdk-node';\nimport { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';\nimport { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-grpc';\nimport { resourceFromAttributes } from '@opentelemetry/resources';\nimport { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } from '@opentelemetry/semantic-conventions';\nimport { trace, context, propagation, SpanStatusCode, type Tracer } from '@opentelemetry/api';\nimport { TraceIdRatioBasedSampler, ParentBasedSampler } from '@opentelemetry/sdk-trace-base';\nimport { type AutoInstrumentationConfig, getDefaultOtelEndpoint } from '../config';\n\nexport interface TracingOptions {\n  serviceName: string;\n  serviceVersion: string;\n  environment: string;\n  endpoint?: string;\n  sampleRate?: number;\n  autoInstrumentation?: AutoInstrumentationConfig;\n}\n\nlet sdk: NodeSDK | null = null;\nlet isInitialized = false;\n\nconst MONITORED_MODULES = ['pg', 'mongodb', 'ioredis', 'mysql2', 'express', '@grpc/grpc-js'];\n\nfunction warnPreloadedModules(): void {\n  // require.resolve / require.cache are only available in CJS contexts\n  if (typeof require === 'undefined' || typeof require.cache === 'undefined') return;\n\n  for (const mod of MONITORED_MODULES) {\n    try {\n      const resolved = require.resolve(mod);\n      if (require.cache[resolved]) {\n        console.warn(\n          `[neoiq-foundation] \"${mod}\" was imported before tracing init. ` +\n            'Auto-instrumentation may not work for this module. ' +\n            'Use node -r @ciq-dev/neoiq-foundation-node/bootstrap or call createFoundation() first.',\n        );\n      }\n    } catch {\n      // Module not installed — no warning needed\n    }\n  }\n}\n\n/** Initialize OpenTelemetry tracing */\nexport function setupTracing(options: TracingOptions): void {\n  if (isInitialized) {\n    console.warn('[neoiq-foundation] Tracing already initialized');\n    return;\n  }\n\n  warnPreloadedModules();\n\n  const {\n    serviceName,\n    serviceVersion,\n    environment,\n    endpoint = getDefaultOtelEndpoint(),\n    sampleRate,\n    autoInstrumentation = {},\n  } = options;\n\n  const resource = resourceFromAttributes({\n    [ATTR_SERVICE_NAME]: serviceName,\n    [ATTR_SERVICE_VERSION]: serviceVersion,\n    'deployment.environment': environment,\n  });\n\n  const traceExporter = new OTLPTraceExporter({ url: endpoint });\n  const instrumentationConfig = buildInstrumentationConfig(autoInstrumentation);\n\n  const sampler =\n    sampleRate !== undefined && sampleRate < 1.0\n      ? new ParentBasedSampler({ root: new TraceIdRatioBasedSampler(sampleRate) })\n      : undefined;\n\n  sdk = new NodeSDK({\n    resource,\n    traceExporter,\n    sampler,\n    instrumentations: [getNodeAutoInstrumentations(instrumentationConfig)],\n  });\n\n  sdk.start();\n  isInitialized = true;\n}\n\nfunction buildInstrumentationConfig(\n  config: AutoInstrumentationConfig\n): Record<string, { enabled: boolean }> {\n  const mapping: Record<string, string> = {\n    http: '@opentelemetry/instrumentation-http',\n    fastify: '@opentelemetry/instrumentation-fastify',\n    express: '@opentelemetry/instrumentation-express',\n    mongodb: '@opentelemetry/instrumentation-mongodb',\n    pg: '@opentelemetry/instrumentation-pg',\n    mysql: '@opentelemetry/instrumentation-mysql',\n    redis: '@opentelemetry/instrumentation-redis',\n    ioredis: '@opentelemetry/instrumentation-ioredis',\n    grpc: '@opentelemetry/instrumentation-grpc',\n    fs: '@opentelemetry/instrumentation-fs',\n    dns: '@opentelemetry/instrumentation-dns',\n  };\n\n  const result: Record<string, { enabled: boolean }> = {};\n  for (const [key, instrumentationName] of Object.entries(mapping)) {\n    const userSetting = config[key as keyof AutoInstrumentationConfig];\n    const defaultValue = key !== 'fs' && key !== 'dns';\n    result[instrumentationName] = { enabled: userSetting ?? defaultValue };\n  }\n  return result;\n}\n\n/** Shutdown tracing gracefully */\nexport async function shutdownTracing(): Promise<void> {\n  if (!sdk) return;\n  try {\n    await sdk.shutdown();\n    isInitialized = false;\n    sdk = null;\n  } catch (error) {\n    console.error('[neoiq-foundation] Error shutting down tracing:', error);\n    throw error;\n  }\n}\n\nexport function getTracer(name: string): Tracer {\n  return trace.getTracer(name);\n}\n\nexport function getActiveSpan(): ReturnType<typeof trace.getActiveSpan> {\n  return trace.getActiveSpan();\n}\n\nexport function getTraceContext(): { traceId?: string; spanId?: string } {\n  const span = trace.getActiveSpan();\n  if (!span) return {};\n  const ctx = span.spanContext();\n  return { traceId: ctx.traceId, spanId: ctx.spanId };\n}\n\nexport function isTracingEnabled(): boolean {\n  return isInitialized;\n}\n\nexport { trace, context, propagation, SpanStatusCode };\nexport type { Tracer };\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ciq-dev/neoiq-foundation-node",
-  "version": "1.0.1-beta.2",
+  "version": "1.0.1-beta.3",
   "description": "Node.js observability foundation for CommerceIQ services. Integrates with Groundcover via OpenTelemetry.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -17,8 +17,14 @@
       }
     },
     "./bootstrap": {
-      "import": "./dist/bootstrap.mjs",
-      "require": "./dist/bootstrap.js"
+      "import": {
+        "types": "./dist/bootstrap.d.mts",
+        "default": "./dist/bootstrap.mjs"
+      },
+      "require": {
+        "types": "./dist/bootstrap.d.ts",
+        "default": "./dist/bootstrap.js"
+      }
     }
   },
   "files": [
@@ -40,7 +46,8 @@
     "node": ">=18.0.0"
   },
   "peerDependencies": {
-    "zod": "^3.22.0",
+    "@aws-sdk/client-s3": "^3.0.0",
+    "@aws-sdk/s3-request-presigner": "^3.0.0",
     "@opentelemetry/api": "^1.7.0",
     "@opentelemetry/auto-instrumentations-node": ">=0.41.0",
     "@opentelemetry/exporter-metrics-otlp-grpc": ">=0.48.0",
@@ -48,6 +55,7 @@
     "@opentelemetry/resources": ">=1.21.0",
     "@opentelemetry/sdk-metrics": ">=1.21.0",
     "@opentelemetry/sdk-node": ">=0.48.0",
+    "@opentelemetry/sdk-trace-base": ">=1.21.0",
     "@opentelemetry/semantic-conventions": "^1.21.0",
     "axios": "^1.6.0",
     "axios-retry": "^4.0.0",
@@ -56,8 +64,7 @@
     "opossum": ">=8.1.0",
     "pino": ">=8.17.0",
     "pino-pretty": ">=10.3.0",
-    "@aws-sdk/client-s3": "^3.0.0",
-    "@aws-sdk/s3-request-presigner": "^3.0.0"
+    "zod": "^3.22.0"
   },
   "peerDependenciesMeta": {
     "@aws-sdk/client-s3": {