@configdirector/nuxt-sdk 1.12.1 → 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.1"
+  "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.1"
+		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;
@@ -1705,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);
 		});
 	}
@@ -1730,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";
@@ -1747,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);
@@ -1769,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);
@@ -2143,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),
@@ -2161,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
@@ -2184,7 +2211,10 @@ const createBrowserClient = (clientSdkKeyOrOptions, sdkOptions, clientOptions) =
 		urlFactory: defaultUrlFactory,
 		valueIdGenerator: generateValueId,
 		clientSession
-	}), clientSdkKeyOrOptions, sdkOptions, clientOptions, { platformCachingProvider: localStorageCachingProvider });
+	}), clientSdkKeyOrOptions, sdkOptions, clientOptions, {
+		sha256HexDigest: sha256HexDigestIfAvailable(),
+		platformCachingProvider: localStorageCachingProvider
+	});
 };
 //#endregion
 //#region ../js-client-core/src/installedTestClient.ts
@@ -2351,7 +2381,7 @@ const buildClient = async (configdirector, logger) => {
 	return {
 		client: createBrowserClient(configdirector?.clientSdkKey || void 0, {
 			sdkName: "nuxt-sdk",
-			sdkVersion: "1.12.1"
+			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;
@@ -1696,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);
 		});
 	}
@@ -1721,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";
@@ -1738,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);
@@ -1760,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);
@@ -2131,7 +2154,7 @@ const installTestClient = (testClient) => {
 const createTestClient = (options) => {
 	return createTestClient$1({
 		sdkName: "nuxt-sdk",
-		sdkVersion: "1.12.1"
+		sdkVersion: "1.13.0"
 	}, options);
 };
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@configdirector/nuxt-sdk",
-  "version": "1.12.1",
+  "version": "1.13.0",
   "description": "Nuxt SDK for ConfigDirector. ConfigDirector is a remote configuration and feature flag service.",
   "license": "MIT",
   "author": "ConfigDirector",