@syncular/observability-sentry 0.0.1 → 0.0.2-127

package/README.md

@@ -0,0 +1,28 @@
+# @syncular/observability-sentry
+
+Sentry adapter for Syncular telemetry (`SyncTelemetry`): logs, traces, metrics, and exceptions.
+
+## Install
+
+```bash
+npm install @syncular/observability-sentry
+```
+
+## Usage
+
+```ts
+import { createBrowserSentryTelemetry } from '@syncular/observability-sentry';
+
+const telemetry = createBrowserSentryTelemetry();
+```
+
+## Documentation
+
+- Observability guide: https://syncular.dev/docs/build/observability
+
+## Links
+
+- GitHub: https://github.com/syncular/syncular
+- Issues: https://github.com/syncular/syncular/issues
+
+> Status: Alpha. APIs and storage layouts may change between releases.

package/dist/browser.d.ts

@@ -1,6 +1,16 @@
 import * as Sentry from '@sentry/react';
-import { type SyncTelemetry } from '@syncular/core';
+import { type SyncTelemetry, type SyncTelemetryAttributeValue } from '@syncular/core';
 export type BrowserSentryInitOptions = Parameters<typeof Sentry.init>[0];
+export type BrowserSentryCaptureMessageLevel = Parameters<typeof Sentry.captureMessage>[1];
+interface BrowserSentryCaptureMessageOptions {
+    level?: BrowserSentryCaptureMessageLevel;
+    tags?: Record<string, string>;
+}
+type BrowserSentryLogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+interface BrowserSentryLogOptions {
+    level?: BrowserSentryLogLevel;
+    attributes?: Record<string, SyncTelemetryAttributeValue>;
+}
 /**
  * Create a Syncular telemetry backend wired to `@sentry/react`.
  */
@@ -13,4 +23,13 @@ export declare function configureBrowserSentryTelemetry(): SyncTelemetry;
  * Initialize browser Sentry and configure Syncular telemetry.
  */
 export declare function initAndConfigureBrowserSentry(options: BrowserSentryInitOptions): SyncTelemetry;
+/**
+ * Capture a browser message in Sentry with optional tags.
+ */
+export declare function captureBrowserSentryMessage(message: string, options?: BrowserSentryCaptureMessageOptions): void;
+/**
+ * Emit a browser Sentry log entry.
+ */
+export declare function logBrowserSentryMessage(message: string, options?: BrowserSentryLogOptions): void;
+export {};
 //# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AAGxB,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAsBzE;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,aAAa,CAkD5D;AAED;;GAEG;AACH,wBAAgB,+BAA+B,IAAI,aAAa,CAI/D;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,wBAAwB,GAChC,aAAa,CAGf"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,2BAA2B,EACjC,MAAM,gBAAgB,CAAC;AAGxB,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACzE,MAAM,MAAM,gCAAgC,GAAG,UAAU,CACvD,OAAO,MAAM,CAAC,cAAc,CAC7B,CAAC,CAAC,CAAC,CAAC;AAEL,UAAU,kCAAkC;IAC1C,KAAK,CAAC,EAAE,gCAAgC,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,KAAK,qBAAqB,GACtB,OAAO,GACP,OAAO,GACP,MAAM,GACN,MAAM,GACN,OAAO,GACP,OAAO,CAAC;AAEZ,UAAU,uBAAuB;IAC/B,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;CAC1D;AAqDD;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,aAAa,CAkD5D;AAED;;GAEG;AACH,wBAAgB,+BAA+B,IAAI,aAAa,CAI/D;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,wBAAwB,GAChC,aAAa,CAIf;AAuBD;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,kCAAkC,GAC3C,IAAI,CAYN;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,uBAAuB,GAChC,IAAI,CASN"}

package/dist/browser.js

@@ -1,6 +1,27 @@
 import * as Sentry from '@sentry/react';
 import { configureSyncTelemetry, } from '@syncular/core';
 import { createSentrySyncTelemetry } from './shared.js';
+function resolveBrowserLogMethod(level) {
+    switch (level) {
+        case 'trace':
+            return Sentry.logger.trace ?? Sentry.logger.debug ?? Sentry.logger.info;
+        case 'debug':
+            return Sentry.logger.debug ?? Sentry.logger.info;
+        case 'info':
+            return Sentry.logger.info;
+        case 'warn':
+            return Sentry.logger.warn ?? Sentry.logger.info;
+        case 'error':
+            return Sentry.logger.error ?? Sentry.logger.warn ?? Sentry.logger.info;
+        case 'fatal':
+            return (Sentry.logger.fatal ??
+                Sentry.logger.error ??
+                Sentry.logger.warn ??
+                Sentry.logger.info);
+        default:
+            return Sentry.logger.info;
+    }
+}
 function toCountMetricOptions(options) {
     if (!options?.attributes)
         return undefined;
@@ -82,7 +103,53 @@ export function configureBrowserSentryTelemetry() {
  * Initialize browser Sentry and configure Syncular telemetry.
  */
 export function initAndConfigureBrowserSentry(options) {
-    Sentry.init(options);
+    const configuredOptions = ensureBrowserTracingIntegration(options);
+    Sentry.init(configuredOptions);
     return configureBrowserSentryTelemetry();
 }
+function ensureBrowserTracingIntegration(options) {
+    const integrations = options.integrations;
+    if (typeof integrations === 'function')
+        return options;
+    const configuredIntegrations = integrations ?? [];
+    const hasBrowserTracing = configuredIntegrations.some((integration) => integration.name === 'BrowserTracing');
+    if (hasBrowserTracing)
+        return options;
+    return {
+        ...options,
+        integrations: [
+            Sentry.browserTracingIntegration(),
+            ...configuredIntegrations,
+        ],
+    };
+}
+/**
+ * Capture a browser message in Sentry with optional tags.
+ */
+export function captureBrowserSentryMessage(message, options) {
+    if (!options?.tags || Object.keys(options.tags).length === 0) {
+        Sentry.captureMessage(message, options?.level);
+        return;
+    }
+    Sentry.withScope((scope) => {
+        for (const [name, value] of Object.entries(options.tags ?? {})) {
+            scope.setTag(name, value);
+        }
+        Sentry.captureMessage(message, options?.level);
+    });
+}
+/**
+ * Emit a browser Sentry log entry.
+ */
+export function logBrowserSentryMessage(message, options) {
+    const level = options?.level ?? 'info';
+    const logMethod = resolveBrowserLogMethod(level);
+    if (!logMethod)
+        return;
+    if (!options?.attributes || Object.keys(options.attributes).length === 0) {
+        logMethod(message);
+        return;
+    }
+    logMethod(message, options.attributes);
+}
 //# sourceMappingURL=browser.js.map

package/dist/browser.js.map

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

package/dist/cloudflare.d.ts

@@ -1,9 +1,32 @@
 import * as Sentry from '@sentry/cloudflare';
-import { type SyncTelemetry } from '@syncular/core';
+import { type SyncTelemetry, type SyncTelemetryAttributeValue } from '@syncular/core';
+export type CloudflareSentryCaptureMessageLevel = Parameters<typeof Sentry.captureMessage>[1];
+interface CloudflareSentryCaptureMessageOptions {
+    level?: CloudflareSentryCaptureMessageLevel;
+    tags?: Record<string, string>;
+}
+type CloudflareSentryLogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+interface CloudflareSentryLogOptions {
+    level?: CloudflareSentryLogLevel;
+    attributes?: Record<string, SyncTelemetryAttributeValue>;
+}
 /**
  * Re-export Cloudflare Sentry worker wrapper.
  */
 export declare const withCloudflareSentry: typeof Sentry.withSentry;
+export declare const instrumentCloudflareDurableObjectWithSentry: typeof Sentry.instrumentDurableObjectWithSentry;
+export interface CloudflareSentryTraceHeaders {
+    sentryTrace?: string;
+    baggage?: string;
+}
+/**
+ * Read current trace headers from the active Cloudflare Sentry scope.
+ */
+export declare function getCloudflareSentryTraceHeaders(traceData?: ReturnType<typeof Sentry.getTraceData>): CloudflareSentryTraceHeaders;
+/**
+ * Clone a request and attach active Cloudflare trace headers when available.
+ */
+export declare function attachCloudflareSentryTraceHeaders(request: Request, traceHeaders?: CloudflareSentryTraceHeaders): Request;
 /**
  * Create a Syncular telemetry backend wired to `@sentry/cloudflare`.
  */
@@ -12,4 +35,13 @@ export declare function createCloudflareSentryTelemetry(): SyncTelemetry;
  * Configure Syncular core telemetry to use the Cloudflare Sentry adapter.
  */
 export declare function configureCloudflareSentryTelemetry(): SyncTelemetry;
+/**
+ * Capture a worker message in Sentry with optional tags.
+ */
+export declare function captureCloudflareSentryMessage(message: string, options?: CloudflareSentryCaptureMessageOptions): void;
+/**
+ * Emit a Cloudflare Sentry log entry.
+ */
+export declare function logCloudflareSentryMessage(message: string, options?: CloudflareSentryLogOptions): void;
+export {};
 //# sourceMappingURL=cloudflare.d.ts.map

package/dist/cloudflare.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../src/cloudflare.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AAuBxB;;GAEG;AACH,eAAO,MAAM,oBAAoB,0BAAoB,CAAC;AAEtD;;GAEG;AACH,wBAAgB,+BAA+B,IAAI,aAAa,CAkD/D;AAED;;GAEG;AACH,wBAAgB,kCAAkC,IAAI,aAAa,CAIlE"}
+{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../src/cloudflare.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,2BAA2B,EACjC,MAAM,gBAAgB,CAAC;AAuBxB,MAAM,MAAM,mCAAmC,GAAG,UAAU,CAC1D,OAAO,MAAM,CAAC,cAAc,CAC7B,CAAC,CAAC,CAAC,CAAC;AAEL,UAAU,qCAAqC;IAC7C,KAAK,CAAC,EAAE,mCAAmC,CAAC;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,KAAK,wBAAwB,GACzB,OAAO,GACP,OAAO,GACP,MAAM,GACN,MAAM,GACN,OAAO,GACP,OAAO,CAAC;AAEZ,UAAU,0BAA0B;IAClC,KAAK,CAAC,EAAE,wBAAwB,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;CAC1D;AAiCD;;GAEG;AACH,eAAO,MAAM,oBAAoB,0BAAoB,CAAC;AACtD,eAAO,MAAM,2CAA2C,iDACd,CAAC;AAE3C,MAAM,WAAW,4BAA4B;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,GAAE,UAAU,CAAC,OAAO,MAAM,CAAC,YAAY,CAAyB,GACxE,4BAA4B,CAO9B;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,OAAO,EAChB,YAAY,GAAE,4BAAgE,GAC7E,OAAO,CAcT;AAED;;GAEG;AACH,wBAAgB,+BAA+B,IAAI,aAAa,CAkD/D;AAED;;GAEG;AACH,wBAAgB,kCAAkC,IAAI,aAAa,CAIlE;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,qCAAqC,GAC9C,IAAI,CAYN;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,0BAA0B,GACnC,IAAI,CASN"}

package/dist/cloudflare.js

@@ -18,10 +18,59 @@ function toValueMetricOptions(options) {
         unit: options.unit,
     };
 }
+function resolveCloudflareLogMethod(level) {
+    switch (level) {
+        case 'trace':
+            return Sentry.logger.trace ?? Sentry.logger.debug ?? Sentry.logger.info;
+        case 'debug':
+            return Sentry.logger.debug ?? Sentry.logger.info;
+        case 'info':
+            return Sentry.logger.info;
+        case 'warn':
+            return Sentry.logger.warn ?? Sentry.logger.info;
+        case 'error':
+            return Sentry.logger.error ?? Sentry.logger.warn ?? Sentry.logger.info;
+        case 'fatal':
+            return (Sentry.logger.fatal ??
+                Sentry.logger.error ??
+                Sentry.logger.warn ??
+                Sentry.logger.info);
+        default:
+            return Sentry.logger.info;
+    }
+}
 /**
  * Re-export Cloudflare Sentry worker wrapper.
  */
 export const withCloudflareSentry = Sentry.withSentry;
+export const instrumentCloudflareDurableObjectWithSentry = Sentry.instrumentDurableObjectWithSentry;
+/**
+ * Read current trace headers from the active Cloudflare Sentry scope.
+ */
+export function getCloudflareSentryTraceHeaders(traceData = Sentry.getTraceData()) {
+    const sentryTrace = traceData['sentry-trace']?.trim();
+    const baggage = traceData.baggage?.trim();
+    return {
+        ...(sentryTrace ? { sentryTrace } : {}),
+        ...(baggage ? { baggage } : {}),
+    };
+}
+/**
+ * Clone a request and attach active Cloudflare trace headers when available.
+ */
+export function attachCloudflareSentryTraceHeaders(request, traceHeaders = getCloudflareSentryTraceHeaders()) {
+    if (!traceHeaders.sentryTrace && !traceHeaders.baggage) {
+        return request;
+    }
+    const headers = new Headers(request.headers);
+    if (traceHeaders.sentryTrace) {
+        headers.set('sentry-trace', traceHeaders.sentryTrace);
+    }
+    if (traceHeaders.baggage) {
+        headers.set('baggage', traceHeaders.baggage);
+    }
+    return new Request(request, { headers });
+}
 /**
  * Create a Syncular telemetry backend wired to `@sentry/cloudflare`.
  */
@@ -82,4 +131,33 @@ export function configureCloudflareSentryTelemetry() {
     configureSyncTelemetry(telemetry);
     return telemetry;
 }
+/**
+ * Capture a worker message in Sentry with optional tags.
+ */
+export function captureCloudflareSentryMessage(message, options) {
+    if (!options?.tags || Object.keys(options.tags).length === 0) {
+        Sentry.captureMessage(message, options?.level);
+        return;
+    }
+    Sentry.withScope((scope) => {
+        for (const [name, value] of Object.entries(options.tags ?? {})) {
+            scope.setTag(name, value);
+        }
+        Sentry.captureMessage(message, options?.level);
+    });
+}
+/**
+ * Emit a Cloudflare Sentry log entry.
+ */
+export function logCloudflareSentryMessage(message, options) {
+    const level = options?.level ?? 'info';
+    const logMethod = resolveCloudflareLogMethod(level);
+    if (!logMethod)
+        return;
+    if (!options?.attributes || Object.keys(options.attributes).length === 0) {
+        logMethod(message);
+        return;
+    }
+    logMethod(message, options.attributes);
+}
 //# sourceMappingURL=cloudflare.js.map

package/dist/cloudflare.js.map

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

package/dist/shared.d.ts

@@ -1,4 +1,4 @@
-import type { SyncMetricOptions, SyncSpanOptions, SyncTelemetry, SyncTelemetryAttributeValue, SyncTelemetryAttributes } from '@syncular/core';
+import type { SyncMetricOptions, SyncSpanOptions, SyncTelemetry, SyncTelemetryAttributes, SyncTelemetryAttributeValue } from '@syncular/core';
 interface SentryLoggerAdapter {
     trace?(message: string, attributes?: Record<string, unknown>): void;
     debug?(message: string, attributes?: Record<string, unknown>): void;

package/dist/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EAGjB,eAAe,EACf,aAAa,EACb,2BAA2B,EAC3B,uBAAuB,EAIxB,MAAM,gBAAgB,CAAC;AAExB,UAAU,mBAAmB;IAC3B,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACpE,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACpE,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACnE,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACnE,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACpE,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACrE;AAED,UAAU,iBAAiB;IACzB,YAAY,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,2BAA2B,GAAG,IAAI,CAAC;IACtE,aAAa,CAAC,CAAC,UAAU,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC1D,SAAS,CAAC,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;CACnD;AAED,UAAU,oBAAoB;IAC5B,KAAK,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACvE,KAAK,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACvE,YAAY,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAC/E;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,SAAS,CAAC,CAAC,CAAC,EACV,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,CAAC,GACvC,CAAC,CAAC;IACL,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,gBAAgB,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CACzC;AAgFD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,sBAAsB,GAC9B,aAAa,CAyBf"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EAGjB,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,2BAA2B,EAI5B,MAAM,gBAAgB,CAAC;AAExB,UAAU,mBAAmB;IAC3B,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACpE,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACpE,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACnE,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACnE,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACpE,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACrE;AAED,UAAU,iBAAiB;IACzB,YAAY,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,2BAA2B,GAAG,IAAI,CAAC;IACtE,aAAa,CAAC,CAAC,UAAU,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC1D,SAAS,CAAC,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;CACnD;AAED,UAAU,oBAAoB;IAC5B,KAAK,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACvE,KAAK,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACvE,YAAY,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAC/E;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,SAAS,CAAC,CAAC,CAAC,EACV,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,CAAC,GACvC,CAAC,CAAC;IACL,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,gBAAgB,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CACzC;AAyHD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,sBAAsB,GAC9B,aAAa,CA+Bf"}

package/dist/shared.js

@@ -47,6 +47,44 @@ function toSpan(span) {
         },
     };
 }
+function toLogAttributeValue(value) {
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number') {
+        return Number.isFinite(value) ? value : undefined;
+    }
+    if (typeof value === 'boolean')
+        return value;
+    if (typeof value === 'bigint') {
+        const asNumber = Number(value);
+        if (Number.isFinite(asNumber))
+            return asNumber;
+        return value.toString();
+    }
+    if (value instanceof Date)
+        return value.toISOString();
+    if (value === null || value === undefined)
+        return undefined;
+    if (Array.isArray(value) || typeof value === 'object') {
+        try {
+            return JSON.stringify(value);
+        }
+        catch {
+            return String(value);
+        }
+    }
+    return String(value);
+}
+function sanitizeLogAttributes(attributes) {
+    const sanitized = {};
+    for (const [name, value] of Object.entries(attributes)) {
+        const normalized = toLogAttributeValue(value);
+        if (normalized !== undefined) {
+            sanitized[name] = normalized;
+        }
+    }
+    return Object.keys(sanitized).length > 0 ? sanitized : null;
+}
 function createTracer(adapter) {
     return {
         startSpan(options, callback) {
@@ -80,11 +118,12 @@ export function createSentrySyncTelemetry(adapter) {
             const logMethod = resolveLogMethod(adapter.logger, level);
             if (!logMethod)
                 return;
-            if (Object.keys(attributes).length === 0) {
+            const sanitizedAttributes = sanitizeLogAttributes(attributes);
+            if (!sanitizedAttributes) {
                 logMethod(message);
                 return;
             }
-            logMethod(message, attributes);
+            logMethod(message, sanitizedAttributes);
         },
         tracer: createTracer(adapter),
         metrics: createMetrics(adapter),
@@ -96,7 +135,12 @@ export function createSentrySyncTelemetry(adapter) {
                 resolveLogMethod(adapter.logger, 'info');
             if (!logMethod)
                 return;
-            logMethod('sync.exception.context', context);
+            const sanitizedContext = sanitizeLogAttributes(context);
+            if (!sanitizedContext) {
+                logMethod('sync.exception.context');
+                return;
+            }
+            logMethod('sync.exception.context', sanitizedContext);
         },
     };
 }

package/dist/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AA4CA,MAAM,QAAQ,GAAa;IACzB,YAAY,GAAG,EAAC,CAAC;IACjB,aAAa,GAAG,EAAC,CAAC;IAClB,SAAS,GAAG,EAAC,CAAC;CACf,CAAC;AAEF,SAAS,eAAe,CAAC,KAAyB,EAAsB;IACtE,IAAI,KAAK,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC;IACpC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;AAAA,CACvC;AAED,SAAS,gBAAgB,CACvB,MAAuC,EACvC,KAAyB,EACiD;IAC1E,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,OAAO;YACV,OAAO,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC;QAC7D,KAAK,OAAO;YACV,OAAO,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC;QAC7C,KAAK,MAAM;YACT,OAAO,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC;QAC7B,KAAK,MAAM;YACT,OAAO,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC;QAC5C,KAAK,OAAO;YACV,OAAO,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC;QAC5D,KAAK,OAAO;YACV,OAAO,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC;QAC5E;YACE,OAAO,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC;IAC/B,CAAC;AAAA,CACF;AAED,SAAS,MAAM,CAAC,IAAuB,EAAY;IACjD,OAAO;QACL,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE;YACxB,IAAI,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAAA,CAClC;QACD,aAAa,CAAC,UAAU,EAAE;YACxB,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACvB,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;gBAC/B,OAAO;YACT,CAAC;YAED,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;gBACtD,IAAI,CAAC,YAAY,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAClC,CAAC;QAAA,CACF;QACD,SAAS,CAAC,MAAM,EAAE;YAChB,IAAI,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,CAAC;QAAA,CAC1B;KACF,CAAC;AAAA,CACH;AAED,SAAS,YAAY,CAAC,OAA+B,EAAc;IACjE,OAAO;QACL,SAAS,CAAI,OAAwB,EAAE,QAA+B,EAAK;YACzE,IAAI,CAAC,OAAO,CAAC,SAAS;gBAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAClD,OAAO,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAAA,CACrE;KACF,CAAC;AAAA,CACH;AAED,SAAS,aAAa,CAAC,OAA+B,EAAe;IACnE,OAAO;QACL,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE;YAC1B,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QAAA,CACrD;QACD,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE;YAC1B,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAAA,CAChD;QACD,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE;YACjC,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAAA,CACvD;KACF,CAAC;AAAA,CACH;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAA+B,EAChB;IACf,OAAO;QACL,GAAG,CAAC,KAAK,EAAE;YACT,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;YACrC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,UAAU,EAAE,GAAG,KAAK,CAAC;YAChD,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC1D,IAAI,CAAC,SAAS;gBAAE,OAAO;YACvB,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzC,SAAS,CAAC,OAAO,CAAC,CAAC;gBACnB,OAAO;YACT,CAAC;YACD,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAAA,CAChC;QACD,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC;QAC7B,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC;QAC/B,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE;YAC/B,OAAO,CAAC,gBAAgB,EAAE,CAAC,KAAK,CAAC,CAAC;YAClC,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,MAAM,SAAS,GACb,gBAAgB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;gBACzC,gBAAgB,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC3C,IAAI,CAAC,SAAS;gBAAE,OAAO;YACvB,SAAS,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAC;QAAA,CAC9C;KACF,CAAC;AAAA,CACH"}
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncular/observability-sentry",
-  "version": "0.0.1",
+  "version": "0.0.2-127",
   "description": "Sentry adapters for Syncular telemetry",
   "license": "MIT",
   "author": "Benjamin Kniffler",
@@ -43,7 +43,7 @@
   "dependencies": {
     "@sentry/cloudflare": "^10.38.0",
     "@sentry/react": "^10.38.0",
-    "@syncular/core": "0.0.1"
+    "@syncular/core": "0.0.2-127"
   },
   "devDependencies": {
     "@syncular/config": "0.0.0"

package/src/browser.ts

@@ -3,6 +3,7 @@ import {
   configureSyncTelemetry,
   type SyncMetricOptions,
   type SyncTelemetry,
+  type SyncTelemetryAttributeValue,
 } from '@syncular/core';
 import { createSentrySyncTelemetry } from './shared';
 
@@ -16,6 +17,50 @@ interface BrowserSentryCaptureMessageOptions {
   tags?: Record<string, string>;
 }
 
+type BrowserSentryLogLevel =
+  | 'trace'
+  | 'debug'
+  | 'info'
+  | 'warn'
+  | 'error'
+  | 'fatal';
+
+interface BrowserSentryLogOptions {
+  level?: BrowserSentryLogLevel;
+  attributes?: Record<string, SyncTelemetryAttributeValue>;
+}
+
+function resolveBrowserLogMethod(
+  level: BrowserSentryLogLevel
+):
+  | ((
+      message: string,
+      attributes?: Record<string, SyncTelemetryAttributeValue>
+    ) => void)
+  | null {
+  switch (level) {
+    case 'trace':
+      return Sentry.logger.trace ?? Sentry.logger.debug ?? Sentry.logger.info;
+    case 'debug':
+      return Sentry.logger.debug ?? Sentry.logger.info;
+    case 'info':
+      return Sentry.logger.info;
+    case 'warn':
+      return Sentry.logger.warn ?? Sentry.logger.info;
+    case 'error':
+      return Sentry.logger.error ?? Sentry.logger.warn ?? Sentry.logger.info;
+    case 'fatal':
+      return (
+        Sentry.logger.fatal ??
+        Sentry.logger.error ??
+        Sentry.logger.warn ??
+        Sentry.logger.info
+      );
+    default:
+      return Sentry.logger.info;
+  }
+}
+
 function toCountMetricOptions(
   options?: SyncMetricOptions
 ): Parameters<typeof Sentry.metrics.count>[2] | undefined {
@@ -106,10 +151,32 @@ export function configureBrowserSentryTelemetry(): SyncTelemetry {
 export function initAndConfigureBrowserSentry(
   options: BrowserSentryInitOptions
 ): SyncTelemetry {
-  Sentry.init(options);
+  const configuredOptions = ensureBrowserTracingIntegration(options);
+  Sentry.init(configuredOptions);
   return configureBrowserSentryTelemetry();
 }
 
+function ensureBrowserTracingIntegration(
+  options: BrowserSentryInitOptions
+): BrowserSentryInitOptions {
+  const integrations = options.integrations;
+  if (typeof integrations === 'function') return options;
+
+  const configuredIntegrations = integrations ?? [];
+  const hasBrowserTracing = configuredIntegrations.some(
+    (integration) => integration.name === 'BrowserTracing'
+  );
+  if (hasBrowserTracing) return options;
+
+  return {
+    ...options,
+    integrations: [
+      Sentry.browserTracingIntegration(),
+      ...configuredIntegrations,
+    ],
+  };
+}
+
 /**
  * Capture a browser message in Sentry with optional tags.
  */
@@ -129,3 +196,20 @@ export function captureBrowserSentryMessage(
     Sentry.captureMessage(message, options?.level);
   });
 }
+
+/**
+ * Emit a browser Sentry log entry.
+ */
+export function logBrowserSentryMessage(
+  message: string,
+  options?: BrowserSentryLogOptions
+): void {
+  const level = options?.level ?? 'info';
+  const logMethod = resolveBrowserLogMethod(level);
+  if (!logMethod) return;
+  if (!options?.attributes || Object.keys(options.attributes).length === 0) {
+    logMethod(message);
+    return;
+  }
+  logMethod(message, options.attributes);
+}

package/src/cloudflare.test.ts

@@ -0,0 +1,49 @@
+import { describe, expect, test } from 'bun:test';
+import {
+  attachCloudflareSentryTraceHeaders,
+  getCloudflareSentryTraceHeaders,
+} from './cloudflare';
+
+describe('cloudflare tracing helpers', () => {
+  test('extracts trace headers from sentry trace data', () => {
+    expect(
+      getCloudflareSentryTraceHeaders({
+        'sentry-trace': 'trace-id-span-id-1',
+        baggage: 'sample_rate=1',
+      })
+    ).toEqual({
+      sentryTrace: 'trace-id-span-id-1',
+      baggage: 'sample_rate=1',
+    });
+  });
+
+  test('returns original request when trace headers are missing', () => {
+    const request = new Request('https://example.com/api/sync', {
+      method: 'POST',
+      headers: { 'x-custom': '1' },
+      body: '{}',
+    });
+
+    const result = attachCloudflareSentryTraceHeaders(request, {});
+    expect(result).toBe(request);
+  });
+
+  test('adds sentry trace headers to cloned request', async () => {
+    const request = new Request('https://example.com/api/sync', {
+      method: 'POST',
+      headers: { 'x-custom': '1' },
+      body: '{"ok":true}',
+    });
+
+    const result = attachCloudflareSentryTraceHeaders(request, {
+      sentryTrace: 'trace-id-span-id-1',
+      baggage: 'sample_rate=1',
+    });
+
+    expect(result).not.toBe(request);
+    expect(result.headers.get('x-custom')).toBe('1');
+    expect(result.headers.get('sentry-trace')).toBe('trace-id-span-id-1');
+    expect(result.headers.get('baggage')).toBe('sample_rate=1');
+    expect(await result.text()).toBe('{"ok":true}');
+  });
+});

package/src/cloudflare.ts

@@ -3,6 +3,7 @@ import {
   configureSyncTelemetry,
   type SyncMetricOptions,
   type SyncTelemetry,
+  type SyncTelemetryAttributeValue,
 } from '@syncular/core';
 import { createSentrySyncTelemetry } from './shared';
 
@@ -35,10 +36,97 @@ interface CloudflareSentryCaptureMessageOptions {
   tags?: Record<string, string>;
 }
 
+type CloudflareSentryLogLevel =
+  | 'trace'
+  | 'debug'
+  | 'info'
+  | 'warn'
+  | 'error'
+  | 'fatal';
+
+interface CloudflareSentryLogOptions {
+  level?: CloudflareSentryLogLevel;
+  attributes?: Record<string, SyncTelemetryAttributeValue>;
+}
+
+function resolveCloudflareLogMethod(
+  level: CloudflareSentryLogLevel
+):
+  | ((
+      message: string,
+      attributes?: Record<string, SyncTelemetryAttributeValue>
+    ) => void)
+  | null {
+  switch (level) {
+    case 'trace':
+      return Sentry.logger.trace ?? Sentry.logger.debug ?? Sentry.logger.info;
+    case 'debug':
+      return Sentry.logger.debug ?? Sentry.logger.info;
+    case 'info':
+      return Sentry.logger.info;
+    case 'warn':
+      return Sentry.logger.warn ?? Sentry.logger.info;
+    case 'error':
+      return Sentry.logger.error ?? Sentry.logger.warn ?? Sentry.logger.info;
+    case 'fatal':
+      return (
+        Sentry.logger.fatal ??
+        Sentry.logger.error ??
+        Sentry.logger.warn ??
+        Sentry.logger.info
+      );
+    default:
+      return Sentry.logger.info;
+  }
+}
+
 /**
  * Re-export Cloudflare Sentry worker wrapper.
  */
 export const withCloudflareSentry = Sentry.withSentry;
+export const instrumentCloudflareDurableObjectWithSentry =
+  Sentry.instrumentDurableObjectWithSentry;
+
+export interface CloudflareSentryTraceHeaders {
+  sentryTrace?: string;
+  baggage?: string;
+}
+
+/**
+ * Read current trace headers from the active Cloudflare Sentry scope.
+ */
+export function getCloudflareSentryTraceHeaders(
+  traceData: ReturnType<typeof Sentry.getTraceData> = Sentry.getTraceData()
+): CloudflareSentryTraceHeaders {
+  const sentryTrace = traceData['sentry-trace']?.trim();
+  const baggage = traceData.baggage?.trim();
+  return {
+    ...(sentryTrace ? { sentryTrace } : {}),
+    ...(baggage ? { baggage } : {}),
+  };
+}
+
+/**
+ * Clone a request and attach active Cloudflare trace headers when available.
+ */
+export function attachCloudflareSentryTraceHeaders(
+  request: Request,
+  traceHeaders: CloudflareSentryTraceHeaders = getCloudflareSentryTraceHeaders()
+): Request {
+  if (!traceHeaders.sentryTrace && !traceHeaders.baggage) {
+    return request;
+  }
+
+  const headers = new Headers(request.headers);
+  if (traceHeaders.sentryTrace) {
+    headers.set('sentry-trace', traceHeaders.sentryTrace);
+  }
+  if (traceHeaders.baggage) {
+    headers.set('baggage', traceHeaders.baggage);
+  }
+
+  return new Request(request, { headers });
+}
 
 /**
  * Create a Syncular telemetry backend wired to `@sentry/cloudflare`.
@@ -123,3 +211,20 @@ export function captureCloudflareSentryMessage(
     Sentry.captureMessage(message, options?.level);
   });
 }
+
+/**
+ * Emit a Cloudflare Sentry log entry.
+ */
+export function logCloudflareSentryMessage(
+  message: string,
+  options?: CloudflareSentryLogOptions
+): void {
+  const level = options?.level ?? 'info';
+  const logMethod = resolveCloudflareLogMethod(level);
+  if (!logMethod) return;
+  if (!options?.attributes || Object.keys(options.attributes).length === 0) {
+    logMethod(message);
+    return;
+  }
+  logMethod(message, options.attributes);
+}

package/src/shared.test.ts

@@ -101,4 +101,45 @@ describe('createSentrySyncTelemetry', () => {
       attributes: { requestId: 'r1' },
     });
   });
+
+  test('sanitizes non-primitive log attributes', () => {
+    const logs: Array<{
+      level: string;
+      message: string;
+      attributes?: Record<string, unknown>;
+    }> = [];
+
+    const telemetry = createSentrySyncTelemetry({
+      logger: {
+        info(message, attributes) {
+          logs.push({ level: 'info', message, attributes });
+        },
+      },
+    });
+
+    telemetry.log({
+      event: 'sync.attributes',
+      id: 'abc',
+      nested: { ok: true },
+      values: [1, 2, 3],
+      enabled: true,
+      count: 3,
+      ignored: undefined,
+      nonFinite: Number.POSITIVE_INFINITY,
+    });
+
+    expect(logs).toEqual([
+      {
+        level: 'info',
+        message: 'sync.attributes',
+        attributes: {
+          id: 'abc',
+          nested: '{"ok":true}',
+          values: '[1,2,3]',
+          enabled: true,
+          count: 3,
+        },
+      },
+    ]);
+  });
 });

package/src/shared.ts

@@ -97,6 +97,47 @@ function toSpan(span: SentrySpanAdapter): SyncSpan {
   };
 }
 
+function toLogAttributeValue(
+  value: unknown
+): SyncTelemetryAttributeValue | undefined {
+  if (typeof value === 'string') return value;
+  if (typeof value === 'number') {
+    return Number.isFinite(value) ? value : undefined;
+  }
+  if (typeof value === 'boolean') return value;
+  if (typeof value === 'bigint') {
+    const asNumber = Number(value);
+    if (Number.isFinite(asNumber)) return asNumber;
+    return value.toString();
+  }
+  if (value instanceof Date) return value.toISOString();
+  if (value === null || value === undefined) return undefined;
+
+  if (Array.isArray(value) || typeof value === 'object') {
+    try {
+      return JSON.stringify(value);
+    } catch {
+      return String(value);
+    }
+  }
+
+  return String(value);
+}
+
+function sanitizeLogAttributes(
+  attributes: Record<string, unknown>
+): Record<string, SyncTelemetryAttributeValue> | null {
+  const sanitized: Record<string, SyncTelemetryAttributeValue> = {};
+  for (const [name, value] of Object.entries(attributes)) {
+    const normalized = toLogAttributeValue(value);
+    if (normalized !== undefined) {
+      sanitized[name] = normalized;
+    }
+  }
+
+  return Object.keys(sanitized).length > 0 ? sanitized : null;
+}
+
 function createTracer(adapter: SentryTelemetryAdapter): SyncTracer {
   return {
     startSpan<T>(options: SyncSpanOptions, callback: (span: SyncSpan) => T): T {
@@ -132,11 +173,12 @@ export function createSentrySyncTelemetry(
       const { event: message, ...attributes } = event;
       const logMethod = resolveLogMethod(adapter.logger, level);
       if (!logMethod) return;
-      if (Object.keys(attributes).length === 0) {
+      const sanitizedAttributes = sanitizeLogAttributes(attributes);
+      if (!sanitizedAttributes) {
         logMethod(message);
         return;
       }
-      logMethod(message, attributes);
+      logMethod(message, sanitizedAttributes);
     },
     tracer: createTracer(adapter),
     metrics: createMetrics(adapter),
@@ -147,7 +189,12 @@ export function createSentrySyncTelemetry(
         resolveLogMethod(adapter.logger, 'error') ??
         resolveLogMethod(adapter.logger, 'info');
       if (!logMethod) return;
-      logMethod('sync.exception.context', context);
+      const sanitizedContext = sanitizeLogAttributes(context);
+      if (!sanitizedContext) {
+        logMethod('sync.exception.context');
+        return;
+      }
+      logMethod('sync.exception.context', sanitizedContext);
     },
   };
 }