@configdirector/nuxt-sdk 1.9.2 → 1.11.0

package/dist/testing.mjs

@@ -49,6 +49,13 @@ var ConfigDirectorValidationError = class ConfigDirectorValidationError extends
 		Object.setPrototypeOf(this, ConfigDirectorValidationError.prototype);
 	}
 };
+var ConfigDirectorInitializationError = class ConfigDirectorInitializationError extends Error {
+	name = "ConfigDirectorInitializationError";
+	constructor(message) {
+		super(message);
+		Object.setPrototypeOf(this, ConfigDirectorInitializationError.prototype);
+	}
+};
 //#endregion
 //#region ../eventsource/src/errors.ts
 var StreamClosedError = class StreamClosedError extends Error {
@@ -383,6 +390,7 @@ var StreamingTransport = class {
 	eventEmitter = new Emitter();
 	url;
 	timeoutTimer;
+	connectionGeneration = 0;
 	constructor(options) {
 		this.options = options;
 		this.options = options;
@@ -390,6 +398,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({
@@ -401,7 +412,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);
@@ -466,6 +478,7 @@ var StreamingTransport = class {
 		this.eventEmitter.clear();
 	}
 	close() {
+		this.connectionGeneration++;
 		this.eventSource?.close();
 		clearTimeout(this.timeoutTimer);
 	}
@@ -475,6 +488,183 @@ var StreamingTransport = class {
 	}
 };
 //#endregion
+//#region ../shared/src/native-values.ts
+const encodeNativeValue = (key, value) => {
+	if (key.trim().length == 0) throw new ConfigDirectorValidationError("Invalid config key. The key of a value cannot be empty.");
+	return encode(key, value);
+};
+const encode = (key, value) => {
+	switch (typeof value) {
+		case "boolean": return {
+			type: "boolean",
+			value: value ? "true" : "false"
+		};
+		case "number": return encodeNumber(key, value);
+		case "string": return {
+			type: "string",
+			value
+		};
+		case "object": if (value !== null) {
+			assertJsonContents(key, value, "");
+			return {
+				type: "json",
+				value: JSON.stringify(value)
+			};
+		}
+	}
+	throw new ConfigDirectorValidationError(`Invalid value for '${key}': ${describe(value)}. Use a boolean, a number, a string, a plain object, or an array.`);
+};
+const encodeNumber = (key, value) => {
+	if (!Number.isFinite(value)) throw new ConfigDirectorValidationError(`Invalid value for '${key}': ${describe(value)} is not a finite number.`);
+	if (Number.isInteger(value)) {
+		if (!Number.isSafeInteger(value)) throw new ConfigDirectorValidationError(`Invalid value for '${key}': ${value} is not a safe integer, so the SDK could not read it back exactly.`);
+		return {
+			type: "integer",
+			value: String(value)
+		};
+	}
+	return {
+		type: "float",
+		value: toPlainDecimal(value)
+	};
+};
+const toPlainDecimal = (value) => {
+	const text = String(value);
+	const exponentIndex = text.indexOf("e-");
+	if (exponentIndex < 0) return text;
+	const sign = text.startsWith("-") ? "-" : "";
+	const [integerDigits = "", fractionDigits = ""] = text.slice(sign.length, exponentIndex).split(".");
+	const leadingZeros = Number(text.slice(exponentIndex + 2)) - integerDigits.length;
+	return `${sign}0.${"0".repeat(leadingZeros)}${integerDigits}${fractionDigits}`;
+};
+const assertJsonContents = (key, value, path) => {
+	if (value === null || typeof value === "boolean" || typeof value === "string") return;
+	if (typeof value === "number") {
+		if (!Number.isFinite(value)) throw invalidJsonContents(key, path, `${describe(value)} is not a finite number`);
+		return;
+	}
+	if (Array.isArray(value)) {
+		value.forEach((item, index) => assertJsonContents(key, item, `${path}[${index}]`));
+		return;
+	}
+	if (isPlainObject(value)) {
+		for (const [property, item] of Object.entries(value)) assertJsonContents(key, item, path ? `${path}.${property}` : property);
+		return;
+	}
+	throw invalidJsonContents(key, path, `${describe(value)} cannot be encoded as JSON`);
+};
+const invalidJsonContents = (key, path, problem) => new ConfigDirectorValidationError(`Invalid value for '${key}'${path ? ` at '${path}'` : ""}: ${problem}. JSON contents can hold booleans, finite numbers, strings, null, arrays, and plain objects.`);
+const isPlainObject = (value) => {
+	if (typeof value !== "object" || value === null) return false;
+	const prototype = Object.getPrototypeOf(value);
+	return prototype === Object.prototype || prototype === null;
+};
+const describe = (value) => {
+	if (value === null) return "null";
+	if (typeof value === "function") return "a function";
+	if (typeof value === "object") return `a ${value.constructor?.name ?? "object"} instance`;
+	if (typeof value === "symbol") return "a symbol";
+	return String(value);
+};
+//#endregion
+//#region ../js-client-core/src/native-values.ts
+const nativeValueConfigState = (id, key, value, valueId) => {
+	const encoded = encodeNativeValue(key, value);
+	return {
+		id,
+		key,
+		type: encoded.type,
+		value: encoded.value,
+		valueId
+	};
+};
+//#endregion
+//#region ../js-client-core/src/OfflineTransport.ts
+const OFFLINE_ENVIRONMENT = {
+	environmentId: "offline",
+	projectId: "offline"
+};
+var OfflineTransport = class {
+	emitter = new Emitter();
+	constructor(source) {
+		this.source = source;
+	}
+	async connect() {
+		const configs = loadOfflineConfigs(this.source);
+		this.emitter.emit("configSetReceived", {
+			...OFFLINE_ENVIRONMENT,
+			kind: "full",
+			configs
+		});
+		return this;
+	}
+	on = (name, handler) => this.emitter.on(name, handler);
+	off = (name, handler) => this.emitter.off(name, handler);
+	clear() {
+		this.emitter.clear();
+	}
+	close() {}
+	dispose() {
+		this.clear();
+	}
+};
+const loadOfflineConfigs = (source) => {
+	switch (source.kind) {
+		case "in-code-defaults": return {};
+		case "values": return encodeOfflineValues(source.values);
+		case "rejected": throw new ConfigDirectorInitializationError(source.message);
+	}
+};
+const encodeOfflineValues = (values) => {
+	try {
+		return Object.fromEntries(Object.entries(values).map(([key, value]) => [key, nativeValueConfigState(`offline:${key}`, key, value, void 0)]));
+	} catch (error) {
+		if (error instanceof ConfigDirectorValidationError) throw new ConfigDirectorInitializationError(`The offline values could not be loaded. ${error.message}`);
+		throw error;
+	}
+};
+//#endregion
+//#region ../shared/src/constants.ts
+const CLIENT_BASE_URL = "https://client-sdk-api.configdirector.com";
+//#endregion
+//#region ../js-client-core/src/connection-plan.ts
+const planConnection = (clientSdkKey, connection, urlFactory) => {
+	if (connection?.mode === "offline") return {
+		kind: "stay-offline",
+		source: offlineSourceOf(connection)
+	};
+	const mode = connection?.mode ?? "streaming";
+	if (!clientSdkKey || clientSdkKey.trim().length == 0) throw new ConfigDirectorValidationError("No client SDK key was provided, the client cannot be instantiated without a valid client SDK key");
+	if (connection?.values !== void 0) return {
+		kind: "stay-offline",
+		source: {
+			kind: "rejected",
+			message: `The connection option 'values' applies only when the connection mode is 'offline', but the mode is '${mode}'.`
+		}
+	};
+	return {
+		kind: "connect",
+		mode,
+		clientSdkKey,
+		baseUrl: baseUrlOf(connection?.url, urlFactory)
+	};
+};
+const baseUrlOf = (url, urlFactory) => {
+	if (!url) return CLIENT_BASE_URL;
+	try {
+		return urlFactory(url);
+	} catch (error) {
+		throw new ConfigDirectorValidationError(`Invalid base URL '${url}'. Parsing failed: ${error}`);
+	}
+};
+const offlineSourceOf = (connection) => {
+	if (connection.values !== void 0) return {
+		kind: "values",
+		values: connection.values
+	};
+	return { kind: "in-code-defaults" };
+};
+//#endregion
 //#region ../shared/src/value-parser.ts
 const getRequestedType = (defaultValue) => {
 	const baseType = typeof defaultValue;
@@ -694,6 +884,14 @@ const createDefaultLogger = (level, messageDecorator) => {
 	return new DefaultConsoleLogger(level ?? "warn", messageDecorator ?? new LogMessageDecorator());
 };
 //#endregion
+//#region ../js-client-core/src/telemetry/discarding.ts
+const discardingTelemetryClient = {
+	updateContext: async () => {},
+	evaluatedConfig: () => {},
+	recordInvalidContext: () => {},
+	close: async () => {}
+};
+//#endregion
 //#region ../shared/src/url.ts
 const defaultUrlFactory = (input, base) => new URL(input, base?.toString());
 //#endregion
@@ -722,10 +920,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) => {
@@ -741,7 +940,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 {
@@ -756,34 +955,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,
@@ -792,19 +994,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
@@ -885,6 +1122,7 @@ var PollingTransport = class extends AbstractPollingTransport {
 	eventEmitter = new Emitter();
 	url;
 	lastUpdateTimestamp;
+	connectionGeneration = 0;
 	constructor(options) {
 		super();
 		this.options = options;
@@ -894,19 +1132,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;
@@ -919,7 +1164,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);
@@ -960,9 +1206,49 @@ 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 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 {
+var DefaultConfigDirectorClient = class DefaultConfigDirectorClient {
 	logger;
 	telemetryClient;
 	configSet;
@@ -977,18 +1263,20 @@ var DefaultConfigDirectorClient = class {
 	readyPromise;
 	readyResolve;
 	currentContext;
-	connectionMode;
-	instanceId;
-	constructor(telemetryClient, clientSdkKey, sdkOptions, clientOptions, internalClientOptions) {
+	connectionPlan;
+	clientSession;
+	static from(liveTelemetryClient, clientSdkKeyOrOptions, sdkOptions, clientOptions) {
+		if (typeof clientSdkKeyOrOptions === "object") return new DefaultConfigDirectorClient(liveTelemetryClient, void 0, sdkOptions, clientSdkKeyOrOptions);
+		return new DefaultConfigDirectorClient(liveTelemetryClient, clientSdkKeyOrOptions, sdkOptions, clientOptions);
+	}
+	constructor(liveTelemetryClient, clientSdkKey, sdkOptions, clientOptions, internalClientOptions) {
 		this.logger = clientOptions?.logger ?? createDefaultLogger();
-		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;
-		const baseUrl = this.parseUrl(clientOptions?.connection?.url, urlFactory) ?? "https://client-sdk-api.configdirector.com";
-		this.connectionMode = clientOptions?.connection?.mode ?? "streaming";
-		this.telemetryClient = telemetryClient;
-		this.transport = internalClientOptions?.transport ?? this.buildTransport(clientSdkKey, sdkOptions, baseUrl, urlFactory, clientOptions, internalClientOptions);
+		this.connectionPlan = planConnection(clientSdkKey, clientOptions?.connection, urlFactory);
+		this.telemetryClient = this.buildTelemetryClient(liveTelemetryClient, clientOptions);
+		this.transport = internalClientOptions?.transport ?? this.buildTransport(sdkOptions, clientOptions, urlFactory, internalClientOptions);
 		this.transport.on("configSetReceived", (configSet) => {
 			this.hasReceivedConfigSet = true;
 			this.readyResolve?.();
@@ -1025,8 +1313,8 @@ 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;
+	pollingIntervalFor(mode, configuredSeconds) {
+		if (mode !== "polling") return;
 		const resolved = resolvePollingInterval(configuredSeconds, {
 			defaultSeconds: 60,
 			minimumSeconds: 30
@@ -1034,39 +1322,79 @@ var DefaultConfigDirectorClient = class {
 		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)
-		});
+	buildTelemetryClient(liveTelemetryClient, clientOptions) {
+		const plan = this.connectionPlan;
+		switch (plan.kind) {
+			case "stay-offline": return discardingTelemetryClient;
+			case "connect": return liveTelemetryClient({
+				clientSdkKey: plan.clientSdkKey,
+				baseUrl: plan.baseUrl,
+				logger: this.logger,
+				metadata: clientOptions?.metadata
+			});
+		}
 	}
-	getTransportConstructor(connectionMode) {
-		switch (connectionMode) {
+	buildTransport(sdkOptions, clientOptions, urlFactory, internalClientOptions) {
+		const plan = this.connectionPlan;
+		switch (plan.kind) {
+			case "stay-offline": return new OfflineTransport(plan.source);
+			case "connect": return new (this.getTransportConstructor(plan.mode))({
+				clientSession: this.clientSession,
+				clientSdkKey: plan.clientSdkKey,
+				baseUrl: plan.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.pollingIntervalFor(plan.mode, clientOptions?.connection?.pollingInterval)
+			});
+		}
+	}
+	getTransportConstructor(mode) {
+		switch (mode) {
 			case "polling": return PollingTransport;
-			default: return StreamingTransport;
+			case "streaming": return StreamingTransport;
 		}
 	}
 	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");
+		switch (this.connectionPlan.kind) {
+			case "connect":
+				await this.submitContext(context, "context update");
+				return;
+			case "stay-offline":
+				this.storeContext(this.admittedContextFor(context, "context update"));
+				return;
+		}
+	}
+	storeContext(context) {
+		this.currentContext = context;
+		this.emit("contextUpdated", { context });
+	}
+	async submitContext(context, submission) {
+		await this.connectToTransport(this.admittedContextFor(context, submission), submission);
+	}
+	admittedContextFor(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; continuing 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;
@@ -1095,11 +1423,21 @@ var DefaultConfigDirectorClient = class {
 			if (remainingTimeout > 0) await Promise.race([this.readyPromise, new Promise((resolve) => {
 				this.timeoutTimer = setTimeout(() => resolve(), remainingTimeout);
 			})]).finally(() => clearTimeout(this.timeoutTimer));
-			if (!this.ready) this.logger.warn(`[ConfigDirectorClient] Timed out waiting for ${caller} after ${this.timeout}ms. The client will continue to retry since there were no fatal errors detected. Configs will return the default value until the connection succeeds.`);
+			if (!this.ready) this.logger.warn(`[ConfigDirectorClient] Timed out waiting for ${caller} after ${this.timeout}ms. ${this.timeoutWarningDetails()}`);
 		} catch (error) {
+			if (error instanceof ConfigDirectorInitializationError) {
+				this.initializing = false;
+				throw error;
+			}
 			this.logger.error(`[ConfigDirectorClient] An error occurred during ${caller}: `, error);
 		}
 	}
+	timeoutWarningDetails() {
+		switch (this.connectionPlan.kind) {
+			case "connect": return "The client will continue to retry since there were no fatal errors detected. Configs will return the default value until the connection succeeds.";
+			case "stay-offline": return "The offline values were not delivered, so configs return the default value.";
+		}
+	}
 	findKeysRemovedBy(configSet) {
 		if (!this.configSet || configSet.kind != "full") return [];
 		return Object.keys(this.configSet.configs).filter((key) => !Object.prototype.hasOwnProperty.call(configSet.configs, key));
@@ -1194,17 +1532,6 @@ var DefaultConfigDirectorClient = class {
 			this.logger.error(`[ConfigDirectorClient] Error executing event handlers for '${name}'`, error);
 		}
 	}
-	parseUrl(url, urlFactory) {
-		if (!url) return;
-		try {
-			return urlFactory(url);
-		} catch (error) {
-			throw new ConfigDirectorValidationError(`Invalid base URL '${url}'. Parsing failed: ${error}`);
-		}
-	}
-	validateSdkKeyPresence(sdkKey) {
-		if (!sdkKey || sdkKey.trim().length == 0) throw new ConfigDirectorValidationError("No client SDK key was provided, the client cannot be instantiated without a valid client SDK key");
-	}
 	validateDefaultValue(defaultValue) {
 		if (defaultValue === void 0 || defaultValue === null) throw new ConfigDirectorValidationError("Invalid default value. The default value for a config must be defined and non-null.");
 		if (typeof defaultValue === "function") throw new ConfigDirectorValidationError("Invalid default value. The default value for a config cannot be a function.");
@@ -1230,14 +1557,24 @@ var DefaultConfigDirectorClient = class {
 		this.handlersMap.clear();
 	}
 	pauseNetwork() {
-		this.logger.debug("[ConfigDirectorClient] pauseNetwork() called, pausing transport connection");
-		clearTimeout(this.timeoutTimer);
-		this.timeoutTimer = void 0;
-		this.transport.close();
-		this.ready = false;
+		switch (this.connectionPlan.kind) {
+			case "stay-offline": return;
+			case "connect":
+				this.logger.debug("[ConfigDirectorClient] pauseNetwork() called, pausing transport connection");
+				clearTimeout(this.timeoutTimer);
+				this.timeoutTimer = void 0;
+				this.transport.close();
+				this.ready = false;
+				return;
+		}
 	}
 	async resumeNetwork() {
-		await this.connectToTransport(this.currentContext, "network resume");
+		switch (this.connectionPlan.kind) {
+			case "stay-offline": return;
+			case "connect":
+				await this.connectToTransport(this.currentContext, "network resume");
+				return;
+		}
 	}
 	async close() {
 		this.logger.debug("[ConfigDirectorClient] close() has been called, closing connection to server");
@@ -1254,97 +1591,6 @@ var DefaultConfigDirectorClient = class {
 	}
 };
 //#endregion
-//#region ../shared/src/testing/values.ts
-const encodeTestValue$1 = (key, value) => {
-	if (key.trim().length == 0) throw new ConfigDirectorValidationError("Invalid config key. The key of a test value cannot be empty.");
-	return encode(key, value);
-};
-const encode = (key, value) => {
-	switch (typeof value) {
-		case "boolean": return {
-			type: "boolean",
-			value: value ? "true" : "false"
-		};
-		case "number": return encodeNumber(key, value);
-		case "string": return {
-			type: "string",
-			value
-		};
-		case "object": if (value !== null) {
-			assertJsonContents(key, value, "");
-			return {
-				type: "json",
-				value: JSON.stringify(value)
-			};
-		}
-	}
-	throw new ConfigDirectorValidationError(`Invalid test value for '${key}': ${describe(value)}. Use a boolean, a number, a string, a plain object, or an array.`);
-};
-const encodeNumber = (key, value) => {
-	if (!Number.isFinite(value)) throw new ConfigDirectorValidationError(`Invalid test value for '${key}': ${describe(value)} is not a finite number.`);
-	if (Number.isInteger(value)) {
-		if (!Number.isSafeInteger(value)) throw new ConfigDirectorValidationError(`Invalid test value for '${key}': ${value} is not a safe integer, so the SDK could not read it back exactly.`);
-		return {
-			type: "integer",
-			value: String(value)
-		};
-	}
-	return {
-		type: "float",
-		value: toPlainDecimal(value)
-	};
-};
-const toPlainDecimal = (value) => {
-	const text = String(value);
-	const exponentIndex = text.indexOf("e-");
-	if (exponentIndex < 0) return text;
-	const sign = text.startsWith("-") ? "-" : "";
-	const [integerDigits = "", fractionDigits = ""] = text.slice(sign.length, exponentIndex).split(".");
-	const leadingZeros = Number(text.slice(exponentIndex + 2)) - integerDigits.length;
-	return `${sign}0.${"0".repeat(leadingZeros)}${integerDigits}${fractionDigits}`;
-};
-const assertJsonContents = (key, value, path) => {
-	if (value === null || typeof value === "boolean" || typeof value === "string") return;
-	if (typeof value === "number") {
-		if (!Number.isFinite(value)) throw invalidJsonContents(key, path, `${describe(value)} is not a finite number`);
-		return;
-	}
-	if (Array.isArray(value)) {
-		value.forEach((item, index) => assertJsonContents(key, item, `${path}[${index}]`));
-		return;
-	}
-	if (isPlainObject(value)) {
-		for (const [property, item] of Object.entries(value)) assertJsonContents(key, item, path ? `${path}.${property}` : property);
-		return;
-	}
-	throw invalidJsonContents(key, path, `${describe(value)} cannot be encoded as JSON`);
-};
-const invalidJsonContents = (key, path, problem) => new ConfigDirectorValidationError(`Invalid test value for '${key}'${path ? ` at '${path}'` : ""}: ${problem}. JSON contents can hold booleans, finite numbers, strings, null, arrays, and plain objects.`);
-const isPlainObject = (value) => {
-	if (typeof value !== "object" || value === null) return false;
-	const prototype = Object.getPrototypeOf(value);
-	return prototype === Object.prototype || prototype === null;
-};
-const describe = (value) => {
-	if (value === null) return "null";
-	if (typeof value === "function") return "a function";
-	if (typeof value === "object") return `a ${value.constructor?.name ?? "object"} instance`;
-	if (typeof value === "symbol") return "a symbol";
-	return String(value);
-};
-//#endregion
-//#region ../js-client-core/src/testing/values.ts
-const encodeTestValue = (key, value, revision) => {
-	const encoded = encodeTestValue$1(key, value);
-	return {
-		id: `test-config:${key}`,
-		key,
-		type: encoded.type,
-		value: encoded.value,
-		valueId: `test-value:${key}:${revision}`
-	};
-};
-//#endregion
 //#region ../js-client-core/src/testing/InMemoryConnection.ts
 const TEST_ENVIRONMENT = {
 	environmentId: "test-environment",
@@ -1379,7 +1625,7 @@ var InMemoryConnection = class {
 		return [...this.recordedContexts];
 	}
 	setValue(key, value) {
-		const configState = encodeTestValue(key, value, ++this.revision);
+		const configState = this.encode(key, value);
 		this.configs.set(key, configState);
 		this.deliverIfConnected({
 			...TEST_ENVIRONMENT,
@@ -1524,18 +1770,16 @@ var InMemoryConnection = class {
 	}
 	encodeAll(values) {
 		const encoded = /* @__PURE__ */ new Map();
-		for (const [key, value] of Object.entries(values)) encoded.set(key, encodeTestValue(key, value, ++this.revision));
+		for (const [key, value] of Object.entries(values)) encoded.set(key, this.encode(key, value));
 		return encoded;
 	}
+	encode(key, value) {
+		return nativeValueConfigState(`test-config:${key}`, key, value, `test-value:${key}:${++this.revision}`);
+	}
 };
 //#endregion
 //#region ../js-client-core/src/testing/TestClient.ts
 const TEST_CLIENT_SDK_KEY = "test-client";
-const noopTelemetryClient = {
-	updateContext: async () => {},
-	evaluatedConfig: () => {},
-	close: async () => {}
-};
 var InMemoryTestClient = class {
 	constructor(client, connection) {
 		this.client = client;
@@ -1575,7 +1819,7 @@ var InMemoryTestClient = class {
 const createTestClient$1 = (sdkOptions, options) => {
 	const logger = options?.logger ?? createDefaultLogger();
 	const connection = new InMemoryConnection(logger, options?.values ?? {});
-	return new InMemoryTestClient(new DefaultConfigDirectorClient(noopTelemetryClient, TEST_CLIENT_SDK_KEY, sdkOptions, {
+	return new InMemoryTestClient(new DefaultConfigDirectorClient(() => discardingTelemetryClient, TEST_CLIENT_SDK_KEY, sdkOptions, {
 		logger,
 		connection: { timeout: options?.timeout }
 	}, { transport: connection }), connection);
@@ -1638,7 +1882,7 @@ const installTestClient = (testClient) => {
 const createTestClient = (options) => {
 	return createTestClient$1({
 		sdkName: "nuxt-sdk",
-		sdkVersion: "1.9.2"
+		sdkVersion: "1.11.0"
 	}, options);
 };
 //#endregion