@configdirector/nuxt-sdk 1.0.0 → 1.3.0

package/dist/module.d.mts

@@ -1,6 +1,9 @@
 import * as _$_nuxt_schema0 from "@nuxt/schema";
 import { LogLevel } from "consola";
 
+//#region ../shared/src/types.d.ts
+type ConnectionMode = "streaming" | "polling";
+//#endregion
 //#region src/module.d.ts
 interface ConfigDirectorRuntimeConfig {
   /**
@@ -23,6 +26,40 @@ interface ConfigDirectorRuntimeConfig {
    * Can be set via the NUXT_CONFIGDIRECTOR_BASE_URL environment variable.
    */
   baseUrl?: string;
+  /**
+   * Connection options for the server SDK client used during SSR and in Nitro handlers.
+   */
+  connection?: {
+    /**
+     * The connection mode, one of `streaming` (default) or `polling`. In `streaming` mode the
+     * connection stays open and receives config updates as they happen. In `polling` mode configs
+     * are fetched once during initialization and then again on every `pollingInterval`.
+     * Can be set via the NUXT_CONFIGDIRECTOR_CONNECTION_MODE environment variable.
+     */
+    mode?: ConnectionMode;
+    /**
+     * The polling interval in seconds when `mode` is `polling`. Has no effect in `streaming` mode.
+     * When omitted (or `0`), the server SDK default is used.
+     * Can be set via the NUXT_CONFIGDIRECTOR_CONNECTION_POLLING_INTERVAL environment variable.
+     */
+    pollingInterval?: number;
+    /**
+     * How long, in milliseconds, the server SDK client waits for its initial config payload. Requests
+     * that arrive before the payload is received are held until it arrives or this timeout elapses,
+     * after which they render with default values. When omitted (or `0`), the server SDK default is used.
+     * Can be set via the NUXT_CONFIGDIRECTOR_CONNECTION_TIMEOUT environment variable.
+     */
+    timeout?: number;
+  };
+  /**
+   * Whether requests that arrive before the server SDK client received its initial config payload
+   * (for example right after the server starts) wait for it, for up to the connection `timeout`, before
+   * being handled. When disabled, such requests are handled immediately and evaluate configs to their
+   * default values until the payload arrives.
+   *
+   * Defaults to `true`. Can be set via the NUXT_CONFIGDIRECTOR_WAIT_FOR_INITIALIZATION environment variable.
+   */
+  waitForInitialization?: boolean;
 }
 interface ConfigDirectorPublicRuntimeConfig {
   /**

package/dist/module.json

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

package/dist/module.mjs

@@ -11,14 +11,20 @@ var module_default = defineNuxtModule({
 	setup(options, nuxt) {
 		const logger = useLogger("configdirector");
 		const resolver = createResolver(import.meta.url);
-		nuxt.options.runtimeConfig.configdirector = defu(nuxt.options.runtimeConfig.configdirector, options.logLevel !== void 0 ? {
-			serverSdkKey: "",
-			logLevel: options.logLevel,
-			baseUrl: ""
-		} : {
+		const serverDefaults = {
 			serverSdkKey: "",
-			baseUrl: ""
-		});
+			baseUrl: "",
+			connection: {
+				mode: "streaming",
+				pollingInterval: 0,
+				timeout: 0
+			},
+			waitForInitialization: true
+		};
+		nuxt.options.runtimeConfig.configdirector = defu(nuxt.options.runtimeConfig.configdirector, options.logLevel !== void 0 ? {
+			...serverDefaults,
+			logLevel: options.logLevel
+		} : serverDefaults);
 		nuxt.options.runtimeConfig.public.configdirector = defu(nuxt.options.runtimeConfig.public.configdirector, options.logLevel !== void 0 ? {
 			clientSdkKey: "",
 			logLevel: options.logLevel,

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

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

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

@@ -2,7 +2,7 @@ import * as _$h3 from "h3";
 import { ConfigDirectorClient } from "@configdirector/server-sdk";
 
 //#region src/runtime/nitro/middleware.d.ts
-declare const _default: _$h3.EventHandler<_$h3.EventHandlerRequest, void>;
+declare const _default: _$h3.EventHandler<_$h3.EventHandlerRequest, Promise<void>>;
 declare module "h3" {
   interface H3EventContext {
     configDirectorClient: ConfigDirectorClient;

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

@@ -2,7 +2,7 @@ import * as _$h3 from "h3";
 import { ConfigDirectorClient } from "@configdirector/server-sdk";
 
 //#region src/runtime/nitro/middleware.d.ts
-declare const _default: _$h3.EventHandler<_$h3.EventHandlerRequest, void>;
+declare const _default: _$h3.EventHandler<_$h3.EventHandlerRequest, Promise<void>>;
 declare module "h3" {
   interface H3EventContext {
     configDirectorClient: ConfigDirectorClient;

package/dist/runtime/nitro/middleware.mjs

@@ -1,8 +1,10 @@
-import { useNitroApp } from "nitropack/runtime";
+import { useNitroApp, useRuntimeConfig } from "nitropack/runtime";
 import { defineEventHandler } from "h3";
 //#region src/runtime/nitro/middleware.ts
-var middleware_default = defineEventHandler((event) => {
-	event.context.configDirectorClient = useNitroApp().configDirectorClient;
+var middleware_default = defineEventHandler(async (event) => {
+	const nitroApp = useNitroApp();
+	if (useRuntimeConfig(event).configdirector.waitForInitialization) await nitroApp.configDirectorInitialization;
+	event.context.configDirectorClient = nitroApp.configDirectorClient;
 });
 //#endregion
 export { middleware_default as default };

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

@@ -1,4 +1,4 @@
-import { n as ConfigDirectorClient } from "../types-CzmBIfqo.mjs";
+import { n as ConfigDirectorClient } from "../types-C54FjC1D.mjs";
 import * as _$nitropack from "nitropack";
 
 //#region src/runtime/nitro/plugin.d.ts
@@ -6,6 +6,7 @@ declare const _default: _$nitropack.NitroAppPlugin;
 declare module "nitropack" {
   interface NitroApp {
     configDirectorClient: ConfigDirectorClient;
+    configDirectorInitialization: Promise<void>;
   }
 }
 //#endregion

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

@@ -1,4 +1,4 @@
-import { n as ConfigDirectorClient } from "../types-CzmBIfqo.mjs";
+import { n as ConfigDirectorClient } from "../types-C54FjC1D.mjs";
 import * as _$nitropack from "nitropack";
 
 //#region src/runtime/nitro/plugin.d.ts
@@ -6,6 +6,7 @@ declare const _default: _$nitropack.NitroAppPlugin;
 declare module "nitropack" {
   interface NitroApp {
     configDirectorClient: ConfigDirectorClient;
+    configDirectorInitialization: Promise<void>;
   }
 }
 //#endregion

package/dist/runtime/nitro/plugin.mjs

@@ -1,8 +1,8 @@
 import EventEmitter, { EventEmitter as EventEmitter$1 } from "node:events";
+import { createHash, randomUUID } from "node:crypto";
 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
@@ -177,6 +177,7 @@ var EventSourceClient = class {
 	DEFAULT_CALCULATE_RECONNECT_DELAY = () => this.serverReconnectionTime;
 	url;
 	headers;
+	body;
 	requestOptions;
 	lastEventId;
 	reconnectAttempt = 0;
@@ -199,8 +200,9 @@ var EventSourceClient = class {
 			Accept: "text/event-stream",
 			...options.headers
 		};
+		const body = options.body;
+		this.body = typeof body === "function" ? body : () => body;
 		this.requestOptions = {
-			body: options.body,
 			method: options.method ?? "GET",
 			mode: options.mode,
 			credentials: options.credentials,
@@ -256,6 +258,7 @@ var EventSourceClient = class {
 		this._readyState = ReadyState.CONNECTING;
 		this._fetch(this.url, {
 			...this.requestOptions,
+			body: this.body(),
 			headers: this.buildRequestHeaders(),
 			signal: this.abortController.signal,
 			cache: "no-store"
@@ -353,18 +356,44 @@ const createEventSourceClient = (options) => {
 	return new EventSourceClient(options);
 };
 //#endregion
+//#region ../shared/src/fetchWithTimeout.ts
+const fetchWithTimeout = async (timeout, resource, options, logger) => {
+	const abortController = new AbortController();
+	const abortTimeoutId = setTimeout(() => {
+		logger.debug("[fetchWithTimeout] Reached timeout, aborting request");
+		abortController.abort();
+	}, timeout);
+	try {
+		const response = await fetch(typeof resource === "string" || resource instanceof Request ? resource : resource.toString(), {
+			...options,
+			signal: abortController.signal
+		});
+		clearTimeout(abortTimeoutId);
+		return response;
+	} catch (error) {
+		logger.warn("[fetchWithTimeout] Fetch error: ", error);
+		clearTimeout(abortTimeoutId);
+		throw error;
+	}
+};
+//#endregion
 //#region ../js-server-sdk/src/StreamingTransport.ts
 const MAX_EXPONENTIAL_DELAY = 9;
+const HEARTBEAT_INTERVAL_MS = 9e4;
 var StreamingTransport = class {
 	logger;
 	eventSource;
 	eventEmitter = new EventEmitter$1();
 	url;
+	heartbeatUrl;
+	heartbeatTimer;
+	_sessionId;
 	constructor(options) {
 		this.options = options;
 		this.options = options;
 		this.logger = options.logger;
 		this.url = new URL("server/sse/v1", options.baseUrl);
+		this.heartbeatUrl = new URL("server/heartbeat/v1", options.baseUrl);
 	}
 	async connect(timeout) {
 		if (this.eventSource) this.close();
@@ -373,10 +402,7 @@ var StreamingTransport = class {
 				url: this.url,
 				method: "POST",
 				headers: { "Content-Type": "application/json" },
-				body: JSON.stringify({
-					metaContext: this.options.metaContext,
-					serverSdkKey: this.options.serverSdkKey
-				}),
+				body: () => this.buildRequestBody(),
 				onMessage: ({ data }) => {
 					this.dispatchMessage(data);
 				},
@@ -386,7 +412,11 @@ var StreamingTransport = class {
 				},
 				shouldReconnect: (state) => {
 					const reconnect = !this.isStatusFatal(state.status);
-					if (!reconnect) reject(this.prepareFatalError(state.status, state.error));
+					if (!reconnect) {
+						const error = this.prepareFatalError(state.status, state.error);
+						this.eventEmitter.emit("connectionError", error);
+						reject(error);
+					}
 					return reconnect;
 				},
 				calculateReconnectDelay: (state) => {
@@ -402,10 +432,37 @@ var StreamingTransport = class {
 			});
 			this.eventSource.connect();
 		});
+		this.heartbeatTimer = setInterval(() => this.sendHeartbeat(), HEARTBEAT_INTERVAL_MS);
 		return Promise.race([eventSourcePromise, new Promise((resolve) => {
 			setTimeout(() => resolve(this), timeout);
 		})]);
 	}
+	get sessionId() {
+		return this._sessionId;
+	}
+	sendHeartbeat() {
+		if (!this.isConnected || !this._sessionId) return;
+		fetchWithTimeout(HEARTBEAT_INTERVAL_MS, this.heartbeatUrl, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify({
+				serverSdkKey: this.options.serverSdkKey,
+				sessionId: this._sessionId
+			})
+		}, this.logger).then((response) => {
+			if (!response.ok) this.logger.debug(`[StreamingTransport] Heartbeat failed with status: ${response.status}`);
+		}).catch((error) => {
+			this.logger.debug("[StreamingTransport] Heartbeat failed: ", error);
+		});
+	}
+	buildRequestBody() {
+		this._sessionId = randomUUID();
+		return JSON.stringify({
+			metaContext: this.options.metaContext,
+			serverSdkKey: this.options.serverSdkKey,
+			sessionId: this._sessionId
+		});
+	}
 	dispatchMessage(data) {
 		try {
 			const json = JSON.parse(data);
@@ -435,6 +492,8 @@ var StreamingTransport = class {
 		this.eventEmitter.removeAllListeners();
 	}
 	close() {
+		clearInterval(this.heartbeatTimer);
+		this.heartbeatTimer = void 0;
 		this.eventSource?.close();
 	}
 	dispose() {
@@ -459,6 +518,7 @@ var AbstractPollingTransport = class {
 	async handleNonOkResponse(response) {
 		if (!response.ok) if (this.isStatusFatal(response.status)) {
 			this.fatalError = true;
+			this.close();
 			throw this.prepareFatalResponseStatusError(response.status, await response.text());
 		} else throw new ConfigDirectorConnectionError(`Connection failed with status: ${response.status}`, response.status);
 	}
@@ -478,9 +538,7 @@ var AbstractPollingTransport = class {
 		return !!status && status >= 400 && status < 500;
 	}
 	isFetchErrorFatal(fetchError) {
-		if (fetchError?.name === "NotAllowedError") return true;
-		else if (fetchError instanceof TypeError) return true;
-		return false;
+		return fetchError?.name === "NotAllowedError";
 	}
 	get isConnected() {
 		return this.pollingInterval !== void 0;
@@ -495,40 +553,20 @@ var AbstractPollingTransport = class {
 	}
 };
 //#endregion
-//#region ../shared/src/fetchWithTimeout.ts
-const fetchWithTimeout = async (timeout, resource, options, logger) => {
-	const abortController = new AbortController();
-	const abortTimeoutId = setTimeout(() => {
-		logger.debug("[fetchWithTimeout] Reached timeout, aborting request");
-		abortController.abort();
-	}, timeout);
-	try {
-		const response = await fetch(typeof resource === "string" || resource instanceof Request ? resource : resource.toString(), {
-			...options,
-			signal: abortController.signal
-		});
-		clearTimeout(abortTimeoutId);
-		return response;
-	} catch (error) {
-		logger.warn("[fetchWithTimeout] Fetch error: ", error);
-		clearTimeout(abortTimeoutId);
-		throw error;
-	}
-};
-//#endregion
 //#region ../js-server-sdk/src/PollingTransport.ts
 var PollingTransport = class extends AbstractPollingTransport {
 	logger;
 	eventEmitter = new EventEmitter$1();
 	url;
 	lastUpdateTimestamp;
+	_sessionId = randomUUID();
 	constructor(options) {
 		super();
 		this.options = options;
 		this.options = options;
 		this.logger = options.logger;
 		this.url = new URL("server/polling/v1", options.baseUrl);
-		this.pollingIntervalSeconds = options.pollingInterval ?? 60;
+		this.pollingIntervalSeconds = options.pollingInterval ?? 300;
 	}
 	async connect(timeout) {
 		this.clearPollingInterval();
@@ -543,6 +581,9 @@ var PollingTransport = class extends AbstractPollingTransport {
 		}
 		return this;
 	}
+	get sessionId() {
+		return this._sessionId;
+	}
 	async fetchConfigs(timeout) {
 		if (this.fatalError) {
 			this.logger.warn("[PollingTransport] There was a prior unrecoverable error. Ignoring attempt to reconnect.");
@@ -555,7 +596,8 @@ var PollingTransport = class extends AbstractPollingTransport {
 				body: JSON.stringify({
 					metaContext: this.options.metaContext,
 					serverSdkKey: this.options.serverSdkKey,
-					lastUpdateTimestamp: this.lastUpdateTimestamp
+					lastUpdateTimestamp: this.lastUpdateTimestamp,
+					sessionId: this._sessionId
 				})
 			}, this.logger);
 			await this.handleNonOkResponse(response);
@@ -565,7 +607,12 @@ var PollingTransport = class extends AbstractPollingTransport {
 				this.eventEmitter.emit("configBundleReceived", json);
 			}
 		} catch (fetchError) {
-			this.handleFetchError(fetchError);
+			try {
+				this.handleFetchError(fetchError);
+			} catch (handledError) {
+				if (this.fatalError) this.eventEmitter.emit("connectionError", handledError);
+				throw handledError;
+			}
 		}
 	}
 	on(name, handler) {
@@ -580,14 +627,6 @@ var PollingTransport = class extends AbstractPollingTransport {
 	}
 };
 //#endregion
-//#region ../js-server-sdk/src/OneTimeTransport.ts
-var OneTimeTransport = class extends PollingTransport {
-	constructor(options) {
-		super(options);
-		this.pollingIntervalSeconds = 0;
-	}
-};
-//#endregion
 //#region ../config-evaluator/src/text-comparison.ts
 /**
 * Text comparisons.
@@ -649,11 +688,11 @@ const compareNumeric = (givenValue, operator, targetValues) => {
 const parseFinite = (value) => {
 	if (typeof value === "number") return Number.isFinite(value) ? value : void 0;
 	if (typeof value !== "string" || value.length === 0) return;
-	if (!isDecimalCharacters(value)) return;
+	if (!isDecimalCharacters$1(value)) return;
 	const parsed = Number(value);
 	return Number.isFinite(parsed) ? parsed : void 0;
 };
-const isDecimalCharacters = (value) => {
+const isDecimalCharacters$1 = (value) => {
 	for (const character of value) if (!(character >= "0" && character <= "9") && !"+-.eE".includes(character)) return false;
 	return true;
 };
@@ -7088,7 +7127,7 @@ const isNumericNativeType = (requestedType) => {
 const parseConfigValue = (configState, defaultValue) => {
 	const value = configState.value;
 	const requestedType = getRequestedType(defaultValue);
-	if (!value) return {
+	if (value == null) return {
 		parsedValue: defaultValue,
 		parsedValueId: void 0,
 		requestedType,
@@ -7103,7 +7142,7 @@ const parseConfigValue = (configState, defaultValue) => {
 		usedDefault: false,
 		reason: "found-match"
 	};
-	if (typeof defaultValue === "boolean" && (configState.type === "boolean" || configState.type === "string")) {
+	if (typeof defaultValue === "boolean" && (configState.type === "boolean" || configState.type === "string" || configState.type === "enum")) {
 		const boolValue = parseConfigBoolean(value);
 		const hasBoolean = typeof boolValue === "boolean";
 		return {
@@ -7137,11 +7176,11 @@ const parseConfigValue = (configState, defaultValue) => {
 		};
 	}
 	return {
-		parsedValue: value,
-		parsedValueId: configState.valueId,
+		parsedValue: defaultValue,
+		parsedValueId: void 0,
 		requestedType,
-		usedDefault: false,
-		reason: "found-match"
+		usedDefault: true,
+		reason: "type-mismatch"
 	};
 };
 const parseConfigBoolean = (value) => {
@@ -7151,17 +7190,22 @@ const parseConfigBoolean = (value) => {
 	return lowerValue === "true";
 };
 const parseConfigInteger = (value) => {
-	if (!value) return;
-	const num = Number.parseInt(value);
-	if (isNaN(num) || !isFinite(num)) return;
-	return num;
+	const num = parseStrictNumber(value);
+	return num == null ? void 0 : Math.trunc(num);
 };
 const parseConfigFloat = (value) => {
-	if (!value) return;
-	const num = Number.parseFloat(value);
+	return parseStrictNumber(value);
+};
+const parseStrictNumber = (value) => {
+	if (!value || !isDecimalCharacters(value)) return;
+	const num = Number(value);
 	if (isNaN(num) || !isFinite(num)) return;
 	return num;
 };
+const isDecimalCharacters = (value) => {
+	for (const character of value) if (!(character >= "0" && character <= "9") && !"+-.eE".includes(character)) return false;
+	return true;
+};
 const parseJson = (jsonString, defaultValue, requestedType, valueId) => {
 	if (typeof defaultValue === "string") return {
 		parsedValue: jsonString,
@@ -7171,8 +7215,16 @@ const parseJson = (jsonString, defaultValue, requestedType, valueId) => {
 		reason: "found-match"
 	};
 	try {
+		const parsed = JSON.parse(jsonString);
+		if (!isJsonTypeCompatible(parsed, defaultValue)) return {
+			parsedValue: defaultValue,
+			parsedValueId: void 0,
+			requestedType,
+			usedDefault: true,
+			reason: "type-mismatch"
+		};
 		return {
-			parsedValue: JSON.parse(jsonString),
+			parsedValue: parsed,
 			parsedValueId: valueId,
 			requestedType,
 			usedDefault: false,
@@ -7188,6 +7240,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;
+};
 //#endregion
 //#region ../shared/src/logger.ts
 const LEVELS = {
@@ -7456,11 +7514,25 @@ var TelemetryEventCollector = class {
 		this.flushTimeout = setTimeout(() => this.flushAndScheduleNext(), initialDelay);
 	}
 	async flushAndScheduleNext() {
-		if ((await this.flush()).fatalError) {
+		if (!this.collectEvents) return;
+		let response;
+		try {
+			response = await this.flush();
+		} catch (error) {
+			this.logger.warn("[TelemetryEventCollector] Error flushing telemetry events: ", error);
+			response = {
+				success: false,
+				fatalError: false
+			};
+		}
+		if (response.fatalError) {
 			this.collectEvents = false;
 			this.close();
 			this.logger.warn("[TelemetryEventCollector] Received a fatal error from telemetry collection. No longer collecting events.");
-		} else this.flushTimeout = setTimeout(() => this.flushAndScheduleNext(), this.flushIntervalDelay);
+		} else if (this.collectEvents) {
+			this.cancelScheduledFlush();
+			this.flushTimeout = setTimeout(() => this.flushAndScheduleNext(), this.flushIntervalDelay);
+		}
 	}
 	cancelScheduledFlush() {
 		clearTimeout(this.flushTimeout);
@@ -7468,7 +7540,11 @@ var TelemetryEventCollector = class {
 	async close() {
 		this.collectEvents = false;
 		clearTimeout(this.flushTimeout);
-		await this.flush();
+		try {
+			await this.flush();
+		} catch (error) {
+			this.logger.warn("[TelemetryEventCollector] Error flushing telemetry events during close: ", error);
+		}
 		this.evaluationEventQueue.clear();
 	}
 	dispose() {
@@ -7681,9 +7757,14 @@ var DefaultConfigDirectorClient = class {
 			}
 			this.logger.debug(`[ConfigDirectorClient] ConfigSet updated from server with ${configKeys.length} key(s)`, { keys: configKeys });
 		});
+		this.transport.on("connectionError", (error) => {
+			this.logger.error("[ConfigDirectorClient] The connection encountered an unrecoverable error and will not be retried. Configs will no longer receive updates.", error);
+			this.eventEmitter.emit("connectionError", { error });
+		});
 		this.registerHandler("clientReady", clientOptions?.hooks?.clientReady);
 		this.registerHandler("configEvaluated", clientOptions?.hooks?.configEvaluated);
 		this.registerHandler("configsUpdated", clientOptions?.hooks?.configsUpdated);
+		this.registerHandler("connectionError", clientOptions?.hooks?.connectionError);
 	}
 	registerHandler(event, handler) {
 		if (!handler) return;
@@ -7717,7 +7798,6 @@ var DefaultConfigDirectorClient = class {
 	}
 	getTransportConstructor(mode) {
 		switch (mode) {
-			case "one-time": return OneTimeTransport;
 			case "polling": return PollingTransport;
 			default: return StreamingTransport;
 		}
@@ -7864,6 +7944,9 @@ var DefaultConfigDirectorClient = class {
 	dispose() {
 		this.removeAllObservers();
 		this.closeConnection();
+		this.usageEventCollector.close().catch((error) => {
+			this.logger.warn("[ConfigDirectorClient] Error flushing telemetry while disposing the client: ", error);
+		});
 	}
 };
 //#endregion
@@ -7884,16 +7967,21 @@ var plugin_default = defineNitroPlugin((nitroApp) => {
 		throw new ConfigDirectorInitializationError(message);
 	}
 	logger.debug("Initializing ConfigDirector Nitro plugin");
-	const { serverSdkKey, baseUrl } = runtimeConfig.configdirector;
+	const { serverSdkKey, baseUrl, connection } = runtimeConfig.configdirector;
 	const client = new DefaultConfigDirectorClient(serverSdkKey, {
 		sdkName: "nuxt-sdk",
-		sdkVersion: "1.0.0"
+		sdkVersion: "1.3.0"
 	}, {
 		logger,
-		...baseUrl ? { connection: { url: baseUrl } } : {}
+		connection: {
+			url: baseUrl || void 0,
+			mode: connection?.mode || void 0,
+			pollingInterval: connection?.pollingInterval || void 0,
+			timeout: connection?.timeout || void 0
+		}
 	});
 	nitroApp.configDirectorClient = client;
-	client.initialize();
+	nitroApp.configDirectorInitialization = client.initialize();
 });
 //#endregion
 export { plugin_default as default };

package/dist/runtime/plugin.client.mjs

@@ -207,6 +207,7 @@ var EventSourceClient = class {
 	DEFAULT_CALCULATE_RECONNECT_DELAY = () => this.serverReconnectionTime;
 	url;
 	headers;
+	body;
 	requestOptions;
 	lastEventId;
 	reconnectAttempt = 0;
@@ -229,8 +230,9 @@ var EventSourceClient = class {
 			Accept: "text/event-stream",
 			...options.headers
 		};
+		const body = options.body;
+		this.body = typeof body === "function" ? body : () => body;
 		this.requestOptions = {
-			body: options.body,
 			method: options.method ?? "GET",
 			mode: options.mode,
 			credentials: options.credentials,
@@ -286,6 +288,7 @@ var EventSourceClient = class {
 		this._readyState = ReadyState.CONNECTING;
 		this._fetch(this.url, {
 			...this.requestOptions,
+			body: this.body(),
 			headers: this.buildRequestHeaders(),
 			signal: this.abortController.signal,
 			cache: "no-store"
@@ -419,7 +422,11 @@ var StreamingTransport = class {
 				},
 				shouldReconnect: (state) => {
 					const reconnect = !this.isStatusFatal(state.status);
-					if (!reconnect) reject(this.prepareFatalError(state.status, state.error));
+					if (!reconnect) {
+						const error = this.prepareFatalError(state.status, state.error);
+						this.eventEmitter.emit("connectionError", error);
+						reject(error);
+					}
 					return reconnect;
 				},
 				calculateReconnectDelay: (state) => {
@@ -500,7 +507,7 @@ const isNumericNativeType = (requestedType) => {
 const parseConfigValue = (configState, defaultValue) => {
 	const value = configState.value;
 	const requestedType = getRequestedType(defaultValue);
-	if (!value) return {
+	if (value == null) return {
 		parsedValue: defaultValue,
 		parsedValueId: void 0,
 		requestedType,
@@ -515,7 +522,7 @@ const parseConfigValue = (configState, defaultValue) => {
 		usedDefault: false,
 		reason: "found-match"
 	};
-	if (typeof defaultValue === "boolean" && (configState.type === "boolean" || configState.type === "string")) {
+	if (typeof defaultValue === "boolean" && (configState.type === "boolean" || configState.type === "string" || configState.type === "enum")) {
 		const boolValue = parseConfigBoolean(value);
 		const hasBoolean = typeof boolValue === "boolean";
 		return {
@@ -549,11 +556,11 @@ const parseConfigValue = (configState, defaultValue) => {
 		};
 	}
 	return {
-		parsedValue: value,
-		parsedValueId: configState.valueId,
+		parsedValue: defaultValue,
+		parsedValueId: void 0,
 		requestedType,
-		usedDefault: false,
-		reason: "found-match"
+		usedDefault: true,
+		reason: "type-mismatch"
 	};
 };
 const parseConfigBoolean = (value) => {
@@ -563,17 +570,22 @@ const parseConfigBoolean = (value) => {
 	return lowerValue === "true";
 };
 const parseConfigInteger = (value) => {
-	if (!value) return;
-	const num = Number.parseInt(value);
-	if (isNaN(num) || !isFinite(num)) return;
-	return num;
+	const num = parseStrictNumber(value);
+	return num == null ? void 0 : Math.trunc(num);
 };
 const parseConfigFloat = (value) => {
-	if (!value) return;
-	const num = Number.parseFloat(value);
+	return parseStrictNumber(value);
+};
+const parseStrictNumber = (value) => {
+	if (!value || !isDecimalCharacters(value)) return;
+	const num = Number(value);
 	if (isNaN(num) || !isFinite(num)) return;
 	return num;
 };
+const isDecimalCharacters = (value) => {
+	for (const character of value) if (!(character >= "0" && character <= "9") && !"+-.eE".includes(character)) return false;
+	return true;
+};
 const parseJson = (jsonString, defaultValue, requestedType, valueId) => {
 	if (typeof defaultValue === "string") return {
 		parsedValue: jsonString,
@@ -583,8 +595,16 @@ const parseJson = (jsonString, defaultValue, requestedType, valueId) => {
 		reason: "found-match"
 	};
 	try {
+		const parsed = JSON.parse(jsonString);
+		if (!isJsonTypeCompatible(parsed, defaultValue)) return {
+			parsedValue: defaultValue,
+			parsedValueId: void 0,
+			requestedType,
+			usedDefault: true,
+			reason: "type-mismatch"
+		};
 		return {
-			parsedValue: JSON.parse(jsonString),
+			parsedValue: parsed,
 			parsedValueId: valueId,
 			requestedType,
 			usedDefault: false,
@@ -600,6 +620,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;
+};
 //#endregion
 //#region ../shared/src/logger.ts
 const LEVELS = {
@@ -664,6 +690,111 @@ const createDefaultLogger$1 = (level, messageDecorator) => {
 	return new DefaultConsoleLogger(level ?? "warn", messageDecorator ?? new LogMessageDecorator());
 };
 //#endregion
+//#region ../shared/src/url.ts
+const defaultUrlFactory = (input, base) => new URL(input, base?.toString());
+const parseUrl = (url) => {
+	if (!url) return;
+	try {
+		return new URL(url);
+	} catch (error) {
+		throw new ConfigDirectorValidationError(`Invalid URL '${url}'. Parsing failed: ${error}`);
+	}
+};
+//#endregion
+//#region ../shared/src/instance-id.ts
+const generateInstanceId = () => {
+	if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") return crypto.randomUUID();
+	return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (placeholder) => {
+		const random = Math.random() * 16 | 0;
+		return (placeholder === "x" ? random : random & 3 | 8).toString(16);
+	});
+};
+//#endregion
+//#region ../js-client-core/src/instance-id.ts
+const STORAGE_KEY = "configdirector-sdk:instance-id";
+const RECORD_VERSION = 1;
+const MAX_AGE_MS = 360 * 60 * 1e3;
+const CHECKSUM_SALT = "configdirector.instanceId.v1";
+const UUID_V4_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
+const fnv1a = (input, offsetBasis) => {
+	let hash = offsetBasis;
+	for (let i = 0; i < input.length; i++) {
+		hash ^= input.charCodeAt(i);
+		hash = Math.imul(hash, 16777619);
+	}
+	return hash >>> 0;
+};
+const checksumFor = (id, createdAt) => {
+	const payload = `${CHECKSUM_SALT}|${id}|${createdAt}`;
+	const low = fnv1a(payload, 2166136261);
+	return fnv1a(`${low}|${payload}`, 16777619).toString(16).padStart(8, "0") + low.toString(16).padStart(8, "0");
+};
+const getLocalStorage = () => {
+	try {
+		return globalThis.localStorage ?? void 0;
+	} catch {
+		return;
+	}
+};
+const isUsableRecord = (record) => {
+	if (!record || typeof record !== "object") return false;
+	const { v, id, createdAt, checksum } = record;
+	if (v !== RECORD_VERSION || typeof id !== "string" || typeof checksum !== "string") return false;
+	if (typeof createdAt !== "number" || !Number.isInteger(createdAt) || createdAt <= 0) return false;
+	if (!UUID_V4_PATTERN.test(id)) return false;
+	return checksum === checksumFor(id, createdAt);
+};
+const readStoredInstanceId = (storage, logger) => {
+	let raw;
+	try {
+		raw = storage.getItem(STORAGE_KEY);
+	} catch (error) {
+		logger?.debug("[ConfigDirectorClient] Could not read the stored instance id, generating a new one", error);
+		return;
+	}
+	if (!raw) return;
+	let record;
+	try {
+		record = JSON.parse(raw);
+	} catch {
+		logger?.debug("[ConfigDirectorClient] The stored instance id is not valid JSON, generating a new one");
+		return;
+	}
+	if (!isUsableRecord(record)) {
+		logger?.debug("[ConfigDirectorClient] The stored instance id failed validation, generating a new one");
+		return;
+	}
+	const age = Date.now() - record.createdAt;
+	if (age < 0 || age >= MAX_AGE_MS) {
+		logger?.debug("[ConfigDirectorClient] The stored instance id has expired, generating a new one");
+		return;
+	}
+	return record.id;
+};
+const storeInstanceId = (storage, id, logger) => {
+	const createdAt = Date.now();
+	const record = {
+		v: RECORD_VERSION,
+		id,
+		createdAt,
+		checksum: checksumFor(id, createdAt)
+	};
+	try {
+		storage.setItem(STORAGE_KEY, JSON.stringify(record));
+	} catch (error) {
+		logger?.debug("[ConfigDirectorClient] Could not persist the instance id", error);
+	}
+};
+const resolveInstanceId = (logger) => {
+	const storage = getLocalStorage();
+	if (!storage) return generateInstanceId();
+	const storedInstanceId = readStoredInstanceId(storage, logger);
+	if (storedInstanceId) return storedInstanceId;
+	const instanceId = generateInstanceId();
+	storeInstanceId(storage, instanceId, logger);
+	return instanceId;
+};
+//#endregion
 //#region ../shared/src/transport/AbstractPollingTransport.ts
 var AbstractPollingTransport = class {
 	fatalError = false;
@@ -680,6 +811,7 @@ var AbstractPollingTransport = class {
 	async handleNonOkResponse(response) {
 		if (!response.ok) if (this.isStatusFatal(response.status)) {
 			this.fatalError = true;
+			this.close();
 			throw this.prepareFatalResponseStatusError(response.status, await response.text());
 		} else throw new ConfigDirectorConnectionError(`Connection failed with status: ${response.status}`, response.status);
 	}
@@ -699,9 +831,7 @@ var AbstractPollingTransport = class {
 		return !!status && status >= 400 && status < 500;
 	}
 	isFetchErrorFatal(fetchError) {
-		if (fetchError?.name === "NotAllowedError") return true;
-		else if (fetchError instanceof TypeError) return true;
-		return false;
+		return fetchError?.name === "NotAllowedError";
 	}
 	get isConnected() {
 		return this.pollingInterval !== void 0;
@@ -749,7 +879,9 @@ var PollingTransport = class extends AbstractPollingTransport {
 		this.options = options;
 		this.logger = options.logger;
 		this.url = options.resolveUrl("client/polling/v1", options.baseUrl);
-		this.pollingIntervalSeconds = options.pollingInterval ?? 60;
+		const requestedInterval = options.pollingInterval ?? 300;
+		if (requestedInterval < 60) this.logger.warn(`[PollingTransport] pollingInterval of ${requestedInterval} seconds is below the minimum of 60 seconds. Using 60 seconds.`);
+		this.pollingIntervalSeconds = Math.max(requestedInterval, 60);
 	}
 	async connect(context, timeout) {
 		this.clearPollingInterval();
@@ -788,7 +920,12 @@ var PollingTransport = class extends AbstractPollingTransport {
 				this.eventEmitter.emit("configSetReceived", json);
 			}
 		} catch (fetchError) {
-			this.handleFetchError(fetchError);
+			try {
+				this.handleFetchError(fetchError);
+			} catch (handledError) {
+				if (this.fatalError) this.eventEmitter.emit("connectionError", handledError);
+				throw handledError;
+			}
 		}
 	}
 	on(name, handler) {
@@ -802,33 +939,16 @@ var PollingTransport = class extends AbstractPollingTransport {
 	}
 };
 //#endregion
-//#region ../js-client-core/src/OneTimeTransport.ts
-var OneTimeTransport = class extends PollingTransport {
-	constructor(options) {
-		super(options);
-		this.pollingIntervalSeconds = 0;
-	}
-};
-//#endregion
-//#region ../shared/src/url.ts
-const defaultUrlFactory = (input, base) => new URL(input, base?.toString());
-const parseUrl = (url) => {
-	if (!url) return;
+//#region ../js-client-core/src/browser-globals.ts
+const read = (readValue) => {
 	try {
-		return new URL(url);
-	} catch (error) {
-		throw new ConfigDirectorValidationError(`Invalid URL '${url}'. Parsing failed: ${error}`);
+		return readValue(globalThis);
+	} catch {
+		return;
 	}
 };
-//#endregion
-//#region ../shared/src/instance-id.ts
-const generateInstanceId = () => {
-	if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") return crypto.randomUUID();
-	return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (placeholder) => {
-		const random = Math.random() * 16 | 0;
-		return (placeholder === "x" ? random : random & 3 | 8).toString(16);
-	});
-};
+const readUserAgent = () => read((globals) => globals.navigator?.userAgent);
+const readHost = () => read((globals) => globals.location?.host);
 //#endregion
 //#region ../js-client-core/src/DefaultConfigDirectorClient.ts
 const MAX_EXPONENTIAL_DELAY = 9;
@@ -849,8 +969,8 @@ var DefaultConfigDirectorClient = class {
 	connectionMode;
 	instanceId;
 	constructor(telemetryClient, clientSdkKey, sdkOptions, clientOptions, internalClientOptions) {
-		this.instanceId = generateInstanceId();
 		this.logger = clientOptions?.logger ?? createDefaultLogger$1();
+		this.instanceId = resolveInstanceId(this.logger);
 		this.timeout = clientOptions?.connection?.timeout ?? 3e3;
 		this.validateSdkKeyPresence(clientSdkKey);
 		const urlFactory = internalClientOptions?.urlFactory ?? defaultUrlFactory;
@@ -867,7 +987,8 @@ var DefaultConfigDirectorClient = class {
 				...clientOptions?.metadata,
 				sdkName: sdkOptions.sdkName,
 				sdkVersion: sdkOptions.sdkVersion,
-				userAgent: navigator?.userAgent
+				userAgent: readUserAgent(),
+				host: readHost()
 			},
 			logger: this.logger,
 			fetch: internalClientOptions?.fetch,
@@ -893,10 +1014,15 @@ var DefaultConfigDirectorClient = class {
 			}
 			this.logger.debug("[ConfigDirectorClient] ConfigSet updated from server:", { keys: configKeys });
 		});
+		this.transport.on("connectionError", (error) => {
+			this.logger.error("[ConfigDirectorClient] The connection encountered an unrecoverable error and will not be retried. Configs will no longer receive updates.", error);
+			this.emit("connectionError", { error });
+		});
 		this.registerHandler("clientReady", clientOptions?.hooks?.clientReady);
 		this.registerHandler("configEvaluated", clientOptions?.hooks?.configEvaluated);
 		this.registerHandler("configsUpdated", clientOptions?.hooks?.configsUpdated);
 		this.registerHandler("contextUpdated", clientOptions?.hooks?.contextUpdated);
+		this.registerHandler("connectionError", clientOptions?.hooks?.connectionError);
 	}
 	registerHandler(event, handler) {
 		if (!handler) return;
@@ -905,7 +1031,6 @@ var DefaultConfigDirectorClient = class {
 	}
 	getTransportConstructor(connectionMode) {
 		switch (connectionMode) {
-			case "one-time": return OneTimeTransport;
 			case "polling": return PollingTransport;
 			default: return StreamingTransport;
 		}
@@ -925,7 +1050,8 @@ var DefaultConfigDirectorClient = class {
 			this.ready = false;
 			this.readyPromise = new Promise((resolve) => {
 				this.readyResolve = resolve;
-			}).then(() => {
+			}).then((cancelled) => {
+				if (cancelled) return;
 				this.ready = true;
 				this.initializing = false;
 				this.emit("clientReady", { action: caller });
@@ -1085,10 +1211,11 @@ var DefaultConfigDirectorClient = class {
 	async close() {
 		this.logger.debug("[ConfigDirectorClient] close() has been called, closing connection to server");
 		clearTimeout(this.timeoutTimer);
-		this.readyResolve?.();
+		this.readyResolve?.(true);
 		this.telemetryClient.close();
 		this.transport.close();
 		this.ready = false;
+		this.initializing = false;
 	}
 	dispose() {
 		this.clear();
@@ -1122,14 +1249,18 @@ const mapToTelemetryValue = (ev) => {
 };
 //#endregion
 //#region ../js-browser-client/src/telemetry/WebWorkerTelemetryClient.ts
+const DEFAULT_WORKER_CLOSE_TIMEOUT = 6e3;
 var WebWorkerTelemetryClient = class {
 	logger;
 	worker;
 	closePromise;
 	closeResolve;
+	closeTimer;
+	workerCloseTimeout;
 	visibilityHandler;
 	constructor(options) {
 		this.logger = options.logger;
+		this.workerCloseTimeout = options.workerCloseTimeout ?? DEFAULT_WORKER_CLOSE_TIMEOUT;
 		const initializeMessage = {
 			type: "Initialize",
 			payload: {
@@ -1141,7 +1272,7 @@ var WebWorkerTelemetryClient = class {
 				flushIntervalDelay: options.flushIntervalDelay ?? 3e4
 			}
 		};
-		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.sdkIdentity=e.sdkIdentity,this.url=e.urlFactory(`client/telemetry/v1`,e.baseUrl)}async report({context:e,discreteEvents:t,aggregatedEvents:n,droppedEvents:r}){if(!this.executeRequests)return{success:!1,fatalError:!0};let i={clientSdkKey:this.sdkKey,metaContext:{sdkName:this.sdkIdentity.sdkName,sdkVersion:this.sdkIdentity.sdkVersion},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 = new Worker(URL.createObjectURL(new Blob(["(function(){let e=async(e,t)=>e.valueId?{valueId:e.valueId}:e.value?e.value.length<=500&&e.type!=`json`?{value:e.value}:{valueId:await t(e.value)}:e,t=e=>{let t=Object.keys(e);if(t.length==0)return!0;for(let n of t)if((e[n]?.length??0)>0)return!1;return!0},n=e=>{if(!e)return!0;let t=Object.keys(e);if(t.length==0)return!0;for(let n of t)if((e[n]??0)>0)return!1;return!0},r=async(e,t,n,r)=>{let i=new AbortController,a=setTimeout(()=>{r.debug(`[fetchWithTimeout] Reached timeout, aborting request`),i.abort()},e);try{let e=await fetch(typeof t==`string`||t instanceof Request?t:t.toString(),{...n,signal:i.signal});return clearTimeout(a),e}catch(e){throw r.warn(`[fetchWithTimeout] Fetch error: `,e),clearTimeout(a),e}},i=e=>e?.name===`NotAllowedError`?!0:e instanceof TypeError;var a=class{constructor(e){this.executeRequests=!0,this.sdkKey=e.sdkKey,this.logger=e.logger,this.sdkIdentity=e.sdkIdentity,this.url=e.urlFactory(`client/telemetry/v1`,e.baseUrl)}async report({context:e,discreteEvents:t,aggregatedEvents:n,droppedEvents:r}){if(!this.executeRequests)return{success:!1,fatalError:!0};let i={clientSdkKey:this.sdkKey,metaContext:{sdkName:this.sdkIdentity.sdkName,sdkVersion:this.sdkIdentity.sdkVersion},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(){if(!this.collectEvents)return;let e;try{e=await this.flush()}catch(t){this.logger.warn(`[TelemetryEventCollector] Error flushing telemetry events: `,t),e={success:!1,fatalError:!1}}e.fatalError?(this.collectEvents=!1,this.close(),this.logger.warn(`[TelemetryEventCollector] Received a fatal error from telemetry collection. No longer collecting events.`)):this.collectEvents&&(this.cancelScheduledFlush(),this.flushTimeout=setTimeout(()=>this.flushAndScheduleNext(),this.flushIntervalDelay))}cancelScheduledFlush(){clearTimeout(this.flushTimeout)}async close(){this.collectEvents=!1,clearTimeout(this.flushTimeout);try{await this.flush()}catch(e){this.logger.warn(`[TelemetryEventCollector] Error flushing telemetry events during close: `,e)}this.evaluationEventQueue.clear()}dispose(){this.close()}},l=class{constructor(e){this.valueIdGenerator=e,this.valueIdGenerator=e}async process(t){let n=await Promise.all(t.events.map(async t=>({...t,defaultValue:await e(t.defaultValue,this.valueIdGenerator),evaluatedValue:await e(t.evaluatedValue,this.valueIdGenerator)})));return{...t,events:n}}},u=class 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=>{if(typeof crypto>`u`||crypto.subtle==null)return;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`:if(g){y.warn(`[TelemetryWorker] Received a duplicate Initialize event, ignoring it`);break}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);
 		};
@@ -1185,7 +1316,7 @@ var WebWorkerTelemetryClient = class {
 	}
 	handleWorkerEvent(event) {
 		if (event.type === "Closed") {
-			this.closeResolve?.();
+			this.finishClose();
 			return;
 		}
 		if (!event.payload?.level || !event.payload?.message) return;
@@ -1201,7 +1332,7 @@ var WebWorkerTelemetryClient = class {
 				this.logger.warn(message, ...args);
 				break;
 			case "error":
-				this.logger.warn(message, ...args);
+				this.logger.error(message, ...args);
 				break;
 		}
 	}
@@ -1213,13 +1344,27 @@ var WebWorkerTelemetryClient = class {
 		return this.performClose();
 	}
 	performClose() {
-		document.removeEventListener("visibilitychange", this.visibilityHandler);
+		try {
+			document.removeEventListener("visibilitychange", this.visibilityHandler);
+		} catch (error) {
+			this.logger.warn("[WebWorkerTelemetryClient] Could not remove 'visibilitychange' listener: ", error);
+		}
 		this.closePromise = new Promise((resolve) => {
 			this.closeResolve = resolve;
+			this.closeTimer = setTimeout(() => {
+				this.logger.warn("[WebWorkerTelemetryClient] Timed out waiting for the telemetry worker to close. Terminating the worker.");
+				this.finishClose();
+			}, this.workerCloseTimeout);
 			this.worker.postMessage({ type: "Close" });
 		});
 		return this.closePromise;
 	}
+	finishClose() {
+		clearTimeout(this.closeTimer);
+		this.closeTimer = void 0;
+		this.worker.terminate();
+		this.closeResolve?.();
+	}
 };
 //#endregion
 //#region ../shared/src/base62-encoder.ts
@@ -1241,6 +1386,7 @@ const BASE62_LENGTH = Math.ceil(128 / Math.log2(62));
 //#region ../js-browser-client/src/telemetry/value-id-generator.ts
 const encoder = new TextEncoder();
 const generateValueId = async (v) => {
+	if (typeof crypto === "undefined" || crypto.subtle == null) return;
 	const hashBuffer = await crypto.subtle.digest("SHA-256", encoder.encode(v?.toString() ?? ""));
 	return toBase62(new Uint8Array(hashBuffer, 0, 16), BASE62_LENGTH);
 };
@@ -1317,7 +1463,7 @@ var plugin_client_default = defineNuxtPlugin((nuxtApp) => {
 	const { clientSdkKey, appName, appVersion, baseUrl } = runtimeConfig.public.configdirector;
 	const client = createBrowserClient(clientSdkKey, {
 		sdkName: "nuxt-sdk",
-		sdkVersion: "1.0.0"
+		sdkVersion: "1.3.0"
 	}, {
 		metadata: {
 			appName,

package/dist/runtime/plugin.server.mjs

@@ -83,15 +83,11 @@ var SsrClient = class {
 	getValue(configKey, defaultValue) {
 		return this.serverClient.getValue(configKey, defaultValue, this.currentContext);
 	}
-	watch(configKey, defaultValue, callback) {
-		return this.serverClient.watch(configKey, defaultValue, callback, this.currentContext);
-	}
-	unwatch(configKey, callback) {
-		return this.serverClient.unwatch(configKey, callback);
-	}
-	unwatchAll() {
-		return this.serverClient.unwatchAll();
+	watch() {
+		return () => {};
 	}
+	unwatch() {}
+	unwatchAll() {}
 	pauseNetwork() {}
 	async resumeNetwork() {}
 	dispose() {}

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

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

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

@@ -1,4 +1,4 @@
-import { t as ClientHooks } from "../../types-CzmBIfqo.mjs";
+import { t as ClientHooks } from "../../types-C54FjC1D.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-CzmBIfqo.mjs";
+import { t as ClientHooks } from "../../types-C54FjC1D.mjs";
 
 //#region src/runtime/server/composables/useConfigDirectorServerHooks.d.ts
 declare const useConfigDirectorServerHooks: (hooks: ClientHooks) => void;

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

@@ -16,6 +16,7 @@ type ClientHooks = {
   configsUpdated?: HookHandler<"configsUpdated"> | HookHandler<"configsUpdated">[];
   contextUpdated?: HookHandler<"contextUpdated"> | HookHandler<"contextUpdated">[];
   configEvaluated?: HookHandler<"configEvaluated"> | HookHandler<"configEvaluated">[];
+  connectionError?: HookHandler<"connectionError"> | HookHandler<"connectionError">[];
 };
 type ClientConnectAction = "initialization" | "context update" | "network resume";
 type HookHandler<TEvent extends keyof ClientEvents> = (payload: ClientEvents[TEvent]) => void;
@@ -32,6 +33,9 @@ type ClientEvents = {
   configEvaluated: {
     evaluation: ConfigEvaluation;
   };
+  connectionError: {
+    error: Error;
+  };
 };
 type WatchHandler<T extends ConfigValueType> = (message: T) => void;
 /**

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

@@ -9,11 +9,15 @@ type ClientEvents = {
   configEvaluated: {
     evaluation: ConfigEvaluation;
   };
+  connectionError: {
+    error: Error;
+  };
 };
 type ClientHooks = {
   clientReady?: HookHandler<"clientReady"> | HookHandler<"clientReady">[];
   configsUpdated?: HookHandler<"configsUpdated"> | HookHandler<"configsUpdated">[];
   configEvaluated?: HookHandler<"configEvaluated"> | HookHandler<"configEvaluated">[];
+  connectionError?: HookHandler<"connectionError"> | HookHandler<"connectionError">[];
 };
 type HookHandler<TEvent extends keyof ClientEvents> = (payload: ClientEvents[TEvent]) => void;
 type WatchHandler<T extends ConfigValueType> = (message: T) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@configdirector/nuxt-sdk",
-  "version": "1.0.0",
+  "version": "1.3.0",
   "description": "Nuxt SDK for ConfigDirector. ConfigDirector is a remote configuration and feature flag service.",
   "license": "MIT",
   "author": "ConfigDirector",
@@ -58,14 +58,14 @@
     "semver": "^7.7.4"
   },
   "devDependencies": {
-    "@nuxt/devtools": "^3.2.4",
+    "@nuxt/devtools": "^3.4.2",
     "@nuxt/eslint-config": "^1.15.2",
     "@nuxt/schema": "4.4.8",
     "@nuxt/test-utils": "^4.0.2",
     "@types/node": "^24.13.3",
     "changelogen": "^0.6.2",
     "eslint": "^10.7.0",
-    "nuxt": "^4.4.8",
+    "nuxt": "^4.5.2",
     "playwright": "^1.60.0",
     "rimraf": "^6.1.3",
     "tsdown": "^0.21.7",