@genn-inc/cluebase-frontend-sdk 0.0.3 → 0.0.8

package/dist/instrumentation/performance.js

@@ -91,8 +91,7 @@ const observeEntryType = (observers, entryType, callback) => {
         observer.observe({ type: entryType, buffered: true });
         observers.push(observer);
     }
-    catch {
-    }
+    catch { }
 };
 const readPerformanceNavigation = () => {
     if (typeof performance === "undefined") {

package/dist/internal/internal-log.js

@@ -26,7 +26,8 @@ export function logSwallowed(operation, _cause, context = {}) {
     const details = {};
     for (const [key, value] of Object.entries(context)) {
         if (SAFE_CONTEXT_KEYS.has(key) &&
-            (value === null || typeof value === "boolean" ||
+            (value === null ||
+                typeof value === "boolean" ||
                 (typeof value === "number" && Number.isFinite(value)) ||
                 (typeof value === "string" && SAFE_TOKEN.test(value)))) {
             details[key] = value;

package/dist/provider/_version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION: "0.0.3";
+export declare const SDK_VERSION: "0.0.8";

package/dist/provider/_version.js

@@ -1,3 +1,3 @@
 // This file is generated by scripts/generate-version-module.mjs.
 // Do NOT edit by hand. The source of truth is `package.json` `version`.
-export const SDK_VERSION = "0.0.3";
+export const SDK_VERSION = "0.0.8";

package/dist/provider/config.js

@@ -1,3 +1,4 @@
+import { CANONICAL_BROWSER_INGEST_PATH, CLUEBASE_API_V1_PREFIX, } from "../_generated/ingest-routes.js";
 import { ALWAYS_DENIED_KEYS, DEFAULT_API_BASE_URL, DEFAULT_CONFIG, DEFAULT_FRONTEND_SOURCE_IDENTIFIER, MAX_DIAGNOSTIC_TTL_MS, } from "./constants.js";
 import { SDK_COLLECTION_MODE } from "./contracts.js";
 const normalizeKeyList = (keys) => {
@@ -74,6 +75,12 @@ export const parseSendableUrl = (value) => {
         return null;
     }
 };
+const isExtendableIngestPath = (pathname) => {
+    const path = pathname.endsWith("/") ? pathname.slice(0, -1) : pathname;
+    return (path === "" ||
+        path.endsWith(CLUEBASE_API_V1_PREFIX) ||
+        path.endsWith(CANONICAL_BROWSER_INGEST_PATH));
+};
 const normalizeConfiguredEndpoint = (value) => parseSendableUrl(value)?.toString() ?? "";
 const normalizeTracePropagationOrigin = (value) => {
     const trimmed = value.trim();
@@ -101,10 +108,8 @@ export const resolveConfig = (options) => {
     return {
         endpoint: originalEndpoint,
         originalEndpoint,
-        localSetupCheckEndpoint: null,
         projectKey: options.projectKey?.trim() ?? "",
         producerId: DEFAULT_FRONTEND_SOURCE_IDENTIFIER,
-        transportProfile: DEFAULT_CONFIG.transportProfile,
         autocapture: options.autocapture ?? DEFAULT_CONFIG.autocapture,
         captureNetwork: options.captureNetwork ?? DEFAULT_CONFIG.captureNetwork,
         captureErrors: options.captureErrors ?? DEFAULT_CONFIG.captureErrors,
@@ -139,8 +144,15 @@ export const resolveConfig = (options) => {
 };
 export const validateConfig = (config) => {
     const issues = [];
-    if (!config.endpoint) {
-        issues.push("endpoint is required");
+    const endpoint = parseSendableUrl(config.endpoint);
+    if (!endpoint) {
+        issues.push("endpoint must be an absolute http(s) url with a host, such as https://api.cluebase.io");
+    }
+    else if (endpoint.search || endpoint.hash) {
+        issues.push("endpoint must not carry a query string or fragment; pass the api base url only");
+    }
+    else if (!isExtendableIngestPath(endpoint.pathname)) {
+        issues.push(`endpoint path cannot be extended to ${CANONICAL_BROWSER_INGEST_PATH}; pass the api base url, the ${CLUEBASE_API_V1_PREFIX} base, or the canonical ingest path`);
     }
     if (!config.projectKey) {
         issues.push("projectKey is required");

package/dist/provider/constants.d.ts

@@ -1,5 +1,5 @@
-import type { CluebaseConsentState, ResolvedCluebaseConfig } from "./types.js";
 import { SDK_VERSION } from "./_version.js";
+import type { CluebaseConsentState, ResolvedCluebaseConfig } from "./types.js";
 export { SDK_VERSION };
 export declare const SDK_NAME = "@genn-inc/cluebase-frontend-sdk";
 export declare const EVENT_SOURCE: "frontend_sdk";

package/dist/provider/constants.js

@@ -41,10 +41,8 @@ export const MAX_SANITIZE_DEPTH = 20;
 export const DEFAULT_CONFIG = {
     endpoint: "",
     originalEndpoint: "",
-    localSetupCheckEndpoint: null,
     projectKey: "",
     producerId: DEFAULT_FRONTEND_SOURCE_IDENTIFIER,
-    transportProfile: "standard",
     autocapture: true,
     captureNetwork: true,
     captureErrors: true,

package/dist/provider/lifecycle-event-dedup.d.ts

@@ -0,0 +1,7 @@
+import type { CanonicalJsonValue } from "./types.js";
+export type LifecycleEventIdentity = Readonly<Record<string, CanonicalJsonValue>>;
+export declare class LifecycleEventDedup {
+    private readonly seenAtMs;
+    shouldEmit(identity: LifecycleEventIdentity): boolean;
+    clear(): void;
+}

package/dist/provider/lifecycle-event-dedup.js

@@ -0,0 +1,31 @@
+import { canonicalize } from "json-canonicalize";
+const LIFECYCLE_DEDUPE_TTL_MS = 300000;
+const LIFECYCLE_DEDUPE_MAX_ENTRIES = 4096;
+export class LifecycleEventDedup {
+    constructor() {
+        this.seenAtMs = new Map();
+    }
+    shouldEmit(identity) {
+        const key = canonicalize(identity);
+        const now = Date.now();
+        for (const [seenKey, seenAt] of this.seenAtMs) {
+            if (now - seenAt > LIFECYCLE_DEDUPE_TTL_MS) {
+                this.seenAtMs.delete(seenKey);
+            }
+        }
+        if (this.seenAtMs.has(key)) {
+            this.seenAtMs.set(key, now);
+            return false;
+        }
+        if (this.seenAtMs.size >= LIFECYCLE_DEDUPE_MAX_ENTRIES) {
+            const oldest = [...this.seenAtMs.entries()].sort((left, right) => left[1] - right[1])[0]?.[0];
+            if (oldest !== undefined)
+                this.seenAtMs.delete(oldest);
+        }
+        this.seenAtMs.set(key, now);
+        return true;
+    }
+    clear() {
+        this.seenAtMs.clear();
+    }
+}

package/dist/provider/sdk-event-pipeline.d.ts

@@ -1,16 +1,17 @@
-import { TraceManager } from "../context/trace.js";
 import type { EnvironmentManager } from "../context/environment.js";
 import type { IdentityManager } from "../context/identity.js";
 import type { OrganizationManager } from "../context/organization.js";
 import type { SessionManager } from "../context/session.js";
 import type { TabManager } from "../context/tab.js";
+import { TraceManager } from "../context/trace.js";
 import type { BatchTransport } from "../exporter/batch.js";
 import type { InternalMetricsStore } from "../internal/metrics.js";
-import type { CluebaseConsentState, CluebaseContext, CluebaseInternalLogger, IngestUsageGovernorFeedback, RawCapturedEvent, ResolvedCluebaseConfig } from "./types.js";
+import type { CluebaseConsentState, CluebaseContext, CluebaseInternalLogger, RawCapturedEvent, ResolvedCluebaseConfig } from "./types.js";
 export declare const OFFICIAL_CUSTOM_EVENT_NAME: {
     readonly identityIdentified: "identity_identified";
     readonly identityReset: "identity_reset";
     readonly organizationAssociated: "organization_associated";
+    readonly externalAccountLinked: "external_account_linked";
     readonly sdkInitialized: "sdk_initialized";
 };
 export type OfficialCustomEventProperties = Record<string, string | string[] | number>;
@@ -32,7 +33,6 @@ export declare const getSessionCaptureEligibility: (transport: BatchTransport) =
 export declare class ProviderEventPipeline {
     private runtime;
     private currentViewId;
-    private usageGovernorFeedback;
     private sessionCaptureEligible;
     private unregisterSessionCaptureEligibility;
     configure(runtime: ProviderEventPipelineRuntime): void;
@@ -47,7 +47,6 @@ export declare class ProviderEventPipeline {
         tabId: string | null;
     };
     enqueueRawEvent(event: RawCapturedEvent, skipSessionTouch?: boolean): void;
-    applyUsageGovernorFeedback(feedback: IngestUsageGovernorFeedback | null | undefined): void;
     refreshSessionCaptureEligibility(): void;
     buildContext(event?: RawCapturedEvent): CluebaseContext;
     private attachInteractionContext;

package/dist/provider/sdk-event-pipeline.js

@@ -1,9 +1,8 @@
 import { TraceManager } from "../context/trace.js";
 import { generateViewId } from "../exporter/event-id.js";
-import { rawEventToSourceSignalEvent } from "../exporter/raw-event-to-source-signal.js";
 import { createFrontendResourceAttributes } from "../exporter/frontend-resource.js";
+import { rawEventToSourceSignalEvent } from "../exporter/raw-event-to-source-signal.js";
 import { sanitizeObject, } from "../exporter/sanitize.js";
-import { DEFAULT_INGEST_USAGE_GOVERNOR_FEEDBACK, hasUsageGovernorFeedbackChanged, isCostCapabilityDisabled, normalizeIngestUsageGovernorFeedback, } from "./usage-governor.js";
 import { FRONTEND_EVENT_NAME } from "./contracts.js";
 import { shouldSampleSession } from "./sampling.js";
 import { stripQueryAndHashFromUrl, toStringOrNull, toSubjectProfile, } from "./sdk-input-normalization.js";
@@ -23,6 +22,7 @@ export const OFFICIAL_CUSTOM_EVENT_NAME = {
     identityIdentified: "identity_identified",
     identityReset: "identity_reset",
     organizationAssociated: "organization_associated",
+    externalAccountLinked: "external_account_linked",
     sdkInitialized: "sdk_initialized",
 };
 const OFFICIAL_CUSTOM_EVENT_NAMES = new Set(Object.values(OFFICIAL_CUSTOM_EVENT_NAME));
@@ -75,7 +75,6 @@ export class ProviderEventPipeline {
     constructor() {
         this.runtime = null;
         this.currentViewId = null;
-        this.usageGovernorFeedback = DEFAULT_INGEST_USAGE_GOVERNOR_FEEDBACK;
         this.sessionCaptureEligible = true;
         this.unregisterSessionCaptureEligibility = null;
     }
@@ -85,14 +84,12 @@ export class ProviderEventPipeline {
         this.unregisterSessionCaptureEligibility =
             registerSessionCaptureEligibility(runtime.transport, () => this.sessionCaptureEligible);
         this.currentViewId = generateViewId();
-        this.usageGovernorFeedback = DEFAULT_INGEST_USAGE_GOVERNOR_FEEDBACK;
         this.refreshSessionCaptureEligibility();
     }
     clearRuntime() {
         this.unregisterSessionCaptureEligibility?.();
         this.unregisterSessionCaptureEligibility = null;
         this.runtime = null;
-        this.usageGovernorFeedback = DEFAULT_INGEST_USAGE_GOVERNOR_FEEDBACK;
         this.sessionCaptureEligible = true;
     }
     resetViewId() {
@@ -149,10 +146,6 @@ export class ProviderEventPipeline {
                     runtime.internalMetrics.increment("sampling_dropped_count", droppedCount);
                 }
             }
-            if (isCostCapabilityDisabled(this.usageGovernorFeedback, "event_collection")) {
-                runtime.internalMetrics.increment("dropped_count");
-                return;
-            }
             const sourceSignal = rawEventToSourceSignalEvent(eventWithLocation, {
                 context,
                 resource: createFrontendResourceAttributes(runtime.config),
@@ -187,13 +180,6 @@ export class ProviderEventPipeline {
             });
         }
     }
-    applyUsageGovernorFeedback(feedback) {
-        const nextFeedback = normalizeIngestUsageGovernorFeedback(feedback);
-        if (!hasUsageGovernorFeedbackChanged(this.usageGovernorFeedback, nextFeedback)) {
-            return;
-        }
-        this.usageGovernorFeedback = nextFeedback;
-    }
     refreshSessionCaptureEligibility() {
         const config = this.runtime?.config;
         if (!config) {
@@ -458,7 +444,9 @@ export class ProviderEventPipeline {
 }
 function sanitizeContextTraits(traits, deniedKeys, excludedKeys = new Set(), summary, pathPrefix = "", maskIdentityPii = true, preserveExplicitTraits = false) {
     const sanitized = sanitizeObject(traits, deniedKeys, summary, pathPrefix, maskIdentityPii, preserveExplicitTraits);
-    if (typeof sanitized !== "object" || sanitized === null || Array.isArray(sanitized)) {
+    if (typeof sanitized !== "object" ||
+        sanitized === null ||
+        Array.isArray(sanitized)) {
         return {};
     }
     return Object.fromEntries(Object.entries(sanitized).filter(([key]) => !excludedKeys.has(key)));

package/dist/provider/sdk-input-normalization.js

@@ -1,4 +1,4 @@
-import { detectIdentityPII, hashIdentityValue } from "../exporter/sanitize.js";
+import { detectWholeValuePII, hashIdentityValue } from "../exporter/sanitize.js";
 const PUBLIC_CUSTOM_EVENT_NAME_PATTERN = /^[A-Za-z0-9_.:-]{1,128}$/;
 const SAFE_DATA_IMAGE_MIME_TYPES = new Set([
     "image/png",
@@ -80,7 +80,7 @@ const normalizeEmailTrait = (raw) => {
         return null;
     }
     const normalized = value.trim().toLowerCase();
-    return detectIdentityPII(normalized) === "email" ? normalized : null;
+    return detectWholeValuePII(normalized) === "email" ? normalized : null;
 };
 const emailDomain = (email) => {
     if (email === null) {

package/dist/provider/sdk-otel-pipeline.d.ts

@@ -6,8 +6,9 @@ type CreateCluebaseOtelPipelineOptions = {
     resolved: ResolvedCluebaseConfig;
     getTransport: () => BatchTransport | null;
     getContext: () => CluebaseContext;
+    ignoreUrlPrefixes: readonly string[];
 };
-export declare const createCluebaseOtelPipeline: ({ resolved, getTransport, getContext, }: CreateCluebaseOtelPipelineOptions) => CluebaseOtelProvider | null;
+export declare const createCluebaseOtelPipeline: ({ resolved, getTransport, getContext, ignoreUrlPrefixes, }: CreateCluebaseOtelPipelineOptions) => CluebaseOtelProvider | null;
 export declare const shutdownCluebaseOtelProvider: (provider: CluebaseOtelProvider | null) => void;
 export declare const shutdownCluebaseOtelProviderAsync: (provider: CluebaseOtelProvider | null) => Promise<void>;
 export declare const forceFlushCluebaseOtelProvider: (provider: CluebaseOtelProvider | null, signal?: AbortSignal) => Promise<void>;

package/dist/provider/sdk-otel-pipeline.js

@@ -2,9 +2,8 @@ import { context, propagation, trace } from "@opentelemetry/api";
 import { resourceFromAttributes } from "@opentelemetry/resources";
 import { BatchSpanProcessor } from "@opentelemetry/sdk-trace-base";
 import { WebTracerProvider } from "@opentelemetry/sdk-trace-web";
-import { resolveBrowserTokenEndpoint, resolveCanonicalIngestEndpoint, } from "../exporter/client.js";
-import { ObservationSourceEventExporter } from "../exporter/observation-source-event-exporter.js";
 import { createFrontendResourceAttributes } from "../exporter/frontend-resource.js";
+import { ObservationSourceEventExporter } from "../exporter/observation-source-event-exporter.js";
 import { createCluebaseNetworkPropagator } from "../instrumentation/network.js";
 import { getSessionCaptureEligibility } from "./sdk-event-pipeline.js";
 const globalSnapshots = new WeakMap();
@@ -16,7 +15,7 @@ const getTracerDelegate = (provider) => {
     const candidate = provider;
     return candidate.getDelegate?.();
 };
-export const createCluebaseOtelPipeline = ({ resolved, getTransport, getContext, }) => {
+export const createCluebaseOtelPipeline = ({ resolved, getTransport, getContext, ignoreUrlPrefixes, }) => {
     if (!getTransport()) {
         return null;
     }
@@ -58,15 +57,7 @@ export const createCluebaseOtelPipeline = ({ resolved, getTransport, getContext,
         },
         getContext,
         deniedKeys: resolved.privacy?.deniedKeys ?? [],
-        ignoreUrlPrefixes: [
-            resolveCanonicalIngestEndpoint(resolved.endpoint),
-            resolveCanonicalIngestEndpoint(resolved.originalEndpoint),
-            resolveBrowserTokenEndpoint(resolved.endpoint),
-            resolveBrowserTokenEndpoint(resolved.originalEndpoint),
-            ...(resolved.localSetupCheckEndpoint
-                ? [resolved.localSetupCheckEndpoint]
-                : []),
-        ].filter((url) => typeof url === "string" && url.length > 0),
+        ignoreUrlPrefixes,
     });
     const provider = new WebTracerProvider({
         resource,
@@ -88,7 +79,9 @@ export const createCluebaseOtelPipeline = ({ resolved, getTransport, getContext,
             propagator: createCluebaseNetworkPropagator(),
         });
         globalSnapshots.set(provider, {
-            installedTracer: getTracerDelegate(trace.getTracerProvider()) === provider ? provider : null,
+            installedTracer: getTracerDelegate(trace.getTracerProvider()) === provider
+                ? provider
+                : null,
             installedContextManager: isNoopContextManager(contextBeforeRegister)
                 ? readContextManager()
                 : null,
@@ -162,8 +155,7 @@ export const forceFlushCluebaseOtelProvider = async (provider, signal) => {
     try {
         await awaitWithAbort(provider.forceFlush(), signal);
     }
-    catch {
-    }
+    catch { }
 };
 const awaitWithAbort = async (promise, signal) => {
     if (!signal)

package/dist/provider/sdk-runtime-surfaces.d.ts

@@ -1,22 +1,26 @@
 import { TraceManager } from "../context/trace.js";
-import { type IngestClient } from "../exporter/client.js";
 import type { BatchTransport } from "../exporter/batch.js";
+import type { IngestClient } from "../exporter/client.js";
 import type { InternalMetricsStore } from "../internal/metrics.js";
-import type { CluebaseOtelProvider } from "./sdk-otel-pipeline.js";
+import { type CluebaseOtelProvider } from "./sdk-otel-pipeline.js";
 import type { CaptureModuleContext, CluebaseConsentState, CluebaseInternalLogger, RawCapturedEvent, ResolvedCluebaseConfig } from "./types.js";
+type RuntimeSurfacesObservationContext = {
+    anonymousId: string | null;
+    userId: string | null;
+    organizationId?: string | null;
+    sessionId: string | null;
+    tabId: string | null;
+};
+type RuntimeSurfacesEventPipeline = {
+    getViewId: () => string | null;
+    getObservationContext: () => RuntimeSurfacesObservationContext;
+};
 type ProviderRuntimeSurfacesOptions = {
     internalMetrics: InternalMetricsStore;
     logger: CluebaseInternalLogger;
     enqueueRawEvent: (event: RawCapturedEvent) => void;
-    getViewId: () => string | null;
+    eventPipeline: RuntimeSurfacesEventPipeline;
     getConsent: () => CluebaseConsentState;
-    getObservationContext: () => {
-        anonymousId: string | null;
-        userId: string | null;
-        organizationId?: string | null;
-        sessionId: string | null;
-        tabId: string | null;
-    };
     getTraceManager: () => TraceManager | null;
     getTransport: () => BatchTransport | null;
     getTracerProvider: () => CluebaseOtelProvider | null;
@@ -25,9 +29,8 @@ export declare class ProviderRuntimeSurfaces {
     private readonly internalMetrics;
     private readonly logger;
     private readonly enqueueRawEvent;
-    private readonly getViewId;
+    private readonly eventPipeline;
     private readonly getConsent;
-    private readonly getObservationContext;
     private readonly getTraceManager;
     private readonly getTransport;
     private readonly getTracerProvider;
@@ -38,7 +41,8 @@ export declare class ProviderRuntimeSurfaces {
     constructor(options: ProviderRuntimeSurfacesOptions);
     buildCaptureContext(): CaptureModuleContext;
     warmupBrowserToken(client: IngestClient): void;
-    startCaptureModules(config: ResolvedCluebaseConfig): void;
+    refreshIgnoreUrlPrefixes(): void;
+    startCaptureModules(config: ResolvedCluebaseConfig, ignoreUrlPrefixes: readonly string[]): void;
     stopCaptureModules(): void;
     abortBrowserTokenWarmup(): void;
     flushCaptureSummaries(reason: string): Promise<void>;

package/dist/provider/sdk-runtime-surfaces.js

@@ -1,5 +1,4 @@
 import { TraceManager } from "../context/trace.js";
-import { resolveBrowserTokenEndpoint, resolveCanonicalIngestEndpoint, } from "../exporter/client.js";
 import { startActionCapture } from "../instrumentation/action.js";
 import { startDragCapture } from "../instrumentation/drag.js";
 import { startErrorCapture } from "../instrumentation/error.js";
@@ -9,6 +8,7 @@ import { startNavigationCapture } from "../instrumentation/navigation.js";
 import { startNetworkCapture } from "../instrumentation/network.js";
 import { startPageCapture } from "../instrumentation/page.js";
 import { startPerformanceCapture } from "../instrumentation/performance.js";
+import { forceFlushCluebaseOtelProvider, } from "./sdk-otel-pipeline.js";
 const FLUSH_DEBOUNCE_MS = 200;
 export class ProviderRuntimeSurfaces {
     constructor(options) {
@@ -19,9 +19,8 @@ export class ProviderRuntimeSurfaces {
         this.internalMetrics = options.internalMetrics;
         this.logger = options.logger;
         this.enqueueRawEvent = options.enqueueRawEvent;
-        this.getViewId = options.getViewId;
+        this.eventPipeline = options.eventPipeline;
         this.getConsent = options.getConsent;
-        this.getObservationContext = options.getObservationContext;
         this.getTraceManager = options.getTraceManager;
         this.getTransport = options.getTransport;
         this.getTracerProvider = options.getTracerProvider;
@@ -38,10 +37,9 @@ export class ProviderRuntimeSurfaces {
                     error_code: "capture_module_error",
                 });
             },
-            getViewId: () => this.getViewId(),
+            getViewId: () => this.eventPipeline.getViewId(),
             getConsent: () => this.getConsent(),
-            getObservationContext: () => this.getObservationContext(),
-            shouldIgnoreElement: () => false,
+            getObservationContext: () => this.eventPipeline.getObservationContext(),
             startInteraction: (input) => {
                 return (this.getTraceManager()?.startInteraction(input) ??
                     input.interactionId ??
@@ -56,6 +54,7 @@ export class ProviderRuntimeSurfaces {
                     return;
                 this.flushDebounceTimer = setTimeout(() => {
                     this.flushDebounceTimer = null;
+                    void forceFlushCluebaseOtelProvider(this.getTracerProvider());
                     const transport = this.getTransport();
                     if (!transport)
                         return;
@@ -88,7 +87,12 @@ export class ProviderRuntimeSurfaces {
             }
         });
     }
-    startCaptureModules(config) {
+    refreshIgnoreUrlPrefixes() {
+        for (const handle of this.captureHandles) {
+            handle.refreshIgnoreUrlPrefixes?.();
+        }
+    }
+    startCaptureModules(config, ignoreUrlPrefixes) {
         const captureContext = this.buildCaptureContext();
         const handles = [];
         handles.push(startInputCapture(captureContext));
@@ -101,10 +105,7 @@ export class ProviderRuntimeSurfaces {
             handles.push(startNetworkCapture(captureContext, {
                 tracerProvider: this.getTracerProvider() ?? undefined,
                 deniedKeys: config.privacy.deniedKeys,
-                ignoreUrlPrefixes: [
-                    resolveCanonicalIngestEndpoint(config.endpoint),
-                    resolveBrowserTokenEndpoint(config.endpoint),
-                ],
+                ignoreUrlPrefixes,
                 tracePropagationOrigins: config.network.tracePropagationOrigins,
                 createRequestTraceContext: (input) => {
                     const traceManager = this.getTraceManager();
@@ -177,12 +178,14 @@ export class ProviderRuntimeSurfaces {
             }
             handled = true;
             onUnloadSessionEnd();
+            void forceFlushCluebaseOtelProvider(this.getTracerProvider());
             this.getTransport()?.flushOnUnload();
         };
         const visibilityHandler = () => {
             if (document.visibilityState !== "hidden") {
                 return;
             }
+            void forceFlushCluebaseOtelProvider(this.getTracerProvider());
             this.getTransport()?.flushOnUnload();
         };
         window.addEventListener("pagehide", handler, { capture: true });
@@ -210,8 +213,7 @@ export class ProviderRuntimeSurfaces {
             try {
                 dispose();
             }
-            catch {
-            }
+            catch { }
         }
         this.unloadHandlers = [];
     }