@configdirector/nuxt-sdk 1.9.2 → 1.10.0

package/dist/runtime/plugin.client.mjs

@@ -393,6 +393,7 @@ var StreamingTransport = class {
 	eventEmitter = new Emitter();
 	url;
 	timeoutTimer;
+	connectionGeneration = 0;
 	constructor(options) {
 		this.options = options;
 		this.options = options;
@@ -400,6 +401,9 @@ var StreamingTransport = class {
 		this.url = options.resolveUrl("client/sse/v1", options.baseUrl);
 	}
 	async connect(context, timeout) {
+		const generation = ++this.connectionGeneration;
+		const clientSession = await this.options.clientSession;
+		if (generation !== this.connectionGeneration) return this;
 		if (this.eventSource) this.close();
 		const eventSourcePromise = new Promise((resolve, reject) => {
 			this.eventSource = createEventSourceClient({
@@ -411,7 +415,8 @@ var StreamingTransport = class {
 					givenContext: context,
 					metaContext: this.options.metaContext,
 					clientSdkKey: this.options.clientSdkKey,
-					instanceId: this.options.instanceId
+					instanceId: clientSession.instanceId,
+					ephemeral: clientSession.ephemeral
 				}),
 				onMessage: ({ data }) => {
 					this.dispatchMessage(data);
@@ -476,6 +481,7 @@ var StreamingTransport = class {
 		this.eventEmitter.clear();
 	}
 	close() {
+		this.connectionGeneration++;
 		this.eventSource?.close();
 		clearTimeout(this.timeoutTimer);
 	}
@@ -740,10 +746,11 @@ const generateInstanceId = () => {
 	});
 };
 //#endregion
-//#region ../js-client-core/src/instance-id.ts
+//#region ../js-client-core/src/client-session.ts
 const STORAGE_KEY = "configdirector-sdk:instance-id";
 const RECORD_VERSION = 1;
 const MAX_AGE_MS = 360 * 60 * 1e3;
+const STORAGE_DEADLINE_MS = 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) => {
@@ -759,7 +766,7 @@ const checksumFor = (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 = () => {
+const localStorageIfAvailable = () => {
 	try {
 		return globalThis.localStorage ?? void 0;
 	} catch {
@@ -774,34 +781,37 @@ const isUsableRecord = (record) => {
 	if (!UUID_V4_PATTERN.test(id)) return false;
 	return checksum === checksumFor(id, createdAt);
 };
-const readStoredInstanceId = (storage, logger) => {
+const readStoredInstanceId = async (storage, logger) => {
 	let raw;
 	try {
-		raw = storage.getItem(STORAGE_KEY);
+		raw = await storage.getItem(STORAGE_KEY);
 	} catch (error) {
-		logger?.debug("[ConfigDirectorClient] Could not read the stored instance id, generating a new one", error);
-		return;
+		logger.debug("[ConfigDirectorClient] Could not read the stored instance id, using an ephemeral one", error);
+		return { outcome: "failed" };
 	}
-	if (!raw) return;
+	if (typeof raw !== "string" || raw === "") return { outcome: "nothing usable" };
 	let record;
 	try {
 		record = JSON.parse(raw);
 	} catch {
-		logger?.debug("[ConfigDirectorClient] The stored instance id is not valid JSON, generating a new one");
-		return;
+		logger.debug("[ConfigDirectorClient] The stored instance id is not valid JSON, generating a new one");
+		return { outcome: "nothing usable" };
 	}
 	if (!isUsableRecord(record)) {
-		logger?.debug("[ConfigDirectorClient] The stored instance id failed validation, generating a new one");
-		return;
+		logger.debug("[ConfigDirectorClient] The stored instance id failed validation, generating a new one");
+		return { outcome: "nothing usable" };
 	}
 	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;
+		logger.debug("[ConfigDirectorClient] The stored instance id has expired, generating a new one");
+		return { outcome: "nothing usable" };
 	}
-	return record.id;
+	return {
+		outcome: "stored",
+		instanceId: record.id
+	};
 };
-const storeInstanceId = (storage, id, logger) => {
+const persistInstanceId = async (storage, id, logger) => {
 	const createdAt = Date.now();
 	const record = {
 		v: RECORD_VERSION,
@@ -810,19 +820,54 @@ const storeInstanceId = (storage, id, logger) => {
 		checksum: checksumFor(id, createdAt)
 	};
 	try {
-		storage.setItem(STORAGE_KEY, JSON.stringify(record));
+		await storage.setItem(STORAGE_KEY, JSON.stringify(record));
+		return true;
 	} catch (error) {
-		logger?.debug("[ConfigDirectorClient] Could not persist the instance id", error);
+		logger.debug("[ConfigDirectorClient] Could not persist the instance id, using it as an ephemeral one", error);
+		return false;
 	}
 };
-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;
+const settleFromStorage = async (storage, provisionalId, deadline, logger) => {
+	const read = await readStoredInstanceId(storage, logger);
+	switch (read.outcome) {
+		case "stored": return { instanceId: read.instanceId };
+		case "failed": return {
+			instanceId: provisionalId,
+			ephemeral: true
+		};
+		case "nothing usable": break;
+	}
+	if (deadline.passed) return {
+		instanceId: provisionalId,
+		ephemeral: true
+	};
+	return await persistInstanceId(storage, provisionalId, logger) ? { instanceId: provisionalId } : {
+		instanceId: provisionalId,
+		ephemeral: true
+	};
+};
+const resolveClientSession = (logger, storage = localStorageIfAvailable()) => {
+	const provisionalId = generateInstanceId();
+	if (!storage) {
+		logger.debug("[ConfigDirectorClient] No instance id storage is available, using an ephemeral instance id");
+		return Promise.resolve({
+			instanceId: provisionalId,
+			ephemeral: true
+		});
+	}
+	const deadline = { passed: false };
+	let deadlineTimer;
+	const fallbackAtDeadline = new Promise((resolve) => {
+		deadlineTimer = setTimeout(() => {
+			deadline.passed = true;
+			logger.warn(`[ConfigDirectorClient] The instance id storage did not respond within ${STORAGE_DEADLINE_MS}ms, using an ephemeral instance id`);
+			resolve({
+				instanceId: provisionalId,
+				ephemeral: true
+			});
+		}, STORAGE_DEADLINE_MS);
+	});
+	return Promise.race([settleFromStorage(storage, provisionalId, deadline, logger), fallbackAtDeadline]).finally(() => clearTimeout(deadlineTimer));
 };
 //#endregion
 //#region ../shared/src/transport/AbstractPollingTransport.ts
@@ -903,6 +948,7 @@ var PollingTransport = class extends AbstractPollingTransport {
 	eventEmitter = new Emitter();
 	url;
 	lastUpdateTimestamp;
+	connectionGeneration = 0;
 	constructor(options) {
 		super();
 		this.options = options;
@@ -912,19 +958,26 @@ var PollingTransport = class extends AbstractPollingTransport {
 		this.pollingIntervalSeconds = options.pollingInterval ?? 60;
 	}
 	async connect(context, timeout) {
+		const generation = ++this.connectionGeneration;
 		this.clearPollingInterval();
+		const clientSession = await this.options.clientSession;
+		if (generation !== this.connectionGeneration) return this;
 		try {
-			await this.fetchConfigs(context, timeout);
+			await this.fetchConfigs(context, timeout, clientSession);
 		} finally {
 			if (!this.fatalError) this.schedulePollingInterval(() => {
-				this.fetchConfigs(context, timeout).catch((error) => {
+				this.fetchConfigs(context, timeout, clientSession).catch((error) => {
 					this.logger.error("[PollingTransport] Error during polling:", error);
 				});
 			});
 		}
 		return this;
 	}
-	async fetchConfigs(context, timeout) {
+	close() {
+		this.connectionGeneration++;
+		super.close();
+	}
+	async fetchConfigs(context, timeout, clientSession) {
 		if (this.fatalError) {
 			this.logger.warn("[PollingTransport] There was a prior unrecoverable error. Ignoring attempt to reconnect.");
 			return;
@@ -937,7 +990,8 @@ var PollingTransport = class extends AbstractPollingTransport {
 					givenContext: context,
 					metaContext: this.options.metaContext,
 					clientSdkKey: this.options.clientSdkKey,
-					instanceId: this.options.instanceId,
+					instanceId: clientSession.instanceId,
+					ephemeral: clientSession.ephemeral,
 					lastUpdateTimestamp: this.lastUpdateTimestamp
 				})
 			}, this.logger);
@@ -978,6 +1032,50 @@ const read = (readValue) => {
 const readUserAgent = () => read((globals) => globals.navigator?.userAgent);
 const readHost = () => read((globals) => globals.location?.host);
 //#endregion
+//#region ../shared/src/context-kind.ts
+const CONTEXT_KIND_MAXIMUM_LENGTH = 64;
+const KIND_SAMPLE_MAXIMUM_CHARACTERS = 128;
+const isContextKindCharacter = (character) => character >= "a" && character <= "z" || character >= "0" && character <= "9" || character === "-" || character === "_";
+const isValidContextKind = (kind) => {
+	if (kind.length < 1 || kind.length > CONTEXT_KIND_MAXIMUM_LENGTH) return false;
+	for (const character of kind) if (!isContextKindCharacter(character)) return false;
+	return true;
+};
+const isAcceptedKind = (kind) => kind === void 0 || kind === null || typeof kind === "string" && isValidContextKind(kind);
+const stringFormOf = (kind) => {
+	if (typeof kind === "string") return kind;
+	try {
+		return String(kind);
+	} catch {
+		return Object.prototype.toString.call(kind);
+	}
+};
+const firstCharactersOf = (text, maximumCharacters) => {
+	let sample = "";
+	let characterCount = 0;
+	for (const character of text) {
+		if (characterCount === maximumCharacters) break;
+		sample += character;
+		characterCount += 1;
+	}
+	return sample;
+};
+const admittedContextOrNone = (context) => {
+	const admission = admitContext(context);
+	return admission.outcome === "admitted" ? admission.context : void 0;
+};
+const admitContext = (context) => {
+	const kind = context?.kind;
+	if (isAcceptedKind(kind)) return {
+		outcome: "admitted",
+		context
+	};
+	return {
+		outcome: "ignored",
+		kindSample: firstCharactersOf(stringFormOf(kind), KIND_SAMPLE_MAXIMUM_CHARACTERS)
+	};
+};
+//#endregion
 //#region ../js-client-core/src/DefaultConfigDirectorClient.ts
 const MAX_EXPONENTIAL_DELAY = 9;
 var DefaultConfigDirectorClient = class {
@@ -996,10 +1094,10 @@ var DefaultConfigDirectorClient = class {
 	readyResolve;
 	currentContext;
 	connectionMode;
-	instanceId;
+	clientSession;
 	constructor(telemetryClient, clientSdkKey, sdkOptions, clientOptions, internalClientOptions) {
 		this.logger = clientOptions?.logger ?? createDefaultLogger$1();
-		this.instanceId = resolveInstanceId(this.logger);
+		this.clientSession = resolveClientSession(this.logger, internalClientOptions?.instanceIdStorage);
 		this.timeout = clientOptions?.connection?.timeout ?? 3e3;
 		this.validateSdkKeyPresence(clientSdkKey);
 		const urlFactory = internalClientOptions?.urlFactory ?? defaultUrlFactory;
@@ -1054,7 +1152,7 @@ var DefaultConfigDirectorClient = class {
 	}
 	buildTransport(clientSdkKey, sdkOptions, baseUrl, urlFactory, clientOptions, internalClientOptions) {
 		return new (this.getTransportConstructor(this.connectionMode))({
-			instanceId: this.instanceId,
+			clientSession: this.clientSession,
 			clientSdkKey,
 			baseUrl,
 			resolveUrl: urlFactory,
@@ -1081,10 +1179,23 @@ var DefaultConfigDirectorClient = class {
 	}
 	async initialize(context) {
 		if (!this.hasReceivedConfigSet) this.initializing = true;
-		await this.connectToTransport(context, "initialization");
+		await this.submitContext(context, "initialization");
 	}
 	async updateContext(context) {
-		await this.connectToTransport(context, "context update");
+		await this.submitContext(context, "context update");
+	}
+	async submitContext(context, submission) {
+		await this.connectToTransport(this.contextToConnectWith(context, submission), submission);
+	}
+	contextToConnectWith(suppliedContext, submission) {
+		const admission = admitContext(suppliedContext);
+		switch (admission.outcome) {
+			case "admitted": return admission.context;
+			case "ignored":
+				this.logger.error(`[ConfigDirectorClient] Ignored the context supplied for ${submission} because its kind '${admission.kindSample}' is invalid; connecting as if no context was supplied. A context kind has 1 to 64 characters, using only lowercase letters, digits, '-' and '_'.`);
+				this.telemetryClient.recordInvalidContext(admission.kindSample);
+				return;
+		}
 	}
 	get context() {
 		return this.currentContext;
@@ -1296,6 +1407,59 @@ const mapToTelemetryValue = (ev) => {
 	if (stringValue && stringValue.length <= CONFIG_VALUE_MAX_LENGTH) return { value: stringValue };
 	return ev.valueId ? { valueId: ev.valueId } : { value: stringValue };
 };
+var InvalidContextSubmissions = class {
+	countsByKindSample = /* @__PURE__ */ new Map();
+	countBeyondSampleLimit = 0;
+	startTime;
+	record(kindSample) {
+		this.startTime ??= /* @__PURE__ */ new Date();
+		return this.add(kindSample, 1);
+	}
+	absorb(entries) {
+		for (const entry of entries) {
+			if (this.startTime === void 0 || entry.startTime < this.startTime) this.startTime = entry.startTime;
+			this.add(entry.event.kindSample, entry.count);
+		}
+	}
+	add(kindSample, count) {
+		if (kindSample !== void 0) {
+			const knownCount = this.countsByKindSample.get(kindSample);
+			if (knownCount !== void 0) {
+				this.countsByKindSample.set(kindSample, knownCount + count);
+				return "known-kind-sample";
+			}
+			if (this.countsByKindSample.size < 20) {
+				this.countsByKindSample.set(kindSample, count);
+				return "new-kind-sample";
+			}
+		}
+		const firstBeyondSampleLimit = this.countBeyondSampleLimit === 0;
+		this.countBeyondSampleLimit += count;
+		return firstBeyondSampleLimit ? "first-beyond-sample-limit" : "beyond-sample-limit";
+	}
+	takeSnapshot() {
+		const endTime = /* @__PURE__ */ new Date();
+		const startTime = this.startTime ?? endTime;
+		const entryOf = (count, kindSample) => ({
+			startTime,
+			endTime,
+			count,
+			event: {
+				reason: "invalid-context-kind",
+				kindSample
+			}
+		});
+		const sampledEntries = Array.from(this.countsByKindSample, ([kindSample, count]) => entryOf(count, kindSample));
+		const entries = this.countBeyondSampleLimit > 0 ? [...sampledEntries, entryOf(this.countBeyondSampleLimit)] : sampledEntries;
+		this.clear();
+		return entries;
+	}
+	clear() {
+		this.countsByKindSample.clear();
+		this.countBeyondSampleLimit = 0;
+		this.startTime = void 0;
+	}
+};
 //#endregion
 //#region ../js-browser-client/src/telemetry/WebWorkerTelemetryClient.ts
 const DEFAULT_WORKER_CLOSE_TIMEOUT = 6e3;
@@ -1306,6 +1470,7 @@ var WebWorkerTelemetryClient = class {
 	turnedOff = false;
 	pendingEvaluations = [];
 	pendingEvaluationLimit;
+	pendingInvalidContextSubmissions = new InvalidContextSubmissions();
 	closePromise;
 	closeResolve;
 	closeTimer;
@@ -1337,7 +1502,7 @@ var WebWorkerTelemetryClient = class {
 			return;
 		}
 		try {
-			return new Worker(URL.createObjectURL(new Blob(["(function(){let e=async(e,t)=>e.valueId?{valueId:e.valueId}:e.value?e.value.length<=500&&e.type!=`json`?{value:e.value}:{valueId:await t(e.value)}:e,t=e=>{let t=Object.keys(e);if(t.length==0)return!0;for(let n of t)if((e[n]?.length??0)>0)return!1;return!0},n=e=>{if(!e)return!0;let t=Object.keys(e);if(t.length==0)return!0;for(let n of t)if((e[n]??0)>0)return!1;return!0},r=async(e,t,n,r)=>{let i=new AbortController,a=setTimeout(()=>{r.debug(`[fetchWithTimeout] Reached timeout, aborting request`),i.abort()},e);try{let e=await fetch(typeof t==`string`||t instanceof Request?t:t.toString(),{...n,signal:i.signal});return clearTimeout(a),e}catch(e){throw r.warn(`[fetchWithTimeout] Fetch error: `,e),clearTimeout(a),e}},i=e=>e?.name===`NotAllowedError`?!0:e instanceof TypeError;var a=class{constructor(e){this.executeRequests=!0,this.sdkKey=e.sdkKey,this.logger=e.logger,this.sdkIdentity=e.sdkIdentity,this.metaContext=e.metaContext,this.url=e.urlFactory(`client/telemetry/v1`,e.baseUrl)}async report({context:e,discreteEvents:t,aggregatedEvents:n,droppedEvents:r}){if(!this.executeRequests)return{success:!1,fatalError:!0};let i={clientSdkKey:this.sdkKey,metaContext:{sdkName:this.sdkIdentity.sdkName,sdkVersion:this.sdkIdentity.sdkVersion,appName:this.metaContext.appName,appVersion:this.metaContext.appVersion},context:e,discreteEvents:t,aggregatedEvents:n,droppedEvents:r};if(this.isReportEmpty(i))return{success:!0,fatalError:!1};let a=await this.sendReport(i);return a.fatalError&&(this.executeRequests=!1),a}isReportEmpty(e){return t(e.discreteEvents)&&t(e.aggregatedEvents)&&n(e.droppedEvents)}async sendReport(e){try{let t=await r(5e3,this.url,{method:`POST`,body:JSON.stringify(e),keepalive:!0},this.logger),n=this.isStatusFatal(t.status);return n&&this.logger.warn(`[EventReporter] Received a fatal status response (${t.status}) from the telemetry endpoint. No more telemetry data will be sent.`),{success:t.ok,fatalError:n}}catch(e){let t=i(e);return this.logger.warn(`[EventReporter] Error attempting to send telemetry data: ${e}`,{error:e}),{success:!1,fatalError:t}}}isStatusFatal(e){return!!e&&e>=400&&e<500&&e!=429}},o=class{aggregate(e){if(e.events.length==0)return[];let t=new Map;for(let n of e.events){let e=JSON.stringify(n),r=t.get(e)?.count||0;t.set(e,{event:n,count:r+1})}return Array.from(t).map(([,t])=>({startTime:e.startTime,endTime:e.endTime,count:t.count,event:t.event}))}},s=class{constructor(e){this._events=[],this._droppedEventCount=0,this.limit=e??1e3}get events(){return this._events}get reachedLimit(){return this._events.length>=this.limit}get droppedEventCount(){return this._droppedEventCount}push(...e){this.startTime||=new Date;let t=Math.max(0,e.length-this.limit),n=e.slice(t,e.length);if(this._droppedEventCount+=t,this._events.length+n.length>this.limit){let e=this._events.length+n.length-this.limit;this._events.splice(0,e),this._droppedEventCount+=e}return this._events.push(...n)}takeSnapshot(){let e=new Date,t=this.startTime??e,n=this._events.splice(0),r=this._droppedEventCount;return this.startTime=void 0,this._droppedEventCount=0,{startTime:t,endTime:e,events:n,droppedCount:r}}clear(){this._events=[],this.startTime=void 0,this._droppedEventCount=0}},c=class{constructor(e){this.aggregator=new o,this.collectEvents=!0,this.started=!1,this.logger=e.logger,this.evaluationEventQueue=new s(e.evaluationQueueLimit??1e3),this.flushIntervalDelay=e.flushIntervalDelay??3e4,this.initialFlushIntervalDelay=e.initialFlushIntervalDelay??5e3}start(){this.started||!this.collectEvents||(this.started=!0,this.flushTimeout=setTimeout(()=>this.flushAndScheduleNext(),this.initialFlushIntervalDelay))}async flushAndScheduleNext(){if(!this.collectEvents)return;let e;try{e=await this.flush()}catch(t){this.logger.warn(`[TelemetryEventCollector] Error flushing telemetry events: `,t),e={success:!1,fatalError:!1}}e.fatalError?(this.collectEvents=!1,this.close(),this.logger.warn(`[TelemetryEventCollector] Received a fatal error from telemetry collection. No longer collecting events.`)):this.collectEvents&&(this.cancelScheduledFlush(),this.flushTimeout=setTimeout(()=>this.flushAndScheduleNext(),this.flushIntervalDelay))}cancelScheduledFlush(){clearTimeout(this.flushTimeout)}async close(){this.collectEvents=!1,clearTimeout(this.flushTimeout);try{await this.flush()}catch(e){this.logger.warn(`[TelemetryEventCollector] Error flushing telemetry events during close: `,e)}this.evaluationEventQueue.clear()}dispose(){this.close()}},l=class{constructor(e){this.valueIdGenerator=e,this.valueIdGenerator=e}async process(t){let n=await Promise.all(t.events.map(async t=>({...t,defaultValue:await e(t.defaultValue,this.valueIdGenerator),evaluatedValue:await e(t.evaluatedValue,this.valueIdGenerator)})));return{...t,events:n}}},u=class 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" })));
+			return new Worker(URL.createObjectURL(new Blob(["(function(){let e=async(e,t)=>e.valueId?{valueId:e.valueId}:e.value?e.value.length<=500&&e.type!=`json`?{value:e.value}:{valueId:await t(e.value)}:e,t=e=>{let t=Object.keys(e);if(t.length==0)return!0;for(let n of t)if((e[n]?.length??0)>0)return!1;return!0},n=e=>{if(!e)return!0;let t=Object.keys(e);if(t.length==0)return!0;for(let n of t)if((e[n]??0)>0)return!1;return!0},r=async(e,t,n,r)=>{let i=new AbortController,a=setTimeout(()=>{r.debug(`[fetchWithTimeout] Reached timeout, aborting request`),i.abort()},e);try{let e=await fetch(typeof t==`string`||t instanceof Request?t:t.toString(),{...n,signal:i.signal});return clearTimeout(a),e}catch(e){throw r.warn(`[fetchWithTimeout] Fetch error: `,e),clearTimeout(a),e}},i=e=>e?.name===`NotAllowedError`?!0:e instanceof TypeError;var a=class{constructor(e){this.executeRequests=!0,this.sdkKey=e.sdkKey,this.logger=e.logger,this.sdkIdentity=e.sdkIdentity,this.metaContext=e.metaContext,this.url=e.urlFactory(`client/telemetry/v1`,e.baseUrl)}async report({context:e,discreteEvents:t,aggregatedEvents:n,droppedEvents:r}){if(!this.executeRequests)return{success:!1,fatalError:!0};let i={clientSdkKey:this.sdkKey,metaContext:{sdkName:this.sdkIdentity.sdkName,sdkVersion:this.sdkIdentity.sdkVersion,appName:this.metaContext.appName,appVersion:this.metaContext.appVersion},context:e,discreteEvents:t,aggregatedEvents:n,droppedEvents:r};if(this.isReportEmpty(i))return{success:!0,fatalError:!1};let a=await this.sendReport(i);return a.fatalError&&(this.executeRequests=!1),a}isReportEmpty(e){return t(e.discreteEvents)&&t(e.aggregatedEvents)&&n(e.droppedEvents)}async sendReport(e){try{let t=await r(5e3,this.url,{method:`POST`,body:JSON.stringify(e),keepalive:!0},this.logger),n=this.isStatusFatal(t.status);return n&&this.logger.warn(`[EventReporter] Received a fatal status response (${t.status}) from the telemetry endpoint. No more telemetry data will be sent.`),{success:t.ok,fatalError:n}}catch(e){let t=i(e);return this.logger.warn(`[EventReporter] Error attempting to send telemetry data: ${e}`,{error:e}),{success:!1,fatalError:t}}}isStatusFatal(e){return!!e&&e>=400&&e<500&&e!=429}},o=class{aggregate(e){if(e.events.length==0)return[];let t=new Map;for(let n of e.events){let e=JSON.stringify(n),r=t.get(e)?.count||0;t.set(e,{event:n,count:r+1})}return Array.from(t).map(([,t])=>({startTime:e.startTime,endTime:e.endTime,count:t.count,event:t.event}))}},s=class{constructor(e){this._events=[],this._droppedEventCount=0,this.limit=e??1e3}get events(){return this._events}get reachedLimit(){return this._events.length>=this.limit}get droppedEventCount(){return this._droppedEventCount}push(...e){this.startTime||=new Date;let t=Math.max(0,e.length-this.limit),n=e.slice(t,e.length);if(this._droppedEventCount+=t,this._events.length+n.length>this.limit){let e=this._events.length+n.length-this.limit;this._events.splice(0,e),this._droppedEventCount+=e}return this._events.push(...n)}takeSnapshot(){let e=new Date,t=this.startTime??e,n=this._events.splice(0),r=this._droppedEventCount;return this.startTime=void 0,this._droppedEventCount=0,{startTime:t,endTime:e,events:n,droppedCount:r}}clear(){this._events=[],this.startTime=void 0,this._droppedEventCount=0}},c=class{constructor(e){this.aggregator=new o,this.collectEvents=!0,this.started=!1,this.logger=e.logger,this.evaluationEventQueue=new s(e.evaluationQueueLimit??1e3),this.flushIntervalDelay=e.flushIntervalDelay??3e4,this.initialFlushIntervalDelay=e.initialFlushIntervalDelay??5e3}start(){this.started||!this.collectEvents||(this.started=!0,this.flushTimeout=setTimeout(()=>this.flushAndScheduleNext(),this.initialFlushIntervalDelay))}async flushAndScheduleNext(){if(!this.collectEvents)return;let e;try{e=await this.flush()}catch(t){this.logger.warn(`[TelemetryEventCollector] Error flushing telemetry events: `,t),e={success:!1,fatalError:!1}}e.fatalError?(this.collectEvents=!1,this.close(),this.logger.warn(`[TelemetryEventCollector] Received a fatal error from telemetry collection. No longer collecting events.`)):this.collectEvents&&(this.cancelScheduledFlush(),this.flushTimeout=setTimeout(()=>this.flushAndScheduleNext(),this.flushIntervalDelay))}cancelScheduledFlush(){clearTimeout(this.flushTimeout)}async close(){this.collectEvents=!1,clearTimeout(this.flushTimeout);try{await this.flush()}catch(e){this.logger.warn(`[TelemetryEventCollector] Error flushing telemetry events during close: `,e)}this.evaluationEventQueue.clear()}dispose(){this.close()}},l=class{constructor(e){this.valueIdGenerator=e,this.valueIdGenerator=e}async process(t){let n=await Promise.all(t.events.map(async t=>({...t,defaultValue:await e(t.defaultValue,this.valueIdGenerator),evaluatedValue:await e(t.evaluatedValue,this.valueIdGenerator)})));return{...t,events:n}}},u=class{constructor(){this.countsByKindSample=new Map,this.countBeyondSampleLimit=0}record(e){return this.startTime??=new Date,this.add(e,1)}absorb(e){for(let t of e)(this.startTime===void 0||t.startTime<this.startTime)&&(this.startTime=t.startTime),this.add(t.event.kindSample,t.count)}add(e,t){if(e!==void 0){let n=this.countsByKindSample.get(e);if(n!==void 0)return this.countsByKindSample.set(e,n+t),`known-kind-sample`;if(this.countsByKindSample.size<20)return this.countsByKindSample.set(e,t),`new-kind-sample`}let n=this.countBeyondSampleLimit===0;return this.countBeyondSampleLimit+=t,n?`first-beyond-sample-limit`:`beyond-sample-limit`}takeSnapshot(){let e=new Date,t=this.startTime??e,n=(n,r)=>({startTime:t,endTime:e,count:n,event:{reason:`invalid-context-kind`,kindSample:r}}),r=Array.from(this.countsByKindSample,([e,t])=>n(t,e)),i=this.countBeyondSampleLimit>0?[...r,n(this.countBeyondSampleLimit)]:r;return this.clear(),i}clear(){this.countsByKindSample.clear(),this.countBeyondSampleLimit=0,this.startTime=void 0}},d=class extends c{constructor(e){super(e),this.invalidContextSubmissions=new u,this.reporter=new a(e),this.evaluationEventSnapshotPreprocessor=new l(e.valueIdGenerator)}async updateContext(e){this.cancelScheduledFlush(),await this.flush(),this._context=e,await this.flushAndScheduleNext()}evaluatedConfig(e){this.collectEvents&&this.evaluationEventQueue.push(e)}recordInvalidContext(e){this.invalidContextSubmissions.record(e)}absorbInvalidContextSubmissions(e){this.invalidContextSubmissions.absorb(e)}async forceFlush(){this.cancelScheduledFlush(),await this.flushAndScheduleNext()}async flush(){if(!this.reporter)return{success:!1,fatalError:!1};let e=await this.evaluationEventSnapshotPreprocessor.process(this.evaluationEventQueue.takeSnapshot());return await this.reporter?.report({context:this._context,discreteEvents:{},aggregatedEvents:{evaluatedConfig:this.aggregator.aggregate(e),invalidContext:this.invalidContextSubmissions.takeSnapshot()},droppedEvents:{evaluatedConfig:e.droppedCount}})}};let f=(e,t)=>new URL(e,t?.toString()),p=(e,t)=>{let n=BigInt(0),r=BigInt(62),i=Array.from(e).map(e=>e.toString(16).padStart(2,`0`)).join(``),a=BigInt(`0x`+i),o=``;for(;a>n;)o=`0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz`[Number(a%r)]+o,a/=r;return o.padStart(t,`0`)},m=Math.ceil(128/Math.log2(62)),h=new TextEncoder,g=async e=>{if(typeof crypto>`u`||crypto.subtle==null)return;let t=await crypto.subtle.digest(`SHA-256`,h.encode(e?.toString()??``));return p(new Uint8Array(t,0,16),m)},_,v=(e,t,...n)=>({type:`Log`,payload:{level:e,message:t,args:n}}),y=e=>{try{self.postMessage(e)}catch{self.postMessage(v(e.payload.level,e.payload.message))}},b={debug:function(e,...t){y(v(`debug`,e,t))},info:function(e,...t){y(v(`info`,e,t))},warn:function(e,...t){y(v(`warn`,e,t))},error:function(e,...t){y(v(`error`,e,t))}};addEventListener(`message`,e=>{let t=e.data;if(t.type!=`Initialize`&&!_){b.info(`[TelemetryWorker] Ignoring ${t.type} because no collector is configured`);return}switch(b.debug(`[TelemetryWorker] Received '${t.type}' event:`,t),t.type){case`Initialize`:if(_){b.warn(`[TelemetryWorker] Received a duplicate Initialize event, ignoring it`);break}_=new d({...t.payload,baseUrl:f(t.payload.baseUrl),urlFactory:f,valueIdGenerator:g,logger:b}),_.start();break;case`EvaluatedConfigEvent`:_?.evaluatedConfig(t.payload);break;case`InvalidContextSubmissions`:_?.absorbInvalidContextSubmissions(t.payload.entries);break;case`UpdateContext`:_?.updateContext(t.payload.context);break;case`Flush`:_?.forceFlush();break;case`Close`:(_?.close()??Promise.resolve()).then(()=>{self.postMessage({type:`Closed`}),self.close()});break}})})();"], { type: "application/javascript" })));
 		} catch (error) {
 			this.turnOff("[WebWorkerTelemetryClient] Telemetry is off because the telemetry Web Worker could not be created: ", error);
 			return;
@@ -1364,8 +1529,19 @@ var WebWorkerTelemetryClient = class {
 		}
 		for (const evaluation of this.pendingEvaluations) worker.postMessage(evaluation);
 		this.pendingEvaluations.length = 0;
+		this.forwardInvalidContextSubmissions(worker);
 		return worker;
 	}
+	forwardInvalidContextSubmissions(worker) {
+		if (!worker) return;
+		const entries = this.pendingInvalidContextSubmissions.takeSnapshot();
+		if (entries.length === 0) return;
+		const submissionsMessage = {
+			type: "InvalidContextSubmissions",
+			payload: { entries }
+		};
+		worker.postMessage(submissionsMessage);
+	}
 	async updateContext(value) {
 		if (this.closePromise) return;
 		const updateContextMessage = {
@@ -1387,6 +1563,10 @@ var WebWorkerTelemetryClient = class {
 		if (this.pendingEvaluations.length >= this.pendingEvaluationLimit) this.pendingEvaluations.shift();
 		this.pendingEvaluations.push(evaluatedConfigMessage);
 	}
+	recordInvalidContext(kindSample) {
+		this.pendingInvalidContextSubmissions.record(kindSample);
+		this.forwardInvalidContextSubmissions(this.worker);
+	}
 	sanitizeEvaluatedConfigEvent(event) {
 		return {
 			...event,
@@ -1555,7 +1735,7 @@ const useConfigDirectorContext = () => {
 		const rawContext = toRaw(context);
 		const oldContext = JSON.stringify(state.value);
 		const newContext = JSON.stringify(rawContext);
-		state.value = rawContext;
+		state.value = admittedContextOrNone(rawContext);
 		if (oldContext != newContext) {
 			const timeout = getEffectiveTimeout(options?.timeoutMilliseconds);
 			let timer;
@@ -1617,7 +1797,7 @@ const buildClient = (configdirector, logger) => {
 	const { clientSdkKey, appName, appVersion, baseUrl, connection } = configdirector;
 	return createBrowserClient(clientSdkKey, {
 		sdkName: "nuxt-sdk",
-		sdkVersion: "1.9.2"
+		sdkVersion: "1.10.0"
 	}, {
 		metadata: {
 			appName,

package/dist/runtime/plugin.server.mjs

@@ -14,6 +14,50 @@ const useConfigDirectorClient = () => {
 	return { client: $configDirectorClient };
 };
 //#endregion
+//#region ../shared/src/context-kind.ts
+const CONTEXT_KIND_MAXIMUM_LENGTH = 64;
+const KIND_SAMPLE_MAXIMUM_CHARACTERS = 128;
+const isContextKindCharacter = (character) => character >= "a" && character <= "z" || character >= "0" && character <= "9" || character === "-" || character === "_";
+const isValidContextKind = (kind) => {
+	if (kind.length < 1 || kind.length > CONTEXT_KIND_MAXIMUM_LENGTH) return false;
+	for (const character of kind) if (!isContextKindCharacter(character)) return false;
+	return true;
+};
+const isAcceptedKind = (kind) => kind === void 0 || kind === null || typeof kind === "string" && isValidContextKind(kind);
+const stringFormOf = (kind) => {
+	if (typeof kind === "string") return kind;
+	try {
+		return String(kind);
+	} catch {
+		return Object.prototype.toString.call(kind);
+	}
+};
+const firstCharactersOf = (text, maximumCharacters) => {
+	let sample = "";
+	let characterCount = 0;
+	for (const character of text) {
+		if (characterCount === maximumCharacters) break;
+		sample += character;
+		characterCount += 1;
+	}
+	return sample;
+};
+const admittedContextOrNone = (context) => {
+	const admission = admitContext(context);
+	return admission.outcome === "admitted" ? admission.context : void 0;
+};
+const admitContext = (context) => {
+	const kind = context?.kind;
+	if (isAcceptedKind(kind)) return {
+		outcome: "admitted",
+		context
+	};
+	return {
+		outcome: "ignored",
+		kindSample: firstCharactersOf(stringFormOf(kind), KIND_SAMPLE_MAXIMUM_CHARACTERS)
+	};
+};
+//#endregion
 //#region src/runtime/app/composables/useConfigDirectorContext.ts
 const DEFAULT_TIMEOUT = 3e3;
 const getEffectiveTimeout = (option) => {
@@ -26,7 +70,7 @@ const useConfigDirectorContext = () => {
 		const rawContext = toRaw(context);
 		const oldContext = JSON.stringify(state.value);
 		const newContext = JSON.stringify(rawContext);
-		state.value = rawContext;
+		state.value = admittedContextOrNone(rawContext);
 		if (oldContext != newContext) {
 			const timeout = getEffectiveTimeout(options?.timeoutMilliseconds);
 			let timer;
@@ -65,19 +109,19 @@ var plugin_server_default = defineNuxtPlugin((nuxtApp) => {
 	} };
 });
 var SsrClient = class {
-	currentContext;
+	suppliedContext;
 	constructor(serverClient) {
 		this.serverClient = serverClient;
 		this.serverClient = serverClient;
 	}
 	async initialize(context) {
-		this.currentContext = context;
+		this.suppliedContext = context;
 	}
 	async updateContext(context) {
-		this.currentContext = context;
+		this.suppliedContext = context;
 	}
 	get context() {
-		return this.currentContext;
+		return admittedContextOrNone(this.suppliedContext);
 	}
 	get isReady() {
 		return this.serverClient.isReady;
@@ -86,7 +130,7 @@ var SsrClient = class {
 		return false;
 	}
 	getValue(configKey, defaultValue) {
-		return this.serverClient.getValue(configKey, defaultValue, this.currentContext);
+		return this.serverClient.getValue(configKey, defaultValue, this.suppliedContext);
 	}
 	watch() {
 		return () => {};

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

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

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

@@ -1,4 +1,4 @@
-import { i as ConfigValueType, n as ConfigEvaluation, r as ConfigState, t as ConfigDirectorContext } from "./types-CHmsCChN.mjs";
+import { i as ConfigValueType, n as ConfigEvaluation, r as ConfigState, t as ConfigDirectorContext } from "./types-IPLvRsUO.mjs";
 
 //#region ../js-server-sdk/src/types.d.ts
 type ClientEvents = {

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

@@ -1,4 +1,4 @@
-import { i as ConfigValueType, n as ConfigEvaluation, t as ConfigDirectorContext } from "./types-CHmsCChN.mjs";
+import { i as ConfigValueType, n as ConfigEvaluation, t as ConfigDirectorContext } from "./types-IPLvRsUO.mjs";
 
 //#region ../js-client-core/src/Emitter.d.ts
 type EventType = string | symbol;
@@ -60,17 +60,25 @@ interface ConfigDirectorClient extends EventProvider<ClientEvents> {
    * not attempt to re-connect and an error will be logged to the console or the provided
    * logger.
    *
-   * @param context The current user's context to be used for evaluating targeting rules (optional).
+   * A context whose {@link ConfigDirectorContext.kind} is invalid is ignored as a whole: an error is
+   * logged, and the client connects as if no context had been provided.
+   *
+   * @param context The current context to be used for evaluating targeting rules (optional).
    */
   initialize(context?: ConfigDirectorContext): Promise<void>;
   /**
-   * Updates the user's context and re-evaluates all config and flag values based on the new context.
+   * Updates the context and re-evaluates all config and flag values based on the new context.
+   *
+   * A context whose {@link ConfigDirectorContext.kind} is invalid is ignored as a whole: an error is
+   * logged, the previous context is no longer used, and the client connects as if no context had been
+   * provided.
    *
-   * @param context The current user's context to be used for evaluating targeting rules (required).
+   * @param context The current context to be used for evaluating targeting rules (required).
    */
   updateContext(context: ConfigDirectorContext): Promise<void>;
   /**
-   * Returns the current context the client is configured with, or undefined if there is no context.
+   * Returns the current context the client is configured with, or undefined if there is no context,
+   * including after a context with an invalid kind was ignored.
    *
    * Note that the value returned does not updated immediately after calling {@link updateContext}. Only
    * once the underlying connection was successful or timed out, the current context is updated. This is