@dxos/observability 0.8.4-main.ae835ea → 0.8.4-main.bc2380dfbc

package/dist/types/src/extensions/otel/logs.js

@@ -0,0 +1,107 @@
+//
+// Copyright 2024 DXOS.org
+//
+import { SeverityNumber } from '@opentelemetry/api-logs';
+import { OTLPLogExporter } from '@opentelemetry/exporter-logs-otlp-http';
+import { BatchLogRecordProcessor, LoggerProvider } from '@opentelemetry/sdk-logs';
+import { ATTR_SERVICE_VERSION } from '@opentelemetry/semantic-conventions';
+import { LogLevel, getContextFromEntry, getRelativeFilename, } from '@dxos/log';
+import { resolveOtlpUrl, setDiagLogger } from './otel';
+const FLATTEN_DEPTH = 1;
+export class OtelLogs {
+    options;
+    _loggerProvider;
+    constructor(options) {
+        this.options = options;
+        setDiagLogger(options.consoleDiagLogLevel);
+        const logExporter = new OTLPLogExporter({
+            url: resolveOtlpUrl(this.options.endpoint + '/v1/logs'),
+            headers: this.options.headers,
+            concurrencyLimit: 10, // an optional limit on pending requests
+        });
+        this._loggerProvider = new LoggerProvider({
+            resource: this.options.resource,
+            processors: [new BatchLogRecordProcessor(logExporter)],
+        });
+    }
+    logProcessor = (_config, entry) => {
+        const logger = this._loggerProvider.getLogger('dxos-observability', this.options.resource.attributes[ATTR_SERVICE_VERSION]?.toString());
+        if (entry.level < this.options.logLevel ||
+            (!this.options.includeSharedWorkerLogs && entry.meta?.S?.remoteSessionId)) {
+            return;
+        }
+        const attributes = {
+            ...this.options.getTags(),
+            ...(entry.meta ? { meta: { file: getRelativeFilename(entry.meta.F), line: entry.meta.L } } : {}),
+            ...(entry.error ? { error: entry.error.stack } : {}),
+            ...stringifyValues(getContextFromEntry(entry), 'ctx_'),
+        };
+        logger.emit({
+            severityNumber: convertLevel(entry.level),
+            body: entry.message,
+            attributes,
+        });
+    };
+    flush() {
+        return this._loggerProvider.forceFlush();
+    }
+    close() {
+        return this._loggerProvider.shutdown();
+    }
+}
+/** Maps {@link LogLevel} to OpenTelemetry {@link SeverityNumber}. */
+const convertLevel = (level) => {
+    switch (level) {
+        case LogLevel.TRACE:
+            return SeverityNumber.TRACE;
+        case LogLevel.DEBUG:
+            return SeverityNumber.DEBUG;
+        case LogLevel.VERBOSE:
+            return SeverityNumber.INFO;
+        case LogLevel.INFO:
+            return SeverityNumber.INFO;
+        case LogLevel.WARN:
+            return SeverityNumber.WARN;
+        case LogLevel.ERROR:
+            return SeverityNumber.ERROR;
+        default:
+            return SeverityNumber.UNSPECIFIED;
+    }
+};
+const safeStringify = (value) => {
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return '[Circular]';
+    }
+};
+// TODO(wittjosiah): Reconcile logging utils w/ EDGE.
+const stringifyValues = (object, keyPrefix, depth = 1) => {
+    if (!object) {
+        return {};
+    }
+    const result = {};
+    for (const [key, value] of Object.entries(object)) {
+        if (value === undefined) {
+            continue;
+        }
+        const newKey = keyPrefix ? `${keyPrefix}${key}` : key;
+        if (typeof value === 'object') {
+            if (!value || Array.isArray(value) || depth > FLATTEN_DEPTH) {
+                result[newKey] = safeStringify(value);
+            }
+            else {
+                const flattened = stringifyValues(value, `${newKey}_`, depth + 1);
+                for (const [flattenedKey, flattenedValue] of Object.entries(flattened)) {
+                    result[flattenedKey] = flattenedValue;
+                }
+            }
+        }
+        else {
+            result[newKey] = String(value);
+        }
+    }
+    return result;
+};
+//# sourceMappingURL=logs.js.map

package/dist/types/src/extensions/otel/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../../../../src/extensions/otel/logs.ts"],"names":[],"mappings":"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"}

package/dist/types/src/extensions/otel/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/otel/metrics.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,WAAW,EAAiC,MAAM,QAAQ,CAAC;AAIzE,qBAAa,WAAW;IAIV,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,MAAM,CAAQ;IAEtB,YAA6B,OAAO,EAAE,WAAW,EAoChD;IAED,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAInD;IAED,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAIxD;IAED,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAI1D;IAED,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAErB;IAED,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAErB;CACF"}

package/dist/types/src/{otel → extensions/otel}/metrics.js

@@ -2,12 +2,10 @@
 // Copyright 2024 DXOS.org
 //
 import { OTLPMetricExporter } from '@opentelemetry/exporter-metrics-otlp-http';
-import { defaultResource, resourceFromAttributes } from '@opentelemetry/resources';
 import { MeterProvider, PeriodicExportingMetricReader } from '@opentelemetry/sdk-metrics';
-import { SEMRESATTRS_SERVICE_NAME, SEMRESATTRS_SERVICE_VERSION } from '@opentelemetry/semantic-conventions';
 import { log } from '@dxos/log';
 import { TRACE_PROCESSOR } from '@dxos/tracing';
-import { setDiagLogger } from './otel';
+import { resolveOtlpUrl, setDiagLogger } from './otel';
 const EXPORT_INTERVAL = 60 * 1000;
 export class OtelMetrics {
     options;
@@ -18,21 +16,15 @@ export class OtelMetrics {
         // TODO: improve error handling/logging
         //  https://github.com/open-telemetry/opentelemetry-js/issues/4823
         setDiagLogger(options.consoleDiagLogLevel);
-        const resource = defaultResource().merge(resourceFromAttributes({
-            [SEMRESATTRS_SERVICE_NAME]: this.options.serviceName,
-            [SEMRESATTRS_SERVICE_VERSION]: this.options.serviceVersion,
-        }));
         const grafanaMetricReader = new PeriodicExportingMetricReader({
             exporter: new OTLPMetricExporter({
-                url: this.options.endpoint + '/v1/metrics',
-                headers: {
-                    Authorization: this.options.authorizationHeader,
-                },
+                url: resolveOtlpUrl(this.options.endpoint + '/v1/metrics'),
+                headers: this.options.headers,
             }),
             exportIntervalMillis: EXPORT_INTERVAL,
         });
         this._meterProvider = new MeterProvider({
-            resource,
+            resource: this.options.resource,
             readers: [grafanaMetricReader],
         });
         this._meter = this._meterProvider.getMeter('dxos-observability');

package/dist/types/src/extensions/otel/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../../../src/extensions/otel/metrics.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAGF,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAE1F,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAmB,eAAe,EAAE,MAAM,eAAe,CAAC;AAEjE,OAAO,EAAoB,cAAc,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEzE,MAAM,eAAe,GAAG,EAAE,GAAG,IAAI,CAAC;AAElC,MAAM,OAAO,WAAW;IAIO,OAAO;IAH5B,cAAc,CAAgB;IAC9B,MAAM,CAAQ;IAEtB,YAA6B,OAAoB;uBAApB,OAAO;QAClC,uCAAuC;QACvC,kEAAkE;QAClE,aAAa,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAE3C,MAAM,mBAAmB,GAAG,IAAI,6BAA6B,CAAC;YAC5D,QAAQ,EAAE,IAAI,kBAAkB,CAAC;gBAC/B,GAAG,EAAE,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAG,aAAa,CAAC;gBAC1D,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO;aAC9B,CAAC;YACF,oBAAoB,EAAE,eAAe;SACtC,CAAC,CAAC;QAEH,IAAI,CAAC,cAAc,GAAG,IAAI,aAAa,CAAC;YACtC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ;YAC/B,OAAO,EAAE,CAAC,mBAAmB,CAAC;SAC/B,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;QAEjE,MAAM,OAAO,GAAG;YACd,gDAAgD;YAChD,SAAS,EAAE,CAAC,IAAY,EAAE,KAAc,EAAE,IAAiB,EAAE,EAAE;gBAC7D,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;YACjD,CAAC;YACD,YAAY,EAAE,CAAC,IAAY,EAAE,KAAa,EAAE,IAAiB,EAAE,EAAE;gBAC/D,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;YACpD,CAAC;YACD,GAAG,EAAE,CAAC,IAAY,EAAE,KAAsB,EAAE,IAAiB,EAAE,EAAE;gBAC/D,0CAA0C;YAC5C,CAAC;YACD,KAAK,EAAE,CAAC,IAAY,EAAE,KAAa,EAAE,IAAiB,EAAE,EAAE;gBACxD,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;YAC7C,CAAC;SACF,CAAC;QAEF,eAAe,CAAC,aAAa,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,IAAY,EAAE,KAAa,EAAE,IAAU;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC5C,GAAG,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC;QACjF,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,SAAS,CAAC,IAAY,EAAE,KAAc,EAAE,IAAU;QAChD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAChD,GAAG,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC;QACnF,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,YAAY,CAAC,IAAY,EAAE,KAAa,EAAE,IAAU;QAClD,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACvD,GAAG,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC;QACxF,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC;IAC1C,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC;IACxC,CAAC;CACF;AAED,MAAM,WAAW,GAAG,CAAC,IAAiB,EAAE,EAAE;IACxC,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACtB,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAyB,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YACpF,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACjB,OAAO,GAAG,CAAC;QACb,CAAC,EAAE,EAAE,CAAC,CAAC;IACT,CAAC;SAAM,CAAC;QACN,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC,CAAC"}

package/dist/types/src/extensions/otel/otel.d.ts

@@ -0,0 +1,19 @@
+import { type Resource } from '@opentelemetry/resources';
+export type OtelOptions = {
+    endpoint: string;
+    headers: Record<string, string>;
+    resource: Resource;
+    getTags: () => {
+        [key: string]: string;
+    };
+    consoleDiagLogLevel?: string;
+};
+export declare const setDiagLogger: (level?: string) => void;
+/**
+ * Resolve a possibly-relative OTLP exporter URL to an absolute URL.
+ * The OpenTelemetry browser HTTP exporter validates user-provided URLs with `new URL(url)`,
+ * which throws on relative paths like `/api/otel/v1/logs`. In a browser context we resolve
+ * against `window.location.origin`; outside the browser we return the input unchanged.
+ */
+export declare const resolveOtlpUrl: (url: string) => string;
+//# sourceMappingURL=otel.d.ts.map

package/dist/types/src/extensions/otel/otel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/otel/otel.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACzC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,aAAa,WAAY,MAAM,SAK3C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,QAAS,MAAM,KAAG,MAK5C,CAAC"}

package/dist/types/src/extensions/otel/otel.js

@@ -0,0 +1,23 @@
+//
+// Copyright 2024 DXOS.org
+//
+import { DiagConsoleLogger, DiagLogLevel, diag } from '@opentelemetry/api';
+export const setDiagLogger = (level) => {
+    const logLevel = DiagLogLevel[level];
+    if (logLevel) {
+        diag.setLogger(new DiagConsoleLogger(), logLevel);
+    }
+};
+/**
+ * Resolve a possibly-relative OTLP exporter URL to an absolute URL.
+ * The OpenTelemetry browser HTTP exporter validates user-provided URLs with `new URL(url)`,
+ * which throws on relative paths like `/api/otel/v1/logs`. In a browser context we resolve
+ * against `window.location.origin`; outside the browser we return the input unchanged.
+ */
+export const resolveOtlpUrl = (url) => {
+    if (typeof window !== 'undefined' && url.startsWith('/')) {
+        return new URL(url, window.location.origin).toString();
+    }
+    return url;
+};
+//# sourceMappingURL=otel.js.map

package/dist/types/src/extensions/otel/otel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.js","sourceRoot":"","sources":["../../../../../src/extensions/otel/otel.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAEF,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAW3E,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,EAAE;IAC9C,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAkC,CAAC,CAAC;IAClE,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,CAAC,SAAS,CAAC,IAAI,iBAAiB,EAAE,EAAE,QAAQ,CAAC,CAAC;IACpD,CAAC;AACH,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAW,EAAU,EAAE;IACpD,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzD,OAAO,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;IACzD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC"}

package/dist/types/src/extensions/otel/span-processors.d.ts

@@ -0,0 +1,25 @@
+import { type Context } from '@opentelemetry/api';
+import { type ReadableSpan, type Span, type SpanProcessor } from '@opentelemetry/sdk-trace-base';
+/**
+ * Injects dynamic tags as attributes on every span.
+ *
+ * This is an `onStart`-only processor; `onEnd`/`shutdown`/`forceFlush` are no-ops
+ * because this processor never holds pending work (delegates export to downstream
+ * processors like BatchSpanProcessor).
+ *
+ * Use for tags that are not known at provider construction (e.g. identity
+ * resolved asynchronously after login). For values known at startup, prefer
+ * putting them on the `Resource` — see `extension.ts`.
+ *
+ * Failures in the tag provider are swallowed so they can never break span
+ * recording (the processor is best-effort and runs on the startSpan hot path).
+ */
+export declare class TagInjectorSpanProcessor implements SpanProcessor {
+    private readonly _getTags;
+    constructor(_getTags: () => Record<string, string>);
+    onStart(span: Span, _parentContext: Context): void;
+    onEnd(_span: ReadableSpan): void;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+}
+//# sourceMappingURL=span-processors.d.ts.map

package/dist/types/src/extensions/otel/span-processors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-processors.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/otel/span-processors.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,IAAI,EAAE,KAAK,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAIjG;;;;;;;;;;;;;GAaG;AACH,qBAAa,wBAAyB,YAAW,aAAa;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAArC,YAA6B,QAAQ,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAI;IAEvE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,GAAG,IAAI,CAWjD;IAED,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAG;IAE7B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;IAE5B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;CACrC"}

package/dist/types/src/extensions/otel/span-processors.js

@@ -0,0 +1,41 @@
+//
+// Copyright 2025 DXOS.org
+//
+import { log } from '@dxos/log';
+/**
+ * Injects dynamic tags as attributes on every span.
+ *
+ * This is an `onStart`-only processor; `onEnd`/`shutdown`/`forceFlush` are no-ops
+ * because this processor never holds pending work (delegates export to downstream
+ * processors like BatchSpanProcessor).
+ *
+ * Use for tags that are not known at provider construction (e.g. identity
+ * resolved asynchronously after login). For values known at startup, prefer
+ * putting them on the `Resource` — see `extension.ts`.
+ *
+ * Failures in the tag provider are swallowed so they can never break span
+ * recording (the processor is best-effort and runs on the startSpan hot path).
+ */
+export class TagInjectorSpanProcessor {
+    _getTags;
+    constructor(_getTags) {
+        this._getTags = _getTags;
+    }
+    onStart(span, _parentContext) {
+        let tags;
+        try {
+            tags = this._getTags();
+        }
+        catch (err) {
+            log.catch(err);
+            return;
+        }
+        for (const [key, value] of Object.entries(tags)) {
+            span.setAttribute(key, value);
+        }
+    }
+    onEnd(_span) { }
+    async shutdown() { }
+    async forceFlush() { }
+}
+//# sourceMappingURL=span-processors.js.map

package/dist/types/src/extensions/otel/span-processors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-processors.js","sourceRoot":"","sources":["../../../../../src/extensions/otel/span-processors.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAKF,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhC;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,wBAAwB;IACN,QAAQ;IAArC,YAA6B,QAAsC;wBAAtC,QAAQ;IAAiC,CAAC;IAEvE,OAAO,CAAC,IAAU,EAAE,cAAuB;QACzC,IAAI,IAA4B,CAAC;QACjC,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACzB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACf,OAAO;QACT,CAAC;QACD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAmB,IAAS,CAAC;IAEnC,KAAK,CAAC,QAAQ,KAAmB,CAAC;IAElC,KAAK,CAAC,UAAU,KAAmB,CAAC;CACrC"}

package/dist/types/src/extensions/otel/traces-browser.d.ts

@@ -0,0 +1,25 @@
+import { type OtelOptions } from './otel';
+export declare class OtelTraces {
+    private readonly options;
+    private _tracer;
+    private readonly _tracerProvider;
+    constructor(options: OtelOptions);
+    /**
+     * Forcibly flush the BatchSpanProcessor. Call before process exit / page unload
+     * to avoid losing queued spans (which manifests as "Missing Span" in SigNoz —
+     * their already-exported children reference a parent that never made it to OTLP).
+     */
+    flush(): Promise<void>;
+    /**
+     * Flush + shut down the tracer provider via `WebTracerProvider.shutdown()`,
+     * which forces a final export then terminates all span processors.
+     *
+     * Terminal and effectively one-shot: safe to call after `flush()`, but
+     * `flush()` MUST NOT be called after `close()` — shutdown stops further
+     * exporting, so subsequent `close()`/`flush()` calls resolve without
+     * emitting new spans.
+     */
+    close(): Promise<void>;
+    start(): void;
+}
+//# sourceMappingURL=traces-browser.d.ts.map

package/dist/types/src/extensions/otel/traces-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traces-browser.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/otel/traces-browser.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAE,KAAK,WAAW,EAAkB,MAAM,QAAQ,CAAC;AAG1D,qBAAa,UAAU;IAIT,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoB;IAEpD,YAA6B,OAAO,EAAE,WAAW,EA6BhD;IAED;;;;OAIG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAElC;IAED;;;;;;;;OAQG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAElC;IAEM,KAAK,IAAI,IAAI,CAiDnB;CACF"}

package/dist/types/src/extensions/otel/traces-browser.js

@@ -0,0 +1,105 @@
+//
+// Copyright 2024 DXOS.org
+//
+import { ROOT_CONTEXT, SpanStatusCode, context as otelContext, propagation, trace, } from '@opentelemetry/api';
+import { getWebAutoInstrumentations } from '@opentelemetry/auto-instrumentations-web';
+import { W3CTraceContextPropagator } from '@opentelemetry/core';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
+import { registerInstrumentations } from '@opentelemetry/instrumentation';
+import { AlwaysOnSampler, BatchSpanProcessor, ParentBasedSampler, TraceIdRatioBasedSampler, } from '@opentelemetry/sdk-trace-base';
+import { WebTracerProvider } from '@opentelemetry/sdk-trace-web';
+import { ATTR_SERVICE_VERSION } from '@opentelemetry/semantic-conventions';
+import { log } from '@dxos/log';
+import { TRACE_ALL_KEY, TRACE_PROCESSOR } from '@dxos/tracing';
+import { resolveOtlpUrl } from './otel';
+import { TagInjectorSpanProcessor } from './span-processors';
+export class OtelTraces {
+    options;
+    _tracer;
+    _tracerProvider;
+    constructor(options) {
+        this.options = options;
+        propagation.setGlobalPropagator(new W3CTraceContextPropagator());
+        const forceTraceAll = typeof localStorage !== 'undefined' && localStorage.getItem(TRACE_ALL_KEY) === 'true';
+        this._tracerProvider = new WebTracerProvider({
+            resource: this.options.resource,
+            sampler: new ParentBasedSampler({
+                root: forceTraceAll ? new AlwaysOnSampler() : new TraceIdRatioBasedSampler(0.3),
+            }),
+            spanProcessors: [
+                new TagInjectorSpanProcessor(this.options.getTags),
+                new BatchSpanProcessor(new OTLPTraceExporter({
+                    url: resolveOtlpUrl(this.options.endpoint + '/v1/traces'),
+                    headers: this.options.headers,
+                    concurrencyLimit: 10,
+                }), { scheduledDelayMillis: 5_000 }),
+            ],
+        });
+        trace.setGlobalTracerProvider(this._tracerProvider);
+        this._tracer = trace.getTracer('dxos-observability', this.options.resource.attributes[ATTR_SERVICE_VERSION]?.toString());
+    }
+    /**
+     * Forcibly flush the BatchSpanProcessor. Call before process exit / page unload
+     * to avoid losing queued spans (which manifests as "Missing Span" in SigNoz —
+     * their already-exported children reference a parent that never made it to OTLP).
+     */
+    async flush() {
+        await this._tracerProvider.forceFlush();
+    }
+    /**
+     * Flush + shut down the tracer provider via `WebTracerProvider.shutdown()`,
+     * which forces a final export then terminates all span processors.
+     *
+     * Terminal and effectively one-shot: safe to call after `flush()`, but
+     * `flush()` MUST NOT be called after `close()` — shutdown stops further
+     * exporting, so subsequent `close()`/`flush()` calls resolve without
+     * emitting new spans.
+     */
+    async close() {
+        await this._tracerProvider.shutdown();
+    }
+    start() {
+        log('trace processor registered');
+        registerInstrumentations({
+            instrumentations: [
+                getWebAutoInstrumentations({
+                    '@opentelemetry/instrumentation-fetch': { enabled: false, ignoreUrls: [/api\.ipdata\.co/] },
+                    '@opentelemetry/instrumentation-document-load': { enabled: false },
+                    '@opentelemetry/instrumentation-xml-http-request': { enabled: false },
+                    '@opentelemetry/instrumentation-user-interaction': { enabled: false },
+                }),
+            ],
+        });
+        const tracer = this._tracer;
+        TRACE_PROCESSOR.tracingBackend = {
+            startSpan: (options) => {
+                log('begin otel trace', { options });
+                const parentCtx = options.parentContext
+                    ? propagation.extract(ROOT_CONTEXT, {
+                        traceparent: options.parentContext.traceparent,
+                        tracestate: options.parentContext.tracestate ?? '',
+                    })
+                    : otelContext.active();
+                const span = tracer.startSpan(options.name, options, parentCtx);
+                const sc = span.spanContext();
+                const spanContext = sc && sc.traceId && sc.spanId
+                    ? {
+                        traceparent: `00-${sc.traceId}-${sc.spanId}-${(sc.traceFlags ?? 0).toString(16).padStart(2, '0')}`,
+                        tracestate: sc.traceState?.serialize(),
+                    }
+                    : undefined;
+                return {
+                    end: (endTime) => span.end(endTime),
+                    setError: (err) => {
+                        if (err instanceof Error) {
+                            span.recordException(err);
+                        }
+                        span.setStatus({ code: SpanStatusCode.ERROR, message: err instanceof Error ? err.message : String(err) });
+                    },
+                    spanContext,
+                };
+            },
+        };
+    }
+}
+//# sourceMappingURL=traces-browser.js.map

package/dist/types/src/extensions/otel/traces-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traces-browser.js","sourceRoot":"","sources":["../../../../../src/extensions/otel/traces-browser.ts"],"names":[],"mappings":"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"}

package/dist/types/src/extensions/otel/traces.d.ts

@@ -0,0 +1,25 @@
+import { type OtelOptions } from './otel';
+export declare class OtelTraces {
+    private readonly options;
+    private _tracer;
+    private readonly _tracerProvider;
+    constructor(options: OtelOptions);
+    /**
+     * Forcibly flush the BatchSpanProcessor. Call before process exit to avoid
+     * losing queued spans (which manifests as "Missing Span" in SigNoz — their
+     * already-exported children reference a parent that never made it to OTLP).
+     */
+    flush(): Promise<void>;
+    /**
+     * Flush + shut down the tracer provider via `BasicTracerProvider.shutdown()`,
+     * which forces a final export then terminates all span processors.
+     *
+     * Terminal and effectively one-shot: safe to call after `flush()`, but
+     * `flush()` MUST NOT be called after `close()` — shutdown stops further
+     * exporting, so subsequent `close()`/`flush()` calls resolve without
+     * emitting new spans.
+     */
+    close(): Promise<void>;
+    start(): void;
+}
+//# sourceMappingURL=traces.d.ts.map

package/dist/types/src/extensions/otel/traces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traces.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/otel/traces.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,KAAK,WAAW,EAAkB,MAAM,QAAQ,CAAC;AAG1D,qBAAa,UAAU;IAIT,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsB;IAEtD,YAA6B,OAAO,EAAE,WAAW,EAsBhD;IAED;;;;OAIG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAElC;IAED;;;;;;;;OAQG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAElC;IAEM,KAAK,IAAI,IAAI,CAsCnB;CACF"}

package/dist/types/src/extensions/otel/traces.js

@@ -0,0 +1,88 @@
+//
+// Copyright 2024 DXOS.org
+//
+import { ROOT_CONTEXT, SpanStatusCode, context as otelContext, propagation, trace, } from '@opentelemetry/api';
+import { W3CTraceContextPropagator } from '@opentelemetry/core';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
+import { BasicTracerProvider, BatchSpanProcessor } from '@opentelemetry/sdk-trace-base';
+import { ATTR_SERVICE_VERSION } from '@opentelemetry/semantic-conventions';
+import { log } from '@dxos/log';
+import { TRACE_PROCESSOR } from '@dxos/tracing';
+import { resolveOtlpUrl } from './otel';
+import { TagInjectorSpanProcessor } from './span-processors';
+export class OtelTraces {
+    options;
+    _tracer;
+    _tracerProvider;
+    constructor(options) {
+        this.options = options;
+        propagation.setGlobalPropagator(new W3CTraceContextPropagator());
+        this._tracerProvider = new BasicTracerProvider({
+            resource: this.options.resource,
+            spanProcessors: [
+                new TagInjectorSpanProcessor(this.options.getTags),
+                new BatchSpanProcessor(new OTLPTraceExporter({
+                    url: resolveOtlpUrl(this.options.endpoint + '/v1/traces'),
+                    headers: this.options.headers,
+                    concurrencyLimit: 10,
+                })),
+            ],
+        });
+        trace.setGlobalTracerProvider(this._tracerProvider);
+        this._tracer = trace.getTracer('dxos-observability', this.options.resource.attributes[ATTR_SERVICE_VERSION]?.toString());
+    }
+    /**
+     * Forcibly flush the BatchSpanProcessor. Call before process exit to avoid
+     * losing queued spans (which manifests as "Missing Span" in SigNoz — their
+     * already-exported children reference a parent that never made it to OTLP).
+     */
+    async flush() {
+        await this._tracerProvider.forceFlush();
+    }
+    /**
+     * Flush + shut down the tracer provider via `BasicTracerProvider.shutdown()`,
+     * which forces a final export then terminates all span processors.
+     *
+     * Terminal and effectively one-shot: safe to call after `flush()`, but
+     * `flush()` MUST NOT be called after `close()` — shutdown stops further
+     * exporting, so subsequent `close()`/`flush()` calls resolve without
+     * emitting new spans.
+     */
+    async close() {
+        await this._tracerProvider.shutdown();
+    }
+    start() {
+        log('trace processor registered');
+        const tracer = this._tracer;
+        TRACE_PROCESSOR.tracingBackend = {
+            startSpan: (options) => {
+                log('begin otel trace', { options });
+                const parentCtx = options.parentContext
+                    ? propagation.extract(ROOT_CONTEXT, {
+                        traceparent: options.parentContext.traceparent,
+                        tracestate: options.parentContext.tracestate ?? '',
+                    })
+                    : otelContext.active();
+                const span = tracer.startSpan(options.name, options, parentCtx);
+                const sc = span.spanContext();
+                const spanContext = sc && sc.traceId && sc.spanId
+                    ? {
+                        traceparent: `00-${sc.traceId}-${sc.spanId}-${(sc.traceFlags ?? 0).toString(16).padStart(2, '0')}`,
+                        tracestate: sc.traceState?.serialize(),
+                    }
+                    : undefined;
+                return {
+                    end: (endTime) => span.end(endTime),
+                    setError: (err) => {
+                        if (err instanceof Error) {
+                            span.recordException(err);
+                        }
+                        span.setStatus({ code: SpanStatusCode.ERROR, message: err instanceof Error ? err.message : String(err) });
+                    },
+                    spanContext,
+                };
+            },
+        };
+    }
+}
+//# sourceMappingURL=traces.js.map

package/dist/types/src/extensions/otel/traces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traces.js","sourceRoot":"","sources":["../../../../../src/extensions/otel/traces.ts"],"names":[],"mappings":"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"}

package/dist/types/src/extensions/posthog/extension.d.ts

@@ -0,0 +1,28 @@
+import * as Effect from 'effect/Effect';
+import { type PostHogConfig } from 'posthog-js';
+import { type Config } from '@dxos/config';
+import { type IdbLogStore } from '@dxos/log-store-idb';
+import { type Extension } from '../../observability-extension';
+export type ExtensionsOptions = {
+    config: Config;
+    /** Release identifier, e.g. `composer@0.8.3`. */
+    release?: string;
+    /** Deployment environment, e.g. `production` or `staging`. */
+    environment?: string;
+    posthog?: Partial<PostHogConfig>;
+    /**
+     * Shared persistent log store for debug log dumps.
+     * The owning app is expected to register `logStore.processor` with `log` itself —
+     * this extension only consumes the buffered logs (via `export()`).
+     */
+    logStore?: IdbLogStore;
+    /**
+     * Maximum byte size passed to `logStore.export()` when uploading feedback logs.
+     * Should match the upload limit enforced by the server receiving the logs.
+     * When omitted the full store is exported without trimming.
+     */
+    feedbackLogMaxSize?: number;
+};
+/** Create a PostHog-backed observability extension for events, errors, and feedback. */
+export declare const extensions: (options: ExtensionsOptions) => Effect.Effect<Extension>;
+//# sourceMappingURL=extension.d.ts.map

package/dist/types/src/extensions/posthog/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/posthog/extension.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAG/D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACjC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAsBF,wFAAwF;AACxF,eAAO,MAAM,UAAU,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,MAAM,CAAC,MAAM,CAAC,SAAS,CAmI9E,CAAC"}