@decocms/blocks 7.15.1 → 7.16.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/blocks",
-  "version": "7.15.1",
+  "version": "7.16.0",
   "type": "module",
   "engines": {
     "node": ">=24"

package/src/sdk/otel.ts

@@ -99,6 +99,23 @@ import { RequestContext } from "./requestContext";
 // ---------------------------------------------------------------------------
 
 export interface OtelOptions {
+  /**
+   * When `true`, skips all observability exporters (AE, OTLP metrics,
+   * logs, traces). Overridden by the env var.
+   */
+  disabled?: boolean;
+  /**
+   * Env var name holding the tri-state observability switch. Values:
+   * - `"on"`   → force enable (even in local dev)
+   * - `"off"`  → force disable
+   * - unset    → auto: enabled in real deploys, disabled in local
+   *
+   * Local is detected by the absence of `CF_VERSION_METADATA` (a binding
+   * that only exists in production/preview Cloudflare deploys).
+   *
+   * Defaults to `"DECO_OTEL"`.
+   */
+  envVar?: string;
   /** Logical service name. Falls back to `env.DECO_SITE_NAME`, then "deco-site". */
   serviceName?: string;
   /** Env var name holding the AE binding. Defaults to `"DECO_METRICS"`. */
@@ -624,6 +641,18 @@ function bootObservability(opts: OtelOptions, env: Record<string, unknown>): voi
   const state = getBootState();
   if (state.booted) return;
 
+  // CF_VERSION_METADATA is only present in real (production/preview) deploys;
+  // wrangler dev never sets it, making it a reliable local-dev signal.
+  const mode = env[opts.envVar ?? "DECO_OTEL"];
+  const isLocal = !env.CF_VERSION_METADATA;
+  const isDisabled =
+    mode === "off" ||
+    (mode !== "on" && (opts.disabled || isLocal));
+  if (isDisabled) {
+    state.booted = true;
+    return;
+  }
+
   // Capture the original console.warn BEFORE patchConsole() runs. The onError
   // callbacks below need a direct channel to console that bypasses the logger
   // to avoid routing exporter-level warnings back through the OTLP adapter