@powerhousedao/switchboard 6.0.0-dev.236 → 6.0.0-dev.238

package/CHANGELOG.md

@@ -1,3 +1,23 @@
+## 6.0.0-dev.238 (2026-05-11)
+
+### 🚀 Features
+
+- **switchboard:** bridge OpenTelemetry spans to Sentry ([c1f2fc28b](https://github.com/powerhouse-inc/powerhouse/commit/c1f2fc28b))
+- **ph-cli,ph-cmd,shared:** use lightweight sentry sdk ([248c6b2f6](https://github.com/powerhouse-inc/powerhouse/commit/248c6b2f6))
+
+### 🩹 Fixes
+
+- update dockerfiles for pnpm 11 bin path ([d33db03ce](https://github.com/powerhouse-inc/powerhouse/commit/d33db03ce))
+- **switchboard:** only enable tracing if a destination is configured ([8abff8020](https://github.com/powerhouse-inc/powerhouse/commit/8abff8020))
+
+### ❤️ Thank You
+
+- acaldas
+
+## 6.0.0-dev.237 (2026-05-10)
+
+This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
+
 ## 6.0.0-dev.236 (2026-05-09)
 
 ### 🚀 Features

package/README.md

@@ -13,6 +13,7 @@ A powerful document-driven server that provides a unified API for managing and s
 - **HTTPS Support**: Built-in HTTPS server with custom certificates
 - **Profiling**: Integration with Pyroscope for performance monitoring
 - **Error Tracking**: Sentry integration for error monitoring and reporting
+- **Observability**: Unified OpenTelemetry tracing + metrics bootstrap, with optional Sentry APM bridging (same trace IDs in Tempo and Sentry)
 
 ## 📦 Installation
 
@@ -106,11 +107,11 @@ pnpm add -g @powerhousedao/switchboard
 | `PH_REACTOR_DATABASE_URL`   | PostgreSQL URL (takes precedence)  | -                     |
 | `REDIS_URL`                 | Redis connection URL               | -                     |
 | `REDIS_TLS_URL`             | Redis TLS connection URL           | -                     |
-| `SENTRY_DSN`                | Sentry DSN for error tracking      | -                     |
-| `SENTRY_ENV`                | Sentry environment                 | -                     |
 | `PYROSCOPE_SERVER_ADDRESS`  | Pyroscope server address           | -                     |
 | `FEATURE_REACTORV2_ENABLED` | Enable Reactor v2 subgraph feature | `false`               |
 
+See [Observability](#observability) below for Sentry and OpenTelemetry variables.
+
 ### Authentication Configuration
 
 ```typescript
@@ -132,6 +133,47 @@ Switchboard supports multiple storage backends:
 - **PostgreSQL**: Persistent database storage
 - **Redis**: Caching layer (optional)
 
+### Observability
+
+Switchboard bootstraps Sentry and OpenTelemetry from a single module (`src/observability.mts`) that is imported as the very first thing in `src/index.mts`. The OpenTelemetry instrumentations (`http`, `express`, `pg`, `graphql`) register require-time hooks at load, so the import order must not be changed.
+
+What runs depends on which environment variables are set:
+
+- `SENTRY_DSN` set → Sentry error reporting is initialized.
+- `ENABLE_TRACING=true` or `NODE_ENV=production`, **and** at least one trace destination is configured (`TEMPO_ENDPOINT` or `SENTRY_DSN`) → OpenTelemetry tracing is initialized. Spans go to Tempo over OTLP HTTP if `TEMPO_ENDPOINT` is set, and/or to Sentry via `SentrySpanProcessor` if `SENTRY_DSN` is set. When both are set, the same trace IDs appear in Tempo and Sentry and cross-link in Grafana.
+- Tracing requested (prod or `ENABLE_TRACING=true`) but no destination configured → a warning is logged and tracing is **not** started. This avoids the cost of patching `http`/`express`/`pg`/`graphql` and generating spans only to drop them. Set `TEMPO_ENDPOINT` and/or `SENTRY_DSN` to enable.
+- `OTEL_EXPORTER_OTLP_ENDPOINT` set → metrics export to that OTLP HTTP endpoint via a periodic reader. Reactor metrics emitted by `@powerhousedao/opentelemetry-instrumentation-reactor` flow through the same global meter provider.
+
+If neither Sentry nor a tracing destination is configured, the module is a no-op and no exporters or instrumentations are registered.
+
+#### Environment Variables
+
+| Variable                      | Description                                                                                                                                                                  | Default                                             |
+| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
+| `SENTRY_DSN`                  | Sentry DSN. When unset, Sentry is disabled.                                                                                                                                  | -                                                   |
+| `SENTRY_ENV`                  | `environment` tag passed to `Sentry.init`.                                                                                                                                   | -                                                   |
+| `SENTRY_RELEASE`              | Release tag (must match the version uploaded by CI for source maps to resolve).                                                                                              | `v${npm_package_version}` if available              |
+| `SENTRY_TRACES_SAMPLE_RATE`   | APM sampling rate (0.0–1.0).                                                                                                                                                 | `0.1`                                               |
+| `ENABLE_TRACING`              | Set to `true` to request tracing outside production. Tracing only starts when a destination is also set.                                                                     | `false` (also requested when `NODE_ENV=production`) |
+| `NODE_ENV`                    | When `production`, tracing is requested automatically. Also exported as `deployment.environment` attribute.                                                                  | `development`                                       |
+| `OTEL_SERVICE_NAME`           | `service.name` resource attribute.                                                                                                                                           | `switchboard`                                       |
+| `TENANT_ID`                   | `tenant.id` resource attribute (used to slice traces by tenant in Grafana).                                                                                                  | `default`                                           |
+| `TEMPO_ENDPOINT`              | OTLP HTTP endpoint for trace export. When unset, OTLP trace export is disabled. In-cluster deploys typically set `http://tempo.monitoring.svc.cluster.local:4318/v1/traces`. | -                                                   |
+| `OTEL_EXPORTER_OTLP_ENDPOINT` | OTLP HTTP endpoint for metrics export. Metrics export is disabled when unset.                                                                                                | -                                                   |
+| `OTEL_METRIC_EXPORT_INTERVAL` | Metric export interval in milliseconds.                                                                                                                                      | `60000`                                             |
+
+#### Local Development
+
+Tracing is off by default outside production, so a bare `pnpm dev` does not need any of these set. To exercise the full pipeline locally, point `TEMPO_ENDPOINT` and `OTEL_EXPORTER_OTLP_ENDPOINT` at a local OTel collector (or Tempo + Prometheus) and run with `ENABLE_TRACING=true`:
+
+```bash
+ENABLE_TRACING=true \
+TEMPO_ENDPOINT=http://localhost:4318/v1/traces \
+OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318/v1/metrics \
+SENTRY_DSN=... \
+pnpm dev
+```
+
 ## 🐳 Docker Deployment
 
 ### Using Docker Compose

package/dist/{esm-aE6sDAbA.mjs → esm-CigE675X.mjs}

@@ -5435,7 +5435,7 @@ var require_node = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	};
 }));
 //#endregion
-//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.4/node_modules/@pyroscope/nodejs/dist/esm/utils/pyroscope-profiler.js
+//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.5/node_modules/@pyroscope/nodejs/dist/esm/utils/pyroscope-profiler.js
 var import_src = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((exports, module) => {
 	/**
 	* Detect Electron renderer / nwjs process, which is node, but we should
@@ -5458,7 +5458,7 @@ function setProfiler(value) {
 	pyroscopeProfiler = value;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.4/node_modules/@pyroscope/nodejs/dist/esm/middleware/express.js
+//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.5/node_modules/@pyroscope/nodejs/dist/esm/middleware/express.js
 const log$5 = (0, import_src.default)("pyroscope");
 async function collectProfile$1(profiler) {
 	const profile = profiler.profile().profile;
@@ -5510,7 +5510,7 @@ function expressMiddleware() {
 	};
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.4/node_modules/@pyroscope/nodejs/dist/esm/middleware/fastify.js
+//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.5/node_modules/@pyroscope/nodejs/dist/esm/middleware/fastify.js
 const log$4 = (0, import_src.default)("pyroscope");
 async function collectProfile(profiler) {
 	const profile = profiler.profile().profile;
@@ -5567,7 +5567,7 @@ const fastifyMiddleware = () => {
 	return plugin;
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.4/node_modules/@pyroscope/nodejs/dist/esm/logger.js
+//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.5/node_modules/@pyroscope/nodejs/dist/esm/logger.js
 /**
 * Copyright 2024 Datadog Inc. All Rights Reserved.
 *
@@ -5596,13 +5596,13 @@ function setLogger$1(newLogger) {
 	logger = newLogger;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.4/node_modules/@pyroscope/nodejs/dist/esm/utils/date-to-unix-timestamp.js
+//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.5/node_modules/@pyroscope/nodejs/dist/esm/utils/date-to-unix-timestamp.js
 const MS_PER_SECOND$1 = 1e3;
 function dateToUnixTimestamp(date) {
 	return Math.floor(date.getTime() / MS_PER_SECOND$1);
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.4/node_modules/@pyroscope/nodejs/dist/esm/utils/process-profile.js
+//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.5/node_modules/@pyroscope/nodejs/dist/esm/utils/process-profile.js
 const V8_NAME_TO_GOLANG_NAME_MAP = {
 	objects: "inuse_objects",
 	sample: "samples",
@@ -5633,7 +5633,7 @@ function adjustSampleNames(profile) {
 	}
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.4/node_modules/@pyroscope/nodejs/dist/esm/pyroscope-api-exporter.js
+//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.5/node_modules/@pyroscope/nodejs/dist/esm/pyroscope-api-exporter.js
 const log$3 = (0, import_src.default)("pyroscope");
 var PyroscopeApiExporter = class {
 	applicationName;
@@ -5698,7 +5698,7 @@ var PyroscopeApiExporter = class {
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.4/node_modules/@pyroscope/nodejs/dist/esm/profilers/continuous-profiler.js
+//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.5/node_modules/@pyroscope/nodejs/dist/esm/profilers/continuous-profiler.js
 const log$2 = (0, import_src.default)("pyroscope::profiler");
 var ContinuousProfiler = class {
 	profiler;
@@ -5759,7 +5759,7 @@ var ContinuousProfiler = class {
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.4/node_modules/@pyroscope/nodejs/dist/esm/profilers/heap-profiler.js
+//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.5/node_modules/@pyroscope/nodejs/dist/esm/profilers/heap-profiler.js
 const log$1 = (0, import_src.default)("pyroscope::profiler::heap");
 var HeapProfiler = class {
 	lastProfiledAt;
@@ -5800,7 +5800,7 @@ var HeapProfiler = class {
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.4/node_modules/@pyroscope/nodejs/dist/esm/profilers/wall-profiler.js
+//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.5/node_modules/@pyroscope/nodejs/dist/esm/profilers/wall-profiler.js
 const MICROS_PER_SECOND$1 = 1e6;
 const log = (0, import_src.default)("pyroscope::profiler::wall");
 var WallProfiler = class {
@@ -5871,7 +5871,7 @@ var WallProfiler = class {
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.4/node_modules/@pyroscope/nodejs/dist/esm/profilers/pyroscope-profiler.js
+//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.5/node_modules/@pyroscope/nodejs/dist/esm/profilers/pyroscope-profiler.js
 const MICROS_PER_SECOND = 1e6;
 const MS_PER_SECOND = 1e3;
 const B_PER_MB = 1024;
@@ -6072,7 +6072,7 @@ function validateConcurrency(concurrency) {
 	if (!((Number.isInteger(concurrency) || concurrency === Number.POSITIVE_INFINITY) && concurrency > 0)) throw new TypeError("Expected `concurrency` to be a number from 1 and up");
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.4/node_modules/@pyroscope/nodejs/dist/esm/sourcemapper.js
+//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.5/node_modules/@pyroscope/nodejs/dist/esm/sourcemapper.js
 /**
 * Copyright 2024 Datadog Inc. All Rights Reserved.
 * Copyright 2016 Google Inc. All Rights Reserved.
@@ -6308,7 +6308,7 @@ async function getSourceCodeFiles(baseDir) {
 	return mapFiles;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.4/node_modules/@pyroscope/nodejs/dist/esm/utils/check-pyroscope-config.js
+//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.5/node_modules/@pyroscope/nodejs/dist/esm/utils/check-pyroscope-config.js
 function checkPyroscopeConfig(config) {
 	if (!isObject(config)) throw new Error("Expecting an object config");
 	const errors = [];
@@ -6360,7 +6360,7 @@ function isObject(object) {
 	return object !== null && typeof object === "object";
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.4/node_modules/@pyroscope/nodejs/dist/esm/utils/get-env.js
+//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.5/node_modules/@pyroscope/nodejs/dist/esm/utils/get-env.js
 function getEnv() {
 	return {
 		adhocServerAddress: process.env["PYROSCOPE_ADHOC_SERVER_ADDRESS"],
@@ -6382,7 +6382,7 @@ function parseBooleanEnv(envVal) {
 	return envVal === void 0 ? envVal : envVal === "true" || envVal === "1";
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.4/node_modules/@pyroscope/nodejs/dist/esm/utils/process-config.js
+//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.5/node_modules/@pyroscope/nodejs/dist/esm/utils/process-config.js
 function processConfig(config, env) {
 	return {
 		appName: config.appName ?? env.appName,
@@ -6406,7 +6406,7 @@ function processConfig(config, env) {
 	};
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.4/node_modules/@pyroscope/nodejs/dist/esm/index.js
+//#region ../../node_modules/.pnpm/@pyroscope+nodejs@0.4.10_express@4.22.1_fastify@5.8.5/node_modules/@pyroscope/nodejs/dist/esm/index.js
 function init(config = {}) {
 	checkPyroscopeConfig(config);
 	setProfiler(new PyroscopeProfiler(processConfig(config, getEnv())));
@@ -6478,4 +6478,4 @@ var esm_default = {
 //#endregion
 export { esm_default as default };
 
-//# sourceMappingURL=esm-aE6sDAbA.mjs.map
+//# sourceMappingURL=esm-CigE675X.mjs.map