@kubesense/kubesense-browser-core 1.7.0 → 2.0.0-beta.0

package/cjs/domain/configuration/configuration.js

@@ -1,135 +1,166 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TraceContextInjection = exports.DefaultPrivacyLevel = void 0;
-exports.isSampleRate = isSampleRate;
-exports.validateAndBuildConfiguration = validateAndBuildConfiguration;
-exports.serializeConfiguration = serializeConfiguration;
-const catchUserErrors_1 = require("../../tools/catchUserErrors");
-const display_1 = require("../../tools/display");
-const numberUtils_1 = require("../../tools/utils/numberUtils");
-const objectUtils_1 = require("../../tools/utils/objectUtils");
-const sessionStore_1 = require("../session/sessionStore");
-const trackingConsent_1 = require("../trackingConsent");
-const allowedTrackingOrigins_1 = require("../allowedTrackingOrigins");
-const globalObject_1 = require("../../tools/globalObject");
-const transportConfiguration_1 = require("./transportConfiguration");
+const require_trackingConsent = require("../trackingConsent.js");
+let _kubesense_kubesense_js_core_transport = require("@kubesense/kubesense-js-core/transport");
+//#region src/domain/configuration/configuration.ts
 /**
- * Default privacy level for the browser SDK.
- *
- * [Replay Privacy Options](https://docs.kubesense.ai/real_user_monitoring/session_replay/browser/privacy_options) for further information.
- */
-exports.DefaultPrivacyLevel = {
-    ALLOW: 'allow',
-    MASK: 'mask',
-    MASK_USER_INPUT: 'mask-user-input',
-    MASK_UNLESS_ALLOWLISTED: 'mask-unless-allowlisted',
+* Default privacy level for the browser SDK.
+*
+* [Replay Privacy Options](https://docs.kubesense.ai/real_user_monitoring/session_replay/browser/privacy_options) for further information.
+*/
+const DefaultPrivacyLevel = {
+	ALLOW: "allow",
+	MASK: "mask",
+	MASK_USER_INPUT: "mask-user-input",
+	MASK_UNLESS_ALLOWLISTED: "mask-unless-allowlisted"
 };
 /**
- * Trace context injection option.
- *
- * See [Connect RUM and Traces](https://docs.kubesense.ai/real_user_monitoring/platform/connect_rum_and_traces/?tab=browserrum) for further information.
- */
-exports.TraceContextInjection = {
-    ALL: 'all',
-    SAMPLED: 'sampled',
+* Trace context injection option.
+*
+* See [Connect RUM and Traces](https://docs.kubesense.ai/real_user_monitoring/platform/connect_rum_and_traces/?tab=browserrum) for further information.
+*/
+const TraceContextInjection = {
+	ALL: "all",
+	SAMPLED: "sampled"
+};
+const BROWSER_CORE_SCHEMA = {
+	clientToken: {
+		type: "string",
+		required: true
+	},
+	service: { type: "string" },
+	env: { type: "string" },
+	version: { type: "string" },
+	kubesenseRumEndpoint: {
+		type: "site",
+		default: _kubesense_kubesense_js_core_transport.INTAKE_SITE_PROD
+	},
+	proxy: {
+		type: "union",
+		variants: [{ type: "string" }, {
+			type: "function",
+			signature: void 0
+		}]
+	},
+	sessionSampleRate: {
+		type: "percentage",
+		default: 100
+	},
+	telemetrySampleRate: {
+		type: "percentage",
+		default: 20
+	},
+	telemetryConfigurationSampleRate: {
+		type: "percentage",
+		default: 5
+	},
+	telemetryUsageSampleRate: {
+		type: "percentage",
+		default: 5
+	},
+	silentMultipleInit: {
+		type: "boolean",
+		default: false,
+		strict: false
+	},
+	storeContextsAcrossPages: {
+		type: "boolean",
+		default: false,
+		strict: false
+	},
+	trackAnonymousUser: {
+		type: "boolean",
+		default: true,
+		strict: false
+	},
+	useSecureSessionCookie: {
+		type: "boolean",
+		default: false,
+		strict: false
+	},
+	usePartitionedCrossSiteSessionCookie: {
+		type: "boolean",
+		default: false,
+		strict: false
+	},
+	trackSessionAcrossSubdomains: {
+		type: "boolean",
+		default: false,
+		strict: false
+	},
+	allowedTrackingOrigins: {
+		type: "match-option",
+		multiple: true,
+		strict: false
+	},
+	trackingConsent: {
+		type: "enum",
+		values: require_trackingConsent.TrackingConsent,
+		default: require_trackingConsent.TrackingConsent.GRANTED
+	},
+	beforeSend: {
+		type: "function",
+		signature: void 0
+	},
+	source: {
+		type: "enum",
+		values: [
+			"browser",
+			"flutter",
+			"unity"
+		],
+		default: "browser",
+		strict: false
+	},
+	sessionPersistence: {
+		type: "enum",
+		values: [
+			"cookie",
+			"local-storage",
+			"memory"
+		],
+		multiple: true,
+		strict: false
+	},
+	replica: {
+		type: "schema",
+		schema: {
+			clientToken: {
+				type: "string",
+				required: true
+			},
+			applicationId: { type: "string" }
+		}
+	},
+	datacenter: { type: "string" },
+	sdkVersion: { type: "string" },
+	variant: { type: "string" }
 };
-function isString(tag, tagName) {
-    if (tag !== undefined && tag !== null && typeof tag !== 'string') {
-        display_1.display.error(`${tagName} must be defined as a string`);
-        return false;
-    }
-    return true;
-}
-function isKubeSenseSite(site) {
-    if (site && typeof site === 'string' && !/(kubesense|tyke)/.test(site)) {
-        display_1.display.error(`Site should be a valid KubeSense site. ${display_1.MORE_DETAILS} ${display_1.DOCS_ORIGIN}/getting_started/site/.`);
-        return false;
-    }
-    return true;
-}
-function isSampleRate(sampleRate, name) {
-    if (sampleRate !== undefined && !(0, numberUtils_1.isPercentage)(sampleRate)) {
-        display_1.display.error(`${name} Sample Rate should be a number between 0 and 100`);
-        return false;
-    }
-    return true;
-}
-function validateAndBuildConfiguration(initConfiguration, errorStack) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-    if (!initConfiguration || !initConfiguration.clientToken) {
-        display_1.display.error('Client Token is not configured, we will not send any data.');
-        return;
-    }
-    if (initConfiguration.allowedTrackingOrigins !== undefined &&
-        !Array.isArray(initConfiguration.allowedTrackingOrigins)) {
-        display_1.display.error('Allowed Tracking Origins must be an array');
-        return;
-    }
-    if (
-    // !isKubeSenseSite(initConfiguration.kubesenseRumEndpoint) ||
-    !isSampleRate(initConfiguration.sessionSampleRate, 'Session') ||
-        !isSampleRate(initConfiguration.telemetrySampleRate, 'Telemetry') ||
-        !isSampleRate(initConfiguration.telemetryConfigurationSampleRate, 'Telemetry Configuration') ||
-        !isSampleRate(initConfiguration.telemetryUsageSampleRate, 'Telemetry Usage') ||
-        !isString(initConfiguration.version, 'Version') ||
-        !isString(initConfiguration.env, 'Env') ||
-        !isString(initConfiguration.service, 'Service') ||
-        !(0, allowedTrackingOrigins_1.isAllowedTrackingOrigins)(initConfiguration, errorStack !== null && errorStack !== void 0 ? errorStack : '')) {
-        return;
-    }
-    if (initConfiguration.trackingConsent !== undefined &&
-        !(0, objectUtils_1.objectHasValue)(trackingConsent_1.TrackingConsent, initConfiguration.trackingConsent)) {
-        display_1.display.error('Tracking Consent should be either "granted" or "not-granted"');
-        return;
-    }
-    return {
-        beforeSend: initConfiguration.beforeSend && (0, catchUserErrors_1.catchUserErrors)(initConfiguration.beforeSend, 'beforeSend threw an error:'),
-        sessionStoreStrategyType: globalObject_1.isWorkerEnvironment ? undefined : (0, sessionStore_1.selectSessionStoreStrategyType)(initConfiguration),
-        sessionSampleRate: (_a = initConfiguration.sessionSampleRate) !== null && _a !== void 0 ? _a : 100,
-        telemetrySampleRate: (_b = initConfiguration.telemetrySampleRate) !== null && _b !== void 0 ? _b : 20,
-        telemetryConfigurationSampleRate: (_c = initConfiguration.telemetryConfigurationSampleRate) !== null && _c !== void 0 ? _c : 5,
-        telemetryUsageSampleRate: (_d = initConfiguration.telemetryUsageSampleRate) !== null && _d !== void 0 ? _d : 5,
-        service: (_e = initConfiguration.service) !== null && _e !== void 0 ? _e : undefined,
-        env: (_f = initConfiguration.env) !== null && _f !== void 0 ? _f : undefined,
-        version: (_g = initConfiguration.version) !== null && _g !== void 0 ? _g : undefined,
-        datacenter: (_h = initConfiguration.datacenter) !== null && _h !== void 0 ? _h : undefined,
-        silentMultipleInit: !!initConfiguration.silentMultipleInit,
-        allowUntrustedEvents: !!initConfiguration.allowUntrustedEvents,
-        trackingConsent: (_j = initConfiguration.trackingConsent) !== null && _j !== void 0 ? _j : trackingConsent_1.TrackingConsent.GRANTED,
-        trackAnonymousUser: (_k = initConfiguration.trackAnonymousUser) !== null && _k !== void 0 ? _k : true,
-        storeContextsAcrossPages: !!initConfiguration.storeContextsAcrossPages,
-        betaEncodeCookieOptions: !!initConfiguration.betaEncodeCookieOptions,
-        /**
-         * The source of the SDK, used for support plugins purposes.
-         */
-        variant: initConfiguration.variant,
-        sdkVersion: initConfiguration.sdkVersion,
-        ...(0, transportConfiguration_1.computeTransportConfiguration)(initConfiguration),
-    };
-}
 function serializeConfiguration(initConfiguration) {
-    return {
-        session_sample_rate: initConfiguration.sessionSampleRate,
-        telemetry_sample_rate: initConfiguration.telemetrySampleRate,
-        telemetry_configuration_sample_rate: initConfiguration.telemetryConfigurationSampleRate,
-        telemetry_usage_sample_rate: initConfiguration.telemetryUsageSampleRate,
-        use_before_send: !!initConfiguration.beforeSend,
-        use_partitioned_cross_site_session_cookie: initConfiguration.usePartitionedCrossSiteSessionCookie,
-        use_secure_session_cookie: initConfiguration.useSecureSessionCookie,
-        use_proxy: !!initConfiguration.proxy,
-        silent_multiple_init: initConfiguration.silentMultipleInit,
-        track_session_across_subdomains: initConfiguration.trackSessionAcrossSubdomains,
-        track_anonymous_user: initConfiguration.trackAnonymousUser,
-        session_persistence: initConfiguration.sessionPersistence,
-        allow_fallback_to_local_storage: !!initConfiguration.allowFallbackToLocalStorage,
-        store_contexts_across_pages: !!initConfiguration.storeContextsAcrossPages,
-        allow_untrusted_events: !!initConfiguration.allowUntrustedEvents,
-        tracking_consent: initConfiguration.trackingConsent,
-        use_allowed_tracking_origins: Array.isArray(initConfiguration.allowedTrackingOrigins),
-        beta_encode_cookie_options: initConfiguration.betaEncodeCookieOptions,
-        source: initConfiguration.source,
-        sdk_version: initConfiguration.sdkVersion,
-        variant: initConfiguration.variant,
-    };
+	return {
+		session_sample_rate: initConfiguration.sessionSampleRate,
+		telemetry_sample_rate: initConfiguration.telemetrySampleRate,
+		telemetry_configuration_sample_rate: initConfiguration.telemetryConfigurationSampleRate,
+		telemetry_usage_sample_rate: initConfiguration.telemetryUsageSampleRate,
+		use_before_send: !!initConfiguration.beforeSend,
+		use_partitioned_cross_site_session_cookie: initConfiguration.usePartitionedCrossSiteSessionCookie,
+		use_secure_session_cookie: initConfiguration.useSecureSessionCookie,
+		use_proxy: !!initConfiguration.proxy,
+		silent_multiple_init: initConfiguration.silentMultipleInit,
+		track_session_across_subdomains: initConfiguration.trackSessionAcrossSubdomains,
+		track_anonymous_user: initConfiguration.trackAnonymousUser,
+		session_persistence: Array.isArray(initConfiguration.sessionPersistence) ? initConfiguration.sessionPersistence[0] : initConfiguration.sessionPersistence,
+		store_contexts_across_pages: !!initConfiguration.storeContextsAcrossPages,
+		allow_untrusted_events: !!initConfiguration.allowUntrustedEvents,
+		tracking_consent: initConfiguration.trackingConsent,
+		use_allowed_tracking_origins: Array.isArray(initConfiguration.allowedTrackingOrigins),
+		source: initConfiguration.source,
+		sdk_version: initConfiguration.sdkVersion,
+		variant: initConfiguration.variant
+	};
 }
+//#endregion
+exports.BROWSER_CORE_SCHEMA = BROWSER_CORE_SCHEMA;
+exports.DefaultPrivacyLevel = DefaultPrivacyLevel;
+exports.TraceContextInjection = TraceContextInjection;
+exports.serializeConfiguration = serializeConfiguration;
+
 //# sourceMappingURL=configuration.js.map

package/cjs/domain/configuration/configuration.js.map

@@ -1 +1 @@
-{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../../../src/domain/configuration/configuration.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"configuration.js","names":["INTAKE_SITE_PROD","TrackingConsent"],"sources":["../../../src/domain/configuration/configuration.ts"],"sourcesContent":["import type { ProxyFn, Site } from '@kubesense/kubesense-js-core/transport'\nimport { INTAKE_SITE_PROD } from '@kubesense/kubesense-js-core/transport'\nimport type { InferredConfig, MatchOption } from '@kubesense/kubesense-js-core/configuration'\nimport type { RawTelemetryConfiguration } from '../telemetry'\nimport { TrackingConsent } from '../trackingConsent'\nimport type { SessionPersistence } from '../session/sessionConstants'\n\n/**\n * Default privacy level for the browser SDK.\n *\n * [Replay Privacy Options](https://docs.kubesense.ai/real_user_monitoring/session_replay/browser/privacy_options) for further information.\n */\nexport const DefaultPrivacyLevel = {\n  ALLOW: 'allow',\n  MASK: 'mask',\n  MASK_USER_INPUT: 'mask-user-input',\n  MASK_UNLESS_ALLOWLISTED: 'mask-unless-allowlisted',\n} as const\nexport type DefaultPrivacyLevel = (typeof DefaultPrivacyLevel)[keyof typeof DefaultPrivacyLevel]\n\n/**\n * Trace context injection option.\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 */\nexport const TraceContextInjection = {\n  ALL: 'all',\n  SAMPLED: 'sampled',\n} as const\n\n/**\n * Trace context injection option.\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 */\nexport type TraceContextInjection = (typeof TraceContextInjection)[keyof typeof TraceContextInjection]\n\nexport interface InitConfiguration {\n  /**\n   * The client token for KubeSense. Required for authenticating your application with KubeSense.\n   *\n   * @category Authentication\n   */\n  clientToken: string\n\n  /**\n   * A callback function that can be used to modify events before they are sent to KubeSense.\n   *\n   * @category Data Collection\n   */\n  beforeSend?: GenericBeforeSendCallback | undefined\n\n  /**\n   * The percentage of sessions tracked. A value between 0 and 100.\n   *\n   * @category Data Collection\n   * @defaultValue 100\n   */\n  sessionSampleRate?: number | undefined\n\n  /**\n   * The percentage of telemetry events sent. A value between 0 and 100.\n   *\n   * @category Data Collection\n   * @defaultValue 20\n   */\n  telemetrySampleRate?: number | undefined\n\n  /**\n   * Initialization fails silently if the RUM Browser SDK is already initialized on the page.\n   *\n   * @defaultValue false\n   */\n  silentMultipleInit?: boolean | undefined\n\n  /**\n   * Which storage strategy to use for persisting sessions. Can be 'cookie', 'local-storage', or 'memory'.\n   * When an array is provided, the SDK will attempt each persistence type in the order specified.\n   *\n   * Important: If you are using the RUM and Logs Browser SDKs, this option must be configured with identical values\n   *\n   * Note: 'memory' option is only for use with single-page applications. All page loads will start a new session, likely resulting in an increase in total number of RUM sessions\n   *\n   * @category Session Persistence\n   * @defaultValue \"cookie\"\n   */\n  sessionPersistence?: SessionPersistence | SessionPersistence[] | undefined\n\n  /**\n   * Allow listening to DOM events dispatched programmatically ([untrusted events](https://developer.mozilla.org/en-US/docs/Web/API/Event/isTrusted)). Enabling this option can be useful if you heavily rely on programmatic events, such as in an automated UI test environment.\n   *\n   * @defaultValue false\n   */\n  allowUntrustedEvents?: boolean | undefined\n\n  /**\n   * Store global context and user context in localStorage to preserve them along the user navigation.\n   * See [Contexts life cycle](https://docs.kubesense.ai/real_user_monitoring/browser/advanced_configuration/?tab=npm#contexts-life-cycle) for further information.\n   *\n   * @defaultValue false\n   */\n  storeContextsAcrossPages?: boolean | undefined\n\n  /**\n   * Set the initial user tracking consent state.\n   * See [User tracking consent](https://docs.kubesense.ai/real_user_monitoring/browser/advanced_configuration/?tab=npm#user-tracking-consent) for further information.\n   *\n   * @category Privacy\n   * @defaultValue granted\n   */\n  trackingConsent?: TrackingConsent | undefined\n\n  /**\n   * List of origins where the SDK is allowed to run when used in a browser extension context.\n   * Matches urls against the extensions origin.\n   * If not provided and the SDK is running in a browser extension, the SDK will not run.\n   */\n  allowedTrackingOrigins?: MatchOption[] | undefined\n\n  // transport options\n  /**\n   * Optional proxy URL, for example: https://www.proxy.com/path.\n   * See [Proxy Your Browser RUM Data](https://docs.kubesense.ai/real_user_monitoring/guide/proxy-rum-data) for further information.\n   *\n   * @category Transport\n   */\n  proxy?: string | ProxyFn | undefined\n\n  /**\n   * The KubeSense RUM intake host that events are sent to, for example `us2.kubesense.ai`.\n   *\n   * @category Transport\n   * @defaultValue us2.kubesense.ai\n   */\n  kubesenseRumEndpoint?: Site | undefined\n\n  // tag and context options\n  /**\n   * The service name for your application. Follows the [tag syntax requirements](https://docs.kubesense.ai/getting_started/tagging/#define-tags).\n   *\n   * @category Data Collection\n   */\n  service?: string | undefined | null\n\n  /**\n   * The application’s environment, for example: prod, pre-prod, and staging. Follows the [tag syntax requirements](https://docs.kubesense.ai/getting_started/tagging/#define-tags).\n   *\n   * @category Data Collection\n   */\n  env?: string | undefined | null\n\n  /**\n   * The application’s version, for example: 1.2.3, 6c44da20, and 2020.02.13. Follows the [tag syntax requirements](https://docs.kubesense.ai/getting_started/tagging/#define-tags).\n   *\n   * @category Data Collection\n   */\n  version?: string | undefined | null\n\n  // cookie options\n  /**\n   * Use a partitioned secure cross-site session cookie. This allows the RUM Browser SDK to run when the site is loaded from another one (iframe). Implies `useSecureSessionCookie`.\n   *\n   * Important: If you are using the RUM and Logs Browser SDKs, this option must be configured with identical values\n   *\n   * @category Session Persistence\n   * @defaultValue false\n   */\n  usePartitionedCrossSiteSessionCookie?: boolean | undefined\n\n  /**\n   * Use a secure session cookie. This disables RUM events sent on insecure (non-HTTPS) connections.\n   *\n   * Important: If you are using the RUM and Logs Browser SDKs, this option must be configured with identical values\n   *\n   * @category Session Persistence\n   * @defaultValue false\n   */\n  useSecureSessionCookie?: boolean | undefined\n\n  /**\n   * Preserve the session across subdomains for the same site.\n   *\n   * Important: If you are using the RUM and Logs Browser SDKs, this option must be configured with identical values\n   *\n   * @category Session Persistence\n   * @defaultValue false\n   */\n  trackSessionAcrossSubdomains?: boolean | undefined\n\n  /**\n   * Track anonymous user for the same site and extend cookie expiration date\n   *\n   * @category Data Collection\n   * @defaultValue true\n   */\n  trackAnonymousUser?: boolean | undefined\n\n  // internal options\n  /**\n   * [Internal option] Enable experimental features\n   *\n   * @internal\n   */\n  enableExperimentalFeatures?: string[] | undefined\n\n  /**\n   * [Internal option] Configure the dual shipping to another datacenter\n   *\n   * @internal\n   */\n  replica?: ReplicaInitConfiguration | undefined\n\n  /**\n   * [Internal option] Set the datacenter from where the data is dual shipped\n   *\n   * @internal\n   */\n  datacenter?: string\n\n  /**\n   * [Internal option] The percentage of telemetry configuration sent. A value between 0 and 100.\n   *\n   * @internal\n   * @defaultValue 5\n   */\n  telemetryConfigurationSampleRate?: number\n\n  /**\n   * [Internal option] The percentage of telemetry usage sent. A value between 0 and 100.\n   *\n   * @internal\n   * @defaultValue 5\n   */\n  telemetryUsageSampleRate?: number\n\n  /**\n   * [Internal option] Additional configuration for the SDK.\n   *\n   * @internal\n   */\n  source?: 'browser' | 'flutter' | 'unity' | undefined\n\n  /**\n   * [Internal option] Additional configuration for the SDK.\n   *\n   * @internal\n   */\n  sdkVersion?: string | undefined\n\n  /**\n   * [Internal option] Additional configuration for the SDK.\n   *\n   * @internal\n   */\n  variant?: string | undefined\n}\n\n// This type is only used to build the core configuration. Logs and RUM SDKs are using a proper type\n// for this option.\ntype GenericBeforeSendCallback = (event: any, context?: any) => unknown\n\n/**\n * @internal\n */\nexport interface ReplicaInitConfiguration {\n  applicationId?: string\n  clientToken: string\n}\n\nexport type SdkSource = 'browser' | 'flutter' | 'unity'\n\nexport const BROWSER_CORE_SCHEMA = {\n  clientToken: { type: 'string', required: true },\n\n  // Optional tag fields\n  service: { type: 'string' },\n  env: { type: 'string' },\n  version: { type: 'string' },\n\n  // Transport\n  kubesenseRumEndpoint: { type: 'site', default: INTAKE_SITE_PROD },\n  proxy: {\n    type: 'union',\n    variants: [{ type: 'string' }, { type: 'function', signature: undefined as ProxyFn | undefined }],\n  },\n\n  // Sample rates\n  sessionSampleRate: { type: 'percentage', default: 100 },\n  telemetrySampleRate: { type: 'percentage', default: 20 },\n  telemetryConfigurationSampleRate: { type: 'percentage', default: 5 },\n  telemetryUsageSampleRate: { type: 'percentage', default: 5 },\n\n  // Booleans\n  silentMultipleInit: { type: 'boolean', default: false, strict: false },\n  storeContextsAcrossPages: { type: 'boolean', default: false, strict: false },\n  trackAnonymousUser: { type: 'boolean', default: true, strict: false },\n  useSecureSessionCookie: { type: 'boolean', default: false, strict: false },\n  usePartitionedCrossSiteSessionCookie: { type: 'boolean', default: false, strict: false },\n  trackSessionAcrossSubdomains: { type: 'boolean', default: false, strict: false },\n\n  // Cookie/extension origin validation\n  allowedTrackingOrigins: { type: 'match-option', multiple: true, strict: false },\n\n  // Privacy\n  trackingConsent: { type: 'enum', values: TrackingConsent, default: TrackingConsent.GRANTED },\n\n  // Callbacks\n  beforeSend: { type: 'function', signature: undefined as GenericBeforeSendCallback | undefined },\n\n  // Passthroughs\n  source: { type: 'enum', values: ['browser', 'flutter', 'unity'] as const, default: 'browser', strict: false },\n  sessionPersistence: {\n    type: 'enum',\n    values: ['cookie', 'local-storage', 'memory'] as const,\n    multiple: true,\n    strict: false,\n  },\n  replica: {\n    type: 'schema',\n    schema: {\n      clientToken: { type: 'string', required: true },\n      applicationId: { type: 'string' },\n    },\n  },\n\n  // Internal\n  datacenter: { type: 'string' },\n  sdkVersion: { type: 'string' },\n  variant: { type: 'string' },\n} as const\n\nexport type Configuration = InferredConfig<typeof BROWSER_CORE_SCHEMA>\n\nexport function serializeConfiguration(initConfiguration: InitConfiguration) {\n  return {\n    session_sample_rate: initConfiguration.sessionSampleRate,\n    telemetry_sample_rate: initConfiguration.telemetrySampleRate,\n    telemetry_configuration_sample_rate: initConfiguration.telemetryConfigurationSampleRate,\n    telemetry_usage_sample_rate: initConfiguration.telemetryUsageSampleRate,\n    use_before_send: !!initConfiguration.beforeSend,\n    use_partitioned_cross_site_session_cookie: initConfiguration.usePartitionedCrossSiteSessionCookie,\n    use_secure_session_cookie: initConfiguration.useSecureSessionCookie,\n    use_proxy: !!initConfiguration.proxy,\n    silent_multiple_init: initConfiguration.silentMultipleInit,\n    track_session_across_subdomains: initConfiguration.trackSessionAcrossSubdomains,\n    track_anonymous_user: initConfiguration.trackAnonymousUser,\n    session_persistence: Array.isArray(initConfiguration.sessionPersistence)\n      ? initConfiguration.sessionPersistence[0]\n      : initConfiguration.sessionPersistence,\n    store_contexts_across_pages: !!initConfiguration.storeContextsAcrossPages,\n    allow_untrusted_events: !!initConfiguration.allowUntrustedEvents,\n    tracking_consent: initConfiguration.trackingConsent,\n    use_allowed_tracking_origins: Array.isArray(initConfiguration.allowedTrackingOrigins),\n    source: initConfiguration.source,\n    sdk_version: initConfiguration.sdkVersion,\n    variant: initConfiguration.variant,\n  } satisfies RawTelemetryConfiguration\n}\n"],"mappings":";;;;;;;;AAYA,MAAa,sBAAsB;CACjC,OAAO;CACP,MAAM;CACN,iBAAiB;CACjB,yBAAyB;AAC3B;;;;;;AAQA,MAAa,wBAAwB;CACnC,KAAK;CACL,SAAS;AACX;AAoPA,MAAa,sBAAsB;CACjC,aAAa;EAAE,MAAM;EAAU,UAAU;CAAK;CAG9C,SAAS,EAAE,MAAM,SAAS;CAC1B,KAAK,EAAE,MAAM,SAAS;CACtB,SAAS,EAAE,MAAM,SAAS;CAG1B,sBAAsB;EAAE,MAAM;EAAQ,SAASA,uCAAAA;CAAiB;CAChE,OAAO;EACL,MAAM;EACN,UAAU,CAAC,EAAE,MAAM,SAAS,GAAG;GAAE,MAAM;GAAY,WAAW,KAAA;EAAiC,CAAC;CAClG;CAGA,mBAAmB;EAAE,MAAM;EAAc,SAAS;CAAI;CACtD,qBAAqB;EAAE,MAAM;EAAc,SAAS;CAAG;CACvD,kCAAkC;EAAE,MAAM;EAAc,SAAS;CAAE;CACnE,0BAA0B;EAAE,MAAM;EAAc,SAAS;CAAE;CAG3D,oBAAoB;EAAE,MAAM;EAAW,SAAS;EAAO,QAAQ;CAAM;CACrE,0BAA0B;EAAE,MAAM;EAAW,SAAS;EAAO,QAAQ;CAAM;CAC3E,oBAAoB;EAAE,MAAM;EAAW,SAAS;EAAM,QAAQ;CAAM;CACpE,wBAAwB;EAAE,MAAM;EAAW,SAAS;EAAO,QAAQ;CAAM;CACzE,sCAAsC;EAAE,MAAM;EAAW,SAAS;EAAO,QAAQ;CAAM;CACvF,8BAA8B;EAAE,MAAM;EAAW,SAAS;EAAO,QAAQ;CAAM;CAG/E,wBAAwB;EAAE,MAAM;EAAgB,UAAU;EAAM,QAAQ;CAAM;CAG9E,iBAAiB;EAAE,MAAM;EAAQ,QAAQC,wBAAAA;EAAiB,SAASA,wBAAAA,gBAAgB;CAAQ;CAG3F,YAAY;EAAE,MAAM;EAAY,WAAW,KAAA;CAAmD;CAG9F,QAAQ;EAAE,MAAM;EAAQ,QAAQ;GAAC;GAAW;GAAW;EAAO;EAAY,SAAS;EAAW,QAAQ;CAAM;CAC5G,oBAAoB;EAClB,MAAM;EACN,QAAQ;GAAC;GAAU;GAAiB;EAAQ;EAC5C,UAAU;EACV,QAAQ;CACV;CACA,SAAS;EACP,MAAM;EACN,QAAQ;GACN,aAAa;IAAE,MAAM;IAAU,UAAU;GAAK;GAC9C,eAAe,EAAE,MAAM,SAAS;EAClC;CACF;CAGA,YAAY,EAAE,MAAM,SAAS;CAC7B,YAAY,EAAE,MAAM,SAAS;CAC7B,SAAS,EAAE,MAAM,SAAS;AAC5B;AAIA,SAAgB,uBAAuB,mBAAsC;CAC3E,OAAO;EACL,qBAAqB,kBAAkB;EACvC,uBAAuB,kBAAkB;EACzC,qCAAqC,kBAAkB;EACvD,6BAA6B,kBAAkB;EAC/C,iBAAiB,CAAC,CAAC,kBAAkB;EACrC,2CAA2C,kBAAkB;EAC7D,2BAA2B,kBAAkB;EAC7C,WAAW,CAAC,CAAC,kBAAkB;EAC/B,sBAAsB,kBAAkB;EACxC,iCAAiC,kBAAkB;EACnD,sBAAsB,kBAAkB;EACxC,qBAAqB,MAAM,QAAQ,kBAAkB,kBAAkB,IACnE,kBAAkB,mBAAmB,KACrC,kBAAkB;EACtB,6BAA6B,CAAC,CAAC,kBAAkB;EACjD,wBAAwB,CAAC,CAAC,kBAAkB;EAC5C,kBAAkB,kBAAkB;EACpC,8BAA8B,MAAM,QAAQ,kBAAkB,sBAAsB;EACpF,QAAQ,kBAAkB;EAC1B,aAAa,kBAAkB;EAC/B,SAAS,kBAAkB;CAC7B;AACF"}

package/cjs/domain/configuration/index.d.ts

@@ -1,8 +1,6 @@
-export type { Configuration, InitConfiguration, ProxyFn } from './configuration';
-export { DefaultPrivacyLevel, TraceContextInjection, isSampleRate, validateAndBuildConfiguration, serializeConfiguration, } from './configuration';
-export type { EndpointBuilder, TrackType } from './endpointBuilder';
-export { createEndpointBuilder, buildEndpointHost } from './endpointBuilder';
+export type { Configuration, InitConfiguration } from './configuration';
+export { DefaultPrivacyLevel, TraceContextInjection, serializeConfiguration, BROWSER_CORE_SCHEMA, } from './configuration';
 export type { RemoteSdkConfig, RemoteSdkConfigFeatures } from './remoteSdkConfig';
-export { SDK_CONFIG_CACHE_KEY, SDK_CONFIG_PATH, buildSdkConfigEndpoint, clearCachedSdkConfig, getCachedSdkConfig, parseSdkConfig, readBoolean, readEnum, readSampleRate, readString, refreshSdkConfig, setCachedSdkConfig, } from './remoteSdkConfig';
-export * from '../intakeSites';
-export { computeTransportConfiguration, isIntakeUrl } from './transportConfiguration';
+export { SDK_CONFIG_CACHE_KEY, SDK_CONFIG_PATH, buildSdkConfigEndpoint, clearCachedSdkConfig, getCachedSdkConfig, parseSdkConfig, readBoolean, readEnum, readNumberInRange, readSampleRate, readString, readStringList, refreshSdkConfig, setCachedSdkConfig, } from './remoteSdkConfig';
+export { buildCookieOptions } from '../../browser/cookie';
+export { isAllowedTrackingOrigins } from '../allowedTrackingOrigins';

package/cjs/domain/configuration/remoteSdkConfig.d.ts

@@ -6,7 +6,14 @@ import type { InitConfiguration } from './configuration';
  * storage, so it costs nothing on the initialization path. Cached values are applied on the
  * next page load — SDK configuration is frozen at `init()` time by design.
  */
+/**
+ * Prefix of the local-storage key holding the cached document. The key carries the client token,
+ * which the collector issues per application, so applications sharing an origin — several apps on
+ * one domain, or `localhost` during development — never read each other's settings. RUM and Logs
+ * of one application share the token, and so still share the document.
+ */
 export declare const SDK_CONFIG_CACHE_KEY = "_kubesense_sdk_config";
+export declare function sdkConfigCacheKey(clientToken: string): string;
 export declare const SDK_CONFIG_PATH = "/rum/api/v1/sdk-config";
 /** Give up rather than let a hung request keep a page-load handle alive. */
 export declare const SDK_CONFIG_FETCH_TIMEOUT = 10000;
@@ -43,9 +50,9 @@ export interface RemoteSdkConfigFeatures {
  * Read the cached document. Synchronous, never touches the network, and never throws: a
  * corrupted or unavailable cache resolves to `undefined` (pure SDK defaults).
  */
-export declare function getCachedSdkConfig(): RemoteSdkConfig | undefined;
-export declare function setCachedSdkConfig(rawConfig: string): void;
-export declare function clearCachedSdkConfig(): void;
+export declare function getCachedSdkConfig(clientToken: string): RemoteSdkConfig | undefined;
+export declare function setCachedSdkConfig(clientToken: string, rawConfig: string): void;
+export declare function clearCachedSdkConfig(clientToken: string): void;
 /**
  * A document is only usable if it is a JSON object. Anything else (array, primitive, invalid
  * JSON) is rejected wholesale.
@@ -59,9 +66,9 @@ export declare function parseSdkConfig(raw: string): RemoteSdkConfig | undefined
  */
 export declare function buildSdkConfigEndpoint(initConfiguration: InitConfiguration, applicationId?: string): string;
 /**
- * Fetch the document and refresh the cache for the *next* page load. Fire-and-forget: any
- * failure (offline, 404 because the collector has no config file, 401, timeout, malformed
- * body) leaves the existing cache untouched.
+ * Fetch the document and refresh the cache for the *next* page load. Fire-and-forget: a 404 —
+ * the collector has no configuration for this application — clears the cache, and any other
+ * failure (offline, 401, 5xx, timeout, malformed body) leaves it untouched.
  *
  * The response is validated before it overwrites the cache, so a half-written document on the
  * collector can never poison a client.
@@ -73,6 +80,19 @@ export declare function readBoolean(source: {
 export declare function readSampleRate(source: {
     [key: string]: unknown;
 } | undefined, key: string): number | undefined;
+/**
+ * Reads a number the SDK only accepts within a fixed range. Out-of-range values are rejected rather
+ * than clamped: a dashboard that asks for something the SDK cannot honour should fall back to the
+ * local value, not to a silently different one.
+ */
+export declare function readNumberInRange(source: {
+    [key: string]: unknown;
+} | undefined, key: string, min: number, max: number): number | undefined;
+/**
+ * Reads a list of non-empty strings, dropping unusable entries. Returns `undefined` for anything
+ * that is not an array, or when no entry survives, so the local value keeps applying.
+ */
+export declare function readStringList(value: unknown): string[] | undefined;
 export declare function readString(source: {
     [key: string]: unknown;
 } | undefined, key: string): string | undefined;