@configdirector/react-native-sdk 1.7.0 → 1.8.0

package/dist/configdirector-react-native-testing.d.mts

@@ -1,4 +1,4 @@
-import { i as ConfigDirectorContext, n as ConfigDirectorClient, o as ConfigDirectorLogger } from "./types-P1hoU2Ru.mjs";
+import { c as NativeValues, d as ConfigDirectorLogger, l as ConfigDirectorContext, n as ConfigDirectorClient, o as NativeJsonValue, s as NativeValue } from "./types-DoORnGTD.mjs";
 
 //#region ../shared/src/errors.d.ts
 declare class ConfigDirectorConnectionError extends Error {
@@ -11,15 +11,6 @@ declare class ConfigDirectorValidationError extends Error {
   constructor(message: string);
 }
 //#endregion
-//#region ../shared/src/testing/values.d.ts
-type TestJsonValue = boolean | number | string | null | TestJsonValue[] | {
-  [key: string]: TestJsonValue;
-};
-type TestValue = boolean | number | string | TestJsonValue[] | {
-  [key: string]: TestJsonValue;
-};
-type TestValues = Record<string, TestValue>;
-//#endregion
 //#region ../js-client-core/src/testing/TestClient.d.ts
 /**
  * Options for {@link createTestClient}. Every option is optional.
@@ -30,7 +21,7 @@ type TestClientOptions = {
    * config type follows from each value: a boolean, an integral number (`integer`), any other
    * number (`float`), a string, or a plain object or array (`json`).
    */
-  values?: TestValues;
+  values?: NativeValues;
   /**
    * The connection timeout of the SDK client, in milliseconds. It bounds how long a held
    * `initialize` or `updateContext` waits. Defaults to the SDK's production timeout.
@@ -59,7 +50,7 @@ interface TestClient {
    * Stores `value` under `key` and, when the client is connected, delivers it as an update, so
    * reads, watchers, and `configsUpdated` handlers see it.
    */
-  setValue(key: string, value: TestValue): void;
+  setValue(key: string, value: NativeValue): void;
   /**
    * Removes `key` and, when the client is connected, delivers a full update without it, so reads
    * fall back to the in-code default value and watchers of `key` receive that default.
@@ -69,7 +60,7 @@ interface TestClient {
    * Replaces every stored value with `values`, disarms any armed hold or failure, and, when the
    * client is connected, delivers the new values as a full update.
    */
-  replaceValues(values: TestValues): void;
+  replaceValues(values: NativeValues): void;
   /**
    * Makes the next `initialize` wait until {@link completeInitialization} or
    * {@link failInitialization} is called, or until the client's timeout elapses.
@@ -155,4 +146,4 @@ declare const installTestClient: (testClient: TestClient) => (() => void);
  */
 declare const createTestClient: (options?: TestClientOptions) => TestClient;
 //#endregion
-export { ConfigDirectorConnectionError, ConfigDirectorValidationError, type TestClient, type TestClientOptions, type TestJsonValue, type TestValue, type TestValues, createTestClient, installTestClient };
+export { ConfigDirectorConnectionError, ConfigDirectorValidationError, type TestClient, type TestClientOptions, type NativeJsonValue as TestJsonValue, type NativeValue as TestValue, type NativeValues as TestValues, createTestClient, installTestClient };

package/dist/configdirector-react-native-testing.mjs

@@ -1,98 +1,4 @@
-import { c as ConfigDirectorConnectionError, d as _defineProperty, l as ConfigDirectorValidationError, o as createDefaultLogger, r as DefaultConfigDirectorClient, t as INSTALLED_TEST_CLIENT_SLOT, u as Emitter } from "./installedTestClient-LWv5ji8J.mjs";
-//#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") {
-		var _value$constructor$na, _value$constructor;
-		return `a ${(_value$constructor$na = (_value$constructor = value.constructor) === null || _value$constructor === void 0 ? void 0 : _value$constructor.name) !== null && _value$constructor$na !== void 0 ? _value$constructor$na : "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
+import { a as discardingTelemetryClient, d as Emitter, f as _defineProperty, l as ConfigDirectorConnectionError, o as createDefaultLogger, r as DefaultConfigDirectorClient, s as nativeValueConfigState, t as INSTALLED_TEST_CLIENT_SLOT, u as ConfigDirectorValidationError } from "./installedTestClient-CKjaEilj.mjs";
 //#region ../js-client-core/src/testing/InMemoryConnection.ts
 const TEST_ENVIRONMENT = {
 	environmentId: "test-environment",
@@ -129,7 +35,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,
@@ -278,19 +184,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: () => {},
-	recordInvalidContext: () => {},
-	close: async () => {}
-};
 var InMemoryTestClient = class {
 	constructor(client, connection) {
 		this.client = client;
@@ -331,7 +234,7 @@ const createTestClient$1 = (sdkOptions, options) => {
 	var _options$logger, _options$values;
 	const logger = (_options$logger = options === null || options === void 0 ? void 0 : options.logger) !== null && _options$logger !== void 0 ? _options$logger : createDefaultLogger();
 	const connection = new InMemoryConnection(logger, (_options$values = options === null || options === void 0 ? void 0 : options.values) !== null && _options$values !== void 0 ? _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 === null || options === void 0 ? void 0 : options.timeout }
 	}, { transport: connection }), connection);
@@ -392,7 +295,7 @@ const installTestClient = (testClient) => {
 const createTestClient = (options) => {
 	return createTestClient$1({
 		sdkName: "react-native-sdk",
-		sdkVersion: "1.7.0"
+		sdkVersion: "1.8.0"
 	}, options);
 };
 //#endregion

package/dist/configdirector-react-native.d.mts

@@ -1,4 +1,4 @@
-import { a as ConfigDirectorLogMessageDecorator, c as ConfigValueType, i as ConfigDirectorContext, l as ConnectionMode, n as ConfigDirectorClient, o as ConfigDirectorLogger, r as ConfigDirectorClientOptions, s as ConfigDirectorLoggingLevel, t as ClientHooks } from "./types-P1hoU2Ru.mjs";
+import { a as OfflineValues, d as ConfigDirectorLogger, f as ConfigDirectorLoggingLevel, i as OfflineValue, l as ConfigDirectorContext, m as ConnectionMode, n as ConfigDirectorClient, p as ConfigValueType, r as ConfigDirectorClientOptions, t as ClientHooks, u as ConfigDirectorLogMessageDecorator } from "./types-DoORnGTD.mjs";
 import { Component, PropsWithChildren } from "react";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 
@@ -39,19 +39,31 @@ type NetInfoState = {
  */
 type NetInfoSubscribe = (callback: (state: NetInfoState) => void) => () => void;
 type ConfigDirectorProviderOptions = {
-  sdkKey: string;
+  /**
+   * Your ConfigDirector client SDK key. Required unless `mode` is `offline`.
+   */
+  sdkKey?: string;
   appName?: string;
   appVersion?: string;
   url?: string;
   timeout?: number;
   /**
-   * The connection mode, one of `streaming` or `polling`. In `streaming` mode the connection stays
-   * open and receives config updates as they happen. In `polling` mode configs are fetched once during
-   * initialization and then again on every `pollingInterval`.
+   * The connection mode, one of `streaming`, `polling` or `offline`. In `streaming` mode the connection
+   * stays open and receives config updates as they happen. In `polling` mode configs are fetched once
+   * during initialization and then again on every `pollingInterval`. In `offline` mode the client never
+   * connects to ConfigDirector and sends nothing: it serves `values` to every context, or the in-code
+   * default values when none are given, and needs no `sdkKey`.
    *
    * Defaults to `streaming`.
    */
   mode?: ConnectionMode;
+  /**
+   * The values to serve in `offline` mode, keyed by config key. The config type of each value follows
+   * from the value: a boolean, an integral number (`integer`), any other number (`float`), a string, or
+   * a plain object or array (`json`). Can be given only in `offline` mode; otherwise the client fails
+   * to initialize.
+   */
+  values?: OfflineValues;
   /**
    * The polling interval in seconds when `mode` is `polling`. Has no effect in `streaming` mode.
    *
@@ -133,4 +145,4 @@ declare class ConfigDirectorReactContextError extends Error {
 //#region src/logger.d.ts
 declare const createConsoleLogger: (level?: ConfigDirectorLoggingLevel) => DefaultConsoleLogger;
 //#endregion
-export { type ClientStatus, type ConfigDirectorClient, type ConfigDirectorClientOptions, type ConfigDirectorContext, type ConfigDirectorLogger, type ConfigDirectorLoggingLevel, ConfigDirectorProvider, type ConfigDirectorProviderClientProps, type ConfigDirectorProviderOptions, type ConfigDirectorProviderProps, ConfigDirectorReactContextError, type ConnectionMode, type NetInfoSubscribe, createClient, createConsoleLogger, useClient, useConfigValue, useContext };
+export { type ClientStatus, type ConfigDirectorClient, type ConfigDirectorClientOptions, type ConfigDirectorContext, type ConfigDirectorLogger, type ConfigDirectorLoggingLevel, ConfigDirectorProvider, type ConfigDirectorProviderClientProps, type ConfigDirectorProviderOptions, type ConfigDirectorProviderProps, ConfigDirectorReactContextError, type ConnectionMode, type NetInfoSubscribe, type OfflineValue, type OfflineValues, createClient, createConsoleLogger, useClient, useConfigValue, useContext };

package/dist/configdirector-react-native.mjs

@@ -1,4 +1,4 @@
-import { a as CLIENT_BASE_URL, d as _defineProperty, i as fetchWithTimeout, n as readInstalledTestClient, o as createDefaultLogger, r as DefaultConfigDirectorClient, s as isFetchErrorFatal } from "./installedTestClient-LWv5ji8J.mjs";
+import { c as isFetchErrorFatal, f as _defineProperty, i as fetchWithTimeout, n as readInstalledTestClient, o as createDefaultLogger, r as DefaultConfigDirectorClient } from "./installedTestClient-CKjaEilj.mjs";
 import React, { Component, useContext as useContext$1 } from "react";
 import { AppState, NativeModules } from "react-native";
 import { sha256 } from "@noble/hashes/sha2.js";
@@ -742,19 +742,20 @@ var MinimalUrl = class {
 const urlFactory = (input, base) => new MinimalUrl(input, base);
 //#endregion
 //#region src/client.ts
-const createClient = (clientSdkKey, clientOptions) => {
-	var _clientOptions$logger, _clientOptions$connec;
+const createClient = (clientSdkKey, clientOptions) => createReactNativeClient(clientSdkKey, clientOptions);
+const createReactNativeClient = (clientSdkKey, clientOptions) => {
+	var _clientOptions$logger;
 	const sdkIdentity = {
 		sdkName: "react-native-sdk",
-		sdkVersion: "1.7.0"
+		sdkVersion: "1.8.0"
 	};
 	const logger = (_clientOptions$logger = clientOptions === null || clientOptions === void 0 ? void 0 : clientOptions.logger) !== null && _clientOptions$logger !== void 0 ? _clientOptions$logger : createConsoleLogger("warn");
 	const metadata = resolveMetadata(clientOptions === null || clientOptions === void 0 ? void 0 : clientOptions.metadata, logger);
-	return new DefaultConfigDirectorClient(new ReactNativeTelemetryClient({
-		sdkKey: clientSdkKey,
+	return new DefaultConfigDirectorClient((liveTelemetry) => new ReactNativeTelemetryClient({
+		sdkKey: liveTelemetry.clientSdkKey,
 		sdkIdentity,
 		metaContext: metadata,
-		baseUrl: (clientOptions === null || clientOptions === void 0 || (_clientOptions$connec = clientOptions.connection) === null || _clientOptions$connec === void 0 ? void 0 : _clientOptions$connec.url) ? urlFactory(clientOptions.connection.url) : CLIENT_BASE_URL,
+		baseUrl: liveTelemetry.baseUrl,
 		logger,
 		urlFactory
 	}), clientSdkKey, sdkIdentity, {
@@ -771,12 +772,13 @@ const createClient = (clientSdkKey, clientOptions) => {
 //#region src/clientSource.ts
 const buildClient = (options) => {
 	var _options$logger;
-	return createClient(options.sdkKey, {
+	return createReactNativeClient(options.sdkKey, {
 		connection: {
 			url: options.url,
 			timeout: options.timeout,
 			mode: options.mode,
-			pollingInterval: options.pollingInterval
+			pollingInterval: options.pollingInterval,
+			values: options.values
 		},
 		metadata: {
 			appName: options.appName,
@@ -804,6 +806,7 @@ const resolveClientSource = (props) => {
 };
 //#endregion
 //#region src/provider.tsx
+const settledStatusOf = (client) => (client === null || client === void 0 ? void 0 : client.isReady) ? "ready" : "default";
 var ConfigDirectorProvider = class extends Component {
 	constructor(props) {
 		super(props);
@@ -871,15 +874,15 @@ var ConfigDirectorProvider = class extends Component {
 				break;
 			case "none": return;
 		}
-		if (!client.isReady) this.setState({ status: "default" });
+		this.setState({ status: settledStatusOf(client) });
 	}
 	async componentDidUpdate(prevProps) {
 		if (hasGivenClient(prevProps) && hasGivenClient(this.props) && prevProps.client !== this.props.client) createConsoleLogger("warn").warn("The client prop of ConfigDirectorProvider changed after it mounted and is ignored. Remount the provider, for example with a new key, to use another client.");
 		if (!deepEqual(prevProps.context, this.props.context)) {
-			var _this$state$client3, _this$props$context, _this$state$client4;
+			var _this$state$client3, _this$props$context;
 			this.setState({ status: "loading" });
 			await ((_this$state$client3 = this.state.client) === null || _this$state$client3 === void 0 ? void 0 : _this$state$client3.updateContext((_this$props$context = this.props.context) !== null && _this$props$context !== void 0 ? _this$props$context : {}));
-			if (!((_this$state$client4 = this.state.client) === null || _this$state$client4 === void 0 ? void 0 : _this$state$client4.isReady)) this.setState({ status: "default" });
+			this.setState({ status: settledStatusOf(this.state.client) });
 		}
 	}
 	componentWillUnmount() {
@@ -891,8 +894,8 @@ var ConfigDirectorProvider = class extends Component {
 		(_this$handlers = this.handlers) === null || _this$handlers === void 0 || _this$handlers.removeAll();
 		this.handlers = void 0;
 		if (this.ownsClient) {
-			var _this$state$client5;
-			(_this$state$client5 = this.state.client) === null || _this$state$client5 === void 0 || _this$state$client5.dispose();
+			var _this$state$client4;
+			(_this$state$client4 = this.state.client) === null || _this$state$client4 === void 0 || _this$state$client4.dispose();
 			this.disposedOwnClient = true;
 		}
 	}

package/dist/{installedTestClient-LWv5ji8J.mjs → installedTestClient-CKjaEilj.mjs}

@@ -89,6 +89,13 @@ var ConfigDirectorValidationError = class ConfigDirectorValidationError extends
 		Object.setPrototypeOf(this, ConfigDirectorValidationError.prototype);
 	}
 };
+var ConfigDirectorInitializationError = class ConfigDirectorInitializationError extends Error {
+	constructor(message) {
+		super(message);
+		_defineProperty(this, "name", "ConfigDirectorInitializationError");
+		Object.setPrototypeOf(this, ConfigDirectorInitializationError.prototype);
+	}
+};
 //#endregion
 //#region ../js-client-core/src/errors.ts
 const isFetchErrorFatal = (fetchError) => {
@@ -535,6 +542,187 @@ 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") {
+		var _value$constructor$na, _value$constructor;
+		return `a ${(_value$constructor$na = (_value$constructor = value.constructor) === null || _value$constructor === void 0 ? void 0 : _value$constructor.name) !== null && _value$constructor$na !== void 0 ? _value$constructor$na : "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 {
+	constructor(source) {
+		this.source = source;
+		_defineProperty(this, "emitter", new Emitter());
+		_defineProperty(this, "on", (name, handler) => this.emitter.on(name, handler));
+		_defineProperty(this, "off", (name, handler) => this.emitter.off(name, handler));
+	}
+	async connect() {
+		const configs = loadOfflineConfigs(this.source);
+		this.emitter.emit("configSetReceived", {
+			...OFFLINE_ENVIRONMENT,
+			kind: "full",
+			configs
+		});
+		return this;
+	}
+	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) => {
+	var _connection$mode;
+	if ((connection === null || connection === void 0 ? void 0 : connection.mode) === "offline") return {
+		kind: "stay-offline",
+		source: offlineSourceOf(connection)
+	};
+	const mode = (_connection$mode = connection === null || connection === void 0 ? void 0 : connection.mode) !== null && _connection$mode !== void 0 ? _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 === null || connection === void 0 ? void 0 : 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 === null || connection === void 0 ? void 0 : 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;
@@ -758,12 +946,17 @@ const createDefaultLogger = (level, messageDecorator) => {
 	return new DefaultConsoleLogger(level !== null && level !== void 0 ? level : "warn", messageDecorator !== null && messageDecorator !== void 0 ? 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 === null || base === void 0 ? void 0 : base.toString());
 //#endregion
-//#region ../shared/src/constants.ts
-const CLIENT_BASE_URL = "https://client-sdk-api.configdirector.com";
-//#endregion
 //#region ../shared/src/transport/pollingInterval.ts
 const resolvePollingInterval = (configuredSeconds, defaults) => {
 	if (configuredSeconds === void 0) return {
@@ -1128,9 +1321,13 @@ const admitContext = (context) => {
 //#endregion
 //#region ../js-client-core/src/DefaultConfigDirectorClient.ts
 const MAX_EXPONENTIAL_DELAY = 9;
-var DefaultConfigDirectorClient = class {
-	constructor(telemetryClient, clientSdkKey, sdkOptions, clientOptions, internalClientOptions) {
-		var _clientOptions$logger, _clientOptions$connec, _clientOptions$connec2, _internalClientOption, _this$parseUrl, _clientOptions$connec3, _clientOptions$connec4, _clientOptions$connec5, _internalClientOption2, _clientOptions$hooks, _clientOptions$hooks2, _clientOptions$hooks3, _clientOptions$hooks4, _clientOptions$hooks5;
+var DefaultConfigDirectorClient = class DefaultConfigDirectorClient {
+	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) {
+		var _clientOptions$logger, _clientOptions$connec, _clientOptions$connec2, _internalClientOption, _internalClientOption2, _clientOptions$hooks, _clientOptions$hooks2, _clientOptions$hooks3, _clientOptions$hooks4, _clientOptions$hooks5;
 		_defineProperty(this, "logger", void 0);
 		_defineProperty(this, "telemetryClient", void 0);
 		_defineProperty(this, "configSet", void 0);
@@ -1145,17 +1342,15 @@ var DefaultConfigDirectorClient = class {
 		_defineProperty(this, "readyPromise", void 0);
 		_defineProperty(this, "readyResolve", void 0);
 		_defineProperty(this, "currentContext", void 0);
-		_defineProperty(this, "connectionMode", void 0);
+		_defineProperty(this, "connectionPlan", void 0);
 		_defineProperty(this, "clientSession", void 0);
 		this.logger = (_clientOptions$logger = clientOptions === null || clientOptions === void 0 ? void 0 : clientOptions.logger) !== null && _clientOptions$logger !== void 0 ? _clientOptions$logger : createDefaultLogger();
 		this.clientSession = resolveClientSession(this.logger, internalClientOptions === null || internalClientOptions === void 0 ? void 0 : internalClientOptions.instanceIdStorage);
 		this.timeout = (_clientOptions$connec = clientOptions === null || clientOptions === void 0 || (_clientOptions$connec2 = clientOptions.connection) === null || _clientOptions$connec2 === void 0 ? void 0 : _clientOptions$connec2.timeout) !== null && _clientOptions$connec !== void 0 ? _clientOptions$connec : 3e3;
-		this.validateSdkKeyPresence(clientSdkKey);
 		const urlFactory = (_internalClientOption = internalClientOptions === null || internalClientOptions === void 0 ? void 0 : internalClientOptions.urlFactory) !== null && _internalClientOption !== void 0 ? _internalClientOption : defaultUrlFactory;
-		const baseUrl = (_this$parseUrl = this.parseUrl(clientOptions === null || clientOptions === void 0 || (_clientOptions$connec3 = clientOptions.connection) === null || _clientOptions$connec3 === void 0 ? void 0 : _clientOptions$connec3.url, urlFactory)) !== null && _this$parseUrl !== void 0 ? _this$parseUrl : CLIENT_BASE_URL;
-		this.connectionMode = (_clientOptions$connec4 = clientOptions === null || clientOptions === void 0 || (_clientOptions$connec5 = clientOptions.connection) === null || _clientOptions$connec5 === void 0 ? void 0 : _clientOptions$connec5.mode) !== null && _clientOptions$connec4 !== void 0 ? _clientOptions$connec4 : "streaming";
-		this.telemetryClient = telemetryClient;
-		this.transport = (_internalClientOption2 = internalClientOptions === null || internalClientOptions === void 0 ? void 0 : internalClientOptions.transport) !== null && _internalClientOption2 !== void 0 ? _internalClientOption2 : this.buildTransport(clientSdkKey, sdkOptions, baseUrl, urlFactory, clientOptions, internalClientOptions);
+		this.connectionPlan = planConnection(clientSdkKey, clientOptions === null || clientOptions === void 0 ? void 0 : clientOptions.connection, urlFactory);
+		this.telemetryClient = this.buildTelemetryClient(liveTelemetryClient, clientOptions);
+		this.transport = (_internalClientOption2 = internalClientOptions === null || internalClientOptions === void 0 ? void 0 : internalClientOptions.transport) !== null && _internalClientOption2 !== void 0 ? _internalClientOption2 : this.buildTransport(sdkOptions, clientOptions, urlFactory, internalClientOptions);
 		this.transport.on("configSetReceived", (configSet) => {
 			var _this$readyResolve;
 			this.hasReceivedConfigSet = true;
@@ -1193,8 +1388,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
@@ -1202,32 +1397,49 @@ var DefaultConfigDirectorClient = class {
 		if (resolved.warning) this.logger.warn(`[ConfigDirectorClient] ${resolved.warning}`);
 		return resolved.seconds;
 	}
-	buildTransport(clientSdkKey, sdkOptions, baseUrl, urlFactory, clientOptions, internalClientOptions) {
-		var _internalClientOption3, _clientOptions$connec6;
-		return new (this.getTransportConstructor(this.connectionMode))({
-			clientSession: this.clientSession,
-			clientSdkKey,
-			baseUrl,
-			resolveUrl: urlFactory,
-			metaContext: {
-				...clientOptions === null || clientOptions === void 0 ? void 0 : clientOptions.metadata,
-				sdkName: sdkOptions.sdkName,
-				sdkVersion: sdkOptions.sdkVersion,
-				userAgent: readUserAgent(),
-				host: readHost()
-			},
-			logger: this.logger,
-			fetch: internalClientOptions === null || internalClientOptions === void 0 ? void 0 : internalClientOptions.fetch,
-			connectionRetryDelay: (_internalClientOption3 = internalClientOptions === null || internalClientOptions === void 0 ? void 0 : internalClientOptions.connectionRetryDelay) !== null && _internalClientOption3 !== void 0 ? _internalClientOption3 : ((attempt) => {
-				return Math.pow(2, Math.min(attempt, MAX_EXPONENTIAL_DELAY)) * 1e3;
-			}),
-			pollingInterval: this.resolvePollingIntervalForMode(clientOptions === null || clientOptions === void 0 || (_clientOptions$connec6 = clientOptions.connection) === null || _clientOptions$connec6 === void 0 ? void 0 : _clientOptions$connec6.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 === null || clientOptions === void 0 ? void 0 : clientOptions.metadata
+			});
+		}
+	}
+	buildTransport(sdkOptions, clientOptions, urlFactory, internalClientOptions) {
+		const plan = this.connectionPlan;
+		switch (plan.kind) {
+			case "stay-offline": return new OfflineTransport(plan.source);
+			case "connect":
+				var _internalClientOption3, _clientOptions$connec3;
+				return new (this.getTransportConstructor(plan.mode))({
+					clientSession: this.clientSession,
+					clientSdkKey: plan.clientSdkKey,
+					baseUrl: plan.baseUrl,
+					resolveUrl: urlFactory,
+					metaContext: {
+						...clientOptions === null || clientOptions === void 0 ? void 0 : clientOptions.metadata,
+						sdkName: sdkOptions.sdkName,
+						sdkVersion: sdkOptions.sdkVersion,
+						userAgent: readUserAgent(),
+						host: readHost()
+					},
+					logger: this.logger,
+					fetch: internalClientOptions === null || internalClientOptions === void 0 ? void 0 : internalClientOptions.fetch,
+					connectionRetryDelay: (_internalClientOption3 = internalClientOptions === null || internalClientOptions === void 0 ? void 0 : internalClientOptions.connectionRetryDelay) !== null && _internalClientOption3 !== void 0 ? _internalClientOption3 : ((attempt) => {
+						return Math.pow(2, Math.min(attempt, MAX_EXPONENTIAL_DELAY)) * 1e3;
+					}),
+					pollingInterval: this.pollingIntervalFor(plan.mode, clientOptions === null || clientOptions === void 0 || (_clientOptions$connec3 = clientOptions.connection) === null || _clientOptions$connec3 === void 0 ? void 0 : _clientOptions$connec3.pollingInterval)
+				});
+		}
 	}
-	getTransportConstructor(connectionMode) {
-		switch (connectionMode) {
+	getTransportConstructor(mode) {
+		switch (mode) {
 			case "polling": return PollingTransport;
-			default: return StreamingTransport;
+			case "streaming": return StreamingTransport;
 		}
 	}
 	async initialize(context) {
@@ -1235,17 +1447,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;
 		}
@@ -1277,11 +1500,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));
@@ -1380,17 +1613,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.");
@@ -1416,14 +1638,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() {
 		var _this$readyResolve2;
@@ -1445,4 +1677,4 @@ var DefaultConfigDirectorClient = class {
 const INSTALLED_TEST_CLIENT_SLOT = Symbol.for("@configdirector/installed-test-client");
 const readInstalledTestClient = () => globalThis[INSTALLED_TEST_CLIENT_SLOT];
 //#endregion
-export { CLIENT_BASE_URL as a, ConfigDirectorConnectionError as c, _defineProperty as d, fetchWithTimeout as i, ConfigDirectorValidationError as l, readInstalledTestClient as n, createDefaultLogger as o, DefaultConfigDirectorClient as r, isFetchErrorFatal as s, INSTALLED_TEST_CLIENT_SLOT as t, Emitter as u };
+export { discardingTelemetryClient as a, isFetchErrorFatal as c, Emitter as d, _defineProperty as f, fetchWithTimeout as i, ConfigDirectorConnectionError as l, readInstalledTestClient as n, createDefaultLogger as o, DefaultConfigDirectorClient as r, nativeValueConfigState as s, INSTALLED_TEST_CLIENT_SLOT as t, ConfigDirectorValidationError as u };

package/dist/{types-P1hoU2Ru.d.mts → types-DoORnGTD.d.mts}

@@ -88,9 +88,76 @@ type ConfigDirectorMetaContext = {
   appVersion?: string;
   appName?: string;
 };
-type ConnectionMode = "streaming" | "polling";
+type ConnectionMode = "streaming" | "polling" | "offline";
+//#endregion
+//#region ../shared/src/native-values.d.ts
+type NativeJsonValue = boolean | number | string | null | NativeJsonValue[] | {
+  [key: string]: NativeJsonValue;
+};
+type NativeValue = boolean | number | string | NativeJsonValue[] | {
+  [key: string]: NativeJsonValue;
+};
+type NativeValues = Record<string, NativeValue>;
 //#endregion
 //#region ../js-client-core/src/types.d.ts
+/**
+ * One value an offline client serves for a config key. The config type follows from the value: a
+ * boolean, an integral number (`integer`), any other number (`float`), a string, or a plain object
+ * or array (`json`).
+ */
+type OfflineValue = NativeValue;
+/**
+ * The values an offline client serves, keyed by config key. See {@link OfflineValue} for how each
+ * value's config type is decided. Every context receives the same value.
+ */
+type OfflineValues = NativeValues;
+/**
+ * Connection options of the {@link ConfigDirectorClient}
+ */
+type ConnectionOptions = {
+  /**
+   * The connection mode to be used, one of `streaming` (default), `polling` or `offline`.
+   * If set to `streaming`, the connection will remain open and receive updates whenever
+   * config state is updated on the ConfigDirector dashboard.
+   * When set to `polling`, there will be an initial request to retrieve config state during
+   * initialization, and additional requests on a `pollingInterval`.
+   * When set to `offline`, the client never connects to ConfigDirector and sends nothing: it serves
+   * the values given in {@link values} to every context, or the in-code default values when none
+   * are given. No SDK key is needed.
+   *
+   * Defaults to `streaming`
+   */
+  mode?: ConnectionMode;
+  /**
+   * The values to serve in `offline` mode, keyed by config key. A value such as `null` makes
+   * `initialize` reject with a `ConfigDirectorInitializationError`.
+   *
+   * Can be given only in `offline` mode; otherwise `initialize` rejects.
+   */
+  values?: OfflineValues;
+  /**
+   * The polling interval in _seconds_ when the `mode` is set to `polling`. This option has no
+   * effect in the other modes.
+   *
+   * Defaults to 60 seconds. The minimum is 30 seconds. A value below the minimum is raised to the
+   * minimum and a warning is logged.
+   */
+  pollingInterval?: number;
+  /**
+   * The timeout, in _milliseconds_, to be used in initialization and when updating the context.
+   * If streaming is enabled, the operation (initialization or context update) may still succeed
+   * after it times out if no unrecoverable errors are encountered (like an invalid SDK key).
+   * If streaming is disabled, if the operation times out, it will not be retried. This option has
+   * no effect in `offline` mode.
+   */
+  timeout?: number;
+  /**
+   * The base URL to the ConfigDirector SDK server. To be used only when needing to route through a
+   * proxy to connect to the ConfigDirector SDK server. Please refer to the docs on how to configure
+   * a proxy for the client SDK. This option has no effect in `offline` mode.
+   */
+  url?: string;
+};
 /**
  * Configuration options for the {@link ConfigDirectorClient}
  */
@@ -102,39 +169,7 @@ type ConfigDirectorClientOptions = {
   /**
    * Connection options
    */
-  connection?: {
-    /**
-     * The connection mode to be used, one of `streaming` (default) or `polling`.
-     * If set to `streaming`, the connection will remain open and receive updates whenever
-     * config state is updated on the ConfigDirector dashboard.
-     * When set to `polling`, there will be an initial request to retrieve config state during
-     * initialization, and additional requests on a `pollingInterval`.
-     *
-     * Defaults to `streaming`
-     */
-    mode?: ConnectionMode;
-    /**
-     * The polling interval in _seconds_ when the `mode` is set to `polling`. This option has no
-     * effect when the `mode` is set to `streaming`.
-     *
-     * Defaults to 60 seconds. The minimum is 30 seconds. A value below the minimum is raised to the
-     * minimum and a warning is logged.
-     */
-    pollingInterval?: number;
-    /**
-     * The timeout, in _milliseconds_, to be used in initialization and when updating the context.
-     * If streaming is enabled, the operation (initialization or context update) may still succeed
-     * after it times out if no unrecoverable errors are encountered (like an invalid SDK key).
-     * If streaming is disabled, if the operation times out, it will not be retried.
-     */
-    timeout?: number;
-    /**
-     * The base URL to the ConfigDirector SDK server. To be used only when needing to route through a
-     * proxy to connect to the ConfigDirector SDK server. Please refer to the docs on how to configure
-     * a proxy for the client SDK.
-     */
-    url?: string;
-  };
+  connection?: ConnectionOptions;
   /**
    * A logger that implements {@link ConfigDirectorLogger}. It defaults to the ConfigDirector console
    * logger set to 'warn' level.
@@ -313,4 +348,4 @@ interface ConfigDirectorClient extends EventProvider<ClientEvents> {
   dispose(): void;
 }
 //#endregion
-export { ConfigDirectorLogMessageDecorator as a, ConfigValueType as c, ConfigDirectorContext as i, ConnectionMode as l, ConfigDirectorClient as n, ConfigDirectorLogger as o, ConfigDirectorClientOptions as r, ConfigDirectorLoggingLevel as s, ClientHooks as t };
+export { OfflineValues as a, NativeValues as c, ConfigDirectorLogger as d, ConfigDirectorLoggingLevel as f, OfflineValue as i, ConfigDirectorContext as l, ConnectionMode as m, ConfigDirectorClient as n, NativeJsonValue as o, ConfigValueType as p, ConfigDirectorClientOptions as r, NativeValue as s, ClientHooks as t, ConfigDirectorLogMessageDecorator as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@configdirector/react-native-sdk",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "React Native client SDK for ConfigDirector. ConfigDirector is a remote configuration and feature flag service.",
   "license": "MIT",
   "author": "ConfigDirector",