@configdirector/nuxt-sdk 1.12.0 → 1.13.0

package/dist/module.d.mts

@@ -2,6 +2,80 @@ import * as _$_nuxt_schema0 from "@nuxt/schema";
 import { LogLevel } from "consola";
 
 //#region ../shared/src/types.d.ts
+type ConfigEnumLikeType = {
+  [key: string]: string | number;
+};
+type ConfigValueType = string | number | boolean | object | ConfigEnumLikeType;
+/**
+ * Why an evaluation returned the value it did. `found-match` returns a value from ConfigDirector,
+ * and `cached` a value kept on the device while a client SDK waits for live values. `value-missing`
+ * returns the in-code default value because the config has no value. Every other reason returns the
+ * in-code default value because of an error: the config does not exist (`config-state-missing`), no
+ * values have arrived yet (`client-not-ready`), or the value cannot be read as the type of the in-code
+ * default value.
+ */
+type EvaluationReason = "found-match" | "config-state-missing" | "client-not-ready" | "type-mismatch" | "value-missing" | "invalid-number" | "invalid-json" | "invalid-boolean" | "cached";
+/**
+ * One evaluation of a config: the value it returned, why, and the context it was evaluated for.
+ */
+type ConfigEvaluation<T extends ConfigValueType = ConfigValueType> = {
+  /** The config key that was evaluated. */key: string; /** The value returned, which is the in-code default value when {@link isDefaultValue} is `true`. */
+  value: T; /** The ID ConfigDirector assigned to the value returned, when ConfigDirector sent one with it. */
+  valueId?: string; /** Whether the evaluation returned the in-code default value. */
+  isDefaultValue: boolean; /** Why the evaluation returned this value. */
+  reason: EvaluationReason; /** The context the config was evaluated for, if any. */
+  context?: ConfigDirectorContext;
+};
+/**
+ * The context to be sent to ConfigDirector: the user or other entity, such as a device or an
+ * organization, that configs are evaluated for. This context will be used for targeting rules
+ * evaluation.
+ */
+type ConfigDirectorContext = {
+  /**
+   * The context's identifier. This should be a value that uniquely identifies the user or other
+   * entity among contexts of the same {@link kind}.
+   * In the case of anonymous users, you could generate a UUID or alternatively not provide
+   * the {@link id}. In a client SDK, ConfigDirector then derives an identifier from an ID the SDK
+   * stores for the app install or the website, so it stays the same until the app is uninstalled
+   * or the site's data is cleared. However, keep in mind that this value is used for segmenting
+   * contexts in percentage rollouts, and changes to the {@link id} could result in the context
+   * being assigned to a different percentile.
+   */
+  id?: string;
+  /**
+   * The kind of entity this context represents, such as `user`, `device`, `organization`,
+   * `tenant` or `listing`. You can use any other kind that fits your application. A kind has 1
+   * to 64 characters, using only lowercase letters (`a`-`z`), digits, `-` and `_`. It is used
+   * exactly as given, without trimming or changing its case.
+   *
+   * A context with an invalid kind is ignored as a whole: the SDK logs an error and evaluates
+   * as if no context had been provided.
+   *
+   * @default "user"
+   */
+  kind?: string;
+  /**
+   * The context's display name. This will be shown in the ConfigDirector dashboard and may be
+   * used for targeting rules.
+   */
+  name?: string;
+  /**
+   * Any arbitrary traits for the context. They will be shown in the ConfigDirector dashboard
+   * and may be used for targeting rules.
+   */
+  traits?: {
+    [key: string]: unknown;
+  };
+  /**
+   * Whether or not to treat the context as anonymous during evaluation. When `true`, the
+   * context values will be used for targeting rules evaluation but the context will not be
+   * persisted and will not appear in the dashboard.
+   *
+   * @default false
+   */
+  anonymous?: boolean;
+};
 type ConnectionMode = "streaming" | "polling" | "offline";
 //#endregion
 //#region ../shared/src/native-values.d.ts
@@ -219,4 +293,4 @@ interface ModuleOptions {
 }
 declare const _default: _$_nuxt_schema0.NuxtModule<ModuleOptions, ModuleOptions, false>;
 //#endregion
-export { ModuleOptions, type OfflineValue, type OfflineValues, _default as default };
+export { type ConfigEvaluation, type EvaluationReason, ModuleOptions, type OfflineValue, type OfflineValues, _default as default };

package/dist/module.json

@@ -4,5 +4,5 @@
   "compatibility": {
     "nuxt": ">=4.0.0"
   },
-  "version": "1.12.0"
+  "version": "1.13.0"
 }

package/dist/runtime/app/composables/useConfigDirectorClient.d.mts

@@ -1,4 +1,4 @@
-import { n as ConfigDirectorClient } from "../../types-CuzrFq9I.mjs";
+import { n as ConfigDirectorClient } from "../../types-BvqduMQP.mjs";
 
 //#region src/runtime/app/composables/useConfigDirectorClient.d.ts
 declare const useConfigDirectorClient: () => {

package/dist/runtime/app/composables/useConfigDirectorClient.d.ts

@@ -1,4 +1,4 @@
-import { n as ConfigDirectorClient } from "../../types-CuzrFq9I.mjs";
+import { n as ConfigDirectorClient } from "../../types-BvqduMQP.mjs";
 
 //#region src/runtime/app/composables/useConfigDirectorClient.d.ts
 declare const useConfigDirectorClient: () => {

package/dist/runtime/app/composables/useConfigDirectorClientHooks.d.mts

@@ -1,4 +1,4 @@
-import { t as ClientHooks } from "../../types-CuzrFq9I.mjs";
+import { t as ClientHooks } from "../../types-BvqduMQP.mjs";
 
 //#region src/runtime/app/composables/useConfigDirectorClientHooks.d.ts
 declare const useConfigDirectorClientHooks: (hooks: ClientHooks) => void;

package/dist/runtime/app/composables/useConfigDirectorClientHooks.d.ts

@@ -1,4 +1,4 @@
-import { t as ClientHooks } from "../../types-CuzrFq9I.mjs";
+import { t as ClientHooks } from "../../types-BvqduMQP.mjs";
 
 //#region src/runtime/app/composables/useConfigDirectorClientHooks.d.ts
 declare const useConfigDirectorClientHooks: (hooks: ClientHooks) => void;

package/dist/runtime/app/composables/useConfigDirectorContext.d.mts

@@ -1,4 +1,4 @@
-import { n as ConfigDirectorContext } from "../../native-values-ChQdi7c7.mjs";
+import { n as ConfigDirectorContext } from "../../native-values-CfhP0yLS.mjs";
 import { Ref } from "vue";
 
 //#region src/runtime/app/composables/useConfigDirectorContext.d.ts

package/dist/runtime/app/composables/useConfigDirectorContext.d.ts

@@ -1,4 +1,4 @@
-import { n as ConfigDirectorContext } from "../../native-values-ChQdi7c7.mjs";
+import { n as ConfigDirectorContext } from "../../native-values-CfhP0yLS.mjs";
 import { Ref } from "vue";
 
 //#region src/runtime/app/composables/useConfigDirectorContext.d.ts

package/dist/runtime/app/composables/useConfigDirectorValue.d.mts

@@ -1,4 +1,4 @@
-import { a as ConfigValueType } from "../../native-values-ChQdi7c7.mjs";
+import { a as ConfigValueType } from "../../native-values-CfhP0yLS.mjs";
 import { t as ClientStatus } from "../../types-C30VJ25l.mjs";
 import { DeepReadonly, Ref, ShallowRef } from "vue";
 

package/dist/runtime/app/composables/useConfigDirectorValue.d.ts

@@ -1,4 +1,4 @@
-import { a as ConfigValueType } from "../../native-values-ChQdi7c7.mjs";
+import { a as ConfigValueType } from "../../native-values-CfhP0yLS.mjs";
 import { t as ClientStatus } from "../../types-C30VJ25l.mjs";
 import { DeepReadonly, Ref, ShallowRef } from "vue";
 

package/dist/runtime/{native-values-ChQdi7c7.d.mts → native-values-CfhP0yLS.d.mts}

@@ -12,13 +12,24 @@ type ConfigState = {
   value: string | undefined | null;
   valueId?: string | undefined | null;
 };
+/**
+ * Why an evaluation returned the value it did. `found-match` returns a value from ConfigDirector,
+ * and `cached` a value kept on the device while a client SDK waits for live values. `value-missing`
+ * returns the in-code default value because the config has no value. Every other reason returns the
+ * in-code default value because of an error: the config does not exist (`config-state-missing`), no
+ * values have arrived yet (`client-not-ready`), or the value cannot be read as the type of the in-code
+ * default value.
+ */
 type EvaluationReason = "found-match" | "config-state-missing" | "client-not-ready" | "type-mismatch" | "value-missing" | "invalid-number" | "invalid-json" | "invalid-boolean" | "cached";
-type ConfigEvaluation = {
-  key: string;
-  value: ConfigValueType;
-  valueId?: string;
-  isDefaultValue: boolean;
-  reason: EvaluationReason;
+/**
+ * One evaluation of a config: the value it returned, why, and the context it was evaluated for.
+ */
+type ConfigEvaluation<T extends ConfigValueType = ConfigValueType> = {
+  /** The config key that was evaluated. */key: string; /** The value returned, which is the in-code default value when {@link isDefaultValue} is `true`. */
+  value: T; /** The ID ConfigDirector assigned to the value returned, when ConfigDirector sent one with it. */
+  valueId?: string; /** Whether the evaluation returned the in-code default value. */
+  isDefaultValue: boolean; /** Why the evaluation returned this value. */
+  reason: EvaluationReason; /** The context the config was evaluated for, if any. */
   context?: ConfigDirectorContext;
 };
 /**

package/dist/runtime/nitro/offline-values.d.mts

@@ -1,4 +1,4 @@
-import { t as NativeValues } from "../native-values-ChQdi7c7.mjs";
+import { t as NativeValues } from "../native-values-CfhP0yLS.mjs";
 import * as _$h3 from "h3";
 
 //#region src/runtime/nitro/offline-values.d.ts

package/dist/runtime/nitro/offline-values.d.ts

@@ -1,4 +1,4 @@
-import { t as NativeValues } from "../native-values-ChQdi7c7.mjs";
+import { t as NativeValues } from "../native-values-CfhP0yLS.mjs";
 import * as _$h3 from "h3";
 
 //#region src/runtime/nitro/offline-values.d.ts

package/dist/runtime/nitro/plugin.d.mts

@@ -1,5 +1,5 @@
-import { o as ConnectionMode } from "../native-values-ChQdi7c7.mjs";
-import { n as ConfigDirectorClient } from "../types-BoDJiQsr.mjs";
+import { o as ConnectionMode } from "../native-values-CfhP0yLS.mjs";
+import { n as ConfigDirectorClient } from "../types-qDEc6g8R.mjs";
 import * as _$nitropack from "nitropack";
 
 //#region src/runtime/nitro/plugin.d.ts

package/dist/runtime/nitro/plugin.d.ts

@@ -1,5 +1,5 @@
-import { o as ConnectionMode } from "../native-values-ChQdi7c7.mjs";
-import { n as ConfigDirectorClient } from "../types-BoDJiQsr.mjs";
+import { o as ConnectionMode } from "../native-values-CfhP0yLS.mjs";
+import { n as ConfigDirectorClient } from "../types-qDEc6g8R.mjs";
 import * as _$nitropack from "nitropack";
 
 //#region src/runtime/nitro/plugin.d.ts

package/dist/runtime/nitro/plugin.mjs

@@ -7252,19 +7252,22 @@ var ConfigEvaluator = class {
 		this.logger = logger;
 	}
 	evaluate(config, context, segments) {
+		const explanation = this.explain(config, context, segments);
 		return {
 			id: config.id,
 			key: config.key,
 			type: config.type,
-			value: this.explain(config, context, segments).value
+			value: explanation.value,
+			valueId: explanation.valueId
 		};
 	}
 	/**
 	* Evaluate a config for a context and record how the value was reached: every rule in the
 	* order it was walked with its outcome, the conditions that were checked with what they
 	* resolved to, and the share a rollout assigned the context to. `evaluate` is this walk with
-	* only the value kept, so the two cannot disagree. `segments` is the payload's segments map,
-	* which a segment condition looks its segment up in; a segment it does not hold never matches.
+	* only the value and its value ID kept, so the two cannot disagree. `segments` is the payload's
+	* segments map, which a segment condition looks its segment up in; a segment it does not hold
+	* never matches.
 	*/
 	explain(config, context, segments) {
 		const rules = [...config.target?.rules ?? []].sort((a, b) => (a.order ?? Number.MAX_SAFE_INTEGER) - (b.order ?? Number.MAX_SAFE_INTEGER));
@@ -7282,17 +7285,24 @@ var ConfigEvaluator = class {
 			}
 			const result = this.explainRule(rule, config, context, segments);
 			explanations.push(result.explanation);
-			if (result.value !== void 0) served = {
+			if (result.served !== void 0) served = {
 				ruleId: rule.id,
-				value: result.value
+				...result.served
 			};
 		}
-		return {
-			value: served?.value ?? config.target?.defaultValue,
-			servedBy: served ? {
+		if (served) return {
+			value: served.value,
+			valueId: served.valueId,
+			servedBy: {
 				kind: "rule",
 				ruleId: served.ruleId
-			} : { kind: "default" },
+			},
+			rules: explanations
+		};
+		return {
+			value: config.target?.defaultValue,
+			valueId: config.target?.defaultValueId,
+			servedBy: { kind: "default" },
 			rules: explanations
 		};
 	}
@@ -7304,13 +7314,13 @@ var ConfigEvaluator = class {
 			bucket: void 0
 		};
 		try {
-			let value;
-			if (rule.type == "percentage") value = this.explainPercentage(rule.percentages ?? [], config, context, explanation);
-			else if (rule.type == "conditional") value = this.explainConditionalRule(rule, config, context, segments, explanation);
-			if (value !== void 0) explanation.outcome = "matched";
+			let served;
+			if (rule.type == "percentage") served = this.explainPercentage(rule.percentages ?? [], config, context, explanation);
+			else if (rule.type == "conditional") served = this.explainConditionalRule(rule, config, context, segments, explanation);
+			if (served !== void 0) explanation.outcome = "matched";
 			return {
 				explanation,
-				value
+				served
 			};
 		} catch (error) {
 			this.logger.warn(`There was an error while evaluating a targeting rule '${rule?.id}' for '${config?.key}'. The rule will be disregarded.`, {
@@ -7325,7 +7335,7 @@ var ConfigEvaluator = class {
 					conditions: [],
 					bucket: void 0
 				},
-				value: void 0
+				served: void 0
 			};
 		}
 	}
@@ -7357,7 +7367,10 @@ var ConfigEvaluator = class {
 			shares,
 			selectedPercentageId: selected?.id
 		};
-		return selected?.value != null ? selected.value.toString() : void 0;
+		return selected?.value != null ? {
+			value: selected.value.toString(),
+			valueId: selected.valueId
+		} : void 0;
 	}
 	explainConditionalRule(rule, config, context, segments, explanation) {
 		let failed = false;
@@ -7374,7 +7387,10 @@ var ConfigEvaluator = class {
 			failed = checked.outcome !== "matched";
 		}
 		if (failed) return;
-		if (rule.target == "value") return rule.value != null ? rule.value.toString() : void 0;
+		if (rule.target == "value") return rule.value != null ? {
+			value: rule.value.toString(),
+			valueId: rule.valueId
+		} : void 0;
 		if (rule.target == "percentage") return this.explainPercentage(rule.percentages ?? [], config, context, explanation);
 	}
 	explainCondition(condition, context, segments) {
@@ -7551,9 +7567,12 @@ const parseJson = (jsonString, defaultValue, requestedType, valueId) => {
 };
 const isJsonTypeCompatible = (parsed, defaultValue) => {
 	if (parsed === null) return false;
-	const defaultType = typeof defaultValue;
-	if (defaultType === "bigint") return typeof parsed === "number";
-	return typeof parsed === defaultType;
+	return jsonShapeOf(parsed) === jsonShapeOf(defaultValue);
+};
+const jsonShapeOf = (value) => {
+	if (Array.isArray(value)) return "array";
+	const nativeType = typeof value;
+	return nativeType === "bigint" ? "number" : nativeType;
 };
 //#endregion
 //#region ../shared/src/logger.ts
@@ -8282,7 +8301,7 @@ var DefaultConfigDirectorClient = class DefaultConfigDirectorClient {
 	updateWatchersForConfig(configKey) {
 		const configDefinition = this.configSet?.configs[configKey];
 		this.handlersMap.get(configKey)?.forEach((h) => {
-			const value = this.getValueFromConfigDefinition(configKey, configDefinition, h.defaultValue, h.context);
+			const value = this.evaluationOf(configKey, configDefinition, h.defaultValue, h.context).value;
 			h.handler(value);
 		});
 	}
@@ -8308,11 +8327,14 @@ var DefaultConfigDirectorClient = class DefaultConfigDirectorClient {
 		} else handlers.splice(0);
 	}
 	getValue(configKey, defaultValue, context) {
+		return this.evaluate(configKey, defaultValue, context).value;
+	}
+	evaluate(configKey, defaultValue, context) {
 		this.validateDefaultValue(defaultValue);
 		const configDefinition = this.configSet?.configs[configKey];
-		return this.getValueFromConfigDefinition(configKey, configDefinition, defaultValue, context);
+		return this.evaluationOf(configKey, configDefinition, defaultValue, context);
 	}
-	getValueFromConfigDefinition(configKey, configDefinition, defaultValue, suppliedContext) {
+	evaluationOf(configKey, configDefinition, defaultValue, suppliedContext) {
 		const context = this.contextToEvaluate(suppliedContext);
 		if (configDefinition) {
 			const configState = this.configEvaluator.evaluate(configDefinition, {
@@ -8333,16 +8355,17 @@ var DefaultConfigDirectorClient = class DefaultConfigDirectorClient {
 					evaluationReason: parseResult.reason
 				}
 			});
-			this.dispatchEvaluationEvent({
+			const evaluation = {
 				key: configKey,
 				value: parseResult.parsedValue,
 				valueId: parseResult.parsedValueId ?? void 0,
 				isDefaultValue: parseResult.usedDefault,
 				reason: parseResult.reason,
 				context
-			});
+			};
+			this.dispatchEvaluationEvent(evaluation);
 			this.logger.debug(`[ConfigDirectorClient] Evaluated '${configKey}' to '${parseResult.parsedValue}'`);
-			return parseResult.parsedValue;
+			return evaluation;
 		} else {
 			this.logger.debug(`[ConfigDirectorClient] No config state found for '${configKey}', returning default value '${defaultValue}'`);
 			const reason = this.isReady ? "config-state-missing" : "client-not-ready";
@@ -8357,14 +8380,15 @@ var DefaultConfigDirectorClient = class DefaultConfigDirectorClient {
 					evaluationReason: reason
 				}
 			});
-			this.dispatchEvaluationEvent({
+			const evaluation = {
 				key: configKey,
 				value: defaultValue,
 				isDefaultValue: true,
 				reason,
 				context
-			});
-			return defaultValue;
+			};
+			this.dispatchEvaluationEvent(evaluation);
+			return evaluation;
 		}
 	}
 	contextToEvaluate(suppliedContext) {
@@ -8452,7 +8476,7 @@ var plugin_default = defineNitroPlugin((nitroApp) => {
 	logger.debug("Initializing ConfigDirector Nitro plugin");
 	const client = new DefaultConfigDirectorClient(serverSdkKey || void 0, {
 		sdkName: "nuxt-sdk",
-		sdkVersion: "1.12.0"
+		sdkVersion: "1.13.0"
 	}, {
 		logger,
 		connection: {

package/dist/runtime/plugin.client.mjs

@@ -819,9 +819,12 @@ const parseJson = (jsonString, defaultValue, requestedType, valueId) => {
 };
 const isJsonTypeCompatible = (parsed, defaultValue) => {
 	if (parsed === null) return false;
-	const defaultType = typeof defaultValue;
-	if (defaultType === "bigint") return typeof parsed === "number";
-	return typeof parsed === defaultType;
+	return jsonShapeOf(parsed) === jsonShapeOf(defaultValue);
+};
+const jsonShapeOf = (value) => {
+	if (Array.isArray(value)) return "array";
+	const nativeType = typeof value;
+	return nativeType === "bigint" ? "number" : nativeType;
 };
 //#endregion
 //#region ../shared/src/logger.ts
@@ -1265,11 +1268,12 @@ const utf8ByteLength = (text) => {
 };
 //#endregion
 //#region ../js-client-core/src/cached-values.ts
-const ENTRY_FORMAT_VERSION = 1;
+const ENTRY_FORMAT_VERSION = 2;
+const FIRST_ENTRY_FORMAT_VERSION = 1;
 const DEFAULT_CONTEXT_KIND = "user";
 const CACHED_VALUES_STORAGE_KEY_PREFIX = "configdirector-sdk:cached-values:";
 const DEFAULT_CACHING_SIZE_LIMIT_BYTES = 256 * 1024;
-const planCaching = (connectionPlan, caching, platformProvider) => {
+const planCaching = (connectionPlan, caching, sha256HexDigest, platformCachingProvider) => {
 	if (connectionPlan.kind === "stay-offline") return {
 		kind: "no cache",
 		reason: "offline mode"
@@ -1278,7 +1282,12 @@ const planCaching = (connectionPlan, caching, platformProvider) => {
 		kind: "no cache",
 		reason: "turned off"
 	};
-	const provider = caching?.provider ?? platformProvider?.(connectionPlan.clientSdkKey);
+	if (!sha256HexDigest) return {
+		kind: "no cache",
+		reason: "no SHA-256 available"
+	};
+	const clientSdkKeyDigest = sha256HexDigest(connectionPlan.clientSdkKey);
+	const provider = caching?.provider ?? platformCachingProvider?.(clientSdkKeyDigest);
 	if (!provider) return {
 		kind: "no cache",
 		reason: "no provider available"
@@ -1286,7 +1295,7 @@ const planCaching = (connectionPlan, caching, platformProvider) => {
 	return {
 		kind: "cache",
 		provider,
-		clientSdkKey: connectionPlan.clientSdkKey
+		clientSdkKeyDigest
 	};
 };
 const contextTagFor = (context, instanceId) => {
@@ -1321,19 +1330,34 @@ const isConfigStateMap = (candidate) => {
 	if (!candidate || typeof candidate !== "object" || Array.isArray(candidate)) return false;
 	return Object.values(candidate).every((config) => config && typeof config === "object" && typeof config.id === "string" && typeof config.key === "string");
 };
-const isEntryFor = (clientSdkKey, candidate) => {
+const isEntryFor = (clientSdkKeyDigest, candidate) => {
 	if (!candidate || typeof candidate !== "object") return false;
 	const entry = candidate;
-	return entry.formatVersion === ENTRY_FORMAT_VERSION && entry.clientSdkKey === clientSdkKey && isContextTag(entry.contextTag) && typeof entry.environmentId === "string" && typeof entry.projectId === "string" && isConfigStateMap(entry.configs) && typeof entry.receivedAt === "number";
+	return entry.formatVersion === ENTRY_FORMAT_VERSION && entry.clientSdkKeyDigest === clientSdkKeyDigest && isContextTag(entry.contextTag) && typeof entry.environmentId === "string" && typeof entry.projectId === "string" && isConfigStateMap(entry.configs) && typeof entry.receivedAt === "number";
+};
+const hasFirstFormatVersion = (candidate) => !!candidate && typeof candidate === "object" && candidate.formatVersion === FIRST_ENTRY_FORMAT_VERSION;
+const parseEntry = (raw, clientSdkKeyDigest) => {
+	let candidate;
+	try {
+		candidate = JSON.parse(raw);
+	} catch {
+		return { outcome: "unreadable" };
+	}
+	if (isEntryFor(clientSdkKeyDigest, candidate)) return {
+		outcome: "stored",
+		cachedValues: candidate
+	};
+	if (hasFirstFormatVersion(candidate)) return { outcome: "first format" };
+	return { outcome: "unreadable" };
 };
 var CachedValuesStore = class {
 	warned = /* @__PURE__ */ new Set();
 	pendingRead;
 	queuedCachedValues;
 	writing = false;
-	constructor(provider, clientSdkKey, logger) {
+	constructor(provider, clientSdkKeyDigest, logger) {
 		this.provider = provider;
-		this.clientSdkKey = clientSdkKey;
+		this.clientSdkKeyDigest = clientSdkKeyDigest;
 		this.logger = logger;
 	}
 	read() {
@@ -1353,23 +1377,16 @@ var CachedValuesStore = class {
 			return { outcome: "failed" };
 		}
 		if (raw == null || raw === "") return { outcome: "nothing stored" };
-		const entry = this.parseEntry(raw);
-		if (!entry) {
-			this.warnOnce("unreadable", "The values kept on the device could not be read and were removed, starting without them");
-			await this.removeEntry();
-			return { outcome: "unreadable" };
-		}
-		return {
-			outcome: "stored",
-			cachedValues: entry
-		};
-	}
-	parseEntry(raw) {
-		try {
-			const candidate = JSON.parse(raw);
-			return isEntryFor(this.clientSdkKey, candidate) ? candidate : void 0;
-		} catch {
-			return;
+		const entryParseOutcome = parseEntry(raw, await this.clientSdkKeyDigest);
+		switch (entryParseOutcome.outcome) {
+			case "stored": return entryParseOutcome;
+			case "first format":
+				await this.removeEntry();
+				return entryParseOutcome;
+			case "unreadable":
+				this.warnOnce("unreadable", "The values kept on the device could not be read and were removed, starting without them");
+				await this.removeEntry();
+				return entryParseOutcome;
 		}
 	}
 	async writeQueued() {
@@ -1388,7 +1405,7 @@ var CachedValuesStore = class {
 	async writeEntry(cachedValues) {
 		const entry = {
 			formatVersion: ENTRY_FORMAT_VERSION,
-			clientSdkKey: this.clientSdkKey,
+			clientSdkKeyDigest: await this.clientSdkKeyDigest,
 			...cachedValues
 		};
 		const serialized = JSON.stringify(entry);
@@ -1452,7 +1469,7 @@ var DefaultConfigDirectorClient = class DefaultConfigDirectorClient {
 		this.timeout = clientOptions?.connection?.timeout ?? 3e3;
 		const urlFactory = internalClientOptions?.urlFactory ?? defaultUrlFactory;
 		this.connectionPlan = planConnection(clientSdkKey, clientOptions?.connection, urlFactory);
-		this.cachedValuesStore = this.buildCachedValuesStore(planCaching(this.connectionPlan, clientOptions?.caching, internalClientOptions?.platformCachingProvider));
+		this.cachedValuesStore = this.buildCachedValuesStore(planCaching(this.connectionPlan, clientOptions?.caching, internalClientOptions?.sha256HexDigest, internalClientOptions?.platformCachingProvider));
 		this.telemetryClient = this.buildTelemetryClient(liveTelemetryClient, clientOptions);
 		this.transport = internalClientOptions?.transport ?? this.buildTransport(sdkOptions, clientOptions, urlFactory, internalClientOptions);
 		this.transport.on("configSetReceived", (configSet) => {
@@ -1495,7 +1512,7 @@ var DefaultConfigDirectorClient = class DefaultConfigDirectorClient {
 				this.logger.debug(`[ConfigDirectorClient] No values are kept on the device: ${cachingPlan.reason}`);
 				return;
 			case "cache": {
-				const store = new CachedValuesStore(cachingPlan.provider, cachingPlan.clientSdkKey, this.logger);
+				const store = new CachedValuesStore(cachingPlan.provider, cachingPlan.clientSdkKeyDigest, this.logger);
 				store.read();
 				return store;
 			}
@@ -1511,6 +1528,7 @@ var DefaultConfigDirectorClient = class DefaultConfigDirectorClient {
 		const read = await store.read();
 		switch (read.outcome) {
 			case "nothing stored":
+			case "first format":
 			case "unreadable":
 			case "failed": return;
 			case "stored": break;
@@ -1584,7 +1602,8 @@ var DefaultConfigDirectorClient = class DefaultConfigDirectorClient {
 				clientSdkKey: plan.clientSdkKey,
 				baseUrl: plan.baseUrl,
 				logger: this.logger,
-				metadata: clientOptions?.metadata
+				metadata: clientOptions?.metadata,
+				clientSession: this.clientSession
 			});
 		}
 	}
@@ -1704,7 +1723,7 @@ var DefaultConfigDirectorClient = class DefaultConfigDirectorClient {
 	updateWatchersForConfig(configKey) {
 		const configState = this.configSet?.configs[configKey];
 		this.handlersMap.get(configKey)?.forEach((h) => {
-			const value = this.getValueFromConfigState(configKey, configState, h.defaultValue);
+			const value = this.evaluationOf(configKey, configState, h.defaultValue).value;
 			h.handler(value);
 		});
 	}
@@ -1729,11 +1748,14 @@ var DefaultConfigDirectorClient = class DefaultConfigDirectorClient {
 		} else handlers.splice(0);
 	}
 	getValue(configKey, defaultValue) {
+		return this.evaluate(configKey, defaultValue).value;
+	}
+	evaluate(configKey, defaultValue) {
 		this.validateDefaultValue(defaultValue);
 		const configState = this.configSet?.configs[configKey];
-		return this.getValueFromConfigState(configKey, configState, defaultValue);
+		return this.evaluationOf(configKey, configState, defaultValue);
 	}
-	getValueFromConfigState(configKey, configState, defaultValue) {
+	evaluationOf(configKey, configState, defaultValue) {
 		if (!configState) {
 			this.logger.debug(`[ConfigDirectorClient] No config state found for '${configKey}', returning default value '${defaultValue}'`);
 			const reason = this.isReady ? "config-state-missing" : "client-not-ready";
@@ -1746,14 +1768,15 @@ var DefaultConfigDirectorClient = class DefaultConfigDirectorClient {
 				usedDefault: true,
 				evaluationReason: reason
 			});
-			this.dispatchEvaluationEvent({
+			const evaluation = {
 				key: configKey,
 				value: defaultValue,
 				isDefaultValue: true,
 				reason,
 				context: this.context
-			});
-			return defaultValue;
+			};
+			this.dispatchEvaluationEvent(evaluation);
+			return evaluation;
 		}
 		const parseResult = parseConfigValue(configState, defaultValue);
 		const reason = this.servedReason(parseResult.reason);
@@ -1768,16 +1791,17 @@ var DefaultConfigDirectorClient = class DefaultConfigDirectorClient {
 			usedDefault: parseResult.usedDefault,
 			evaluationReason: reason
 		});
-		this.dispatchEvaluationEvent({
+		const evaluation = {
 			key: configKey,
 			value: parseResult.parsedValue,
 			valueId: parseResult.parsedValueId ?? void 0,
 			isDefaultValue: parseResult.usedDefault,
 			reason,
 			context: this.context
-		});
+		};
+		this.dispatchEvaluationEvent(evaluation);
 		this.logger.debug(`[ConfigDirectorClient] Evaluated '${configKey}' to '${parseResult.parsedValue}'`);
-		return parseResult.parsedValue;
+		return evaluation;
 	}
 	dispatchEvaluationEvent(event) {
 		setTimeout(() => this.emit("configEvaluated", { evaluation: event }), 0);
@@ -1931,6 +1955,7 @@ const DEFAULT_WORKER_CLOSE_TIMEOUT = 6e3;
 var WebWorkerTelemetryClient = class {
 	logger;
 	initializeMessage;
+	clientSession;
 	worker;
 	turnedOff = false;
 	pendingEvaluations = [];
@@ -1945,6 +1970,7 @@ var WebWorkerTelemetryClient = class {
 		this.logger = options.logger;
 		this.workerCloseTimeout = options.workerCloseTimeout ?? DEFAULT_WORKER_CLOSE_TIMEOUT;
 		this.pendingEvaluationLimit = options.evaluationQueueLimit ?? 1e3;
+		this.clientSession = options.clientSession;
 		this.initializeMessage = {
 			type: "Initialize",
 			payload: {
@@ -1967,7 +1993,7 @@ var WebWorkerTelemetryClient = class {
 			return;
 		}
 		try {
-			return new Worker(URL.createObjectURL(new Blob(["(function(){let e=async(e,t)=>e.valueId?{valueId:e.valueId}:e.value?e.value.length<=500&&e.type!=`json`?{value:e.value}:{valueId:await t(e.value)}:e,t=e=>{let t=Object.keys(e);if(t.length==0)return!0;for(let n of t)if((e[n]?.length??0)>0)return!1;return!0},n=e=>{if(!e)return!0;let t=Object.keys(e);if(t.length==0)return!0;for(let n of t)if((e[n]??0)>0)return!1;return!0},r=async(e,t,n,r)=>{let i=new AbortController,a=setTimeout(()=>{r.debug(`[fetchWithTimeout] Reached timeout, aborting request`),i.abort()},e);try{let e=await fetch(typeof t==`string`||t instanceof Request?t:t.toString(),{...n,signal:i.signal});return clearTimeout(a),e}catch(e){throw r.warn(`[fetchWithTimeout] Fetch error: `,e),clearTimeout(a),e}},i=e=>e?.name===`NotAllowedError`?!0:e instanceof TypeError;var a=class{constructor(e){this.executeRequests=!0,this.sdkKey=e.sdkKey,this.logger=e.logger,this.sdkIdentity=e.sdkIdentity,this.metaContext=e.metaContext,this.url=e.urlFactory(`client/telemetry/v1`,e.baseUrl)}async report({context:e,discreteEvents:t,aggregatedEvents:n,droppedEvents:r}){if(!this.executeRequests)return{success:!1,fatalError:!0};let i={clientSdkKey:this.sdkKey,metaContext:{sdkName:this.sdkIdentity.sdkName,sdkVersion:this.sdkIdentity.sdkVersion,appName:this.metaContext.appName,appVersion:this.metaContext.appVersion},context:e,discreteEvents:t,aggregatedEvents:n,droppedEvents:r};if(this.isReportEmpty(i))return{success:!0,fatalError:!1};let a=await this.sendReport(i);return a.fatalError&&(this.executeRequests=!1),a}isReportEmpty(e){return t(e.discreteEvents)&&t(e.aggregatedEvents)&&n(e.droppedEvents)}async sendReport(e){try{let t=await r(5e3,this.url,{method:`POST`,body:JSON.stringify(e),keepalive:!0},this.logger),n=this.isStatusFatal(t.status);return n&&this.logger.warn(`[EventReporter] Received a fatal status response (${t.status}) from the telemetry endpoint. No more telemetry data will be sent.`),{success:t.ok,fatalError:n}}catch(e){let t=i(e);return this.logger.warn(`[EventReporter] Error attempting to send telemetry data: ${e}`,{error:e}),{success:!1,fatalError:t}}}isStatusFatal(e){return!!e&&e>=400&&e<500&&e!=429}},o=class{aggregate(e){if(e.events.length==0)return[];let t=new Map;for(let n of e.events){let e=JSON.stringify(n),r=t.get(e)?.count||0;t.set(e,{event:n,count:r+1})}return Array.from(t).map(([,t])=>({startTime:e.startTime,endTime:e.endTime,count:t.count,event:t.event}))}},s=class{constructor(e){this._events=[],this._droppedEventCount=0,this.limit=e??1e3}get events(){return this._events}get reachedLimit(){return this._events.length>=this.limit}get droppedEventCount(){return this._droppedEventCount}push(...e){this.startTime||=new Date;let t=Math.max(0,e.length-this.limit),n=e.slice(t,e.length);if(this._droppedEventCount+=t,this._events.length+n.length>this.limit){let e=this._events.length+n.length-this.limit;this._events.splice(0,e),this._droppedEventCount+=e}return this._events.push(...n)}takeSnapshot(){let e=new Date,t=this.startTime??e,n=this._events.splice(0),r=this._droppedEventCount;return this.startTime=void 0,this._droppedEventCount=0,{startTime:t,endTime:e,events:n,droppedCount:r}}clear(){this._events=[],this.startTime=void 0,this._droppedEventCount=0}},c=class{constructor(e){this.aggregator=new o,this.collectEvents=!0,this.started=!1,this.logger=e.logger,this.evaluationEventQueue=new s(e.evaluationQueueLimit??1e3),this.flushIntervalDelay=e.flushIntervalDelay??3e4,this.initialFlushIntervalDelay=e.initialFlushIntervalDelay??5e3}start(){this.started||!this.collectEvents||(this.started=!0,this.flushTimeout=setTimeout(()=>this.flushAndScheduleNext(),this.initialFlushIntervalDelay))}async flushAndScheduleNext(){if(!this.collectEvents)return;let e;try{e=await this.flush()}catch(t){this.logger.warn(`[TelemetryEventCollector] Error flushing telemetry events: `,t),e={success:!1,fatalError:!1}}e.fatalError?(this.collectEvents=!1,this.close(),this.logger.warn(`[TelemetryEventCollector] Received a fatal error from telemetry collection. No longer collecting events.`)):this.collectEvents&&(this.cancelScheduledFlush(),this.flushTimeout=setTimeout(()=>this.flushAndScheduleNext(),this.flushIntervalDelay))}cancelScheduledFlush(){clearTimeout(this.flushTimeout)}async close(){this.collectEvents=!1,clearTimeout(this.flushTimeout);try{await this.flush()}catch(e){this.logger.warn(`[TelemetryEventCollector] Error flushing telemetry events during close: `,e)}this.evaluationEventQueue.clear()}dispose(){this.close()}},l=class{constructor(e){this.valueIdGenerator=e,this.valueIdGenerator=e}async process(t){let n=await Promise.all(t.events.map(async t=>({...t,defaultValue:await e(t.defaultValue,this.valueIdGenerator),evaluatedValue:await e(t.evaluatedValue,this.valueIdGenerator)})));return{...t,events:n}}},u=class{constructor(){this.countsByKindSample=new Map,this.countBeyondSampleLimit=0}record(e){return this.startTime??=new Date,this.add(e,1)}absorb(e){for(let t of e)(this.startTime===void 0||t.startTime<this.startTime)&&(this.startTime=t.startTime),this.add(t.event.kindSample,t.count)}add(e,t){if(e!==void 0){let n=this.countsByKindSample.get(e);if(n!==void 0)return this.countsByKindSample.set(e,n+t),`known-kind-sample`;if(this.countsByKindSample.size<20)return this.countsByKindSample.set(e,t),`new-kind-sample`}let n=this.countBeyondSampleLimit===0;return this.countBeyondSampleLimit+=t,n?`first-beyond-sample-limit`:`beyond-sample-limit`}takeSnapshot(){let e=new Date,t=this.startTime??e,n=(n,r)=>({startTime:t,endTime:e,count:n,event:{reason:`invalid-context-kind`,kindSample:r}}),r=Array.from(this.countsByKindSample,([e,t])=>n(t,e)),i=this.countBeyondSampleLimit>0?[...r,n(this.countBeyondSampleLimit)]:r;return this.clear(),i}clear(){this.countsByKindSample.clear(),this.countBeyondSampleLimit=0,this.startTime=void 0}},d=class extends c{constructor(e){super(e),this.invalidContextSubmissions=new u,this.reporter=new a(e),this.evaluationEventSnapshotPreprocessor=new l(e.valueIdGenerator)}async updateContext(e){this.cancelScheduledFlush(),await this.flush(),this._context=e,await this.flushAndScheduleNext()}evaluatedConfig(e){this.collectEvents&&this.evaluationEventQueue.push(e)}recordInvalidContext(e){this.invalidContextSubmissions.record(e)}absorbInvalidContextSubmissions(e){this.invalidContextSubmissions.absorb(e)}async forceFlush(){this.cancelScheduledFlush(),await this.flushAndScheduleNext()}async flush(){if(!this.reporter)return{success:!1,fatalError:!1};let e=await this.evaluationEventSnapshotPreprocessor.process(this.evaluationEventQueue.takeSnapshot());return await this.reporter?.report({context:this._context,discreteEvents:{},aggregatedEvents:{evaluatedConfig:this.aggregator.aggregate(e),invalidContext:this.invalidContextSubmissions.takeSnapshot()},droppedEvents:{evaluatedConfig:e.droppedCount}})}};let f=(e,t)=>new URL(e,t?.toString()),p=(e,t)=>{let n=BigInt(0),r=BigInt(62),i=Array.from(e).map(e=>e.toString(16).padStart(2,`0`)).join(``),a=BigInt(`0x`+i),o=``;for(;a>n;)o=`0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz`[Number(a%r)]+o,a/=r;return o.padStart(t,`0`)},m=Math.ceil(128/Math.log2(62)),h=new TextEncoder,g=async e=>{if(typeof crypto>`u`||crypto.subtle==null)return;let t=await crypto.subtle.digest(`SHA-256`,h.encode(e?.toString()??``));return p(new Uint8Array(t,0,16),m)},_,v=(e,t,...n)=>({type:`Log`,payload:{level:e,message:t,args:n}}),y=e=>{try{self.postMessage(e)}catch{self.postMessage(v(e.payload.level,e.payload.message))}},b={debug:function(e,...t){y(v(`debug`,e,t))},info:function(e,...t){y(v(`info`,e,t))},warn:function(e,...t){y(v(`warn`,e,t))},error:function(e,...t){y(v(`error`,e,t))}};addEventListener(`message`,e=>{let t=e.data;if(t.type!=`Initialize`&&!_){b.info(`[TelemetryWorker] Ignoring ${t.type} because no collector is configured`);return}switch(b.debug(`[TelemetryWorker] Received '${t.type}' event:`,t),t.type){case`Initialize`:if(_){b.warn(`[TelemetryWorker] Received a duplicate Initialize event, ignoring it`);break}_=new d({...t.payload,baseUrl:f(t.payload.baseUrl),urlFactory:f,valueIdGenerator:g,logger:b}),_.start();break;case`EvaluatedConfigEvent`:_?.evaluatedConfig(t.payload);break;case`InvalidContextSubmissions`:_?.absorbInvalidContextSubmissions(t.payload.entries);break;case`UpdateContext`:_?.updateContext(t.payload.context);break;case`Flush`:_?.forceFlush();break;case`Close`:(_?.close()??Promise.resolve()).then(()=>{self.postMessage({type:`Closed`}),self.close()});break}})})();"], { type: "application/javascript" })));
+			return new Worker(URL.createObjectURL(new Blob(["(function(){let e=async(e,t)=>e.valueId?{valueId:e.valueId}:e.value?e.value.length<=500&&e.type!=`json`?{value:e.value}:{valueId:await t(e.value)}:e,t=e=>{let t=Object.keys(e);if(t.length==0)return!0;for(let n of t)if((e[n]?.length??0)>0)return!1;return!0},n=e=>{if(!e)return!0;let t=Object.keys(e);if(t.length==0)return!0;for(let n of t)if((e[n]??0)>0)return!1;return!0},r=async(e,t,n,r)=>{let i=new AbortController,a=setTimeout(()=>{r.debug(`[fetchWithTimeout] Reached timeout, aborting request`),i.abort()},e);try{let e=await fetch(typeof t==`string`||t instanceof Request?t:t.toString(),{...n,signal:i.signal});return clearTimeout(a),e}catch(e){throw r.warn(`[fetchWithTimeout] Fetch error: `,e),clearTimeout(a),e}},i=e=>e?.name===`NotAllowedError`?!0:e instanceof TypeError;var a=class{constructor(e){this.executeRequests=!0,this.sdkKey=e.sdkKey,this.logger=e.logger,this.sdkIdentity=e.sdkIdentity,this.metaContext=e.metaContext,this.url=e.urlFactory(`client/telemetry/v1`,e.baseUrl),this.clientSession=e.clientSession}async report({context:e,discreteEvents:t,aggregatedEvents:n,droppedEvents:r}){if(!this.executeRequests)return{success:!1,fatalError:!0};let{instanceId:i}=await this.clientSession,a={clientSdkKey:this.sdkKey,instanceId:i,metaContext:{sdkName:this.sdkIdentity.sdkName,sdkVersion:this.sdkIdentity.sdkVersion,appName:this.metaContext.appName,appVersion:this.metaContext.appVersion},context:e,discreteEvents:t,aggregatedEvents:n,droppedEvents:r};if(this.isReportEmpty(a))return{success:!0,fatalError:!1};let o=await this.sendReport(a);return o.fatalError&&(this.executeRequests=!1),o}isReportEmpty(e){return t(e.discreteEvents)&&t(e.aggregatedEvents)&&n(e.droppedEvents)}async sendReport(e){try{let t=await r(5e3,this.url,{method:`POST`,body:JSON.stringify(e),keepalive:!0},this.logger),n=this.isStatusFatal(t.status);return n&&this.logger.warn(`[EventReporter] Received a fatal status response (${t.status}) from the telemetry endpoint. No more telemetry data will be sent.`),{success:t.ok,fatalError:n}}catch(e){let t=i(e);return this.logger.warn(`[EventReporter] Error attempting to send telemetry data: ${e}`,{error:e}),{success:!1,fatalError:t}}}isStatusFatal(e){return!!e&&e>=400&&e<500&&e!=429}},o=class{aggregate(e){if(e.events.length==0)return[];let t=new Map;for(let n of e.events){let e=JSON.stringify(n),r=t.get(e)?.count||0;t.set(e,{event:n,count:r+1})}return Array.from(t).map(([,t])=>({startTime:e.startTime,endTime:e.endTime,count:t.count,event:t.event}))}},s=class{constructor(e){this._events=[],this._droppedEventCount=0,this.limit=e??1e3}get events(){return this._events}get reachedLimit(){return this._events.length>=this.limit}get droppedEventCount(){return this._droppedEventCount}push(...e){this.startTime||=new Date;let t=Math.max(0,e.length-this.limit),n=e.slice(t,e.length);if(this._droppedEventCount+=t,this._events.length+n.length>this.limit){let e=this._events.length+n.length-this.limit;this._events.splice(0,e),this._droppedEventCount+=e}return this._events.push(...n)}takeSnapshot(){let e=new Date,t=this.startTime??e,n=this._events.splice(0),r=this._droppedEventCount;return this.startTime=void 0,this._droppedEventCount=0,{startTime:t,endTime:e,events:n,droppedCount:r}}clear(){this._events=[],this.startTime=void 0,this._droppedEventCount=0}},c=class{constructor(e){this.aggregator=new o,this.collectEvents=!0,this.started=!1,this.logger=e.logger,this.evaluationEventQueue=new s(e.evaluationQueueLimit??1e3),this.flushIntervalDelay=e.flushIntervalDelay??3e4,this.initialFlushIntervalDelay=e.initialFlushIntervalDelay??5e3}start(){this.started||!this.collectEvents||(this.started=!0,this.flushTimeout=setTimeout(()=>this.flushAndScheduleNext(),this.initialFlushIntervalDelay))}async flushAndScheduleNext(){if(!this.collectEvents)return;let e;try{e=await this.flush()}catch(t){this.logger.warn(`[TelemetryEventCollector] Error flushing telemetry events: `,t),e={success:!1,fatalError:!1}}e.fatalError?(this.collectEvents=!1,this.close(),this.logger.warn(`[TelemetryEventCollector] Received a fatal error from telemetry collection. No longer collecting events.`)):this.collectEvents&&(this.cancelScheduledFlush(),this.flushTimeout=setTimeout(()=>this.flushAndScheduleNext(),this.flushIntervalDelay))}cancelScheduledFlush(){clearTimeout(this.flushTimeout)}async close(){this.collectEvents=!1,clearTimeout(this.flushTimeout);try{await this.flush()}catch(e){this.logger.warn(`[TelemetryEventCollector] Error flushing telemetry events during close: `,e)}this.evaluationEventQueue.clear()}dispose(){this.close()}},l=class{constructor(e){this.valueIdGenerator=e,this.valueIdGenerator=e}async process(t){let n=await Promise.all(t.events.map(async t=>({...t,defaultValue:await e(t.defaultValue,this.valueIdGenerator),evaluatedValue:await e(t.evaluatedValue,this.valueIdGenerator)})));return{...t,events:n}}},u=class{constructor(){this.countsByKindSample=new Map,this.countBeyondSampleLimit=0}record(e){return this.startTime??=new Date,this.add(e,1)}absorb(e){for(let t of e)(this.startTime===void 0||t.startTime<this.startTime)&&(this.startTime=t.startTime),this.add(t.event.kindSample,t.count)}add(e,t){if(e!==void 0){let n=this.countsByKindSample.get(e);if(n!==void 0)return this.countsByKindSample.set(e,n+t),`known-kind-sample`;if(this.countsByKindSample.size<20)return this.countsByKindSample.set(e,t),`new-kind-sample`}let n=this.countBeyondSampleLimit===0;return this.countBeyondSampleLimit+=t,n?`first-beyond-sample-limit`:`beyond-sample-limit`}takeSnapshot(){let e=new Date,t=this.startTime??e,n=(n,r)=>({startTime:t,endTime:e,count:n,event:{reason:`invalid-context-kind`,kindSample:r}}),r=Array.from(this.countsByKindSample,([e,t])=>n(t,e)),i=this.countBeyondSampleLimit>0?[...r,n(this.countBeyondSampleLimit)]:r;return this.clear(),i}clear(){this.countsByKindSample.clear(),this.countBeyondSampleLimit=0,this.startTime=void 0}},d=class extends c{constructor(e){super(e),this.invalidContextSubmissions=new u,this.reporter=new a(e),this.evaluationEventSnapshotPreprocessor=new l(e.valueIdGenerator)}async updateContext(e){this.cancelScheduledFlush(),await this.flush(),this._context=e,await this.flushAndScheduleNext()}evaluatedConfig(e){this.collectEvents&&this.evaluationEventQueue.push(e)}recordInvalidContext(e){this.invalidContextSubmissions.record(e)}absorbInvalidContextSubmissions(e){this.invalidContextSubmissions.absorb(e)}async forceFlush(){this.cancelScheduledFlush(),await this.flushAndScheduleNext()}async flush(){if(!this.reporter)return{success:!1,fatalError:!1};let e=await this.evaluationEventSnapshotPreprocessor.process(this.evaluationEventQueue.takeSnapshot());return await this.reporter?.report({context:this._context,discreteEvents:{},aggregatedEvents:{evaluatedConfig:this.aggregator.aggregate(e),invalidContext:this.invalidContextSubmissions.takeSnapshot()},droppedEvents:{evaluatedConfig:e.droppedCount}})}};let f=(e,t)=>new URL(e,t?.toString()),p=(e,t)=>{let n=BigInt(0),r=BigInt(62),i=Array.from(e).map(e=>e.toString(16).padStart(2,`0`)).join(``),a=BigInt(`0x`+i),o=``;for(;a>n;)o=`0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz`[Number(a%r)]+o,a/=r;return o.padStart(t,`0`)},m=Math.ceil(128/Math.log2(62)),h=new TextEncoder,g=async e=>{if(typeof crypto>`u`||crypto.subtle==null)return;let t=await crypto.subtle.digest(`SHA-256`,h.encode(e?.toString()??``));return p(new Uint8Array(t,0,16),m)},_,v,y=new Promise(e=>{v=e}),b=(e,t,...n)=>({type:`Log`,payload:{level:e,message:t,args:n}}),x=e=>{try{self.postMessage(e)}catch{self.postMessage(b(e.payload.level,e.payload.message))}},S={debug:function(e,...t){x(b(`debug`,e,t))},info:function(e,...t){x(b(`info`,e,t))},warn:function(e,...t){x(b(`warn`,e,t))},error:function(e,...t){x(b(`error`,e,t))}};addEventListener(`message`,e=>{let t=e.data;if(t.type!=`Initialize`&&!_){S.info(`[TelemetryWorker] Ignoring ${t.type} because no collector is configured`);return}switch(S.debug(`[TelemetryWorker] Received '${t.type}' event:`,t),t.type){case`Initialize`:if(_){S.warn(`[TelemetryWorker] Received a duplicate Initialize event, ignoring it`);break}_=new d({...t.payload,baseUrl:f(t.payload.baseUrl),urlFactory:f,valueIdGenerator:g,logger:S,clientSession:y}),_.start();break;case`ClientSession`:v(t.payload);break;case`EvaluatedConfigEvent`:_?.evaluatedConfig(t.payload);break;case`InvalidContextSubmissions`:_?.absorbInvalidContextSubmissions(t.payload.entries);break;case`UpdateContext`:_?.updateContext(t.payload.context);break;case`Flush`:_?.forceFlush();break;case`Close`:(_?.close()??Promise.resolve()).then(()=>{self.postMessage({type:`Closed`}),self.close()});break}})})();"], { type: "application/javascript" })));
 		} catch (error) {
 			this.turnOff("[WebWorkerTelemetryClient] Telemetry is off because the telemetry Web Worker could not be created: ", error);
 			return;
@@ -1986,6 +2012,7 @@ var WebWorkerTelemetryClient = class {
 			this.handleWorkerEvent(message.data);
 		};
 		worker.postMessage(this.initializeMessage);
+		this.forwardClientSession(worker);
 		this.worker = worker;
 		try {
 			document.addEventListener("visibilitychange", this.visibilityHandler);
@@ -1997,6 +2024,15 @@ var WebWorkerTelemetryClient = class {
 		this.forwardInvalidContextSubmissions(worker);
 		return worker;
 	}
+	forwardClientSession(worker) {
+		this.clientSession.then((clientSession) => {
+			const clientSessionMessage = {
+				type: "ClientSession",
+				payload: clientSession
+			};
+			worker.postMessage(clientSessionMessage);
+		});
+	}
 	forwardInvalidContextSubmissions(worker) {
 		if (!worker) return;
 		const entries = this.pendingInvalidContextSubmissions.takeSnapshot();
@@ -2130,16 +2166,10 @@ const generateValueId = async (v) => {
 };
 //#endregion
 //#region ../js-browser-client/src/local-storage-caching-provider.ts
-const toHex = (bytes) => Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
-const storageKeyFor = async (clientSdkKey) => {
-	const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(clientSdkKey));
-	return CACHED_VALUES_STORAGE_KEY_PREFIX + toHex(new Uint8Array(digest));
-};
-const subtleCryptoAvailable = () => typeof crypto !== "undefined" && crypto.subtle != null;
-const localStorageCachingProvider = (clientSdkKey) => {
+const localStorageCachingProvider = (clientSdkKeyDigest) => {
 	const storage = localStorageIfAvailable();
-	if (!storage || !subtleCryptoAvailable()) return;
-	const storageKey = storageKeyFor(clientSdkKey);
+	if (!storage) return;
+	const storageKey = clientSdkKeyDigest.then((digest) => CACHED_VALUES_STORAGE_KEY_PREFIX + digest);
 	return {
 		read: async () => storage.getItem(await storageKey),
 		write: async (value) => storage.setItem(await storageKey, value),
@@ -2148,6 +2178,16 @@ const localStorageCachingProvider = (clientSdkKey) => {
 	};
 };
 //#endregion
+//#region ../js-browser-client/src/sha256-hex-digest.ts
+const toHex = (bytes) => Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
+const sha256HexDigestIfAvailable = () => {
+	if (typeof crypto === "undefined" || crypto.subtle == null) return;
+	return async (text) => {
+		const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(text));
+		return toHex(new Uint8Array(digest));
+	};
+};
+//#endregion
 //#region ../js-browser-client/src/BrowserConfigDirectorClient.ts
 /**
 * Creates a browser client. With a client SDK key it connects to ConfigDirector; with
@@ -2156,7 +2196,7 @@ const localStorageCachingProvider = (clientSdkKey) => {
 * and fails like a missing key otherwise.
 */
 const createBrowserClient = (clientSdkKeyOrOptions, sdkOptions, clientOptions) => {
-	return DefaultConfigDirectorClient.from(({ clientSdkKey, baseUrl, logger, metadata }) => new WebWorkerTelemetryClient({
+	return DefaultConfigDirectorClient.from(({ clientSdkKey, baseUrl, logger, metadata, clientSession }) => new WebWorkerTelemetryClient({
 		sdkKey: clientSdkKey,
 		sdkIdentity: {
 			sdkName: sdkOptions.sdkName,
@@ -2169,8 +2209,12 @@ const createBrowserClient = (clientSdkKeyOrOptions, sdkOptions, clientOptions) =
 		logger,
 		baseUrl,
 		urlFactory: defaultUrlFactory,
-		valueIdGenerator: generateValueId
-	}), clientSdkKeyOrOptions, sdkOptions, clientOptions, { platformCachingProvider: localStorageCachingProvider });
+		valueIdGenerator: generateValueId,
+		clientSession
+	}), clientSdkKeyOrOptions, sdkOptions, clientOptions, {
+		sha256HexDigest: sha256HexDigestIfAvailable(),
+		platformCachingProvider: localStorageCachingProvider
+	});
 };
 //#endregion
 //#region ../js-client-core/src/installedTestClient.ts
@@ -2337,7 +2381,7 @@ const buildClient = async (configdirector, logger) => {
 	return {
 		client: createBrowserClient(configdirector?.clientSdkKey || void 0, {
 			sdkName: "nuxt-sdk",
-			sdkVersion: "1.12.0"
+			sdkVersion: "1.13.0"
 		}, {
 			metadata: {
 				appName: configdirector?.appName,

package/dist/runtime/plugin.server.mjs

@@ -176,6 +176,9 @@ var SsrClient = class {
 	getValue(configKey, defaultValue) {
 		return this.serverClient.getValue(configKey, defaultValue, this.suppliedContext);
 	}
+	evaluate(configKey, defaultValue) {
+		return this.serverClient.evaluate(configKey, defaultValue, this.suppliedContext);
+	}
 	watch() {
 		return () => {};
 	}

package/dist/runtime/server/composables/useConfigDirectorServerClient.d.mts

@@ -1,4 +1,4 @@
-import { n as ConfigDirectorClient } from "../../types-BoDJiQsr.mjs";
+import { n as ConfigDirectorClient } from "../../types-qDEc6g8R.mjs";
 
 //#region src/runtime/server/composables/useConfigDirectorServerClient.d.ts
 declare const useConfigDirectorServerClient: () => ConfigDirectorClient;

package/dist/runtime/server/composables/useConfigDirectorServerClient.d.ts

@@ -1,4 +1,4 @@
-import { n as ConfigDirectorClient } from "../../types-BoDJiQsr.mjs";
+import { n as ConfigDirectorClient } from "../../types-qDEc6g8R.mjs";
 
 //#region src/runtime/server/composables/useConfigDirectorServerClient.d.ts
 declare const useConfigDirectorServerClient: () => ConfigDirectorClient;

package/dist/runtime/server/composables/useConfigDirectorServerHooks.d.mts

@@ -1,4 +1,4 @@
-import { t as ClientHooks } from "../../types-BoDJiQsr.mjs";
+import { t as ClientHooks } from "../../types-qDEc6g8R.mjs";
 
 //#region src/runtime/server/composables/useConfigDirectorServerHooks.d.ts
 declare const useConfigDirectorServerHooks: (hooks: ClientHooks) => void;

package/dist/runtime/server/composables/useConfigDirectorServerHooks.d.ts

@@ -1,4 +1,4 @@
-import { t as ClientHooks } from "../../types-BoDJiQsr.mjs";
+import { t as ClientHooks } from "../../types-qDEc6g8R.mjs";
 
 //#region src/runtime/server/composables/useConfigDirectorServerHooks.d.ts
 declare const useConfigDirectorServerHooks: (hooks: ClientHooks) => void;

package/dist/runtime/{types-CuzrFq9I.d.mts → types-BvqduMQP.d.mts}

@@ -1,4 +1,4 @@
-import { a as ConfigValueType, n as ConfigDirectorContext, r as ConfigEvaluation } from "./native-values-ChQdi7c7.mjs";
+import { a as ConfigValueType, n as ConfigDirectorContext, r as ConfigEvaluation } from "./native-values-CfhP0yLS.mjs";
 
 //#region ../js-client-core/src/Emitter.d.ts
 type EventType = string | symbol;
@@ -113,6 +113,16 @@ interface ConfigDirectorClient extends EventProvider<ClientEvents> {
    * is called before initialization is done.
    */
   getValue<T extends ConfigValueType>(configKey: string, defaultValue: T): T;
+  /**
+   * Evaluates a config as {@link getValue} does and returns the evaluation: the value, the reason it
+   * was served and its value ID. Like every read, it fires `configEvaluated` and is counted in
+   * telemetry.
+   *
+   * @returns The evaluation, whose `value` is what {@link getValue} returns
+   * @param configKey The config key to evaluate
+   * @param defaultValue The in-code default value, returned when no value from ConfigDirector can be served
+   */
+  evaluate<T extends ConfigValueType>(configKey: string, defaultValue: T): ConfigEvaluation<T>;
   /**
    * Watches for changes to a a config evaluation value. Whenever the config value changes, the
    * provided callback function will be called with the new value. Changes can happen due to updates

package/dist/runtime/{types-BoDJiQsr.d.mts → types-qDEc6g8R.d.mts}

@@ -1,4 +1,4 @@
-import { a as ConfigValueType, i as ConfigState, n as ConfigDirectorContext, r as ConfigEvaluation } from "./native-values-ChQdi7c7.mjs";
+import { a as ConfigValueType, i as ConfigState, n as ConfigDirectorContext, r as ConfigEvaluation } from "./native-values-CfhP0yLS.mjs";
 
 //#region ../js-server-sdk/src/types.d.ts
 type ClientEvents = {
@@ -59,6 +59,17 @@ interface ConfigDirectorClient {
    * @param context The user's context to be used for targeting rules evaluation (optional)
    */
   getValue<T extends ConfigValueType>(configKey: string, defaultValue: T, context?: ConfigDirectorContext): T;
+  /**
+   * Evaluates a config as {@link getValue} does and returns the evaluation: the value, the reason it
+   * was served and its value ID. Like every read, it fires `configEvaluated` and is counted in
+   * telemetry.
+   *
+   * @returns The evaluation, whose `value` is what {@link getValue} returns
+   * @param configKey The config key to evaluate
+   * @param defaultValue The in-code default value, returned when no value from ConfigDirector can be served
+   * @param context The user's context to be used for targeting rules evaluation (optional)
+   */
+  evaluate<T extends ConfigValueType>(configKey: string, defaultValue: T, context?: ConfigDirectorContext): ConfigEvaluation<T>;
   /**
    * Watches for changes to a a config evaluation value. Whenever the config value changes, the
    * provided callback function will be called with the new value. Changes can happen due to updates

package/dist/testing.d.mts

@@ -19,13 +19,24 @@ interface ConfigDirectorLogger {
   warn(message: string, ...args: any): void;
   error(message: string, ...args: any): void;
 }
+/**
+ * Why an evaluation returned the value it did. `found-match` returns a value from ConfigDirector,
+ * and `cached` a value kept on the device while a client SDK waits for live values. `value-missing`
+ * returns the in-code default value because the config has no value. Every other reason returns the
+ * in-code default value because of an error: the config does not exist (`config-state-missing`), no
+ * values have arrived yet (`client-not-ready`), or the value cannot be read as the type of the in-code
+ * default value.
+ */
 type EvaluationReason = "found-match" | "config-state-missing" | "client-not-ready" | "type-mismatch" | "value-missing" | "invalid-number" | "invalid-json" | "invalid-boolean" | "cached";
-type ConfigEvaluation = {
-  key: string;
-  value: ConfigValueType;
-  valueId?: string;
-  isDefaultValue: boolean;
-  reason: EvaluationReason;
+/**
+ * One evaluation of a config: the value it returned, why, and the context it was evaluated for.
+ */
+type ConfigEvaluation<T extends ConfigValueType = ConfigValueType> = {
+  /** The config key that was evaluated. */key: string; /** The value returned, which is the in-code default value when {@link isDefaultValue} is `true`. */
+  value: T; /** The ID ConfigDirector assigned to the value returned, when ConfigDirector sent one with it. */
+  valueId?: string; /** Whether the evaluation returned the in-code default value. */
+  isDefaultValue: boolean; /** Why the evaluation returned this value. */
+  reason: EvaluationReason; /** The context the config was evaluated for, if any. */
   context?: ConfigDirectorContext;
 };
 /**
@@ -182,6 +193,16 @@ interface ConfigDirectorClient extends EventProvider<ClientEvents> {
    * is called before initialization is done.
    */
   getValue<T extends ConfigValueType>(configKey: string, defaultValue: T): T;
+  /**
+   * Evaluates a config as {@link getValue} does and returns the evaluation: the value, the reason it
+   * was served and its value ID. Like every read, it fires `configEvaluated` and is counted in
+   * telemetry.
+   *
+   * @returns The evaluation, whose `value` is what {@link getValue} returns
+   * @param configKey The config key to evaluate
+   * @param defaultValue The in-code default value, returned when no value from ConfigDirector can be served
+   */
+  evaluate<T extends ConfigValueType>(configKey: string, defaultValue: T): ConfigEvaluation<T>;
   /**
    * Watches for changes to a a config evaluation value. Whenever the config value changes, the
    * provided callback function will be called with the new value. Changes can happen due to updates

package/dist/testing.mjs

@@ -816,9 +816,12 @@ const parseJson = (jsonString, defaultValue, requestedType, valueId) => {
 };
 const isJsonTypeCompatible = (parsed, defaultValue) => {
 	if (parsed === null) return false;
-	const defaultType = typeof defaultValue;
-	if (defaultType === "bigint") return typeof parsed === "number";
-	return typeof parsed === defaultType;
+	return jsonShapeOf(parsed) === jsonShapeOf(defaultValue);
+};
+const jsonShapeOf = (value) => {
+	if (Array.isArray(value)) return "array";
+	const nativeType = typeof value;
+	return nativeType === "bigint" ? "number" : nativeType;
 };
 //#endregion
 //#region ../shared/src/logger.ts
@@ -1258,9 +1261,10 @@ const utf8ByteLength = (text) => {
 };
 //#endregion
 //#region ../js-client-core/src/cached-values.ts
-const ENTRY_FORMAT_VERSION = 1;
+const ENTRY_FORMAT_VERSION = 2;
+const FIRST_ENTRY_FORMAT_VERSION = 1;
 const DEFAULT_CONTEXT_KIND = "user";
-const planCaching = (connectionPlan, caching, platformProvider) => {
+const planCaching = (connectionPlan, caching, sha256HexDigest, platformCachingProvider) => {
 	if (connectionPlan.kind === "stay-offline") return {
 		kind: "no cache",
 		reason: "offline mode"
@@ -1269,7 +1273,12 @@ const planCaching = (connectionPlan, caching, platformProvider) => {
 		kind: "no cache",
 		reason: "turned off"
 	};
-	const provider = caching?.provider ?? platformProvider?.(connectionPlan.clientSdkKey);
+	if (!sha256HexDigest) return {
+		kind: "no cache",
+		reason: "no SHA-256 available"
+	};
+	const clientSdkKeyDigest = sha256HexDigest(connectionPlan.clientSdkKey);
+	const provider = caching?.provider ?? platformCachingProvider?.(clientSdkKeyDigest);
 	if (!provider) return {
 		kind: "no cache",
 		reason: "no provider available"
@@ -1277,7 +1286,7 @@ const planCaching = (connectionPlan, caching, platformProvider) => {
 	return {
 		kind: "cache",
 		provider,
-		clientSdkKey: connectionPlan.clientSdkKey
+		clientSdkKeyDigest
 	};
 };
 const contextTagFor = (context, instanceId) => {
@@ -1312,19 +1321,34 @@ const isConfigStateMap = (candidate) => {
 	if (!candidate || typeof candidate !== "object" || Array.isArray(candidate)) return false;
 	return Object.values(candidate).every((config) => config && typeof config === "object" && typeof config.id === "string" && typeof config.key === "string");
 };
-const isEntryFor = (clientSdkKey, candidate) => {
+const isEntryFor = (clientSdkKeyDigest, candidate) => {
 	if (!candidate || typeof candidate !== "object") return false;
 	const entry = candidate;
-	return entry.formatVersion === ENTRY_FORMAT_VERSION && entry.clientSdkKey === clientSdkKey && isContextTag(entry.contextTag) && typeof entry.environmentId === "string" && typeof entry.projectId === "string" && isConfigStateMap(entry.configs) && typeof entry.receivedAt === "number";
+	return entry.formatVersion === ENTRY_FORMAT_VERSION && entry.clientSdkKeyDigest === clientSdkKeyDigest && isContextTag(entry.contextTag) && typeof entry.environmentId === "string" && typeof entry.projectId === "string" && isConfigStateMap(entry.configs) && typeof entry.receivedAt === "number";
+};
+const hasFirstFormatVersion = (candidate) => !!candidate && typeof candidate === "object" && candidate.formatVersion === FIRST_ENTRY_FORMAT_VERSION;
+const parseEntry = (raw, clientSdkKeyDigest) => {
+	let candidate;
+	try {
+		candidate = JSON.parse(raw);
+	} catch {
+		return { outcome: "unreadable" };
+	}
+	if (isEntryFor(clientSdkKeyDigest, candidate)) return {
+		outcome: "stored",
+		cachedValues: candidate
+	};
+	if (hasFirstFormatVersion(candidate)) return { outcome: "first format" };
+	return { outcome: "unreadable" };
 };
 var CachedValuesStore = class {
 	warned = /* @__PURE__ */ new Set();
 	pendingRead;
 	queuedCachedValues;
 	writing = false;
-	constructor(provider, clientSdkKey, logger) {
+	constructor(provider, clientSdkKeyDigest, logger) {
 		this.provider = provider;
-		this.clientSdkKey = clientSdkKey;
+		this.clientSdkKeyDigest = clientSdkKeyDigest;
 		this.logger = logger;
 	}
 	read() {
@@ -1344,23 +1368,16 @@ var CachedValuesStore = class {
 			return { outcome: "failed" };
 		}
 		if (raw == null || raw === "") return { outcome: "nothing stored" };
-		const entry = this.parseEntry(raw);
-		if (!entry) {
-			this.warnOnce("unreadable", "The values kept on the device could not be read and were removed, starting without them");
-			await this.removeEntry();
-			return { outcome: "unreadable" };
-		}
-		return {
-			outcome: "stored",
-			cachedValues: entry
-		};
-	}
-	parseEntry(raw) {
-		try {
-			const candidate = JSON.parse(raw);
-			return isEntryFor(this.clientSdkKey, candidate) ? candidate : void 0;
-		} catch {
-			return;
+		const entryParseOutcome = parseEntry(raw, await this.clientSdkKeyDigest);
+		switch (entryParseOutcome.outcome) {
+			case "stored": return entryParseOutcome;
+			case "first format":
+				await this.removeEntry();
+				return entryParseOutcome;
+			case "unreadable":
+				this.warnOnce("unreadable", "The values kept on the device could not be read and were removed, starting without them");
+				await this.removeEntry();
+				return entryParseOutcome;
 		}
 	}
 	async writeQueued() {
@@ -1379,7 +1396,7 @@ var CachedValuesStore = class {
 	async writeEntry(cachedValues) {
 		const entry = {
 			formatVersion: ENTRY_FORMAT_VERSION,
-			clientSdkKey: this.clientSdkKey,
+			clientSdkKeyDigest: await this.clientSdkKeyDigest,
 			...cachedValues
 		};
 		const serialized = JSON.stringify(entry);
@@ -1443,7 +1460,7 @@ var DefaultConfigDirectorClient = class DefaultConfigDirectorClient {
 		this.timeout = clientOptions?.connection?.timeout ?? 3e3;
 		const urlFactory = internalClientOptions?.urlFactory ?? defaultUrlFactory;
 		this.connectionPlan = planConnection(clientSdkKey, clientOptions?.connection, urlFactory);
-		this.cachedValuesStore = this.buildCachedValuesStore(planCaching(this.connectionPlan, clientOptions?.caching, internalClientOptions?.platformCachingProvider));
+		this.cachedValuesStore = this.buildCachedValuesStore(planCaching(this.connectionPlan, clientOptions?.caching, internalClientOptions?.sha256HexDigest, internalClientOptions?.platformCachingProvider));
 		this.telemetryClient = this.buildTelemetryClient(liveTelemetryClient, clientOptions);
 		this.transport = internalClientOptions?.transport ?? this.buildTransport(sdkOptions, clientOptions, urlFactory, internalClientOptions);
 		this.transport.on("configSetReceived", (configSet) => {
@@ -1486,7 +1503,7 @@ var DefaultConfigDirectorClient = class DefaultConfigDirectorClient {
 				this.logger.debug(`[ConfigDirectorClient] No values are kept on the device: ${cachingPlan.reason}`);
 				return;
 			case "cache": {
-				const store = new CachedValuesStore(cachingPlan.provider, cachingPlan.clientSdkKey, this.logger);
+				const store = new CachedValuesStore(cachingPlan.provider, cachingPlan.clientSdkKeyDigest, this.logger);
 				store.read();
 				return store;
 			}
@@ -1502,6 +1519,7 @@ var DefaultConfigDirectorClient = class DefaultConfigDirectorClient {
 		const read = await store.read();
 		switch (read.outcome) {
 			case "nothing stored":
+			case "first format":
 			case "unreadable":
 			case "failed": return;
 			case "stored": break;
@@ -1575,7 +1593,8 @@ var DefaultConfigDirectorClient = class DefaultConfigDirectorClient {
 				clientSdkKey: plan.clientSdkKey,
 				baseUrl: plan.baseUrl,
 				logger: this.logger,
-				metadata: clientOptions?.metadata
+				metadata: clientOptions?.metadata,
+				clientSession: this.clientSession
 			});
 		}
 	}
@@ -1695,7 +1714,7 @@ var DefaultConfigDirectorClient = class DefaultConfigDirectorClient {
 	updateWatchersForConfig(configKey) {
 		const configState = this.configSet?.configs[configKey];
 		this.handlersMap.get(configKey)?.forEach((h) => {
-			const value = this.getValueFromConfigState(configKey, configState, h.defaultValue);
+			const value = this.evaluationOf(configKey, configState, h.defaultValue).value;
 			h.handler(value);
 		});
 	}
@@ -1720,11 +1739,14 @@ var DefaultConfigDirectorClient = class DefaultConfigDirectorClient {
 		} else handlers.splice(0);
 	}
 	getValue(configKey, defaultValue) {
+		return this.evaluate(configKey, defaultValue).value;
+	}
+	evaluate(configKey, defaultValue) {
 		this.validateDefaultValue(defaultValue);
 		const configState = this.configSet?.configs[configKey];
-		return this.getValueFromConfigState(configKey, configState, defaultValue);
+		return this.evaluationOf(configKey, configState, defaultValue);
 	}
-	getValueFromConfigState(configKey, configState, defaultValue) {
+	evaluationOf(configKey, configState, defaultValue) {
 		if (!configState) {
 			this.logger.debug(`[ConfigDirectorClient] No config state found for '${configKey}', returning default value '${defaultValue}'`);
 			const reason = this.isReady ? "config-state-missing" : "client-not-ready";
@@ -1737,14 +1759,15 @@ var DefaultConfigDirectorClient = class DefaultConfigDirectorClient {
 				usedDefault: true,
 				evaluationReason: reason
 			});
-			this.dispatchEvaluationEvent({
+			const evaluation = {
 				key: configKey,
 				value: defaultValue,
 				isDefaultValue: true,
 				reason,
 				context: this.context
-			});
-			return defaultValue;
+			};
+			this.dispatchEvaluationEvent(evaluation);
+			return evaluation;
 		}
 		const parseResult = parseConfigValue(configState, defaultValue);
 		const reason = this.servedReason(parseResult.reason);
@@ -1759,16 +1782,17 @@ var DefaultConfigDirectorClient = class DefaultConfigDirectorClient {
 			usedDefault: parseResult.usedDefault,
 			evaluationReason: reason
 		});
-		this.dispatchEvaluationEvent({
+		const evaluation = {
 			key: configKey,
 			value: parseResult.parsedValue,
 			valueId: parseResult.parsedValueId ?? void 0,
 			isDefaultValue: parseResult.usedDefault,
 			reason,
 			context: this.context
-		});
+		};
+		this.dispatchEvaluationEvent(evaluation);
 		this.logger.debug(`[ConfigDirectorClient] Evaluated '${configKey}' to '${parseResult.parsedValue}'`);
-		return parseResult.parsedValue;
+		return evaluation;
 	}
 	dispatchEvaluationEvent(event) {
 		setTimeout(() => this.emit("configEvaluated", { evaluation: event }), 0);
@@ -2130,7 +2154,7 @@ const installTestClient = (testClient) => {
 const createTestClient = (options) => {
 	return createTestClient$1({
 		sdkName: "nuxt-sdk",
-		sdkVersion: "1.12.0"
+		sdkVersion: "1.13.0"
 	}, options);
 };
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@configdirector/nuxt-sdk",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "Nuxt SDK for ConfigDirector. ConfigDirector is a remote configuration and feature flag service.",
   "license": "MIT",
   "author": "ConfigDirector",
@@ -73,7 +73,7 @@
     "eslint": "^10.7.0",
     "jsdom": "^30.0.1",
     "nuxt": "^4.5.2",
-    "playwright": "^1.60.0",
+    "playwright": "^1.64.1",
     "rimraf": "^6.1.3",
     "tsdown": "^0.21.7",
     "tslib": "^2.8.1",