@genn-inc/cluebase-frontend-sdk 0.0.1 → 0.0.2

package/dist/internal/internal-log.js

@@ -1,10 +1,3 @@
-/**
- * SDK-internal diagnostic logger for the Frontend SDK.
- *
- * Mirror of Node SDK ``internal-log.ts`` and Python SDK ``_internal_log.py``.
- * Exposes a single configurable {@link InternalLogger}. Default is a no-op
- * so the SDK does not write to the host page's console.
- */
 const SAFE_CONTEXT_KEYS = new Set([
     "attempt",
     "code",
@@ -39,9 +32,5 @@ export function logSwallowed(operation, _cause, context = {}) {
             details[key] = value;
         }
     }
-    // Exception text and stacks may contain customer payloads, credentials, or
-    // source paths. The internal logger is an optional diagnostic sink, so it
-    // keeps only bounded caller-provided classification fields, matching the
-    // backend SDKs and the API/worker log contract.
     currentLogger.debug(`cluebase.sdk swallowed ${operation}`, details);
 }

package/dist/provider/_version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION: "0.0.1";
+export declare const SDK_VERSION: "0.0.2";

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.1";
+export const SDK_VERSION = "0.0.2";

package/dist/provider/config.d.ts

@@ -1,11 +1,4 @@
 import type { CluebaseInitOptions, ResolvedCluebaseConfig } from "./types.js";
-/**
- * Read an address Cluebase is able to send to, or `null` when it cannot.
- *
- * `cluebase.init` refuses such an endpoint loudly and `resolveConfig` drops it to
- * `""`; the two reactions differ but the question does not, so neither restates
- * the rule.
- */
 export declare const parseSendableUrl: (value: string) => URL | null;
 export declare const resolveConfig: (options: CluebaseInitOptions) => ResolvedCluebaseConfig;
 export declare const validateConfig: (config: ResolvedCluebaseConfig) => string[];

package/dist/provider/config.js

@@ -1,4 +1,4 @@
-import { ALWAYS_DENIED_KEYS, DEFAULT_CONFIG, DEFAULT_FRONTEND_SOURCE_IDENTIFIER, MAX_DIAGNOSTIC_TTL_MS, } from "./constants.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) => {
     if (!keys || keys.length === 0) {
@@ -64,17 +64,7 @@ const normalizeDiagnosticConfig = (value) => {
         enabledBy: value?.enabledBy?.trim() || null,
     };
 };
-// The protocols Cluebase can actually deliver over. Every place that rejects an
-// address reads this one set, so a browser-only scheme cannot be refused here
-// and accepted there.
 const SENDABLE_PROTOCOLS = new Set(["http:", "https:"]);
-/**
- * Read an address Cluebase is able to send to, or `null` when it cannot.
- *
- * `cluebase.init` refuses such an endpoint loudly and `resolveConfig` drops it to
- * `""`; the two reactions differ but the question does not, so neither restates
- * the rule.
- */
 export const parseSendableUrl = (value) => {
     try {
         const parsed = new URL(value.trim());
@@ -90,8 +80,6 @@ const normalizeTracePropagationOrigin = (value) => {
     if (!trimmed) {
         return null;
     }
-    // Unlike an endpoint, an origin that does not parse is kept as written: the
-    // caller matches these against request URLs itself.
     try {
         const parsed = new URL(trimmed);
         return SENDABLE_PROTOCOLS.has(parsed.protocol) ? parsed.origin : null;
@@ -100,10 +88,9 @@ const normalizeTracePropagationOrigin = (value) => {
         return trimmed;
     }
 };
-// The SDK does not emit a ProjectService environment. The server resolves
-// dev/prod from the `projectKey` prefix and ProjectService.
 export const resolveConfig = (options) => {
-    const originalEndpoint = normalizeConfiguredEndpoint(options.endpoint);
+    const configuredEndpoint = options.endpoint?.trim() || DEFAULT_API_BASE_URL;
+    const originalEndpoint = normalizeConfiguredEndpoint(configuredEndpoint);
     const customDenied = normalizeKeyList(options.privacy?.deniedKeys);
     const deniedKeys = [...new Set([...ALWAYS_DENIED_KEYS, ...customDenied])];
     const tracePropagationOrigins = [

package/dist/provider/constants.d.ts

@@ -7,6 +7,7 @@ export declare const EVENT_VERSION = 1;
 export declare const SOURCE_SCHEMA_VERSION = "1";
 export declare const SURFACE_TYPE: "web";
 export declare const DEFAULT_FRONTEND_SOURCE_IDENTIFIER = "frontend";
+export declare const DEFAULT_API_BASE_URL = "https://api.cluebase.io";
 export declare const MASKED_VALUE = "__cluebase_masked__";
 export declare const FORBIDDEN_PARAMETER_VALUE = "__forbidden__";
 export declare const TRUNCATED_PARAMETER_VALUE = "__truncated__";
@@ -32,23 +33,6 @@ export declare const STORAGE_KEYS: {
     readonly sessionStartedAt: "cluebase:session_started_at";
     readonly sessionLastActivityAt: "cluebase:session_last_activity_at";
 };
-/**
- * SDK-side denied keys. Stripped from event properties / metrics /
- * traits / headers / body fragments before the value is set as an OTel
- * span attribute or attached to a source-signal envelope.
- *
- * This list is a strict superset of the server-side hard-deny list
- * (`INGEST_HARD_DENY_KEYS`) **by construction**: both are emitted from the
- * same canonical data file,
- * `packages/cluebase-shared/src/ingest/ingest-privacy-policy.v1.json`.
- * It is not a hand-kept copy asserted by a parity test any more.
- *
- * `@cluebase/shared` is `private: true` and the published SDK is built with
- * `tsc` alone (no bundling), so the SDK cannot import it at customer
- * runtime. The shared-contract generator therefore writes the table into
- * this package instead; the generated file's banner names the command to
- * re-run. Do not re-declare the list, or the command, here.
- */
 export declare const ALWAYS_DENIED_KEYS: readonly string[];
 export declare const MAX_SCHEMA_DEPTH = 6;
 export declare const MAX_SCHEMA_KEYS = 512;

package/dist/provider/constants.js

@@ -1,9 +1,6 @@
 import { SDK_ALWAYS_DENIED_KEYS } from "../_generated/ingest-privacy-tables.js";
 import { SDK_RETRY_POLICY } from "../_generated/sdk-runtime-policy.js";
 import { SDK_VERSION } from "./_version.js";
-// SDK_VERSION SoT is `package.json` `version`, generated into
-// `_version.ts` by `scripts/generate-version-module.mjs` at build time.
-// Re-export it here so call sites keep the existing import path.
 export { SDK_VERSION };
 export const SDK_NAME = "@genn-inc/cluebase-frontend-sdk";
 export const EVENT_SOURCE = "frontend_sdk";
@@ -11,18 +8,11 @@ export const EVENT_VERSION = 1;
 export const SOURCE_SCHEMA_VERSION = "1";
 export const SURFACE_TYPE = "web";
 export const DEFAULT_FRONTEND_SOURCE_IDENTIFIER = "frontend";
-// Canonical mask sentinel — matches Node SDK / Python SDK / `@cluebase/shared`
-// (`__cluebase_masked__`). Aligning across the 3 SDKs lets downstream analytics
-// queries and redaction UIs detect masked values by a single string literal.
+export const DEFAULT_API_BASE_URL = "https://api.cluebase.io";
 export const MASKED_VALUE = "__cluebase_masked__";
 export const FORBIDDEN_PARAMETER_VALUE = "__forbidden__";
 export const TRUNCATED_PARAMETER_VALUE = "__truncated__";
 export const DEFAULT_CONSENT = "unknown";
-// 送信中の取りやめが「同意の取り消し」だったのかを、中断の理由で見分けます。
-// 立てる側 (`batch.ts`) と読む側 (`client.ts`) が別の module なので、字面を
-// 両方へ書くと片方だけずれても誰も気づきません。**ずれると取り消し後の束が
-// 破棄ではなく再送**になり、利用者が拒否した後の観測が顧客のサイトから出ます。
-// 正本を 1 つにして、両端がここを読みます (AGENTS §0.2)。
 export const CONSENT_DENIED_ABORT_REASON = "consent_denied";
 export const DEFAULT_SESSION_TIMEOUT_MS = 30 * 60 * 1000;
 export const DEFAULT_LIFECYCLE_INTERACTION_GRACE_WINDOW_MS = 30000;
@@ -30,9 +20,6 @@ export const DEFAULT_MAX_EVENT_PAYLOAD_BYTES = 48 * 1024;
 export const DEFAULT_BATCH_FLUSH_THRESHOLD_BYTES = 48 * 1024;
 export const DEFAULT_MAX_BATCH_PAYLOAD_BYTES = 60 * 1024;
 export const DEFAULT_MAX_BATCH_QUEUE_BYTES = 300 * 1024;
-// EventQueue の保持件数上限。 maxBytes (300KB) と二重にガードして OOM を防ぐ。
-// queueMaxBytes は payload size 起点で削るが、件数ベースの暴走 (極小 event の連射等)
-// を捕捉するために件数上限も併設する。
 export const DEFAULT_MAX_BATCH_QUEUE_ITEMS = 5000;
 export const DEFAULT_DIAGNOSTIC_TTL_MS = 600000;
 export const MAX_DIAGNOSTIC_TTL_MS = 1800000;
@@ -47,23 +34,6 @@ export const STORAGE_KEYS = {
     sessionStartedAt: "cluebase:session_started_at",
     sessionLastActivityAt: "cluebase:session_last_activity_at",
 };
-/**
- * SDK-side denied keys. Stripped from event properties / metrics /
- * traits / headers / body fragments before the value is set as an OTel
- * span attribute or attached to a source-signal envelope.
- *
- * This list is a strict superset of the server-side hard-deny list
- * (`INGEST_HARD_DENY_KEYS`) **by construction**: both are emitted from the
- * same canonical data file,
- * `packages/cluebase-shared/src/ingest/ingest-privacy-policy.v1.json`.
- * It is not a hand-kept copy asserted by a parity test any more.
- *
- * `@cluebase/shared` is `private: true` and the published SDK is built with
- * `tsc` alone (no bundling), so the SDK cannot import it at customer
- * runtime. The shared-contract generator therefore writes the table into
- * this package instead; the generated file's banner names the command to
- * re-run. Do not re-declare the list, or the command, here.
- */
 export const ALWAYS_DENIED_KEYS = SDK_ALWAYS_DENIED_KEYS;
 export const MAX_SCHEMA_DEPTH = 6;
 export const MAX_SCHEMA_KEYS = 512;

package/dist/provider/privacy-policy-store.d.ts

@@ -1,18 +1,6 @@
-/**
- * 届いた方針を適用する。**契約に合わない形は捨てて、伏せた側へ倒れます。**
- * 途中まで読めた分を活かすと、顧客が決めていない項目を平文にし得ます。
- */
 export declare const applyDeliveredPrivacyPolicy: (policy: unknown) => void;
-/** まだ何も適用していない状態へ戻す。= 全部伏せる。 */
 export declare const resetPrivacyPolicy: () => void;
-/** 塊の要求に載せる合印。持っていなければ載せない。 */
 export declare const appliedPrivacyPolicyToken: () => string | undefined;
-/**
- * この入口・この向きで、顧客が平文にした項目名。
- *
- * **入口が決まらない時は空を返します。**曖昧に当てると、顧客が 1 つの入口について
- * 決めたことが、関係のない通信まで平文にします。
- */
 export declare const allowedValuePathsFor: (input: {
     method: string | null | undefined;
     pathTemplate: string | null | undefined;

package/dist/provider/privacy-policy-store.js

@@ -2,10 +2,6 @@ import { ingestPrivacyPolicySchema, } from "../exporter/delivery-response-contra
 const policyKey = (input) => `${input.direction} ${input.method.toUpperCase()} ${input.pathTemplate}`;
 let appliedToken = null;
 let allowedPathsByEntrance = new Map();
-/**
- * 届いた方針を適用する。**契約に合わない形は捨てて、伏せた側へ倒れます。**
- * 途中まで読めた分を活かすと、顧客が決めていない項目を平文にし得ます。
- */
 export const applyDeliveredPrivacyPolicy = (policy) => {
     const parsed = ingestPrivacyPolicySchema.safeParse(policy);
     if (!parsed.success) {
@@ -32,19 +28,11 @@ const setPrivacyPolicy = (policy) => {
     allowedPathsByEntrance = next;
     appliedToken = policy.token;
 };
-/** まだ何も適用していない状態へ戻す。= 全部伏せる。 */
 export const resetPrivacyPolicy = () => {
     allowedPathsByEntrance = new Map();
     appliedToken = null;
 };
-/** 塊の要求に載せる合印。持っていなければ載せない。 */
 export const appliedPrivacyPolicyToken = () => appliedToken ?? undefined;
-/**
- * この入口・この向きで、顧客が平文にした項目名。
- *
- * **入口が決まらない時は空を返します。**曖昧に当てると、顧客が 1 つの入口について
- * 決めたことが、関係のない通信まで平文にします。
- */
 export const allowedValuePathsFor = (input) => {
     if (!input.method || !input.pathTemplate)
         return [];

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

@@ -49,7 +49,7 @@ export declare class ProviderEventPipeline {
     enqueueRawEvent(event: RawCapturedEvent, skipSessionTouch?: boolean): void;
     applyUsageGovernorFeedback(feedback: IngestUsageGovernorFeedback | null | undefined): void;
     refreshSessionCaptureEligibility(): void;
-    buildContext(): CluebaseContext;
+    buildContext(event?: RawCapturedEvent): CluebaseContext;
     private attachInteractionContext;
     private attachCurrentLocation;
     private handleSessionLifecycle;

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

@@ -4,7 +4,6 @@ import { rawEventToSourceSignalEvent } from "../exporter/raw-event-to-source-sig
 import { createFrontendResourceAttributes } from "../exporter/frontend-resource.js";
 import { sanitizeObject, } from "../exporter/sanitize.js";
 import { DEFAULT_INGEST_USAGE_GOVERNOR_FEEDBACK, hasUsageGovernorFeedbackChanged, isCostCapabilityDisabled, normalizeIngestUsageGovernorFeedback, } from "./usage-governor.js";
-import { DEFAULT_LIFECYCLE_INTERACTION_GRACE_WINDOW_MS, } from "./constants.js";
 import { FRONTEND_EVENT_NAME } from "./contracts.js";
 import { shouldSampleSession } from "./sampling.js";
 import { stripQueryAndHashFromUrl, toStringOrNull, toSubjectProfile, } from "./sdk-input-normalization.js";
@@ -20,13 +19,6 @@ const TRACE_ROOT_EVENTS = new Set([
     "drag_drop_completed",
     "custom_emitted",
 ]);
-const SUBJECT_PROFILE_TRAIT_KEYS = new Set([
-    "name",
-    "displayName",
-    "email",
-    "emailAddress",
-    "avatarUrl",
-]);
 export const OFFICIAL_CUSTOM_EVENT_NAME = {
     identityIdentified: "identity_identified",
     identityReset: "identity_reset",
@@ -146,7 +138,7 @@ export class ProviderEventPipeline {
             }
         }
         try {
-            const context = this.buildContext();
+            const context = this.buildContext(eventWithLocation);
             if (SUMMARY_EVENT_NAMES.has(eventWithLocation.type)) {
                 const summaryCount = eventWithLocation.payload.summaryCount;
                 const droppedCount = eventWithLocation.payload.droppedCount;
@@ -211,7 +203,7 @@ export class ProviderEventPipeline {
         const rate = config.sampling.sessionSampleRate;
         this.sessionCaptureEligible = shouldSampleSession(rate);
     }
-    buildContext() {
+    buildContext(event) {
         const runtime = this.runtime;
         if (!runtime) {
             throw new Error("SDK is not initialized");
@@ -221,6 +213,9 @@ export class ProviderEventPipeline {
         const organization = runtime.organizationManager.getContext();
         const environment = runtime.environmentManager.getContext();
         const trace = runtime.traceManager.getSnapshot();
+        const actionContext = runtime.traceManager.getBoundActionContext();
+        const eventActionId = toStringOrNull(event?.payload.actionId);
+        const eventInteractionId = toStringOrNull(event?.payload.interactionId);
         const requestContext = runtime.traceManager.createRequestContext() ??
             new TraceManager().createRequestContext();
         const privacySummary = {
@@ -228,9 +223,9 @@ export class ProviderEventPipeline {
             droppedFieldCount: 0,
             maskedFields: new Set(),
         };
-        const subjectTraits = sanitizeContextTraits(identity.traits, runtime.config.privacy.deniedKeys, SUBJECT_PROFILE_TRAIT_KEYS, privacySummary, "subject.trait");
-        const organizationTraits = sanitizeContextTraits(organization.traits, runtime.config.privacy.deniedKeys, new Set(), privacySummary, "organization.trait");
-        const contextTraits = sanitizeContextTraits(environment.contextTraits, runtime.config.privacy.deniedKeys, new Set(), privacySummary, "context.trait");
+        const subjectTraits = sanitizeContextTraits(identity.traits, runtime.config.privacy.deniedKeys, new Set(), privacySummary, "subject.trait", false, true);
+        const organizationTraits = sanitizeContextTraits(organization.traits, runtime.config.privacy.deniedKeys, new Set(), privacySummary, "organization.trait", false, true);
+        const contextTraits = sanitizeContextTraits(environment.contextTraits, runtime.config.privacy.deniedKeys, new Set(), privacySummary, "context.trait", false, true);
         return {
             producer_id: runtime.config.producerId,
             anonymous_id: identity.anonymousId,
@@ -239,10 +234,12 @@ export class ProviderEventPipeline {
             user_profile: toSubjectProfile(identity.traits),
             session_id: session.sessionId,
             tab_id: runtime.tabManager.getTabId(),
-            trace_id: trace.traceId ?? requestContext.traceId,
+            trace_id: actionContext?.traceId ?? trace.traceId ?? requestContext.traceId,
             request_id: requestContext.requestId,
             request_span_id: requestContext.requestSpanId,
-            interaction_id: runtime.traceManager.getActiveInteractionId() ??
+            action_id: eventActionId ?? actionContext?.actionId ?? requestContext.actionId,
+            interaction_id: eventInteractionId ??
+                actionContext?.interactionId ??
                 requestContext.interactionId,
             correlation_id: null,
             sdk_collection_mode: runtime.config.collection.mode,
@@ -283,49 +280,42 @@ export class ProviderEventPipeline {
     attachInteractionContext(event) {
         const traceManager = this.runtime?.traceManager;
         const nowMs = event.occurredAtMs ?? Date.now();
-        const payloadInteractionId = toStringOrNull(event.payload.interactionId);
+        const actionContext = traceManager?.getBoundActionContext();
+        const payloadInteractionId = toStringOrNull(event.payload.interactionId) ??
+            actionContext?.interactionId ??
+            null;
+        const payloadActionId = toStringOrNull(event.payload.actionId) ?? actionContext?.actionId ?? null;
         const occurrenceKind = "frontend_action";
         if (event.type === "page_view") {
-            const interactionId = traceManager?.startFrontendAction({
-                interactionId: payloadInteractionId,
-                interactionInitiator: toStringOrNull(event.payload.interactionInitiator) ?? "page_visit",
-                interactionStartEventKind: toStringOrNull(event.payload.interactionStartEventKind) ??
-                    "page_view",
-                viewId: toStringOrNull(event.payload.viewId),
-                nowMs,
-            }) ?? payloadInteractionId;
-            if (!interactionId)
+            if (!payloadActionId && !payloadInteractionId)
                 return event;
             return {
                 ...event,
                 payload: {
                     ...event.payload,
-                    interactionId,
-                    interactionInitiator: toStringOrNull(event.payload.interactionInitiator) ?? "page_visit",
-                    interactionStartEventKind: toStringOrNull(event.payload.interactionStartEventKind) ??
-                        "page_view",
-                    occurrenceKind,
+                    ...(payloadActionId ? { actionId: payloadActionId } : {}),
+                    ...(payloadInteractionId
+                        ? { interactionId: payloadInteractionId }
+                        : {}),
                 },
             };
         }
         if (event.type === "page_leave") {
-            const interactionId = payloadInteractionId ??
-                traceManager?.getActiveInteractionId() ??
-                null;
-            if (!interactionId)
+            if (!payloadActionId && !payloadInteractionId)
                 return event;
-            traceManager?.endFrontendAction(interactionId);
             return {
                 ...event,
                 payload: {
                     ...event.payload,
-                    interactionId,
-                    occurrenceKind,
+                    ...(payloadActionId ? { actionId: payloadActionId } : {}),
+                    ...(payloadInteractionId
+                        ? { interactionId: payloadInteractionId }
+                        : {}),
                 },
             };
         }
         if (isOfficialCustomLifecycleEvent(event)) {
-            const lifecycleInteraction = traceManager?.getRecentInteractionSnapshot(nowMs, DEFAULT_LIFECYCLE_INTERACTION_GRACE_WINDOW_MS) ?? null;
+            const lifecycleInteraction = traceManager?.getBoundActionContext() ?? null;
             const interactionId = payloadInteractionId ?? lifecycleInteraction?.interactionId ?? null;
             if (!interactionId)
                 return event;
@@ -333,6 +323,11 @@ export class ProviderEventPipeline {
                 ...event,
                 payload: {
                     ...event.payload,
+                    ...(lifecycleInteraction?.actionId
+                        ? { actionId: lifecycleInteraction.actionId }
+                        : payloadActionId
+                            ? { actionId: payloadActionId }
+                            : {}),
                     interactionId,
                     occurrenceKind,
                     interactionInitiator: toStringOrNull(event.payload.interactionInitiator) ??
@@ -364,6 +359,11 @@ export class ProviderEventPipeline {
                 ...event,
                 payload: {
                     ...event.payload,
+                    ...(traceManager?.getActiveActionId()
+                        ? { actionId: traceManager.getActiveActionId() }
+                        : payloadActionId
+                            ? { actionId: payloadActionId }
+                            : {}),
                     interactionId,
                     occurrenceKind,
                     interactionInitiator: toStringOrNull(event.payload.interactionInitiator) ??
@@ -373,20 +373,7 @@ export class ProviderEventPipeline {
                 },
             };
         }
-        const activeInteractionId = payloadInteractionId ??
-            traceManager?.getActiveInteractionId() ??
-            null;
-        if (!activeInteractionId || activeInteractionId === payloadInteractionId) {
-            return event;
-        }
-        return {
-            ...event,
-            payload: {
-                ...event.payload,
-                interactionId: activeInteractionId,
-                occurrenceKind,
-            },
-        };
+        return event;
     }
     attachCurrentLocation(event) {
         const payload = event.payload;
@@ -469,8 +456,8 @@ export class ProviderEventPipeline {
         traceManager.setActiveSpan(eventId);
     }
 }
-function sanitizeContextTraits(traits, deniedKeys, excludedKeys = new Set(), summary, pathPrefix = "") {
-    const sanitized = sanitizeObject(traits, deniedKeys, summary, pathPrefix);
+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)) {
         return {};
     }

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

@@ -1,4 +1,4 @@
-import { trace } from "@opentelemetry/api";
+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";
@@ -7,6 +7,15 @@ import { ObservationSourceEventExporter } from "../exporter/observation-source-e
 import { createFrontendResourceAttributes } from "../exporter/frontend-resource.js";
 import { createCluebaseNetworkPropagator } from "../instrumentation/network.js";
 import { getSessionCaptureEligibility } from "./sdk-event-pipeline.js";
+const globalSnapshots = new WeakMap();
+const readContextManager = () => Reflect.get(context, "_getContextManager").call(context);
+const readPropagator = () => Reflect.get(propagation, "_getGlobalPropagator").call(propagation);
+const isNoopContextManager = (manager) => manager.constructor.name === "NoopContextManager";
+const isNoopPropagator = (propagator) => propagator.constructor.name === "NoopTextMapPropagator";
+const getTracerDelegate = (provider) => {
+    const candidate = provider;
+    return candidate.getDelegate?.();
+};
 export const createCluebaseOtelPipeline = ({ resolved, getTransport, getContext, }) => {
     if (!getTransport()) {
         return null;
@@ -73,9 +82,22 @@ export const createCluebaseOtelPipeline = ({ resolved, getTransport, getContext,
     const mode = resolved.otelProviderMode;
     const shouldRegister = mode === "register" || (mode === "detect" && !hasHostInstalledProvider());
     if (shouldRegister) {
+        const contextBeforeRegister = readContextManager();
+        const propagatorBeforeRegister = readPropagator();
         provider.register({
             propagator: createCluebaseNetworkPropagator(),
         });
+        globalSnapshots.set(provider, {
+            installedTracer: getTracerDelegate(trace.getTracerProvider()) === provider ? provider : null,
+            installedContextManager: isNoopContextManager(contextBeforeRegister)
+                ? readContextManager()
+                : null,
+            installedPropagator: isNoopPropagator(propagatorBeforeRegister)
+                ? readPropagator()
+                : null,
+            contextWasAlreadyRegistered: !isNoopContextManager(contextBeforeRegister),
+            propagatorWasAlreadyRegistered: !isNoopPropagator(propagatorBeforeRegister),
+        });
     }
     return provider;
 };
@@ -95,7 +117,10 @@ export const shutdownCluebaseOtelProvider = (provider) => {
     if (!provider) {
         return;
     }
-    void provider.shutdown().catch(() => undefined);
+    void provider
+        .shutdown()
+        .catch(() => undefined)
+        .finally(() => restoreCluebaseOtelGlobals(provider));
 };
 export const shutdownCluebaseOtelProviderAsync = async (provider) => {
     if (!provider) {
@@ -105,8 +130,30 @@ export const shutdownCluebaseOtelProviderAsync = async (provider) => {
         await provider.shutdown();
     }
     catch {
-        // shutdown is best-effort per OTel contract.
     }
+    finally {
+        restoreCluebaseOtelGlobals(provider);
+    }
+};
+const restoreCluebaseOtelGlobals = (provider) => {
+    const snapshot = globalSnapshots.get(provider);
+    if (!snapshot)
+        return;
+    if (snapshot.installedTracer &&
+        getTracerDelegate(trace.getTracerProvider()) === snapshot.installedTracer) {
+        trace.disable();
+    }
+    if (!snapshot.contextWasAlreadyRegistered &&
+        snapshot.installedContextManager &&
+        readContextManager() === snapshot.installedContextManager) {
+        context.disable();
+    }
+    if (!snapshot.propagatorWasAlreadyRegistered &&
+        snapshot.installedPropagator &&
+        readPropagator() === snapshot.installedPropagator) {
+        propagation.disable();
+    }
+    globalSnapshots.delete(provider);
 };
 export const forceFlushCluebaseOtelProvider = async (provider, signal) => {
     if (!provider) {
@@ -116,7 +163,6 @@ export const forceFlushCluebaseOtelProvider = async (provider, signal) => {
         await awaitWithAbort(provider.forceFlush(), signal);
     }
     catch {
-        // forceFlush is best-effort per OTel contract.
     }
 };
 const awaitWithAbort = async (promise, signal) => {

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

@@ -47,6 +47,9 @@ export class ProviderRuntimeSurfaces {
                     input.interactionId ??
                     null);
             },
+            bindEventContext: (event) => {
+                this.getTraceManager()?.bindEventContext(event);
+            },
             requestFlush: () => {
                 void this.flushCaptureSummaries("capture_flush");
                 if (this.flushDebounceTimer)
@@ -208,7 +211,6 @@ export class ProviderRuntimeSurfaces {
                 dispose();
             }
             catch {
-                // Ignore.
             }
         }
         this.unloadHandlers = [];