@configdirector/nuxt-sdk 1.10.0 → 1.11.1

package/dist/runtime/plugin.client.mjs

@@ -491,6 +491,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$1(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$1 = (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;
@@ -710,16 +887,16 @@ const createDefaultLogger$1 = (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());
-const parseUrl = (url) => {
-	if (!url) return;
-	try {
-		return new URL(url);
-	} catch (error) {
-		throw new ConfigDirectorValidationError(`Invalid URL '${url}'. Parsing failed: ${error}`);
-	}
-};
 //#endregion
 //#region ../shared/src/transport/pollingInterval.ts
 const resolvePollingInterval = (configuredSeconds, defaults) => {
@@ -1078,7 +1255,7 @@ const admitContext = (context) => {
 //#endregion
 //#region ../js-client-core/src/DefaultConfigDirectorClient.ts
 const MAX_EXPONENTIAL_DELAY = 9;
-var DefaultConfigDirectorClient = class {
+var DefaultConfigDirectorClient = class DefaultConfigDirectorClient {
 	logger;
 	telemetryClient;
 	configSet;
@@ -1093,18 +1270,20 @@ var DefaultConfigDirectorClient = class {
 	readyPromise;
 	readyResolve;
 	currentContext;
-	connectionMode;
+	connectionPlan;
 	clientSession;
-	constructor(telemetryClient, clientSdkKey, sdkOptions, clientOptions, internalClientOptions) {
+	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$1();
 		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?.();
@@ -1141,8 +1320,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
@@ -1150,31 +1329,47 @@ 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))({
-			clientSession: this.clientSession,
-			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
+			});
+		}
+	}
+	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(connectionMode) {
-		switch (connectionMode) {
+	getTransportConstructor(mode) {
+		switch (mode) {
 			case "polling": return PollingTransport;
-			default: return StreamingTransport;
+			case "streaming": return StreamingTransport;
 		}
 	}
 	async initialize(context) {
@@ -1182,17 +1377,28 @@ var DefaultConfigDirectorClient = class {
 		await this.submitContext(context, "initialization");
 	}
 	async updateContext(context) {
-		await this.submitContext(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.contextToConnectWith(context, submission), submission);
+		await this.connectToTransport(this.admittedContextFor(context, submission), submission);
 	}
-	contextToConnectWith(suppliedContext, 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; connecting as if no context was supplied. A context kind has 1 to 64 characters, using only lowercase letters, digits, '-' and '_'.`);
+				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;
 		}
@@ -1224,11 +1430,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));
@@ -1323,17 +1539,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.");
@@ -1359,14 +1564,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");
@@ -1665,27 +1880,28 @@ const generateValueId = async (v) => {
 };
 //#endregion
 //#region ../js-browser-client/src/BrowserConfigDirectorClient.ts
-const createBrowserClient = (clientSdkKey, sdkOptions, clientOptions) => {
-	const logger = clientOptions?.logger ?? createDefaultLogger$1();
-	const baseUrl = parseUrl(clientOptions?.connection?.url) ?? "https://client-sdk-api.configdirector.com";
-	return new DefaultConfigDirectorClient(new WebWorkerTelemetryClient({
+/**
+* Creates a browser client. With a client SDK key it connects to ConfigDirector; with
+* {@link OfflineClientOptions} alone it runs in `offline` mode and serves `connection.values`. An
+* absent key with `clientOptions` is the same as the options alone when their mode is `offline`,
+* and fails like a missing key otherwise.
+*/
+const createBrowserClient = (clientSdkKeyOrOptions, sdkOptions, clientOptions) => {
+	return DefaultConfigDirectorClient.from(({ clientSdkKey, baseUrl, logger, metadata }) => new WebWorkerTelemetryClient({
 		sdkKey: clientSdkKey,
 		sdkIdentity: {
 			sdkName: sdkOptions.sdkName,
 			sdkVersion: sdkOptions.sdkVersion
 		},
 		metaContext: {
-			appName: clientOptions?.metadata?.appName,
-			appVersion: clientOptions?.metadata?.appVersion
+			appName: metadata?.appName,
+			appVersion: metadata?.appVersion
 		},
 		logger,
 		baseUrl,
 		urlFactory: defaultUrlFactory,
 		valueIdGenerator: generateValueId
-	}), clientSdkKey, sdkOptions, {
-		...clientOptions,
-		logger
-	});
+	}), clientSdkKeyOrOptions, sdkOptions, clientOptions);
 };
 //#endregion
 //#region ../js-client-core/src/installedTestClient.ts
@@ -1717,6 +1933,13 @@ const decideMountAction = (client, context) => {
 	return "none";
 };
 //#endregion
+//#region ../shared/src/browser-half.ts
+const decideBrowserHalfSource = (browserHalf, serverConnectionMode) => {
+	if (browserHalf.mode !== void 0 || browserHalf.values !== void 0) return "as-given";
+	if (serverConnectionMode === "offline") return "inherit-offline";
+	return "connect";
+};
+//#endregion
 //#region src/runtime/app/composables/useConfigDirectorClient.ts
 const useConfigDirectorClient = () => {
 	const { $configDirectorClient } = useNuxtApp();
@@ -1761,13 +1984,16 @@ const createDefaultLogger = (level) => {
 	return logger;
 };
 //#endregion
+//#region src/runtime/offline-values-route.ts
+const OFFLINE_VALUES_ROUTE = "/_configdirector/offline-values";
+//#endregion
 //#region src/runtime/plugin.client.ts
 const DEFAULT_INITIALIZATION_TIMEOUT_MILLISECONDS = 2e3;
-var plugin_client_default = defineNuxtPlugin((nuxtApp) => {
+var plugin_client_default = defineNuxtPlugin(async (nuxtApp) => {
 	const runtimeConfig = useRuntimeConfig();
 	const logger = createDefaultLogger(runtimeConfig.public?.configdirector?.logLevel);
 	const installedTestClient = readInstalledTestClient();
-	const client = installedTestClient ?? buildClient(runtimeConfig.public?.configdirector, logger);
+	const client = installedTestClient ?? await 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", () => {
@@ -1788,29 +2014,58 @@ var plugin_client_default = defineNuxtPlugin((nuxtApp) => {
 		configDirectorClientReadyStatus: readonly(readyStatus)
 	} };
 });
-const buildClient = (configdirector, logger) => {
-	if (!configdirector?.clientSdkKey) {
+const buildClient = async (configdirector, logger) => {
+	const browserHalf = await browserHalfConnectionOf(configdirector, logger);
+	if (browserHalf.mode !== "offline" && !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);
 	}
-	const { clientSdkKey, appName, appVersion, baseUrl, connection } = configdirector;
-	return createBrowserClient(clientSdkKey, {
+	return createBrowserClient(configdirector?.clientSdkKey || void 0, {
 		sdkName: "nuxt-sdk",
-		sdkVersion: "1.10.0"
+		sdkVersion: "1.11.1"
 	}, {
 		metadata: {
-			appName,
-			appVersion
+			appName: configdirector?.appName,
+			appVersion: configdirector?.appVersion
 		},
 		connection: {
-			url: baseUrl || void 0,
-			mode: connection?.mode || void 0,
-			pollingInterval: connection?.pollingInterval || void 0,
-			timeout: connection?.timeout || DEFAULT_INITIALIZATION_TIMEOUT_MILLISECONDS
+			url: configdirector?.baseUrl || void 0,
+			mode: browserHalf.mode,
+			values: browserHalf.values,
+			pollingInterval: configdirector?.connection?.pollingInterval || void 0,
+			timeout: configdirector?.connection?.timeout || DEFAULT_INITIALIZATION_TIMEOUT_MILLISECONDS
 		},
 		logger
 	});
 };
+const browserHalfConnectionOf = async (configdirector, logger) => {
+	const givenConnection = {
+		mode: configdirector?.connection?.mode || void 0,
+		values: configdirector?.connection?.values
+	};
+	const source = decideBrowserHalfSource(givenConnection, configdirector?.serverConnectionMode);
+	logger.debug(`Browser half source: ${source}`);
+	switch (source) {
+		case "as-given": return givenConnection;
+		case "inherit-offline": return {
+			mode: "offline",
+			values: await fetchServerOfflineValues(logger)
+		};
+		case "connect": return {
+			mode: void 0,
+			values: void 0
+		};
+	}
+};
+const fetchServerOfflineValues = async (logger) => {
+	try {
+		return await $fetch(OFFLINE_VALUES_ROUTE);
+	} catch (error) {
+		const message = `The server runs ConfigDirector in offline mode, but its values could not be fetched from ${OFFLINE_VALUES_ROUTE}: ${error instanceof Error ? error.message : String(error)}. A statically generated site has no server to serve them; set 'runtimeConfig.public.configdirector.connection' to { mode: "offline", values } in nuxt.config.ts to give the browser its own values.`;
+		logger.error(message);
+		throw new ConfigDirectorInitializationError(message);
+	}
+};
 //#endregion
 export { plugin_client_default as default };

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

@@ -0,0 +1,6 @@
+import { n as ConfigDirectorClient } from "../../types-CS7AMNWe.mjs";
+
+//#region src/runtime/server/composables/useConfigDirectorServerClient.d.ts
+declare const useConfigDirectorServerClient: () => ConfigDirectorClient;
+//#endregion
+export { useConfigDirectorServerClient };

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

@@ -0,0 +1,6 @@
+import { n as ConfigDirectorClient } from "../../types-CS7AMNWe.mjs";
+
+//#region src/runtime/server/composables/useConfigDirectorServerClient.d.ts
+declare const useConfigDirectorServerClient: () => ConfigDirectorClient;
+//#endregion
+export { useConfigDirectorServerClient };

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

@@ -0,0 +1,9 @@
+import { useNitroApp } from "nitropack/runtime";
+//#region src/runtime/server/composables/useConfigDirectorServerClient.ts
+const useConfigDirectorServerClient = () => {
+	const serverSdkClient = useNitroApp().configDirectorClient;
+	if (!serverSdkClient) throw new Error("The ConfigDirector Nitro plugin was not initialized");
+	return serverSdkClient;
+};
+//#endregion
+export { useConfigDirectorServerClient };

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

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

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

@@ -1,8 +1,7 @@
-import { useNitroApp } from "nitropack/runtime";
+import { useConfigDirectorServerClient } from "./useConfigDirectorServerClient.mjs";
 //#region src/runtime/server/composables/useConfigDirectorServerHooks.ts
 const useConfigDirectorServerHooks = (hooks) => {
-	const client = useNitroApp().configDirectorClient;
-	if (!client) throw new Error("The ConfigDirector Nitro plugin was not initialized");
+	const client = useConfigDirectorServerClient();
 	const entries = Object.entries(hooks);
 	for (const [event, handler] of entries) {
 		if (!handler) continue;

package/dist/runtime/{types-B9_4pADA.d.mts → types-CS7AMNWe.d.mts}

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

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

@@ -1,4 +1,4 @@
-import { i as ConfigValueType, n as ConfigEvaluation, t as ConfigDirectorContext } from "./types-IPLvRsUO.mjs";
+import { a as ConfigValueType, n as ConfigDirectorContext, r as ConfigEvaluation } from "./native-values-BV2k_xR2.mjs";
 
 //#region ../js-client-core/src/Emitter.d.ts
 type EventType = string | symbol;