@configdirector/nuxt-sdk 0.7.0 → 0.9.0

package/dist/module.json

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

package/dist/module.mjs

@@ -37,6 +37,10 @@ var module_default = defineNuxtModule({
 			name: "useConfigDirectorClient",
 			as: "useConfigDirectorClient",
 			from: resolver.resolve("./runtime/server/composables/useConfigDirectorClient")
+		}, {
+			name: "useConfigDirectorServerHooks",
+			as: "useConfigDirectorServerHooks",
+			from: resolver.resolve("./runtime/server/composables/useConfigDirectorServerHooks")
 		}]);
 		addPlugin(resolver.resolve("./runtime/plugin.server"));
 		addPlugin(resolver.resolve("./runtime/plugin.client"));
@@ -60,6 +64,11 @@ var module_default = defineNuxtModule({
 				name: "useConfigDirectorValue",
 				as: "useConfigDirectorValue",
 				from: resolver.resolve("./runtime/app/composables/useConfigDirectorValue")
+			},
+			{
+				name: "useConfigDirectorClientHooks",
+				as: "useConfigDirectorClientHooks",
+				from: resolver.resolve("./runtime/app/composables/useConfigDirectorClientHooks")
 			}
 		]);
 	}

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

@@ -1,4 +1,4 @@
-import { t as ConfigDirectorClient } from "../../types-BkRZRTVv.mjs";
+import { n as ConfigDirectorClient } from "../../types-B4EK1B6g.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 { t as ConfigDirectorClient } from "../../types-BkRZRTVv.mjs";
+import { n as ConfigDirectorClient } from "../../types-B4EK1B6g.mjs";
 
 //#region src/runtime/app/composables/useConfigDirectorClient.d.ts
 declare const useConfigDirectorClient: () => {

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

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

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

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

package/dist/runtime/app/composables/useConfigDirectorClientHooks.mjs

@@ -0,0 +1,22 @@
+import { useNuxtApp } from "#app";
+import { getCurrentInstance, onUnmounted } from "vue";
+//#region src/runtime/app/composables/useConfigDirectorClientHooks.ts
+const useConfigDirectorClientHooks = (hooks) => {
+	const { $configDirectorClient } = useNuxtApp();
+	const client = $configDirectorClient;
+	const hookEntries = Object.entries(hooks);
+	for (const [event, handler] of hookEntries) {
+		if (!handler) continue;
+		const handlers = Array.isArray(handler) ? handler : [handler];
+		for (const h of handlers) client.on(event, h);
+	}
+	if (getCurrentInstance()) onUnmounted(() => {
+		for (const [event, handler] of hookEntries) {
+			if (!handler) continue;
+			const handlers = Array.isArray(handler) ? handler : [handler];
+			for (const h of handlers) client.off(event, h);
+		}
+	});
+};
+//#endregion
+export { useConfigDirectorClientHooks };

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

@@ -1,4 +1,4 @@
-import { t as ConfigDirectorContext } from "../../types-f2z6DgES.mjs";
+import { t as ConfigDirectorContext } from "../../types-CHmsCChN.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 { t as ConfigDirectorContext } from "../../types-f2z6DgES.mjs";
+import { t as ConfigDirectorContext } from "../../types-CHmsCChN.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 { r as ConfigValueType } from "../../types-f2z6DgES.mjs";
+import { i as ConfigValueType } from "../../types-CHmsCChN.mjs";
 import { t as ClientStatus } from "../../types-CkzBXJwA.mjs";
 import { DeepReadonly, Ref, ShallowRef } from "vue";
 

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

@@ -1,4 +1,4 @@
-import { r as ConfigValueType } from "../../types-f2z6DgES.mjs";
+import { i as ConfigValueType } from "../../types-CHmsCChN.mjs";
 import { t as ClientStatus } from "../../types-CkzBXJwA.mjs";
 import { DeepReadonly, Ref, ShallowRef } from "vue";
 

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

@@ -1,4 +1,4 @@
-import { t as ConfigDirectorClient } from "../types-BDwzL0dp.mjs";
+import { n as ConfigDirectorClient } from "../types-CzmBIfqo.mjs";
 import * as _$nitropack from "nitropack";
 
 //#region src/runtime/nitro/plugin.d.ts

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

@@ -1,4 +1,4 @@
-import { t as ConfigDirectorClient } from "../types-BDwzL0dp.mjs";
+import { n as ConfigDirectorClient } from "../types-CzmBIfqo.mjs";
 import * as _$nitropack from "nitropack";
 
 //#region src/runtime/nitro/plugin.d.ts

package/dist/runtime/nitro/plugin.mjs

@@ -2,6 +2,7 @@ import EventEmitter, { EventEmitter as EventEmitter$1 } from "node:events";
 import { findByPointer } from "@jsonjoy.com/json-pointer";
 import * as semver from "semver";
 import { rapidhash } from "rapidhash-js";
+import { createHash } from "node:crypto";
 import { defineNitroPlugin, useRuntimeConfig } from "nitropack/runtime";
 import { consola } from "consola";
 //#region ../shared/src/errors.ts
@@ -849,22 +850,25 @@ const parseConfigValue = (configState, defaultValue) => {
 	const requestedType = getRequestedType(defaultValue);
 	if (!value) return {
 		parsedValue: defaultValue,
+		parsedValueId: void 0,
 		requestedType,
 		usedDefault: true,
 		reason: "value-missing"
 	};
-	if (configState.type === "json") return parseJson(value, defaultValue, requestedType);
+	if (configState.type === "json") return parseJson(value, defaultValue, requestedType, configState.valueId);
 	if (typeof defaultValue === "string") return {
 		parsedValue: value,
+		parsedValueId: configState.valueId,
 		requestedType,
 		usedDefault: false,
 		reason: "found-match"
 	};
-	if (typeof defaultValue === "boolean" && configState.type === "boolean") {
+	if (typeof defaultValue === "boolean" && (configState.type === "boolean" || configState.type === "string")) {
 		const boolValue = parseConfigBoolean(value);
 		const hasBoolean = typeof boolValue === "boolean";
 		return {
 			parsedValue: hasBoolean ? boolValue : defaultValue,
+			parsedValueId: hasBoolean ? configState.valueId : void 0,
 			requestedType,
 			usedDefault: !hasBoolean,
 			reason: hasBoolean ? "found-match" : "invalid-boolean"
@@ -875,16 +879,18 @@ const parseConfigValue = (configState, defaultValue) => {
 		const hasNumber = typeof numValue === "number";
 		return {
 			parsedValue: hasNumber ? numValue : defaultValue,
+			parsedValueId: hasNumber ? configState.valueId : void 0,
 			requestedType,
 			usedDefault: !hasNumber,
 			reason: hasNumber ? "found-match" : "invalid-number"
 		};
 	}
-	if (isNumericNativeType(typeof defaultValue) && (configState.type === "float" || configState.type === "enum")) {
+	if (isNumericNativeType(typeof defaultValue) && (configState.type === "float" || configState.type === "enum" || configState.type === "string")) {
 		const numValue = parseConfigFloat(value);
 		const hasNumber = typeof numValue === "number";
 		return {
 			parsedValue: hasNumber ? numValue : defaultValue,
+			parsedValueId: hasNumber ? configState.valueId : void 0,
 			requestedType,
 			usedDefault: !hasNumber,
 			reason: hasNumber ? "found-match" : "invalid-number"
@@ -892,6 +898,7 @@ const parseConfigValue = (configState, defaultValue) => {
 	}
 	return {
 		parsedValue: value,
+		parsedValueId: configState.valueId,
 		requestedType,
 		usedDefault: false,
 		reason: "found-match"
@@ -915,9 +922,10 @@ const parseConfigFloat = (value) => {
 	if (isNaN(num) || !isFinite(num)) return;
 	return num;
 };
-const parseJson = (jsonString, defaultValue, requestedType) => {
+const parseJson = (jsonString, defaultValue, requestedType, valueId) => {
 	if (typeof defaultValue === "string") return {
 		parsedValue: jsonString,
+		parsedValueId: valueId,
 		requestedType,
 		usedDefault: false,
 		reason: "found-match"
@@ -925,6 +933,7 @@ const parseJson = (jsonString, defaultValue, requestedType) => {
 	try {
 		return {
 			parsedValue: JSON.parse(jsonString),
+			parsedValueId: valueId,
 			requestedType,
 			usedDefault: false,
 			reason: "found-match"
@@ -932,6 +941,7 @@ const parseJson = (jsonString, defaultValue, requestedType) => {
 	} catch {
 		return {
 			parsedValue: defaultValue,
+			parsedValueId: void 0,
 			requestedType,
 			usedDefault: true,
 			reason: "invalid-json"
@@ -1007,25 +1017,35 @@ const defaultUrlFactory = (input, base) => new URL(input, base?.toString());
 //#endregion
 //#region ../shared/src/telemetry/utils.ts
 const CONFIG_VALUE_MAX_LENGTH = 500;
-const sanitizeValue = (value, type) => {
-	if (type === "json" || type == null && typeof value === "object") try {
-		return { digest: djb2Hash(JSON.stringify(value)) };
-	} catch {
-		return { digest: value.toString() };
+const compactTelemetryValue = async (tv, valueIdGenerator) => {
+	if (tv.valueId) return { valueId: tv.valueId };
+	if (tv.value) {
+		if (tv.value.length <= CONFIG_VALUE_MAX_LENGTH && tv.type != "json") return { value: tv.value };
+		return { valueId: await valueIdGenerator(tv.value) };
 	}
-	if (value.toString().length > CONFIG_VALUE_MAX_LENGTH) return { digest: djb2Hash(value.toString()) };
-	else return { value: value.toString() };
-};
-const djb2Hash = (data) => {
-	return djb2(new TextEncoder().encode(data)).toString(16).padStart(8, "0");
+	return tv;
 };
-const djb2 = (bytes) => {
-	let hash = 5381;
-	for (let i = 0; i < bytes.length; i++) {
-		hash = (hash << 5) + hash + (bytes[i] ?? 0);
-		hash = hash >>> 0;
+const mapToTelemetryValue = (ev) => {
+	if (ev.type === "json" || ev.type == null && typeof ev.value === "object") {
+		if (ev.valueId) return {
+			valueId: ev.valueId,
+			type: "json"
+		};
+		try {
+			return {
+				value: JSON.stringify(ev.value),
+				type: "json"
+			};
+		} catch {
+			return {
+				value: ev.value.toString(),
+				type: "json"
+			};
+		}
 	}
-	return hash;
+	const stringValue = ev.value?.toString();
+	if (stringValue && stringValue.length <= CONFIG_VALUE_MAX_LENGTH) return { value: stringValue };
+	return ev.valueId ? { valueId: ev.valueId } : { value: stringValue };
 };
 const isEventListEmpty = (eventList) => {
 	const keys = Object.keys(eventList);
@@ -1189,9 +1209,6 @@ var TelemetryEventCollector = class {
 		const initialDelay = options.initialFlushIntervalDelay ?? 5e3;
 		this.flushTimeout = setTimeout(() => this.flushAndScheduleNext(), initialDelay);
 	}
-	sanitizeValue(value, type) {
-		return sanitizeValue(value, type);
-	}
 	async flushAndScheduleNext() {
 		if ((await this.flush()).fatalError) {
 			this.collectEvents = false;
@@ -1199,19 +1216,6 @@ var TelemetryEventCollector = class {
 			this.logger.warn("[TelemetryEventCollector] Received a fatal error from telemetry collection. No longer collecting events.");
 		} else this.flushTimeout = setTimeout(() => this.flushAndScheduleNext(), this.flushIntervalDelay);
 	}
-	async flush() {
-		if (!this.reporter) return {
-			success: false,
-			fatalError: false
-		};
-		const evaluationSnapshot = this.evaluationEventQueue.takeSnapshot();
-		return await this.reporter?.report({
-			context: this._context,
-			discreteEvents: {},
-			aggregatedEvents: { evaluatedConfig: this.aggregator.aggregate(evaluationSnapshot) },
-			droppedEvents: { evaluatedConfig: evaluationSnapshot.droppedCount }
-		});
-	}
 	cancelScheduledFlush() {
 		clearTimeout(this.flushTimeout);
 	}
@@ -1258,9 +1262,31 @@ var LimitedMap = class extends Map {
 	}
 };
 //#endregion
+//#region ../shared/src/telemetry/EvaluatedConfigEventPreprocessor.ts
+var EvaluatedConfigEventPreprocessor = class {
+	constructor(valueIdGenerator) {
+		this.valueIdGenerator = valueIdGenerator;
+		this.valueIdGenerator = valueIdGenerator;
+	}
+	async process(snapshot) {
+		const events = await Promise.all(snapshot.events.map(async (e) => {
+			return {
+				...e,
+				defaultValue: await compactTelemetryValue(e.defaultValue, this.valueIdGenerator),
+				evaluatedValue: await compactTelemetryValue(e.evaluatedValue, this.valueIdGenerator)
+			};
+		}));
+		return {
+			...snapshot,
+			events
+		};
+	}
+};
+//#endregion
 //#region ../js-server-sdk/src/telemetry/ServerTelemetryEventCollector.ts
 const DEFAULT_CONTEXTS_LIMIT = 1e3;
 var ServerTelemetryEventCollector = class extends TelemetryEventCollector {
+	evaluationEventSnapshotPreprocessor;
 	reporter;
 	_context;
 	contexts;
@@ -1268,6 +1294,7 @@ var ServerTelemetryEventCollector = class extends TelemetryEventCollector {
 		super(options);
 		this.reporter = new ServerEventReporter(options);
 		this.contexts = new LimitedMap(options.contextLimit ?? DEFAULT_CONTEXTS_LIMIT);
+		this.evaluationEventSnapshotPreprocessor = new EvaluatedConfigEventPreprocessor(options.valueIdGenerator);
 	}
 	evaluatedConfig(payload) {
 		if (!this.collectEvents) return;
@@ -1281,8 +1308,15 @@ var ServerTelemetryEventCollector = class extends TelemetryEventCollector {
 	sanitizeEvaluatedConfigEvent(event) {
 		return {
 			...event,
-			defaultValue: this.sanitizeValue(event.defaultValue, event.type),
-			evaluatedValue: this.sanitizeValue(event.evaluatedValue, event.type)
+			defaultValue: mapToTelemetryValue({
+				value: event.defaultValue,
+				type: event.type
+			}),
+			evaluatedValue: mapToTelemetryValue({
+				value: event.evaluatedValue,
+				valueId: event.evaluatedValueId,
+				type: event.type
+			})
 		};
 	}
 	snapshotContexts() {
@@ -1299,7 +1333,7 @@ var ServerTelemetryEventCollector = class extends TelemetryEventCollector {
 			success: false,
 			fatalError: false
 		};
-		const evaluationSnapshot = this.evaluationEventQueue.takeSnapshot();
+		const evaluationSnapshot = await this.evaluationEventSnapshotPreprocessor.process(this.evaluationEventQueue.takeSnapshot());
 		const contextsSnapshot = this.snapshotContexts();
 		return await this.reporter?.report({
 			context: this._context,
@@ -1313,6 +1347,27 @@ var ServerTelemetryEventCollector = class extends TelemetryEventCollector {
 	}
 };
 //#endregion
+//#region ../shared/src/base62-encoder.ts
+const BASE62 = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
+const toBase62 = (buf, length) => {
+	const ZERO = BigInt(0);
+	const BASE = BigInt(62);
+	const hex = Array.from(buf).map((b) => b.toString(16).padStart(2, "0")).join("");
+	let n = BigInt("0x" + hex);
+	let result = "";
+	while (n > ZERO) {
+		result = BASE62[Number(n % BASE)] + result;
+		n /= BASE;
+	}
+	return result.padStart(length, "0");
+};
+const BASE62_LENGTH = Math.ceil(128 / Math.log2(62));
+//#endregion
+//#region ../js-server-sdk/src/telemetry/value-id-generator.ts
+const generateValueId = async (v) => {
+	return toBase62(createHash("sha256").update(v?.toString() ?? "").digest().subarray(0, 16), BASE62_LENGTH);
+};
+//#endregion
 //#region ../js-server-sdk/src/DefaultConfigDirectorClient.ts
 const defaultBaseUrl = new URL("https://server-sdk-api.configdirector.com");
 const DEFAULT_FLUSH_INTERVAL = 3e4;
@@ -1347,7 +1402,8 @@ var DefaultConfigDirectorClient = class {
 			flushIntervalDelay: clientOptions?.telemetry?.flushInterval ?? DEFAULT_FLUSH_INTERVAL,
 			evaluationQueueLimit: Math.ceil(queueLimit * .7),
 			contextLimit: Math.floor(queueLimit * .3),
-			urlFactory: defaultUrlFactory
+			urlFactory: defaultUrlFactory,
+			valueIdGenerator: generateValueId
 		});
 		this.transport = new transportConstructor({
 			serverSdkKey,
@@ -1377,6 +1433,14 @@ var DefaultConfigDirectorClient = class {
 			}
 			this.logger.debug(`[ConfigDirectorClient] ConfigSet updated from server with ${configKeys.length} key(s)`, { keys: configKeys });
 		});
+		this.registerHandler("clientReady", clientOptions?.hooks?.clientReady);
+		this.registerHandler("configEvaluated", clientOptions?.hooks?.configEvaluated);
+		this.registerHandler("configsUpdated", clientOptions?.hooks?.configsUpdated);
+	}
+	registerHandler(event, handler) {
+		if (!handler) return;
+		const handlers = Array.isArray(handler) ? handler : [handler];
+		for (const h of handlers) if (typeof h === "function") this.on(event, h);
 	}
 	async initialize() {
 		try {
@@ -1460,14 +1524,24 @@ var DefaultConfigDirectorClient = class {
 					defaultValue,
 					requestedType: parseResult.requestedType,
 					evaluatedValue: parseResult.parsedValue,
+					evaluatedValueId: parseResult.parsedValueId,
 					usedDefault: parseResult.usedDefault,
 					evaluationReason: parseResult.reason
 				}
 			});
+			this.dispatchEvaluationEvent({
+				key: configKey,
+				value: parseResult.parsedValue,
+				valueId: parseResult.parsedValueId ?? void 0,
+				isDefaultValue: parseResult.usedDefault,
+				reason: parseResult.reason,
+				context
+			});
 			this.logger.debug(`[ConfigDirectorClient] Evaluated '${configKey}' to '${parseResult.parsedValue}'`);
 			return parseResult.parsedValue;
 		} 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";
 			this.usageEventCollector.evaluatedConfig({
 				context,
 				evaluation: {
@@ -1476,12 +1550,22 @@ var DefaultConfigDirectorClient = class {
 					requestedType: getRequestedType(defaultValue),
 					evaluatedValue: defaultValue,
 					usedDefault: true,
-					evaluationReason: "config-state-missing"
+					evaluationReason: reason
 				}
 			});
+			this.dispatchEvaluationEvent({
+				key: configKey,
+				value: defaultValue,
+				isDefaultValue: true,
+				reason,
+				context
+			});
 			return defaultValue;
 		}
 	}
+	dispatchEvaluationEvent(event) {
+		setTimeout(() => this.eventEmitter.emit("configEvaluated", { evaluation: event }), 0);
+	}
 	parseUrl(url) {
 		if (!url) return;
 		try {
@@ -1552,7 +1636,7 @@ var plugin_default = defineNitroPlugin((nitroApp) => {
 	const { serverSdkKey, baseUrl } = runtimeConfig.configdirector;
 	const client = new DefaultConfigDirectorClient(serverSdkKey, {
 		sdkName: "nuxt-sdk",
-		sdkVersion: "0.7.0"
+		sdkVersion: "0.9.0"
 	}, {
 		logger,
 		...baseUrl ? { connection: { url: baseUrl } } : {}

package/dist/runtime/plugin.client.mjs

@@ -502,22 +502,25 @@ const parseConfigValue = (configState, defaultValue) => {
 	const requestedType = getRequestedType(defaultValue);
 	if (!value) return {
 		parsedValue: defaultValue,
+		parsedValueId: void 0,
 		requestedType,
 		usedDefault: true,
 		reason: "value-missing"
 	};
-	if (configState.type === "json") return parseJson(value, defaultValue, requestedType);
+	if (configState.type === "json") return parseJson(value, defaultValue, requestedType, configState.valueId);
 	if (typeof defaultValue === "string") return {
 		parsedValue: value,
+		parsedValueId: configState.valueId,
 		requestedType,
 		usedDefault: false,
 		reason: "found-match"
 	};
-	if (typeof defaultValue === "boolean" && configState.type === "boolean") {
+	if (typeof defaultValue === "boolean" && (configState.type === "boolean" || configState.type === "string")) {
 		const boolValue = parseConfigBoolean(value);
 		const hasBoolean = typeof boolValue === "boolean";
 		return {
 			parsedValue: hasBoolean ? boolValue : defaultValue,
+			parsedValueId: hasBoolean ? configState.valueId : void 0,
 			requestedType,
 			usedDefault: !hasBoolean,
 			reason: hasBoolean ? "found-match" : "invalid-boolean"
@@ -528,16 +531,18 @@ const parseConfigValue = (configState, defaultValue) => {
 		const hasNumber = typeof numValue === "number";
 		return {
 			parsedValue: hasNumber ? numValue : defaultValue,
+			parsedValueId: hasNumber ? configState.valueId : void 0,
 			requestedType,
 			usedDefault: !hasNumber,
 			reason: hasNumber ? "found-match" : "invalid-number"
 		};
 	}
-	if (isNumericNativeType(typeof defaultValue) && (configState.type === "float" || configState.type === "enum")) {
+	if (isNumericNativeType(typeof defaultValue) && (configState.type === "float" || configState.type === "enum" || configState.type === "string")) {
 		const numValue = parseConfigFloat(value);
 		const hasNumber = typeof numValue === "number";
 		return {
 			parsedValue: hasNumber ? numValue : defaultValue,
+			parsedValueId: hasNumber ? configState.valueId : void 0,
 			requestedType,
 			usedDefault: !hasNumber,
 			reason: hasNumber ? "found-match" : "invalid-number"
@@ -545,6 +550,7 @@ const parseConfigValue = (configState, defaultValue) => {
 	}
 	return {
 		parsedValue: value,
+		parsedValueId: configState.valueId,
 		requestedType,
 		usedDefault: false,
 		reason: "found-match"
@@ -568,9 +574,10 @@ const parseConfigFloat = (value) => {
 	if (isNaN(num) || !isFinite(num)) return;
 	return num;
 };
-const parseJson = (jsonString, defaultValue, requestedType) => {
+const parseJson = (jsonString, defaultValue, requestedType, valueId) => {
 	if (typeof defaultValue === "string") return {
 		parsedValue: jsonString,
+		parsedValueId: valueId,
 		requestedType,
 		usedDefault: false,
 		reason: "found-match"
@@ -578,6 +585,7 @@ const parseJson = (jsonString, defaultValue, requestedType) => {
 	try {
 		return {
 			parsedValue: JSON.parse(jsonString),
+			parsedValueId: valueId,
 			requestedType,
 			usedDefault: false,
 			reason: "found-match"
@@ -585,6 +593,7 @@ const parseJson = (jsonString, defaultValue, requestedType) => {
 	} catch {
 		return {
 			parsedValue: defaultValue,
+			parsedValueId: void 0,
 			requestedType,
 			usedDefault: true,
 			reason: "invalid-json"
@@ -859,18 +868,27 @@ var DefaultConfigDirectorClient = class {
 			const configKeys = Object.keys(configSet.configs);
 			if (!this.configSet || configSet.kind == "full") {
 				this.configSet = configSet;
-				this.eventEmitter.emit("configsUpdated", { keys: configKeys });
+				this.emit("configsUpdated", { keys: configKeys });
 				this.updateWatchers(configSet.configs);
 			} else {
 				this.configSet.configs = {
 					...this.configSet.configs,
 					...configSet.configs
 				};
-				this.eventEmitter.emit("configsUpdated", { keys: configKeys });
+				this.emit("configsUpdated", { keys: configKeys });
 				this.updateWatchers(configSet.configs);
 			}
 			this.logger.debug("[ConfigDirectorClient] ConfigSet updated from server:", { keys: configKeys });
 		});
+		this.registerHandler("clientReady", clientOptions?.hooks?.clientReady);
+		this.registerHandler("configEvaluated", clientOptions?.hooks?.configEvaluated);
+		this.registerHandler("configsUpdated", clientOptions?.hooks?.configsUpdated);
+		this.registerHandler("contextUpdated", clientOptions?.hooks?.contextUpdated);
+	}
+	registerHandler(event, handler) {
+		if (!handler) return;
+		const handlers = Array.isArray(handler) ? handler : [handler];
+		for (const h of handlers) if (typeof h === "function") this.on(event, h);
 	}
 	getTransportConstructor(connectionMode) {
 		switch (connectionMode) {
@@ -897,14 +915,14 @@ var DefaultConfigDirectorClient = class {
 			}).then(() => {
 				this.ready = true;
 				this.initializing = false;
-				this.eventEmitter.emit("clientReady", { action: caller });
+				this.emit("clientReady", { action: caller });
 				this.logger.debug("[ConfigDirectorClient] Received initial payload from the server, client is ready");
 			});
 			const startTime = (/* @__PURE__ */ new Date()).getTime();
 			await this.transport.connect(context ?? {}, this.timeout);
 			this.currentContext = context;
 			this.telemetryClient.updateContext(context);
-			this.eventEmitter.emit("contextUpdated", { context });
+			this.emit("contextUpdated", { context });
 			const elapsedTime = (/* @__PURE__ */ new Date()).getTime() - startTime;
 			const remainingTimeout = this.timeout - elapsedTime;
 			clearTimeout(this.timeoutTimer);
@@ -954,6 +972,7 @@ var DefaultConfigDirectorClient = class {
 	getValueFromConfigState(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";
 			this.telemetryClient.evaluatedConfig({
 				contextId: this.currentContext?.id,
 				key: configKey,
@@ -961,7 +980,14 @@ var DefaultConfigDirectorClient = class {
 				requestedType: getRequestedType(defaultValue),
 				evaluatedValue: defaultValue,
 				usedDefault: true,
-				evaluationReason: "config-state-missing"
+				evaluationReason: reason
+			});
+			this.dispatchEvaluationEvent({
+				key: configKey,
+				value: defaultValue,
+				isDefaultValue: true,
+				reason,
+				context: this.context
 			});
 			return defaultValue;
 		}
@@ -973,12 +999,31 @@ var DefaultConfigDirectorClient = class {
 			defaultValue,
 			requestedType: parseResult.requestedType,
 			evaluatedValue: parseResult.parsedValue,
+			evaluatedValueId: parseResult.parsedValueId,
 			usedDefault: parseResult.usedDefault,
 			evaluationReason: parseResult.reason
 		});
+		this.dispatchEvaluationEvent({
+			key: configKey,
+			value: parseResult.parsedValue,
+			valueId: parseResult.parsedValueId ?? void 0,
+			isDefaultValue: parseResult.usedDefault,
+			reason: parseResult.reason,
+			context: this.context
+		});
 		this.logger.debug(`[ConfigDirectorClient] Evaluated '${configKey}' to '${parseResult.parsedValue}'`);
 		return parseResult.parsedValue;
 	}
+	dispatchEvaluationEvent(event) {
+		setTimeout(() => this.emit("configEvaluated", { evaluation: event }), 0);
+	}
+	emit(name, payload) {
+		try {
+			this.eventEmitter.emit(name, payload);
+		} catch (error) {
+			this.logger.error(`[ConfigDirectorClient] Error executing event handlers for '${name}'`, error);
+		}
+	}
 	parseUrl(url, urlFactory) {
 		if (!url) return;
 		try {
@@ -1037,25 +1082,27 @@ var DefaultConfigDirectorClient = class {
 //#endregion
 //#region ../shared/src/telemetry/utils.ts
 const CONFIG_VALUE_MAX_LENGTH = 500;
-const sanitizeValue = (value, type) => {
-	if (type === "json" || type == null && typeof value === "object") try {
-		return { digest: djb2Hash(JSON.stringify(value)) };
-	} catch {
-		return { digest: value.toString() };
-	}
-	if (value.toString().length > CONFIG_VALUE_MAX_LENGTH) return { digest: djb2Hash(value.toString()) };
-	else return { value: value.toString() };
-};
-const djb2Hash = (data) => {
-	return djb2(new TextEncoder().encode(data)).toString(16).padStart(8, "0");
-};
-const djb2 = (bytes) => {
-	let hash = 5381;
-	for (let i = 0; i < bytes.length; i++) {
-		hash = (hash << 5) + hash + (bytes[i] ?? 0);
-		hash = hash >>> 0;
+const mapToTelemetryValue = (ev) => {
+	if (ev.type === "json" || ev.type == null && typeof ev.value === "object") {
+		if (ev.valueId) return {
+			valueId: ev.valueId,
+			type: "json"
+		};
+		try {
+			return {
+				value: JSON.stringify(ev.value),
+				type: "json"
+			};
+		} catch {
+			return {
+				value: ev.value.toString(),
+				type: "json"
+			};
+		}
 	}
-	return hash;
+	const stringValue = ev.value?.toString();
+	if (stringValue && stringValue.length <= CONFIG_VALUE_MAX_LENGTH) return { value: stringValue };
+	return ev.valueId ? { valueId: ev.valueId } : { value: stringValue };
 };
 //#endregion
 //#region ../js-browser-client/src/telemetry/WebWorkerTelemetryClient.ts
@@ -1077,7 +1124,7 @@ var WebWorkerTelemetryClient = class {
 				flushIntervalDelay: options.flushIntervalDelay ?? 3e4
 			}
 		};
-		this.worker = new Worker(URL.createObjectURL(new Blob(["(function(){let e=(e,n)=>{if(n===`json`||n==null&&typeof e==`object`)try{return{digest:t(JSON.stringify(e))}}catch{return{digest:e.toString()}}return e.toString().length>500?{digest:t(e.toString())}:{value:e.toString()}},t=e=>n(new TextEncoder().encode(e)).toString(16).padStart(8,`0`),n=e=>{let t=5381;for(let n=0;n<e.length;n++)t=(t<<5)+t+(e[n]??0),t>>>=0;return t},r=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},i=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},a=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}},o=e=>e?.name===`NotAllowedError`?!0:e instanceof TypeError;var s=class{constructor(e){this.executeRequests=!0,this.sdkKey=e.sdkKey,this.logger=e.logger,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,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 r(e.discreteEvents)&&r(e.aggregatedEvents)&&i(e.droppedEvents)}async sendReport(e){try{let t=await a(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=o(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}},c=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}))}},l=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}},u=class{constructor(e){this.aggregator=new c,this.collectEvents=!0,this.logger=e.logger,this.evaluationEventQueue=new l(e.evaluationQueueLimit??1e3),this.flushIntervalDelay=e.flushIntervalDelay??3e4;let t=e.initialFlushIntervalDelay??5e3;this.flushTimeout=setTimeout(()=>this.flushAndScheduleNext(),t)}sanitizeValue(t,n){return e(t,n)}async flushAndScheduleNext(){(await this.flush()).fatalError?(this.collectEvents=!1,this.close(),this.logger.warn(`[TelemetryEventCollector] Received a fatal error from telemetry collection. No longer collecting events.`)):this.flushTimeout=setTimeout(()=>this.flushAndScheduleNext(),this.flushIntervalDelay)}async flush(){if(!this.reporter)return{success:!1,fatalError:!1};let e=this.evaluationEventQueue.takeSnapshot();return await this.reporter?.report({context:this._context,discreteEvents:{},aggregatedEvents:{evaluatedConfig:this.aggregator.aggregate(e)},droppedEvents:{evaluatedConfig:e.droppedCount}})}cancelScheduledFlush(){clearTimeout(this.flushTimeout)}async close(){this.collectEvents=!1,clearTimeout(this.flushTimeout),await this.flush(),this.evaluationEventQueue.clear()}dispose(){this.close()}},d=class extends u{constructor(e){super(e),this.reporter=new s(e)}async updateContext(e){this.cancelScheduledFlush(),await this.flush(),this._context=e,await this.flushAndScheduleNext()}evaluatedConfig(e){this.collectEvents&&this.evaluationEventQueue.push(e)}async forceFlush(){this.cancelScheduledFlush(),await this.flushAndScheduleNext()}};let f=(e,t)=>new URL(e,t?.toString()),p,m=(e,t,...n)=>({type:`Log`,payload:{level:e,message:t,args:n}}),h=e=>{try{self.postMessage(e)}catch{self.postMessage(m(e.payload.level,e.payload.message))}},g={debug:function(e,...t){h(m(`debug`,e,t))},info:function(e,...t){h(m(`info`,e,t))},warn:function(e,...t){h(m(`warn`,e,t))},error:function(e,...t){h(m(`error`,e,t))}};addEventListener(`message`,e=>{let t=e.data;if(t.type!=`Initialize`&&!p){g.info(`[TelemetryWorker] Ignoring ${t.type} because no collector is configured`);return}switch(g.debug(`[TelemetryWorker] Received '${t.type}' event:`,t),t.type){case`Initialize`:p=new d({...t.payload,baseUrl:f(t.payload.baseUrl),urlFactory:f,logger:g});break;case`EvaluatedConfigEvent`:p?.evaluatedConfig(t.payload);break;case`UpdateContext`:p?.updateContext(t.payload.context);break;case`Flush`:p?.forceFlush();break;case`Close`:(p?.close()??Promise.resolve()).then(()=>{self.postMessage({type:`Closed`}),self.close()});break}})})();"], { type: "application/javascript" })));
+		this.worker = 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.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,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}},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.logger=e.logger,this.evaluationEventQueue=new s(e.evaluationQueueLimit??1e3),this.flushIntervalDelay=e.flushIntervalDelay??3e4;let t=e.initialFlushIntervalDelay??5e3;this.flushTimeout=setTimeout(()=>this.flushAndScheduleNext(),t)}async flushAndScheduleNext(){(await this.flush()).fatalError?(this.collectEvents=!1,this.close(),this.logger.warn(`[TelemetryEventCollector] Received a fatal error from telemetry collection. No longer collecting events.`)):this.flushTimeout=setTimeout(()=>this.flushAndScheduleNext(),this.flushIntervalDelay)}cancelScheduledFlush(){clearTimeout(this.flushTimeout)}async close(){this.collectEvents=!1,clearTimeout(this.flushTimeout),await this.flush(),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 extends c{constructor(e){super(e),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)}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)},droppedEvents:{evaluatedConfig:e.droppedCount}})}};let d=(e,t)=>new URL(e,t?.toString()),f=(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`)},p=Math.ceil(128/Math.log2(62)),m=new TextEncoder,h=async e=>{let t=await crypto.subtle.digest(`SHA-256`,m.encode(e?.toString()??``));return f(new Uint8Array(t,0,16),p)},g,_=(e,t,...n)=>({type:`Log`,payload:{level:e,message:t,args:n}}),v=e=>{try{self.postMessage(e)}catch{self.postMessage(_(e.payload.level,e.payload.message))}},y={debug:function(e,...t){v(_(`debug`,e,t))},info:function(e,...t){v(_(`info`,e,t))},warn:function(e,...t){v(_(`warn`,e,t))},error:function(e,...t){v(_(`error`,e,t))}};addEventListener(`message`,e=>{let t=e.data;if(t.type!=`Initialize`&&!g){y.info(`[TelemetryWorker] Ignoring ${t.type} because no collector is configured`);return}switch(y.debug(`[TelemetryWorker] Received '${t.type}' event:`,t),t.type){case`Initialize`:g=new u({...t.payload,baseUrl:d(t.payload.baseUrl),urlFactory:d,valueIdGenerator:h,logger:y});break;case`EvaluatedConfigEvent`:g?.evaluatedConfig(t.payload);break;case`UpdateContext`:g?.updateContext(t.payload.context);break;case`Flush`:g?.forceFlush();break;case`Close`:(g?.close()??Promise.resolve()).then(()=>{self.postMessage({type:`Closed`}),self.close()});break}})})();"], { type: "application/javascript" })));
 		this.worker.onmessage = (message) => {
 			this.handleWorkerEvent(message.data);
 		};
@@ -1108,8 +1155,15 @@ var WebWorkerTelemetryClient = class {
 	sanitizeEvaluatedConfigEvent(event) {
 		return {
 			...event,
-			defaultValue: sanitizeValue(event.defaultValue, event.type),
-			evaluatedValue: sanitizeValue(event.evaluatedValue, event.type)
+			defaultValue: mapToTelemetryValue({
+				value: event.defaultValue,
+				type: event.type
+			}),
+			evaluatedValue: mapToTelemetryValue({
+				value: event.evaluatedValue,
+				valueId: event.evaluatedValueId,
+				type: event.type
+			})
 		};
 	}
 	handleWorkerEvent(event) {
@@ -1151,6 +1205,29 @@ var WebWorkerTelemetryClient = class {
 	}
 };
 //#endregion
+//#region ../shared/src/base62-encoder.ts
+const BASE62 = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
+const toBase62 = (buf, length) => {
+	const ZERO = BigInt(0);
+	const BASE = BigInt(62);
+	const hex = Array.from(buf).map((b) => b.toString(16).padStart(2, "0")).join("");
+	let n = BigInt("0x" + hex);
+	let result = "";
+	while (n > ZERO) {
+		result = BASE62[Number(n % BASE)] + result;
+		n /= BASE;
+	}
+	return result.padStart(length, "0");
+};
+const BASE62_LENGTH = Math.ceil(128 / Math.log2(62));
+//#endregion
+//#region ../js-browser-client/src/telemetry/value-id-generator.ts
+const encoder = new TextEncoder();
+const generateValueId = async (v) => {
+	const hashBuffer = await crypto.subtle.digest("SHA-256", encoder.encode(v?.toString() ?? ""));
+	return toBase62(new Uint8Array(hashBuffer, 0, 16), BASE62_LENGTH);
+};
+//#endregion
 //#region ../js-browser-client/src/BrowserConfigDirectorClient.ts
 const createBrowserClient = (clientSdkKey, sdkOptions, clientOptions) => {
 	const logger = clientOptions?.logger ?? createDefaultLogger$1();
@@ -1158,7 +1235,8 @@ const createBrowserClient = (clientSdkKey, sdkOptions, clientOptions) => {
 		sdkKey: clientSdkKey,
 		logger,
 		baseUrl: parseUrl(clientOptions?.connection?.url) ?? "https://client-sdk-api.configdirector.com",
-		urlFactory: defaultUrlFactory
+		urlFactory: defaultUrlFactory,
+		valueIdGenerator: generateValueId
 	}), clientSdkKey, sdkOptions, {
 		...clientOptions,
 		logger
@@ -1217,7 +1295,7 @@ var plugin_client_default = defineNuxtPlugin((nuxtApp) => {
 	const { clientSdkKey, appName, appVersion, baseUrl } = runtimeConfig.public.configdirector;
 	const client = createBrowserClient(clientSdkKey, {
 		sdkName: "nuxt-sdk",
-		sdkVersion: "0.7.0"
+		sdkVersion: "0.9.0"
 	}, {
 		metadata: {
 			appName,

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

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

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

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

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

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

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

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

package/dist/runtime/server/composables/useConfigDirectorServerHooks.mjs

@@ -0,0 +1,14 @@
+import { useNitroApp } from "nitropack/runtime";
+//#region src/runtime/server/composables/useConfigDirectorServerHooks.ts
+const useConfigDirectorServerHooks = (hooks) => {
+	const client = useNitroApp().configDirectorClient;
+	if (!client) throw new Error("The ConfigDirector Nitro plugin was not initialized");
+	const entries = Object.entries(hooks);
+	for (const [event, handler] of entries) {
+		if (!handler) continue;
+		const handlers = Array.isArray(handler) ? handler : [handler];
+		for (const h of handlers) client.on(event, h);
+	}
+};
+//#endregion
+export { useConfigDirectorServerHooks };

package/dist/runtime/{types-BkRZRTVv.d.mts → types-B4EK1B6g.d.mts}

@@ -1,4 +1,4 @@
-import { r as ConfigValueType, t as ConfigDirectorContext } from "./types-f2z6DgES.mjs";
+import { i as ConfigValueType, n as ConfigEvaluation, t as ConfigDirectorContext } from "./types-CHmsCChN.mjs";
 
 //#region ../js-client-core/src/Emitter.d.ts
 type EventType = string | symbol;
@@ -11,7 +11,14 @@ interface EventProvider<TEventsRecord extends EventsRecord> {
 }
 //#endregion
 //#region ../js-client-core/src/types.d.ts
+type ClientHooks = {
+  clientReady?: HookHandler<"clientReady"> | HookHandler<"clientReady">[];
+  configsUpdated?: HookHandler<"configsUpdated"> | HookHandler<"configsUpdated">[];
+  contextUpdated?: HookHandler<"contextUpdated"> | HookHandler<"contextUpdated">[];
+  configEvaluated?: HookHandler<"configEvaluated"> | HookHandler<"configEvaluated">[];
+};
 type ClientConnectAction = "initialization" | "context update" | "network resume";
+type HookHandler<TEvent extends keyof ClientEvents> = (payload: ClientEvents[TEvent]) => void;
 type ClientEvents = {
   configsUpdated: {
     keys: string[];
@@ -22,6 +29,9 @@ type ClientEvents = {
   contextUpdated: {
     context: ConfigDirectorContext | undefined;
   };
+  configEvaluated: {
+    evaluation: ConfigEvaluation;
+  };
 };
 type WatchHandler<T extends ConfigValueType> = (message: T) => void;
 /**
@@ -132,4 +142,4 @@ interface ConfigDirectorClient extends EventProvider<ClientEvents> {
   dispose(): void;
 }
 //#endregion
-export { ConfigDirectorClient as t };
+export { ConfigDirectorClient as n, ClientHooks as t };

package/dist/runtime/{types-f2z6DgES.d.mts → types-CHmsCChN.d.mts}

@@ -10,6 +10,16 @@ type ConfigState = {
   key: string;
   type: ConfigType;
   value: string | undefined | null;
+  valueId?: string | undefined | null;
+};
+type EvaluationReason = "found-match" | "config-state-missing" | "client-not-ready" | "type-mismatch" | "value-missing" | "invalid-number" | "invalid-json" | "invalid-boolean";
+type ConfigEvaluation = {
+  key: string;
+  value: ConfigValueType;
+  valueId?: string;
+  isDefaultValue: boolean;
+  reason: EvaluationReason;
+  context?: ConfigDirectorContext;
 };
 /**
  * The user's context to be sent to ConfigDirector. This context will be used for targeting
@@ -47,4 +57,4 @@ type ConfigDirectorContext = {
   anonymous?: boolean;
 };
 //#endregion
-export { ConfigState as n, ConfigValueType as r, ConfigDirectorContext as t };
+export { ConfigValueType as i, ConfigEvaluation as n, ConfigState as r, ConfigDirectorContext as t };

package/dist/runtime/{types-BDwzL0dp.d.mts → types-CzmBIfqo.d.mts}

@@ -1,4 +1,4 @@
-import { n as ConfigState, r as ConfigValueType, t as ConfigDirectorContext } from "./types-f2z6DgES.mjs";
+import { i as ConfigValueType, n as ConfigEvaluation, r as ConfigState, t as ConfigDirectorContext } from "./types-CHmsCChN.mjs";
 
 //#region ../js-server-sdk/src/types.d.ts
 type ClientEvents = {
@@ -6,7 +6,16 @@ type ClientEvents = {
     keys: string[];
   };
   clientReady: undefined;
+  configEvaluated: {
+    evaluation: ConfigEvaluation;
+  };
+};
+type ClientHooks = {
+  clientReady?: HookHandler<"clientReady"> | HookHandler<"clientReady">[];
+  configsUpdated?: HookHandler<"configsUpdated"> | HookHandler<"configsUpdated">[];
+  configEvaluated?: HookHandler<"configEvaluated"> | HookHandler<"configEvaluated">[];
 };
+type HookHandler<TEvent extends keyof ClientEvents> = (payload: ClientEvents[TEvent]) => void;
 type WatchHandler<T extends ConfigValueType> = (message: T) => void;
 /**
  * The ConfigDirector SDK client object.
@@ -93,4 +102,4 @@ interface ConfigDirectorClient {
   dispose(): void;
 }
 //#endregion
-export { ConfigDirectorClient as t };
+export { ConfigDirectorClient as n, ClientHooks as t };

package/package.json

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