@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.
- package/LICENSE.txt +87 -0
- package/README.md +298 -0
- package/dist/browser/console-logging.d.ts +18 -0
- package/dist/browser/console-logging.d.ts.map +1 -0
- package/dist/browser/console-logging.js +32 -0
- package/dist/browser/console-logging.js.map +1 -0
- package/dist/browser/early-console-buffer.d.ts +49 -0
- package/dist/browser/early-console-buffer.d.ts.map +1 -0
- package/dist/browser/early-console-buffer.js +182 -0
- package/dist/browser/early-console-buffer.js.map +1 -0
- package/dist/browser/index.d.ts +17 -0
- package/dist/browser/index.d.ts.map +1 -0
- package/dist/browser/index.js +50 -0
- package/dist/browser/index.js.map +1 -0
- package/dist/browser/init.d.ts +101 -0
- package/dist/browser/init.d.ts.map +1 -0
- package/dist/browser/init.js +329 -0
- package/dist/browser/init.js.map +1 -0
- package/dist/browser/instrumentations.d.ts +67 -0
- package/dist/browser/instrumentations.d.ts.map +1 -0
- package/dist/browser/instrumentations.js +83 -0
- package/dist/browser/instrumentations.js.map +1 -0
- package/dist/browser/logs.d.ts +55 -0
- package/dist/browser/logs.d.ts.map +1 -0
- package/dist/browser/logs.js +86 -0
- package/dist/browser/logs.js.map +1 -0
- package/dist/browser/metrics.d.ts +29 -0
- package/dist/browser/metrics.d.ts.map +1 -0
- package/dist/browser/metrics.js +49 -0
- package/dist/browser/metrics.js.map +1 -0
- package/dist/browser/resilient-exporter.d.ts +43 -0
- package/dist/browser/resilient-exporter.d.ts.map +1 -0
- package/dist/browser/resilient-exporter.js +88 -0
- package/dist/browser/resilient-exporter.js.map +1 -0
- package/dist/browser/sanitizer.d.ts +35 -0
- package/dist/browser/sanitizer.d.ts.map +1 -0
- package/dist/browser/sanitizer.js +211 -0
- package/dist/browser/sanitizer.js.map +1 -0
- package/dist/browser/traced-socket.d.ts +102 -0
- package/dist/browser/traced-socket.d.ts.map +1 -0
- package/dist/browser/traced-socket.js +203 -0
- package/dist/browser/traced-socket.js.map +1 -0
- package/dist/common/contracts/tier2-traces.d.ts +116 -0
- package/dist/common/contracts/tier2-traces.d.ts.map +1 -0
- package/dist/common/contracts/tier2-traces.js +736 -0
- package/dist/common/contracts/tier2-traces.js.map +1 -0
- package/dist/common/deployment-type.d.ts +18 -0
- package/dist/common/deployment-type.d.ts.map +1 -0
- package/dist/common/deployment-type.js +30 -0
- package/dist/common/deployment-type.js.map +1 -0
- package/dist/common/guardrails.d.ts +116 -0
- package/dist/common/guardrails.d.ts.map +1 -0
- package/dist/common/guardrails.js +189 -0
- package/dist/common/guardrails.js.map +1 -0
- package/dist/common/index.d.ts +18 -0
- package/dist/common/index.d.ts.map +1 -0
- package/dist/common/index.js +34 -0
- package/dist/common/index.js.map +1 -0
- package/dist/common/log-sanitizer.d.ts +170 -0
- package/dist/common/log-sanitizer.d.ts.map +1 -0
- package/dist/common/log-sanitizer.js +690 -0
- package/dist/common/log-sanitizer.js.map +1 -0
- package/dist/common/normalize-metric-path.d.ts +2 -0
- package/dist/common/normalize-metric-path.d.ts.map +1 -0
- package/dist/common/normalize-metric-path.js +22 -0
- package/dist/common/normalize-metric-path.js.map +1 -0
- package/dist/common/policy-evaluator.d.ts +103 -0
- package/dist/common/policy-evaluator.d.ts.map +1 -0
- package/dist/common/policy-evaluator.js +200 -0
- package/dist/common/policy-evaluator.js.map +1 -0
- package/dist/common/resource.d.ts +79 -0
- package/dist/common/resource.d.ts.map +1 -0
- package/dist/common/resource.js +128 -0
- package/dist/common/resource.js.map +1 -0
- package/dist/common/tier-hints.d.ts +182 -0
- package/dist/common/tier-hints.d.ts.map +1 -0
- package/dist/common/tier-hints.js +209 -0
- package/dist/common/tier-hints.js.map +1 -0
- package/dist/common/trace-sanitizer.d.ts +82 -0
- package/dist/common/trace-sanitizer.d.ts.map +1 -0
- package/dist/common/trace-sanitizer.js +234 -0
- package/dist/common/trace-sanitizer.js.map +1 -0
- package/dist/common/traced-socket-types.d.ts +43 -0
- package/dist/common/traced-socket-types.d.ts.map +1 -0
- package/dist/common/traced-socket-types.js +17 -0
- package/dist/common/traced-socket-types.js.map +1 -0
- package/dist/index.d.ts +45 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +88 -0
- package/dist/index.js.map +1 -0
- package/dist/lint/forbidden-attributes.d.ts +149 -0
- package/dist/lint/forbidden-attributes.d.ts.map +1 -0
- package/dist/lint/forbidden-attributes.js +215 -0
- package/dist/lint/forbidden-attributes.js.map +1 -0
- package/dist/lint/index.d.ts +9 -0
- package/dist/lint/index.d.ts.map +1 -0
- package/dist/lint/index.js +16 -0
- package/dist/lint/index.js.map +1 -0
- package/dist/llmobs/index.d.ts +22 -0
- package/dist/llmobs/index.d.ts.map +1 -0
- package/dist/llmobs/index.js +29 -0
- package/dist/llmobs/index.js.map +1 -0
- package/dist/llmobs/tier1-exporter.d.ts +146 -0
- package/dist/llmobs/tier1-exporter.d.ts.map +1 -0
- package/dist/llmobs/tier1-exporter.js +199 -0
- package/dist/llmobs/tier1-exporter.js.map +1 -0
- package/dist/llmobs/tier2-summarizer.d.ts +268 -0
- package/dist/llmobs/tier2-summarizer.d.ts.map +1 -0
- package/dist/llmobs/tier2-summarizer.js +656 -0
- package/dist/llmobs/tier2-summarizer.js.map +1 -0
- package/dist/node/dynamic-attribute-processor.d.ts +43 -0
- package/dist/node/dynamic-attribute-processor.d.ts.map +1 -0
- package/dist/node/dynamic-attribute-processor.js +79 -0
- package/dist/node/dynamic-attribute-processor.js.map +1 -0
- package/dist/node/exporters/resilient-exporter.d.ts +91 -0
- package/dist/node/exporters/resilient-exporter.d.ts.map +1 -0
- package/dist/node/exporters/resilient-exporter.js +136 -0
- package/dist/node/exporters/resilient-exporter.js.map +1 -0
- package/dist/node/index.d.ts +13 -0
- package/dist/node/index.d.ts.map +1 -0
- package/dist/node/index.js +32 -0
- package/dist/node/index.js.map +1 -0
- package/dist/node/init.d.ts +97 -0
- package/dist/node/init.d.ts.map +1 -0
- package/dist/node/init.js +365 -0
- package/dist/node/init.js.map +1 -0
- package/dist/node/local-obs-mode.d.ts +17 -0
- package/dist/node/local-obs-mode.d.ts.map +1 -0
- package/dist/node/local-obs-mode.js +22 -0
- package/dist/node/local-obs-mode.js.map +1 -0
- package/dist/node/log-processor.d.ts +132 -0
- package/dist/node/log-processor.d.ts.map +1 -0
- package/dist/node/log-processor.js +397 -0
- package/dist/node/log-processor.js.map +1 -0
- package/dist/node/metrics-client.d.ts +88 -0
- package/dist/node/metrics-client.d.ts.map +1 -0
- package/dist/node/metrics-client.js +209 -0
- package/dist/node/metrics-client.js.map +1 -0
- package/dist/node/safe-logger.d.ts +55 -0
- package/dist/node/safe-logger.d.ts.map +1 -0
- package/dist/node/safe-logger.js +158 -0
- package/dist/node/safe-logger.js.map +1 -0
- package/dist/node/sanitizing-processor.d.ts +67 -0
- package/dist/node/sanitizing-processor.d.ts.map +1 -0
- package/dist/node/sanitizing-processor.js +167 -0
- package/dist/node/sanitizing-processor.js.map +1 -0
- package/dist/node/service-tracers.d.ts +52 -0
- package/dist/node/service-tracers.d.ts.map +1 -0
- package/dist/node/service-tracers.js +81 -0
- package/dist/node/service-tracers.js.map +1 -0
- package/dist/node/traced-socket.d.ts +120 -0
- package/dist/node/traced-socket.d.ts.map +1 -0
- package/dist/node/traced-socket.js +338 -0
- package/dist/node/traced-socket.js.map +1 -0
- package/dist/npm-registry/emitter.d.ts +310 -0
- package/dist/npm-registry/emitter.d.ts.map +1 -0
- package/dist/npm-registry/emitter.js +537 -0
- package/dist/npm-registry/emitter.js.map +1 -0
- package/dist/npm-registry/index.d.ts +12 -0
- package/dist/npm-registry/index.d.ts.map +1 -0
- package/dist/npm-registry/index.js +28 -0
- package/dist/npm-registry/index.js.map +1 -0
- package/dist/npm-registry/sanitize.d.ts +174 -0
- package/dist/npm-registry/sanitize.d.ts.map +1 -0
- package/dist/npm-registry/sanitize.js +342 -0
- package/dist/npm-registry/sanitize.js.map +1 -0
- package/dist/npm-registry/spans.d.ts +61 -0
- package/dist/npm-registry/spans.d.ts.map +1 -0
- package/dist/npm-registry/spans.js +91 -0
- package/dist/npm-registry/spans.js.map +1 -0
- package/dist/testing/in-memory-exporter.d.ts +179 -0
- package/dist/testing/in-memory-exporter.d.ts.map +1 -0
- package/dist/testing/in-memory-exporter.js +256 -0
- package/dist/testing/in-memory-exporter.js.map +1 -0
- package/dist/testing/index.d.ts +9 -0
- package/dist/testing/index.d.ts.map +1 -0
- package/dist/testing/index.js +21 -0
- package/dist/testing/index.js.map +1 -0
- package/dist/testing/metrics-capture.d.ts +29 -0
- package/dist/testing/metrics-capture.d.ts.map +1 -0
- package/dist/testing/metrics-capture.js +74 -0
- package/dist/testing/metrics-capture.js.map +1 -0
- package/dist/testing/test-init.d.ts +80 -0
- package/dist/testing/test-init.d.ts.map +1 -0
- package/dist/testing/test-init.js +144 -0
- package/dist/testing/test-init.js.map +1 -0
- package/dist/types/index.d.ts +84 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/types/index.js +23 -0
- package/dist/types/index.js.map +1 -0
- package/dist/types/policy.d.ts +92 -0
- package/dist/types/policy.d.ts.map +1 -0
- package/dist/types/policy.js +125 -0
- package/dist/types/policy.js.map +1 -0
- package/dist-esm/browser/console-logging.d.ts +18 -0
- package/dist-esm/browser/console-logging.d.ts.map +1 -0
- package/dist-esm/browser/console-logging.js +27 -0
- package/dist-esm/browser/console-logging.js.map +1 -0
- package/dist-esm/browser/early-console-buffer.d.ts +49 -0
- package/dist-esm/browser/early-console-buffer.d.ts.map +1 -0
- package/dist-esm/browser/early-console-buffer.js +180 -0
- package/dist-esm/browser/early-console-buffer.js.map +1 -0
- package/dist-esm/browser/index.d.ts +17 -0
- package/dist-esm/browser/index.d.ts.map +1 -0
- package/dist-esm/browser/index.js +22 -0
- package/dist-esm/browser/index.js.map +1 -0
- package/dist-esm/browser/init.d.ts +101 -0
- package/dist-esm/browser/init.d.ts.map +1 -0
- package/dist-esm/browser/init.js +319 -0
- package/dist-esm/browser/init.js.map +1 -0
- package/dist-esm/browser/instrumentations.d.ts +67 -0
- package/dist-esm/browser/instrumentations.d.ts.map +1 -0
- package/dist-esm/browser/instrumentations.js +79 -0
- package/dist-esm/browser/instrumentations.js.map +1 -0
- package/dist-esm/browser/logs.d.ts +55 -0
- package/dist-esm/browser/logs.d.ts.map +1 -0
- package/dist-esm/browser/logs.js +79 -0
- package/dist-esm/browser/logs.js.map +1 -0
- package/dist-esm/browser/metrics.d.ts +29 -0
- package/dist-esm/browser/metrics.d.ts.map +1 -0
- package/dist-esm/browser/metrics.js +46 -0
- package/dist-esm/browser/metrics.js.map +1 -0
- package/dist-esm/browser/resilient-exporter.d.ts +43 -0
- package/dist-esm/browser/resilient-exporter.d.ts.map +1 -0
- package/dist-esm/browser/resilient-exporter.js +84 -0
- package/dist-esm/browser/resilient-exporter.js.map +1 -0
- package/dist-esm/browser/sanitizer.d.ts +35 -0
- package/dist-esm/browser/sanitizer.d.ts.map +1 -0
- package/dist-esm/browser/sanitizer.js +207 -0
- package/dist-esm/browser/sanitizer.js.map +1 -0
- package/dist-esm/browser/traced-socket.d.ts +102 -0
- package/dist-esm/browser/traced-socket.d.ts.map +1 -0
- package/dist-esm/browser/traced-socket.js +199 -0
- package/dist-esm/browser/traced-socket.js.map +1 -0
- package/dist-esm/common/contracts/tier2-traces.d.ts +116 -0
- package/dist-esm/common/contracts/tier2-traces.d.ts.map +1 -0
- package/dist-esm/common/contracts/tier2-traces.js +725 -0
- package/dist-esm/common/contracts/tier2-traces.js.map +1 -0
- package/dist-esm/common/deployment-type.d.ts +18 -0
- package/dist-esm/common/deployment-type.d.ts.map +1 -0
- package/dist-esm/common/deployment-type.js +27 -0
- package/dist-esm/common/deployment-type.js.map +1 -0
- package/dist-esm/common/guardrails.d.ts +116 -0
- package/dist-esm/common/guardrails.d.ts.map +1 -0
- package/dist-esm/common/guardrails.js +179 -0
- package/dist-esm/common/guardrails.js.map +1 -0
- package/dist-esm/common/index.d.ts +18 -0
- package/dist-esm/common/index.d.ts.map +1 -0
- package/dist-esm/common/index.js +18 -0
- package/dist-esm/common/index.js.map +1 -0
- package/dist-esm/common/log-sanitizer.d.ts +170 -0
- package/dist-esm/common/log-sanitizer.d.ts.map +1 -0
- package/dist-esm/common/log-sanitizer.js +672 -0
- package/dist-esm/common/log-sanitizer.js.map +1 -0
- package/dist-esm/common/normalize-metric-path.d.ts +2 -0
- package/dist-esm/common/normalize-metric-path.d.ts.map +1 -0
- package/dist-esm/common/normalize-metric-path.js +19 -0
- package/dist-esm/common/normalize-metric-path.js.map +1 -0
- package/dist-esm/common/policy-evaluator.d.ts +103 -0
- package/dist-esm/common/policy-evaluator.d.ts.map +1 -0
- package/dist-esm/common/policy-evaluator.js +196 -0
- package/dist-esm/common/policy-evaluator.js.map +1 -0
- package/dist-esm/common/resource.d.ts +79 -0
- package/dist-esm/common/resource.d.ts.map +1 -0
- package/dist-esm/common/resource.js +121 -0
- package/dist-esm/common/resource.js.map +1 -0
- package/dist-esm/common/tier-hints.d.ts +182 -0
- package/dist-esm/common/tier-hints.d.ts.map +1 -0
- package/dist-esm/common/tier-hints.js +199 -0
- package/dist-esm/common/tier-hints.js.map +1 -0
- package/dist-esm/common/trace-sanitizer.d.ts +82 -0
- package/dist-esm/common/trace-sanitizer.d.ts.map +1 -0
- package/dist-esm/common/trace-sanitizer.js +230 -0
- package/dist-esm/common/trace-sanitizer.js.map +1 -0
- package/dist-esm/common/traced-socket-types.d.ts +43 -0
- package/dist-esm/common/traced-socket-types.d.ts.map +1 -0
- package/dist-esm/common/traced-socket-types.js +16 -0
- package/dist-esm/common/traced-socket-types.js.map +1 -0
- package/dist-esm/index.d.ts +45 -0
- package/dist-esm/index.d.ts.map +1 -0
- package/dist-esm/index.js +56 -0
- package/dist-esm/index.js.map +1 -0
- package/dist-esm/lint/forbidden-attributes.d.ts +149 -0
- package/dist-esm/lint/forbidden-attributes.d.ts.map +1 -0
- package/dist-esm/lint/forbidden-attributes.js +210 -0
- package/dist-esm/lint/forbidden-attributes.js.map +1 -0
- package/dist-esm/lint/index.d.ts +9 -0
- package/dist-esm/lint/index.d.ts.map +1 -0
- package/dist-esm/lint/index.js +9 -0
- package/dist-esm/lint/index.js.map +1 -0
- package/dist-esm/llmobs/index.d.ts +22 -0
- package/dist-esm/llmobs/index.d.ts.map +1 -0
- package/dist-esm/llmobs/index.js +22 -0
- package/dist-esm/llmobs/index.js.map +1 -0
- package/dist-esm/llmobs/tier1-exporter.d.ts +146 -0
- package/dist-esm/llmobs/tier1-exporter.d.ts.map +1 -0
- package/dist-esm/llmobs/tier1-exporter.js +193 -0
- package/dist-esm/llmobs/tier1-exporter.js.map +1 -0
- package/dist-esm/llmobs/tier2-summarizer.d.ts +268 -0
- package/dist-esm/llmobs/tier2-summarizer.d.ts.map +1 -0
- package/dist-esm/llmobs/tier2-summarizer.js +652 -0
- package/dist-esm/llmobs/tier2-summarizer.js.map +1 -0
- package/dist-esm/node/dynamic-attribute-processor.d.ts +43 -0
- package/dist-esm/node/dynamic-attribute-processor.d.ts.map +1 -0
- package/dist-esm/node/dynamic-attribute-processor.js +74 -0
- package/dist-esm/node/dynamic-attribute-processor.js.map +1 -0
- package/dist-esm/node/exporters/resilient-exporter.d.ts +91 -0
- package/dist-esm/node/exporters/resilient-exporter.d.ts.map +1 -0
- package/dist-esm/node/exporters/resilient-exporter.js +132 -0
- package/dist-esm/node/exporters/resilient-exporter.js.map +1 -0
- package/dist-esm/node/index.d.ts +13 -0
- package/dist-esm/node/index.d.ts.map +1 -0
- package/dist-esm/node/index.js +13 -0
- package/dist-esm/node/index.js.map +1 -0
- package/dist-esm/node/init.d.ts +97 -0
- package/dist-esm/node/init.d.ts.map +1 -0
- package/dist-esm/node/init.js +359 -0
- package/dist-esm/node/init.js.map +1 -0
- package/dist-esm/node/local-obs-mode.d.ts +17 -0
- package/dist-esm/node/local-obs-mode.d.ts.map +1 -0
- package/dist-esm/node/local-obs-mode.js +19 -0
- package/dist-esm/node/local-obs-mode.js.map +1 -0
- package/dist-esm/node/log-processor.d.ts +132 -0
- package/dist-esm/node/log-processor.d.ts.map +1 -0
- package/dist-esm/node/log-processor.js +389 -0
- package/dist-esm/node/log-processor.js.map +1 -0
- package/dist-esm/node/metrics-client.d.ts +88 -0
- package/dist-esm/node/metrics-client.d.ts.map +1 -0
- package/dist-esm/node/metrics-client.js +205 -0
- package/dist-esm/node/metrics-client.js.map +1 -0
- package/dist-esm/node/safe-logger.d.ts +55 -0
- package/dist-esm/node/safe-logger.d.ts.map +1 -0
- package/dist-esm/node/safe-logger.js +154 -0
- package/dist-esm/node/safe-logger.js.map +1 -0
- package/dist-esm/node/sanitizing-processor.d.ts +67 -0
- package/dist-esm/node/sanitizing-processor.d.ts.map +1 -0
- package/dist-esm/node/sanitizing-processor.js +163 -0
- package/dist-esm/node/sanitizing-processor.js.map +1 -0
- package/dist-esm/node/service-tracers.d.ts +52 -0
- package/dist-esm/node/service-tracers.d.ts.map +1 -0
- package/dist-esm/node/service-tracers.js +78 -0
- package/dist-esm/node/service-tracers.js.map +1 -0
- package/dist-esm/node/traced-socket.d.ts +120 -0
- package/dist-esm/node/traced-socket.d.ts.map +1 -0
- package/dist-esm/node/traced-socket.js +334 -0
- package/dist-esm/node/traced-socket.js.map +1 -0
- package/dist-esm/npm-registry/emitter.d.ts +310 -0
- package/dist-esm/npm-registry/emitter.d.ts.map +1 -0
- package/dist-esm/npm-registry/emitter.js +525 -0
- package/dist-esm/npm-registry/emitter.js.map +1 -0
- package/dist-esm/npm-registry/index.d.ts +12 -0
- package/dist-esm/npm-registry/index.d.ts.map +1 -0
- package/dist-esm/npm-registry/index.js +12 -0
- package/dist-esm/npm-registry/index.js.map +1 -0
- package/dist-esm/npm-registry/sanitize.d.ts +174 -0
- package/dist-esm/npm-registry/sanitize.d.ts.map +1 -0
- package/dist-esm/npm-registry/sanitize.js +331 -0
- package/dist-esm/npm-registry/sanitize.js.map +1 -0
- package/dist-esm/npm-registry/spans.d.ts +61 -0
- package/dist-esm/npm-registry/spans.d.ts.map +1 -0
- package/dist-esm/npm-registry/spans.js +86 -0
- package/dist-esm/npm-registry/spans.js.map +1 -0
- package/dist-esm/package.json +1 -0
- package/dist-esm/testing/in-memory-exporter.d.ts +179 -0
- package/dist-esm/testing/in-memory-exporter.d.ts.map +1 -0
- package/dist-esm/testing/in-memory-exporter.js +250 -0
- package/dist-esm/testing/in-memory-exporter.js.map +1 -0
- package/dist-esm/testing/index.d.ts +9 -0
- package/dist-esm/testing/index.d.ts.map +1 -0
- package/dist-esm/testing/index.js +9 -0
- package/dist-esm/testing/index.js.map +1 -0
- package/dist-esm/testing/metrics-capture.d.ts +29 -0
- package/dist-esm/testing/metrics-capture.d.ts.map +1 -0
- package/dist-esm/testing/metrics-capture.js +71 -0
- package/dist-esm/testing/metrics-capture.js.map +1 -0
- package/dist-esm/testing/test-init.d.ts +80 -0
- package/dist-esm/testing/test-init.d.ts.map +1 -0
- package/dist-esm/testing/test-init.js +137 -0
- package/dist-esm/testing/test-init.js.map +1 -0
- package/dist-esm/types/index.d.ts +84 -0
- package/dist-esm/types/index.d.ts.map +1 -0
- package/dist-esm/types/index.js +7 -0
- package/dist-esm/types/index.js.map +1 -0
- package/dist-esm/types/policy.d.ts +92 -0
- package/dist-esm/types/policy.d.ts.map +1 -0
- package/dist-esm/types/policy.js +122 -0
- package/dist-esm/types/policy.js.map +1 -0
- package/package.json +102 -0
|
@@ -0,0 +1,203 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* Browser-side TracedSocket for WebSocket tracing.
|
|
4
|
+
*
|
|
5
|
+
* Wraps a WebSocket client (or any WebSocket-like object) and adds
|
|
6
|
+
* OpenTelemetry tracing. Designed to speak the same envelope protocol as the
|
|
7
|
+
* server-side TracedSocket so that distributed traces link correctly across
|
|
8
|
+
* the browser–server boundary.
|
|
9
|
+
*
|
|
10
|
+
* Envelope format (matches @superblocksteam/shared SocketRequest):
|
|
11
|
+
* outbound: { request: { method, id, traceparent?, tracestate?, ... } }
|
|
12
|
+
* inbound: { request: { method, id, traceparent?, tracestate?, ... } }
|
|
13
|
+
* { response: { id, ... } }
|
|
14
|
+
*
|
|
15
|
+
* Propagation uses the W3C Trace Context propagator registered globally by
|
|
16
|
+
* initBrowserTelemetry() (see browser/init.ts). The carrier is the
|
|
17
|
+
* `request` object itself — the same convention as the server side.
|
|
18
|
+
*/
|
|
19
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
20
|
+
exports.BrowserTracedSocket = void 0;
|
|
21
|
+
const api_1 = require("@opentelemetry/api");
|
|
22
|
+
const semantic_conventions_1 = require("@opentelemetry/semantic-conventions");
|
|
23
|
+
const MESSAGING_ATTRS = {
|
|
24
|
+
[semantic_conventions_1.SEMATTRS_MESSAGING_SYSTEM]: "ws",
|
|
25
|
+
[semantic_conventions_1.SEMATTRS_MESSAGING_DESTINATION_KIND]: "websocket",
|
|
26
|
+
};
|
|
27
|
+
/**
|
|
28
|
+
* BrowserTracedSocket wraps a WebSocket and provides:
|
|
29
|
+
*
|
|
30
|
+
* 1. `decorateOutbound(msg)` — call this before sending any message.
|
|
31
|
+
* Injects traceparent/tracestate into msg.request so the server can
|
|
32
|
+
* extract the browser's active context.
|
|
33
|
+
*
|
|
34
|
+
* 2. `traceOutboundCall(method)` — wraps a client-initiated RPC call in a
|
|
35
|
+
* CLIENT span. Returns the span's end function.
|
|
36
|
+
*
|
|
37
|
+
* 3. `handleInbound(msg)` — call this when a message arrives from the server.
|
|
38
|
+
* Extracts the server's trace context and creates a SERVER span so that
|
|
39
|
+
* server-initiated pushes appear in the browser's trace.
|
|
40
|
+
*
|
|
41
|
+
* 4. `recordReconnect({ attempt })` — call this from the reconnect loop to
|
|
42
|
+
* create a ws.reconnect span.
|
|
43
|
+
*
|
|
44
|
+
* Lifecycle spans (ws.connect, ws.disconnect) are attached automatically via
|
|
45
|
+
* WebSocket open/close event listeners.
|
|
46
|
+
*/
|
|
47
|
+
class BrowserTracedSocket {
|
|
48
|
+
ws;
|
|
49
|
+
tracer;
|
|
50
|
+
connectStartTime;
|
|
51
|
+
constructor(ws, config) {
|
|
52
|
+
this.ws = ws;
|
|
53
|
+
this.tracer = config.tracer ?? api_1.trace.getTracer("superblocks-ws", "0.0.0");
|
|
54
|
+
this.connectStartTime = performance.now();
|
|
55
|
+
this.ws.addEventListener("open", this.onOpen);
|
|
56
|
+
this.ws.addEventListener("close", this.onClose);
|
|
57
|
+
// If the WebSocket is already open (e.g. constructed after connectWebSocket
|
|
58
|
+
// resolves), the "open" event won't fire again. Fire onOpen immediately so
|
|
59
|
+
// the ws.connect lifecycle span is still recorded.
|
|
60
|
+
if (this.ws.readyState === 1 /* WebSocket.OPEN */) {
|
|
61
|
+
this.onOpen(undefined);
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
// ------------------------------------------------------------------
|
|
65
|
+
// Lifecycle handlers
|
|
66
|
+
// ------------------------------------------------------------------
|
|
67
|
+
onOpen = (_event) => {
|
|
68
|
+
try {
|
|
69
|
+
const durationMs = this.connectStartTime
|
|
70
|
+
? performance.now() - this.connectStartTime
|
|
71
|
+
: undefined;
|
|
72
|
+
this.tracer.startActiveSpan("ws.connect", {
|
|
73
|
+
kind: api_1.SpanKind.CLIENT,
|
|
74
|
+
attributes: {
|
|
75
|
+
...MESSAGING_ATTRS,
|
|
76
|
+
...(durationMs !== undefined
|
|
77
|
+
? { "ws.connect_duration_ms": durationMs }
|
|
78
|
+
: {}),
|
|
79
|
+
},
|
|
80
|
+
}, (span) => {
|
|
81
|
+
span.end();
|
|
82
|
+
});
|
|
83
|
+
}
|
|
84
|
+
catch (err) {
|
|
85
|
+
console.error("[TracedSocket] onOpen tracing error", err);
|
|
86
|
+
}
|
|
87
|
+
};
|
|
88
|
+
onClose = (event) => {
|
|
89
|
+
try {
|
|
90
|
+
const ev = event;
|
|
91
|
+
const code = ev.code ?? 1000;
|
|
92
|
+
const reason = ev.reason ?? "";
|
|
93
|
+
this.tracer.startActiveSpan("ws.disconnect", {
|
|
94
|
+
kind: api_1.SpanKind.CLIENT,
|
|
95
|
+
attributes: {
|
|
96
|
+
...MESSAGING_ATTRS,
|
|
97
|
+
"ws.close_code": code,
|
|
98
|
+
"ws.close_reason": reason,
|
|
99
|
+
},
|
|
100
|
+
}, (span) => {
|
|
101
|
+
span.end();
|
|
102
|
+
});
|
|
103
|
+
}
|
|
104
|
+
catch (err) {
|
|
105
|
+
console.error("[TracedSocket] onClose tracing error", err);
|
|
106
|
+
}
|
|
107
|
+
};
|
|
108
|
+
/**
|
|
109
|
+
* Records a ws.reconnect span. Call this from the reconnect loop just
|
|
110
|
+
* before opening a new WebSocket, passing the attempt counter so it shows
|
|
111
|
+
* up as a span attribute.
|
|
112
|
+
*/
|
|
113
|
+
recordReconnect({ attempt }) {
|
|
114
|
+
this.tracer.startActiveSpan("ws.reconnect", {
|
|
115
|
+
kind: api_1.SpanKind.CLIENT,
|
|
116
|
+
attributes: {
|
|
117
|
+
...MESSAGING_ATTRS,
|
|
118
|
+
"ws.reconnect_attempt": attempt,
|
|
119
|
+
},
|
|
120
|
+
}, (span) => {
|
|
121
|
+
span.end();
|
|
122
|
+
});
|
|
123
|
+
}
|
|
124
|
+
// ------------------------------------------------------------------
|
|
125
|
+
// Outbound
|
|
126
|
+
// ------------------------------------------------------------------
|
|
127
|
+
/**
|
|
128
|
+
* Injects W3C trace context into the message's request envelope.
|
|
129
|
+
* Call this on every outbound message before handing it to the transport.
|
|
130
|
+
*
|
|
131
|
+
* Mirrors the server-side TracedSocket.decorateToSend() behaviour so that
|
|
132
|
+
* the server can extract the browser's active context via propagation.extract.
|
|
133
|
+
*/
|
|
134
|
+
decorateOutbound(message) {
|
|
135
|
+
if (!message.request) {
|
|
136
|
+
return message;
|
|
137
|
+
}
|
|
138
|
+
// Skip if already injected (e.g. manual traceparent for testing)
|
|
139
|
+
if (message.request.traceparent || message.request.tracestate) {
|
|
140
|
+
return message;
|
|
141
|
+
}
|
|
142
|
+
api_1.propagation.inject(api_1.context.active(), message.request);
|
|
143
|
+
return message;
|
|
144
|
+
}
|
|
145
|
+
/**
|
|
146
|
+
* Creates a CLIENT span for a browser-initiated RPC call.
|
|
147
|
+
* Returns the span so the caller can end it after the response resolves.
|
|
148
|
+
*
|
|
149
|
+
* Usage:
|
|
150
|
+
* ```typescript
|
|
151
|
+
* const span = socket.traceOutboundCall("editor.runApi");
|
|
152
|
+
* const result = await socket.request("editor.runApi", params);
|
|
153
|
+
* span.end();
|
|
154
|
+
* ```
|
|
155
|
+
*/
|
|
156
|
+
traceOutboundCall(method) {
|
|
157
|
+
return this.tracer.startActiveSpan(`WS CLIENT ${method}`, {
|
|
158
|
+
kind: api_1.SpanKind.CLIENT,
|
|
159
|
+
attributes: {
|
|
160
|
+
...MESSAGING_ATTRS,
|
|
161
|
+
"ws.method": method,
|
|
162
|
+
},
|
|
163
|
+
}, (span) => span);
|
|
164
|
+
}
|
|
165
|
+
// ------------------------------------------------------------------
|
|
166
|
+
// Inbound
|
|
167
|
+
// ------------------------------------------------------------------
|
|
168
|
+
/**
|
|
169
|
+
* Handles an inbound message from the server.
|
|
170
|
+
* - Extracts the server's trace context from the request envelope.
|
|
171
|
+
* - Creates a SERVER span as a child of the server's trace so that
|
|
172
|
+
* server-initiated pushes appear in the browser's distributed trace.
|
|
173
|
+
* - Response-only messages (no request field) are ignored.
|
|
174
|
+
*/
|
|
175
|
+
handleInbound(message) {
|
|
176
|
+
if (!message.request) {
|
|
177
|
+
return;
|
|
178
|
+
}
|
|
179
|
+
const method = message.request.method ?? "unknown";
|
|
180
|
+
const parentCtx = api_1.propagation.extract(api_1.ROOT_CONTEXT, message.request);
|
|
181
|
+
api_1.context.with(parentCtx, () => {
|
|
182
|
+
this.tracer.startActiveSpan(`WS SERVER ${method}`, {
|
|
183
|
+
kind: api_1.SpanKind.CONSUMER,
|
|
184
|
+
attributes: {
|
|
185
|
+
...MESSAGING_ATTRS,
|
|
186
|
+
"ws.method": method,
|
|
187
|
+
},
|
|
188
|
+
}, (span) => {
|
|
189
|
+
span.end();
|
|
190
|
+
});
|
|
191
|
+
});
|
|
192
|
+
}
|
|
193
|
+
// ------------------------------------------------------------------
|
|
194
|
+
// Cleanup
|
|
195
|
+
// ------------------------------------------------------------------
|
|
196
|
+
/** Remove lifecycle listeners. Call when tearing down the socket. */
|
|
197
|
+
dispose() {
|
|
198
|
+
this.ws.removeEventListener("open", this.onOpen);
|
|
199
|
+
this.ws.removeEventListener("close", this.onClose);
|
|
200
|
+
}
|
|
201
|
+
}
|
|
202
|
+
exports.BrowserTracedSocket = BrowserTracedSocket;
|
|
203
|
+
//# sourceMappingURL=traced-socket.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"traced-socket.js","sourceRoot":"","sources":["../../src/browser/traced-socket.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Tier 2 Traces Contract (v0.6.0) — TypeScript mirror.
|
|
3
|
+
*
|
|
4
|
+
* THIS FILE IS A MIRROR, NOT THE SOURCE OF TRUTH. The canonical Tier 2 traces
|
|
5
|
+
* contract lives in the `engineering` repo:
|
|
6
|
+
* - engineering/projects/o11y-refactor/contracts/tier2-traces.v0.6.0.json (canonical contract)
|
|
7
|
+
* - engineering/projects/o11y-refactor/contracts/README.md (rationale, Versioning Policy, Review Checklist)
|
|
8
|
+
* Org-wide telemetry naming and the Tier 2 privacy boundary are documented in the
|
|
9
|
+
* `workspace` repo: workspace/docs/naming-conventions.md and the `observability`
|
|
10
|
+
* skill (.agents/skills/observability/SKILL.md).
|
|
11
|
+
*
|
|
12
|
+
* CHANGING TIER 2 BEHAVIOR (forbidden / hashed / dropped / allowed attributes):
|
|
13
|
+
* 1. Update the canonical JSON in `engineering` FIRST, as a NEW version, per the
|
|
14
|
+
* README Versioning Policy (breaking = MAJOR, additive = MINOR, docs = PATCH).
|
|
15
|
+
* 2. Propagate the SAME change to every mirror so they stay byte-for-byte aligned:
|
|
16
|
+
* - this file (TS SDK sanitizer / ESLint / guardrails)
|
|
17
|
+
* - orchestrator/pkg/telemetry/forbidden_attributes.go (Go SDK maps)
|
|
18
|
+
* - orchestrator/pkg/telemetry/contracts/tier2-traces.json (Go embedded; regenerate via
|
|
19
|
+
* orchestrator/scripts/sync-ts-telemetry-contracts.sh — do not hand-edit)
|
|
20
|
+
* Editing this file alone silently drifts from the contract and the other SDKs, which
|
|
21
|
+
* lets a re-cased or newly added attribute bypass the Tier 2 privacy boundary. Cross-surface
|
|
22
|
+
* parity is enforced by the orchestrator Go tests (TestForbiddenAttributesMatchTSContract,
|
|
23
|
+
* TestDroppedAttributesMatchTS).
|
|
24
|
+
*
|
|
25
|
+
* Used by: trace-sanitizer (which spans/attributes to export), lint/forbidden-attributes
|
|
26
|
+
* (ESLint), guardrails (dev-time warnings), and Collector config generation.
|
|
27
|
+
* "request handler *" is a local extension for Express instrumentation (not in the JSON).
|
|
28
|
+
*/
|
|
29
|
+
import { DeploymentTypeEnum } from "@superblocksteam/shared";
|
|
30
|
+
export interface AttributeDefinition {
|
|
31
|
+
name: string;
|
|
32
|
+
allowedValues?: string[];
|
|
33
|
+
maxCardinality?: number;
|
|
34
|
+
type?: "string" | "number" | "boolean";
|
|
35
|
+
}
|
|
36
|
+
export type AllowedAttribute = string | AttributeDefinition;
|
|
37
|
+
export interface SpanDefinition {
|
|
38
|
+
name: string;
|
|
39
|
+
description?: string;
|
|
40
|
+
allowedAttributes: AllowedAttribute[];
|
|
41
|
+
alwaysSample?: boolean;
|
|
42
|
+
}
|
|
43
|
+
export declare function getAttributeName(attr: AllowedAttribute): string;
|
|
44
|
+
/**
|
|
45
|
+
* Span patterns from tier2-traces.v0.4.0.json.
|
|
46
|
+
* Suffix wildcard only: "HTTP POST *" matches "HTTP POST /api/..." or "POST /api/...".
|
|
47
|
+
*/
|
|
48
|
+
export declare const TIER_2_TRACE_CONTRACT: SpanDefinition[];
|
|
49
|
+
/**
|
|
50
|
+
* Cloud trace contract: match-all span name ("*") so no spans are dropped by name.
|
|
51
|
+
* Attribute allowlist is not used when attributeAllowlistPassthrough is true.
|
|
52
|
+
*/
|
|
53
|
+
export declare const CLOUD_TRACE_CONTRACT: SpanDefinition[];
|
|
54
|
+
/**
|
|
55
|
+
* Returns the trace contract (span definitions) for the given deployment type.
|
|
56
|
+
* Cloud: match-all so no traces are dropped by span name.
|
|
57
|
+
* Cloud-prem: Tier 2 contract (named spans only).
|
|
58
|
+
*/
|
|
59
|
+
export declare function getTraceContract(deploymentType: DeploymentTypeEnum): SpanDefinition[];
|
|
60
|
+
/** Forbidden in Tier 2 (forbiddenAttributes in contract). Collector strips these entirely. */
|
|
61
|
+
export declare const FORBIDDEN_TIER_2_SPAN_ATTRIBUTES: string[];
|
|
62
|
+
/**
|
|
63
|
+
* Hashed (keyed HMAC) for Tier 2 (hashedAttributes in contract).
|
|
64
|
+
* v0.5.0 (AGENT-3255): per-user / per-session identifiers single out a natural
|
|
65
|
+
* person (pseudonymous personal data even as a UUID), so pseudonymize rather than
|
|
66
|
+
* forbid. This is the full contract hashedAttributes set: enduser.id, session.id,
|
|
67
|
+
* and the user-id variants. organization-id is intentionally NOT hashed (single
|
|
68
|
+
* customer org per cloud-prem deployment → pass-through).
|
|
69
|
+
* NOTE: with no hashConfig, TraceSanitizer.hashValue() emits "[redacted]", so
|
|
70
|
+
* these fail closed and never flow raw until an HMAC key is provisioned.
|
|
71
|
+
*/
|
|
72
|
+
export declare const HASHED_TIER_2_SPAN_ATTRIBUTES: string[];
|
|
73
|
+
/**
|
|
74
|
+
* Dropped — high cardinality, no hash value (droppedAttributes in contract).
|
|
75
|
+
* The contract's dropped set also lists correlation/request/trace/execution ids,
|
|
76
|
+
* but those are dropped at the collector (and pass through at the SDK in
|
|
77
|
+
* pass-through mode); the SDK only hard-drops binding keys. v0.6.0 adds the
|
|
78
|
+
* dotted/kebab spellings of binding_keys for casing parity.
|
|
79
|
+
*/
|
|
80
|
+
export declare const DROPPED_HIGH_CARDINALITY_ATTRIBUTES: string[];
|
|
81
|
+
export declare const TIER2_FORBIDDEN_ATTRIBUTES: Set<string>;
|
|
82
|
+
export declare const TIER2_HASHED_ATTRIBUTES: Set<string>;
|
|
83
|
+
export declare const TIER2_DROPPED_ATTRIBUTES: Set<string>;
|
|
84
|
+
/**
|
|
85
|
+
* Attribute sets and contract options used by TraceSanitizer.
|
|
86
|
+
* Allows different rules per deployment type (e.g. cloud vs cloud-prem).
|
|
87
|
+
*/
|
|
88
|
+
export interface TraceSanitizerAttributeSets {
|
|
89
|
+
forbiddenAttributes: Set<string>;
|
|
90
|
+
droppedAttributes: Set<string>;
|
|
91
|
+
hashedAttributes: Set<string>;
|
|
92
|
+
/** Span definitions for name matching; cloud uses match-all ("*"). */
|
|
93
|
+
spanDefinitions: SpanDefinition[];
|
|
94
|
+
/** When true, span attributes are not filtered by allowedAttributes (pass-through). */
|
|
95
|
+
attributeAllowlistPassthrough: boolean;
|
|
96
|
+
}
|
|
97
|
+
/**
|
|
98
|
+
* Returns the Tier 2 trace attribute sets and contract options for the given deployment type.
|
|
99
|
+
* Cloud: relaxed policy (no attributes dropped/hashed), match-all span names, pass-through attributes.
|
|
100
|
+
* Cloud-prem: full Tier 2 contract (forbidden/dropped/hashed), named spans only, allowlist enforced.
|
|
101
|
+
*/
|
|
102
|
+
export declare function getTraceSanitizerAttributeSets(deploymentType: DeploymentTypeEnum): TraceSanitizerAttributeSets;
|
|
103
|
+
/** Spans that should ALWAYS be sampled (samplingPolicy.alwaysSampleSpans in contract). */
|
|
104
|
+
export declare const ALWAYS_SAMPLE_SPANS: Set<string>;
|
|
105
|
+
/**
|
|
106
|
+
* Patterns that indicate forbidden content in attribute values (e.g. secrets in strings).
|
|
107
|
+
* No ^/$ anchors so they match secrets embedded anywhere.
|
|
108
|
+
* It's not used by TraceSanitizer, only in guardrails.
|
|
109
|
+
*/
|
|
110
|
+
export declare const FORBIDDEN_VALUE_PATTERNS: RegExp[];
|
|
111
|
+
export declare function isForbiddenAttribute(name: string): boolean;
|
|
112
|
+
export declare function isHashedAttribute(name: string): boolean;
|
|
113
|
+
export declare function isDroppedAttribute(name: string): boolean;
|
|
114
|
+
export declare function containsForbiddenPattern(value: unknown): boolean;
|
|
115
|
+
export declare function shouldAlwaysSample(spanName: string): boolean;
|
|
116
|
+
//# sourceMappingURL=tier2-traces.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tier2-traces.d.ts","sourceRoot":"","sources":["../../../src/common/contracts/tier2-traces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAM7D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,mBAAmB,CAAC;AAE5D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IACtC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAE/D;AA0KD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,cAAc,EA+TjD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,cAAc,EAEhD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,cAAc,EAAE,kBAAkB,GACjC,cAAc,EAAE,CAQlB;AAMD,8FAA8F;AAC9F,eAAO,MAAM,gCAAgC,EAAE,MAAM,EAiEpD,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,6BAA6B,EAAE,MAAM,EAUjD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mCAAmC,EAAE,MAAM,EAIvD,CAAC;AAMF,eAAO,MAAM,0BAA0B,aAEtC,CAAC;AACF,eAAO,MAAM,uBAAuB,aAAyC,CAAC;AAC9E,eAAO,MAAM,wBAAwB,aAEpC,CAAC;AASF;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,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,sEAAsE;IACtE,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,uFAAuF;IACvF,6BAA6B,EAAE,OAAO,CAAC;CACxC;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,cAAc,EAAE,kBAAkB,GACjC,2BAA2B,CAwB7B;AAMD,0FAA0F;AAC1F,eAAO,MAAM,mBAAmB,aAA2B,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,UAYpC,CAAC;AAMF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGhE;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE5D"}
|