@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,46 +0,0 @@
1
- /**
2
- * Browser Metrics Bootstrap
3
- *
4
- * Initializes a MeterProvider for browser contexts using OTLP HTTP export.
5
- */
6
- import { metrics } from "@opentelemetry/api";
7
- import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-http";
8
- import { AggregationTemporality, MeterProvider, PeriodicExportingMetricReader, } from "@opentelemetry/sdk-metrics";
9
- /**
10
- * Browser metrics export interval.
11
- *
12
- * The OTel default is 60 s, but browser sessions are typically short-lived.
13
- * A page closed before the first export fires silently loses all recorded
14
- * metrics (there is no flush-on-unload in PeriodicExportingMetricReader).
15
- * 10 s keeps the window small enough that most sessions export at least once.
16
- */
17
- const BROWSER_EXPORT_INTERVAL_MS = 10_000;
18
- /**
19
- * Initialize browser metrics with a MeterProvider that exports via OTLP HTTP.
20
- *
21
- * Uses DELTA aggregation temporality so each export stands on its own and
22
- * Datadog does not see counter-reset artifacts from short-lived sessions.
23
- *
24
- * @param config - Browser metrics configuration
25
- * @returns Browser metrics instance with getMeter and shutdown
26
- */
27
- export function initBrowserMetrics(config) {
28
- const exporter = new OTLPMetricExporter({
29
- url: config.otlpUrl,
30
- temporalityPreference: AggregationTemporality.DELTA,
31
- });
32
- const reader = new PeriodicExportingMetricReader({
33
- exporter,
34
- exportIntervalMillis: BROWSER_EXPORT_INTERVAL_MS,
35
- });
36
- const provider = new MeterProvider({
37
- resource: config.resource,
38
- readers: [reader],
39
- });
40
- metrics.setGlobalMeterProvider(provider);
41
- return {
42
- getMeter: (name) => provider.getMeter(name ?? config.serviceName),
43
- shutdown: () => provider.shutdown(),
44
- };
45
- }
46
- //# sourceMappingURL=metrics.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/browser/metrics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAc,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAE/E,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,6BAA6B,GAC9B,MAAM,4BAA4B,CAAC;AAepC;;;;;;;GAOG;AACH,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAE1C;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAA4B;IAE5B,MAAM,QAAQ,GAAG,IAAI,kBAAkB,CAAC;QACtC,GAAG,EAAE,MAAM,CAAC,OAAO;QACnB,qBAAqB,EAAE,sBAAsB,CAAC,KAAK;KACpD,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,6BAA6B,CAAC;QAC/C,QAAQ;QACR,oBAAoB,EAAE,0BAA0B;KACjD,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,IAAI,aAAa,CAAC;QACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,OAAO,EAAE,CAAC,MAAM,CAAC;KAClB,CAAC,CAAC;IAEH,OAAO,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAEzC,OAAO;QACL,QAAQ,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,MAAM,CAAC,WAAW,CAAC;QAC1E,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE;KACpC,CAAC;AACJ,CAAC"}
@@ -1,43 +0,0 @@
1
- /**
2
- * Browser Resilient Exporter
3
- *
4
- * Simplified resilient exporter for browser environments.
5
- * Ensures export failures don't affect the main thread.
6
- */
7
- import { ExportResult } from "@opentelemetry/core";
8
- import type { SpanExporter, ReadableSpan } from "@opentelemetry/sdk-trace-base";
9
- /**
10
- * Configuration for the browser resilient exporter.
11
- */
12
- export interface BrowserResilientExporterConfig {
13
- /** Underlying exporter to wrap */
14
- delegate: SpanExporter;
15
- /** Max items to buffer before dropping (default: 512, lower than Node for memory) */
16
- maxQueueSize?: number;
17
- /** Export timeout in ms (default: 10000, shorter for browser) */
18
- exportTimeoutMs?: number;
19
- /** Callback when items are dropped */
20
- onDrop?: (count: number, reason: "queue_full" | "export_failed" | "timeout") => void;
21
- }
22
- /**
23
- * Browser-compatible resilient exporter.
24
- *
25
- * CRITICAL: Export failures must never block or affect the main thread.
26
- * This wrapper catches all errors and timeouts.
27
- */
28
- export declare class BrowserResilientExporter implements SpanExporter {
29
- private readonly delegate;
30
- private readonly maxQueueSize;
31
- private readonly exportTimeoutMs;
32
- private readonly onDrop;
33
- private queuedCount;
34
- private shuttingDown;
35
- constructor(config: BrowserResilientExporterConfig);
36
- /**
37
- * Export spans with resilient error handling.
38
- */
39
- export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): void;
40
- shutdown(): Promise<void>;
41
- forceFlush(): Promise<void>;
42
- }
43
- //# sourceMappingURL=resilient-exporter.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"resilient-exporter.d.ts","sourceRoot":"","sources":["../../src/browser/resilient-exporter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAoB,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,kCAAkC;IAClC,QAAQ,EAAE,YAAY,CAAC;IACvB,qFAAqF;IACrF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sCAAsC;IACtC,MAAM,CAAC,EAAE,CACP,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,YAAY,GAAG,eAAe,GAAG,SAAS,KAC/C,IAAI,CAAC;CACX;AAED;;;;;GAKG;AACH,qBAAa,wBAAyB,YAAW,YAAY;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAGb;IAEV,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,EAAE,8BAA8B;IAOlD;;OAEG;IACH,MAAM,CACJ,KAAK,EAAE,YAAY,EAAE,EACrB,cAAc,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAC7C,IAAI;IAiDD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAKzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}
@@ -1,84 +0,0 @@
1
- /**
2
- * Browser Resilient Exporter
3
- *
4
- * Simplified resilient exporter for browser environments.
5
- * Ensures export failures don't affect the main thread.
6
- */
7
- import { ExportResultCode } from "@opentelemetry/core";
8
- /**
9
- * Browser-compatible resilient exporter.
10
- *
11
- * CRITICAL: Export failures must never block or affect the main thread.
12
- * This wrapper catches all errors and timeouts.
13
- */
14
- export class BrowserResilientExporter {
15
- delegate;
16
- maxQueueSize;
17
- exportTimeoutMs;
18
- onDrop;
19
- queuedCount = 0;
20
- shuttingDown = false;
21
- constructor(config) {
22
- this.delegate = config.delegate;
23
- this.maxQueueSize = config.maxQueueSize ?? 512;
24
- this.exportTimeoutMs = config.exportTimeoutMs ?? 10000;
25
- this.onDrop = config.onDrop ?? (() => { });
26
- }
27
- /**
28
- * Export spans with resilient error handling.
29
- */
30
- export(spans, resultCallback) {
31
- // Reject during shutdown
32
- if (this.shuttingDown) {
33
- resultCallback({ code: ExportResultCode.SUCCESS });
34
- return;
35
- }
36
- // Check backpressure
37
- if (this.queuedCount + spans.length > this.maxQueueSize) {
38
- this.onDrop(spans.length, "queue_full");
39
- resultCallback({ code: ExportResultCode.SUCCESS });
40
- return;
41
- }
42
- this.queuedCount += spans.length;
43
- let completed = false;
44
- // Timeout handler
45
- const timeoutId = setTimeout(() => {
46
- if (completed)
47
- return;
48
- completed = true;
49
- this.queuedCount -= spans.length;
50
- this.onDrop(spans.length, "timeout");
51
- resultCallback({ code: ExportResultCode.SUCCESS });
52
- }, this.exportTimeoutMs);
53
- try {
54
- this.delegate.export(spans, (result) => {
55
- if (completed)
56
- return;
57
- completed = true;
58
- clearTimeout(timeoutId);
59
- this.queuedCount -= spans.length;
60
- if (result.code !== ExportResultCode.SUCCESS) {
61
- this.onDrop(spans.length, "export_failed");
62
- }
63
- resultCallback({ code: ExportResultCode.SUCCESS });
64
- });
65
- }
66
- catch {
67
- if (completed)
68
- return;
69
- completed = true;
70
- clearTimeout(timeoutId);
71
- this.queuedCount -= spans.length;
72
- this.onDrop(spans.length, "export_failed");
73
- resultCallback({ code: ExportResultCode.SUCCESS });
74
- }
75
- }
76
- async shutdown() {
77
- this.shuttingDown = true;
78
- return this.delegate.shutdown();
79
- }
80
- async forceFlush() {
81
- return this.delegate.forceFlush?.() ?? Promise.resolve();
82
- }
83
- }
84
- //# sourceMappingURL=resilient-exporter.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"resilient-exporter.js","sourceRoot":"","sources":["../../src/browser/resilient-exporter.ts"],"names":[],"mappings":"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"}
@@ -1,35 +0,0 @@
1
- /**
2
- * Browser PII Sanitizing Processors
3
- *
4
- * Span and log processors that redact PII before export from the browser.
5
- * Browser telemetry always runs in untrusted context, so aggressive sanitization
6
- * is applied unconditionally.
7
- *
8
- * - SanitizingSpanProcessor: redacts sensitive span attributes and strips
9
- * sensitive query params from URL attributes.
10
- * - SanitizingLogProcessor: redacts sensitive log record attributes and
11
- * replaces email-like patterns in log body text.
12
- */
13
- import type { LogRecordProcessor } from "@opentelemetry/sdk-logs";
14
- import type { SpanProcessor } from "@opentelemetry/sdk-trace-base";
15
- export interface SanitizingConfig {
16
- /** Additional attribute key patterns to redact */
17
- additionalKeyPatterns?: RegExp[];
18
- /** Additional URL param names to strip */
19
- additionalSensitiveParams?: string[];
20
- }
21
- /**
22
- * Create a SpanProcessor that redacts PII from span attributes before export.
23
- *
24
- * @param config - Optional configuration for additional key patterns / URL params
25
- * @returns A SpanProcessor suitable for use in a browser WebTracerProvider
26
- */
27
- export declare function createSanitizingSpanProcessor(config?: SanitizingConfig): SpanProcessor;
28
- /**
29
- * Create a LogRecordProcessor that redacts PII from log records before export.
30
- *
31
- * @param config - Optional configuration for additional key patterns
32
- * @returns A LogRecordProcessor suitable for use in a browser log provider
33
- */
34
- export declare function createSanitizingLogProcessor(config?: SanitizingConfig): LogRecordProcessor;
35
- //# sourceMappingURL=sanitizer.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"sanitizer.d.ts","sourceRoot":"","sources":["../../src/browser/sanitizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAEV,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAGV,aAAa,EACd,MAAM,+BAA+B,CAAC;AAwDvC,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,0CAA0C;IAC1C,yBAAyB,CAAC,EAAE,MAAM,EAAE,CAAC;CACtC;AAsKD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,CAAC,EAAE,gBAAgB,GACxB,aAAa,CAEf;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,CAAC,EAAE,gBAAgB,GACxB,kBAAkB,CAEpB"}
@@ -1,207 +0,0 @@
1
- /**
2
- * Browser PII Sanitizing Processors
3
- *
4
- * Span and log processors that redact PII before export from the browser.
5
- * Browser telemetry always runs in untrusted context, so aggressive sanitization
6
- * is applied unconditionally.
7
- *
8
- * - SanitizingSpanProcessor: redacts sensitive span attributes and strips
9
- * sensitive query params from URL attributes.
10
- * - SanitizingLogProcessor: redacts sensitive log record attributes and
11
- * replaces email-like patterns in log body text.
12
- */
13
- // ============================================================================
14
- // Constants
15
- // ============================================================================
16
- const REDACTED = "[REDACTED]";
17
- const REDACTED_EMAIL = "[REDACTED_EMAIL]";
18
- /**
19
- * Attribute key substrings that indicate sensitive values.
20
- * Case-insensitive matching is applied.
21
- */
22
- const SENSITIVE_KEY_SUBSTRINGS = [
23
- "email",
24
- "token",
25
- "secret",
26
- "password",
27
- "authorization",
28
- "cookie",
29
- "credential",
30
- ];
31
- /**
32
- * Attribute key patterns (regex) for additional well-known sensitive keys
33
- * not covered by simple substring matching (e.g. api_key, x-api-key).
34
- */
35
- const SENSITIVE_KEY_PATTERNS = [
36
- /api[_\-.]?key/i,
37
- /x[_\-.]?api[_\-.]?key/i,
38
- ];
39
- /**
40
- * URL query parameter names that should be stripped.
41
- * Exact (case-insensitive) match against param name.
42
- */
43
- const SENSITIVE_URL_PARAMS = [
44
- "token",
45
- "key",
46
- "secret",
47
- "password",
48
- "code",
49
- "state",
50
- "auth",
51
- ];
52
- /** URL attribute keys that receive query-param sanitization. */
53
- const URL_ATTRIBUTE_KEYS = new Set(["http.url", "url.full"]);
54
- /** Regex matching email-like patterns in log body text. */
55
- const EMAIL_PATTERN = /[\w.+-]+@[\w.-]+(\.\w+)?/g;
56
- // ============================================================================
57
- // Helpers
58
- // ============================================================================
59
- /**
60
- * Returns true if the attribute key is sensitive and its value should be
61
- * replaced with [REDACTED].
62
- */
63
- function isSensitiveKey(key, additionalPatterns) {
64
- const lower = key.toLowerCase();
65
- for (const substr of SENSITIVE_KEY_SUBSTRINGS) {
66
- if (lower.includes(substr)) {
67
- return true;
68
- }
69
- }
70
- for (const pattern of SENSITIVE_KEY_PATTERNS) {
71
- pattern.lastIndex = 0;
72
- if (pattern.test(key)) {
73
- return true;
74
- }
75
- }
76
- for (const pattern of additionalPatterns) {
77
- pattern.lastIndex = 0;
78
- if (pattern.test(key)) {
79
- return true;
80
- }
81
- }
82
- return false;
83
- }
84
- /**
85
- * Strips sensitive query parameters from a URL string.
86
- * Sensitive param values are replaced with [REDACTED] (key is preserved).
87
- */
88
- function sanitizeUrl(url, additionalParams) {
89
- const qIdx = url.indexOf("?");
90
- if (qIdx === -1) {
91
- return url;
92
- }
93
- const base = url.slice(0, qIdx);
94
- const query = url.slice(qIdx + 1);
95
- const sensitiveSet = new Set([
96
- ...SENSITIVE_URL_PARAMS.map((p) => p.toLowerCase()),
97
- ...additionalParams.map((p) => p.toLowerCase()),
98
- ]);
99
- const sanitizedParts = query.split("&").map((part) => {
100
- const eqIdx = part.indexOf("=");
101
- if (eqIdx === -1) {
102
- return part;
103
- }
104
- const rawParamName = part.slice(0, eqIdx);
105
- let paramName;
106
- try {
107
- paramName = decodeURIComponent(rawParamName).toLowerCase();
108
- }
109
- catch {
110
- paramName = rawParamName.toLowerCase();
111
- }
112
- if (sensitiveSet.has(paramName)) {
113
- return `${part.slice(0, eqIdx)}=${REDACTED}`;
114
- }
115
- return part;
116
- });
117
- return `${base}?${sanitizedParts.join("&")}`;
118
- }
119
- /**
120
- * Sanitizes span/log attributes in-place. Sensitive keys get value [REDACTED];
121
- * URL attributes get query-param sanitization.
122
- */
123
- function sanitizeAttributes(attributes, additionalKeyPatterns, additionalSensitiveParams) {
124
- for (const key of Object.keys(attributes)) {
125
- if (URL_ATTRIBUTE_KEYS.has(key)) {
126
- const val = attributes[key];
127
- if (typeof val === "string") {
128
- attributes[key] = sanitizeUrl(val, additionalSensitiveParams);
129
- }
130
- // URL attributes are handled; skip further key-based check
131
- continue;
132
- }
133
- if (isSensitiveKey(key, additionalKeyPatterns)) {
134
- attributes[key] = REDACTED;
135
- }
136
- }
137
- }
138
- // ============================================================================
139
- // SanitizingSpanProcessor
140
- // ============================================================================
141
- class SanitizingSpanProcessor {
142
- additionalKeyPatterns;
143
- additionalSensitiveParams;
144
- constructor(config = {}) {
145
- this.additionalKeyPatterns = config.additionalKeyPatterns ?? [];
146
- this.additionalSensitiveParams = config.additionalSensitiveParams ?? [];
147
- }
148
- onStart(_span, _parentContext) {
149
- // Nothing to do at start; sanitization occurs at end when attributes are final.
150
- }
151
- onEnd(span) {
152
- // ReadableSpan.attributes is typed as Attributes (readonly in API), but
153
- // in practice the SDK implementation uses a mutable object. We cast to
154
- // allow in-place mutation, which avoids allocating a new span wrapper.
155
- const attrs = span.attributes;
156
- sanitizeAttributes(attrs, this.additionalKeyPatterns, this.additionalSensitiveParams);
157
- }
158
- async shutdown() { }
159
- async forceFlush() { }
160
- }
161
- // ============================================================================
162
- // SanitizingLogProcessor
163
- // ============================================================================
164
- class BrowserSanitizingLogProcessor {
165
- additionalKeyPatterns;
166
- constructor(config = {}) {
167
- this.additionalKeyPatterns = config.additionalKeyPatterns ?? [];
168
- }
169
- onEmit(record, _context) {
170
- // Sanitize attributes in-place
171
- const attrs = record.attributes;
172
- for (const key of Object.keys(attrs)) {
173
- if (isSensitiveKey(key, this.additionalKeyPatterns)) {
174
- attrs[key] = REDACTED;
175
- }
176
- }
177
- // Redact email-like patterns in string body
178
- if (typeof record.body === "string") {
179
- EMAIL_PATTERN.lastIndex = 0;
180
- record.body = record.body.replace(EMAIL_PATTERN, REDACTED_EMAIL);
181
- }
182
- }
183
- async shutdown() { }
184
- async forceFlush() { }
185
- }
186
- // ============================================================================
187
- // Factory functions
188
- // ============================================================================
189
- /**
190
- * Create a SpanProcessor that redacts PII from span attributes before export.
191
- *
192
- * @param config - Optional configuration for additional key patterns / URL params
193
- * @returns A SpanProcessor suitable for use in a browser WebTracerProvider
194
- */
195
- export function createSanitizingSpanProcessor(config) {
196
- return new SanitizingSpanProcessor(config);
197
- }
198
- /**
199
- * Create a LogRecordProcessor that redacts PII from log records before export.
200
- *
201
- * @param config - Optional configuration for additional key patterns
202
- * @returns A LogRecordProcessor suitable for use in a browser log provider
203
- */
204
- export function createSanitizingLogProcessor(config) {
205
- return new BrowserSanitizingLogProcessor(config);
206
- }
207
- //# sourceMappingURL=sanitizer.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"sanitizer.js","sourceRoot":"","sources":["../../src/browser/sanitizer.ts"],"names":[],"mappings":"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"}
@@ -1,102 +0,0 @@
1
- /**
2
- * Browser-side TracedSocket for WebSocket tracing.
3
- *
4
- * Wraps a WebSocket client (or any WebSocket-like object) and adds
5
- * OpenTelemetry tracing. Designed to speak the same envelope protocol as the
6
- * server-side TracedSocket so that distributed traces link correctly across
7
- * the browser–server boundary.
8
- *
9
- * Envelope format (matches @superblocksteam/shared SocketRequest):
10
- * outbound: { request: { method, id, traceparent?, tracestate?, ... } }
11
- * inbound: { request: { method, id, traceparent?, tracestate?, ... } }
12
- * { response: { id, ... } }
13
- *
14
- * Propagation uses the W3C Trace Context propagator registered globally by
15
- * initBrowserTelemetry() (see browser/init.ts). The carrier is the
16
- * `request` object itself — the same convention as the server side.
17
- */
18
- import { type Tracer } from "@opentelemetry/api";
19
- import type { SocketMessageEnvelope } from "../common/traced-socket-types.js";
20
- /** Minimal browser WebSocket surface needed by BrowserTracedSocket. */
21
- export interface WebSocketLike {
22
- readonly readyState: number;
23
- close(code?: number, reason?: string): void;
24
- send(data: string | ArrayBuffer): void;
25
- addEventListener(type: string, listener: (event: unknown) => void): void;
26
- removeEventListener(type: string, listener: (event: unknown) => void): void;
27
- }
28
- /** Configuration for BrowserTracedSocket. */
29
- export interface BrowserTracedSocketConfig {
30
- /**
31
- * Tracer instance. When omitted the global tracer named
32
- * "superblocks-ws" is used (requires initBrowserTelemetry() first).
33
- */
34
- tracer?: Tracer;
35
- }
36
- /**
37
- * BrowserTracedSocket wraps a WebSocket and provides:
38
- *
39
- * 1. `decorateOutbound(msg)` — call this before sending any message.
40
- * Injects traceparent/tracestate into msg.request so the server can
41
- * extract the browser's active context.
42
- *
43
- * 2. `traceOutboundCall(method)` — wraps a client-initiated RPC call in a
44
- * CLIENT span. Returns the span's end function.
45
- *
46
- * 3. `handleInbound(msg)` — call this when a message arrives from the server.
47
- * Extracts the server's trace context and creates a SERVER span so that
48
- * server-initiated pushes appear in the browser's trace.
49
- *
50
- * 4. `recordReconnect({ attempt })` — call this from the reconnect loop to
51
- * create a ws.reconnect span.
52
- *
53
- * Lifecycle spans (ws.connect, ws.disconnect) are attached automatically via
54
- * WebSocket open/close event listeners.
55
- */
56
- export declare class BrowserTracedSocket {
57
- private readonly ws;
58
- private readonly tracer;
59
- private connectStartTime;
60
- constructor(ws: WebSocketLike, config: BrowserTracedSocketConfig);
61
- private readonly onOpen;
62
- private readonly onClose;
63
- /**
64
- * Records a ws.reconnect span. Call this from the reconnect loop just
65
- * before opening a new WebSocket, passing the attempt counter so it shows
66
- * up as a span attribute.
67
- */
68
- recordReconnect({ attempt }: {
69
- attempt: number;
70
- }): void;
71
- /**
72
- * Injects W3C trace context into the message's request envelope.
73
- * Call this on every outbound message before handing it to the transport.
74
- *
75
- * Mirrors the server-side TracedSocket.decorateToSend() behaviour so that
76
- * the server can extract the browser's active context via propagation.extract.
77
- */
78
- decorateOutbound(message: SocketMessageEnvelope): SocketMessageEnvelope;
79
- /**
80
- * Creates a CLIENT span for a browser-initiated RPC call.
81
- * Returns the span so the caller can end it after the response resolves.
82
- *
83
- * Usage:
84
- * ```typescript
85
- * const span = socket.traceOutboundCall("editor.runApi");
86
- * const result = await socket.request("editor.runApi", params);
87
- * span.end();
88
- * ```
89
- */
90
- traceOutboundCall(method: string): import("@opentelemetry/api").Span;
91
- /**
92
- * Handles an inbound message from the server.
93
- * - Extracts the server's trace context from the request envelope.
94
- * - Creates a SERVER span as a child of the server's trace so that
95
- * server-initiated pushes appear in the browser's distributed trace.
96
- * - Response-only messages (no request field) are ignored.
97
- */
98
- handleInbound(message: SocketMessageEnvelope): void;
99
- /** Remove lifecycle listeners. Call when tearing down the socket. */
100
- dispose(): void;
101
- }
102
- //# sourceMappingURL=traced-socket.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"traced-socket.d.ts","sourceRoot":"","sources":["../../src/browser/traced-socket.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAML,KAAK,MAAM,EACZ,MAAM,oBAAoB,CAAC;AAM5B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAE9E,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IACvC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IACzE,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;CAC7E;AAED,6CAA6C;AAC7C,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAOD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,mBAAmB;IAK5B,OAAO,CAAC,QAAQ,CAAC,EAAE;IAJrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,gBAAgB,CAAqB;gBAG1B,EAAE,EAAE,aAAa,EAClC,MAAM,EAAE,yBAAyB;IAoBnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAwBrB;IAEF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAuBtB;IAEF;;;;OAIG;IACI,eAAe,CAAC,EAAE,OAAO,EAAE,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAoB9D;;;;;;OAMG;IACI,gBAAgB,CACrB,OAAO,EAAE,qBAAqB,GAC7B,qBAAqB;IAexB;;;;;;;;;;OAUG;IACI,iBAAiB,CAAC,MAAM,EAAE,MAAM;IAkBvC;;;;;;OAMG;IACI,aAAa,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAgC1D,qEAAqE;IAC9D,OAAO,IAAI,IAAI;CAIvB"}