@configdirector/nuxt-sdk 1.7.0 → 1.8.0

package/dist/runtime/plugin.client.mjs

@@ -512,7 +512,7 @@ const configTypesNotReadableAsString = new Set([
 const parseConfigValue = (configState, defaultValue) => {
 	const value = configState.value;
 	const requestedType = getRequestedType(defaultValue);
-	if (value == null) return {
+	if (value == null || value === "") return {
 		parsedValue: defaultValue,
 		parsedValueId: void 0,
 		requestedType,
@@ -715,6 +715,22 @@ const parseUrl = (url) => {
 	}
 };
 //#endregion
+//#region ../shared/src/transport/pollingInterval.ts
+const resolvePollingInterval = (configuredSeconds, defaults) => {
+	if (configuredSeconds === void 0) return {
+		seconds: defaults.defaultSeconds,
+		warning: void 0
+	};
+	if (configuredSeconds >= defaults.minimumSeconds) return {
+		seconds: configuredSeconds,
+		warning: void 0
+	};
+	return {
+		seconds: defaults.minimumSeconds,
+		warning: `pollingInterval of ${configuredSeconds} seconds is below the minimum of ${defaults.minimumSeconds} seconds. Using ${defaults.minimumSeconds} seconds.`
+	};
+};
+//#endregion
 //#region ../shared/src/instance-id.ts
 const generateInstanceId = () => {
 	if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") return crypto.randomUUID();
@@ -813,7 +829,6 @@ const resolveInstanceId = (logger) => {
 var AbstractPollingTransport = class {
 	fatalError = false;
 	pollingInterval;
-	pollingIntervalSeconds = 60;
 	clearPollingInterval() {
 		clearInterval(this.pollingInterval);
 	}
@@ -883,6 +898,7 @@ const fetchWithTimeout = async (timeout, resource, options, logger) => {
 //#endregion
 //#region ../js-client-core/src/PollingTransport.ts
 var PollingTransport = class extends AbstractPollingTransport {
+	pollingIntervalSeconds;
 	logger;
 	eventEmitter = new Emitter();
 	url;
@@ -893,9 +909,7 @@ var PollingTransport = class extends AbstractPollingTransport {
 		this.options = options;
 		this.logger = options.logger;
 		this.url = options.resolveUrl("client/polling/v1", options.baseUrl);
-		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);
+		this.pollingIntervalSeconds = options.pollingInterval ?? 60;
 	}
 	async connect(context, timeout) {
 		this.clearPollingInterval();
@@ -977,6 +991,7 @@ var DefaultConfigDirectorClient = class {
 	timeoutTimer;
 	ready = false;
 	initializing = false;
+	hasReceivedConfigSet = false;
 	readyPromise;
 	readyResolve;
 	currentContext;
@@ -990,45 +1005,30 @@ var DefaultConfigDirectorClient = class {
 		const urlFactory = internalClientOptions?.urlFactory ?? defaultUrlFactory;
 		const baseUrl = this.parseUrl(clientOptions?.connection?.url, urlFactory) ?? "https://client-sdk-api.configdirector.com";
 		this.connectionMode = clientOptions?.connection?.mode ?? "streaming";
-		const transportConstructor = this.getTransportConstructor(this.connectionMode);
 		this.telemetryClient = telemetryClient;
-		this.transport = new transportConstructor({
-			instanceId: this.instanceId,
-			clientSdkKey,
-			baseUrl,
-			resolveUrl: urlFactory,
-			metaContext: {
-				...clientOptions?.metadata,
-				sdkName: sdkOptions.sdkName,
-				sdkVersion: sdkOptions.sdkVersion,
-				userAgent: readUserAgent(),
-				host: readHost()
-			},
-			logger: this.logger,
-			fetch: internalClientOptions?.fetch,
-			connectionRetryDelay: internalClientOptions?.connectionRetryDelay ?? ((attempt) => {
-				return Math.pow(2, Math.min(attempt, MAX_EXPONENTIAL_DELAY)) * 1e3;
-			}),
-			pollingInterval: clientOptions?.connection?.pollingInterval
-		});
+		this.transport = internalClientOptions?.transport ?? this.buildTransport(clientSdkKey, sdkOptions, baseUrl, urlFactory, clientOptions, internalClientOptions);
 		this.transport.on("configSetReceived", (configSet) => {
+			this.hasReceivedConfigSet = true;
 			this.readyResolve?.();
-			const configKeys = Object.keys(configSet.configs);
-			if (!this.configSet || configSet.kind == "full") {
-				this.configSet = configSet;
-				this.emit("configsUpdated", { keys: configKeys });
-				this.updateWatchers(configSet.configs);
-			} else {
-				this.configSet.configs = {
-					...this.configSet.configs,
-					...configSet.configs
-				};
-				this.emit("configsUpdated", { keys: configKeys });
-				this.updateWatchers(configSet.configs);
-			}
-			this.logger.debug("[ConfigDirectorClient] ConfigSet updated from server:", { keys: configKeys });
+			const removedKeys = this.findKeysRemovedBy(configSet);
+			if (!this.configSet || configSet.kind == "full") this.configSet = configSet;
+			else this.configSet.configs = {
+				...this.configSet.configs,
+				...configSet.configs
+			};
+			const keys = Object.keys(configSet.configs);
+			this.emit("configsUpdated", {
+				keys,
+				removedKeys
+			});
+			this.updateWatchers([...keys, ...removedKeys]);
+			this.logger.debug("[ConfigDirectorClient] ConfigSet updated from server:", {
+				keys,
+				removedKeys
+			});
 		});
 		this.transport.on("connectionError", (error) => {
+			this.initializing = false;
 			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 });
 		});
@@ -1043,6 +1043,36 @@ var DefaultConfigDirectorClient = class {
 		const handlers = Array.isArray(handler) ? handler : [handler];
 		for (const h of handlers) if (typeof h === "function") this.on(event, h);
 	}
+	resolvePollingIntervalForMode(configuredSeconds) {
+		if (this.connectionMode !== "polling") return;
+		const resolved = resolvePollingInterval(configuredSeconds, {
+			defaultSeconds: 60,
+			minimumSeconds: 30
+		});
+		if (resolved.warning) this.logger.warn(`[ConfigDirectorClient] ${resolved.warning}`);
+		return resolved.seconds;
+	}
+	buildTransport(clientSdkKey, sdkOptions, baseUrl, urlFactory, clientOptions, internalClientOptions) {
+		return new (this.getTransportConstructor(this.connectionMode))({
+			instanceId: this.instanceId,
+			clientSdkKey,
+			baseUrl,
+			resolveUrl: urlFactory,
+			metaContext: {
+				...clientOptions?.metadata,
+				sdkName: sdkOptions.sdkName,
+				sdkVersion: sdkOptions.sdkVersion,
+				userAgent: readUserAgent(),
+				host: readHost()
+			},
+			logger: this.logger,
+			fetch: internalClientOptions?.fetch,
+			connectionRetryDelay: internalClientOptions?.connectionRetryDelay ?? ((attempt) => {
+				return Math.pow(2, Math.min(attempt, MAX_EXPONENTIAL_DELAY)) * 1e3;
+			}),
+			pollingInterval: this.resolvePollingIntervalForMode(clientOptions?.connection?.pollingInterval)
+		});
+	}
 	getTransportConstructor(connectionMode) {
 		switch (connectionMode) {
 			case "polling": return PollingTransport;
@@ -1050,7 +1080,7 @@ var DefaultConfigDirectorClient = class {
 		}
 	}
 	async initialize(context) {
-		this.initializing = true;
+		if (!this.hasReceivedConfigSet) this.initializing = true;
 		await this.connectToTransport(context, "initialization");
 	}
 	async updateContext(context) {
@@ -1072,7 +1102,7 @@ var DefaultConfigDirectorClient = class {
 				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);
+			await this.transport.connect(context ?? {}, this.timeout, caller);
 			this.currentContext = context;
 			this.telemetryClient.updateContext(context);
 			this.emit("contextUpdated", { context });
@@ -1088,12 +1118,17 @@ var DefaultConfigDirectorClient = class {
 			this.logger.error(`[ConfigDirectorClient] An error occurred during ${caller}: `, error);
 		}
 	}
-	updateWatchers(configsMap) {
-		Object.values(configsMap).forEach((v) => this.updateWatchersForConfig(v));
+	findKeysRemovedBy(configSet) {
+		if (!this.configSet || configSet.kind != "full") return [];
+		return Object.keys(this.configSet.configs).filter((key) => !Object.prototype.hasOwnProperty.call(configSet.configs, key));
+	}
+	updateWatchers(configKeys) {
+		configKeys.forEach((configKey) => this.updateWatchersForConfig(configKey));
 	}
-	updateWatchersForConfig(configState) {
-		this.handlersMap.get(configState.key)?.forEach((h) => {
-			const value = this.getValueFromConfigState(configState.key, configState, h.defaultValue);
+	updateWatchersForConfig(configKey) {
+		const configState = this.configSet?.configs[configKey];
+		this.handlersMap.get(configKey)?.forEach((h) => {
+			const value = this.getValueFromConfigState(configKey, configState, h.defaultValue);
 			h.handler(value);
 		});
 	}
@@ -1266,7 +1301,10 @@ const mapToTelemetryValue = (ev) => {
 const DEFAULT_WORKER_CLOSE_TIMEOUT = 6e3;
 var WebWorkerTelemetryClient = class {
 	logger;
+	initializeMessage;
 	worker;
+	pendingEvaluations = [];
+	pendingEvaluationLimit;
 	closePromise;
 	closeResolve;
 	closeTimer;
@@ -1275,45 +1313,59 @@ var WebWorkerTelemetryClient = class {
 	constructor(options) {
 		this.logger = options.logger;
 		this.workerCloseTimeout = options.workerCloseTimeout ?? DEFAULT_WORKER_CLOSE_TIMEOUT;
-		const initializeMessage = {
+		this.pendingEvaluationLimit = options.evaluationQueueLimit ?? 1e3;
+		this.initializeMessage = {
 			type: "Initialize",
 			payload: {
 				sdkKey: options.sdkKey,
 				sdkIdentity: options.sdkIdentity,
 				metaContext: options.metaContext,
 				baseUrl: options.baseUrl.toString(),
-				evaluationQueueLimit: options.evaluationQueueLimit ?? 1e3,
+				evaluationQueueLimit: this.pendingEvaluationLimit,
 				initialFlushIntervalDelay: options.initialFlushIntervalDelay ?? 5e3,
 				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.metaContext=e.metaContext,this.url=e.urlFactory(`client/telemetry/v1`,e.baseUrl)}async report({context:e,discreteEvents:t,aggregatedEvents:n,droppedEvents:r}){if(!this.executeRequests)return{success:!1,fatalError:!0};let i={clientSdkKey:this.sdkKey,metaContext:{sdkName:this.sdkIdentity.sdkName,sdkVersion:this.sdkIdentity.sdkVersion,appName:this.metaContext.appName,appVersion:this.metaContext.appVersion},context:e,discreteEvents:t,aggregatedEvents:n,droppedEvents:r};if(this.isReportEmpty(i))return{success:!0,fatalError:!1};let a=await this.sendReport(i);return a.fatalError&&(this.executeRequests=!1),a}isReportEmpty(e){return t(e.discreteEvents)&&t(e.aggregatedEvents)&&n(e.droppedEvents)}async sendReport(e){try{let t=await r(5e3,this.url,{method:`POST`,body:JSON.stringify(e),keepalive:!0},this.logger),n=this.isStatusFatal(t.status);return n&&this.logger.warn(`[EventReporter] Received a fatal status response (${t.status}) from the telemetry endpoint. No more telemetry data will be sent.`),{success:t.ok,fatalError:n}}catch(e){let t=i(e);return this.logger.warn(`[EventReporter] Error attempting to send telemetry data: ${e}`,{error:e}),{success:!1,fatalError:t}}}isStatusFatal(e){return!!e&&e>=400&&e<500&&e!=429}},o=class{aggregate(e){if(e.events.length==0)return[];let t=new Map;for(let n of e.events){let e=JSON.stringify(n),r=t.get(e)?.count||0;t.set(e,{event:n,count:r+1})}return Array.from(t).map(([,t])=>({startTime:e.startTime,endTime:e.endTime,count:t.count,event:t.event}))}},s=class{constructor(e){this._events=[],this._droppedEventCount=0,this.limit=e??1e3}get events(){return this._events}get reachedLimit(){return this._events.length>=this.limit}get droppedEventCount(){return this._droppedEventCount}push(...e){this.startTime||=new Date;let t=Math.max(0,e.length-this.limit),n=e.slice(t,e.length);if(this._droppedEventCount+=t,this._events.length+n.length>this.limit){let e=this._events.length+n.length-this.limit;this._events.splice(0,e),this._droppedEventCount+=e}return this._events.push(...n)}takeSnapshot(){let e=new Date,t=this.startTime??e,n=this._events.splice(0),r=this._droppedEventCount;return this.startTime=void 0,this._droppedEventCount=0,{startTime:t,endTime:e,events:n,droppedCount:r}}clear(){this._events=[],this.startTime=void 0,this._droppedEventCount=0}},c=class{constructor(e){this.aggregator=new o,this.collectEvents=!0,this.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);
-		};
-		this.worker.postMessage(initializeMessage);
 		this.visibilityHandler = () => {
 			if (document.visibilityState === "hidden") this.flush();
 		};
+	}
+	startWorker() {
+		if (this.worker) return this.worker;
+		const 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.metaContext=e.metaContext,this.url=e.urlFactory(`client/telemetry/v1`,e.baseUrl)}async report({context:e,discreteEvents:t,aggregatedEvents:n,droppedEvents:r}){if(!this.executeRequests)return{success:!1,fatalError:!0};let i={clientSdkKey:this.sdkKey,metaContext:{sdkName:this.sdkIdentity.sdkName,sdkVersion:this.sdkIdentity.sdkVersion,appName:this.metaContext.appName,appVersion:this.metaContext.appVersion},context:e,discreteEvents:t,aggregatedEvents:n,droppedEvents:r};if(this.isReportEmpty(i))return{success:!0,fatalError:!1};let a=await this.sendReport(i);return a.fatalError&&(this.executeRequests=!1),a}isReportEmpty(e){return t(e.discreteEvents)&&t(e.aggregatedEvents)&&n(e.droppedEvents)}async sendReport(e){try{let t=await r(5e3,this.url,{method:`POST`,body:JSON.stringify(e),keepalive:!0},this.logger),n=this.isStatusFatal(t.status);return n&&this.logger.warn(`[EventReporter] Received a fatal status response (${t.status}) from the telemetry endpoint. No more telemetry data will be sent.`),{success:t.ok,fatalError:n}}catch(e){let t=i(e);return this.logger.warn(`[EventReporter] Error attempting to send telemetry data: ${e}`,{error:e}),{success:!1,fatalError:t}}}isStatusFatal(e){return!!e&&e>=400&&e<500&&e!=429}},o=class{aggregate(e){if(e.events.length==0)return[];let t=new Map;for(let n of e.events){let e=JSON.stringify(n),r=t.get(e)?.count||0;t.set(e,{event:n,count:r+1})}return Array.from(t).map(([,t])=>({startTime:e.startTime,endTime:e.endTime,count:t.count,event:t.event}))}},s=class{constructor(e){this._events=[],this._droppedEventCount=0,this.limit=e??1e3}get events(){return this._events}get reachedLimit(){return this._events.length>=this.limit}get droppedEventCount(){return this._droppedEventCount}push(...e){this.startTime||=new Date;let t=Math.max(0,e.length-this.limit),n=e.slice(t,e.length);if(this._droppedEventCount+=t,this._events.length+n.length>this.limit){let e=this._events.length+n.length-this.limit;this._events.splice(0,e),this._droppedEventCount+=e}return this._events.push(...n)}takeSnapshot(){let e=new Date,t=this.startTime??e,n=this._events.splice(0),r=this._droppedEventCount;return this.startTime=void 0,this._droppedEventCount=0,{startTime:t,endTime:e,events:n,droppedCount:r}}clear(){this._events=[],this.startTime=void 0,this._droppedEventCount=0}},c=class{constructor(e){this.aggregator=new o,this.collectEvents=!0,this.started=!1,this.logger=e.logger,this.evaluationEventQueue=new s(e.evaluationQueueLimit??1e3),this.flushIntervalDelay=e.flushIntervalDelay??3e4,this.initialFlushIntervalDelay=e.initialFlushIntervalDelay??5e3}start(){this.started||!this.collectEvents||(this.started=!0,this.flushTimeout=setTimeout(()=>this.flushAndScheduleNext(),this.initialFlushIntervalDelay))}async flushAndScheduleNext(){if(!this.collectEvents)return;let e;try{e=await this.flush()}catch(t){this.logger.warn(`[TelemetryEventCollector] Error flushing telemetry events: `,t),e={success:!1,fatalError:!1}}e.fatalError?(this.collectEvents=!1,this.close(),this.logger.warn(`[TelemetryEventCollector] Received a fatal error from telemetry collection. No longer collecting events.`)):this.collectEvents&&(this.cancelScheduledFlush(),this.flushTimeout=setTimeout(()=>this.flushAndScheduleNext(),this.flushIntervalDelay))}cancelScheduledFlush(){clearTimeout(this.flushTimeout)}async close(){this.collectEvents=!1,clearTimeout(this.flushTimeout);try{await this.flush()}catch(e){this.logger.warn(`[TelemetryEventCollector] Error flushing telemetry events during close: `,e)}this.evaluationEventQueue.clear()}dispose(){this.close()}},l=class{constructor(e){this.valueIdGenerator=e,this.valueIdGenerator=e}async process(t){let n=await Promise.all(t.events.map(async t=>({...t,defaultValue:await e(t.defaultValue,this.valueIdGenerator),evaluatedValue:await e(t.evaluatedValue,this.valueIdGenerator)})));return{...t,events:n}}},u=class 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}),g.start();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" })));
+		worker.onmessage = (message) => {
+			this.handleWorkerEvent(message.data);
+		};
+		worker.postMessage(this.initializeMessage);
+		this.worker = worker;
 		try {
 			document.addEventListener("visibilitychange", this.visibilityHandler);
 		} catch (error) {
 			this.logger.warn("[TelemetryEventCollector] Could not configure 'visibilitychange' listener: ", error);
 		}
+		for (const evaluation of this.pendingEvaluations) worker.postMessage(evaluation);
+		this.pendingEvaluations.length = 0;
+		return worker;
 	}
 	async updateContext(value) {
+		if (this.closePromise) return;
 		const updateContextMessage = {
 			type: "UpdateContext",
 			payload: { context: value }
 		};
-		this.worker.postMessage(updateContextMessage);
+		this.startWorker().postMessage(updateContextMessage);
 	}
 	evaluatedConfig(event) {
 		const evaluatedConfigMessage = {
 			type: "EvaluatedConfigEvent",
 			payload: this.sanitizeEvaluatedConfigEvent(event)
 		};
-		this.worker.postMessage(evaluatedConfigMessage);
+		if (this.worker) {
+			this.worker.postMessage(evaluatedConfigMessage);
+			return;
+		}
+		if (this.pendingEvaluations.length >= this.pendingEvaluationLimit) this.pendingEvaluations.shift();
+		this.pendingEvaluations.push(evaluatedConfigMessage);
 	}
 	sanitizeEvaluatedConfigEvent(event) {
 		return {
@@ -1352,13 +1404,19 @@ var WebWorkerTelemetryClient = class {
 		}
 	}
 	flush() {
-		this.worker.postMessage({ type: "Flush" });
+		this.worker?.postMessage({ type: "Flush" });
 	}
 	close() {
 		if (this.closePromise) return this.closePromise;
 		return this.performClose();
 	}
 	performClose() {
+		const worker = this.worker;
+		if (!worker) {
+			this.pendingEvaluations.length = 0;
+			this.closePromise = Promise.resolve();
+			return this.closePromise;
+		}
 		try {
 			document.removeEventListener("visibilitychange", this.visibilityHandler);
 		} catch (error) {
@@ -1370,14 +1428,14 @@ var WebWorkerTelemetryClient = class {
 				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" });
+			worker.postMessage({ type: "Close" });
 		});
 		return this.closePromise;
 	}
 	finishClose() {
 		clearTimeout(this.closeTimer);
 		this.closeTimer = void 0;
-		this.worker.terminate();
+		this.worker?.terminate();
 		this.closeResolve?.();
 	}
 };
@@ -1430,6 +1488,35 @@ const createBrowserClient = (clientSdkKey, sdkOptions, clientOptions) => {
 	});
 };
 //#endregion
+//#region ../js-client-core/src/installedTestClient.ts
+const INSTALLED_TEST_CLIENT_SLOT = Symbol.for("@configdirector/installed-test-client");
+const readInstalledTestClient = () => globalThis[INSTALLED_TEST_CLIENT_SLOT];
+//#endregion
+//#region ../shared/src/deepEqual.ts
+const deepEqual = (left, right) => {
+	if (Object.is(left, right)) return true;
+	if (typeof left !== "object" || typeof right !== "object" || left === null || right === null) return false;
+	if (Object.getPrototypeOf(left) !== Object.getPrototypeOf(right)) return false;
+	if (left instanceof Date && right instanceof Date) return left.getTime() === right.getTime();
+	if (Array.isArray(left) && Array.isArray(right)) return left.length === right.length && left.every((item, index) => deepEqual(item, right[index]));
+	if (!isPlainObject(left) || !isPlainObject(right)) return false;
+	const leftKeys = Object.keys(left);
+	const rightKeys = Object.keys(right);
+	return leftKeys.length === rightKeys.length && leftKeys.every((key) => Object.prototype.hasOwnProperty.call(right, key) && deepEqual(left[key], right[key]));
+};
+const isPlainObject = (value) => {
+	const prototype = Object.getPrototypeOf(value);
+	return prototype === Object.prototype || prototype === null;
+};
+//#endregion
+//#region ../js-client-core/src/mountAction.ts
+const decideMountAction = (client, context) => {
+	if (client.isInitializing) return "none";
+	if (!client.isReady) return "initialize";
+	if (context !== void 0 && !deepEqual(context, client.context)) return "updateContext";
+	return "none";
+};
+//#endregion
 //#region src/runtime/app/composables/useConfigDirectorClient.ts
 const useConfigDirectorClient = () => {
 	const { $configDirectorClient } = useNuxtApp();
@@ -1451,9 +1538,14 @@ const useConfigDirectorContext = () => {
 		state.value = rawContext;
 		if (oldContext != newContext) {
 			const timeout = getEffectiveTimeout(options?.timeoutMilliseconds);
-			await Promise.race([client.updateContext(rawContext), new Promise((resolve) => {
-				setTimeout(() => resolve(), timeout);
-			})]);
+			let timer;
+			try {
+				await Promise.race([client.updateContext(rawContext), new Promise((resolve) => {
+					timer = setTimeout(() => resolve(), timeout);
+				})]);
+			} finally {
+				clearTimeout(timer);
+			}
 		}
 	};
 	return {
@@ -1470,45 +1562,55 @@ const createDefaultLogger = (level) => {
 };
 //#endregion
 //#region src/runtime/plugin.client.ts
+const DEFAULT_INITIALIZATION_TIMEOUT_MILLISECONDS = 2e3;
 var plugin_client_default = defineNuxtPlugin((nuxtApp) => {
 	const runtimeConfig = useRuntimeConfig();
 	const logger = createDefaultLogger(runtimeConfig.public?.configdirector?.logLevel);
-	if (!runtimeConfig.public?.configdirector?.clientSdkKey) {
+	const installedTestClient = readInstalledTestClient();
+	const client = installedTestClient ?? buildClient(runtimeConfig.public?.configdirector, logger);
+	logger.debug(installedTestClient ? "Installed ConfigDirector Nuxt plugin with a test client" : "Installed ConfigDirector Nuxt plugin");
+	const readyStatus = shallowRef(client.isReady ? "ready" : "loading");
+	client.on("clientReady", () => {
+		readyStatus.value = "ready";
+	});
+	nuxtApp.hooks.hook("app:created", async () => {
+		const { context } = useConfigDirectorContext();
+		const rawContext = toRaw(context.value);
+		const mountAction = decideMountAction(client, rawContext);
+		logger.debug(`Browser client mount action: ${mountAction}`);
+		if (mountAction === "initialize") await client.initialize(rawContext);
+		else if (mountAction === "updateContext" && rawContext !== void 0) await client.updateContext(rawContext);
+		if (!client.isReady) readyStatus.value = "default";
+		logger.debug(`Browser client mount action awaited, ready status: ${client.isReady}`);
+	});
+	return { provide: {
+		configDirectorClient: client,
+		configDirectorClientReadyStatus: readonly(readyStatus)
+	} };
+});
+const buildClient = (configdirector, logger) => {
+	if (!configdirector?.clientSdkKey) {
 		const message = "The ConfigDirector clientSdkKey must be configured for the plugin to initialize. You can provide it in nuxt.config.ts under 'runtimeConfig.public.configdirector.clientSdkKey' or as a runtime environment variable named NUXT_PUBLIC_CONFIGDIRECTOR_CLIENT_SDK_KEY";
 		logger.error(message);
 		throw new ConfigDirectorInitializationError(message);
 	}
-	logger.debug("Installed ConfigDirector Nuxt plugin");
-	const { clientSdkKey, appName, appVersion, baseUrl } = runtimeConfig.public.configdirector;
-	const client = createBrowserClient(clientSdkKey, {
+	const { clientSdkKey, appName, appVersion, baseUrl, connection } = configdirector;
+	return createBrowserClient(clientSdkKey, {
 		sdkName: "nuxt-sdk",
-		sdkVersion: "1.7.0"
+		sdkVersion: "1.8.0"
 	}, {
 		metadata: {
 			appName,
 			appVersion
 		},
 		connection: {
-			timeout: 2e3,
-			...baseUrl ? { url: baseUrl } : {}
+			url: baseUrl || void 0,
+			mode: connection?.mode || void 0,
+			pollingInterval: connection?.pollingInterval || void 0,
+			timeout: connection?.timeout || DEFAULT_INITIALIZATION_TIMEOUT_MILLISECONDS
 		},
 		logger
 	});
-	const readyStatus = shallowRef(client.isReady ? "ready" : "loading");
-	client.on("clientReady", () => {
-		readyStatus.value = "ready";
-	});
-	nuxtApp.hooks.hook("app:created", async () => {
-		logger.debug("Initializing browser client");
-		const { context } = useConfigDirectorContext();
-		await client.initialize(toRaw(context.value));
-		if (!client.isReady) readyStatus.value = "default";
-		logger.debug(`Browser client initialization awaited, ready status: ${client.isReady}`);
-	});
-	return { provide: {
-		configDirectorClient: client,
-		configDirectorClientReadyStatus: readonly(readyStatus)
-	} };
-});
+};
 //#endregion
 export { plugin_client_default as default };

package/dist/runtime/plugin.server.mjs

@@ -29,9 +29,14 @@ const useConfigDirectorContext = () => {
 		state.value = rawContext;
 		if (oldContext != newContext) {
 			const timeout = getEffectiveTimeout(options?.timeoutMilliseconds);
-			await Promise.race([client.updateContext(rawContext), new Promise((resolve) => {
-				setTimeout(() => resolve(), timeout);
-			})]);
+			let timer;
+			try {
+				await Promise.race([client.updateContext(rawContext), new Promise((resolve) => {
+					timer = setTimeout(() => resolve(), timeout);
+				})]);
+			} finally {
+				clearTimeout(timer);
+			}
 		}
 	};
 	return {

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

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

package/dist/runtime/{types-C54FjC1D.d.mts → types-Bgx2-3dY.d.mts}

@@ -4,6 +4,7 @@ import { i as ConfigValueType, n as ConfigEvaluation, r as ConfigState, t as Con
 type ClientEvents = {
   configsUpdated: {
     keys: string[];
+    removedKeys: string[];
   };
   clientReady: undefined;
   configEvaluated: {

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

@@ -23,6 +23,7 @@ type HookHandler<TEvent extends keyof ClientEvents> = (payload: ClientEvents[TEv
 type ClientEvents = {
   configsUpdated: {
     keys: string[];
+    removedKeys: string[];
   };
   clientReady: {
     action: ClientConnectAction;
@@ -85,8 +86,11 @@ interface ConfigDirectorClient extends EventProvider<ClientEvents> {
    */
   get isReady(): boolean;
   /**
-   * Returns whether or not the client is currently initializing. Upon client creation, it is `false`.
-   * It is `true` after calling `initialize` and becomes `false` again once initialization is completed.
+   * Whether the client is trying to get its very first payload from the server. Upon client creation,
+   * it is `false`. It becomes `true` when `initialize` is called on a client that has never received a
+   * payload, stays `true` through timeouts and retries, and becomes `false` when the first payload
+   * arrives, when a fatal connection error stops the retries, or on `close`. `updateContext` and
+   * `resumeNetwork` never set it, and once a payload has been received it is never `true` again.
    */
   get isInitializing(): boolean;
   /**