@superblocksteam/telemetry 2.0.171 → 2.0.173-next.0

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 (304) hide show
  1. package/dist/browser/console-logging.js +2 -7
  2. package/dist/browser/console-logging.js.map +1 -1
  3. package/dist/browser/early-console-buffer.js +12 -14
  4. package/dist/browser/early-console-buffer.js.map +1 -1
  5. package/dist/browser/index.js +12 -41
  6. package/dist/browser/index.js.map +1 -1
  7. package/dist/browser/init.d.ts +1 -1
  8. package/dist/browser/init.d.ts.map +1 -1
  9. package/dist/browser/init.js +42 -52
  10. package/dist/browser/init.js.map +1 -1
  11. package/dist/browser/instrumentations.js +11 -15
  12. package/dist/browser/instrumentations.js.map +1 -1
  13. package/dist/browser/logs.d.ts +1 -1
  14. package/dist/browser/logs.d.ts.map +1 -1
  15. package/dist/browser/logs.js +11 -18
  16. package/dist/browser/logs.js.map +1 -1
  17. package/dist/browser/metrics.js +9 -12
  18. package/dist/browser/metrics.js.map +1 -1
  19. package/dist/browser/resilient-exporter.d.ts +1 -1
  20. package/dist/browser/resilient-exporter.d.ts.map +1 -1
  21. package/dist/browser/resilient-exporter.js +8 -12
  22. package/dist/browser/resilient-exporter.js.map +1 -1
  23. package/dist/browser/sanitizer.js +2 -6
  24. package/dist/browser/sanitizer.js.map +1 -1
  25. package/dist/browser/traced-socket.js +14 -18
  26. package/dist/browser/traced-socket.js.map +1 -1
  27. package/dist/common/contracts/tier2-traces.js +33 -44
  28. package/dist/common/contracts/tier2-traces.js.map +1 -1
  29. package/dist/common/deployment-type.js +5 -8
  30. package/dist/common/deployment-type.js.map +1 -1
  31. package/dist/common/guardrails.js +26 -38
  32. package/dist/common/guardrails.js.map +1 -1
  33. package/dist/common/index.js +8 -24
  34. package/dist/common/index.js.map +1 -1
  35. package/dist/common/log-sanitizer.js +37 -55
  36. package/dist/common/log-sanitizer.js.map +1 -1
  37. package/dist/common/policy-evaluator.d.ts +1 -1
  38. package/dist/common/policy-evaluator.d.ts.map +1 -1
  39. package/dist/common/policy-evaluator.js +5 -9
  40. package/dist/common/policy-evaluator.js.map +1 -1
  41. package/dist/common/resource.js +18 -25
  42. package/dist/common/resource.js.map +1 -1
  43. package/dist/common/tier-hints.js +12 -22
  44. package/dist/common/tier-hints.js.map +1 -1
  45. package/dist/common/trace-sanitizer.js +6 -10
  46. package/dist/common/trace-sanitizer.js.map +1 -1
  47. package/dist/common/traced-socket-types.js +1 -2
  48. package/dist/common/traced-socket-types.js.map +1 -1
  49. package/dist/index.js +6 -38
  50. package/dist/index.js.map +1 -1
  51. package/dist/lint/forbidden-attributes.js +19 -24
  52. package/dist/lint/forbidden-attributes.js.map +1 -1
  53. package/dist/lint/index.js +1 -8
  54. package/dist/lint/index.js.map +1 -1
  55. package/dist/llmobs/index.js +2 -9
  56. package/dist/llmobs/index.js.map +1 -1
  57. package/dist/llmobs/tier1-exporter.js +6 -12
  58. package/dist/llmobs/tier1-exporter.js.map +1 -1
  59. package/dist/llmobs/tier2-summarizer.js +1 -5
  60. package/dist/llmobs/tier2-summarizer.js.map +1 -1
  61. package/dist/node/dynamic-attribute-processor.js +2 -7
  62. package/dist/node/dynamic-attribute-processor.js.map +1 -1
  63. package/dist/node/exporters/resilient-exporter.d.ts +1 -1
  64. package/dist/node/exporters/resilient-exporter.d.ts.map +1 -1
  65. package/dist/node/exporters/resilient-exporter.js +8 -12
  66. package/dist/node/exporters/resilient-exporter.js.map +1 -1
  67. package/dist/node/index.js +7 -26
  68. package/dist/node/index.js.map +1 -1
  69. package/dist/node/init.d.ts +3 -3
  70. package/dist/node/init.d.ts.map +1 -1
  71. package/dist/node/init.js +66 -72
  72. package/dist/node/init.js.map +1 -1
  73. package/dist/node/local-obs-mode.js +1 -4
  74. package/dist/node/local-obs-mode.js.map +1 -1
  75. package/dist/node/log-processor.d.ts +1 -1
  76. package/dist/node/log-processor.d.ts.map +1 -1
  77. package/dist/node/log-processor.js +47 -55
  78. package/dist/node/log-processor.js.map +1 -1
  79. package/dist/node/metrics-client.js +1 -5
  80. package/dist/node/metrics-client.js.map +1 -1
  81. package/dist/node/safe-logger.js +8 -12
  82. package/dist/node/safe-logger.js.map +1 -1
  83. package/dist/node/sanitizing-processor.d.ts +2 -2
  84. package/dist/node/sanitizing-processor.d.ts.map +1 -1
  85. package/dist/node/sanitizing-processor.js +6 -10
  86. package/dist/node/sanitizing-processor.js.map +1 -1
  87. package/dist/node/service-tracers.js +7 -10
  88. package/dist/node/service-tracers.js.map +1 -1
  89. package/dist/node/traced-socket.d.ts +3 -3
  90. package/dist/node/traced-socket.d.ts.map +1 -1
  91. package/dist/node/traced-socket.js +48 -52
  92. package/dist/node/traced-socket.js.map +1 -1
  93. package/dist/npm-registry/emitter.js +34 -47
  94. package/dist/npm-registry/emitter.js.map +1 -1
  95. package/dist/npm-registry/index.js +3 -19
  96. package/dist/npm-registry/index.js.map +1 -1
  97. package/dist/npm-registry/sanitize.js +16 -27
  98. package/dist/npm-registry/sanitize.js.map +1 -1
  99. package/dist/npm-registry/spans.js +7 -12
  100. package/dist/npm-registry/spans.js.map +1 -1
  101. package/dist/testing/in-memory-exporter.d.ts +1 -1
  102. package/dist/testing/in-memory-exporter.d.ts.map +1 -1
  103. package/dist/testing/in-memory-exporter.js +6 -12
  104. package/dist/testing/in-memory-exporter.js.map +1 -1
  105. package/dist/testing/index.js +3 -15
  106. package/dist/testing/index.js.map +1 -1
  107. package/dist/testing/metrics-capture.js +12 -15
  108. package/dist/testing/metrics-capture.js.map +1 -1
  109. package/dist/testing/test-init.js +24 -31
  110. package/dist/testing/test-init.js.map +1 -1
  111. package/dist/types/index.js +1 -17
  112. package/dist/types/index.js.map +1 -1
  113. package/dist/types/policy.js +21 -24
  114. package/dist/types/policy.js.map +1 -1
  115. package/package.json +11 -17
  116. package/dist-esm/browser/console-logging.d.ts +0 -18
  117. package/dist-esm/browser/console-logging.d.ts.map +0 -1
  118. package/dist-esm/browser/console-logging.js +0 -27
  119. package/dist-esm/browser/console-logging.js.map +0 -1
  120. package/dist-esm/browser/early-console-buffer.d.ts +0 -49
  121. package/dist-esm/browser/early-console-buffer.d.ts.map +0 -1
  122. package/dist-esm/browser/early-console-buffer.js +0 -181
  123. package/dist-esm/browser/early-console-buffer.js.map +0 -1
  124. package/dist-esm/browser/index.d.ts +0 -18
  125. package/dist-esm/browser/index.d.ts.map +0 -1
  126. package/dist-esm/browser/index.js +0 -23
  127. package/dist-esm/browser/index.js.map +0 -1
  128. package/dist-esm/browser/init.d.ts +0 -100
  129. package/dist-esm/browser/init.d.ts.map +0 -1
  130. package/dist-esm/browser/init.js +0 -317
  131. package/dist-esm/browser/init.js.map +0 -1
  132. package/dist-esm/browser/instrumentations.d.ts +0 -67
  133. package/dist-esm/browser/instrumentations.d.ts.map +0 -1
  134. package/dist-esm/browser/instrumentations.js +0 -79
  135. package/dist-esm/browser/instrumentations.js.map +0 -1
  136. package/dist-esm/browser/logs.d.ts +0 -57
  137. package/dist-esm/browser/logs.d.ts.map +0 -1
  138. package/dist-esm/browser/logs.js +0 -80
  139. package/dist-esm/browser/logs.js.map +0 -1
  140. package/dist-esm/browser/metrics.d.ts +0 -29
  141. package/dist-esm/browser/metrics.d.ts.map +0 -1
  142. package/dist-esm/browser/metrics.js +0 -46
  143. package/dist-esm/browser/metrics.js.map +0 -1
  144. package/dist-esm/browser/resilient-exporter.d.ts +0 -43
  145. package/dist-esm/browser/resilient-exporter.d.ts.map +0 -1
  146. package/dist-esm/browser/resilient-exporter.js +0 -84
  147. package/dist-esm/browser/resilient-exporter.js.map +0 -1
  148. package/dist-esm/browser/sanitizer.d.ts +0 -35
  149. package/dist-esm/browser/sanitizer.d.ts.map +0 -1
  150. package/dist-esm/browser/sanitizer.js +0 -207
  151. package/dist-esm/browser/sanitizer.js.map +0 -1
  152. package/dist-esm/browser/traced-socket.d.ts +0 -102
  153. package/dist-esm/browser/traced-socket.d.ts.map +0 -1
  154. package/dist-esm/browser/traced-socket.js +0 -199
  155. package/dist-esm/browser/traced-socket.js.map +0 -1
  156. package/dist-esm/common/contracts/tier2-traces.d.ts +0 -116
  157. package/dist-esm/common/contracts/tier2-traces.d.ts.map +0 -1
  158. package/dist-esm/common/contracts/tier2-traces.js +0 -725
  159. package/dist-esm/common/contracts/tier2-traces.js.map +0 -1
  160. package/dist-esm/common/deployment-type.d.ts +0 -18
  161. package/dist-esm/common/deployment-type.d.ts.map +0 -1
  162. package/dist-esm/common/deployment-type.js +0 -27
  163. package/dist-esm/common/deployment-type.js.map +0 -1
  164. package/dist-esm/common/guardrails.d.ts +0 -132
  165. package/dist-esm/common/guardrails.d.ts.map +0 -1
  166. package/dist-esm/common/guardrails.js +0 -230
  167. package/dist-esm/common/guardrails.js.map +0 -1
  168. package/dist-esm/common/index.d.ts +0 -17
  169. package/dist-esm/common/index.d.ts.map +0 -1
  170. package/dist-esm/common/index.js +0 -17
  171. package/dist-esm/common/index.js.map +0 -1
  172. package/dist-esm/common/log-sanitizer.d.ts +0 -163
  173. package/dist-esm/common/log-sanitizer.d.ts.map +0 -1
  174. package/dist-esm/common/log-sanitizer.js +0 -745
  175. package/dist-esm/common/log-sanitizer.js.map +0 -1
  176. package/dist-esm/common/policy-evaluator.d.ts +0 -103
  177. package/dist-esm/common/policy-evaluator.d.ts.map +0 -1
  178. package/dist-esm/common/policy-evaluator.js +0 -196
  179. package/dist-esm/common/policy-evaluator.js.map +0 -1
  180. package/dist-esm/common/resource.d.ts +0 -79
  181. package/dist-esm/common/resource.d.ts.map +0 -1
  182. package/dist-esm/common/resource.js +0 -121
  183. package/dist-esm/common/resource.js.map +0 -1
  184. package/dist-esm/common/tier-hints.d.ts +0 -182
  185. package/dist-esm/common/tier-hints.d.ts.map +0 -1
  186. package/dist-esm/common/tier-hints.js +0 -199
  187. package/dist-esm/common/tier-hints.js.map +0 -1
  188. package/dist-esm/common/trace-sanitizer.d.ts +0 -82
  189. package/dist-esm/common/trace-sanitizer.d.ts.map +0 -1
  190. package/dist-esm/common/trace-sanitizer.js +0 -230
  191. package/dist-esm/common/trace-sanitizer.js.map +0 -1
  192. package/dist-esm/common/traced-socket-types.d.ts +0 -43
  193. package/dist-esm/common/traced-socket-types.d.ts.map +0 -1
  194. package/dist-esm/common/traced-socket-types.js +0 -16
  195. package/dist-esm/common/traced-socket-types.js.map +0 -1
  196. package/dist-esm/index.d.ts +0 -45
  197. package/dist-esm/index.d.ts.map +0 -1
  198. package/dist-esm/index.js +0 -56
  199. package/dist-esm/index.js.map +0 -1
  200. package/dist-esm/lint/forbidden-attributes.d.ts +0 -149
  201. package/dist-esm/lint/forbidden-attributes.d.ts.map +0 -1
  202. package/dist-esm/lint/forbidden-attributes.js +0 -210
  203. package/dist-esm/lint/forbidden-attributes.js.map +0 -1
  204. package/dist-esm/lint/index.d.ts +0 -9
  205. package/dist-esm/lint/index.d.ts.map +0 -1
  206. package/dist-esm/lint/index.js +0 -9
  207. package/dist-esm/lint/index.js.map +0 -1
  208. package/dist-esm/llmobs/index.d.ts +0 -22
  209. package/dist-esm/llmobs/index.d.ts.map +0 -1
  210. package/dist-esm/llmobs/index.js +0 -22
  211. package/dist-esm/llmobs/index.js.map +0 -1
  212. package/dist-esm/llmobs/tier1-exporter.d.ts +0 -146
  213. package/dist-esm/llmobs/tier1-exporter.d.ts.map +0 -1
  214. package/dist-esm/llmobs/tier1-exporter.js +0 -193
  215. package/dist-esm/llmobs/tier1-exporter.js.map +0 -1
  216. package/dist-esm/llmobs/tier2-summarizer.d.ts +0 -268
  217. package/dist-esm/llmobs/tier2-summarizer.d.ts.map +0 -1
  218. package/dist-esm/llmobs/tier2-summarizer.js +0 -652
  219. package/dist-esm/llmobs/tier2-summarizer.js.map +0 -1
  220. package/dist-esm/node/dynamic-attribute-processor.d.ts +0 -43
  221. package/dist-esm/node/dynamic-attribute-processor.d.ts.map +0 -1
  222. package/dist-esm/node/dynamic-attribute-processor.js +0 -74
  223. package/dist-esm/node/dynamic-attribute-processor.js.map +0 -1
  224. package/dist-esm/node/exporters/resilient-exporter.d.ts +0 -91
  225. package/dist-esm/node/exporters/resilient-exporter.d.ts.map +0 -1
  226. package/dist-esm/node/exporters/resilient-exporter.js +0 -132
  227. package/dist-esm/node/exporters/resilient-exporter.js.map +0 -1
  228. package/dist-esm/node/index.d.ts +0 -13
  229. package/dist-esm/node/index.d.ts.map +0 -1
  230. package/dist-esm/node/index.js +0 -13
  231. package/dist-esm/node/index.js.map +0 -1
  232. package/dist-esm/node/init.d.ts +0 -97
  233. package/dist-esm/node/init.d.ts.map +0 -1
  234. package/dist-esm/node/init.js +0 -359
  235. package/dist-esm/node/init.js.map +0 -1
  236. package/dist-esm/node/local-obs-mode.d.ts +0 -17
  237. package/dist-esm/node/local-obs-mode.d.ts.map +0 -1
  238. package/dist-esm/node/local-obs-mode.js +0 -19
  239. package/dist-esm/node/local-obs-mode.js.map +0 -1
  240. package/dist-esm/node/log-processor.d.ts +0 -132
  241. package/dist-esm/node/log-processor.d.ts.map +0 -1
  242. package/dist-esm/node/log-processor.js +0 -389
  243. package/dist-esm/node/log-processor.js.map +0 -1
  244. package/dist-esm/node/metrics-client.d.ts +0 -88
  245. package/dist-esm/node/metrics-client.d.ts.map +0 -1
  246. package/dist-esm/node/metrics-client.js +0 -205
  247. package/dist-esm/node/metrics-client.js.map +0 -1
  248. package/dist-esm/node/safe-logger.d.ts +0 -55
  249. package/dist-esm/node/safe-logger.d.ts.map +0 -1
  250. package/dist-esm/node/safe-logger.js +0 -154
  251. package/dist-esm/node/safe-logger.js.map +0 -1
  252. package/dist-esm/node/sanitizing-processor.d.ts +0 -67
  253. package/dist-esm/node/sanitizing-processor.d.ts.map +0 -1
  254. package/dist-esm/node/sanitizing-processor.js +0 -163
  255. package/dist-esm/node/sanitizing-processor.js.map +0 -1
  256. package/dist-esm/node/service-tracers.d.ts +0 -52
  257. package/dist-esm/node/service-tracers.d.ts.map +0 -1
  258. package/dist-esm/node/service-tracers.js +0 -78
  259. package/dist-esm/node/service-tracers.js.map +0 -1
  260. package/dist-esm/node/traced-socket.d.ts +0 -120
  261. package/dist-esm/node/traced-socket.d.ts.map +0 -1
  262. package/dist-esm/node/traced-socket.js +0 -334
  263. package/dist-esm/node/traced-socket.js.map +0 -1
  264. package/dist-esm/npm-registry/emitter.d.ts +0 -330
  265. package/dist-esm/npm-registry/emitter.d.ts.map +0 -1
  266. package/dist-esm/npm-registry/emitter.js +0 -546
  267. package/dist-esm/npm-registry/emitter.js.map +0 -1
  268. package/dist-esm/npm-registry/index.d.ts +0 -12
  269. package/dist-esm/npm-registry/index.d.ts.map +0 -1
  270. package/dist-esm/npm-registry/index.js +0 -12
  271. package/dist-esm/npm-registry/index.js.map +0 -1
  272. package/dist-esm/npm-registry/sanitize.d.ts +0 -174
  273. package/dist-esm/npm-registry/sanitize.d.ts.map +0 -1
  274. package/dist-esm/npm-registry/sanitize.js +0 -331
  275. package/dist-esm/npm-registry/sanitize.js.map +0 -1
  276. package/dist-esm/npm-registry/spans.d.ts +0 -61
  277. package/dist-esm/npm-registry/spans.d.ts.map +0 -1
  278. package/dist-esm/npm-registry/spans.js +0 -86
  279. package/dist-esm/npm-registry/spans.js.map +0 -1
  280. package/dist-esm/package.json +0 -1
  281. package/dist-esm/testing/in-memory-exporter.d.ts +0 -179
  282. package/dist-esm/testing/in-memory-exporter.d.ts.map +0 -1
  283. package/dist-esm/testing/in-memory-exporter.js +0 -250
  284. package/dist-esm/testing/in-memory-exporter.js.map +0 -1
  285. package/dist-esm/testing/index.d.ts +0 -9
  286. package/dist-esm/testing/index.d.ts.map +0 -1
  287. package/dist-esm/testing/index.js +0 -9
  288. package/dist-esm/testing/index.js.map +0 -1
  289. package/dist-esm/testing/metrics-capture.d.ts +0 -29
  290. package/dist-esm/testing/metrics-capture.d.ts.map +0 -1
  291. package/dist-esm/testing/metrics-capture.js +0 -71
  292. package/dist-esm/testing/metrics-capture.js.map +0 -1
  293. package/dist-esm/testing/test-init.d.ts +0 -80
  294. package/dist-esm/testing/test-init.d.ts.map +0 -1
  295. package/dist-esm/testing/test-init.js +0 -137
  296. package/dist-esm/testing/test-init.js.map +0 -1
  297. package/dist-esm/types/index.d.ts +0 -84
  298. package/dist-esm/types/index.d.ts.map +0 -1
  299. package/dist-esm/types/index.js +0 -7
  300. package/dist-esm/types/index.js.map +0 -1
  301. package/dist-esm/types/policy.d.ts +0 -92
  302. package/dist-esm/types/policy.d.ts.map +0 -1
  303. package/dist-esm/types/policy.js +0 -122
  304. package/dist-esm/types/policy.js.map +0 -1
@@ -1,546 +0,0 @@
1
- /**
2
- * NPM Registry Metrics Emitter (APPS-4378 / APPS-4189)
3
- *
4
- * One emitter for the whole npm-registry subsystem. It owns every
5
- * `superblocks.npm.*` metric and centralizes the sanitize-at-emit-boundary
6
- * discipline: no raw registry hostname, package name, or token can escape via
7
- * a metric label because every dimension is coerced to a closed enum or a
8
- * bounded bucket here, the moment before it reaches an OTel instrument.
9
- *
10
- * Wiring follows the rest of the npm subsystem: the meter is resolved lazily
11
- * from the OTel global (`metrics.getMeter`) and instruments are cached and
12
- * re-bound when the global MeterProvider changes (the typical case is a test
13
- * installing its own provider for isolation). The emitter is therefore a
14
- * zero-config process singleton (`npmRegistryEmitter`) — no DI plumbing
15
- * through AiServiceConfig / NpmRegistryClientDeps.
16
- *
17
- * Metrics (all `superblocks.npm.*`, durations in seconds):
18
- *
19
- * - `config.lookup_total` counter {result}
20
- * - `config.lookup_duration_seconds` histogram {result} buckets [0.05,0.25,1,3,10,30]
21
- * - `config.policy_fallback_total` counter {branch} lastKnownPolicy supplied the policy
22
- * - `sync_home_npmrc.outcome_total` counter {outcome} CLI boot home npmrc materialization
23
- * - `sync_project_npmrc.outcome_total` counter {outcome} project-dir .npmrc reconcile (boot + install)
24
- * - `install.outcome_total` counter {outcome, configured, registry_host, runner, package_manager}
25
- * - `install.duration_seconds`histogram {…same…} buckets [0.5,2,5,15,60,300]
26
- * - `install.status` gauge {…same…} last-seen 1=success/0=else
27
- * - `probe.outcome_total` counter {outcome, registry_host}
28
- * - `probe.duration_seconds` histogram {…same…} buckets [0.1,0.5,1,3,10,30]
29
- * - `lookup.calls_total` counter {outcome, registry_host}
30
- * - `lookup.duration_seconds` histogram {…same…} buckets [0.05,0.25,1,3,10,30]
31
- * - `killswitch.enabled` gauge {} 1 when the feature is suppressed
32
- *
33
- * Cardinality budget (documented contract — must not regress without a
34
- * migration plan; every dashboard / Datadog facet pins on these):
35
- *
36
- * - registry_host ≤ 3 (`public_npm | private | unknown`)
37
- * - install.outcome ≤ 9 (`NPM_INSTALL_OUTCOMES`)
38
- * - probe.outcome ≤ 5 (`NPM_PROBE_OUTCOMES`)
39
- * - lookup.outcome ≤ 3 (`NPM_LOOKUP_TOOL_OUTCOMES`)
40
- * - config.result ≤ 5 (`NPM_CONFIG_LOOKUP_RESULTS`)
41
- * - config.force_refresh ≤ 2 (boolean)
42
- * - config.policy_fallback.branch ≤ 2 (`NPM_POLICY_FALLBACK_BRANCHES`)
43
- * - sync_home_npmrc.outcome ≤ 5 (`NPM_SYNC_HOME_NPMRC_OUTCOMES`)
44
- * - sync_project_npmrc.outcome ≤ 5 (`NPM_SYNC_PROJECT_NPMRC_OUTCOMES`)
45
- * - configured ≤ 2, runner ≤ 6 (`NPM_INSTALL_RUNNERS`)
46
- * - package_manager ≤ 3 (`NPM_INSTALL_PACKAGE_MANAGERS`)
47
- *
48
- * Worst-case distinct series across every instrument is ≈ 2996: the three
49
- * install instruments (status gauge + counter + histogram) dominate at
50
- * outcome×configured×registry_host×runner×package_manager = 9×2×3×6×3 = 972
51
- * each → 2916, plus
52
- * probe 5×3×2=30, config 5×2(force_refresh)×2(counter+histogram)=20, lookup
53
- * 3×3×2=18, the policy-fallback counter 2, the sync-home-npmrc counter 5,
54
- * the sync-project-npmrc counter 5, and the killswitch gauge 1. How it grew
55
- * over time: the runner count went from 3 to 4 (`auto_upgrade`) then 5
56
- * (`uninstall`) then 6 (`update`), adding `config.force_refresh` grew config from 8 to 16,
57
- * adding `stale` as its own config result grew it from 16 to 20, and the
58
- * policy-fallback (2 series), sync-home-npmrc (5 series), and
59
- * sync-project-npmrc (5 series) counters were added. Outcomes grew to 9, and
60
- * adding `package_manager` tripled the install instruments. Adding a label value
61
- * must increase the count, not decrease it.
62
- * Still well under the internal 150K flag and the Datadog billing boundary.
63
- * Per-pod `host` is stripped at the collector for the `superblocks.npm.*`
64
- * family so series are aggregated by `service.name`.
65
- *
66
- * Each path has its OWN closed outcome enum + `normalize*` coercer because the
67
- * paths legitimately diverge (probe has `ok`/`invalid_response`, install has
68
- * `tls_failed`/`lockfile_url_mismatch`, …). `auth_failed` is deliberately a
69
- * first-class outcome on install/probe — an expected, fast-failing
70
- * customer-config mode — kept separable from infra failures (`unreachable` /
71
- * `tls_failed`) so a future alert can page on infra spikes while routing auth
72
- * to a dashboard. These short names diverge from the long-form `NPM_OUTCOMES`
73
- * in `./sanitize` (which stays as the audit-event surface): the install path
74
- * normalizes the long `NpmInstallBlocked.reason` values to the short forms.
75
- */
76
- import { metrics } from "@opentelemetry/api";
77
- import { bucketNpmRegistryHost } from "./sanitize.js";
78
- /**
79
- * Closed enum of npm install call sites that emit metrics. One value per call
80
- * site Superblocks owns; renaming a value breaks every dashboard split on
81
- * `runner`, so additions/removals need a migration plan.
82
- *
83
- * - `install_all` — full install from package.json (no specific
84
- * packages). Covers both `AppShell.runNpmInstall`
85
- * and `AppShell.runPackageManagerInstall`.
86
- * - `install_specific` — `AppShell.installSpecificPackages` (`npm add`).
87
- * - `prefetch` — `installTemplateModules` (template `node_modules`
88
- * prefetch during AiService construction).
89
- * - `auto_upgrade` — `upgradeCliWithPackageManager` in the CLI SDK
90
- * (`automatic-upgrades.ts`). Owns the dev-server
91
- * self-upgrade install; a perimeter block here
92
- * crash-loops the live-edit pod, so the metric is
93
- * the only signal that distinguishes that from a
94
- * working upgrade. APPS-4544.
95
- * - `uninstall` — `AppShell.uninstallPackages` (`npm uninstall` /
96
- * `pnpm remove`). Same registry and script-policy
97
- * wrappers as install; a distinct runner so
98
- * dashboards can split remove from add.
99
- * - `update` — `AppShell.updatePackages` (`npm update` /
100
- * `pnpm update`). Same gate and audit as install.
101
- */
102
- export const NPM_INSTALL_RUNNERS = [
103
- "auto_upgrade",
104
- "install_all",
105
- "install_specific",
106
- "prefetch",
107
- "uninstall",
108
- "update",
109
- ];
110
- /**
111
- * Which package manager ran an install. `other` is any other package manager
112
- * (local dev can detect yarn or bun) and an install that failed before one was
113
- * picked.
114
- */
115
- export const NPM_INSTALL_PACKAGE_MANAGERS = ["npm", "pnpm", "other"];
116
- export function normalizeInstallPackageManager(input) {
117
- return input === "npm" || input === "pnpm" ? input : "other";
118
- }
119
- const METER_NAME = "@superblocksteam/telemetry/npm-registry";
120
- const METRIC_CONFIG_LOOKUP = "superblocks.npm.config.lookup_total";
121
- const METRIC_CONFIG_DURATION = "superblocks.npm.config.lookup_duration_seconds";
122
- const METRIC_POLICY_FALLBACK = "superblocks.npm.config.policy_fallback_total";
123
- const METRIC_SYNC_HOME_NPMRC = "superblocks.npm.sync_home_npmrc.outcome_total";
124
- const METRIC_SYNC_PROJECT_NPMRC = "superblocks.npm.sync_project_npmrc.outcome_total";
125
- const METRIC_INSTALL_OUTCOME = "superblocks.npm.install.outcome_total";
126
- const METRIC_INSTALL_DURATION = "superblocks.npm.install.duration_seconds";
127
- const METRIC_INSTALL_STATUS = "superblocks.npm.install.status";
128
- const METRIC_PROBE_OUTCOME = "superblocks.npm.probe.outcome_total";
129
- const METRIC_PROBE_DURATION = "superblocks.npm.probe.duration_seconds";
130
- const METRIC_LOOKUP_CALLS = "superblocks.npm.lookup.calls_total";
131
- const METRIC_LOOKUP_DURATION = "superblocks.npm.lookup.duration_seconds";
132
- const METRIC_KILLSWITCH = "superblocks.npm.killswitch.enabled";
133
- /**
134
- * Explicit histogram boundaries (seconds). Coarse on purpose: latency
135
- * histograms here exist to detect regressions / alert on pathological cases,
136
- * not for fine percentile work, so 6 finite buckets beat OTel's default 12.
137
- * The SDK appends an implicit `(last, +∞)` overflow bucket, so values past the
138
- * top boundary are still counted — the arrays stay finite (no `Infinity`).
139
- */
140
- const INSTALL_DURATION_BUCKETS = [0.5, 2, 5, 15, 60, 300];
141
- const PROBE_DURATION_BUCKETS = [0.1, 0.5, 1, 3, 10, 30];
142
- const LOOKUP_DURATION_BUCKETS = [0.05, 0.25, 1, 3, 10, 30];
143
- // Config lookups span sub-ms cache hits to multi-second cold fetches (network
144
- // round-trip + possible JWT-refresh retry), so reuse the lookup-tool scale.
145
- const CONFIG_DURATION_BUCKETS = [0.05, 0.25, 1, 3, 10, 30];
146
- // ---------------------------------------------------------------------------
147
- // Per-path closed outcome enums + emit-boundary coercers.
148
- // ---------------------------------------------------------------------------
149
- /**
150
- * `config.lookup_total` result. Derived inside `NpmRegistryClient.getConfig`
151
- * (the only place that knows cache hit vs miss): in-TTL non-empty hit → `hit`;
152
- * fresh fetch with a configured registry → `miss`; empty / 404 / flag-off →
153
- * `not_configured`; serving last-known-good config during an outage → `stale`;
154
- * no usable cache during an outage / any throw → `error`.
155
- *
156
- * `stale` means the client is still serving a real configured registry from
157
- * cache, just past the point where it would normally refresh. On-call needs to
158
- * tell this apart from a real failure, so it is its own result instead of
159
- * folding into `error` (which used to mix "still working off cache" with
160
- * "broken"). The age of the cached value rides on the WARN log only, never as
161
- * a metric label, so it adds no metric series.
162
- */
163
- export const NPM_CONFIG_LOOKUP_RESULTS = [
164
- "hit",
165
- "miss",
166
- "not_configured",
167
- "stale",
168
- "error",
169
- ];
170
- /** Unknown config-lookup states are an error condition, not a new series. */
171
- export function normalizeConfigLookupResult(input) {
172
- return (NPM_CONFIG_LOOKUP_RESULTS.find((result) => result === input) ?? "error");
173
- }
174
- /**
175
- * `config.policy_fallback_total` branch. Records where the in-memory cache
176
- * could not supply an `npmAllowInstallScripts` policy, so
177
- * `NpmRegistryClient.lastKnownPolicy` was used instead. That happens when an
178
- * earlier auth-failure or 4xx branch wiped the cache, which is a sign
179
- * something went wrong, so it is worth alerting on.
180
- *
181
- * - `not_configured_404`: the branch of `getConfig` that keeps the policy on a 404.
182
- * - `unreachable`: the no-usable-cache branch of `serveStaleOrUnconfigured`.
183
- */
184
- export const NPM_POLICY_FALLBACK_BRANCHES = [
185
- "not_configured_404",
186
- "unreachable",
187
- ];
188
- /**
189
- * `sync_home_npmrc.outcome_total` outcome. Mirrors the `SyncHomeNpmrcOutcome`
190
- * union in the CLI's `home-npmrc.mts` and the `outcome` span attribute, so the
191
- * metric and the `npm_registry.sync_home_npmrc` span join on the same value.
192
- * Keep this list in sync with that union; an unknown value folds to `error`
193
- * rather than adding a new series.
194
- */
195
- export const NPM_SYNC_HOME_NPMRC_OUTCOMES = [
196
- "written",
197
- "restored-not-configured",
198
- "skipped-unreachable",
199
- "skipped-snapshot-failed",
200
- "error",
201
- ];
202
- export function normalizeSyncHomeNpmrcOutcome(input) {
203
- return (NPM_SYNC_HOME_NPMRC_OUTCOMES.find((outcome) => outcome === input) ?? "error");
204
- }
205
- /**
206
- * `sync_project_npmrc.outcome_total` outcome. Mirrors project-dir reconcile
207
- * in `maybeWriteNpmrcForDir` (boot + install). Keep in sync with that call
208
- * site; unknown values fold to `error`.
209
- *
210
- * - `written`: configured rewrite with a fresh JWT
211
- * - `restored-not-configured`: restored from a clean backup, or noop
212
- * - `deleted-not-configured`: removed a Superblocks-authored stale file
213
- * - `skipped-unreachable`: fail-closed leave-alone on cold-cache outage
214
- * - `error`: unexpected failure (gitignore refuse, unlink/restore miss, boot catch)
215
- */
216
- export const NPM_SYNC_PROJECT_NPMRC_OUTCOMES = [
217
- "written",
218
- "restored-not-configured",
219
- "deleted-not-configured",
220
- "skipped-unreachable",
221
- "error",
222
- ];
223
- export function normalizeSyncProjectNpmrcOutcome(input) {
224
- return (NPM_SYNC_PROJECT_NPMRC_OUTCOMES.find((outcome) => outcome === input) ??
225
- "error");
226
- }
227
- /**
228
- * `install.outcome_total` outcome. Short forms; the install path normalizes
229
- * the long `NpmInstallBlocked.reason` values (`registry_auth_failed`,
230
- * `registry_unreachable`) to these via {@link normalizeInstallOutcome}.
231
- */
232
- export const NPM_INSTALL_OUTCOMES = [
233
- "success",
234
- "auth_failed",
235
- "not_in_registry",
236
- "unreachable",
237
- "tls_failed",
238
- "lockfile_url_mismatch",
239
- "package_substituted",
240
- "vulnerable_package",
241
- "other",
242
- ];
243
- /**
244
- * Long-form `NpmInstallBlocked.reason` → short install-metric outcome.
245
- * `NPM_INSTALL_OUTCOMES` above is the canonical list for the metric; a blocked
246
- * reason that is neither already a short outcome nor aliased here folds to
247
- * `other` on the metric (the precise reason still rides on the log/audit
248
- * surface via `NPM_OUTCOMES` in ./sanitize). Add an entry here when a new
249
- * `NpmInstallBlocked.reason` should get its own metric facet rather than
250
- * collapsing to `other`.
251
- */
252
- const INSTALL_OUTCOME_ALIASES = new Map([
253
- ["registry_auth_failed", "auth_failed"],
254
- ["registry_unreachable", "unreachable"],
255
- ]);
256
- export function normalizeInstallOutcome(input) {
257
- if (input == null)
258
- return "other";
259
- return (NPM_INSTALL_OUTCOMES.find((outcome) => outcome === input) ??
260
- INSTALL_OUTCOME_ALIASES.get(input) ??
261
- "other");
262
- }
263
- /** `probe.outcome_total` outcome. Mapped from the server `ProbeResult`. */
264
- export const NPM_PROBE_OUTCOMES = [
265
- "ok",
266
- "auth_failed",
267
- "unreachable",
268
- "tls_failed",
269
- "invalid_response",
270
- ];
271
- /**
272
- * Unknown → `unreachable`: the typed call site maps the closed `ProbeReason`
273
- * exhaustively, so this floor only fires on a non-typed (JS) caller, where
274
- * "we couldn't classify the probe" is safest reported as a connectivity
275
- * failure rather than silently dropped or minted as a new series.
276
- */
277
- export function normalizeProbeOutcome(input) {
278
- return (NPM_PROBE_OUTCOMES.find((outcome) => outcome === input) ?? "unreachable");
279
- }
280
- /** `lookup.calls_total` outcome (the Clark `lookupNpmPackage` tool). */
281
- export const NPM_LOOKUP_TOOL_OUTCOMES = [
282
- "in_registry",
283
- "not_in_registry",
284
- "error",
285
- ];
286
- /** Auth / unreachable / fail-closed / throw all collapse to `error` here. */
287
- export function normalizeLookupToolOutcome(input) {
288
- return (NPM_LOOKUP_TOOL_OUTCOMES.find((outcome) => outcome === input) ?? "error");
289
- }
290
- const SECONDS_PER_MS = 1 / 1000;
291
- const toSeconds = (durationMs) => Math.max(0, durationMs) * SECONDS_PER_MS;
292
- /**
293
- * The npm-registry metrics emitter. Constructed once as the
294
- * {@link npmRegistryEmitter} singleton; no `Meter` is injected — instruments
295
- * resolve lazily from the OTel global and re-bind on provider change.
296
- */
297
- export class NpmRegistryEmitter {
298
- /**
299
- * Last-seen install status keyed by the attribute tuple. The observable
300
- * gauge reads this each collection cycle. Every key component is coerced to
301
- * a closed enum / bounded bucket at the emit boundary
302
- * (`normalizeInstallOutcome`, `bucketNpmRegistryHost`, the `NpmInstallRunner`
303
- * union, a boolean), so the map is **bounded by construction** at
304
- * runner(6) × configured(2) × registry_host(3) × outcome(9) ×
305
- * package_manager(3) = 972 entries —
306
- * it cannot grow with traffic, only with deliberate enum changes. Entries
307
- * persist until process exit / `_resetForTesting` (a "last-seen for
308
- * dashboards" gauge must not drop a combo and lie about the most recent
309
- * outcome); no eviction is needed at this bound. The cardinality regression
310
- * test pins the resulting series count.
311
- */
312
- lastInstallStatus = new Map();
313
- /** Returns `true` when the kill-switch is asserting (feature suppressed). */
314
- killswitchState;
315
- cachedMeter;
316
- cachedInstruments;
317
- /**
318
- * Lazy instrument factory. Re-creates instruments and re-registers the
319
- * observable-gauge callbacks when the global MeterProvider changes (a stale
320
- * instrument bound to a replaced provider silently drops data).
321
- */
322
- getInstruments() {
323
- const meter = metrics.getMeter(METER_NAME);
324
- if (meter === this.cachedMeter && this.cachedInstruments) {
325
- return this.cachedInstruments;
326
- }
327
- this.cachedMeter = meter;
328
- this.cachedInstruments = {
329
- configCounter: meter.createCounter(METRIC_CONFIG_LOOKUP, {
330
- description: "Count of NpmRegistryClient.getConfig outcomes (cache hit/miss, not-configured, error).",
331
- unit: "{lookup}",
332
- }),
333
- configHistogram: meter.createHistogram(METRIC_CONFIG_DURATION, {
334
- description: "Duration of NpmRegistryClient.getConfig resolutions (cache hits are sub-ms; misses include the network fetch).",
335
- unit: "s",
336
- advice: { explicitBucketBoundaries: CONFIG_DURATION_BUCKETS },
337
- }),
338
- policyFallbackCounter: meter.createCounter(METRIC_POLICY_FALLBACK, {
339
- description: "Count of times NpmRegistryClient.lastKnownPolicy supplied the install-scripts policy because the cache could not (cache hard-cleared by an earlier auth/4xx branch).",
340
- unit: "{fallback}",
341
- }),
342
- syncHomeNpmrcCounter: meter.createCounter(METRIC_SYNC_HOME_NPMRC, {
343
- description: "Count of CLI ~/.superblocks/npmrc materialization outcomes at dev-server boot / cache refresh.",
344
- unit: "{sync}",
345
- }),
346
- syncProjectNpmrcCounter: meter.createCounter(METRIC_SYNC_PROJECT_NPMRC, {
347
- description: "Count of project-dir .npmrc reconcile outcomes (boot + install write boundaries).",
348
- unit: "{sync}",
349
- }),
350
- installCounter: meter.createCounter(METRIC_INSTALL_OUTCOME, {
351
- description: "Count of npm install outcomes from Superblocks-owned paths.",
352
- unit: "{install}",
353
- }),
354
- installHistogram: meter.createHistogram(METRIC_INSTALL_DURATION, {
355
- description: "Duration of npm install invocations.",
356
- unit: "s",
357
- advice: { explicitBucketBoundaries: INSTALL_DURATION_BUCKETS },
358
- }),
359
- probeCounter: meter.createCounter(METRIC_PROBE_OUTCOME, {
360
- description: "Count of org npm-registry verify-probe outcomes.",
361
- unit: "{probe}",
362
- }),
363
- probeHistogram: meter.createHistogram(METRIC_PROBE_DURATION, {
364
- description: "Duration of org npm-registry verify probes.",
365
- unit: "s",
366
- advice: { explicitBucketBoundaries: PROBE_DURATION_BUCKETS },
367
- }),
368
- lookupCounter: meter.createCounter(METRIC_LOOKUP_CALLS, {
369
- description: "Count of Clark lookupNpmPackage tool outcomes.",
370
- unit: "{call}",
371
- }),
372
- lookupHistogram: meter.createHistogram(METRIC_LOOKUP_DURATION, {
373
- description: "Duration of Clark lookupNpmPackage tool calls.",
374
- unit: "s",
375
- advice: { explicitBucketBoundaries: LOOKUP_DURATION_BUCKETS },
376
- }),
377
- };
378
- const statusGauge = meter.createObservableGauge(METRIC_INSTALL_STATUS, {
379
- description: "Last-seen npm install status (1 = success, 0 = anything else) per runner+configured+registry+outcome. For at-a-glance dashboards.",
380
- });
381
- statusGauge.addCallback((result) => {
382
- // Observable callbacks run on the metric export thread; an uncaught
383
- // throw here aborts the whole collection cycle and drops every metric.
384
- // Never let one escape.
385
- try {
386
- for (const { value, attrs } of this.lastInstallStatus.values()) {
387
- result.observe(value, attrs);
388
- }
389
- }
390
- catch {
391
- // Swallow: a metrics callback must not crash collection.
392
- }
393
- });
394
- const killswitchGauge = meter.createObservableGauge(METRIC_KILLSWITCH, {
395
- description: "1 when the npm-registry feature is suppressed (LD flag off / kill-switch active), 0 otherwise. One series per process.",
396
- });
397
- killswitchGauge.addCallback((result) => {
398
- // Same export-thread safety as the status gauge: if the kill-switch
399
- // state source throws (e.g. a flag client is momentarily unavailable),
400
- // don't take down the whole npm-registry metric stream with it.
401
- try {
402
- if (this.killswitchState) {
403
- result.observe(this.killswitchState() ? 1 : 0);
404
- }
405
- }
406
- catch {
407
- // Swallow: a metrics callback must not crash collection.
408
- }
409
- });
410
- return this.cachedInstruments;
411
- }
412
- /**
413
- * Emit one `config.lookup_total` + `config.lookup_duration_seconds`
414
- * observation. `durationMs` is the time `getConfig` spent resolving — sub-ms
415
- * for a cache hit, the network round-trip (+ any JWT-refresh retry) for a
416
- * miss — so dashboards can tell fast cache hits from slow cold fetches.
417
- * `forceRefresh` records whether the caller bypassed the TTL cache hit, so
418
- * forced just-in-time refreshes can be split from organic TTL-expiry misses.
419
- */
420
- recordConfigLookup(result, durationMs, forceRefresh = false) {
421
- const attrs = {
422
- result: normalizeConfigLookupResult(result),
423
- force_refresh: forceRefresh,
424
- };
425
- const { configCounter, configHistogram } = this.getInstruments();
426
- configCounter.add(1, attrs);
427
- configHistogram.record(toSeconds(durationMs), attrs);
428
- }
429
- /**
430
- * Emit one `config.policy_fallback_total` observation. Call from the
431
- * `getConfig` 404 branch and the `serveStaleOrUnconfigured` no-cache branch
432
- * when `lastKnownPolicy` supplied a value the cache could not. That means an
433
- * earlier auth or 4xx branch wiped the cache, which is a sign something went
434
- * wrong and is worth alerting on.
435
- */
436
- recordPolicyFallback(branch) {
437
- const { policyFallbackCounter } = this.getInstruments();
438
- policyFallbackCounter.add(1, { branch });
439
- }
440
- /**
441
- * Emit one `sync_home_npmrc.outcome_total` observation alongside the
442
- * `npm_registry.sync_home_npmrc` span, so the health of writing the npmrc at
443
- * boot can be alerted on per `service.name` without querying traces.
444
- * `outcome` is the `SyncHomeNpmrcOutcome`; an unknown value folds to `error`.
445
- */
446
- recordSyncHomeNpmrc(outcome) {
447
- const { syncHomeNpmrcCounter } = this.getInstruments();
448
- syncHomeNpmrcCounter.add(1, {
449
- outcome: normalizeSyncHomeNpmrcOutcome(outcome),
450
- });
451
- }
452
- /**
453
- * Emit one `sync_project_npmrc.outcome_total` observation for project-dir
454
- * `.npmrc` reconcile (boot + install). Unknown outcomes fold to `error`.
455
- */
456
- recordSyncProjectNpmrc(outcome) {
457
- const { syncProjectNpmrcCounter } = this.getInstruments();
458
- syncProjectNpmrcCounter.add(1, {
459
- outcome: normalizeSyncProjectNpmrcOutcome(outcome),
460
- });
461
- }
462
- /**
463
- * Emit the install outcome counter + duration histogram + last-seen status
464
- * gauge, and return the matching span-attribute pair for `llmobs.annotate`.
465
- * Safe to call from a `finally` block.
466
- */
467
- recordInstall(input) {
468
- const { installCounter, installHistogram } = this.getInstruments();
469
- const registry_host = bucketNpmRegistryHost(input.registryHost);
470
- const outcome = normalizeInstallOutcome(input.outcome);
471
- const attrs = {
472
- runner: input.runner,
473
- outcome,
474
- configured: input.configured,
475
- registry_host,
476
- package_manager: normalizeInstallPackageManager(input.packageManager),
477
- };
478
- installCounter.add(1, attrs);
479
- installHistogram.record(toSeconds(input.durationMs), attrs);
480
- const key = `${attrs.runner}|${attrs.configured}|${attrs.registry_host}|${attrs.outcome}|${attrs.package_manager}`;
481
- this.lastInstallStatus.set(key, {
482
- value: outcome === "success" ? 1 : 0,
483
- attrs,
484
- });
485
- return {
486
- "npm.registry_host": registry_host,
487
- "npm.outcome": outcome,
488
- "npm.package_manager": attrs.package_manager,
489
- };
490
- }
491
- /** Emit one `probe.outcome_total` + `probe.duration_seconds` observation. */
492
- recordProbe(input) {
493
- const { probeCounter, probeHistogram } = this.getInstruments();
494
- const attrs = {
495
- outcome: normalizeProbeOutcome(input.outcome),
496
- registry_host: bucketNpmRegistryHost(input.registryHost),
497
- };
498
- probeCounter.add(1, attrs);
499
- probeHistogram.record(toSeconds(input.durationMs), attrs);
500
- }
501
- /** Emit one `lookup.calls_total` + `lookup.duration_seconds` observation. */
502
- recordLookupTool(input) {
503
- const { lookupCounter, lookupHistogram } = this.getInstruments();
504
- const attrs = {
505
- outcome: normalizeLookupToolOutcome(input.outcome),
506
- registry_host: bucketNpmRegistryHost(input.registryHost),
507
- };
508
- lookupCounter.add(1, attrs);
509
- lookupHistogram.record(toSeconds(input.durationMs), attrs);
510
- }
511
- /**
512
- * Register the kill-switch state source. `getCurrentState` returns `true`
513
- * when the feature is suppressed (LD flag off). Idempotent — the latest
514
- * source wins; the observable gauge reads it on each scrape. Calling this
515
- * also ensures the instruments (and thus the gauge callback) are wired.
516
- */
517
- setKillswitch(getCurrentState) {
518
- this.killswitchState = getCurrentState;
519
- this.getInstruments();
520
- }
521
- /**
522
- * Test-only: drop cached instruments, last-seen status, and the kill-switch
523
- * source so the next emit re-binds to a freshly-installed test provider.
524
- */
525
- _resetForTesting() {
526
- this.cachedMeter = undefined;
527
- this.cachedInstruments = undefined;
528
- this.lastInstallStatus.clear();
529
- this.killswitchState = undefined;
530
- }
531
- }
532
- /** Process-wide singleton. All npm-registry call sites emit through this. */
533
- export const npmRegistryEmitter = new NpmRegistryEmitter();
534
- /**
535
- * Back-compat free function for the install path (APPS-4189 call sites in
536
- * `shell.ts` / `template-renderer.ts`). Delegates to the singleton and returns
537
- * the span-attribute pair for `llmobs.annotate`.
538
- */
539
- export function recordNpmInstall(input) {
540
- return npmRegistryEmitter.recordInstall(input);
541
- }
542
- /** Test-only reset for the singleton (see {@link NpmRegistryEmitter._resetForTesting}). */
543
- export function _resetNpmRegistryEmitterForTesting() {
544
- npmRegistryEmitter._resetForTesting();
545
- }
546
- //# sourceMappingURL=emitter.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"emitter.js","sourceRoot":"","sources":["../../src/npm-registry/emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AAEH,OAAO,EAAE,OAAO,EAA+B,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EAAE,qBAAqB,EAA0B,MAAM,eAAe,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,cAAc;IACd,aAAa;IACb,kBAAkB;IAClB,UAAU;IACV,WAAW;IACX,QAAQ;CACA,CAAC;AAGX;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAI9E,MAAM,UAAU,8BAA8B,CAC5C,KAAgC;IAEhC,OAAO,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,GAAG,yCAAyC,CAAC;AAE7D,MAAM,oBAAoB,GAAG,qCAAqC,CAAC;AACnE,MAAM,sBAAsB,GAAG,gDAAgD,CAAC;AAChF,MAAM,sBAAsB,GAAG,8CAA8C,CAAC;AAC9E,MAAM,sBAAsB,GAAG,+CAA+C,CAAC;AAC/E,MAAM,yBAAyB,GAC7B,kDAAkD,CAAC;AACrD,MAAM,sBAAsB,GAAG,uCAAuC,CAAC;AACvE,MAAM,uBAAuB,GAAG,0CAA0C,CAAC;AAC3E,MAAM,qBAAqB,GAAG,gCAAgC,CAAC;AAC/D,MAAM,oBAAoB,GAAG,qCAAqC,CAAC;AACnE,MAAM,qBAAqB,GAAG,wCAAwC,CAAC;AACvE,MAAM,mBAAmB,GAAG,oCAAoC,CAAC;AACjE,MAAM,sBAAsB,GAAG,yCAAyC,CAAC;AACzE,MAAM,iBAAiB,GAAG,oCAAoC,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,wBAAwB,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;AAC1D,MAAM,sBAAsB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AACxD,MAAM,uBAAuB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AAC3D,8EAA8E;AAC9E,4EAA4E;AAC5E,MAAM,uBAAuB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AAE3D,8EAA8E;AAC9E,0DAA0D;AAC1D,8EAA8E;AAE9E;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,KAAK;IACL,MAAM;IACN,gBAAgB;IAChB,OAAO;IACP,OAAO;CACC,CAAC;AAGX,6EAA6E;AAC7E,MAAM,UAAU,2BAA2B,CACzC,KAAgC;IAEhC,OAAO,CACL,yBAAyB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,OAAO,CACxE,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,oBAAoB;IACpB,aAAa;CACL,CAAC;AAIX;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,SAAS;IACT,yBAAyB;IACzB,qBAAqB;IACrB,yBAAyB;IACzB,OAAO;CACC,CAAC;AAIX,MAAM,UAAU,6BAA6B,CAC3C,KAAgC;IAEhC,OAAO,CACL,4BAA4B,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,CAAC,IAAI,OAAO,CAC7E,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,SAAS;IACT,yBAAyB;IACzB,wBAAwB;IACxB,qBAAqB;IACrB,OAAO;CACC,CAAC;AAIX,MAAM,UAAU,gCAAgC,CAC9C,KAAgC;IAEhC,OAAO,CACL,+BAA+B,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,CAAC;QACpE,OAAO,CACR,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,SAAS;IACT,aAAa;IACb,iBAAiB;IACjB,aAAa;IACb,YAAY;IACZ,uBAAuB;IACvB,qBAAqB;IACrB,oBAAoB;IACpB,OAAO;CACC,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAA4B;IACjE,CAAC,sBAAsB,EAAE,aAAa,CAAC;IACvC,CAAC,sBAAsB,EAAE,aAAa,CAAC;CACxC,CAAC,CAAC;AAEH,MAAM,UAAU,uBAAuB,CACrC,KAAgC;IAEhC,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,OAAO,CAAC;IAClC,OAAO,CACL,oBAAoB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,CAAC;QACzD,uBAAuB,CAAC,GAAG,CAAC,KAAK,CAAC;QAClC,OAAO,CACR,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI;IACJ,aAAa;IACb,aAAa;IACb,YAAY;IACZ,kBAAkB;CACV,CAAC;AAEX;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAgC;IAEhC,OAAO,CACL,kBAAkB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,CAAC,IAAI,aAAa,CACzE,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,aAAa;IACb,iBAAiB;IACjB,OAAO;CACC,CAAC;AAEX,6EAA6E;AAC7E,MAAM,UAAU,0BAA0B,CACxC,KAAgC;IAEhC,OAAO,CACL,wBAAwB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,CAAC,IAAI,OAAO,CACzE,CAAC;AACJ,CAAC;AA6GD,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,CAAC;AAChC,MAAM,SAAS,GAAG,CAAC,UAAkB,EAAU,EAAE,CAC/C,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,cAAc,CAAC;AAE3C;;;;GAIG;AACH,MAAM,OAAO,kBAAkB;IAC7B;;;;;;;;;;;;;OAaG;IACc,iBAAiB,GAAG,IAAI,GAAG,EAGzC,CAAC;IAEJ,6EAA6E;IACrE,eAAe,CAA8B;IAE7C,WAAW,CAAoB;IAC/B,iBAAiB,CAA0B;IAEnD;;;;OAIG;IACK,cAAc;QACpB,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC3C,IAAI,KAAK,KAAK,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACzD,OAAO,IAAI,CAAC,iBAAiB,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QAEzB,IAAI,CAAC,iBAAiB,GAAG;YACvB,aAAa,EAAE,KAAK,CAAC,aAAa,CAAC,oBAAoB,EAAE;gBACvD,WAAW,EACT,wFAAwF;gBAC1F,IAAI,EAAE,UAAU;aACjB,CAAC;YACF,eAAe,EAAE,KAAK,CAAC,eAAe,CAAC,sBAAsB,EAAE;gBAC7D,WAAW,EACT,gHAAgH;gBAClH,IAAI,EAAE,GAAG;gBACT,MAAM,EAAE,EAAE,wBAAwB,EAAE,uBAAuB,EAAE;aAC9D,CAAC;YACF,qBAAqB,EAAE,KAAK,CAAC,aAAa,CAAC,sBAAsB,EAAE;gBACjE,WAAW,EACT,sKAAsK;gBACxK,IAAI,EAAE,YAAY;aACnB,CAAC;YACF,oBAAoB,EAAE,KAAK,CAAC,aAAa,CAAC,sBAAsB,EAAE;gBAChE,WAAW,EACT,gGAAgG;gBAClG,IAAI,EAAE,QAAQ;aACf,CAAC;YACF,uBAAuB,EAAE,KAAK,CAAC,aAAa,CAAC,yBAAyB,EAAE;gBACtE,WAAW,EACT,mFAAmF;gBACrF,IAAI,EAAE,QAAQ;aACf,CAAC;YACF,cAAc,EAAE,KAAK,CAAC,aAAa,CAAC,sBAAsB,EAAE;gBAC1D,WAAW,EACT,6DAA6D;gBAC/D,IAAI,EAAE,WAAW;aAClB,CAAC;YACF,gBAAgB,EAAE,KAAK,CAAC,eAAe,CAAC,uBAAuB,EAAE;gBAC/D,WAAW,EAAE,sCAAsC;gBACnD,IAAI,EAAE,GAAG;gBACT,MAAM,EAAE,EAAE,wBAAwB,EAAE,wBAAwB,EAAE;aAC/D,CAAC;YACF,YAAY,EAAE,KAAK,CAAC,aAAa,CAAC,oBAAoB,EAAE;gBACtD,WAAW,EAAE,kDAAkD;gBAC/D,IAAI,EAAE,SAAS;aAChB,CAAC;YACF,cAAc,EAAE,KAAK,CAAC,eAAe,CAAC,qBAAqB,EAAE;gBAC3D,WAAW,EAAE,6CAA6C;gBAC1D,IAAI,EAAE,GAAG;gBACT,MAAM,EAAE,EAAE,wBAAwB,EAAE,sBAAsB,EAAE;aAC7D,CAAC;YACF,aAAa,EAAE,KAAK,CAAC,aAAa,CAAC,mBAAmB,EAAE;gBACtD,WAAW,EAAE,gDAAgD;gBAC7D,IAAI,EAAE,QAAQ;aACf,CAAC;YACF,eAAe,EAAE,KAAK,CAAC,eAAe,CAAC,sBAAsB,EAAE;gBAC7D,WAAW,EAAE,gDAAgD;gBAC7D,IAAI,EAAE,GAAG;gBACT,MAAM,EAAE,EAAE,wBAAwB,EAAE,uBAAuB,EAAE;aAC9D,CAAC;SACH,CAAC;QAEF,MAAM,WAAW,GAAG,KAAK,CAAC,qBAAqB,CAAC,qBAAqB,EAAE;YACrE,WAAW,EACT,mIAAmI;SACtI,CAAC,CAAC;QACH,WAAW,CAAC,WAAW,CAAC,CAAC,MAAM,EAAE,EAAE;YACjC,oEAAoE;YACpE,uEAAuE;YACvE,wBAAwB;YACxB,IAAI,CAAC;gBACH,KAAK,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,EAAE,CAAC;oBAC/D,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,yDAAyD;YAC3D,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,eAAe,GAAG,KAAK,CAAC,qBAAqB,CAAC,iBAAiB,EAAE;YACrE,WAAW,EACT,wHAAwH;SAC3H,CAAC,CAAC;QACH,eAAe,CAAC,WAAW,CAAC,CAAC,MAAM,EAAE,EAAE;YACrC,oEAAoE;YACpE,uEAAuE;YACvE,gEAAgE;YAChE,IAAI,CAAC;gBACH,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;oBACzB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACjD,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,yDAAyD;YAC3D,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;IAED;;;;;;;OAOG;IACH,kBAAkB,CAChB,MAAiC,EACjC,UAAkB,EAClB,YAAY,GAAG,KAAK;QAEpB,MAAM,KAAK,GAA2B;YACpC,MAAM,EAAE,2BAA2B,CAAC,MAAM,CAAC;YAC3C,aAAa,EAAE,YAAY;SAC5B,CAAC;QACF,MAAM,EAAE,aAAa,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACjE,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC5B,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC;IAED;;;;;;OAMG;IACH,oBAAoB,CAAC,MAA+B;QAClD,MAAM,EAAE,qBAAqB,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACxD,qBAAqB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACH,mBAAmB,CAAC,OAAkC;QACpD,MAAM,EAAE,oBAAoB,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACvD,oBAAoB,CAAC,GAAG,CAAC,CAAC,EAAE;YAC1B,OAAO,EAAE,6BAA6B,CAAC,OAAO,CAAC;SAChD,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,sBAAsB,CAAC,OAAkC;QACvD,MAAM,EAAE,uBAAuB,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAC1D,uBAAuB,CAAC,GAAG,CAAC,CAAC,EAAE;YAC7B,OAAO,EAAE,gCAAgC,CAAC,OAAO,CAAC;SACnD,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAC,KAA4B;QACxC,MAAM,EAAE,cAAc,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACnE,MAAM,aAAa,GAAG,qBAAqB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,uBAAuB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACvD,MAAM,KAAK,GAAsB;YAC/B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO;YACP,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,aAAa;YACb,eAAe,EAAE,8BAA8B,CAAC,KAAK,CAAC,cAAc,CAAC;SACtE,CAAC;QAEF,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC7B,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;QAE5D,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QACnH,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,EAAE;YAC9B,KAAK,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACpC,KAAK;SACN,CAAC,CAAC;QAEH,OAAO;YACL,mBAAmB,EAAE,aAAa;YAClC,aAAa,EAAE,OAAO;YACtB,qBAAqB,EAAE,KAAK,CAAC,eAAe;SAC7C,CAAC;IACJ,CAAC;IAED,6EAA6E;IAC7E,WAAW,CAAC,KAA0B;QACpC,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAC/D,MAAM,KAAK,GAAoB;YAC7B,OAAO,EAAE,qBAAqB,CAAC,KAAK,CAAC,OAAO,CAAC;YAC7C,aAAa,EAAE,qBAAqB,CAAC,KAAK,CAAC,YAAY,CAAC;SACzD,CAAC;QACF,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC3B,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;IAC5D,CAAC;IAED,6EAA6E;IAC7E,gBAAgB,CAAC,KAA+B;QAC9C,MAAM,EAAE,aAAa,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACjE,MAAM,KAAK,GAAyB;YAClC,OAAO,EAAE,0BAA0B,CAAC,KAAK,CAAC,OAAO,CAAC;YAClD,aAAa,EAAE,qBAAqB,CAAC,KAAK,CAAC,YAAY,CAAC;SACzD,CAAC;QACF,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC5B,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,eAA8B;QAC1C,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,gBAAgB;QACd,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC7B,IAAI,CAAC,iBAAiB,GAAG,SAAS,CAAC;QACnC,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;IACnC,CAAC;CACF;AAED,6EAA6E;AAC7E,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,kBAAkB,EAAE,CAAC;AAE3D;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAA4B;IAE5B,OAAO,kBAAkB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;AACjD,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,kCAAkC;IAChD,kBAAkB,CAAC,gBAAgB,EAAE,CAAC;AACxC,CAAC"}
@@ -1,12 +0,0 @@
1
- /**
2
- * NPM Registry Telemetry
3
- *
4
- * Sanitization helpers, the unified metrics emitter, and the named OTel spans
5
- * for the npm-registry subsystem (config fetch, install, verify probe, the
6
- * Clark lookup tool, CLI npmrc sync). Re-exported from the package root, so
7
- * callers import from `@superblocksteam/telemetry` rather than this subpath.
8
- */
9
- export * from "./sanitize.js";
10
- export * from "./emitter.js";
11
- export * from "./spans.js";
12
- //# sourceMappingURL=index.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/npm-registry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}
@@ -1,12 +0,0 @@
1
- /**
2
- * NPM Registry Telemetry
3
- *
4
- * Sanitization helpers, the unified metrics emitter, and the named OTel spans
5
- * for the npm-registry subsystem (config fetch, install, verify probe, the
6
- * Clark lookup tool, CLI npmrc sync). Re-exported from the package root, so
7
- * callers import from `@superblocksteam/telemetry` rather than this subpath.
8
- */
9
- export * from "./sanitize.js";
10
- export * from "./emitter.js";
11
- export * from "./spans.js";
12
- //# sourceMappingURL=index.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/npm-registry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}