@kubesense/kubesense-browser-rum-core 1.8.0 → 2.0.0-beta.1

package/esm/domain/configuration/configuration.mjs

@@ -0,0 +1,474 @@
+import { getRemoteConfigurationId } from "./remoteConfiguration.mjs";
+import { isIndexableObject, isMatchOption } from "@kubesense/kubesense-js-core/util";
+import { BROWSER_CORE_SCHEMA, DefaultPrivacyLevel, TraceContextInjection, canUseEventBridge, catchUserErrors, display, isNonEmptyArray, isNumber, serializeConfiguration } from "@kubesense/kubesense-browser-core";
+import { validateAndBuildConfiguration } from "@kubesense/kubesense-js-core/configuration";
+//#region src/domain/configuration/configuration.ts
+const DEFAULT_PROPAGATOR_TYPES = ["tracecontext", "kubesense"];
+/**
+* Default list of headers collected on resource events when {@link RumInitConfiguration.trackResourceHeaders | trackResourceHeaders}
+* is set to `true`.
+*/
+const DEFAULT_TRACKED_RESOURCE_HEADERS = [
+	"cache-control",
+	"etag",
+	"age",
+	"expires",
+	"content-type",
+	"content-encoding",
+	"vary",
+	"content-length",
+	"server-timing",
+	"x-cache",
+	"cf-cache-status",
+	"x-vercel-cache"
+];
+/**
+* Recording quality presets for canvas capture. See {@link RumInitConfiguration.sessionReplayCanvasRecording}.
+*
+* | Preset   | Frames per second | Longest side | WebP quality |
+* | -------- | ----------------- | ------------ | ------------ |
+* | `low`    | 1                 | 600 px       | 0.3          |
+* | `medium` | 4                 | 1000 px      | 0.5          |
+* | `high`   | 8                 | 1280 px      | 0.75         |
+*
+* @example
+* ```ts
+* kubesenseSdk.init({
+*   // ...
+*   sessionReplayCanvasRecording: {
+*     enable: true,
+*     quality: CanvasRecordingQuality.MEDIUM,
+*   },
+* })
+* ```
+*/
+const CanvasRecordingQuality = {
+	LOW: "low",
+	MEDIUM: "medium",
+	HIGH: "high"
+};
+const CANVAS_RECORDING_QUALITY_PRESETS = {
+	[CanvasRecordingQuality.LOW]: {
+		maxFramesPerSecond: 1,
+		hashingMaxDimension: 50,
+		maxImageDimension: 600,
+		encodeQuality: .3
+	},
+	[CanvasRecordingQuality.MEDIUM]: {
+		maxFramesPerSecond: 4,
+		hashingMaxDimension: 100,
+		maxImageDimension: 1e3,
+		encodeQuality: .5
+	},
+	[CanvasRecordingQuality.HIGH]: {
+		maxFramesPerSecond: 8,
+		hashingMaxDimension: 100,
+		maxImageDimension: 1280,
+		encodeQuality: .75
+	}
+};
+/**
+* Upstream gates canvas recording behind the `session_replay_record_canvas` experimental flag; in
+* this SDK it is a regular option. The preset's values can be overridden one by one, which is how the
+* dashboard's remote configuration tunes them.
+*/
+function resolveCanvasRecordingConfiguration(configuration) {
+	const preset = configuration && CANVAS_RECORDING_QUALITY_PRESETS[configuration.quality];
+	if (!configuration?.enable || !preset) return;
+	return {
+		enable: true,
+		...preset,
+		maxFramesPerSecond: configuration.maxFramesPerSecond ?? preset.maxFramesPerSecond,
+		maxImageDimension: configuration.maxImageDimension ?? preset.maxImageDimension,
+		hashingMaxDimension: configuration.hashingMaxDimension ?? preset.hashingMaxDimension
+	};
+}
+const RUM_SCHEMA = {
+	...BROWSER_CORE_SCHEMA,
+	applicationId: {
+		type: "string",
+		required: true
+	},
+	actionNameAttribute: { type: "string" },
+	workerUrl: { type: "string" },
+	subdomain: { type: "string" },
+	sessionReplaySampleRate: {
+		type: "percentage",
+		default: 0
+	},
+	traceSampleRate: {
+		type: "percentage",
+		default: 100
+	},
+	profilingSampleRate: {
+		type: "percentage",
+		default: 0
+	},
+	compressIntakeRequests: {
+		type: "boolean",
+		default: false
+	},
+	trackUserInteractions: {
+		type: "boolean",
+		default: true,
+		strict: false
+	},
+	trackResources: {
+		type: "boolean",
+		default: true,
+		strict: false
+	},
+	trackLongTasks: {
+		type: "boolean",
+		default: true,
+		strict: false
+	},
+	trackViewsManually: {
+		type: "boolean",
+		default: false,
+		strict: false
+	},
+	betaEnableViewUpdates: { type: "boolean" },
+	betaTrackWebSockets: {
+		type: "boolean",
+		default: false,
+		strict: false
+	},
+	enablePrivacyForActionName: {
+		type: "boolean",
+		default: true
+	},
+	propagateTraceBaggage: {
+		type: "boolean",
+		default: true
+	},
+	startSessionReplayRecordingManually: {
+		type: "boolean",
+		default: false,
+		strict: false
+	},
+	enableRemoteSdkConfiguration: {
+		type: "boolean",
+		default: false,
+		strict: false
+	},
+	firstPartyDomains: {
+		type: "match-option",
+		multiple: true,
+		default: []
+	},
+	sessionReplayRoutes: {
+		type: "schema",
+		strict: false,
+		schema: {
+			include: {
+				type: "match-option",
+				multiple: true,
+				strict: false
+			},
+			exclude: {
+				type: "match-option",
+				multiple: true,
+				strict: false
+			}
+		}
+	},
+	sessionReplayCanvasRecording: {
+		type: "schema",
+		schema: {
+			enable: {
+				type: "boolean",
+				required: true
+			},
+			quality: {
+				type: "enum",
+				values: CanvasRecordingQuality,
+				default: CanvasRecordingQuality.MEDIUM
+			},
+			maxFramesPerSecond: {
+				type: "number",
+				min: 0,
+				max: 8
+			},
+			maxImageDimension: {
+				type: "number",
+				min: 1,
+				max: 1280
+			},
+			hashingMaxDimension: {
+				type: "number",
+				min: 1,
+				max: 100
+			}
+		}
+	},
+	defaultPrivacyLevel: {
+		type: "enum",
+		values: DefaultPrivacyLevel,
+		default: DefaultPrivacyLevel.MASK_USER_INPUT,
+		strict: false
+	},
+	traceContextInjection: {
+		type: "enum",
+		values: TraceContextInjection,
+		default: TraceContextInjection.SAMPLED,
+		strict: false
+	},
+	excludedActivityUrls: {
+		type: "match-option",
+		multiple: true,
+		default: []
+	},
+	allowedTracingUrls: {
+		type: "union",
+		multiple: true,
+		strict: false,
+		default: [],
+		variants: [{ type: "match-option" }, {
+			type: "schema",
+			schema: {
+				match: {
+					type: "match-option",
+					required: true
+				},
+				propagatorTypes: {
+					type: "enum",
+					values: [
+						"kubesense",
+						"b3",
+						"b3multi",
+						"tracecontext"
+					],
+					multiple: true,
+					strict: false,
+					default: DEFAULT_PROPAGATOR_TYPES
+				}
+			}
+		}]
+	},
+	plugins: {
+		type: "schema",
+		multiple: true,
+		strict: false,
+		default: [],
+		schema: {
+			name: {
+				type: "string",
+				required: true
+			},
+			getConfigurationTelemetry: {
+				type: "function",
+				strict: false,
+				signature: void 0
+			},
+			onInit: {
+				type: "function",
+				strict: false,
+				signature: void 0
+			},
+			onRumStart: {
+				type: "function",
+				strict: false,
+				signature: void 0
+			}
+		}
+	},
+	trackFeatureFlagsForEvents: {
+		type: "enum",
+		values: [
+			"vital",
+			"action",
+			"long_task",
+			"resource"
+		],
+		multiple: true,
+		strict: false,
+		default: []
+	}
+};
+/**
+* Resolves whether partial view updates are enabled. Never enabled when the event bridge is used.
+* Otherwise an explicit `betaEnableViewUpdates` takes precedence, and it defaults to true for CDN
+* users that do not go through a proxy: a proxy may not forward the `view_update` event type yet,
+* and npm users pin an SDK version so they opt in explicitly.
+*
+* The CDN check is temporary, the next step is to default this to true unless `proxy` is set.
+* TODO next major: remove the option.
+*/
+function isViewUpdatesEnabled(explicit, proxy, sdkName) {
+	if (canUseEventBridge()) return false;
+	return explicit ?? false;
+}
+function validateAndBuildRumConfiguration(initConfiguration, sdkName) {
+	const config = validateAndBuildConfiguration(initConfiguration, RUM_SCHEMA, display);
+	if (!config) return;
+	const allowedTracingUrls = config.allowedTracingUrls.map(normalizeTracingOption).filter(Boolean);
+	if (allowedTracingUrls.length > 0 && !config.service) {
+		display.error("Service needs to be configured when tracing is enabled");
+		return;
+	}
+	const sessionReplayCanvasRecording = resolveCanvasRecordingConfiguration(config.sessionReplayCanvasRecording);
+	return {
+		...config,
+		service: config.service || config.applicationId,
+		sessionReplayCanvasRecording,
+		betaEnableViewUpdates: isViewUpdatesEnabled(config.betaEnableViewUpdates, config.proxy, sdkName),
+		allowedTracingUrls,
+		beforeSend: config.beforeSend ? catchUserErrors(config.beforeSend, "beforeSend threw an error:") : void 0,
+		rulePsr: isNumber(initConfiguration.traceSampleRate) ? initConfiguration.traceSampleRate / 100 : void 0,
+		trackResourceHeaders: validateAndBuildTrackResourceHeaders(initConfiguration),
+		allowedGraphQlUrls: validateAndBuildGraphQlOptions(initConfiguration),
+		remoteConfigurationId: getRemoteConfigurationId(initConfiguration)
+	};
+}
+/**
+* Combines the selected tracing propagators from the different options in allowedTracingUrls
+*/
+function getSelectedTracingPropagators(configuration) {
+	const usedTracingPropagators = /* @__PURE__ */ new Set();
+	if (isNonEmptyArray(configuration.allowedTracingUrls)) configuration.allowedTracingUrls.forEach((option) => {
+		normalizeTracingOption(option)?.propagatorTypes.forEach((propagatorType) => usedTracingPropagators.add(propagatorType));
+	});
+	return Array.from(usedTracingPropagators);
+}
+function normalizeTracingOption(option) {
+	if (isMatchOption(option)) return {
+		match: option,
+		propagatorTypes: DEFAULT_PROPAGATOR_TYPES
+	};
+	if (isIndexableObject(option) && isMatchOption(option.match) && (option.propagatorTypes === null || option.propagatorTypes === void 0 || Array.isArray(option.propagatorTypes))) return {
+		match: option.match,
+		propagatorTypes: option.propagatorTypes || DEFAULT_PROPAGATOR_TYPES
+	};
+}
+/**
+* Build GraphQL options from configuration
+*/
+function validateAndBuildGraphQlOptions(initConfiguration) {
+	if (!initConfiguration.allowedGraphQlUrls) return [];
+	if (!Array.isArray(initConfiguration.allowedGraphQlUrls)) {
+		display.warn("allowedGraphQlUrls should be an array");
+		return [];
+	}
+	const graphQlOptions = [];
+	initConfiguration.allowedGraphQlUrls.forEach((option) => {
+		if (isMatchOption(option)) graphQlOptions.push({
+			match: option,
+			trackPayload: false,
+			trackResponseErrors: false
+		});
+		else if (isIndexableObject(option) && isMatchOption(option.match)) graphQlOptions.push({
+			match: option.match,
+			trackPayload: !!option.trackPayload,
+			trackResponseErrors: !!option.trackResponseErrors
+		});
+	});
+	return graphQlOptions;
+}
+const VALID_HEADER_LOCATIONS = [
+	"request",
+	"response",
+	"any"
+];
+function validateAndBuildTrackResourceHeaders(initConfiguration) {
+	const option = initConfiguration.trackResourceHeaders;
+	if (option === void 0 || option === false) return [];
+	if (option === true) return DEFAULT_TRACKED_RESOURCE_HEADERS.map((name) => ({ name }));
+	if (!Array.isArray(option)) {
+		display.warn("trackResourceHeaders should be true or an array of MatchHeader");
+		return [];
+	}
+	if (option.length === 0) {
+		display.warn("trackResourceHeaders is an empty array, no headers will be captured");
+		return [];
+	}
+	const result = [];
+	option.forEach((item, index) => {
+		if (!isIndexableObject(item)) {
+			display.warn(`trackResourceHeaders[${index}] should be a MatchHeader object`);
+			return;
+		}
+		if (item.name !== void 0 && !isMatchOption(item.name)) {
+			display.warn(`trackResourceHeaders[${index}].name should be a MatchOption`);
+			return;
+		}
+		if (item.url !== void 0 && !isMatchOption(item.url)) {
+			display.warn(`trackResourceHeaders[${index}].url should be a MatchOption`);
+			return;
+		}
+		if (item.extractor !== void 0 && !(item.extractor instanceof RegExp)) {
+			display.warn(`trackResourceHeaders[${index}].extractor should be a RegExp`);
+			return;
+		}
+		if (item.location !== void 0 && (typeof item.location !== "string" || !VALID_HEADER_LOCATIONS.includes(item.location))) {
+			display.warn(`trackResourceHeaders[${index}].location should be 'request', 'response', or 'any'`);
+			return;
+		}
+		const { name, ...rest } = item;
+		result.push({
+			...rest,
+			...name !== void 0 ? { name: typeof name === "string" ? name.toLowerCase() : name } : {}
+		});
+	});
+	return result;
+}
+function hasGraphQlPayloadTracking(allowedGraphQlUrls) {
+	return isNonEmptyArray(allowedGraphQlUrls) && allowedGraphQlUrls.some((option) => isIndexableObject(option) && option.trackPayload);
+}
+function hasGraphQlResponseErrorsTracking(allowedGraphQlUrls) {
+	return isNonEmptyArray(allowedGraphQlUrls) && allowedGraphQlUrls.some((option) => isIndexableObject(option) && option.trackResponseErrors);
+}
+function getTrackResourceHeadersTelemetryValue(trackResourceHeaders) {
+	if (trackResourceHeaders === true) return "default_headers";
+	if (Array.isArray(trackResourceHeaders)) return "custom";
+}
+function serializeRumConfiguration(configuration, sdkName, remoteConfigurationMetadata) {
+	const baseSerializedConfiguration = serializeConfiguration(configuration);
+	return {
+		session_replay_sample_rate: configuration.sessionReplaySampleRate,
+		start_session_replay_recording_manually: configuration.startSessionReplayRecordingManually,
+		trace_sample_rate: configuration.traceSampleRate,
+		trace_context_injection: configuration.traceContextInjection,
+		propagate_trace_baggage: configuration.propagateTraceBaggage,
+		action_name_attribute: configuration.actionNameAttribute,
+		use_allowed_tracing_urls: isNonEmptyArray(configuration.allowedTracingUrls),
+		use_allowed_graph_ql_urls: isNonEmptyArray(configuration.allowedGraphQlUrls),
+		use_track_graph_ql_payload: hasGraphQlPayloadTracking(configuration.allowedGraphQlUrls),
+		use_track_graph_ql_response_errors: hasGraphQlResponseErrorsTracking(configuration.allowedGraphQlUrls),
+		selected_tracing_propagators: getSelectedTracingPropagators(configuration),
+		default_privacy_level: configuration.defaultPrivacyLevel,
+		enable_privacy_for_action_name: configuration.enablePrivacyForActionName,
+		use_excluded_activity_urls: isNonEmptyArray(configuration.excludedActivityUrls),
+		use_worker_url: !!configuration.workerUrl,
+		compress_intake_requests: configuration.compressIntakeRequests,
+		track_views_manually: configuration.trackViewsManually,
+		track_user_interactions: configuration.trackUserInteractions,
+		track_resources: configuration.trackResources,
+		track_long_task: configuration.trackLongTasks,
+		plugins: configuration.plugins?.map((plugin) => ({
+			name: plugin.name,
+			...plugin.getConfigurationTelemetry?.()
+		})),
+		track_feature_flags_for_events: configuration.trackFeatureFlagsForEvents,
+		remote_configuration_id: getRemoteConfigurationId(configuration),
+		remote_configuration: remoteConfigurationMetadata && {
+			last_modified: remoteConfigurationMetadata.lastModified,
+			last_synced: remoteConfigurationMetadata.lastSynced,
+			first_applied: remoteConfigurationMetadata.firstApplied,
+			sync_id: remoteConfigurationMetadata.syncId
+		},
+		profiling_sample_rate: configuration.profilingSampleRate,
+		use_remote_configuration_proxy: !!configuration.remoteConfigurationProxy,
+		enable_remote_sdk_configuration: !!configuration.enableRemoteSdkConfiguration,
+		use_session_replay_routes: !!configuration.sessionReplayRoutes && (isNonEmptyArray(configuration.sessionReplayRoutes.include) || isNonEmptyArray(configuration.sessionReplayRoutes.exclude)),
+		use_first_party_domains: isNonEmptyArray(configuration.firstPartyDomains),
+		track_resource_headers: getTrackResourceHeadersTelemetryValue(configuration.trackResourceHeaders),
+		beta_enable_view_updates: isViewUpdatesEnabled(configuration.betaEnableViewUpdates, configuration.proxy, sdkName),
+		beta_track_web_sockets: configuration.betaTrackWebSockets,
+		...baseSerializedConfiguration
+	};
+}
+//#endregion
+export { CanvasRecordingQuality, DEFAULT_PROPAGATOR_TYPES, DEFAULT_TRACKED_RESOURCE_HEADERS, RUM_SCHEMA, serializeRumConfiguration, validateAndBuildRumConfiguration };
+
+//# sourceMappingURL=configuration.mjs.map

package/esm/domain/configuration/configuration.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.mjs","names":[],"sources":["../../../src/domain/configuration/configuration.ts"],"sourcesContent":["import type { InitConfiguration, RawTelemetryConfiguration } from '@kubesense/kubesense-browser-core'\nimport {\n  canUseEventBridge,\n  catchUserErrors,\n  serializeConfiguration,\n  DefaultPrivacyLevel,\n  TraceContextInjection,\n  display,\n  isNumber,\n  isNonEmptyArray,\n  BROWSER_CORE_SCHEMA,\n} from '@kubesense/kubesense-browser-core'\nimport { isIndexableObject, isMatchOption } from '@kubesense/kubesense-js-core/util'\nimport { validateAndBuildConfiguration } from '@kubesense/kubesense-js-core/configuration'\nimport type { InferredConfig, MatchOption } from '@kubesense/kubesense-js-core/configuration'\nimport type { RumEventDomainContext } from '../../domainContext.types'\nimport type { RumEvent } from '../../rumEvent.types'\nimport type { SdkName } from '../contexts/defaultContext'\nimport type { RumPlugin } from '../plugins'\nimport type { PropagatorType, TracingOption } from '../tracing/tracer.types'\nimport { getRemoteConfigurationId } from './remoteConfiguration'\nimport type { RemoteConfigurationMetadata } from './remoteConfigurationCache'\nimport type { SessionReplayRoutes } from './sessionReplayRoutes'\n\n// replaced at build time\ndeclare const __BUILD_ENV__SDK_SETUP__: string\n\nexport const DEFAULT_PROPAGATOR_TYPES: PropagatorType[] = ['tracecontext', 'kubesense']\n\n/**\n * Default list of headers collected on resource events when {@link RumInitConfiguration.trackResourceHeaders | trackResourceHeaders}\n * is set to `true`.\n */\nexport const DEFAULT_TRACKED_RESOURCE_HEADERS = [\n  'cache-control',\n  'etag',\n  'age',\n  'expires',\n  'content-type',\n  'content-encoding',\n  'vary',\n  'content-length',\n  'server-timing',\n  'x-cache',\n  'cf-cache-status',\n  'x-vercel-cache',\n] as const\n\n/**\n * Init Configuration for the RUM browser SDK.\n *\n * @category Main\n * @example NPM\n * ```ts\n * import { kubesenseSdk } from '@kubesense/kubesense-browser-rum'\n *\n * kubesenseSdk.init({\n *   applicationId: '<KUBESENSE_APPLICATION_ID>',\n *   clientToken: '<KUBESENSE_CLIENT_TOKEN>',\n *   kubesenseRumEndpoint: '<KUBESENSE_RUM_ENDPOINT>',\n *   // ...\n * })\n * ```\n * @example CDN\n * ```ts\n * KUBESENSE_SDK.init({\n *   applicationId: '<KUBESENSE_APPLICATION_ID>',\n *   clientToken: '<KUBESENSE_CLIENT_TOKEN>',\n *   kubesenseRumEndpoint: '<KUBESENSE_RUM_ENDPOINT>',\n *   ...\n * })\n * ```\n */\nexport interface RumInitConfiguration extends InitConfiguration {\n  // global options\n  /**\n   * The RUM application ID.\n   *\n   * @category Authentication\n   */\n  applicationId: string\n\n  /**\n   * The service name for your application. Follows the [tag syntax requirements](https://docs.kubesense.ai/getting_started/tagging/#define-tags).\n   *\n   * `allowedTracingUrls` still requires an explicitly configured service.\n   *\n   * @category Data Collection\n   * @defaultValue the `applicationId`\n   */\n  service?: string | undefined | null\n\n  /**\n   * Whether to propagate user and account IDs in the baggage header of trace requests.\n   *\n   * @category Tracing\n   * @defaultValue true\n   */\n  propagateTraceBaggage?: boolean | undefined\n\n  /**\n   * Access to every event collected by the RUM SDK before they are sent to KubeSense.\n   * It allows:\n   * - Enrich your RUM events with additional context attributes\n   * - Modify your RUM events to modify their content, or redact sensitive sequences (see the list of editable properties)\n   * - Discard selected RUM events\n   *\n   * See [Enrich And Control Browser RUM Data With beforeSend](https://docs.kubesense.ai/real_user_monitoring/guide/enrich-and-control-rum-data) for further information.\n   *\n   * @category Data Collection\n   */\n  beforeSend?: RumBeforeSend | undefined\n\n  /**\n   * A list of request origins ignored when computing the page activity.\n   * See [How page activity is calculated](https://docs.kubesense.ai/real_user_monitoring/browser/monitoring_page_performance/#how-page-activity-is-calculated) for further information.\n   */\n  excludedActivityUrls?: MatchOption[] | undefined\n\n  /**\n   * URL pointing to the KubeSense Browser SDK Worker JavaScript file. The URL can be relative or absolute, but is required to have the same origin as the web application.\n   * See [Content Security Policy guidelines](https://docs.kubesense.ai/integrations/content_security_policy_logs/?tab=firefox#use-csp-with-real-user-monitoring-and-session-replay) for further information.\n   *\n   * @category Transport\n   */\n  workerUrl?: string\n\n  /**\n   * Compress requests sent to the KubeSense intake to reduce bandwidth usage when sending large amounts of data. The compression is done in a Worker thread.\n   * See [Content Security Policy guidelines](https://docs.kubesense.ai/integrations/content_security_policy_logs/?tab=firefox#use-csp-with-real-user-monitoring-and-session-replay) for further information.\n   *\n   * @category Transport\n   */\n  compressIntakeRequests?: boolean | undefined\n\n  /**\n   * [Internal option] Id of the remote configuration.\n   * Prefer `remoteConfiguration.id` for the non-blocking cache-and-reload path.\n   *\n   * @internal\n   */\n  remoteConfigurationId?: string | undefined\n\n  /**\n   * [Internal option] Remote configuration descriptor. By default the SDK reads a cached\n   * configuration synchronously and refreshes it in the background. Set `sync: true` to fall back\n   * to the legacy blocking fetch. Set `required: true` to prevent the SDK from starting on the\n   * current page load when the remote configuration cache is empty or unreadable (the background\n   * fetch still runs to populate the cache for the next load). Ignored when `sync: true` is set\n   * or when the legacy `remoteConfigurationId` field is used.\n   *\n   * @internal\n   */\n  remoteConfiguration?: { id: string; sync?: boolean; required?: boolean } | undefined\n\n  /**\n   * [Internal option] set a proxy URL for the remote configuration\n   *\n   * @internal\n   */\n  remoteConfigurationProxy?: string | undefined\n\n  /**\n   * Enable dashboard-managed SDK settings served by the KubeSense collector.\n   *\n   * The configuration document is fetched asynchronously after the SDK starts and cached in\n   * local storage, so it never delays initialization. Cached settings are applied on the next\n   * page load. Local `init()` values are used until a document has been fetched, and any\n   * setting absent from the document keeps its local value.\n   *\n   * @category Data Collection\n   * @defaultValue false\n   */\n  enableRemoteSdkConfiguration?: boolean | undefined\n\n  /**\n   * Restrict Session Replay recording to specific routes.\n   *\n   * Recording starts and stops as the user navigates: it runs only while the current route\n   * matches `include` (when provided) and does not match `exclude`. Rules are matched against\n   * the path (`pathname` + `search` + `hash`), and string entries match by prefix, so\n   * `/checkout` also covers `/checkout/payment`.\n   *\n   * These rules only narrow recording — a session that was not sampled in by\n   * `sessionReplaySampleRate` is never recorded, whatever the routes say.\n   *\n   * @category Session Replay\n   * @example\n   * ```ts\n   * sessionReplayRoutes: { include: ['/checkout', '/signup'], exclude: ['/checkout/card'] }\n   * ```\n   */\n  sessionReplayRoutes?: SessionReplayRoutes | undefined\n\n  /**\n   * A list of domains to treat as first-party in resource provider classification.\n   * Accepts strings (exact hostname match), RegExp, or functions.\n   * The current page hostname is always treated as first-party.\n   *\n   * @category Data Collection\n   * @example ['api.myapp.com', /\\.myapp\\.com$/, (host) => host.endsWith('.internal')]\n   */\n  firstPartyDomains?: MatchOption[] | undefined\n\n  // tracing options\n  /**\n   * A list of request URLs used to inject tracing headers.\n   * See [Connect RUM and Traces](https://docs.kubesense.ai/real_user_monitoring/platform/connect_rum_and_traces/?tab=browserrum) for further information.\n   *\n   * @category Tracing\n   */\n  allowedTracingUrls?:\n    Array<MatchOption | { match: MatchOption; propagatorTypes?: PropagatorType[] | null | undefined }> | undefined\n\n  /**\n   * The percentage of requests to trace: 100 for all, 0 for none.\n   * See [Connect RUM and Traces](https://docs.kubesense.ai/real_user_monitoring/platform/connect_rum_and_traces/?tab=browserrum) for further information.\n   *\n   * @category Tracing\n   * @defaultValue 100\n   */\n  traceSampleRate?: number | undefined\n  /**\n   * If you set a `traceSampleRate`, to ensure backend services' sampling decisions are still applied, configure the `traceContextInjection` initialization parameter to sampled.\n   *\n   * See [Connect RUM and Traces](https://docs.kubesense.ai/real_user_monitoring/platform/connect_rum_and_traces/?tab=browserrum) for further information.\n   *\n   * @category Tracing\n   * @defaultValue sampled\n   */\n  traceContextInjection?: TraceContextInjection | undefined\n\n  // replay options\n  /**\n   * Allow to protect end user privacy and prevent sensitive organizational information from being collected.\n   *\n   * See [Replay Privacy Options](https://docs.kubesense.ai/real_user_monitoring/session_replay/browser/privacy_options) for further information.\n   *\n   * @category Privacy\n   * @defaultValue mask-user-input\n   */\n  defaultPrivacyLevel?: DefaultPrivacyLevel | undefined\n\n  /**\n   * If you are accessing KubeSense through a custom subdomain, you can set `subdomain` to include your custom domain in the `getSessionReplayLink()` returned URL .\n   *\n   * See [Connect Session Replay To Your Third-Party Tools](https://docs.kubesense.ai/real_user_monitoring/guide/connect-session-replay-to-your-third-party-tools) for further information.\n   *\n   * @category Session Replay\n   */\n  subdomain?: string\n\n  /**\n   * The percentage of tracked sessions with [Browser RUM & Session Replay pricing](https://rum.kubesense.ai/pricing/?product=real-user-monitoring--session-replay#real-user-monitoring--session-replay) features: 100 for all, 0 for none.\n   *\n   * See [Configure Your Setup For Browser RUM and Browser RUM & Session Replay Sampling](https://docs.kubesense.ai/real_user_monitoring/guide/sampling-browser-plans) for further information.\n   *\n   * @category Session Replay\n   * @defaultValue 0\n   */\n  sessionReplaySampleRate?: number | undefined\n\n  /**\n   * If the session is sampled for Session Replay, only start the recording when `startSessionReplayRecording()` is called, instead of at the beginning of the session.\n   *\n   * See [Session Replay Usage](https://docs.kubesense.ai/real_user_monitoring/session_replay/browser/#usage) for further information.\n   *\n   * @category Session Replay\n   * @defaultValue false\n   */\n  startSessionReplayRecordingManually?: boolean | undefined\n\n  /**\n   * Records `<canvas>` content (most chart libraries draw on one) in Session Replay as captured frames.\n   * Canvas recording is disabled when this option is omitted.\n   *\n   * A canvas is captured only when its privacy level is `allow` — set with `data-kubesense-privacy=\"allow\"`\n   * or the `kubesense-privacy-allow` class on it or an ancestor — and only when its content changed.\n   * Frames are WebP images (PNG where the browser cannot encode WebP), uploaded next to the replay\n   * segments and deduplicated by content.\n   *\n   * `quality` picks a preset; the other fields override single values of that preset.\n   *\n   * @category Session Replay\n   */\n  sessionReplayCanvasRecording?:\n    | {\n        /**\n         * Enables recording canvas elements in Session Replay.\n         */\n        enable: boolean\n\n        /**\n         * Trades frame rate and image resolution for bandwidth. See {@link CanvasRecordingQuality}.\n         *\n         * @defaultValue 'medium'\n         */\n        quality?: CanvasRecordingQuality | undefined\n\n        /**\n         * Overrides the preset's maximum number of frames captured per second, between 0 and 8. `0`\n         * stops capturing frames.\n         */\n        maxFramesPerSecond?: number | undefined\n\n        /**\n         * Overrides the preset's longest side of a captured frame, in pixels, between 1 and 1280. Larger\n         * canvases are downscaled proportionally.\n         */\n        maxImageDimension?: number | undefined\n\n        /**\n         * Overrides the preset's size of the thumbnail compared to detect a changed canvas, in pixels,\n         * between 1 and 100.\n         */\n        hashingMaxDimension?: number | undefined\n      }\n    | undefined\n\n  /**\n   * Enables privacy control for action names.\n   *\n   * @category Privacy\n   * @defaultValue true\n   */\n  enablePrivacyForActionName?: boolean | undefined\n\n  /**\n   * Enables automatic collection of users actions.\n   *\n   * Add `data-dd-ignore-frustration` without a value, or set it to `all`, to ignore all frustration signals for an element and its descendants. To ignore specific signals, use a space-separated list of `rage-click`, `dead-click`, and `error-click`.\n   *\n   * See [Tracking User Actions](https://docs.kubesense.ai/real_user_monitoring/browser/tracking_user_actions) for further information.\n   *\n   * @category Data Collection\n   * @defaultValue true\n   */\n  trackUserInteractions?: boolean | undefined\n\n  /**\n   * Specify your own attribute to use to name actions.\n   *\n   * See [Declare a name for click actions](https://docs.kubesense.ai/real_user_monitoring/browser/tracking_user_actions/#declare-a-name-for-click-actions) for further information.\n   *\n   * @category Data Collection\n   */\n  actionNameAttribute?: string | undefined\n\n  // view options\n  /**\n   * Allows you to control RUM views creation. See [Override default RUM view names](https://docs.kubesense.ai/real_user_monitoring/browser/advanced_configuration/?tab=npm#override-default-rum-view-names) for further information.\n   *\n   * @category Data Collection\n   */\n  trackViewsManually?: boolean | undefined\n\n  /**\n   * Enables collection of resource events.\n   *\n   * @category Data Collection\n   * @defaultValue true\n   */\n  trackResources?: boolean | undefined\n\n  /**\n   * Enables collection of request and response headers on resource events.\n   *\n   * - `true`: collect {@link DEFAULT_TRACKED_RESOURCE_HEADERS} for all URLs, both directions\n   * - `MatchHeader[]`: each {@link MatchHeader} targets a header name, with optional URL scope\n   * (`url`), value extraction (`extractor`), and `location`. When `name` is omitted, the matcher\n   * applies to {@link DEFAULT_TRACKED_RESOURCE_HEADERS}. By default, both request and response\n   * headers are captured; set `location` to `'request'` or `'response'` to restrict to one.\n   *\n   * Headers whose names match a built-in sensitive-data pattern are always dropped, regardless\n   * of the configured matchers. The pattern blocks headers whose names contain: `token`, `cookie`,\n   * `secret`, `authorization`, `api-key`, `secret-key`, `access-key`, `app-key`, `client-ip`,\n   * `connecting-ip`, `real-ip`, or `forwarded`.\n   *\n   * @category Data Collection\n   * @defaultValue false (disabled)\n   * @example\n   * // Collect default headers plus custom ones for all URLs\n   * trackResourceHeaders: [{}, { name: 'x-request-id' }]\n   * @example\n   * // Collect default headers from responses only\n   * trackResourceHeaders: [{ location: 'response' }]\n   * @example\n   * // URL-scoped rule: capture specific response headers only for calls to /api\n   * trackResourceHeaders: [{ url: /\\/api\\//, name: 'cache-control', location: 'response' }]\n   * @example\n   * // Extract a partial value from a header\n   * trackResourceHeaders: [{ url: /\\/api\\//, name: 'server-timing', extractor: /dur=(\\d+)/, location: 'response' }]\n   */\n  trackResourceHeaders?: boolean | MatchHeader[] | undefined\n\n  /**\n   * Enables collection of long task events.\n   *\n   * @category Data Collection\n   * @defaultValue true\n   */\n  trackLongTasks?: boolean | undefined\n\n  /**\n   * List of plugins to enable. The plugins API is unstable and experimental, and may change without\n   * notice. Please use only plugins provided by KubeSense matching the version of the SDK you are\n   * using.\n   */\n  plugins?: RumPlugin[] | undefined\n\n  /**\n   * Enables collection of features flags in additional events (e.g. long task, resource, action, vital).\n   *\n   * @category Data Collection\n   */\n  trackFeatureFlagsForEvents?: FeatureFlagsForEvents[]\n\n  /**\n   * The percentage of users profiled. A value between 0 and 100.\n   *\n   * @category Profiling\n   * @defaultValue 0\n   */\n  profilingSampleRate?: number | undefined\n\n  /**\n   * A list of GraphQL endpoint URLs to track and enrich with GraphQL-specific metadata.\n   *\n   * @category Data Collection\n   */\n  allowedGraphQlUrls?: Array<MatchOption | GraphQlUrlOption> | undefined\n\n  /**\n   * Enable partial view updates, which reduces bandwidth by sending only changed\n   * fields instead of full view events on intermediate updates.\n   *\n   * Enabled by default when the SDK is loaded from the CDN and no `proxy` is configured.\n   * Disabled by default otherwise, because a proxy may not forward the `view_update` event type.\n   *\n   * @category Beta\n   */\n  betaEnableViewUpdates?: boolean | undefined\n\n  /**\n   * Enables collection of WebSocket resource events.\n   *\n   * Warning: enabling this option introduces WebSocket resource events to the `beforeSend` hook.\n   * Their domain context is WebSocket-specific and does not contain the XHR, Fetch, or performance\n   * entry fields available on regular resource events. Narrow the context using the existing\n   * `isManual` and `isWebSocket` discriminants before accessing those fields.\n   *\n   * @category Beta\n   */\n  betaTrackWebSockets?: boolean | undefined\n}\n\n/**\n * Recording quality presets for canvas capture. See {@link RumInitConfiguration.sessionReplayCanvasRecording}.\n *\n * | Preset   | Frames per second | Longest side | WebP quality |\n * | -------- | ----------------- | ------------ | ------------ |\n * | `low`    | 1                 | 600 px       | 0.3          |\n * | `medium` | 4                 | 1000 px      | 0.5          |\n * | `high`   | 8                 | 1280 px      | 0.75         |\n *\n * @example\n * ```ts\n * kubesenseSdk.init({\n *   // ...\n *   sessionReplayCanvasRecording: {\n *     enable: true,\n *     quality: CanvasRecordingQuality.MEDIUM,\n *   },\n * })\n * ```\n */\nexport const CanvasRecordingQuality = {\n  LOW: 'low',\n  MEDIUM: 'medium',\n  HIGH: 'high',\n} as const\nexport type CanvasRecordingQuality = (typeof CanvasRecordingQuality)[keyof typeof CanvasRecordingQuality]\n\n/**\n * The resolved canvas recording tuning behind each {@link CanvasRecordingQuality} preset.\n */\nexport interface CanvasRecordingConfiguration {\n  enable: true\n  maxFramesPerSecond: number\n  hashingMaxDimension: number\n  maxImageDimension: number\n  encodeQuality: number\n}\n\nconst CANVAS_RECORDING_QUALITY_PRESETS: Record<CanvasRecordingQuality, Omit<CanvasRecordingConfiguration, 'enable'>> = {\n  [CanvasRecordingQuality.LOW]: {\n    maxFramesPerSecond: 1,\n    hashingMaxDimension: 50,\n    maxImageDimension: 600,\n    encodeQuality: 0.3,\n  },\n  [CanvasRecordingQuality.MEDIUM]: {\n    maxFramesPerSecond: 4,\n    hashingMaxDimension: 100,\n    maxImageDimension: 1000,\n    encodeQuality: 0.5,\n  },\n  [CanvasRecordingQuality.HIGH]: {\n    maxFramesPerSecond: 8,\n    hashingMaxDimension: 100,\n    maxImageDimension: 1280,\n    encodeQuality: 0.75,\n  },\n}\n\n/**\n * Upstream gates canvas recording behind the `session_replay_record_canvas` experimental flag; in\n * this SDK it is a regular option. The preset's values can be overridden one by one, which is how the\n * dashboard's remote configuration tunes them.\n */\nfunction resolveCanvasRecordingConfiguration(\n  configuration:\n    | {\n        enable: boolean\n        quality: CanvasRecordingQuality\n        maxFramesPerSecond?: number\n        maxImageDimension?: number\n        hashingMaxDimension?: number\n      }\n    | undefined\n): CanvasRecordingConfiguration | undefined {\n  const preset = configuration && CANVAS_RECORDING_QUALITY_PRESETS[configuration.quality]\n  if (!configuration?.enable || !preset) {\n    return undefined\n  }\n\n  return {\n    enable: true,\n    ...preset,\n    maxFramesPerSecond: configuration.maxFramesPerSecond ?? preset.maxFramesPerSecond,\n    maxImageDimension: configuration.maxImageDimension ?? preset.maxImageDimension,\n    hashingMaxDimension: configuration.hashingMaxDimension ?? preset.hashingMaxDimension,\n  }\n}\n\nexport type FeatureFlagsForEvents = 'vital' | 'action' | 'long_task' | 'resource'\n\n/**\n * Function called before a RUM event is sent to KubeSense. See {@link RumInitConfiguration.beforeSend}\n *\n * @param event - The RUM event\n * @param context - The RUM event domain context providing access to native browser data based on the event type (e.g. error, performance entry).\n * @returns true if the event should be sent to KubeSense, false otherwise\n */\nexport type RumBeforeSend = (event: RumEvent, context: RumEventDomainContext) => boolean\n\nexport interface GraphQlUrlOption {\n  match: MatchOption\n  trackPayload?: boolean\n  trackResponseErrors?: boolean\n}\n\nexport interface MatchHeader {\n  url?: MatchOption\n  name?: MatchOption\n  extractor?: RegExp\n  location?: 'request' | 'response' | 'any'\n}\n\nexport const RUM_SCHEMA = {\n  ...BROWSER_CORE_SCHEMA,\n\n  // Required\n  applicationId: { type: 'string', required: true },\n\n  // Optional strings\n  actionNameAttribute: { type: 'string' },\n  workerUrl: { type: 'string' },\n  subdomain: { type: 'string' },\n\n  // Sample rates\n  sessionReplaySampleRate: { type: 'percentage', default: 0 },\n  traceSampleRate: { type: 'percentage', default: 100 },\n  profilingSampleRate: { type: 'percentage', default: 0 },\n\n  // Booleans\n  compressIntakeRequests: { type: 'boolean', default: false },\n  trackUserInteractions: { type: 'boolean', default: true, strict: false },\n  trackResources: { type: 'boolean', default: true, strict: false },\n  trackLongTasks: { type: 'boolean', default: true, strict: false },\n  trackViewsManually: { type: 'boolean', default: false, strict: false },\n  betaEnableViewUpdates: { type: 'boolean' },\n  betaTrackWebSockets: { type: 'boolean', default: false, strict: false },\n  enablePrivacyForActionName: { type: 'boolean', default: true },\n  propagateTraceBaggage: { type: 'boolean', default: true },\n  startSessionReplayRecordingManually: { type: 'boolean', default: false, strict: false },\n  enableRemoteSdkConfiguration: { type: 'boolean', default: false, strict: false },\n  // KubeSense extensions\n  firstPartyDomains: { type: 'match-option', multiple: true, default: [] as MatchOption[] },\n  sessionReplayRoutes: {\n    type: 'schema',\n    strict: false,\n    schema: {\n      // Not strict: an unusable entry is dropped rather than failing the whole configuration, so a\n      // typo in one route does not take Session Replay down entirely.\n      include: { type: 'match-option', multiple: true, strict: false },\n      exclude: { type: 'match-option', multiple: true, strict: false },\n    },\n  },\n\n  sessionReplayCanvasRecording: {\n    type: 'schema',\n    schema: {\n      enable: { type: 'boolean', required: true },\n      quality: { type: 'enum', values: CanvasRecordingQuality, default: CanvasRecordingQuality.MEDIUM },\n      maxFramesPerSecond: { type: 'number', min: 0, max: 8 },\n      maxImageDimension: { type: 'number', min: 1, max: 1280 },\n      hashingMaxDimension: { type: 'number', min: 1, max: 100 },\n    },\n  },\n\n  // Enums\n  defaultPrivacyLevel: {\n    type: 'enum',\n    values: DefaultPrivacyLevel,\n    default: DefaultPrivacyLevel.MASK_USER_INPUT,\n    strict: false,\n  },\n  traceContextInjection: {\n    type: 'enum',\n    values: TraceContextInjection,\n    default: TraceContextInjection.SAMPLED,\n    strict: false,\n  },\n\n  // Arrays\n  excludedActivityUrls: { type: 'match-option', multiple: true, default: [] as MatchOption[] },\n  allowedTracingUrls: {\n    type: 'union',\n    multiple: true,\n    strict: false,\n    default: [] as Array<MatchOption | { match: MatchOption; propagatorTypes: PropagatorType[] }>,\n    variants: [\n      { type: 'match-option' },\n      {\n        type: 'schema',\n        schema: {\n          match: { type: 'match-option', required: true },\n          propagatorTypes: {\n            type: 'enum',\n            values: ['kubesense', 'b3', 'b3multi', 'tracecontext'] as const,\n            multiple: true,\n            strict: false,\n            default: DEFAULT_PROPAGATOR_TYPES,\n          },\n        },\n      },\n    ],\n  },\n  plugins: {\n    type: 'schema',\n    multiple: true,\n    strict: false,\n    default: [] as RumPlugin[],\n    schema: {\n      name: { type: 'string', required: true },\n      getConfigurationTelemetry: {\n        type: 'function',\n        strict: false,\n        signature: undefined as RumPlugin['getConfigurationTelemetry'],\n      },\n      onInit: { type: 'function', strict: false, signature: undefined as RumPlugin['onInit'] },\n      onRumStart: { type: 'function', strict: false, signature: undefined as RumPlugin['onRumStart'] },\n    },\n  },\n  trackFeatureFlagsForEvents: {\n    type: 'enum',\n    values: ['vital', 'action', 'long_task', 'resource'] as const,\n    multiple: true,\n    strict: false,\n    default: [] as FeatureFlagsForEvents[],\n  },\n} as const\n\nexport type RumConfiguration = Omit<\n  InferredConfig<typeof RUM_SCHEMA>,\n  'allowedTracingUrls' | 'sessionReplayCanvasRecording'\n> & {\n  allowedTracingUrls: TracingOption[]\n  betaEnableViewUpdates: boolean\n  rulePsr: number | undefined\n  trackResourceHeaders: MatchHeader[]\n  allowedGraphQlUrls: GraphQlUrlOption[]\n  remoteConfigurationId: string | undefined\n  sessionReplayCanvasRecording: CanvasRecordingConfiguration | undefined\n}\n\n/**\n * Resolves whether partial view updates are enabled. Never enabled when the event bridge is used.\n * Otherwise an explicit `betaEnableViewUpdates` takes precedence, and it defaults to true for CDN\n * users that do not go through a proxy: a proxy may not forward the `view_update` event type yet,\n * and npm users pin an SDK version so they opt in explicitly.\n *\n * The CDN check is temporary, the next step is to default this to true unless `proxy` is set.\n * TODO next major: remove the option.\n */\nfunction isViewUpdatesEnabled(\n  explicit: boolean | undefined,\n  proxy: InitConfiguration['proxy'],\n  sdkName: SdkName | undefined\n): boolean {\n  if (canUseEventBridge()) {\n    // The bridge replaces the batch transport, and `view_update` events are only created by the\n    // batch dispatcher, so partial updates never happen in a WebView. Ignore the explicit value\n    // too, otherwise telemetry reports updates that cannot be sent.\n    return false\n  }\n\n  // The Salesforce bundle is a CDN build, but the supported install flow uploads it as a static\n  // resource, so publishing a new bundle does not roll those deployments back. Keep them out of\n  // the default, they can still opt in explicitly.\n  return explicit ?? (__BUILD_ENV__SDK_SETUP__ === 'cdn' && !proxy && sdkName !== 'rum-salesforce')\n}\n\nexport function validateAndBuildRumConfiguration(\n  initConfiguration: RumInitConfiguration,\n  sdkName?: SdkName\n): RumConfiguration | undefined {\n  const config = validateAndBuildConfiguration(\n    initConfiguration as unknown as Record<string, unknown>,\n    RUM_SCHEMA,\n    display\n  )\n\n  if (!config) {\n    return\n  }\n\n  const allowedTracingUrls = config.allowedTracingUrls.map(normalizeTracingOption).filter(Boolean) as TracingOption[]\n\n  if (allowedTracingUrls.length > 0 && !config.service) {\n    display.error('Service needs to be configured when tracing is enabled')\n    return\n  }\n\n  const sessionReplayCanvasRecording = resolveCanvasRecordingConfiguration(config.sessionReplayCanvasRecording)\n\n  return {\n    ...config,\n    service: config.service || config.applicationId,\n    sessionReplayCanvasRecording,\n    betaEnableViewUpdates: isViewUpdatesEnabled(config.betaEnableViewUpdates, config.proxy, sdkName),\n    allowedTracingUrls,\n    beforeSend: config.beforeSend\n      ? (catchUserErrors(config.beforeSend, 'beforeSend threw an error:') as typeof config.beforeSend)\n      : undefined,\n    rulePsr: isNumber(initConfiguration.traceSampleRate) ? initConfiguration.traceSampleRate / 100 : undefined,\n    trackResourceHeaders: validateAndBuildTrackResourceHeaders(initConfiguration),\n    allowedGraphQlUrls: validateAndBuildGraphQlOptions(initConfiguration),\n    remoteConfigurationId: getRemoteConfigurationId(initConfiguration),\n  }\n}\n\n/**\n * Combines the selected tracing propagators from the different options in allowedTracingUrls\n */\nfunction getSelectedTracingPropagators(configuration: RumInitConfiguration): PropagatorType[] {\n  const usedTracingPropagators = new Set<PropagatorType>()\n\n  if (isNonEmptyArray(configuration.allowedTracingUrls)) {\n    configuration.allowedTracingUrls.forEach((option) => {\n      normalizeTracingOption(option)?.propagatorTypes.forEach((propagatorType) =>\n        usedTracingPropagators.add(propagatorType)\n      )\n    })\n  }\n\n  return Array.from(usedTracingPropagators)\n}\n\nfunction normalizeTracingOption(option: unknown): TracingOption | undefined {\n  if (isMatchOption(option)) {\n    return { match: option, propagatorTypes: DEFAULT_PROPAGATOR_TYPES }\n  }\n\n  if (\n    isIndexableObject(option) &&\n    isMatchOption(option.match) &&\n    (option.propagatorTypes === null || option.propagatorTypes === undefined || Array.isArray(option.propagatorTypes))\n  ) {\n    return {\n      match: option.match,\n      propagatorTypes: option.propagatorTypes || DEFAULT_PROPAGATOR_TYPES,\n    }\n  }\n}\n\n/**\n * Build GraphQL options from configuration\n */\nfunction validateAndBuildGraphQlOptions(initConfiguration: RumInitConfiguration): GraphQlUrlOption[] {\n  if (!initConfiguration.allowedGraphQlUrls) {\n    return []\n  }\n\n  if (!Array.isArray(initConfiguration.allowedGraphQlUrls)) {\n    display.warn('allowedGraphQlUrls should be an array')\n    return []\n  }\n\n  const graphQlOptions: GraphQlUrlOption[] = []\n\n  initConfiguration.allowedGraphQlUrls.forEach((option) => {\n    if (isMatchOption(option)) {\n      graphQlOptions.push({ match: option, trackPayload: false, trackResponseErrors: false })\n    } else if (isIndexableObject(option) && isMatchOption(option.match)) {\n      graphQlOptions.push({\n        match: option.match,\n        trackPayload: !!option.trackPayload,\n        trackResponseErrors: !!option.trackResponseErrors,\n      })\n    }\n  })\n\n  return graphQlOptions\n}\n\nconst VALID_HEADER_LOCATIONS = ['request', 'response', 'any']\n\nfunction validateAndBuildTrackResourceHeaders(initConfiguration: RumInitConfiguration): MatchHeader[] {\n  const option = initConfiguration.trackResourceHeaders\n\n  if (option === undefined || option === false) {\n    return []\n  }\n\n  if (option === true) {\n    return DEFAULT_TRACKED_RESOURCE_HEADERS.map((name) => ({ name }))\n  }\n\n  if (!Array.isArray(option)) {\n    display.warn('trackResourceHeaders should be true or an array of MatchHeader')\n    return []\n  }\n\n  if (option.length === 0) {\n    display.warn('trackResourceHeaders is an empty array, no headers will be captured')\n    return []\n  }\n\n  const result: MatchHeader[] = []\n\n  option.forEach((item, index) => {\n    if (!isIndexableObject(item)) {\n      display.warn(`trackResourceHeaders[${index}] should be a MatchHeader object`)\n      return\n    }\n    if (item.name !== undefined && !isMatchOption(item.name)) {\n      display.warn(`trackResourceHeaders[${index}].name should be a MatchOption`)\n      return\n    }\n    if (item.url !== undefined && !isMatchOption(item.url)) {\n      display.warn(`trackResourceHeaders[${index}].url should be a MatchOption`)\n      return\n    }\n    if (item.extractor !== undefined && !(item.extractor instanceof RegExp)) {\n      display.warn(`trackResourceHeaders[${index}].extractor should be a RegExp`)\n      return\n    }\n    if (\n      item.location !== undefined &&\n      (typeof item.location !== 'string' || !VALID_HEADER_LOCATIONS.includes(item.location))\n    ) {\n      display.warn(`trackResourceHeaders[${index}].location should be 'request', 'response', or 'any'`)\n      return\n    }\n\n    const { name, ...rest } = item\n    result.push({\n      ...rest,\n      ...(name !== undefined ? { name: typeof name === 'string' ? name.toLowerCase() : name } : {}),\n    })\n  })\n\n  return result\n}\n\nfunction hasGraphQlPayloadTracking(allowedGraphQlUrls: RumInitConfiguration['allowedGraphQlUrls']): boolean {\n  return (\n    isNonEmptyArray(allowedGraphQlUrls) &&\n    allowedGraphQlUrls.some((option) => isIndexableObject(option) && option.trackPayload)\n  )\n}\n\nfunction hasGraphQlResponseErrorsTracking(allowedGraphQlUrls: RumInitConfiguration['allowedGraphQlUrls']): boolean {\n  return (\n    isNonEmptyArray(allowedGraphQlUrls) &&\n    allowedGraphQlUrls.some((option) => isIndexableObject(option) && option.trackResponseErrors)\n  )\n}\n\nfunction getTrackResourceHeadersTelemetryValue(\n  trackResourceHeaders: RumInitConfiguration['trackResourceHeaders']\n): 'default_headers' | 'custom' | undefined {\n  if (trackResourceHeaders === true) {\n    return 'default_headers'\n  }\n  if (Array.isArray(trackResourceHeaders)) {\n    return 'custom'\n  }\n}\n\nexport function serializeRumConfiguration(\n  configuration: RumInitConfiguration,\n  sdkName?: SdkName,\n  remoteConfigurationMetadata?: RemoteConfigurationMetadata\n) {\n  const baseSerializedConfiguration = serializeConfiguration(configuration)\n\n  // `use_` prefix is for telemetry options that track usage of a configuration option as a boolean to avoid capturing customer data\n  return {\n    session_replay_sample_rate: configuration.sessionReplaySampleRate,\n    start_session_replay_recording_manually: configuration.startSessionReplayRecordingManually,\n    trace_sample_rate: configuration.traceSampleRate,\n    trace_context_injection: configuration.traceContextInjection,\n    propagate_trace_baggage: configuration.propagateTraceBaggage,\n    action_name_attribute: configuration.actionNameAttribute,\n    use_allowed_tracing_urls: isNonEmptyArray(configuration.allowedTracingUrls),\n    use_allowed_graph_ql_urls: isNonEmptyArray(configuration.allowedGraphQlUrls),\n    use_track_graph_ql_payload: hasGraphQlPayloadTracking(configuration.allowedGraphQlUrls),\n    use_track_graph_ql_response_errors: hasGraphQlResponseErrorsTracking(configuration.allowedGraphQlUrls),\n    selected_tracing_propagators: getSelectedTracingPropagators(configuration),\n    default_privacy_level: configuration.defaultPrivacyLevel,\n    enable_privacy_for_action_name: configuration.enablePrivacyForActionName,\n    use_excluded_activity_urls: isNonEmptyArray(configuration.excludedActivityUrls),\n    use_worker_url: !!configuration.workerUrl,\n    compress_intake_requests: configuration.compressIntakeRequests,\n    track_views_manually: configuration.trackViewsManually,\n    track_user_interactions: configuration.trackUserInteractions,\n    track_resources: configuration.trackResources,\n    track_long_task: configuration.trackLongTasks,\n    plugins: configuration.plugins?.map((plugin) => ({\n      name: plugin.name,\n      ...plugin.getConfigurationTelemetry?.(),\n    })),\n    track_feature_flags_for_events: configuration.trackFeatureFlagsForEvents,\n    remote_configuration_id: getRemoteConfigurationId(configuration),\n    remote_configuration: remoteConfigurationMetadata && {\n      last_modified: remoteConfigurationMetadata.lastModified,\n      last_synced: remoteConfigurationMetadata.lastSynced,\n      first_applied: remoteConfigurationMetadata.firstApplied,\n      sync_id: remoteConfigurationMetadata.syncId,\n    },\n    profiling_sample_rate: configuration.profilingSampleRate,\n    use_remote_configuration_proxy: !!configuration.remoteConfigurationProxy,\n    // KubeSense extensions: whether the dashboard-managed remote document is in play, whether\n    // replay recording is route-scoped, and whether resource classification has an explicit\n    // first-party list — all needed to interpret the reported values on the dashboard side.\n    enable_remote_sdk_configuration: !!configuration.enableRemoteSdkConfiguration,\n    use_session_replay_routes:\n      !!configuration.sessionReplayRoutes &&\n      (isNonEmptyArray(configuration.sessionReplayRoutes.include) ||\n        isNonEmptyArray(configuration.sessionReplayRoutes.exclude)),\n    use_first_party_domains: isNonEmptyArray(configuration.firstPartyDomains),\n    track_resource_headers: getTrackResourceHeadersTelemetryValue(configuration.trackResourceHeaders),\n    beta_enable_view_updates: isViewUpdatesEnabled(configuration.betaEnableViewUpdates, configuration.proxy, sdkName),\n    beta_track_web_sockets: configuration.betaTrackWebSockets,\n    ...baseSerializedConfiguration,\n  } satisfies RawTelemetryConfiguration\n}\n"],"mappings":"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"}

package/esm/domain/configuration/index.mjs

@@ -0,0 +1,6 @@
+import { CACHE_KEY_PREFIX, CACHE_STATUS_TO_METRIC_MAP, buildCacheKey, createConfigurationCache } from "./remoteConfigurationCache.mjs";
+import { applyRemoteConfiguration, buildEndpoint, fetchAndApplyRemoteConfiguration, fetchRemoteConfiguration, getRemoteConfiguration, getRemoteConfigurationId, initMetrics } from "./remoteConfiguration.mjs";
+import { CanvasRecordingQuality, DEFAULT_PROPAGATOR_TYPES, DEFAULT_TRACKED_RESOURCE_HEADERS, RUM_SCHEMA, serializeRumConfiguration, validateAndBuildRumConfiguration } from "./configuration.mjs";
+import { applyCachedSdkConfiguration, applySdkConfiguration, scheduleSdkConfigurationRefresh } from "./remoteSdkConfiguration.mjs";
+import { getRoutePath, isRouteRecordable } from "./sessionReplayRoutes.mjs";
+export { CACHE_KEY_PREFIX, CACHE_STATUS_TO_METRIC_MAP, CanvasRecordingQuality, DEFAULT_PROPAGATOR_TYPES, DEFAULT_TRACKED_RESOURCE_HEADERS, RUM_SCHEMA, applyCachedSdkConfiguration, applyRemoteConfiguration, applySdkConfiguration, buildCacheKey, buildEndpoint, createConfigurationCache, fetchAndApplyRemoteConfiguration, fetchRemoteConfiguration, getRemoteConfiguration, getRemoteConfigurationId, getRoutePath, initMetrics, isRouteRecordable, scheduleSdkConfigurationRefresh, serializeRumConfiguration, validateAndBuildRumConfiguration };