@superblocksteam/telemetry 2.0.0-SNAPSHOT.329be19cb7ca892b

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 (388) hide show
  1. package/LICENSE.txt +87 -0
  2. package/README.md +298 -0
  3. package/dist/browser/console-logging.d.ts +18 -0
  4. package/dist/browser/console-logging.d.ts.map +1 -0
  5. package/dist/browser/console-logging.js +32 -0
  6. package/dist/browser/console-logging.js.map +1 -0
  7. package/dist/browser/early-console-buffer.d.ts +49 -0
  8. package/dist/browser/early-console-buffer.d.ts.map +1 -0
  9. package/dist/browser/early-console-buffer.js +182 -0
  10. package/dist/browser/early-console-buffer.js.map +1 -0
  11. package/dist/browser/index.d.ts +17 -0
  12. package/dist/browser/index.d.ts.map +1 -0
  13. package/dist/browser/index.js +50 -0
  14. package/dist/browser/index.js.map +1 -0
  15. package/dist/browser/init.d.ts +101 -0
  16. package/dist/browser/init.d.ts.map +1 -0
  17. package/dist/browser/init.js +329 -0
  18. package/dist/browser/init.js.map +1 -0
  19. package/dist/browser/instrumentations.d.ts +67 -0
  20. package/dist/browser/instrumentations.d.ts.map +1 -0
  21. package/dist/browser/instrumentations.js +83 -0
  22. package/dist/browser/instrumentations.js.map +1 -0
  23. package/dist/browser/logs.d.ts +55 -0
  24. package/dist/browser/logs.d.ts.map +1 -0
  25. package/dist/browser/logs.js +86 -0
  26. package/dist/browser/logs.js.map +1 -0
  27. package/dist/browser/metrics.d.ts +29 -0
  28. package/dist/browser/metrics.d.ts.map +1 -0
  29. package/dist/browser/metrics.js +49 -0
  30. package/dist/browser/metrics.js.map +1 -0
  31. package/dist/browser/resilient-exporter.d.ts +43 -0
  32. package/dist/browser/resilient-exporter.d.ts.map +1 -0
  33. package/dist/browser/resilient-exporter.js +88 -0
  34. package/dist/browser/resilient-exporter.js.map +1 -0
  35. package/dist/browser/sanitizer.d.ts +35 -0
  36. package/dist/browser/sanitizer.d.ts.map +1 -0
  37. package/dist/browser/sanitizer.js +211 -0
  38. package/dist/browser/sanitizer.js.map +1 -0
  39. package/dist/browser/traced-socket.d.ts +102 -0
  40. package/dist/browser/traced-socket.d.ts.map +1 -0
  41. package/dist/browser/traced-socket.js +203 -0
  42. package/dist/browser/traced-socket.js.map +1 -0
  43. package/dist/common/contracts/tier2-traces.d.ts +116 -0
  44. package/dist/common/contracts/tier2-traces.d.ts.map +1 -0
  45. package/dist/common/contracts/tier2-traces.js +736 -0
  46. package/dist/common/contracts/tier2-traces.js.map +1 -0
  47. package/dist/common/deployment-type.d.ts +18 -0
  48. package/dist/common/deployment-type.d.ts.map +1 -0
  49. package/dist/common/deployment-type.js +30 -0
  50. package/dist/common/deployment-type.js.map +1 -0
  51. package/dist/common/guardrails.d.ts +116 -0
  52. package/dist/common/guardrails.d.ts.map +1 -0
  53. package/dist/common/guardrails.js +189 -0
  54. package/dist/common/guardrails.js.map +1 -0
  55. package/dist/common/index.d.ts +18 -0
  56. package/dist/common/index.d.ts.map +1 -0
  57. package/dist/common/index.js +34 -0
  58. package/dist/common/index.js.map +1 -0
  59. package/dist/common/log-sanitizer.d.ts +170 -0
  60. package/dist/common/log-sanitizer.d.ts.map +1 -0
  61. package/dist/common/log-sanitizer.js +690 -0
  62. package/dist/common/log-sanitizer.js.map +1 -0
  63. package/dist/common/normalize-metric-path.d.ts +2 -0
  64. package/dist/common/normalize-metric-path.d.ts.map +1 -0
  65. package/dist/common/normalize-metric-path.js +22 -0
  66. package/dist/common/normalize-metric-path.js.map +1 -0
  67. package/dist/common/policy-evaluator.d.ts +103 -0
  68. package/dist/common/policy-evaluator.d.ts.map +1 -0
  69. package/dist/common/policy-evaluator.js +200 -0
  70. package/dist/common/policy-evaluator.js.map +1 -0
  71. package/dist/common/resource.d.ts +79 -0
  72. package/dist/common/resource.d.ts.map +1 -0
  73. package/dist/common/resource.js +128 -0
  74. package/dist/common/resource.js.map +1 -0
  75. package/dist/common/tier-hints.d.ts +182 -0
  76. package/dist/common/tier-hints.d.ts.map +1 -0
  77. package/dist/common/tier-hints.js +209 -0
  78. package/dist/common/tier-hints.js.map +1 -0
  79. package/dist/common/trace-sanitizer.d.ts +82 -0
  80. package/dist/common/trace-sanitizer.d.ts.map +1 -0
  81. package/dist/common/trace-sanitizer.js +234 -0
  82. package/dist/common/trace-sanitizer.js.map +1 -0
  83. package/dist/common/traced-socket-types.d.ts +43 -0
  84. package/dist/common/traced-socket-types.d.ts.map +1 -0
  85. package/dist/common/traced-socket-types.js +17 -0
  86. package/dist/common/traced-socket-types.js.map +1 -0
  87. package/dist/index.d.ts +45 -0
  88. package/dist/index.d.ts.map +1 -0
  89. package/dist/index.js +88 -0
  90. package/dist/index.js.map +1 -0
  91. package/dist/lint/forbidden-attributes.d.ts +149 -0
  92. package/dist/lint/forbidden-attributes.d.ts.map +1 -0
  93. package/dist/lint/forbidden-attributes.js +215 -0
  94. package/dist/lint/forbidden-attributes.js.map +1 -0
  95. package/dist/lint/index.d.ts +9 -0
  96. package/dist/lint/index.d.ts.map +1 -0
  97. package/dist/lint/index.js +16 -0
  98. package/dist/lint/index.js.map +1 -0
  99. package/dist/llmobs/index.d.ts +22 -0
  100. package/dist/llmobs/index.d.ts.map +1 -0
  101. package/dist/llmobs/index.js +29 -0
  102. package/dist/llmobs/index.js.map +1 -0
  103. package/dist/llmobs/tier1-exporter.d.ts +146 -0
  104. package/dist/llmobs/tier1-exporter.d.ts.map +1 -0
  105. package/dist/llmobs/tier1-exporter.js +199 -0
  106. package/dist/llmobs/tier1-exporter.js.map +1 -0
  107. package/dist/llmobs/tier2-summarizer.d.ts +268 -0
  108. package/dist/llmobs/tier2-summarizer.d.ts.map +1 -0
  109. package/dist/llmobs/tier2-summarizer.js +656 -0
  110. package/dist/llmobs/tier2-summarizer.js.map +1 -0
  111. package/dist/node/dynamic-attribute-processor.d.ts +43 -0
  112. package/dist/node/dynamic-attribute-processor.d.ts.map +1 -0
  113. package/dist/node/dynamic-attribute-processor.js +79 -0
  114. package/dist/node/dynamic-attribute-processor.js.map +1 -0
  115. package/dist/node/exporters/resilient-exporter.d.ts +91 -0
  116. package/dist/node/exporters/resilient-exporter.d.ts.map +1 -0
  117. package/dist/node/exporters/resilient-exporter.js +136 -0
  118. package/dist/node/exporters/resilient-exporter.js.map +1 -0
  119. package/dist/node/index.d.ts +13 -0
  120. package/dist/node/index.d.ts.map +1 -0
  121. package/dist/node/index.js +32 -0
  122. package/dist/node/index.js.map +1 -0
  123. package/dist/node/init.d.ts +97 -0
  124. package/dist/node/init.d.ts.map +1 -0
  125. package/dist/node/init.js +365 -0
  126. package/dist/node/init.js.map +1 -0
  127. package/dist/node/local-obs-mode.d.ts +17 -0
  128. package/dist/node/local-obs-mode.d.ts.map +1 -0
  129. package/dist/node/local-obs-mode.js +22 -0
  130. package/dist/node/local-obs-mode.js.map +1 -0
  131. package/dist/node/log-processor.d.ts +132 -0
  132. package/dist/node/log-processor.d.ts.map +1 -0
  133. package/dist/node/log-processor.js +397 -0
  134. package/dist/node/log-processor.js.map +1 -0
  135. package/dist/node/metrics-client.d.ts +88 -0
  136. package/dist/node/metrics-client.d.ts.map +1 -0
  137. package/dist/node/metrics-client.js +209 -0
  138. package/dist/node/metrics-client.js.map +1 -0
  139. package/dist/node/safe-logger.d.ts +55 -0
  140. package/dist/node/safe-logger.d.ts.map +1 -0
  141. package/dist/node/safe-logger.js +158 -0
  142. package/dist/node/safe-logger.js.map +1 -0
  143. package/dist/node/sanitizing-processor.d.ts +67 -0
  144. package/dist/node/sanitizing-processor.d.ts.map +1 -0
  145. package/dist/node/sanitizing-processor.js +167 -0
  146. package/dist/node/sanitizing-processor.js.map +1 -0
  147. package/dist/node/service-tracers.d.ts +52 -0
  148. package/dist/node/service-tracers.d.ts.map +1 -0
  149. package/dist/node/service-tracers.js +81 -0
  150. package/dist/node/service-tracers.js.map +1 -0
  151. package/dist/node/traced-socket.d.ts +120 -0
  152. package/dist/node/traced-socket.d.ts.map +1 -0
  153. package/dist/node/traced-socket.js +338 -0
  154. package/dist/node/traced-socket.js.map +1 -0
  155. package/dist/npm-registry/emitter.d.ts +310 -0
  156. package/dist/npm-registry/emitter.d.ts.map +1 -0
  157. package/dist/npm-registry/emitter.js +537 -0
  158. package/dist/npm-registry/emitter.js.map +1 -0
  159. package/dist/npm-registry/index.d.ts +12 -0
  160. package/dist/npm-registry/index.d.ts.map +1 -0
  161. package/dist/npm-registry/index.js +28 -0
  162. package/dist/npm-registry/index.js.map +1 -0
  163. package/dist/npm-registry/sanitize.d.ts +174 -0
  164. package/dist/npm-registry/sanitize.d.ts.map +1 -0
  165. package/dist/npm-registry/sanitize.js +342 -0
  166. package/dist/npm-registry/sanitize.js.map +1 -0
  167. package/dist/npm-registry/spans.d.ts +61 -0
  168. package/dist/npm-registry/spans.d.ts.map +1 -0
  169. package/dist/npm-registry/spans.js +91 -0
  170. package/dist/npm-registry/spans.js.map +1 -0
  171. package/dist/testing/in-memory-exporter.d.ts +179 -0
  172. package/dist/testing/in-memory-exporter.d.ts.map +1 -0
  173. package/dist/testing/in-memory-exporter.js +256 -0
  174. package/dist/testing/in-memory-exporter.js.map +1 -0
  175. package/dist/testing/index.d.ts +9 -0
  176. package/dist/testing/index.d.ts.map +1 -0
  177. package/dist/testing/index.js +21 -0
  178. package/dist/testing/index.js.map +1 -0
  179. package/dist/testing/metrics-capture.d.ts +29 -0
  180. package/dist/testing/metrics-capture.d.ts.map +1 -0
  181. package/dist/testing/metrics-capture.js +74 -0
  182. package/dist/testing/metrics-capture.js.map +1 -0
  183. package/dist/testing/test-init.d.ts +80 -0
  184. package/dist/testing/test-init.d.ts.map +1 -0
  185. package/dist/testing/test-init.js +144 -0
  186. package/dist/testing/test-init.js.map +1 -0
  187. package/dist/types/index.d.ts +84 -0
  188. package/dist/types/index.d.ts.map +1 -0
  189. package/dist/types/index.js +23 -0
  190. package/dist/types/index.js.map +1 -0
  191. package/dist/types/policy.d.ts +92 -0
  192. package/dist/types/policy.d.ts.map +1 -0
  193. package/dist/types/policy.js +125 -0
  194. package/dist/types/policy.js.map +1 -0
  195. package/dist-esm/browser/console-logging.d.ts +18 -0
  196. package/dist-esm/browser/console-logging.d.ts.map +1 -0
  197. package/dist-esm/browser/console-logging.js +27 -0
  198. package/dist-esm/browser/console-logging.js.map +1 -0
  199. package/dist-esm/browser/early-console-buffer.d.ts +49 -0
  200. package/dist-esm/browser/early-console-buffer.d.ts.map +1 -0
  201. package/dist-esm/browser/early-console-buffer.js +180 -0
  202. package/dist-esm/browser/early-console-buffer.js.map +1 -0
  203. package/dist-esm/browser/index.d.ts +17 -0
  204. package/dist-esm/browser/index.d.ts.map +1 -0
  205. package/dist-esm/browser/index.js +22 -0
  206. package/dist-esm/browser/index.js.map +1 -0
  207. package/dist-esm/browser/init.d.ts +101 -0
  208. package/dist-esm/browser/init.d.ts.map +1 -0
  209. package/dist-esm/browser/init.js +319 -0
  210. package/dist-esm/browser/init.js.map +1 -0
  211. package/dist-esm/browser/instrumentations.d.ts +67 -0
  212. package/dist-esm/browser/instrumentations.d.ts.map +1 -0
  213. package/dist-esm/browser/instrumentations.js +79 -0
  214. package/dist-esm/browser/instrumentations.js.map +1 -0
  215. package/dist-esm/browser/logs.d.ts +55 -0
  216. package/dist-esm/browser/logs.d.ts.map +1 -0
  217. package/dist-esm/browser/logs.js +79 -0
  218. package/dist-esm/browser/logs.js.map +1 -0
  219. package/dist-esm/browser/metrics.d.ts +29 -0
  220. package/dist-esm/browser/metrics.d.ts.map +1 -0
  221. package/dist-esm/browser/metrics.js +46 -0
  222. package/dist-esm/browser/metrics.js.map +1 -0
  223. package/dist-esm/browser/resilient-exporter.d.ts +43 -0
  224. package/dist-esm/browser/resilient-exporter.d.ts.map +1 -0
  225. package/dist-esm/browser/resilient-exporter.js +84 -0
  226. package/dist-esm/browser/resilient-exporter.js.map +1 -0
  227. package/dist-esm/browser/sanitizer.d.ts +35 -0
  228. package/dist-esm/browser/sanitizer.d.ts.map +1 -0
  229. package/dist-esm/browser/sanitizer.js +207 -0
  230. package/dist-esm/browser/sanitizer.js.map +1 -0
  231. package/dist-esm/browser/traced-socket.d.ts +102 -0
  232. package/dist-esm/browser/traced-socket.d.ts.map +1 -0
  233. package/dist-esm/browser/traced-socket.js +199 -0
  234. package/dist-esm/browser/traced-socket.js.map +1 -0
  235. package/dist-esm/common/contracts/tier2-traces.d.ts +116 -0
  236. package/dist-esm/common/contracts/tier2-traces.d.ts.map +1 -0
  237. package/dist-esm/common/contracts/tier2-traces.js +725 -0
  238. package/dist-esm/common/contracts/tier2-traces.js.map +1 -0
  239. package/dist-esm/common/deployment-type.d.ts +18 -0
  240. package/dist-esm/common/deployment-type.d.ts.map +1 -0
  241. package/dist-esm/common/deployment-type.js +27 -0
  242. package/dist-esm/common/deployment-type.js.map +1 -0
  243. package/dist-esm/common/guardrails.d.ts +116 -0
  244. package/dist-esm/common/guardrails.d.ts.map +1 -0
  245. package/dist-esm/common/guardrails.js +179 -0
  246. package/dist-esm/common/guardrails.js.map +1 -0
  247. package/dist-esm/common/index.d.ts +18 -0
  248. package/dist-esm/common/index.d.ts.map +1 -0
  249. package/dist-esm/common/index.js +18 -0
  250. package/dist-esm/common/index.js.map +1 -0
  251. package/dist-esm/common/log-sanitizer.d.ts +170 -0
  252. package/dist-esm/common/log-sanitizer.d.ts.map +1 -0
  253. package/dist-esm/common/log-sanitizer.js +672 -0
  254. package/dist-esm/common/log-sanitizer.js.map +1 -0
  255. package/dist-esm/common/normalize-metric-path.d.ts +2 -0
  256. package/dist-esm/common/normalize-metric-path.d.ts.map +1 -0
  257. package/dist-esm/common/normalize-metric-path.js +19 -0
  258. package/dist-esm/common/normalize-metric-path.js.map +1 -0
  259. package/dist-esm/common/policy-evaluator.d.ts +103 -0
  260. package/dist-esm/common/policy-evaluator.d.ts.map +1 -0
  261. package/dist-esm/common/policy-evaluator.js +196 -0
  262. package/dist-esm/common/policy-evaluator.js.map +1 -0
  263. package/dist-esm/common/resource.d.ts +79 -0
  264. package/dist-esm/common/resource.d.ts.map +1 -0
  265. package/dist-esm/common/resource.js +121 -0
  266. package/dist-esm/common/resource.js.map +1 -0
  267. package/dist-esm/common/tier-hints.d.ts +182 -0
  268. package/dist-esm/common/tier-hints.d.ts.map +1 -0
  269. package/dist-esm/common/tier-hints.js +199 -0
  270. package/dist-esm/common/tier-hints.js.map +1 -0
  271. package/dist-esm/common/trace-sanitizer.d.ts +82 -0
  272. package/dist-esm/common/trace-sanitizer.d.ts.map +1 -0
  273. package/dist-esm/common/trace-sanitizer.js +230 -0
  274. package/dist-esm/common/trace-sanitizer.js.map +1 -0
  275. package/dist-esm/common/traced-socket-types.d.ts +43 -0
  276. package/dist-esm/common/traced-socket-types.d.ts.map +1 -0
  277. package/dist-esm/common/traced-socket-types.js +16 -0
  278. package/dist-esm/common/traced-socket-types.js.map +1 -0
  279. package/dist-esm/index.d.ts +45 -0
  280. package/dist-esm/index.d.ts.map +1 -0
  281. package/dist-esm/index.js +56 -0
  282. package/dist-esm/index.js.map +1 -0
  283. package/dist-esm/lint/forbidden-attributes.d.ts +149 -0
  284. package/dist-esm/lint/forbidden-attributes.d.ts.map +1 -0
  285. package/dist-esm/lint/forbidden-attributes.js +210 -0
  286. package/dist-esm/lint/forbidden-attributes.js.map +1 -0
  287. package/dist-esm/lint/index.d.ts +9 -0
  288. package/dist-esm/lint/index.d.ts.map +1 -0
  289. package/dist-esm/lint/index.js +9 -0
  290. package/dist-esm/lint/index.js.map +1 -0
  291. package/dist-esm/llmobs/index.d.ts +22 -0
  292. package/dist-esm/llmobs/index.d.ts.map +1 -0
  293. package/dist-esm/llmobs/index.js +22 -0
  294. package/dist-esm/llmobs/index.js.map +1 -0
  295. package/dist-esm/llmobs/tier1-exporter.d.ts +146 -0
  296. package/dist-esm/llmobs/tier1-exporter.d.ts.map +1 -0
  297. package/dist-esm/llmobs/tier1-exporter.js +193 -0
  298. package/dist-esm/llmobs/tier1-exporter.js.map +1 -0
  299. package/dist-esm/llmobs/tier2-summarizer.d.ts +268 -0
  300. package/dist-esm/llmobs/tier2-summarizer.d.ts.map +1 -0
  301. package/dist-esm/llmobs/tier2-summarizer.js +652 -0
  302. package/dist-esm/llmobs/tier2-summarizer.js.map +1 -0
  303. package/dist-esm/node/dynamic-attribute-processor.d.ts +43 -0
  304. package/dist-esm/node/dynamic-attribute-processor.d.ts.map +1 -0
  305. package/dist-esm/node/dynamic-attribute-processor.js +74 -0
  306. package/dist-esm/node/dynamic-attribute-processor.js.map +1 -0
  307. package/dist-esm/node/exporters/resilient-exporter.d.ts +91 -0
  308. package/dist-esm/node/exporters/resilient-exporter.d.ts.map +1 -0
  309. package/dist-esm/node/exporters/resilient-exporter.js +132 -0
  310. package/dist-esm/node/exporters/resilient-exporter.js.map +1 -0
  311. package/dist-esm/node/index.d.ts +13 -0
  312. package/dist-esm/node/index.d.ts.map +1 -0
  313. package/dist-esm/node/index.js +13 -0
  314. package/dist-esm/node/index.js.map +1 -0
  315. package/dist-esm/node/init.d.ts +97 -0
  316. package/dist-esm/node/init.d.ts.map +1 -0
  317. package/dist-esm/node/init.js +359 -0
  318. package/dist-esm/node/init.js.map +1 -0
  319. package/dist-esm/node/local-obs-mode.d.ts +17 -0
  320. package/dist-esm/node/local-obs-mode.d.ts.map +1 -0
  321. package/dist-esm/node/local-obs-mode.js +19 -0
  322. package/dist-esm/node/local-obs-mode.js.map +1 -0
  323. package/dist-esm/node/log-processor.d.ts +132 -0
  324. package/dist-esm/node/log-processor.d.ts.map +1 -0
  325. package/dist-esm/node/log-processor.js +389 -0
  326. package/dist-esm/node/log-processor.js.map +1 -0
  327. package/dist-esm/node/metrics-client.d.ts +88 -0
  328. package/dist-esm/node/metrics-client.d.ts.map +1 -0
  329. package/dist-esm/node/metrics-client.js +205 -0
  330. package/dist-esm/node/metrics-client.js.map +1 -0
  331. package/dist-esm/node/safe-logger.d.ts +55 -0
  332. package/dist-esm/node/safe-logger.d.ts.map +1 -0
  333. package/dist-esm/node/safe-logger.js +154 -0
  334. package/dist-esm/node/safe-logger.js.map +1 -0
  335. package/dist-esm/node/sanitizing-processor.d.ts +67 -0
  336. package/dist-esm/node/sanitizing-processor.d.ts.map +1 -0
  337. package/dist-esm/node/sanitizing-processor.js +163 -0
  338. package/dist-esm/node/sanitizing-processor.js.map +1 -0
  339. package/dist-esm/node/service-tracers.d.ts +52 -0
  340. package/dist-esm/node/service-tracers.d.ts.map +1 -0
  341. package/dist-esm/node/service-tracers.js +78 -0
  342. package/dist-esm/node/service-tracers.js.map +1 -0
  343. package/dist-esm/node/traced-socket.d.ts +120 -0
  344. package/dist-esm/node/traced-socket.d.ts.map +1 -0
  345. package/dist-esm/node/traced-socket.js +334 -0
  346. package/dist-esm/node/traced-socket.js.map +1 -0
  347. package/dist-esm/npm-registry/emitter.d.ts +310 -0
  348. package/dist-esm/npm-registry/emitter.d.ts.map +1 -0
  349. package/dist-esm/npm-registry/emitter.js +525 -0
  350. package/dist-esm/npm-registry/emitter.js.map +1 -0
  351. package/dist-esm/npm-registry/index.d.ts +12 -0
  352. package/dist-esm/npm-registry/index.d.ts.map +1 -0
  353. package/dist-esm/npm-registry/index.js +12 -0
  354. package/dist-esm/npm-registry/index.js.map +1 -0
  355. package/dist-esm/npm-registry/sanitize.d.ts +174 -0
  356. package/dist-esm/npm-registry/sanitize.d.ts.map +1 -0
  357. package/dist-esm/npm-registry/sanitize.js +331 -0
  358. package/dist-esm/npm-registry/sanitize.js.map +1 -0
  359. package/dist-esm/npm-registry/spans.d.ts +61 -0
  360. package/dist-esm/npm-registry/spans.d.ts.map +1 -0
  361. package/dist-esm/npm-registry/spans.js +86 -0
  362. package/dist-esm/npm-registry/spans.js.map +1 -0
  363. package/dist-esm/package.json +1 -0
  364. package/dist-esm/testing/in-memory-exporter.d.ts +179 -0
  365. package/dist-esm/testing/in-memory-exporter.d.ts.map +1 -0
  366. package/dist-esm/testing/in-memory-exporter.js +250 -0
  367. package/dist-esm/testing/in-memory-exporter.js.map +1 -0
  368. package/dist-esm/testing/index.d.ts +9 -0
  369. package/dist-esm/testing/index.d.ts.map +1 -0
  370. package/dist-esm/testing/index.js +9 -0
  371. package/dist-esm/testing/index.js.map +1 -0
  372. package/dist-esm/testing/metrics-capture.d.ts +29 -0
  373. package/dist-esm/testing/metrics-capture.d.ts.map +1 -0
  374. package/dist-esm/testing/metrics-capture.js +71 -0
  375. package/dist-esm/testing/metrics-capture.js.map +1 -0
  376. package/dist-esm/testing/test-init.d.ts +80 -0
  377. package/dist-esm/testing/test-init.d.ts.map +1 -0
  378. package/dist-esm/testing/test-init.js +137 -0
  379. package/dist-esm/testing/test-init.js.map +1 -0
  380. package/dist-esm/types/index.d.ts +84 -0
  381. package/dist-esm/types/index.d.ts.map +1 -0
  382. package/dist-esm/types/index.js +7 -0
  383. package/dist-esm/types/index.js.map +1 -0
  384. package/dist-esm/types/policy.d.ts +92 -0
  385. package/dist-esm/types/policy.d.ts.map +1 -0
  386. package/dist-esm/types/policy.js +122 -0
  387. package/dist-esm/types/policy.js.map +1 -0
  388. package/package.json +102 -0
@@ -0,0 +1,182 @@
1
+ /**
2
+ * Tier Policy Hints
3
+ *
4
+ * SDK-level hints that inform the OTEL Collector how to route spans.
5
+ * These are HINTS, not guarantees — the Collector makes final routing decisions.
6
+ *
7
+ * NOTE: This is different from tier TAGS (which indicate which pipeline processed
8
+ * a span). Hints are prescriptive ("please route this way"), tags are descriptive
9
+ * ("this was processed by Tier X"). The Collector adds tier tags; the SDK adds hints.
10
+ *
11
+ * See: engineering/projects/o11y-refactor/proposals/sdk-tier-policy-hints.md
12
+ */
13
+ import type { Span } from "@opentelemetry/api";
14
+ /**
15
+ * The attribute key used for tier policy hints.
16
+ * Collector filters on this attribute to make routing decisions.
17
+ */
18
+ export declare const TIER_HINT_ATTRIBUTE = "superblocks.tier_hint";
19
+ /**
20
+ * Tier policy hints that inform the Collector how to route spans.
21
+ *
22
+ * These are HINTS, not guarantees — the Collector makes final routing decisions
23
+ * based on its configuration. In cloud-prem deployments, the Collector respects
24
+ * these hints to control which tiers receive the span.
25
+ *
26
+ * @example
27
+ * ```typescript
28
+ * import { trace } from '@opentelemetry/api';
29
+ * import { TierPolicyHint, TIER_HINT_ATTRIBUTE } from '@superblocksteam/telemetry';
30
+ *
31
+ * const span = tracer.startSpan('sensitive_operation');
32
+ * span.setAttribute(TIER_HINT_ATTRIBUTE, TierPolicyHint.TIER1_ONLY);
33
+ * ```
34
+ */
35
+ export declare enum TierPolicyHint {
36
+ /**
37
+ * Route to Tier 1 only. Do not export to Tier 2 or Tier 3.
38
+ *
39
+ * Use for:
40
+ * - Spans containing customer secrets or credentials
41
+ * - Highly sensitive customer data that must not leave their environment
42
+ * - Debug/diagnostic spans that should remain local
43
+ *
44
+ * The span will be stored in the customer's Tier 1 backend (e.g., Tempo)
45
+ * but will NOT be exported to Superblocks (Tier 2) or AI analytics (Tier 3).
46
+ */
47
+ TIER1_ONLY = "tier1_only",
48
+ /**
49
+ * Include in Tier 3 (AI quality analysis) in addition to Tier 1 and Tier 2.
50
+ *
51
+ * Use for:
52
+ * - GenAI spans that should be analyzed for quality metrics
53
+ * - AI/LLM operations where prompts and responses are valuable for analysis
54
+ * - Spans with AI quality signals (latency, token usage, etc.)
55
+ *
56
+ * The span will go to all tiers: Tier 1 (full fidelity), Tier 2 (sanitized),
57
+ * and Tier 3 (AI analytics with identity stripped).
58
+ */
59
+ INCLUDE_TIER3 = "include_tier3",
60
+ /**
61
+ * Skip all external export. Tier 1 (local) only, no Tier 2/3.
62
+ * Alias for TIER1_ONLY, kept for semantic clarity.
63
+ *
64
+ * Use for:
65
+ * - High-cardinality diagnostic spans (cost control)
66
+ * - Temporary debug spans that shouldn't persist
67
+ * - Spans that are only useful for local debugging
68
+ *
69
+ * This is functionally equivalent to TIER1_ONLY but communicates
70
+ * a different intent: "this is for cost/noise control" rather than
71
+ * "this contains sensitive data."
72
+ */
73
+ SKIP_EXPORT = "skip_export"
74
+ }
75
+ /**
76
+ * Set a tier policy hint on a span.
77
+ *
78
+ * This is a convenience function that sets the `superblocks.tier_hint` attribute.
79
+ * You can also set the attribute directly if preferred.
80
+ *
81
+ * @param span - The span to set the hint on
82
+ * @param hint - The tier policy hint
83
+ *
84
+ * @example
85
+ * ```typescript
86
+ * import { setTierHint, TierPolicyHint } from '@superblocksteam/telemetry';
87
+ *
88
+ * tracer.startActiveSpan('decrypt_secret', (span) => {
89
+ * setTierHint(span, TierPolicyHint.TIER1_ONLY);
90
+ * // ... perform operation
91
+ * span.end();
92
+ * });
93
+ * ```
94
+ */
95
+ export declare function setTierHint(span: Span, hint: TierPolicyHint): void;
96
+ /**
97
+ * Mark a span as containing sensitive data that should not leave Tier 1.
98
+ *
99
+ * Use this for spans that handle customer secrets, credentials, or other
100
+ * highly sensitive data that must remain in the customer's environment.
101
+ *
102
+ * @param span - The span to mark as sensitive
103
+ *
104
+ * @example
105
+ * ```typescript
106
+ * import { markSensitive } from '@superblocksteam/telemetry';
107
+ *
108
+ * tracer.startActiveSpan('decrypt_customer_secret', (span) => {
109
+ * markSensitive(span);
110
+ * // ... decrypt operation
111
+ * span.end();
112
+ * });
113
+ * ```
114
+ */
115
+ export declare function markSensitive(span: Span): void;
116
+ /**
117
+ * Mark a span for AI quality analysis (Tier 3).
118
+ *
119
+ * Use this for GenAI spans that should be analyzed for quality metrics.
120
+ * The span will go to all tiers, with Tier 3 receiving the content
121
+ * (prompts/responses) for AI quality analysis.
122
+ *
123
+ * @param span - The span to mark for AI analysis
124
+ *
125
+ * @example
126
+ * ```typescript
127
+ * import { markForAIAnalysis } from '@superblocksteam/telemetry';
128
+ *
129
+ * tracer.startActiveSpan('gen_ai.chat', (span) => {
130
+ * markForAIAnalysis(span);
131
+ * span.setAttribute('gen_ai.system', 'anthropic');
132
+ * // ... LLM call
133
+ * span.end();
134
+ * });
135
+ * ```
136
+ */
137
+ export declare function markForAIAnalysis(span: Span): void;
138
+ /**
139
+ * Mark a span as debug-only (no export to Tier 2/3).
140
+ *
141
+ * Use this for high-cardinality diagnostic spans where you want to
142
+ * control costs by preventing export to paid backends.
143
+ *
144
+ * @param span - The span to mark as debug-only
145
+ *
146
+ * @example
147
+ * ```typescript
148
+ * import { markDebugOnly } from '@superblocksteam/telemetry';
149
+ *
150
+ * tracer.startActiveSpan('debug.cache_lookup', (span) => {
151
+ * markDebugOnly(span);
152
+ * span.setAttribute('cache.key', cacheKey); // High cardinality OK
153
+ * // ... lookup
154
+ * span.end();
155
+ * });
156
+ * ```
157
+ */
158
+ export declare function markDebugOnly(span: Span): void;
159
+ /**
160
+ * Check if a span has a tier hint set.
161
+ *
162
+ * @param span - The span to check (must be a ReadableSpan with attributes)
163
+ * @returns The tier hint if set, undefined otherwise
164
+ */
165
+ export declare function getTierHint(span: {
166
+ attributes?: Record<string, unknown>;
167
+ }): TierPolicyHint | undefined;
168
+ /**
169
+ * Check if a tier hint indicates the span should skip Tier 2 export.
170
+ *
171
+ * @param hint - The tier hint to check
172
+ * @returns true if Tier 2 should be skipped
173
+ */
174
+ export declare function shouldSkipTier2(hint: TierPolicyHint | undefined): boolean;
175
+ /**
176
+ * Check if a tier hint indicates the span should be included in Tier 3.
177
+ *
178
+ * @param hint - The tier hint to check
179
+ * @returns true if Tier 3 should be included
180
+ */
181
+ export declare function shouldIncludeTier3(hint: TierPolicyHint | undefined): boolean;
182
+ //# sourceMappingURL=tier-hints.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tier-hints.d.ts","sourceRoot":"","sources":["../../src/common/tier-hints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAE3D;;;;;;;;;;;;;;;GAeG;AACH,oBAAY,cAAc;IACxB;;;;;;;;;;OAUG;IACH,UAAU,eAAe;IAEzB;;;;;;;;;;OAUG;IACH,aAAa,kBAAkB;IAE/B;;;;;;;;;;;;OAYG;IACH,WAAW,gBAAgB;CAC5B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAElE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAE9C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAElD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAE9C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,GAAG,cAAc,GAAG,SAAS,CAS7B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,GAAG,OAAO,CAIzE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,GAAG,OAAO,CAE5E"}
@@ -0,0 +1,209 @@
1
+ "use strict";
2
+ /**
3
+ * Tier Policy Hints
4
+ *
5
+ * SDK-level hints that inform the OTEL Collector how to route spans.
6
+ * These are HINTS, not guarantees — the Collector makes final routing decisions.
7
+ *
8
+ * NOTE: This is different from tier TAGS (which indicate which pipeline processed
9
+ * a span). Hints are prescriptive ("please route this way"), tags are descriptive
10
+ * ("this was processed by Tier X"). The Collector adds tier tags; the SDK adds hints.
11
+ *
12
+ * See: engineering/projects/o11y-refactor/proposals/sdk-tier-policy-hints.md
13
+ */
14
+ Object.defineProperty(exports, "__esModule", { value: true });
15
+ exports.TierPolicyHint = exports.TIER_HINT_ATTRIBUTE = void 0;
16
+ exports.setTierHint = setTierHint;
17
+ exports.markSensitive = markSensitive;
18
+ exports.markForAIAnalysis = markForAIAnalysis;
19
+ exports.markDebugOnly = markDebugOnly;
20
+ exports.getTierHint = getTierHint;
21
+ exports.shouldSkipTier2 = shouldSkipTier2;
22
+ exports.shouldIncludeTier3 = shouldIncludeTier3;
23
+ /**
24
+ * The attribute key used for tier policy hints.
25
+ * Collector filters on this attribute to make routing decisions.
26
+ */
27
+ exports.TIER_HINT_ATTRIBUTE = "superblocks.tier_hint";
28
+ /**
29
+ * Tier policy hints that inform the Collector how to route spans.
30
+ *
31
+ * These are HINTS, not guarantees — the Collector makes final routing decisions
32
+ * based on its configuration. In cloud-prem deployments, the Collector respects
33
+ * these hints to control which tiers receive the span.
34
+ *
35
+ * @example
36
+ * ```typescript
37
+ * import { trace } from '@opentelemetry/api';
38
+ * import { TierPolicyHint, TIER_HINT_ATTRIBUTE } from '@superblocksteam/telemetry';
39
+ *
40
+ * const span = tracer.startSpan('sensitive_operation');
41
+ * span.setAttribute(TIER_HINT_ATTRIBUTE, TierPolicyHint.TIER1_ONLY);
42
+ * ```
43
+ */
44
+ var TierPolicyHint;
45
+ (function (TierPolicyHint) {
46
+ /**
47
+ * Route to Tier 1 only. Do not export to Tier 2 or Tier 3.
48
+ *
49
+ * Use for:
50
+ * - Spans containing customer secrets or credentials
51
+ * - Highly sensitive customer data that must not leave their environment
52
+ * - Debug/diagnostic spans that should remain local
53
+ *
54
+ * The span will be stored in the customer's Tier 1 backend (e.g., Tempo)
55
+ * but will NOT be exported to Superblocks (Tier 2) or AI analytics (Tier 3).
56
+ */
57
+ TierPolicyHint["TIER1_ONLY"] = "tier1_only";
58
+ /**
59
+ * Include in Tier 3 (AI quality analysis) in addition to Tier 1 and Tier 2.
60
+ *
61
+ * Use for:
62
+ * - GenAI spans that should be analyzed for quality metrics
63
+ * - AI/LLM operations where prompts and responses are valuable for analysis
64
+ * - Spans with AI quality signals (latency, token usage, etc.)
65
+ *
66
+ * The span will go to all tiers: Tier 1 (full fidelity), Tier 2 (sanitized),
67
+ * and Tier 3 (AI analytics with identity stripped).
68
+ */
69
+ TierPolicyHint["INCLUDE_TIER3"] = "include_tier3";
70
+ /**
71
+ * Skip all external export. Tier 1 (local) only, no Tier 2/3.
72
+ * Alias for TIER1_ONLY, kept for semantic clarity.
73
+ *
74
+ * Use for:
75
+ * - High-cardinality diagnostic spans (cost control)
76
+ * - Temporary debug spans that shouldn't persist
77
+ * - Spans that are only useful for local debugging
78
+ *
79
+ * This is functionally equivalent to TIER1_ONLY but communicates
80
+ * a different intent: "this is for cost/noise control" rather than
81
+ * "this contains sensitive data."
82
+ */
83
+ TierPolicyHint["SKIP_EXPORT"] = "skip_export";
84
+ })(TierPolicyHint || (exports.TierPolicyHint = TierPolicyHint = {}));
85
+ /**
86
+ * Set a tier policy hint on a span.
87
+ *
88
+ * This is a convenience function that sets the `superblocks.tier_hint` attribute.
89
+ * You can also set the attribute directly if preferred.
90
+ *
91
+ * @param span - The span to set the hint on
92
+ * @param hint - The tier policy hint
93
+ *
94
+ * @example
95
+ * ```typescript
96
+ * import { setTierHint, TierPolicyHint } from '@superblocksteam/telemetry';
97
+ *
98
+ * tracer.startActiveSpan('decrypt_secret', (span) => {
99
+ * setTierHint(span, TierPolicyHint.TIER1_ONLY);
100
+ * // ... perform operation
101
+ * span.end();
102
+ * });
103
+ * ```
104
+ */
105
+ function setTierHint(span, hint) {
106
+ span.setAttribute(exports.TIER_HINT_ATTRIBUTE, hint);
107
+ }
108
+ /**
109
+ * Mark a span as containing sensitive data that should not leave Tier 1.
110
+ *
111
+ * Use this for spans that handle customer secrets, credentials, or other
112
+ * highly sensitive data that must remain in the customer's environment.
113
+ *
114
+ * @param span - The span to mark as sensitive
115
+ *
116
+ * @example
117
+ * ```typescript
118
+ * import { markSensitive } from '@superblocksteam/telemetry';
119
+ *
120
+ * tracer.startActiveSpan('decrypt_customer_secret', (span) => {
121
+ * markSensitive(span);
122
+ * // ... decrypt operation
123
+ * span.end();
124
+ * });
125
+ * ```
126
+ */
127
+ function markSensitive(span) {
128
+ setTierHint(span, TierPolicyHint.TIER1_ONLY);
129
+ }
130
+ /**
131
+ * Mark a span for AI quality analysis (Tier 3).
132
+ *
133
+ * Use this for GenAI spans that should be analyzed for quality metrics.
134
+ * The span will go to all tiers, with Tier 3 receiving the content
135
+ * (prompts/responses) for AI quality analysis.
136
+ *
137
+ * @param span - The span to mark for AI analysis
138
+ *
139
+ * @example
140
+ * ```typescript
141
+ * import { markForAIAnalysis } from '@superblocksteam/telemetry';
142
+ *
143
+ * tracer.startActiveSpan('gen_ai.chat', (span) => {
144
+ * markForAIAnalysis(span);
145
+ * span.setAttribute('gen_ai.system', 'anthropic');
146
+ * // ... LLM call
147
+ * span.end();
148
+ * });
149
+ * ```
150
+ */
151
+ function markForAIAnalysis(span) {
152
+ setTierHint(span, TierPolicyHint.INCLUDE_TIER3);
153
+ }
154
+ /**
155
+ * Mark a span as debug-only (no export to Tier 2/3).
156
+ *
157
+ * Use this for high-cardinality diagnostic spans where you want to
158
+ * control costs by preventing export to paid backends.
159
+ *
160
+ * @param span - The span to mark as debug-only
161
+ *
162
+ * @example
163
+ * ```typescript
164
+ * import { markDebugOnly } from '@superblocksteam/telemetry';
165
+ *
166
+ * tracer.startActiveSpan('debug.cache_lookup', (span) => {
167
+ * markDebugOnly(span);
168
+ * span.setAttribute('cache.key', cacheKey); // High cardinality OK
169
+ * // ... lookup
170
+ * span.end();
171
+ * });
172
+ * ```
173
+ */
174
+ function markDebugOnly(span) {
175
+ setTierHint(span, TierPolicyHint.SKIP_EXPORT);
176
+ }
177
+ /**
178
+ * Check if a span has a tier hint set.
179
+ *
180
+ * @param span - The span to check (must be a ReadableSpan with attributes)
181
+ * @returns The tier hint if set, undefined otherwise
182
+ */
183
+ function getTierHint(span) {
184
+ const hint = span.attributes?.[exports.TIER_HINT_ATTRIBUTE];
185
+ if (typeof hint === "string" &&
186
+ Object.values(TierPolicyHint).includes(hint)) {
187
+ return hint;
188
+ }
189
+ return undefined;
190
+ }
191
+ /**
192
+ * Check if a tier hint indicates the span should skip Tier 2 export.
193
+ *
194
+ * @param hint - The tier hint to check
195
+ * @returns true if Tier 2 should be skipped
196
+ */
197
+ function shouldSkipTier2(hint) {
198
+ return (hint === TierPolicyHint.TIER1_ONLY || hint === TierPolicyHint.SKIP_EXPORT);
199
+ }
200
+ /**
201
+ * Check if a tier hint indicates the span should be included in Tier 3.
202
+ *
203
+ * @param hint - The tier hint to check
204
+ * @returns true if Tier 3 should be included
205
+ */
206
+ function shouldIncludeTier3(hint) {
207
+ return hint === TierPolicyHint.INCLUDE_TIER3;
208
+ }
209
+ //# sourceMappingURL=tier-hints.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tier-hints.js","sourceRoot":"","sources":["../../src/common/tier-hints.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAyFH,kCAEC;AAqBD,sCAEC;AAuBD,8CAEC;AAsBD,sCAEC;AAQD,kCAWC;AAQD,0CAIC;AAQD,gDAEC;AAxMD;;;GAGG;AACU,QAAA,mBAAmB,GAAG,uBAAuB,CAAC;AAE3D;;;;;;;;;;;;;;;GAeG;AACH,IAAY,cAyCX;AAzCD,WAAY,cAAc;IACxB;;;;;;;;;;OAUG;IACH,2CAAyB,CAAA;IAEzB;;;;;;;;;;OAUG;IACH,iDAA+B,CAAA;IAE/B;;;;;;;;;;;;OAYG;IACH,6CAA2B,CAAA;AAC7B,CAAC,EAzCW,cAAc,8BAAd,cAAc,QAyCzB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,WAAW,CAAC,IAAU,EAAE,IAAoB;IAC1D,IAAI,CAAC,YAAY,CAAC,2BAAmB,EAAE,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,aAAa,CAAC,IAAU;IACtC,WAAW,CAAC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,iBAAiB,CAAC,IAAU;IAC1C,WAAW,CAAC,IAAI,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,aAAa,CAAC,IAAU;IACtC,WAAW,CAAC,IAAI,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,IAE3B;IACC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,2BAAmB,CAAC,CAAC;IACpD,IACE,OAAO,IAAI,KAAK,QAAQ;QACxB,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,IAAsB,CAAC,EAC9D,CAAC;QACD,OAAO,IAAsB,CAAC;IAChC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,IAAgC;IAC9D,OAAO,CACL,IAAI,KAAK,cAAc,CAAC,UAAU,IAAI,IAAI,KAAK,cAAc,CAAC,WAAW,CAC1E,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,IAAgC;IACjE,OAAO,IAAI,KAAK,cAAc,CAAC,aAAa,CAAC;AAC/C,CAAC"}
@@ -0,0 +1,82 @@
1
+ /**
2
+ * Tier 2 Trace Sanitizer
3
+ *
4
+ * Sanitizes spans for Tier 2 export per epic-a3-sanitized-traces.
5
+ * - Drops spans for high-volume, low-value routes (health, metrics)
6
+ * - Drops spans not in the contract
7
+ * - Drops forbidden attributes (PII, Tier 1 content)
8
+ * - Drops high-cardinality attributes (e.g. binding_keys) when configured
9
+ * - Hashes configured attributes using keyed HMAC (when hash config provided)
10
+ * - Only includes attributes in the allowlist for each span type
11
+ */
12
+ import type { ReadableSpan } from "@opentelemetry/sdk-trace-base";
13
+ import { type SpanDefinition } from "./contracts/tier2-traces.js";
14
+ export interface HashConfig {
15
+ secretKey: Buffer;
16
+ salt: string;
17
+ algorithm: "sha256" | "sha384" | "sha512";
18
+ outputLengthBytes: number;
19
+ }
20
+ /**
21
+ * Configuration for the trace sanitizer. Attribute sets and contract can vary by deployment type
22
+ * (e.g. cloud vs cloud-prem). Use getTraceSanitizerAttributeSets(deploymentType)
23
+ * from the contract to obtain sets for a given policy.
24
+ */
25
+ export interface TraceSanitizerOptions {
26
+ hashConfig: HashConfig | null;
27
+ forbiddenAttributes: Set<string>;
28
+ droppedAttributes: Set<string>;
29
+ hashedAttributes: Set<string>;
30
+ /** Span definitions for name matching; defaults to TIER_2_TRACE_CONTRACT if omitted. */
31
+ spanDefinitions?: SpanDefinition[];
32
+ /** When true, span attributes are not filtered by allowedAttributes (pass-through). */
33
+ attributeAllowlistPassthrough?: boolean;
34
+ }
35
+ export declare class TraceSanitizer {
36
+ private readonly contractMap;
37
+ private readonly hashConfig;
38
+ private readonly forbiddenAttributes;
39
+ private readonly droppedAttributes;
40
+ private readonly hashedAttributes;
41
+ private readonly attributeAllowlistPassthrough;
42
+ constructor(options: TraceSanitizerOptions);
43
+ /**
44
+ * Check if a span should be exported to Tier 2.
45
+ */
46
+ shouldExport(span: ReadableSpan): boolean;
47
+ /**
48
+ * Sanitize span attributes for Tier 2 export.
49
+ * Returns null if span should not be exported.
50
+ *
51
+ * Returns a ReadableSpan-like object that delegates to the original span for
52
+ * spanContext() and other methods (spread does not copy prototype methods,
53
+ * and the OTLP exporter calls span.spanContext()).
54
+ */
55
+ sanitize(span: ReadableSpan): ReadableSpan | null;
56
+ private findMatchingDefinition;
57
+ /**
58
+ * Pattern matching: "*" matches any name; suffix wildcards (e.g. "HTTP POST *", "ws.*").
59
+ * For "HTTP POST *", matches "HTTP POST" (exact) or "HTTP POST /path" (prefix + rest).
60
+ */
61
+ private matchesPattern;
62
+ /**
63
+ * Sanitize span links for Tier 2: link attributes are filtered the same way as
64
+ * event attributes (forbidden dropped, high-cardinality dropped, hashed values).
65
+ * Link context (trace/span IDs) is preserved.
66
+ */
67
+ private sanitizeLinks;
68
+ /**
69
+ * Sanitize span events for Tier 2: event attributes are filtered the same way as
70
+ * span attributes (forbidden dropped, high-cardinality dropped, hashed values).
71
+ * Event names and timestamps are preserved.
72
+ */
73
+ private sanitizeEvents;
74
+ /**
75
+ * Sanitize attributes that appear on events or links (no allowlist; only
76
+ * drop forbidden/high-cardinality and hash hashed).
77
+ */
78
+ private sanitizeEventOrLinkAttributes;
79
+ private sanitizeAttributes;
80
+ private hashValue;
81
+ }
82
+ //# sourceMappingURL=trace-sanitizer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"trace-sanitizer.d.ts","sourceRoot":"","sources":["../../src/common/trace-sanitizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAYH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC1C,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACjC,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,wFAAwF;IACxF,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,uFAAuF;IACvF,6BAA6B,CAAC,EAAE,OAAO,CAAC;CACzC;AAcD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8B;IAC1D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAc;IAClD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAc;IAChD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAc;IAC/C,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAU;gBAE5C,OAAO,EAAE,qBAAqB;IAc1C;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO;IAIzC;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,GAAG,IAAI;IA6CjD,OAAO,CAAC,sBAAsB;IAe9B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAgBtB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAYrB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAetB;;;OAGG;IACH,OAAO,CAAC,6BAA6B;IAkBrC,OAAO,CAAC,kBAAkB;IAuC1B,OAAO,CAAC,SAAS;CAYlB"}