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

package/dist/exporter/path-template.js

@@ -56,7 +56,9 @@ export const toPathTemplate = (pathname) => {
     }
     const normalizedPath = pathname.startsWith("/") ? pathname : `/${pathname}`;
     const [pathOnly] = normalizedPath.split("?");
-    const rawSegments = pathOnly.split("/").filter((segment) => segment.length > 0);
+    const rawSegments = pathOnly
+        .split("/")
+        .filter((segment) => segment.length > 0);
     const segments = rawSegments.map((segment, index) => shouldTemplateSegment(segment, rawSegments[index - 1] ?? null)
         ? ":id"
         : segment);

package/dist/exporter/raw-event-to-source-signal.js

@@ -2,8 +2,8 @@ import { CLUEBASE_CORRELATION_ATTRIBUTE_KEYS } from "../_generated/correlation-a
 import { cluebaseAuthoredPropertyAttribute } from "../instrumentation/cluebase-authored-attributes.js";
 import { EVENT_SOURCE, EVENT_VERSION, SOURCE_SCHEMA_VERSION, } from "../provider/constants.js";
 import { generateEventId, generateInteractionId, generateRequestId, generateRequestSpanId, generateTraceId, } from "./event-id.js";
-import { isDeniedKey } from "./sanitize.js";
 import { toFrontendSourceResource, } from "./frontend-resource.js";
+import { isDeniedKey } from "./sanitize.js";
 import { SDK_SOURCE_SIGNAL_EVENT_NAME, SDK_SOURCE_SIGNAL_EVENT_TYPE, } from "./source-event.js";
 export const RAW_FRONTEND_SOURCE_SIGNAL_KIND = "frontend_raw_event";
 const PUBLIC_CUSTOM_EVENT_NAME_PATTERN = /^[A-Za-z0-9_.:-]{1,128}$/;
@@ -236,7 +236,8 @@ export function rawEventToSourceSignalEvent(raw, options) {
         if (viewId)
             attributes["cluebase.view.id"] = viewId;
         if (failureType) {
-            attributes[cluebaseAuthoredPropertyAttribute("failure_type")] = failureType;
+            attributes[cluebaseAuthoredPropertyAttribute("failure_type")] =
+                failureType;
         }
         if (outcomeClass)
             attributes["cluebase.outcome_class"] = outcomeClass;
@@ -291,6 +292,7 @@ export function rawEventToSourceSignalEvent(raw, options) {
             attributes,
             events: [],
             resource: toFrontendSourceResource(options.resource, options.deniedKeys),
+            raw_resource: toFrontendSourceResource(options.resource, options.deniedKeys),
             context: contextRecord(context, {
                 session_id: sessionId,
                 trace_id: traceId,

package/dist/exporter/sanitize.d.ts

@@ -1,4 +1,5 @@
-import { detectIdentityPII } from "../_generated/identity-pii-policy.js";
+import { detectTextContainsPII } from "../_generated/identity-pii-policy-text-contains.js";
+import { detectWholeValuePII } from "../_generated/identity-pii-policy-whole-value.js";
 export type SanitizationAccumulator = {
     maskedValueCount: number;
     droppedFieldCount: number;
@@ -15,5 +16,5 @@ export declare const parseUrlForNetwork: (rawUrl: string) => {
     urlMaskedQuery: string;
 };
 export declare const maybeParseJson: (value: unknown) => unknown;
-export { detectIdentityPII };
+export { detectTextContainsPII, detectWholeValuePII };
 export declare const hashIdentityValue: (value: string) => string;

package/dist/exporter/sanitize.js

@@ -1,6 +1,7 @@
 import { sha256 } from "@noble/hashes/sha256";
 import { bytesToHex, utf8ToBytes } from "@noble/hashes/utils";
-import { detectIdentityPII, PII_HASH_HEX_LENGTH, PII_HASH_PREFIX, } from "../_generated/identity-pii-policy.js";
+import { detectTextContainsPII, PII_HASH_HEX_LENGTH, PII_HASH_PREFIX, } from "../_generated/identity-pii-policy-text-contains.js";
+import { detectWholeValuePII } from "../_generated/identity-pii-policy-whole-value.js";
 import { isDeniedLookupKey, toDeniedLookupKeySet, } from "../_generated/ingest-privacy-tables.js";
 import { toPathTemplate } from "../exporter/path-template.js";
 import { ALWAYS_DENIED_KEYS, MASKED_VALUE, MAX_SANITIZE_DEPTH, } from "../provider/constants.js";
@@ -67,7 +68,7 @@ export const sanitizeObject = (value, deniedKeys = [], summary, pathPrefix = "",
         if (maskIdentityPii &&
             !preserveExplicitTraits &&
             typeof current === "string" &&
-            detectIdentityPII(current) !== null) {
+            detectTextContainsPII(current) !== null) {
             if (current === MASKED_VALUE)
                 return current;
             if (summary) {
@@ -140,5 +141,5 @@ export const maybeParseJson = (value) => {
         return null;
     }
 };
-export { detectIdentityPII };
+export { detectTextContainsPII, detectWholeValuePII };
 export const hashIdentityValue = (value) => `${PII_HASH_PREFIX}${bytesToHex(sha256(utf8ToBytes(value))).slice(0, PII_HASH_HEX_LENGTH)}`;

package/dist/exporter/sdk-core-wasm.d.ts

@@ -0,0 +1,5 @@
+import init from "../wasm/pkg-web/cluebase_sdk_core_wasm.js";
+export type SdkCoreWasmInitInput = Parameters<typeof init>[0];
+export declare const initSdkCoreWasm: (input?: SdkCoreWasmInitInput) => Promise<void>;
+export declare const isSdkCoreWasmReady: () => boolean;
+export declare const spanToSdkSignalJson: (spanJson: string, optionsJson: string) => string;

package/dist/exporter/sdk-core-wasm.js

@@ -0,0 +1,18 @@
+import init, { spanToSdkSignalJson as wasmSpanToSdkSignalJson, } from "../wasm/pkg-web/cluebase_sdk_core_wasm.js";
+let readyPromise = null;
+let ready = false;
+export const initSdkCoreWasm = (input) => {
+    if (!readyPromise) {
+        readyPromise = init(input).then(() => {
+            ready = true;
+        });
+    }
+    return readyPromise;
+};
+export const isSdkCoreWasmReady = () => ready;
+export const spanToSdkSignalJson = (spanJson, optionsJson) => {
+    if (!ready) {
+        throw new Error("cluebase sdk core wasm is not initialized; call initSdkCoreWasm() first");
+    }
+    return wasmSpanToSdkSignalJson(spanJson, optionsJson);
+};

package/dist/exporter/source-event.d.ts

@@ -61,6 +61,7 @@ export type BrowserSdkSignal = {
         attributes: Record<string, CanonicalJsonValue>;
     }>;
     resource: Record<string, CanonicalJsonValue>;
+    raw_resource: Record<string, CanonicalJsonValue>;
     context: BrowserSdkSignalContext;
 };
 export type BrowserSourceSignalEvent = {

package/dist/exporter/span-to-source-signal.d.ts

@@ -5,4 +5,4 @@ export interface SpanToSourceSignalOptions {
     context: CluebaseContext;
     deniedKeys?: readonly string[];
 }
-export declare function spanToSourceSignalEvent(span: ReadableSpan, options: SpanToSourceSignalOptions): BrowserSourceSignalEvent;
+export declare function spanToSourceSignalEvent(span: ReadableSpan, options: SpanToSourceSignalOptions): Promise<BrowserSourceSignalEvent>;

package/dist/exporter/span-to-source-signal.js

@@ -1,42 +1,69 @@
 import { CLUEBASE_CORRELATION_ATTRIBUTE_KEYS } from "../_generated/correlation-attribute-keys.js";
-import { attrString, hrTimeToUnixNano, nanosToIso, parentSpanId, } from "../_generated/otel-span-conversion.js";
-import { EVENT_SOURCE, EVENT_VERSION, SOURCE_SCHEMA_VERSION, } from "../provider/constants.js";
-import { generateEventId, generateInteractionId, generateRequestId, generateRequestSpanId, generateTraceId, } from "./event-id.js";
+import { nanosToIso, parentSpanId } from "../_generated/otel-span-conversion.js";
+import { ALWAYS_DENIED_KEYS, EVENT_SOURCE, EVENT_VERSION, SOURCE_SCHEMA_VERSION, } from "../provider/constants.js";
+import { generateEventId } from "./event-id.js";
 import { isDeniedKey } from "./sanitize.js";
-import { toFrontendSourceResource } from "./frontend-resource.js";
+import { initSdkCoreWasm, isSdkCoreWasmReady, spanToSdkSignalJson, } from "./sdk-core-wasm.js";
 import { SDK_SOURCE_SIGNAL_EVENT_NAME, SDK_SOURCE_SIGNAL_EVENT_TYPE, } from "./source-event.js";
-const isDynamicJsonObject = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
-function toJsonValue(value) {
-    if (value === null)
-        return null;
-    if (typeof value === "string" ||
-        typeof value === "number" ||
-        typeof value === "boolean") {
-        return typeof value === "number" && !Number.isFinite(value) ? null : value;
+function withCoreMasking(summary, masking) {
+    const maskedValueCount = masking?.masked_value_count ?? 0;
+    const maskedFields = masking?.masked_fields ?? [];
+    if (!summary) {
+        if (maskedValueCount === 0 && maskedFields.length === 0)
+            return undefined;
+        return {
+            level: "masked",
+            masked_value_count: maskedValueCount,
+            dropped_field_count: 0,
+            masked_fields: [...maskedFields].sort(),
+            rule_set_version: null,
+        };
     }
-    if (Array.isArray(value))
-        return value.map((entry) => toJsonValue(entry));
-    if (isDynamicJsonObject(value)) {
-        const record = {};
-        for (const [key, entry] of Object.entries(value)) {
-            record[key] = toJsonValue(entry);
-        }
-        return record;
-    }
-    if (typeof value === "bigint")
-        return value.toString();
-    return null;
+    return {
+        ...summary,
+        masked_value_count: summary.masked_value_count + maskedValueCount,
+        masked_fields: [
+            ...new Set([...summary.masked_fields, ...maskedFields]),
+        ].sort(),
+    };
+}
+function rawAttrString(attributes, key) {
+    const value = attributes?.[key];
+    return typeof value === "string" && value.trim().length > 0
+        ? value.trim()
+        : null;
 }
-function toJsonRecord(value, deniedKeys = []) {
-    const record = {};
-    for (const [key, entry] of Object.entries(value ?? {})) {
+function preFilterDeniedAttributes(attributes, deniedKeys) {
+    const filtered = {};
+    for (const [key, value] of Object.entries(attributes ?? {})) {
         if (!CLUEBASE_CORRELATION_ATTRIBUTE_KEYS.has(key) &&
             isDeniedKey(key, deniedKeys)) {
             continue;
         }
-        record[key] = toJsonValue(entry);
+        filtered[key] = value;
+    }
+    return filtered;
+}
+function seedFallbackAttribute(attributesForCore, attributeKey, candidateKeys, fallback) {
+    const alreadyPresent = candidateKeys.some((candidateKey) => rawAttrString(attributesForCore, candidateKey) !== null);
+    if (alreadyPresent || !fallback)
+        return;
+    attributesForCore[attributeKey] = fallback;
+}
+function resourceAttributesInput(resource) {
+    const input = resource;
+    try {
+        return { ...(input?.attributes ?? {}) };
+    }
+    catch {
+        return {};
     }
-    return record;
+}
+const FIXED_CORE_DENIED_KEYS = Object.freeze([...new Set(ALWAYS_DENIED_KEYS)].sort());
+function coreDeniedKeys(deniedKeys) {
+    if (deniedKeys.length === 0)
+        return FIXED_CORE_DENIED_KEYS;
+    return [...new Set([...FIXED_CORE_DENIED_KEYS, ...deniedKeys])].sort();
 }
 function instrumentationScopeName(span) {
     const instrumentation = span;
@@ -87,34 +114,49 @@ function contextRecord(context, overrides) {
         context_traits: context.context_traits,
     };
 }
-export function spanToSourceSignalEvent(span, options) {
+export async function spanToSourceSignalEvent(span, options) {
+    if (!isSdkCoreWasmReady()) {
+        await initSdkCoreWasm();
+    }
     const context = options.context;
-    const attributes = toJsonRecord(span.attributes, options.deniedKeys);
+    const deniedKeys = options.deniedKeys ?? [];
     const spanContext = span.spanContext();
-    const traceId = attrString(attributes, "cluebase.trace_id") ??
-        spanContext.traceId ??
-        generateTraceId();
     const spanId = spanContext.spanId || null;
-    const parentId = parentSpanId(span, attributes);
-    const startTimeUnixNano = hrTimeToUnixNano(span.startTime);
-    const endTimeUnixNano = hrTimeToUnixNano(span.endTime);
+    const parentId = parentSpanId(span, span.attributes);
+    const traceId = rawAttrString(span.attributes, "cluebase.trace_id") ??
+        spanContext.traceId ??
+        undefined;
+    const attributesForCore = preFilterDeniedAttributes(span.attributes, deniedKeys);
+    seedFallbackAttribute(attributesForCore, "cluebase.request_span_id", ["cluebase.request_span_id"], spanId ?? context.request_span_id);
+    seedFallbackAttribute(attributesForCore, "cluebase.request_id", ["cluebase.request.id", "cluebase.request_id"], context.request_id);
+    seedFallbackAttribute(attributesForCore, "cluebase.action_id", ["cluebase.action.id", "cluebase.action_id"], context.action_id ?? undefined);
+    seedFallbackAttribute(attributesForCore, "cluebase.interaction_id", ["cluebase.interaction.id", "cluebase.interaction_id"], context.interaction_id);
+    const corePayload = {
+        name: span.name,
+        kind: typeof span.kind === "number" ? span.kind : undefined,
+        trace_id: traceId,
+        span_id: spanId ?? undefined,
+        parent_span_id: parentId ?? undefined,
+        start_time: span.startTime,
+        end_time: span.endTime,
+        status: span.status
+            ? { code: span.status.code ?? undefined, message: span.status.message }
+            : undefined,
+        attributes: attributesForCore,
+        events: (span.events ?? []).map((event) => ({
+            name: event.name,
+            attributes: preFilterDeniedAttributes(event.attributes, deniedKeys),
+        })),
+        resource_attributes: resourceAttributesInput(span.resource),
+        instrumentation_scope_name: instrumentationScopeName(span) ?? undefined,
+    };
+    const coreOptions = {
+        denied_keys: coreDeniedKeys(deniedKeys),
+        surface: "frontend",
+    };
+    const core = JSON.parse(spanToSdkSignalJson(JSON.stringify(corePayload), JSON.stringify(coreOptions)));
+    const resolvedTraceId = core.trace_id ?? traceId ?? "";
     const eventId = generateEventId();
-    const requestSpanId = attrString(attributes, "cluebase.request_span_id") ??
-        spanId ??
-        context.request_span_id ??
-        generateRequestSpanId();
-    const requestId = attrString(attributes, "cluebase.request.id") ??
-        attrString(attributes, "cluebase.request_id") ??
-        context.request_id ??
-        generateRequestId();
-    const actionId = attrString(attributes, "cluebase.action.id") ??
-        attrString(attributes, "cluebase.action_id") ??
-        context.action_id ??
-        null;
-    const interactionId = attrString(attributes, "cluebase.interaction.id") ??
-        attrString(attributes, "cluebase.interaction_id") ??
-        context.interaction_id ??
-        generateInteractionId();
     return {
         event_id: eventId,
         source_event_id: eventId,
@@ -127,7 +169,7 @@ export function spanToSourceSignalEvent(span, options) {
         event_category: "context",
         event_source: EVENT_SOURCE,
         event_version: EVENT_VERSION,
-        occurred_at: nanosToIso(startTimeUnixNano),
+        occurred_at: nanosToIso(core.start_time_unix_nano),
         ingested_at: new Date().toISOString(),
         status: "observed",
         sdk_collection_mode: context.sdk_collection_mode,
@@ -135,14 +177,14 @@ export function spanToSourceSignalEvent(span, options) {
         privacy_level: "default_masked",
         masking_state: "masked",
         allowed_value_keys: [],
-        privacy_summary: context.privacy_summary,
-        trace_id: traceId,
-        span_id: spanId,
-        parent_span_id: parentId,
-        request_id: requestId,
-        request_span_id: requestSpanId,
-        action_id: actionId,
-        interaction_id: interactionId,
+        privacy_summary: withCoreMasking(context.privacy_summary, core.privacy_masking),
+        trace_id: resolvedTraceId,
+        span_id: core.span_id,
+        parent_span_id: core.parent_span_id,
+        request_id: core.request_id,
+        request_span_id: core.request_span_id,
+        action_id: core.action_id,
+        interaction_id: core.interaction_id,
         frontend_release: context.frontend_release,
         backend_release: null,
         properties: {},
@@ -151,27 +193,25 @@ export function spanToSourceSignalEvent(span, options) {
             surface: "frontend",
             kind: "span",
             name: span.name,
-            span_kind: span.kind ?? null,
-            trace_id: traceId,
-            span_id: spanId,
-            parent_span_id: parentId,
-            start_time_unix_nano: startTimeUnixNano,
-            end_time_unix_nano: endTimeUnixNano,
-            status_code: span.status?.code ?? null,
-            status_message: span.status?.message ?? null,
-            instrumentation_scope_name: instrumentationScopeName(span),
-            attributes,
-            events: (span.events ?? []).map((event) => ({
-                name: event.name,
-                attributes: toJsonRecord(event.attributes, options.deniedKeys),
-            })),
-            resource: toFrontendSourceResource(span.resource, options.deniedKeys),
+            span_kind: core.span_kind,
+            trace_id: resolvedTraceId,
+            span_id: core.span_id,
+            parent_span_id: core.parent_span_id,
+            start_time_unix_nano: core.start_time_unix_nano,
+            end_time_unix_nano: core.end_time_unix_nano,
+            status_code: core.status_code ?? null,
+            status_message: core.status_message,
+            instrumentation_scope_name: core.instrumentation_scope_name,
+            attributes: core.attributes,
+            events: core.events,
+            resource: core.resource,
+            raw_resource: core.raw_resource,
             context: contextRecord(context, {
-                trace_id: traceId,
-                request_id: requestId,
-                request_span_id: requestSpanId,
-                action_id: actionId,
-                interaction_id: interactionId,
+                trace_id: resolvedTraceId,
+                request_id: core.request_id,
+                request_span_id: core.request_span_id,
+                action_id: core.action_id,
+                interaction_id: core.interaction_id,
             }),
         },
     };

package/dist/index.d.ts

@@ -1,10 +1,11 @@
 import type { InternalMetricsSnapshot } from "./internal/metrics.js";
-import { createCluebaseBrowserSdk } from "./provider/sdk.js";
-import type { CluebaseBrowserSdk, CluebaseConsentState, CluebaseGroupTraits, CluebaseGroupType, CluebaseInitOptions, CluebaseSubjectTraits, CluebaseTrackMetrics, CluebaseTrackProperties } from "./provider/types.js";
+import type { CluebaseConsentState, CluebaseGroupTraits, CluebaseGroupType, CluebaseInitOptions, CluebaseSubjectTraits, CluebaseTrackMetrics, CluebaseTrackProperties } from "./provider/types.js";
 declare const cluebase: {
     init(options: CluebaseInitOptions): void;
     identify(userId: string, traits?: CluebaseSubjectTraits): void;
     group(groupType: CluebaseGroupType, groupKey: string, traits?: CluebaseGroupTraits): void;
+    linkExternalAccount(namespace: string, externalId: string): void;
+    logout(): void;
     reset(): void;
     track(eventName: string, properties?: CluebaseTrackProperties, metrics?: CluebaseTrackMetrics): void;
     setConsent(consent: CluebaseConsentState): void;
@@ -12,10 +13,10 @@ declare const cluebase: {
     close(): Promise<void>;
     getInternalMetrics(): InternalMetricsSnapshot;
     getDiagnostics(): import("./exporter/diagnostics.js").DiagnosticsSnapshot;
+    withActionContext<T>(callback: () => T): T;
 };
 export { EXPORT_RESULT_FAILED, EXPORT_RESULT_SUCCESS, ObservationSourceEventExporter, type ObservationSourceEventExporterOptions, } from "./exporter/observation-source-event-exporter.js";
 export { attachNextRouterIntegration } from "./integrations/next-router.js";
 export { attachReactRouterIntegration } from "./integrations/react-router.js";
-export type { CluebaseBrowserSdk, CluebaseConsentState, CluebaseGroupTraits, CluebaseGroupType, CluebaseInitOptions, CluebaseSubjectTraits, CluebaseTrackMetrics, CluebaseTrackProperties, InternalMetricsSnapshot, };
-export { createCluebaseBrowserSdk };
+export type { CluebaseConsentState, CluebaseGroupTraits, CluebaseGroupType, CluebaseInitOptions, CluebaseSubjectTraits, CluebaseTrackMetrics, CluebaseTrackProperties, InternalMetricsSnapshot, };
 export default cluebase;

package/dist/index.js

@@ -1,5 +1,6 @@
 import { parseSendableUrl } from "./provider/config.js";
 import { createCluebaseBrowserSdk } from "./provider/sdk.js";
+import { reportSdkError } from "./provider/sdk-error.js";
 const GLOBAL_SDK_KEY = "__cluebase_frontend_sdk_singleton__";
 const globalWithCluebaseSdk = globalThis;
 const existingSdk = globalWithCluebaseSdk[GLOBAL_SDK_KEY];
@@ -7,7 +8,8 @@ const internalSdk = existingSdk ?? createCluebaseBrowserSdk();
 if (!existingSdk) {
     globalWithCluebaseSdk[GLOBAL_SDK_KEY] = internalSdk;
 }
-const reportPublicSdkError = (operation) => {
+const reportPublicSdkError = (operation, error) => {
+    reportSdkError(operation, error);
     try {
         if (typeof console !== "undefined" && typeof console.warn === "function") {
             console.warn(`[cluebase] ${operation} failed`, {
@@ -15,23 +17,22 @@ const reportPublicSdkError = (operation) => {
             });
         }
     }
-    catch {
-    }
+    catch { }
 };
 const safeCall = (operation, callback) => {
     try {
         callback();
     }
-    catch {
-        reportPublicSdkError(operation);
+    catch (error) {
+        reportPublicSdkError(operation, error);
     }
 };
 const safeAsyncCall = async (operation, callback) => {
     try {
         await callback();
     }
-    catch {
-        reportPublicSdkError(operation);
+    catch (error) {
+        reportPublicSdkError(operation, error);
     }
 };
 const REMOVED_PRIVACY_OPTIONS = {
@@ -42,7 +43,9 @@ const REMOVED_PRIVACY_OPTIONS = {
         "and select those fields in the Cluebase privacy screen instead. Until then " +
         "every value stays masked.",
 };
-const REQUIRED_INIT_OPTIONS = ["projectKey"];
+const REQUIRED_INIT_OPTIONS = [
+    "projectKey",
+];
 const validateInitOptions = (options) => {
     const privacy = options.privacy ?? {};
     for (const [name, message] of Object.entries(REMOVED_PRIVACY_OPTIONS)) {
@@ -62,8 +65,7 @@ const validateInitOptions = (options) => {
             "projectKey=NEXT_PUBLIC_CLUEBASE_PROJECT_KEY. The endpoint is optional " +
             "and defaults to the hosted Cluebase API.");
     }
-    if (options.endpoint !== undefined &&
-        typeof options.endpoint !== "string") {
+    if (options.endpoint !== undefined && typeof options.endpoint !== "string") {
         throw new Error("cluebase.init: 'endpoint' must be a string when provided. Omit it to " +
             "use the hosted Cluebase endpoint.");
     }
@@ -95,6 +97,14 @@ const cluebase = {
             internalSdk.setOrganization(groupKey, traits);
         });
     },
+    linkExternalAccount(namespace, externalId) {
+        safeCall("linkExternalAccount", () => {
+            internalSdk.linkExternalAccount(namespace, externalId);
+        });
+    },
+    logout() {
+        safeCall("logout", () => internalSdk.logout());
+    },
     reset() {
         safeCall("reset", () => internalSdk.reset());
     },
@@ -120,9 +130,11 @@ const cluebase = {
     getDiagnostics() {
         return internalSdk.getDiagnostics();
     },
+    withActionContext(callback) {
+        return internalSdk.withActionContext(callback);
+    },
 };
 export { EXPORT_RESULT_FAILED, EXPORT_RESULT_SUCCESS, ObservationSourceEventExporter, } from "./exporter/observation-source-event-exporter.js";
 export { attachNextRouterIntegration } from "./integrations/next-router.js";
 export { attachReactRouterIntegration } from "./integrations/react-router.js";
-export { createCluebaseBrowserSdk };
 export default cluebase;

package/dist/instrumentation/action.js

@@ -1,6 +1,6 @@
 import { buildLocalTextDescriptor, buildLocalValueDescriptor, } from "../exporter/local-minimization.js";
-import { extractFieldName, extractFieldType, getElementAriaLabel, getElementClassList, getElementLabel, getElementPlaceholder, getElementRole, getElementSectionHeading, isEditableElement, resolveClickDisplayTarget, resolveInteractionScopeDescriptor, resolveStableKeyDescriptor, shouldCaptureClickTarget, } from "./dom.js";
 import { buildPrimaryActionKey } from "./common.js";
+import { extractFieldName, extractFieldType, getElementAriaLabel, getElementClassList, getElementLabel, getElementPlaceholder, getElementRole, getElementSectionHeading, isEditableElement, resolveClickDisplayTarget, resolveInteractionScopeDescriptor, resolveStableKeyDescriptor, shouldCaptureClickTarget, } from "./dom.js";
 import { getCurrentPageSnapshot } from "./location.js";
 import { buildScreenActionNamingEvidence } from "./naming-evidence.js";
 const ariaToggleRoles = new Set([
@@ -37,14 +37,12 @@ const ensureCssEscape = () => {
 };
 const emitElementClicked = (context, target, occurredAtMs, event) => {
     const displayTarget = resolveClickDisplayTarget(target);
-    if (context.shouldIgnoreElement?.(displayTarget)) {
-        return;
-    }
     if (!shouldCaptureClickTarget(displayTarget)) {
         return;
     }
     const stableKey = resolveStableKeyDescriptor(displayTarget);
     const interactionScope = resolveInteractionScopeDescriptor(displayTarget);
+    const pageSnapshot = getCurrentPageSnapshot();
     const interactionId = context.startInteraction?.({
         nowMs: occurredAtMs,
         interactionInitiator: "click",
@@ -59,6 +57,7 @@ const emitElementClicked = (context, target, occurredAtMs, event) => {
         occurredAtMs,
         payload: {
             viewId: context.getViewId(),
+            screenKey: pageSnapshot.screenKey,
             ...(interactionId
                 ? {
                     interactionId,
@@ -68,7 +67,7 @@ const emitElementClicked = (context, target, occurredAtMs, event) => {
                 : {}),
             elementTag: displayTarget.tagName.toLowerCase(),
             elementRole: getElementRole(displayTarget),
-            primaryActionKey: buildPrimaryActionKey(getCurrentPageSnapshot().screenKey, stableKey.stableKey),
+            primaryActionKey: buildPrimaryActionKey(pageSnapshot.screenKey, stableKey.stableKey),
             stableKey: stableKey.stableKey,
             stableKeyQuality: stableKey.stableKeyQuality,
             formKey: stableKey.formKey,
@@ -93,9 +92,10 @@ const emitElementClicked = (context, target, occurredAtMs, event) => {
         },
     });
     context.bindEventContext?.(event);
-    maybeEmitAriaToggleChanged(context, displayTarget);
+    context.requestFlush?.();
+    maybeEmitAriaToggleChanged(context, displayTarget, pageSnapshot.screenKey);
 };
-const maybeEmitAriaToggleChanged = (context, element) => {
+const maybeEmitAriaToggleChanged = (context, element, screenKey) => {
     if (isNativeToggleInput(element)) {
         return;
     }
@@ -105,7 +105,7 @@ const maybeEmitAriaToggleChanged = (context, element) => {
     }
     window.setTimeout(() => {
         try {
-            if (!element.isConnected || context.shouldIgnoreElement?.(element)) {
+            if (!element.isConnected) {
                 return;
             }
             const stableKey = resolveStableKeyDescriptor(element);
@@ -116,6 +116,7 @@ const maybeEmitAriaToggleChanged = (context, element) => {
                 occurredAtMs: Date.now(),
                 payload: {
                     viewId: context.getViewId(),
+                    screenKey,
                     elementTag: element.tagName.toLowerCase(),
                     elementRole: role,
                     stableKey: stableKey.stableKey,

package/dist/instrumentation/dom.js

@@ -158,11 +158,11 @@ const getAssociatedLabel = (element) => {
         if (label) {
             return label.replace(/\s+/g, " ").slice(0, 120);
         }
-    }
-    const closestLabel = element.closest("label");
-    const closestLabelText = closestLabel?.textContent?.trim();
-    if (closestLabelText) {
-        return closestLabelText.replace(/\s+/g, " ").slice(0, 120);
+        const closestLabel = element.closest("label");
+        const closestLabelText = closestLabel?.textContent?.trim();
+        if (closestLabelText) {
+            return closestLabelText.replace(/\s+/g, " ").slice(0, 120);
+        }
     }
     return null;
 };
@@ -173,6 +173,10 @@ const readElementContentLabel = (element) => {
         (element instanceof HTMLElement && element.isContentEditable)) {
         return null;
     }
+    const role = getElementRole(element);
+    if (!role || !CLICK_ACTION_ROLES.has(role)) {
+        return null;
+    }
     const ownText = Array.from(element.childNodes)
         .filter((node) => node.nodeType === Node.TEXT_NODE)
         .map((node) => node.textContent?.trim() ?? "")
@@ -182,26 +186,11 @@ const readElementContentLabel = (element) => {
     if (ownText) {
         return ownText.slice(0, 120);
     }
-    const isInteractiveDisplayTarget = element instanceof HTMLButtonElement ||
-        element instanceof HTMLAnchorElement ||
-        element.getAttribute("role") === "button" ||
-        element.getAttribute("role") === "link";
     const descendantCandidates = Array.from(element.querySelectorAll("label, p, span, strong, em, small, button, a, [role='button'], [role='link']"))
         .map((candidate) => candidate.textContent?.trim() ?? "")
         .map((value) => value.replace(/\s+/g, " ").trim())
         .filter((value) => value.length > 0 && value.length <= 80);
-    if (isInteractiveDisplayTarget && descendantCandidates.length > 0) {
-        return descendantCandidates[0] ?? null;
-    }
     if (descendantCandidates.length > 0) {
-        descendantCandidates.sort((left, right) => {
-            const leftWordCount = left.split(/\s+/).length;
-            const rightWordCount = right.split(/\s+/).length;
-            if (leftWordCount !== rightWordCount) {
-                return leftWordCount - rightWordCount;
-            }
-            return left.length - right.length;
-        });
         return descendantCandidates[0] ?? null;
     }
     return getTextPreview(element);
@@ -246,7 +235,10 @@ export const getAccessibleName = (element) => {
     }
     const title = getElementTitle(element);
     if (title?.trim()) {
-        return { name: title.trim().replace(/\s+/g, " ").slice(0, 120), source: "title" };
+        return {
+            name: title.trim().replace(/\s+/g, " ").slice(0, 120),
+            source: "title",
+        };
     }
     return null;
 };

package/dist/instrumentation/drag.js

@@ -31,9 +31,6 @@ export const startDragCapture = (context) => {
         if (!(target instanceof Element)) {
             return;
         }
-        if (context.shouldIgnoreElement?.(target)) {
-            return;
-        }
         try {
             const stableKey = resolveStableKeyDescriptor(target);
             const interactionScope = resolveInteractionScopeDescriptor(target);

package/dist/instrumentation/error.js

@@ -54,7 +54,9 @@ const readStringAttribute = (logRecord, key) => {
 };
 const readNumberAttribute = (logRecord, key) => {
     const value = logRecord.attributes?.[key];
-    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+    return typeof value === "number" && Number.isFinite(value)
+        ? value
+        : undefined;
 };
 export const startErrorCapture = (context) => {
     if (typeof window === "undefined") {