@fulmenhq/tsfulmen 0.3.3 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (123) hide show
  1. package/CHANGELOG.md +76 -1
  2. package/README.md +30 -1
  3. package/config/crucible-ts/taxonomy/metrics.yaml +1 -1
  4. package/dist/appidentity/index.js +9 -2209
  5. package/dist/appidentity/index.js.map +1 -1
  6. package/dist/assets/index.d.ts +184 -0
  7. package/dist/assets/index.js +4 -0
  8. package/dist/assets/index.js.map +1 -0
  9. package/dist/bin/prometheus-cli.js +15 -9139
  10. package/dist/bin/prometheus-cli.js.map +1 -1
  11. package/dist/bin/schema-cli.js +4 -6098
  12. package/dist/bin/schema-cli.js.map +1 -1
  13. package/dist/bin/signals-cli.js +15 -1910
  14. package/dist/bin/signals-cli.js.map +1 -1
  15. package/dist/chunk-24BAF63H.js +194 -0
  16. package/dist/chunk-24BAF63H.js.map +1 -0
  17. package/dist/chunk-3HISR2XI.js +36 -0
  18. package/dist/chunk-3HISR2XI.js.map +1 -0
  19. package/dist/chunk-56F2EEAG.js +328 -0
  20. package/dist/chunk-56F2EEAG.js.map +1 -0
  21. package/dist/chunk-5HZEJGZ5.js +725 -0
  22. package/dist/chunk-5HZEJGZ5.js.map +1 -0
  23. package/dist/chunk-7YWACZEJ.js +837 -0
  24. package/dist/chunk-7YWACZEJ.js.map +1 -0
  25. package/dist/chunk-BCO3FUUO.js +682 -0
  26. package/dist/chunk-BCO3FUUO.js.map +1 -0
  27. package/dist/chunk-GOTEQYAD.js +410 -0
  28. package/dist/chunk-GOTEQYAD.js.map +1 -0
  29. package/dist/chunk-HY6JQOFN.js +32 -0
  30. package/dist/chunk-HY6JQOFN.js.map +1 -0
  31. package/dist/chunk-LMNAUTW7.js +43 -0
  32. package/dist/chunk-LMNAUTW7.js.map +1 -0
  33. package/dist/chunk-LWAH2UG7.js +103 -0
  34. package/dist/chunk-LWAH2UG7.js.map +1 -0
  35. package/dist/chunk-OHE2AOH4.js +273 -0
  36. package/dist/chunk-OHE2AOH4.js.map +1 -0
  37. package/dist/chunk-P3DNOZOG.js +1488 -0
  38. package/dist/chunk-P3DNOZOG.js.map +1 -0
  39. package/dist/chunk-PQ6TKPUN.js +27 -0
  40. package/dist/chunk-PQ6TKPUN.js.map +1 -0
  41. package/dist/chunk-QCCN6POA.js +211 -0
  42. package/dist/chunk-QCCN6POA.js.map +1 -0
  43. package/dist/chunk-QGTNV4U2.js +985 -0
  44. package/dist/chunk-QGTNV4U2.js.map +1 -0
  45. package/dist/chunk-RSLFR4TO.js +631 -0
  46. package/dist/chunk-RSLFR4TO.js.map +1 -0
  47. package/dist/chunk-SNV5WG5V.js +9412 -0
  48. package/dist/chunk-SNV5WG5V.js.map +1 -0
  49. package/dist/chunk-UP2VWCW5.js +33 -0
  50. package/dist/chunk-UP2VWCW5.js.map +1 -0
  51. package/dist/chunk-VJIGX7MH.js +208 -0
  52. package/dist/chunk-VJIGX7MH.js.map +1 -0
  53. package/dist/chunk-WCCMRVZF.js +130 -0
  54. package/dist/chunk-WCCMRVZF.js.map +1 -0
  55. package/dist/chunk-WSMVLWLB.js +269 -0
  56. package/dist/chunk-WSMVLWLB.js.map +1 -0
  57. package/dist/config/index.js +6 -1220
  58. package/dist/config/index.js.map +1 -1
  59. package/dist/crucible/fulpack/index.js +2 -25
  60. package/dist/crucible/fulpack/index.js.map +1 -1
  61. package/dist/crucible/index.js +13 -1129
  62. package/dist/crucible/index.js.map +1 -1
  63. package/dist/docscribe/index.js +2 -680
  64. package/dist/docscribe/index.js.map +1 -1
  65. package/dist/errors/index.js +5 -1831
  66. package/dist/errors/index.js.map +1 -1
  67. package/dist/errors-D7KXV3QW.js +4 -0
  68. package/dist/errors-D7KXV3QW.js.map +1 -0
  69. package/dist/errors-R7ZODJXS.js +8 -0
  70. package/dist/errors-R7ZODJXS.js.map +1 -0
  71. package/dist/export-EA3RNQNS.js +6 -0
  72. package/dist/export-EA3RNQNS.js.map +1 -0
  73. package/dist/foundry/index.js +340 -3949
  74. package/dist/foundry/index.js.map +1 -1
  75. package/dist/foundry/similarity/index.js +3 -134
  76. package/dist/foundry/similarity/index.js.map +1 -1
  77. package/dist/fulencode/index.js +3 -319
  78. package/dist/fulencode/index.js.map +1 -1
  79. package/dist/fulhash/index.js +3 -611
  80. package/dist/fulhash/index.js.map +1 -1
  81. package/dist/fulpack/index.js +3 -1515
  82. package/dist/fulpack/index.js.map +1 -1
  83. package/dist/hash-YOJYVOWH.js +4 -0
  84. package/dist/hash-YOJYVOWH.js.map +1 -0
  85. package/dist/index.d.ts +1 -1
  86. package/dist/index.js +14 -4395
  87. package/dist/index.js.map +1 -1
  88. package/dist/loader-VP2ZIC4O.js +9 -0
  89. package/dist/loader-VP2ZIC4O.js.map +1 -0
  90. package/dist/logging/index.js +2 -723
  91. package/dist/logging/index.js.map +1 -1
  92. package/dist/pathfinder/index.js +18 -2341
  93. package/dist/pathfinder/index.js.map +1 -1
  94. package/dist/prom-client-PNEBGD3G.js +4801 -0
  95. package/dist/prom-client-PNEBGD3G.js.map +1 -0
  96. package/dist/reports/license-inventory.csv +1 -1
  97. package/dist/schema/index.d.ts +19 -6
  98. package/dist/schema/index.js +4 -6148
  99. package/dist/schema/index.js.map +1 -1
  100. package/dist/signals/index.js +8 -2767
  101. package/dist/signals/index.js.map +1 -1
  102. package/dist/similarity/index.js +3 -134
  103. package/dist/similarity/index.js.map +1 -1
  104. package/dist/telemetry/http/index.js +9 -930
  105. package/dist/telemetry/http/index.js.map +1 -1
  106. package/dist/telemetry/index.js +4 -1561
  107. package/dist/telemetry/index.js.map +1 -1
  108. package/dist/telemetry/prometheus/index.js +7 -8422
  109. package/dist/telemetry/prometheus/index.js.map +1 -1
  110. package/dist/validator-I3ASDVDB.js +6 -0
  111. package/dist/validator-I3ASDVDB.js.map +1 -0
  112. package/package.json +5 -1
  113. package/schemas/crucible-ts/library/module-manifest/v1.0.0/module-manifest.schema.json +1 -1
  114. package/schemas/crucible-ts/observability/logging/v1.0.0/definitions.schema.json +1 -1
  115. package/schemas/crucible-ts/observability/logging/v1.0.0/log-event.schema.json +13 -13
  116. package/schemas/crucible-ts/observability/logging/v1.0.0/logger-config.schema.json +2 -2
  117. package/schemas/crucible-ts/observability/logging/v1.0.0/logging-policy.schema.json +1 -1
  118. package/schemas/crucible-ts/observability/logging/v1.0.0/middleware-config.schema.json +2 -2
  119. package/schemas/crucible-ts/observability/logging/v1.0.0/severity-filter.schema.json +3 -3
  120. package/schemas/crucible-ts/upstream/3leaps/crucible/PROVENANCE.md +3 -3
  121. package/schemas/crucible-ts/upstream/3leaps/crucible/docs/catalog/classifiers/README.md +1 -1
  122. package/schemas/crucible-ts/upstream/3leaps/crucible/docs/standards/classifiers-framework.md +1 -1
  123. package/schemas/crucible-ts/upstream/3leaps/crucible/docs/standards/data-sensitivity-classification.md +1 -1
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/telemetry/prometheus/constants.ts","../src/telemetry/prometheus/errors.ts","../src/telemetry/prometheus/exporter.ts","../src/telemetry/prometheus/lifecycle.ts","../src/telemetry/prometheus/server.ts"],"names":["metrics"],"mappings":"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","file":"chunk-7YWACZEJ.js","sourcesContent":["/**\n * Prometheus exporter constants\n *\n * ADR-0007 histogram buckets and metric names from Crucible v0.2.7 taxonomy.\n */\n\n/**\n * ADR-0007 histogram buckets for millisecond timing\n *\n * Buckets: 1ms, 5ms, 10ms, 50ms, 100ms, 500ms, 1s, 5s, 10s\n * Used for: MIME detection, error handling, FulHash operations\n */\nexport const ADR0007_BUCKETS_MS = [1, 5, 10, 50, 100, 500, 1000, 5000, 10000] as const;\n\n/**\n * ADR-0007 histogram buckets for second timing (refresh operations)\n *\n * Buckets: 1ms, 5ms, 10ms, 50ms, 100ms, 500ms, 1s, 5s, 10s (converted to seconds)\n * Used for: Prometheus exporter refresh duration\n */\nexport const ADR0007_BUCKETS_SECONDS = [\n 0.001, 0.005, 0.01, 0.05, 0.1, 0.5, 1.0, 5.0, 10.0,\n] as const;\n\n/**\n * Convert milliseconds to seconds for Prometheus histograms\n */\nexport function msToSeconds(ms: number): number {\n return ms / 1000;\n}\n\n/**\n * Prometheus exporter metric names (Crucible v0.2.7 taxonomy)\n */\nexport const PROMETHEUS_EXPORTER_METRICS = {\n // Refresh metrics\n REFRESH_DURATION_SECONDS: \"prometheus_exporter_refresh_duration_seconds\",\n REFRESH_TOTAL: \"prometheus_exporter_refresh_total\",\n REFRESH_ERRORS_TOTAL: \"prometheus_exporter_refresh_errors_total\",\n REFRESH_INFLIGHT: \"prometheus_exporter_refresh_inflight\",\n\n // HTTP metrics\n HTTP_REQUESTS_TOTAL: \"prometheus_exporter_http_requests_total\",\n HTTP_ERRORS_TOTAL: \"prometheus_exporter_http_errors_total\",\n\n // Restart metrics\n RESTARTS_TOTAL: \"prometheus_exporter_restarts_total\",\n} as const;\n\n/**\n * Foundry module metric names (Crucible v0.2.7 taxonomy)\n */\nexport const FOUNDRY_METRICS = {\n // MIME detection counters\n MIME_DETECTIONS_JSON: \"foundry_mime_detections_total_json\",\n MIME_DETECTIONS_XML: \"foundry_mime_detections_total_xml\",\n MIME_DETECTIONS_YAML: \"foundry_mime_detections_total_yaml\",\n MIME_DETECTIONS_CSV: \"foundry_mime_detections_total_csv\",\n MIME_DETECTIONS_PLAIN_TEXT: \"foundry_mime_detections_total_plain_text\",\n MIME_DETECTIONS_UNKNOWN: \"foundry_mime_detections_total_unknown\",\n\n // MIME detection timing histograms\n MIME_DETECTION_MS_JSON: \"foundry_mime_detection_ms_json\",\n MIME_DETECTION_MS_XML: \"foundry_mime_detection_ms_xml\",\n MIME_DETECTION_MS_YAML: \"foundry_mime_detection_ms_yaml\",\n MIME_DETECTION_MS_CSV: \"foundry_mime_detection_ms_csv\",\n MIME_DETECTION_MS_PLAIN_TEXT: \"foundry_mime_detection_ms_plain_text\",\n MIME_DETECTION_MS_UNKNOWN: \"foundry_mime_detection_ms_unknown\",\n\n // General lookup counter\n LOOKUP_COUNT: \"foundry_lookup_count\",\n} as const;\n\n/**\n * Error handling module metric names (Crucible v0.2.7 taxonomy)\n */\nexport const ERROR_HANDLING_METRICS = {\n WRAPS_TOTAL: \"error_handling_wraps_total\",\n WRAP_MS: \"error_handling_wrap_ms\",\n} as const;\n\n/**\n * FulHash module metric names (Crucible v0.2.7 taxonomy)\n */\nexport const FULHASH_METRICS = {\n // Algorithm-specific counters\n OPERATIONS_XXH3_128: \"fulhash_operations_total_xxh3_128\",\n OPERATIONS_SHA256: \"fulhash_operations_total_sha256\",\n\n // General counters\n HASH_STRING_TOTAL: \"fulhash_hash_string_total\",\n BYTES_HASHED_TOTAL: \"fulhash_bytes_hashed_total\",\n\n // Timing histogram\n OPERATION_MS: \"fulhash_operation_ms\",\n} as const;\n\n/**\n * Label values for Prometheus exporter metrics (taxonomy-compliant)\n */\nexport const EXPORTER_LABELS = {\n // Refresh phases\n PHASE_COLLECT: \"collect\",\n PHASE_CONVERT: \"convert\",\n PHASE_EXPORT: \"export\",\n\n // Results\n RESULT_SUCCESS: \"success\",\n RESULT_ERROR: \"error\",\n\n // Error types\n ERROR_VALIDATION: \"validation\",\n ERROR_IO: \"io\",\n ERROR_TIMEOUT: \"timeout\",\n ERROR_OTHER: \"other\",\n\n // Restart reasons\n REASON_CONFIG_CHANGE: \"config_change\",\n REASON_ERROR: \"error\",\n REASON_MANUAL: \"manual\",\n REASON_OTHER: \"other\",\n} as const;\n","/**\n * Prometheus exporter error classes\n *\n * Specialized errors for Prometheus integration failures.\n */\n\nimport { FulmenError } from \"../../errors/index.js\";\n\n/**\n * Base error class for Prometheus exporter errors\n */\nexport class PrometheusExporterError extends FulmenError {\n constructor(\n message: string,\n options?: {\n code?: string;\n cause?: unknown;\n context?: Record<string, unknown>;\n },\n ) {\n super({\n code: options?.code || \"PROMETHEUS_EXPORTER_ERROR\",\n message,\n severity: \"medium\",\n context: options?.context,\n });\n\n if (options?.cause) {\n this.cause = options.cause;\n }\n\n this.name = \"PrometheusExporterError\";\n }\n}\n\n/**\n * Error thrown when prom-client peer dependency is not installed\n */\nexport class PromClientNotFoundError extends PrometheusExporterError {\n constructor(cause?: unknown) {\n super(\n \"prom-client peer dependency not found. Install with: bun add prom-client\\n\" +\n \"For npm: npm install prom-client\\n\" +\n \"For more information, see: https://github.com/siimon/prom-client\",\n {\n code: \"PROM_CLIENT_NOT_FOUND\",\n cause,\n context: {\n suggestion: 'Run \"bun add prom-client\" to install the required peer dependency',\n },\n },\n );\n\n this.name = \"PromClientNotFoundError\";\n }\n}\n\n/**\n * Error thrown when metric name is invalid for Prometheus\n */\nexport class InvalidMetricNameError extends PrometheusExporterError {\n constructor(metricName: string, reason: string) {\n super(`Invalid Prometheus metric name: \"${metricName}\". ${reason}`, {\n code: \"INVALID_METRIC_NAME\",\n context: {\n metricName,\n reason,\n suggestion:\n \"Prometheus metric names must match: [a-zA-Z_:][a-zA-Z0-9_:]*\\n\" +\n \"See: https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels\",\n },\n });\n\n this.name = \"InvalidMetricNameError\";\n }\n}\n\n/**\n * Error thrown when label name is invalid for Prometheus\n */\nexport class InvalidLabelNameError extends PrometheusExporterError {\n constructor(labelName: string, reason: string) {\n super(`Invalid Prometheus label name: \"${labelName}\". ${reason}`, {\n code: \"INVALID_LABEL_NAME\",\n context: {\n labelName,\n reason,\n suggestion:\n \"Prometheus label names must match: [a-zA-Z_][a-zA-Z0-9_]*\\n\" +\n \"See: https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels\",\n },\n });\n\n this.name = \"InvalidLabelNameError\";\n }\n}\n\n/**\n * Error thrown when metric registration fails\n */\nexport class MetricRegistrationError extends PrometheusExporterError {\n constructor(metricName: string, cause: unknown) {\n super(`Failed to register Prometheus metric: \"${metricName}\"`, {\n code: \"METRIC_REGISTRATION_FAILED\",\n cause,\n context: {\n metricName,\n suggestion: \"Check for duplicate metric names or incompatible collector types\",\n },\n });\n\n this.name = \"MetricRegistrationError\";\n }\n}\n\n/**\n * Error thrown when refresh operation fails\n *\n * This error wraps underlying errors (InvalidMetricNameError, MetricRegistrationError, etc.)\n * that occur during the refresh process. Callers should inspect the `cause` property\n * to access the root error for specific error handling.\n *\n * @example\n * ```typescript\n * try {\n * await exporter.refresh();\n * } catch (err) {\n * if (err instanceof RefreshError) {\n * // Check the underlying cause for specific error types\n * if (err.cause instanceof InvalidMetricNameError) {\n * console.error('Invalid metric name:', err.cause.message);\n * }\n * }\n * }\n * ```\n */\nexport class RefreshError extends PrometheusExporterError {\n constructor(cause: unknown, context?: Record<string, unknown>) {\n super(\"Failed to refresh Prometheus metrics from TelemetryRegistry\", {\n code: \"REFRESH_FAILED\",\n cause,\n context,\n });\n\n this.name = \"RefreshError\";\n }\n}\n","/**\n * Prometheus exporter core implementation\n *\n * Bridges TSFulmen TelemetryRegistry to prom-client for Prometheus exposition.\n * Uses dynamic imports and loose typing for optional peer dependency (prom-client).\n *\n * NOTE: This file intentionally uses 'any' types for prom-client peer dependency\n * to avoid compile-time dependency. Runtime validation ensures type safety.\n * See .plans/active/v0.2.x-plans/prometheus-type-safety-enhancement.md for future work.\n */\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\nimport { metrics as defaultRegistry } from \"../index.js\";\nimport type { MetricsEvent } from \"../types.js\";\nimport { isHistogramSummary } from \"../types.js\";\nimport {\n ADR0007_BUCKETS_SECONDS,\n EXPORTER_LABELS,\n msToSeconds,\n PROMETHEUS_EXPORTER_METRICS,\n} from \"./constants.js\";\nimport {\n InvalidLabelNameError,\n InvalidMetricNameError,\n MetricRegistrationError,\n PromClientNotFoundError,\n RefreshError,\n} from \"./errors.js\";\nimport type { ExporterStats, PrometheusExporterOptions, RefreshOptions } from \"./types.js\";\n\n/**\n * Prometheus exporter\n *\n * Converts TSFulmen TelemetryRegistry metrics to Prometheus format using prom-client.\n *\n * @example\n * ```typescript\n * import { PrometheusExporter } from '@fulmenhq/tsfulmen/telemetry/prometheus';\n * import { metrics } from '@fulmenhq/tsfulmen/telemetry';\n *\n * // Create exporter\n * const exporter = new PrometheusExporter({\n * registry: metrics,\n * namespace: 'myapp',\n * defaultLabels: { environment: 'production' }\n * });\n *\n * // Refresh metrics from registry\n * await exporter.refresh();\n *\n * // Get Prometheus text format\n * const output = await exporter.getMetrics();\n * console.log(output);\n * ```\n */\nexport class PrometheusExporter {\n private readonly telemetryRegistry: typeof defaultRegistry;\n private namespace: string;\n private subsystem: string;\n private readonly defaultLabels: Record<string, string>;\n private readonly helpText: Record<string, string>;\n private readonly metricsEnabled: boolean;\n private readonly recordClientLabel: boolean;\n private readonly moduleMetricsEnabled: boolean;\n\n // prom-client types unavailable at compile time (optional peer dependency)\n // Using 'any' with runtime validation - see file header comment for rationale\n // biome-ignore lint/suspicious/noExplicitAny: prom-client is optional peer dependency\n private promClient: any = null;\n // biome-ignore lint/suspicious/noExplicitAny: prom-client Registry type unavailable at compile time\n private promRegistry: any = null;\n // biome-ignore lint/suspicious/noExplicitAny: prom-client Counter type unavailable at compile time\n private counters: Map<string, any> = new Map();\n // biome-ignore lint/suspicious/noExplicitAny: prom-client Gauge type unavailable at compile time\n private gauges: Map<string, any> = new Map();\n // biome-ignore lint/suspicious/noExplicitAny: prom-client Histogram type unavailable at compile time\n private histograms: Map<string, any> = new Map();\n\n // Statistics\n private refreshCount = 0;\n private errorCount = 0;\n private lastRefreshTime: string | null = null;\n\n // Background refresh loop\n private refreshInterval: NodeJS.Timeout | null = null;\n private refreshPromise: Promise<void> | null = null;\n private isRefreshing = false;\n\n /**\n * Create Prometheus exporter\n *\n * @param options - Exporter configuration\n * @throws {InvalidLabelNameError} If default label names are invalid\n */\n constructor(options: PrometheusExporterOptions = {}) {\n this.telemetryRegistry = options.registry || defaultRegistry;\n this.defaultLabels = options.defaultLabels || {};\n this.helpText = options.helpText || {};\n this.metricsEnabled = options.metricsEnabled ?? true;\n this.recordClientLabel = options.recordClientLabel ?? false;\n this.moduleMetricsEnabled = options.moduleMetricsEnabled ?? true;\n\n // Validate default label names\n for (const labelName of Object.keys(this.defaultLabels)) {\n this.validateLabelName(labelName);\n }\n\n // Initialize namespace and subsystem\n // May be overridden by App Identity in init()\n this.namespace = options.namespace || \"tsfulmen\";\n this.subsystem = options.subsystem || \"app\";\n }\n\n /**\n * Initialize exporter (async setup)\n *\n * Loads prom-client and optionally loads App Identity for namespace/subsystem.\n * Called automatically on first refresh() or getMetrics() call.\n *\n * @throws {PromClientNotFoundError} If prom-client not installed\n */\n private async init(): Promise<void> {\n if (this.promClient) {\n return; // Already initialized\n }\n\n // Lazy load prom-client (peer dependency)\n try {\n this.promClient = await import(\"prom-client\");\n this.promRegistry = new this.promClient.Registry();\n } catch (err) {\n throw new PromClientNotFoundError(err);\n }\n\n // Try to load App Identity for namespace/subsystem (optional)\n if (this.namespace === \"tsfulmen\" || this.subsystem === \"app\") {\n try {\n const { loadIdentity } = await import(\"../../appidentity/index.js\");\n const identity = await loadIdentity({ skipValidation: true });\n\n if (this.namespace === \"tsfulmen\" && identity.app.vendor) {\n this.namespace = identity.app.vendor;\n }\n if (this.subsystem === \"app\" && identity.app.binary_name) {\n this.subsystem = identity.app.binary_name;\n }\n } catch {\n // App Identity not available - use defaults\n }\n }\n }\n\n /**\n * Safely emit instrumentation metric (silently fails if registry doesn't support it)\n * Used to avoid breaking tests that use mock registries\n */\n private safeInstrument(fn: () => void): void {\n try {\n fn();\n } catch {\n // Silently ignore instrumentation failures (e.g., mock registries in tests)\n }\n }\n\n /**\n * Refresh metrics from TelemetryRegistry\n *\n * Exports current metrics from TelemetryRegistry and updates Prometheus collectors.\n * Emits instrumentation metrics per Crucible v0.2.7 taxonomy.\n *\n * @throws {RefreshError} If refresh operation fails. Inspect `error.cause` for the\n * underlying error (InvalidMetricNameError, MetricRegistrationError, etc.) to handle\n * specific failure conditions.\n */\n async refresh(): Promise<void> {\n const startTime = performance.now();\n\n // Set inflight gauge to 1\n this.safeInstrument(() => {\n this.telemetryRegistry.gauge(PROMETHEUS_EXPORTER_METRICS.REFRESH_INFLIGHT).set(1);\n });\n\n try {\n // Phase: collect - export from telemetry registry\n await this.init();\n const events = await this.telemetryRegistry.export();\n\n // Phase: convert - update Prometheus collectors\n for (const event of events) {\n this.updateCollector(event);\n }\n\n // Success metrics\n this.refreshCount++;\n this.lastRefreshTime = new Date().toISOString();\n\n const durationMs = performance.now() - startTime;\n\n // Emit success metrics\n this.safeInstrument(() => {\n this.telemetryRegistry\n .counter(PROMETHEUS_EXPORTER_METRICS.REFRESH_TOTAL)\n .inc(1, { result: EXPORTER_LABELS.RESULT_SUCCESS });\n\n this.telemetryRegistry\n .histogram(PROMETHEUS_EXPORTER_METRICS.REFRESH_DURATION_SECONDS, {\n buckets: [...ADR0007_BUCKETS_SECONDS],\n })\n .observe(msToSeconds(durationMs), {\n phase: EXPORTER_LABELS.PHASE_EXPORT,\n result: EXPORTER_LABELS.RESULT_SUCCESS,\n });\n });\n } catch (err) {\n this.errorCount++;\n\n const durationMs = performance.now() - startTime;\n\n // Classify error type\n let errorType: string = EXPORTER_LABELS.ERROR_OTHER;\n if (err instanceof InvalidMetricNameError || err instanceof InvalidLabelNameError) {\n errorType = EXPORTER_LABELS.ERROR_VALIDATION;\n } else if (err instanceof MetricRegistrationError) {\n errorType = EXPORTER_LABELS.ERROR_OTHER;\n }\n\n // Emit error metrics\n this.safeInstrument(() => {\n this.telemetryRegistry\n .counter(PROMETHEUS_EXPORTER_METRICS.REFRESH_TOTAL)\n .inc(1, { result: EXPORTER_LABELS.RESULT_ERROR });\n\n this.telemetryRegistry\n .counter(PROMETHEUS_EXPORTER_METRICS.REFRESH_ERRORS_TOTAL)\n .inc(1, { error_type: errorType });\n\n this.telemetryRegistry\n .histogram(PROMETHEUS_EXPORTER_METRICS.REFRESH_DURATION_SECONDS, {\n buckets: [...ADR0007_BUCKETS_SECONDS],\n })\n .observe(msToSeconds(durationMs), {\n phase: EXPORTER_LABELS.PHASE_EXPORT,\n result: EXPORTER_LABELS.RESULT_ERROR,\n });\n });\n\n throw new RefreshError(err, {\n refreshCount: this.refreshCount,\n errorCount: this.errorCount,\n });\n } finally {\n // Clear inflight gauge\n this.safeInstrument(() => {\n this.telemetryRegistry.gauge(PROMETHEUS_EXPORTER_METRICS.REFRESH_INFLIGHT).set(0);\n });\n }\n }\n\n /**\n * Get Prometheus metrics in text format\n *\n * Returns metrics in Prometheus exposition text format.\n *\n * @returns Prometheus text format string\n */\n async getMetrics(): Promise<string> {\n await this.init();\n\n if (!this.promRegistry) {\n throw new Error(\"Prometheus registry not initialized\");\n }\n\n return this.promRegistry.metrics();\n }\n\n /**\n * Get exporter statistics\n */\n getStats(): ExporterStats {\n return {\n refreshCount: this.refreshCount,\n errorCount: this.errorCount,\n lastRefreshTime: this.lastRefreshTime,\n metricsCount: this.counters.size + this.gauges.size + this.histograms.size,\n isRefreshing: this.isRefreshing,\n };\n }\n\n /**\n * Get current metrics configuration\n *\n * Returns effective configuration being used by exporter,\n * including defaults for any unspecified options.\n *\n * @returns Current metrics configuration\n */\n getMetricsConfig() {\n return {\n metricsEnabled: this.metricsEnabled,\n recordClientLabel: this.recordClientLabel,\n moduleMetricsEnabled: this.moduleMetricsEnabled,\n namespace: this.namespace,\n subsystem: this.subsystem,\n defaultLabels: { ...this.defaultLabels },\n helpText: { ...this.helpText },\n };\n }\n\n /**\n * Get underlying prom-client Registry\n *\n * Returns null if not yet initialized.\n * Use for advanced prom-client operations.\n */\n // biome-ignore lint/suspicious/noExplicitAny: Returns prom-client Registry type (optional peer dependency)\n getRegistry(): any {\n return this.promRegistry;\n }\n\n /**\n * Get telemetry registry for self-instrumentation\n *\n * Returns the MetricsRegistry instance used for exporter self-instrumentation.\n * Useful for HTTP handler instrumentation.\n *\n * @internal\n */\n getTelemetryRegistry(): typeof defaultRegistry {\n return this.telemetryRegistry;\n }\n\n /**\n * Emit restart metric\n *\n * Records a restart event for tracking exporter or server restarts.\n * Use this when restarting the HTTP metrics server or other exporter components.\n *\n * @param reason - Reason for restart (config_change, error, manual, other)\n *\n * @example\n * ```typescript\n * // Restart server after config change\n * await stopMetricsServer(server);\n * exporter.recordRestart('config_change');\n * const newServer = await startMetricsServer(exporter, newConfig);\n * ```\n */\n recordRestart(reason: \"config_change\" | \"error\" | \"manual\" | \"other\"): void {\n this.safeInstrument(() => {\n this.telemetryRegistry.counter(PROMETHEUS_EXPORTER_METRICS.RESTARTS_TOTAL).inc(1, { reason });\n });\n }\n\n /**\n * Reset all metrics\n */\n reset(): void {\n if (this.promRegistry) {\n this.promRegistry.clear();\n }\n this.counters.clear();\n this.gauges.clear();\n this.histograms.clear();\n }\n\n /**\n * Start background refresh loop\n *\n * Automatically refreshes metrics from TelemetryRegistry at specified interval.\n * Useful for long-running services where metrics should be continuously updated.\n *\n * @param options - Refresh configuration (interval, error handler)\n *\n * @example\n * ```typescript\n * const exporter = new PrometheusExporter({ registry: metrics });\n *\n * // Start refreshing every 15 seconds (default)\n * exporter.startRefresh();\n *\n * // Custom interval and error handling\n * exporter.startRefresh({\n * intervalMs: 10000,\n * onError: (err) => logger.error('Refresh failed:', err)\n * });\n * ```\n */\n startRefresh(options: RefreshOptions = {}): void {\n const intervalMs = options.intervalMs ?? 15000;\n const _isRestart = !!this.refreshInterval;\n\n // Stop existing refresh if running (restart scenario)\n if (this.refreshInterval) {\n this.stopRefresh();\n\n // Emit restart metric\n this.safeInstrument(() => {\n this.telemetryRegistry.counter(PROMETHEUS_EXPORTER_METRICS.RESTARTS_TOTAL).inc(1, {\n reason: options.restartReason || EXPORTER_LABELS.REASON_OTHER,\n });\n });\n }\n\n // Start refresh loop\n this.refreshInterval = setInterval(() => {\n // Don't start new refresh if one is already running (serialization)\n if (this.refreshPromise) {\n return;\n }\n\n this.refreshPromise = this.refresh()\n .catch((err) => {\n // Call error handler if provided\n if (options.onError) {\n options.onError(err as Error);\n }\n })\n .finally(() => {\n this.refreshPromise = null;\n });\n }, intervalMs);\n\n // Update stats to indicate refreshing\n this.isRefreshing = true;\n }\n\n /**\n * Stop background refresh loop\n *\n * Clears the refresh interval and performs one final refresh to capture\n * the latest metrics state before stopping.\n *\n * @example\n * ```typescript\n * // Graceful shutdown\n * await exporter.stopRefresh();\n * ```\n */\n async stopRefresh(): Promise<void> {\n if (this.refreshInterval) {\n clearInterval(this.refreshInterval);\n this.refreshInterval = null;\n }\n\n // Wait for any in-flight refresh to complete\n if (this.refreshPromise) {\n await this.refreshPromise;\n }\n\n // Perform final refresh to capture latest state\n try {\n await this.refresh();\n } catch (_err) {\n // Log but don't throw during shutdown\n // Error is already tracked in stats\n }\n\n // Update stats to indicate not refreshing\n this.isRefreshing = false;\n }\n\n /**\n * Update Prometheus collector from MetricsEvent\n */\n private updateCollector(event: MetricsEvent): void {\n const metricName = this.formatMetricName(event.name);\n const help = this.getHelpText(event.name);\n const labelNames = Object.keys(this.defaultLabels);\n\n if (isHistogramSummary(event.value)) {\n this.updateHistogram(metricName, help, labelNames, event.value);\n } else if (typeof event.value === \"number\") {\n // Use Gauge for all scalar metrics (simplest approach)\n // TSFulmen doesn't distinguish Counter vs Gauge in export format\n this.updateGauge(metricName, help, labelNames, event.value);\n }\n }\n\n /**\n * Update or create Prometheus Gauge\n */\n private updateGauge(name: string, help: string, labelNames: string[], value: number): void {\n let gauge = this.gauges.get(name);\n if (!gauge) {\n try {\n gauge = new this.promClient.Gauge({\n name,\n help,\n labelNames,\n registers: [this.promRegistry],\n });\n this.gauges.set(name, gauge);\n } catch (err) {\n throw new MetricRegistrationError(name, err);\n }\n }\n\n gauge.labels(this.defaultLabels).set(value);\n }\n\n /**\n * Update or create Prometheus Histogram\n *\n * CRITICAL: Converts OTLP cumulative buckets to Prometheus format.\n * This is an approximation - see Phase 0 investigation for details.\n *\n * LIMITATION: Original observations cannot be perfectly reconstructed from bucket summary.\n * Percentiles will be approximate based on bucket midpoints.\n */\n // biome-ignore lint/suspicious/noExplicitAny: summary is HistogramSummary from TelemetryRegistry\n private updateHistogram(name: string, help: string, labelNames: string[], summary: any): void {\n // biome-ignore lint/suspicious/noExplicitAny: bucket type from HistogramSummary\n const buckets = summary.buckets.map((b: any) => b.le);\n\n let histogram = this.histograms.get(name);\n if (!histogram) {\n try {\n histogram = new this.promClient.Histogram({\n name,\n help,\n labelNames,\n buckets,\n registers: [this.promRegistry],\n });\n this.histograms.set(name, histogram);\n } catch (err) {\n throw new MetricRegistrationError(name, err);\n }\n }\n\n // Reconstruct observations from summary\n const observations = this.reconstructObservations(summary);\n for (const value of observations) {\n histogram.labels(this.defaultLabels).observe(value);\n }\n }\n\n /**\n * Reconstruct observations from histogram summary\n *\n * Converts OTLP cumulative bucket counts to approximate observation values.\n * Uses bucket midpoints to generate synthetic observations.\n *\n * LIMITATION: This is an approximation. Original observation values cannot be\n * perfectly reconstructed from bucket summaries. Percentiles will be approximate\n * based on bucket boundaries. This is acceptable for v0.1.8 initial release.\n *\n * TODO: Future enhancement - capture raw observations in TelemetryRegistry\n * for lossless Prometheus export. Track in Phase 2+ planning.\n * See: .plans/active/v0.2.x-plans/prometheus-type-safety-enhancement.md\n *\n * Algorithm:\n * 1. Calculate non-cumulative count for each bucket (delta between adjacent buckets)\n * 2. For each bucket, place observations at the midpoint between bucket boundaries\n * 3. Return array of synthetic observation values\n */\n // biome-ignore lint/suspicious/noExplicitAny: summary is HistogramSummary from TelemetryRegistry\n private reconstructObservations(summary: any): number[] {\n const observations: number[] = [];\n const buckets = summary.buckets;\n\n if (!buckets || buckets.length === 0) {\n return observations;\n }\n\n let prevCount = 0;\n for (let i = 0; i < buckets.length; i++) {\n const bucket = buckets[i];\n const count = bucket.count - prevCount; // Non-cumulative count for this bucket\n\n if (count > 0) {\n // Determine observation value (bucket midpoint)\n let value: number;\n if (i === 0) {\n // First bucket: midpoint between 0 and upper bound\n value = bucket.le / 2;\n } else {\n // Other buckets: midpoint between previous and current upper bound\n const prevLe = buckets[i - 1].le;\n value = (prevLe + bucket.le) / 2;\n }\n\n // Add 'count' observations at this value\n for (let j = 0; j < count; j++) {\n observations.push(value);\n }\n }\n\n prevCount = bucket.count;\n }\n\n return observations;\n }\n\n /**\n * Format metric name with namespace and subsystem prefix\n *\n * Format: {namespace}_{subsystem}_{metric}\n * Example: fulmen_myapp_schema_validations\n */\n private formatMetricName(name: string): string {\n this.validateMetricName(name);\n return `${this.namespace}_${this.subsystem}_${name}`;\n }\n\n /**\n * Get help text for metric\n *\n * Uses custom help text if provided, otherwise generates default.\n */\n private getHelpText(name: string): string {\n if (this.helpText[name]) {\n return this.helpText[name];\n }\n return `TSFulmen metric: ${name}`;\n }\n\n /**\n * Validate Prometheus metric name\n *\n * Rules: Must start with [a-zA-Z_:] and contain only [a-zA-Z0-9_:]\n *\n * @throws {InvalidMetricNameError} If name is invalid\n */\n private validateMetricName(name: string): void {\n const validPattern = /^[a-zA-Z_:][a-zA-Z0-9_:]*$/;\n if (!validPattern.test(name)) {\n throw new InvalidMetricNameError(\n name,\n \"Metric names must start with [a-zA-Z_:] and contain only [a-zA-Z0-9_:]\",\n );\n }\n }\n\n /**\n * Validate Prometheus label name\n *\n * Rules: Must start with [a-zA-Z_] and contain only [a-zA-Z0-9_]\n *\n * @throws {InvalidLabelNameError} If name is invalid\n */\n private validateLabelName(name: string): void {\n const validPattern = /^[a-zA-Z_][a-zA-Z0-9_]*$/;\n if (!validPattern.test(name)) {\n throw new InvalidLabelNameError(\n name,\n \"Label names must start with [a-zA-Z_] and contain only [a-zA-Z0-9_]\",\n );\n }\n }\n}\n","/**\n * Prometheus exporter lifecycle integration\n *\n * Helpers for integrating PrometheusExporter with TSFulmen lifecycle management,\n * particularly signal handling for graceful shutdown.\n */\n\nimport type { SignalManager } from \"../../foundry/signals/index.js\";\nimport type { PrometheusExporter } from \"./exporter.js\";\n\n/**\n * Register Prometheus exporter shutdown handler\n *\n * Automatically stops the background refresh loop and performs a final refresh\n * when SIGTERM or SIGINT is received. This ensures metrics are up-to-date\n * before the process terminates.\n *\n * @param exporter - PrometheusExporter instance to manage\n * @param manager - SignalManager instance for lifecycle coordination\n *\n * @example\n * ```typescript\n * import { PrometheusExporter, registerPrometheusShutdown } from '@fulmenhq/tsfulmen/telemetry/prometheus';\n * import { createSignalManager } from '@fulmenhq/tsfulmen/foundry/signals';\n *\n * const exporter = new PrometheusExporter({ registry: metrics });\n * const signalManager = createSignalManager();\n *\n * // Register graceful shutdown\n * await registerPrometheusShutdown(exporter, signalManager);\n *\n * // Start refresh loop\n * exporter.startRefresh({ intervalMs: 15000 });\n *\n * // When SIGTERM/SIGINT received, exporter will:\n * // 1. Stop refresh loop\n * // 2. Perform final refresh\n * // 3. Allow process to exit gracefully\n * ```\n */\nexport async function registerPrometheusShutdown(\n exporter: PrometheusExporter,\n manager: SignalManager,\n): Promise<void> {\n const shutdownHandler = async () => {\n await exporter.stopRefresh();\n };\n\n // Register for both SIGTERM and SIGINT\n await manager.register(\"SIGTERM\", shutdownHandler);\n await manager.register(\"SIGINT\", shutdownHandler);\n}\n","/**\n * Prometheus HTTP server implementation\n *\n * Framework-agnostic HTTP handler and dev server for exposing Prometheus metrics.\n * Compatible with Node.js http, Express, Fastify, and other frameworks.\n */\n\nimport type { IncomingMessage, Server, ServerResponse } from \"node:http\";\nimport { createServer } from \"node:http\";\nimport { createLogger, LoggingProfile } from \"../../logging/index.js\";\nimport type { MetricsRegistry } from \"../registry.js\";\nimport { PROMETHEUS_EXPORTER_METRICS } from \"./constants.js\";\nimport type { PrometheusExporter } from \"./exporter.js\";\nimport type { ServerOptions } from \"./types.js\";\n\n/**\n * Safe instrumentation helper for HTTP metrics\n *\n * Emits HTTP metrics to provided registry, silently failing if registry\n * doesn't support operation (e.g., mock registries in tests).\n */\nfunction safeInstrumentHTTP(registry: MetricsRegistry | null, fn: () => void): void {\n if (!registry) return;\n try {\n fn();\n } catch {\n // Silently fail - instrumentation is non-critical\n }\n}\n\n/**\n * Get logger from exporter with metricsEnabled check\n */\nfunction getExporterLogger(exporter: PrometheusExporter) {\n // Access private logger property through type assertion\n // biome-ignore lint/suspicious/noExplicitAny: Need to access private logger property\n const exporterAny = exporter as any;\n const logger = exporterAny.logger;\n\n // Return null logger if metrics disabled\n return exporterAny.metricsEnabled ? logger : null;\n}\n\n/**\n * HTTP request context for hooks\n *\n * Provides minimal interface for auth and rate limiting hooks.\n * Compatible with Node.js IncomingMessage and framework request objects.\n */\nexport interface RequestContext {\n /** HTTP method (GET, POST, etc.) */\n method?: string;\n /** Request URL path */\n url?: string;\n /** Request headers */\n headers: Record<string, string | string[] | undefined>;\n /** Remote IP address */\n remoteAddress?: string;\n}\n\n/**\n * Extract request context from Node.js IncomingMessage\n */\nfunction extractRequestContext(req: IncomingMessage): RequestContext {\n return {\n method: req.method,\n url: req.url,\n headers: req.headers as Record<string, string | string[] | undefined>,\n remoteAddress: req.socket.remoteAddress,\n };\n}\n\n/**\n * Create Prometheus metrics HTTP handler\n *\n * Returns a framework-agnostic handler compatible with Node.js http, Express,\n * Fastify, and other frameworks. The handler serves Prometheus metrics in\n * text exposition format with optional authentication and rate limiting.\n *\n * @param exporter - PrometheusExporter instance\n * @param options - Server options (auth, rate limiting, refresh behavior)\n * @returns HTTP handler function\n *\n * @example\n * ```typescript\n * // Basic usage with Node.js http\n * import http from 'node:http';\n * import { PrometheusExporter, createMetricsHandler } from '@fulmenhq/tsfulmen/telemetry/prometheus';\n *\n * const exporter = new PrometheusExporter({ registry: metrics });\n * const handler = createMetricsHandler(exporter);\n *\n * const server = http.createServer(handler);\n * server.listen(9464);\n * ```\n *\n * @example\n * ```typescript\n * // With authentication\n * const handler = createMetricsHandler(exporter, {\n * authenticate: async (req) => {\n * const token = req.headers['authorization'];\n * return token === 'Bearer secret-token';\n * }\n * });\n * ```\n *\n * @example\n * ```typescript\n * // With rate limiting\n * const handler = createMetricsHandler(exporter, {\n * rateLimit: async (req) => {\n * const ip = req.remoteAddress;\n * return rateLimiter.checkLimit(ip);\n * }\n * });\n * ```\n */\nexport function createMetricsHandler(\n exporter: PrometheusExporter,\n options: ServerOptions = {},\n): (req: IncomingMessage, res: ServerResponse) => Promise<void> {\n const path = options.path ?? \"/metrics\";\n const refreshOnScrape = options.refreshOnScrape ?? false;\n const logger = getExporterLogger(exporter);\n\n return async (req: IncomingMessage, res: ServerResponse): Promise<void> => {\n const telemetryRegistry = exporter.getTelemetryRegistry();\n let _statusCode = 200;\n const startTime = performance.now();\n\n try {\n // Extract request context for hooks\n const context = extractRequestContext(req);\n\n // Check path - only serve metrics on configured path\n if (req.url !== path) {\n _statusCode = 404;\n res.writeHead(404, { \"Content-Type\": \"text/plain\" });\n res.end(\"Not Found\");\n\n // Emit HTTP request metric (4xx)\n safeInstrumentHTTP(telemetryRegistry, () => {\n telemetryRegistry\n .counter(PROMETHEUS_EXPORTER_METRICS.HTTP_REQUESTS_TOTAL)\n .inc(1, { status: \"404\", path: req.url || \"unknown\" });\n });\n return;\n }\n\n // Check authentication if hook provided\n if (options.authenticate) {\n const authResult = await options.authenticate(context);\n if (!authResult) {\n _statusCode = 401;\n res.writeHead(401, {\n \"Content-Type\": \"text/plain\",\n \"WWW-Authenticate\": \"Bearer\",\n });\n res.end(\"Unauthorized\");\n\n // Emit HTTP request and error metrics (auth failure)\n safeInstrumentHTTP(telemetryRegistry, () => {\n telemetryRegistry\n .counter(PROMETHEUS_EXPORTER_METRICS.HTTP_REQUESTS_TOTAL)\n .inc(1, { status: \"401\", path });\n telemetryRegistry\n .counter(PROMETHEUS_EXPORTER_METRICS.HTTP_ERRORS_TOTAL)\n .inc(1, { status: \"401\", path });\n });\n return;\n }\n }\n\n // Check rate limit if hook provided\n if (options.rateLimit) {\n const rateLimitResult = await options.rateLimit(context);\n if (!rateLimitResult) {\n _statusCode = 429;\n res.writeHead(429, {\n \"Content-Type\": \"text/plain\",\n \"Retry-After\": \"60\",\n });\n res.end(\"Too Many Requests\");\n\n // Emit HTTP request metric (4xx rate limit)\n safeInstrumentHTTP(telemetryRegistry, () => {\n telemetryRegistry\n .counter(PROMETHEUS_EXPORTER_METRICS.HTTP_REQUESTS_TOTAL)\n .inc(1, { status: \"429\", path });\n });\n return;\n }\n }\n\n // Refresh metrics if configured (optional, adds latency)\n if (refreshOnScrape) {\n await exporter.refresh();\n }\n\n // Get metrics in Prometheus text format\n const metrics = await exporter.getMetrics();\n\n // Send response with correct content-type\n // Prometheus text format version 0.0.4\n _statusCode = 200;\n res.writeHead(200, {\n \"Content-Type\": \"text/plain; version=0.0.4; charset=utf-8\",\n \"Content-Length\": Buffer.byteLength(metrics, \"utf-8\"),\n });\n res.end(metrics);\n\n // Emit HTTP request metric (2xx success)\n safeInstrumentHTTP(telemetryRegistry, () => {\n telemetryRegistry\n .counter(PROMETHEUS_EXPORTER_METRICS.HTTP_REQUESTS_TOTAL)\n .inc(1, { status: \"200\", path });\n });\n } catch (err) {\n // Internal server error\n const errorMessage = err instanceof Error ? err.message : \"Internal Server Error\";\n\n _statusCode = 500;\n res.writeHead(500, { \"Content-Type\": \"text/plain\" });\n res.end(`Error: ${errorMessage}`);\n\n // Emit HTTP request and error metrics (5xx failure)\n safeInstrumentHTTP(telemetryRegistry, () => {\n telemetryRegistry\n .counter(PROMETHEUS_EXPORTER_METRICS.HTTP_REQUESTS_TOTAL)\n .inc(1, { status: \"500\", path });\n telemetryRegistry\n .counter(PROMETHEUS_EXPORTER_METRICS.HTTP_ERRORS_TOTAL)\n .inc(1, { status: \"500\", path });\n });\n } finally {\n // Log HTTP request completion\n if (logger) {\n const durationMs = performance.now() - startTime;\n const context = extractRequestContext(req);\n\n logger.info(\"HTTP request processed\", {\n metric_name: PROMETHEUS_EXPORTER_METRICS.HTTP_REQUESTS_TOTAL,\n status: _statusCode.toString(),\n path: req.url || \"unknown\",\n method: context.method || \"GET\",\n duration_ms: Math.round(durationMs),\n remote_address: context.remoteAddress,\n });\n }\n }\n };\n}\n\n/**\n * Start Prometheus metrics dev server\n *\n * Creates a standalone HTTP server for serving Prometheus metrics.\n * Useful for development, testing, and simple deployments without a full application framework.\n *\n * @param exporter - PrometheusExporter instance\n * @param options - Server configuration (host, port, path, auth, rate limiting)\n * @returns Promise that resolves to the HTTP Server instance\n *\n * @example\n * ```typescript\n * import { PrometheusExporter, startMetricsServer } from '@fulmenhq/tsfulmen/telemetry/prometheus';\n *\n * const exporter = new PrometheusExporter({ registry: metrics });\n *\n * // Start dev server\n * const server = await startMetricsServer(exporter, {\n * host: '127.0.0.1',\n * port: 9464,\n * path: '/metrics'\n * });\n *\n * console.log('Metrics server listening on http://127.0.0.1:9464/metrics');\n *\n * // Graceful shutdown\n * process.on('SIGTERM', async () => {\n * await stopMetricsServer(server);\n * });\n * ```\n */\nexport async function startMetricsServer(\n exporter: PrometheusExporter,\n options: ServerOptions = {},\n): Promise<Server> {\n const host = options.host ?? \"127.0.0.1\";\n const port = options.port ?? 9464;\n const path = options.path ?? \"/metrics\";\n\n // Create handler with options\n const handler = createMetricsHandler(exporter, options);\n\n // Create HTTP server\n const server = createServer(handler);\n\n // Create logger for server operations (only if metrics enabled)\n const exporterLogger = getExporterLogger(exporter);\n const logger =\n exporterLogger ||\n createLogger({\n service: \"prometheus_exporter\",\n profile: LoggingProfile.STRUCTURED,\n });\n\n // Start listening\n return new Promise((resolve, reject) => {\n server.listen(port, host, () => {\n // Log server startup\n logger.info(\"Prometheus metrics server started\", {\n host,\n port,\n path,\n url: `http://${host}:${port}${path}`,\n });\n resolve(server);\n });\n\n server.on(\"error\", (err) => {\n // Log server error\n logger.error(\"Prometheus metrics server error\", err as Error, {\n host,\n port,\n path,\n });\n reject(err);\n });\n });\n}\n\n/**\n * Stop Prometheus metrics server\n *\n * Gracefully shuts down the HTTP server with a configurable timeout.\n * Closes all connections and waits for in-flight requests to complete.\n *\n * @param server - HTTP Server instance from startMetricsServer\n * @param timeoutMs - Timeout in milliseconds (default: 5000)\n * @returns Promise that resolves when server is closed\n *\n * @example\n * ```typescript\n * // Graceful shutdown with 5 second timeout\n * await stopMetricsServer(server);\n *\n * // Custom timeout\n * await stopMetricsServer(server, 10000);\n * ```\n */\nexport async function stopMetricsServer(\n server: Server,\n timeoutMs = 5000,\n exporter?: PrometheusExporter,\n): Promise<void> {\n // Create logger for server operations (only if metrics enabled)\n const exporterLogger = exporter ? getExporterLogger(exporter) : null;\n const logger =\n exporterLogger ||\n createLogger({\n service: \"prometheus_exporter\",\n profile: LoggingProfile.STRUCTURED,\n });\n\n return new Promise((resolve, reject) => {\n // Set timeout for forced shutdown\n const timeout = setTimeout(() => {\n logger.warn(\"Prometheus metrics server shutdown timed out, forcing close\", {\n timeout_ms: timeoutMs,\n });\n server.closeAllConnections?.(); // Available in Node.js 18.2+\n reject(new Error(`Server shutdown timeout after ${timeoutMs}ms`));\n }, timeoutMs);\n\n // Graceful close\n server.close((err) => {\n clearTimeout(timeout);\n if (err) {\n logger.error(\"Error stopping Prometheus metrics server\", err, {\n timeout_ms: timeoutMs,\n });\n reject(err);\n } else {\n logger.info(\"Prometheus metrics server stopped\", {\n timeout_ms: timeoutMs,\n });\n resolve();\n }\n });\n\n // Close all connections immediately (allows graceful request completion)\n server.closeAllConnections?.(); // Available in Node.js 18.2+\n });\n}\n"]}