@dxos/observability 0.10.0 → 0.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/observability",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Provides a common interface for app and platform observability",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -14,9 +14,9 @@
   "type": "module",
   "exports": {
     ".": {
+      "source": "./src/index.ts",
       "types": "./dist/types/src/index.d.ts",
-      "browser": "./dist/lib/browser/index.mjs",
-      "node": "./dist/lib/node-esm/index.mjs"
+      "import": "./dist/lib/index.mjs"
     }
   },
   "browser": {
@@ -30,44 +30,44 @@
   ],
   "dependencies": {
     "@opentelemetry/api": "^1.9.1",
-    "@opentelemetry/api-logs": "^0.219.0",
-    "@opentelemetry/auto-instrumentations-web": "^0.64.0",
-    "@opentelemetry/core": "^2.8.0",
-    "@opentelemetry/exporter-logs-otlp-http": "^0.219.0",
-    "@opentelemetry/exporter-metrics-otlp-http": "^0.219.0",
-    "@opentelemetry/exporter-trace-otlp-http": "^0.219.0",
-    "@opentelemetry/instrumentation": "^0.219.0",
-    "@opentelemetry/resources": "^2.8.0",
-    "@opentelemetry/sdk-logs": "^0.219.0",
-    "@opentelemetry/sdk-metrics": "^2.8.0",
-    "@opentelemetry/sdk-trace-base": "^2.8.0",
-    "@opentelemetry/sdk-trace-web": "^2.8.0",
-    "@opentelemetry/semantic-conventions": "^1.41.1",
+    "@opentelemetry/api-logs": "^0.221.0",
+    "@opentelemetry/auto-instrumentations-web": "^0.66.0",
+    "@opentelemetry/core": "^2.10.0",
+    "@opentelemetry/exporter-logs-otlp-http": "^0.221.0",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.221.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.221.0",
+    "@opentelemetry/instrumentation": "^0.221.0",
+    "@opentelemetry/resources": "^2.10.0",
+    "@opentelemetry/sdk-logs": "^0.221.0",
+    "@opentelemetry/sdk-metrics": "^2.10.0",
+    "@opentelemetry/sdk-trace-base": "^2.10.0",
+    "@opentelemetry/sdk-trace-web": "^2.10.0",
+    "@opentelemetry/semantic-conventions": "^1.43.0",
     "js-yaml": "4.1.1",
     "localforage": "^1.10.0",
     "posthog-js": "^1.353.0",
     "uuid": "^9.0.0",
     "zone.js": "^0.15.0",
-    "@dxos/async": "0.10.0",
-    "@dxos/config": "0.10.0",
-    "@dxos/client-services": "0.10.0",
-    "@dxos/client": "0.10.0",
-    "@dxos/context": "0.10.0",
-    "@dxos/invariant": "0.10.0",
-    "@dxos/log": "0.10.0",
-    "@dxos/log-store-idb": "0.10.0",
-    "@dxos/util": "0.10.0",
-    "@dxos/tracing": "0.10.0",
-    "@dxos/network-manager": "0.10.0",
-    "@dxos/node-std": "0.10.0",
-    "@dxos/protocols": "0.10.0"
+    "@dxos/client": "0.11.0",
+    "@dxos/client-services": "0.11.0",
+    "@dxos/async": "0.11.0",
+    "@dxos/config": "0.11.0",
+    "@dxos/context": "0.11.0",
+    "@dxos/invariant": "0.11.0",
+    "@dxos/log": "0.11.0",
+    "@dxos/log-store-idb": "0.11.0",
+    "@dxos/node-std": "0.11.0",
+    "@dxos/network-manager": "0.11.0",
+    "@dxos/tracing": "0.11.0",
+    "@dxos/protocols": "0.11.0",
+    "@dxos/util": "0.11.0"
   },
   "devDependencies": {
     "@effect/platform": "0.96.2",
     "@types/debug": "^4.1.10",
     "@types/js-yaml": "^4.0.5",
-    "@dxos/effect": "0.10.0",
-    "@dxos/messaging": "0.10.0"
+    "@dxos/effect": "0.11.0",
+    "@dxos/messaging": "0.11.0"
   },
   "peerDependencies": {
     "@effect/platform": "0.96.2",

package/src/cli-observability-secrets.json

@@ -1,6 +1,6 @@
 {
   "POSTHOG_API_KEY": null,
-  "IPDATA_API_KEY": "73dfdecdf979c18f07d50cf841bbdd9e589f237256326ac8cca23786",
-  "OTEL_ENDPOINT": "/api/otel",
+  "IPDATA_API_KEY": null,
+  "OTEL_ENDPOINT": null,
   "OTEL_HEADERS": null
 }

package/src/extensions/otel/logs.test.ts

@@ -0,0 +1,39 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { describe, test } from 'vitest';
+
+import { stringifyValues } from './logs';
+
+describe('stringifyValues', () => {
+  test('serializes errors via stack', ({ expect }) => {
+    const error = new Error('upload exploded');
+    const result = stringifyValues({ error }, 'ctx_');
+    expect(result.ctx_error).toContain('upload exploded');
+  });
+
+  test('falls back to name and message when stack is absent', ({ expect }) => {
+    const error = new Error('no stack here');
+    error.stack = undefined;
+    expect(stringifyValues({ error })).toEqual({ error: 'Error: no stack here' });
+  });
+
+  test('serializes errors nested past the flatten depth', ({ expect }) => {
+    const result = stringifyValues({ outer: { inner: { error: new Error('deep') } } });
+    expect(Object.values(result).join()).toContain('deep');
+  });
+
+  test('flattens plain objects and stringifies arrays', ({ expect }) => {
+    expect(stringifyValues({ status: 502, nested: { count: 1 }, list: [1, 2] })).toEqual({
+      status: '502',
+      nested_count: '1',
+      list: '[1,2]',
+    });
+  });
+
+  test('skips undefined values and handles a missing object', ({ expect }) => {
+    expect(stringifyValues({ present: 'yes', absent: undefined })).toEqual({ present: 'yes' });
+    expect(stringifyValues(undefined)).toEqual({});
+  });
+});

package/src/extensions/otel/logs.ts

@@ -41,7 +41,7 @@ export class OtelLogs {
     });
     this._loggerProvider = new LoggerProvider({
       resource: this.options.resource,
-      processors: [new BatchLogRecordProcessor(logExporter)],
+      processors: [new BatchLogRecordProcessor({ exporter: logExporter })],
     });
   }
 
@@ -101,16 +101,19 @@ const convertLevel = (level: LogLevel): SeverityNumber => {
   }
 };
 
+const errorToString = (error: Error): string => error.stack ?? `${error.name}: ${error.message}`;
+
 const safeStringify = (value: unknown): string => {
   try {
-    return JSON.stringify(value);
+    // Replace errors as they are encountered; `JSON.stringify` alone renders them as `{}`.
+    return JSON.stringify(value, (_key, nested) => (nested instanceof Error ? errorToString(nested) : nested));
   } catch {
     return '[Circular]';
   }
 };
 
 // TODO(wittjosiah): Reconcile logging utils w/ EDGE.
-const stringifyValues = (object: object | undefined, keyPrefix?: string, depth: number = 1) => {
+export const stringifyValues = (object: object | undefined, keyPrefix?: string, depth: number = 1) => {
   if (!object) {
     return {};
   }
@@ -121,7 +124,11 @@ const stringifyValues = (object: object | undefined, keyPrefix?: string, depth:
     }
     const newKey = keyPrefix ? `${keyPrefix}${key}` : key;
     if (typeof value === 'object') {
-      if (!value || Array.isArray(value) || depth > FLATTEN_DEPTH) {
+      if (value instanceof Error) {
+        // `message`/`stack` are non-enumerable, so the flatten path below would silently
+        // reduce a logged error to nothing.
+        result[newKey] = errorToString(value);
+      } else if (!value || Array.isArray(value) || depth > FLATTEN_DEPTH) {
         result[newKey] = safeStringify(value);
       } else {
         const flattened = stringifyValues(value, `${newKey}_`, depth + 1);

package/src/extensions/posthog/extension.ts

@@ -104,6 +104,8 @@ export const extensions: (options: ExtensionsOptions) => Effect.Effect<Extension
           api_host,
           mask_all_text: true,
           capture_exceptions: true,
+          // Cookies stay scoped to the exact host; the cross-subdomain dmn_chk_* probe fails on public-suffix hosts (e.g. *.pages.dev) and spams the console.
+          cross_subdomain_cookie: false,
           ...posthogConfig,
         });
         if (release || environment) {
@@ -181,6 +183,8 @@ export const extensions: (options: ExtensionsOptions) => Effect.Effect<Extension
                     $survey_id: survey.id,
                     $survey_questions: [{ id: question.id, question: question.question }],
                     [`$survey_response_${question.id}`]: form.message,
+                    // Survey destinations (Slack/webhook notifications) filter on `$survey_completed = true`, so responses without it are dropped.
+                    $survey_completed: true,
                     debug_log_dump_key: debugLogDumpKey,
                   });
                   resolve(result?.uuid);

package/dist/lib/browser/chunk-J5LGTIGS.mjs

@@ -1,10 +0,0 @@
-var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-
-export {
-  __export
-};
-//# sourceMappingURL=chunk-J5LGTIGS.mjs.map

package/dist/lib/browser/chunk-J5LGTIGS.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": [],
-  "sourcesContent": [],
-  "mappings": "",
-  "names": []
-}

package/dist/lib/browser/chunk-PSFTIG54.mjs

@@ -1,20 +0,0 @@
-// src/extensions/otel/otel.ts
-import { DiagConsoleLogger, DiagLogLevel, diag } from "@opentelemetry/api";
-var setDiagLogger = (level) => {
-  const logLevel = DiagLogLevel[level];
-  if (logLevel) {
-    diag.setLogger(new DiagConsoleLogger(), logLevel);
-  }
-};
-var resolveOtlpUrl = (url) => {
-  if (typeof window !== "undefined" && url.startsWith("/")) {
-    return new URL(url, window.location.origin).toString();
-  }
-  return url;
-};
-
-export {
-  setDiagLogger,
-  resolveOtlpUrl
-};
-//# sourceMappingURL=chunk-PSFTIG54.mjs.map

package/dist/lib/browser/chunk-PSFTIG54.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/extensions/otel/otel.ts"],
-  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport { DiagConsoleLogger, DiagLogLevel, diag } from '@opentelemetry/api';\nimport { type Resource } from '@opentelemetry/resources';\n\nexport type OtelOptions = {\n  endpoint: string;\n  headers: Record<string, string>;\n  resource: Resource;\n  getTags: () => { [key: string]: string };\n  consoleDiagLogLevel?: string;\n};\n\nexport const setDiagLogger = (level?: string) => {\n  const logLevel = DiagLogLevel[level as keyof typeof DiagLogLevel];\n  if (logLevel) {\n    diag.setLogger(new DiagConsoleLogger(), logLevel);\n  }\n};\n\n/**\n * Resolve a possibly-relative OTLP exporter URL to an absolute URL.\n * The OpenTelemetry browser HTTP exporter validates user-provided URLs with `new URL(url)`,\n * which throws on relative paths like `/api/otel/v1/logs`. In a browser context we resolve\n * against `window.location.origin`; outside the browser we return the input unchanged.\n */\nexport const resolveOtlpUrl = (url: string): string => {\n  if (typeof window !== 'undefined' && url.startsWith('/')) {\n    return new URL(url, window.location.origin).toString();\n  }\n  return url;\n};\n"],
-  "mappings": ";AAIA,SAASA,mBAAmBC,cAAcC,YAAY;AAW/C,IAAMC,gBAAgB,CAACC,UAAAA;AAC5B,QAAMC,WAAWJ,aAAaG,KAAAA;AAC9B,MAAIC,UAAU;AACZH,SAAKI,UAAU,IAAIN,kBAAAA,GAAqBK,QAAAA;EAC1C;AACF;AAQO,IAAME,iBAAiB,CAACC,QAAAA;AAC7B,MAAI,OAAOC,WAAW,eAAeD,IAAIE,WAAW,GAAA,GAAM;AACxD,WAAO,IAAIC,IAAIH,KAAKC,OAAOG,SAASC,MAAM,EAAEC,SAAQ;EACtD;AACA,SAAON;AACT;",
-  "names": ["DiagConsoleLogger", "DiagLogLevel", "diag", "setDiagLogger", "level", "logLevel", "setLogger", "resolveOtlpUrl", "url", "window", "startsWith", "URL", "location", "origin", "toString"]
-}