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

package/dist/index.d.ts

@@ -1,12 +1,573 @@
+import { z } from "zod";
+import { Logger as Logger$1 } from "pino";
+import * as _opentelemetry_api0 from "@opentelemetry/api";
+import { Meter, Span, SpanStatusCode, Tracer, context, metrics, propagation, trace } from "@opentelemetry/api";
+import { FastifyPluginAsync } from "fastify";
+import { AxiosInstance, AxiosRequestConfig, AxiosResponse } from "axios";
+
+//#region src/config.d.ts
+declare const AutoInstrumentationConfigSchema: z.ZodObject<{
+  http: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+  fastify: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+  express: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+  mongodb: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+  pg: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+  mysql: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+  redis: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+  ioredis: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+  grpc: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+  fs: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+  dns: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+  http?: boolean | undefined;
+  fastify?: boolean | undefined;
+  express?: boolean | undefined;
+  mongodb?: boolean | undefined;
+  pg?: boolean | undefined;
+  mysql?: boolean | undefined;
+  redis?: boolean | undefined;
+  ioredis?: boolean | undefined;
+  grpc?: boolean | undefined;
+  fs?: boolean | undefined;
+  dns?: boolean | undefined;
+}, {
+  http?: boolean | undefined;
+  fastify?: boolean | undefined;
+  express?: boolean | undefined;
+  mongodb?: boolean | undefined;
+  pg?: boolean | undefined;
+  mysql?: boolean | undefined;
+  redis?: boolean | undefined;
+  ioredis?: boolean | undefined;
+  grpc?: boolean | undefined;
+  fs?: boolean | undefined;
+  dns?: boolean | undefined;
+}>;
+type AutoInstrumentationConfig = z.infer<typeof AutoInstrumentationConfigSchema>;
+declare const FeaturesConfigSchema: z.ZodObject<{
+  tracing: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+  metrics: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+  logging: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+  autoInstrumentation: z.ZodOptional<z.ZodDefault<z.ZodObject<{
+    http: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    fastify: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    express: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    mongodb: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    pg: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    mysql: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    redis: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    ioredis: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    grpc: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    fs: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    dns: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+  }, "strip", z.ZodTypeAny, {
+    http?: boolean | undefined;
+    fastify?: boolean | undefined;
+    express?: boolean | undefined;
+    mongodb?: boolean | undefined;
+    pg?: boolean | undefined;
+    mysql?: boolean | undefined;
+    redis?: boolean | undefined;
+    ioredis?: boolean | undefined;
+    grpc?: boolean | undefined;
+    fs?: boolean | undefined;
+    dns?: boolean | undefined;
+  }, {
+    http?: boolean | undefined;
+    fastify?: boolean | undefined;
+    express?: boolean | undefined;
+    mongodb?: boolean | undefined;
+    pg?: boolean | undefined;
+    mysql?: boolean | undefined;
+    redis?: boolean | undefined;
+    ioredis?: boolean | undefined;
+    grpc?: boolean | undefined;
+    fs?: boolean | undefined;
+    dns?: boolean | undefined;
+  }>>>;
+}, "strip", z.ZodTypeAny, {
+  tracing?: boolean | undefined;
+  metrics?: boolean | undefined;
+  logging?: boolean | undefined;
+  autoInstrumentation?: {
+    http?: boolean | undefined;
+    fastify?: boolean | undefined;
+    express?: boolean | undefined;
+    mongodb?: boolean | undefined;
+    pg?: boolean | undefined;
+    mysql?: boolean | undefined;
+    redis?: boolean | undefined;
+    ioredis?: boolean | undefined;
+    grpc?: boolean | undefined;
+    fs?: boolean | undefined;
+    dns?: boolean | undefined;
+  } | undefined;
+}, {
+  tracing?: boolean | undefined;
+  metrics?: boolean | undefined;
+  logging?: boolean | undefined;
+  autoInstrumentation?: {
+    http?: boolean | undefined;
+    fastify?: boolean | undefined;
+    express?: boolean | undefined;
+    mongodb?: boolean | undefined;
+    pg?: boolean | undefined;
+    mysql?: boolean | undefined;
+    redis?: boolean | undefined;
+    ioredis?: boolean | undefined;
+    grpc?: boolean | undefined;
+    fs?: boolean | undefined;
+    dns?: boolean | undefined;
+  } | undefined;
+}>;
+type FeaturesConfig = z.infer<typeof FeaturesConfigSchema>;
+declare const OtelConfigSchema: z.ZodObject<{
+  endpoint: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+  metricsIntervalMs: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+  traceSampleRate: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+  endpoint?: string | undefined;
+  metricsIntervalMs?: number | undefined;
+  traceSampleRate?: number | undefined;
+}, {
+  endpoint?: string | undefined;
+  metricsIntervalMs?: number | undefined;
+  traceSampleRate?: number | undefined;
+}>;
+type OtelConfig = z.infer<typeof OtelConfigSchema>;
+declare const LoggingConfigSchema: z.ZodObject<{
+  level: z.ZodOptional<z.ZodDefault<z.ZodEnum<["debug", "info", "warn", "error"]>>>;
+  prettyPrint: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+  level?: "debug" | "info" | "warn" | "error" | undefined;
+  prettyPrint?: boolean | undefined;
+}, {
+  level?: "debug" | "info" | "warn" | "error" | undefined;
+  prettyPrint?: boolean | undefined;
+}>;
+type LoggingConfig = z.infer<typeof LoggingConfigSchema>;
+declare const RequestLoggingConfigSchema: z.ZodObject<{
+  logHeaders: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+  logBody: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+  logResponseBody: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+  maxBodySize: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+  redactHeaders: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+}, "strip", z.ZodTypeAny, {
+  logHeaders?: boolean | undefined;
+  logBody?: boolean | undefined;
+  logResponseBody?: boolean | undefined;
+  maxBodySize?: number | undefined;
+  redactHeaders?: string[] | undefined;
+}, {
+  logHeaders?: boolean | undefined;
+  logBody?: boolean | undefined;
+  logResponseBody?: boolean | undefined;
+  maxBodySize?: number | undefined;
+  redactHeaders?: string[] | undefined;
+}>;
+type RequestLoggingConfig = z.infer<typeof RequestLoggingConfigSchema>;
+declare const FoundationConfigSchema: z.ZodObject<{
+  serviceName: z.ZodString;
+  serviceVersion: z.ZodDefault<z.ZodString>;
+  environment: z.ZodDefault<z.ZodEnum<["development", "staging", "qa", "production"]>>;
+  features: z.ZodDefault<z.ZodObject<{
+    tracing: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    metrics: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    logging: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    autoInstrumentation: z.ZodOptional<z.ZodDefault<z.ZodObject<{
+      http: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+      fastify: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+      express: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+      mongodb: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+      pg: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+      mysql: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+      redis: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+      ioredis: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+      grpc: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+      fs: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+      dns: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+      http?: boolean | undefined;
+      fastify?: boolean | undefined;
+      express?: boolean | undefined;
+      mongodb?: boolean | undefined;
+      pg?: boolean | undefined;
+      mysql?: boolean | undefined;
+      redis?: boolean | undefined;
+      ioredis?: boolean | undefined;
+      grpc?: boolean | undefined;
+      fs?: boolean | undefined;
+      dns?: boolean | undefined;
+    }, {
+      http?: boolean | undefined;
+      fastify?: boolean | undefined;
+      express?: boolean | undefined;
+      mongodb?: boolean | undefined;
+      pg?: boolean | undefined;
+      mysql?: boolean | undefined;
+      redis?: boolean | undefined;
+      ioredis?: boolean | undefined;
+      grpc?: boolean | undefined;
+      fs?: boolean | undefined;
+      dns?: boolean | undefined;
+    }>>>;
+  }, "strip", z.ZodTypeAny, {
+    tracing?: boolean | undefined;
+    metrics?: boolean | undefined;
+    logging?: boolean | undefined;
+    autoInstrumentation?: {
+      http?: boolean | undefined;
+      fastify?: boolean | undefined;
+      express?: boolean | undefined;
+      mongodb?: boolean | undefined;
+      pg?: boolean | undefined;
+      mysql?: boolean | undefined;
+      redis?: boolean | undefined;
+      ioredis?: boolean | undefined;
+      grpc?: boolean | undefined;
+      fs?: boolean | undefined;
+      dns?: boolean | undefined;
+    } | undefined;
+  }, {
+    tracing?: boolean | undefined;
+    metrics?: boolean | undefined;
+    logging?: boolean | undefined;
+    autoInstrumentation?: {
+      http?: boolean | undefined;
+      fastify?: boolean | undefined;
+      express?: boolean | undefined;
+      mongodb?: boolean | undefined;
+      pg?: boolean | undefined;
+      mysql?: boolean | undefined;
+      redis?: boolean | undefined;
+      ioredis?: boolean | undefined;
+      grpc?: boolean | undefined;
+      fs?: boolean | undefined;
+      dns?: boolean | undefined;
+    } | undefined;
+  }>>;
+  otel: z.ZodDefault<z.ZodObject<{
+    endpoint: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    metricsIntervalMs: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    traceSampleRate: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+  }, "strip", z.ZodTypeAny, {
+    endpoint?: string | undefined;
+    metricsIntervalMs?: number | undefined;
+    traceSampleRate?: number | undefined;
+  }, {
+    endpoint?: string | undefined;
+    metricsIntervalMs?: number | undefined;
+    traceSampleRate?: number | undefined;
+  }>>;
+  logging: z.ZodDefault<z.ZodObject<{
+    level: z.ZodOptional<z.ZodDefault<z.ZodEnum<["debug", "info", "warn", "error"]>>>;
+    prettyPrint: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+  }, "strip", z.ZodTypeAny, {
+    level?: "debug" | "info" | "warn" | "error" | undefined;
+    prettyPrint?: boolean | undefined;
+  }, {
+    level?: "debug" | "info" | "warn" | "error" | undefined;
+    prettyPrint?: boolean | undefined;
+  }>>;
+  requestLogging: z.ZodDefault<z.ZodObject<{
+    logHeaders: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    logBody: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    logResponseBody: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    maxBodySize: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    redactHeaders: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+  }, "strip", z.ZodTypeAny, {
+    logHeaders?: boolean | undefined;
+    logBody?: boolean | undefined;
+    logResponseBody?: boolean | undefined;
+    maxBodySize?: number | undefined;
+    redactHeaders?: string[] | undefined;
+  }, {
+    logHeaders?: boolean | undefined;
+    logBody?: boolean | undefined;
+    logResponseBody?: boolean | undefined;
+    maxBodySize?: number | undefined;
+    redactHeaders?: string[] | undefined;
+  }>>;
+}, "strip", z.ZodTypeAny, {
+  logging: {
+    level?: "debug" | "info" | "warn" | "error" | undefined;
+    prettyPrint?: boolean | undefined;
+  };
+  serviceName: string;
+  serviceVersion: string;
+  environment: "development" | "staging" | "qa" | "production";
+  features: {
+    tracing?: boolean | undefined;
+    metrics?: boolean | undefined;
+    logging?: boolean | undefined;
+    autoInstrumentation?: {
+      http?: boolean | undefined;
+      fastify?: boolean | undefined;
+      express?: boolean | undefined;
+      mongodb?: boolean | undefined;
+      pg?: boolean | undefined;
+      mysql?: boolean | undefined;
+      redis?: boolean | undefined;
+      ioredis?: boolean | undefined;
+      grpc?: boolean | undefined;
+      fs?: boolean | undefined;
+      dns?: boolean | undefined;
+    } | undefined;
+  };
+  otel: {
+    endpoint?: string | undefined;
+    metricsIntervalMs?: number | undefined;
+    traceSampleRate?: number | undefined;
+  };
+  requestLogging: {
+    logHeaders?: boolean | undefined;
+    logBody?: boolean | undefined;
+    logResponseBody?: boolean | undefined;
+    maxBodySize?: number | undefined;
+    redactHeaders?: string[] | undefined;
+  };
+}, {
+  serviceName: string;
+  logging?: {
+    level?: "debug" | "info" | "warn" | "error" | undefined;
+    prettyPrint?: boolean | undefined;
+  } | undefined;
+  serviceVersion?: string | undefined;
+  environment?: "development" | "staging" | "qa" | "production" | undefined;
+  features?: {
+    tracing?: boolean | undefined;
+    metrics?: boolean | undefined;
+    logging?: boolean | undefined;
+    autoInstrumentation?: {
+      http?: boolean | undefined;
+      fastify?: boolean | undefined;
+      express?: boolean | undefined;
+      mongodb?: boolean | undefined;
+      pg?: boolean | undefined;
+      mysql?: boolean | undefined;
+      redis?: boolean | undefined;
+      ioredis?: boolean | undefined;
+      grpc?: boolean | undefined;
+      fs?: boolean | undefined;
+      dns?: boolean | undefined;
+    } | undefined;
+  } | undefined;
+  otel?: {
+    endpoint?: string | undefined;
+    metricsIntervalMs?: number | undefined;
+    traceSampleRate?: number | undefined;
+  } | undefined;
+  requestLogging?: {
+    logHeaders?: boolean | undefined;
+    logBody?: boolean | undefined;
+    logResponseBody?: boolean | undefined;
+    maxBodySize?: number | undefined;
+    redactHeaders?: string[] | undefined;
+  } | undefined;
+}>;
+type FoundationConfig = z.infer<typeof FoundationConfigSchema>;
+type FoundationConfigInput = Partial<FoundationConfig> & {
+  serviceName: string;
+};
+/** Parse and validate configuration */
+declare function parseConfig(input: FoundationConfigInput): FoundationConfig;
+/** Get default OTEL endpoint */
+declare function getDefaultOtelEndpoint(): string; //#endregion
+//#region src/features/context.d.ts
+
+//# sourceMappingURL=config.d.ts.map
 /**
- * @commerceiq/neoiq-foundation-node
- *
- * Node.js observability foundation for CommerceIQ services.
- * Integrates with Groundcover via OpenTelemetry.
- *
- * Flow: App → OpenTelemetry SDK → OTEL Collector → Groundcover
+ * Context Manager - AsyncLocalStorage for request context propagation
  */
-export { init, logger, getTracer, getMeter, getRequestContext, runWithContext, getTraceContext, shutdown, als, SpanStatusCode, type InitOptions, type RequestContext, } from './observability';
-export { observabilityPlugin, type PluginOptions } from './plugin';
-export { createHttpClient, type HttpClientOptions } from './http-client';
+interface RequestContext {
+  correlationId?: string;
+  traceId?: string;
+  spanId?: string;
+  startTime?: number;
+  [key: string]: unknown;
+}
+interface ContextManager {
+  getContext(): RequestContext | undefined;
+  run<T>(context: RequestContext, fn: () => T): T;
+  get<K extends keyof RequestContext>(key: K): RequestContext[K] | undefined;
+  update(updates: Partial<RequestContext>): RequestContext | undefined;
+}
+/** Create a new context manager instance */
+declare function createContextManager(): ContextManager;
+
+//#endregion
+//#region src/features/logging.d.ts
+//# sourceMappingURL=context.d.ts.map
+interface LoggerOptions {
+  serviceName: string;
+  serviceVersion: string;
+  environment: string;
+  level: 'debug' | 'info' | 'warn' | 'error';
+  prettyPrint: boolean;
+  contextManager?: ContextManager;
+}
+interface Logger {
+  debug: (obj: object, msg?: string) => void;
+  info: (obj: object, msg?: string) => void;
+  warn: (obj: object, msg?: string) => void;
+  error: (obj: object, msg?: string) => void;
+  child: (bindings: object) => Logger;
+  readonly pino: Logger$1;
+}
+/** Create a structured logger with automatic trace context injection */
+declare function createLogger(options: LoggerOptions): Logger;
+/** Fallback logger when Pino is not available */
+declare function createFallbackLogger(serviceName?: string): Logger;
+declare function setGlobalLogger(logger: Logger): void;
+declare function getGlobalLogger(): Logger;
+
+//#endregion
+//#region src/features/tracing.d.ts
+//# sourceMappingURL=logging.d.ts.map
+interface TracingOptions {
+  serviceName: string;
+  serviceVersion: string;
+  environment: string;
+  endpoint?: string;
+  sampleRate?: number;
+  autoInstrumentation?: AutoInstrumentationConfig;
+}
+/** Initialize OpenTelemetry tracing */
+declare function setupTracing(options: TracingOptions): void;
+/** Shutdown tracing gracefully */
+declare function shutdownTracing(): Promise<void>;
+declare function getTracer(name: string): Tracer;
+declare function getActiveSpan(): _opentelemetry_api0.Span | undefined;
+declare function getTraceContext(): {
+  traceId?: string;
+  spanId?: string;
+};
+declare function isTracingEnabled(): boolean;
+
+//#endregion
+//#region src/features/metrics.d.ts
+interface MetricsOptions {
+  serviceName: string;
+  serviceVersion: string;
+  environment: string;
+  endpoint?: string;
+  intervalMs?: number;
+}
+/** Initialize OpenTelemetry metrics */
+declare function setupMetrics(options: MetricsOptions): void;
+/** Shutdown metrics gracefully */
+declare function shutdownMetrics(): Promise<void>;
+declare function getMeter(name: string, version?: string): Meter;
+declare function isMetricsEnabled(): boolean;
+
+//#endregion
+//#region src/integrations/fastify-plugin.d.ts
+interface PluginRequestContext {
+  correlationId: string;
+  traceId: string;
+  spanId: string;
+  startTime: number;
+  [key: string]: unknown;
+}
+interface RequestLoggingOptions {
+  logHeaders?: boolean;
+  logBody?: boolean;
+  logResponseBody?: boolean;
+  maxBodySize?: number;
+  redactHeaders?: string[];
+}
+interface FastifyPluginOptions {
+  serviceName: string;
+  logger?: Logger;
+  contextManager?: ContextManager;
+  tracingEnabled?: boolean;
+  metricsEnabled?: boolean;
+  excludeRoutes?: string[];
+  /** Request/response logging options */
+  requestLogging?: RequestLoggingOptions;
+}
+declare module 'fastify' {
+  interface FastifyRequest {
+    __span?: Span;
+    __requestContext?: PluginRequestContext;
+  }
+}
+/** Create a configured Fastify observability plugin */
+declare function createObservabilityPlugin(options: FastifyPluginOptions): FastifyPluginAsync<Partial<FastifyPluginOptions>>;
+
+//#endregion
+//#region src/integrations/http-client.d.ts
+interface HttpClientOptions {
+  baseURL: string;
+  serviceName: string;
+  timeout?: number;
+  retry?: {
+    retries?: number;
+    retryDelay?: number;
+    retryStatusCodes?: number[];
+  };
+  circuitBreaker?: {
+    enabled?: boolean;
+    resetTimeout?: number;
+    errorThresholdPercentage?: number;
+  };
+  headers?: Record<string, string>;
+  foundation?: FoundationInstance;
+}
+type HttpClient = AxiosInstance;
+/** Create a configured HTTP client with full observability */
+declare function createHttpClient(options: HttpClientOptions): HttpClient;
+
+//#endregion
+//#region src/foundation.d.ts
+interface HealthStatus {
+  status: 'healthy' | 'degraded' | 'unhealthy';
+  timestamp: string;
+  service: string;
+  version: string;
+  uptime: number;
+  components: {
+    tracing: ComponentHealth;
+    metrics: ComponentHealth;
+    logging: ComponentHealth;
+  };
+}
+interface ComponentHealth {
+  enabled: boolean;
+  status: 'up' | 'down' | 'disabled';
+  message?: string;
+}
+interface FoundationInstance {
+  readonly config: FoundationConfig;
+  readonly logger: Logger;
+  readonly context: ContextManager;
+  readonly tracer: Tracer | null;
+  readonly meter: Meter | null;
+  readonly fastifyPlugin: ReturnType<typeof createObservabilityPlugin>;
+  readonly features: {
+    tracing: boolean;
+    metrics: boolean;
+    logging: boolean;
+  };
+  getTracer: (name?: string) => Tracer;
+  getMeter: (name: string, version?: string) => Meter;
+  getTraceContext: () => {
+    traceId?: string;
+    spanId?: string;
+  };
+  getActiveSpan: () => ReturnType<typeof getActiveSpan>;
+  createHttpClient: (options: Omit<HttpClientOptions, 'foundation'>) => HttpClient;
+  shutdown: () => Promise<void>;
+  isReady: () => boolean;
+  health: () => HealthStatus;
+  trace: <T>(name: string, fn: () => T | Promise<T>) => Promise<T>;
+  safeRun: <T>(fn: () => T | Promise<T>, fallback?: T) => Promise<T | undefined>;
+}
+/** Create a fully configured observability foundation */
+declare function createFoundation(input: FoundationConfigInput): FoundationInstance;
+/** Alias for createFoundation */
+declare const setupObservability: typeof createFoundation;
+
+//#endregion
+export { AutoInstrumentationConfig, AutoInstrumentationConfigSchema, AxiosInstance, AxiosRequestConfig, AxiosResponse, ComponentHealth, ContextManager, FastifyPluginOptions, FeaturesConfig, FeaturesConfigSchema, FoundationConfig, FoundationConfigInput, FoundationConfigSchema, FoundationInstance, HealthStatus, HttpClient, HttpClientOptions, Logger, LoggerOptions, LoggingConfig, LoggingConfigSchema, Meter, MetricsOptions, OtelConfig, OtelConfigSchema, RequestContext, RequestLoggingConfig, RequestLoggingConfigSchema, SpanStatusCode, Tracer, TracingOptions, context, createContextManager, createFallbackLogger, createFoundation, createHttpClient, createLogger, createObservabilityPlugin, getActiveSpan, getDefaultOtelEndpoint, getGlobalLogger, getMeter, getTraceContext, getTracer, isMetricsEnabled, isTracingEnabled, metrics, parseConfig, propagation, setGlobalLogger, setupMetrics, setupObservability, setupTracing, shutdownMetrics, shutdownTracing, trace };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,IAAI,EACJ,MAAM,EACN,SAAS,EACT,QAAQ,EACR,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,QAAQ,EACR,GAAG,EACH,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAGnE,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/config.ts","../src/features/context.ts","../src/features/logging.ts","../src/features/tracing.ts","../src/features/metrics.ts","../src/integrations/fastify-plugin.ts","../src/integrations/http-client.ts","../src/foundation.ts"],"sourcesContent":null,"mappings":"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"}