@configdirector/nuxt-sdk 1.9.2 → 1.11.0

package/dist/module.d.mts

@@ -2,18 +2,40 @@ import * as _$_nuxt_schema0 from "@nuxt/schema";
 import { LogLevel } from "consola";
 
 //#region ../shared/src/types.d.ts
-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-server-sdk/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;
 //#endregion
 //#region src/module.d.ts
 interface ConfigDirectorRuntimeConfig {
   /**
    * Your ConfigDirector Server SDK key. You can obtain this key from the ConfigDirector
-   * dashboard under the project settings.
+   * dashboard under the project settings. Not needed when `connection.mode` is `offline`.
    *
    * This is a secret value and should not be committed to a source code repository. Alternatively,
    * it can be provided at runtime via the NUXT_CONFIGDIRECTOR_SERVER_SDK_KEY environment variable.
    */
-  serverSdkKey: string;
+  serverSdkKey?: string;
   /**
    * Log level for the server side of the ConfigDirector Nuxt SDK, using consola's numeric levels.
    * 0 = error, 1 = warn, 2 = log, 3 = info, 4 = debug, 5 = trace.
@@ -31,14 +53,34 @@ interface ConfigDirectorRuntimeConfig {
    */
   connection?: {
     /**
-     * The connection mode, one of `streaming` (default) 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` (default), `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 server never connects to ConfigDirector and sends nothing: it serves the values of
+     * `file` or `values` to every context, or the in-code default values when neither is given, and
+     * needs no `serverSdkKey`. The browser follows the server into `offline` mode with the same values
+     * unless `runtimeConfig.public.configdirector.connection` sets its own `mode` or `values`.
      * Can be set via the NUXT_CONFIGDIRECTOR_CONNECTION_MODE environment variable.
      */
     mode?: ConnectionMode;
     /**
-     * The polling interval in seconds when `mode` is `polling`. Has no effect in `streaming` mode.
+     * The path of a JSON file holding the values to serve in `offline` mode, resolved against the
+     * server process working directory. The file holds one object with a value per config key. A
+     * file that is missing, unreadable, not a JSON object, or holding a value such as `null` makes
+     * every request fail with a `ConfigDirectorInitializationError`. Only one of `file` and `values`
+     * can be given, and only in `offline` mode.
+     * Can be set via the NUXT_CONFIGDIRECTOR_CONNECTION_FILE environment variable.
+     */
+    file?: string;
+    /**
+     * The values to serve in `offline` mode, keyed by config key, as an alternative to `file`. 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`). Only one of `file`
+     * and `values` can be given, and only in `offline` mode.
+     */
+    values?: OfflineValues;
+    /**
+     * The polling interval in seconds when `mode` is `polling`. Has no effect in the other modes.
      * When omitted (or `0`), the server SDK default is used.
      * Can be set via the NUXT_CONFIGDIRECTOR_CONNECTION_POLLING_INTERVAL environment variable.
      */
@@ -64,12 +106,13 @@ interface ConfigDirectorRuntimeConfig {
 interface ConfigDirectorPublicRuntimeConfig {
   /**
    * Your ConfigDirector Client SDK key. You can obtain this key from the ConfigDirector
-   * dashboard under the project settings.
+   * dashboard under the project settings. Not needed when the browser runs in `offline` mode,
+   * whether given here or inherited from the server.
    *
    * This value is not a secret. It can alternatively be provided at runtime via the
    * NUXT_PUBLIC_CONFIGDIRECTOR_CLIENT_SDK_KEY environment variable.
    */
-  clientSdkKey: string;
+  clientSdkKey?: string;
   /**
    * Your app's name. This value can be used in ConfigDirector targeting rules.
    */
@@ -93,18 +136,30 @@ interface ConfigDirectorPublicRuntimeConfig {
    */
   baseUrl?: string;
   /**
-   * Connection options for the browser client used on the client side.
+   * Connection options for the browser client used on the client side. When neither `mode` nor
+   * `values` is given and the server runs in `offline` mode, the browser runs in `offline` mode
+   * too, with the server's values.
    */
   connection?: {
     /**
-     * The connection mode, one of `streaming` (default) or `polling`. In `streaming` mode the
+     * 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`.
+     * are fetched once during initialization and then again on every `pollingInterval`. In `offline`
+     * mode the browser 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 `clientSdkKey`.
+     * Empty when not set; the browser client then uses its default, `streaming`, unless it follows
+     * an offline server.
      * Can be set via the NUXT_PUBLIC_CONFIGDIRECTOR_CONNECTION_MODE environment variable.
      */
-    mode?: ConnectionMode;
+    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.
+     */
+    values?: OfflineValues;
     /**
-     * The polling interval in seconds when `mode` is `polling`. Has no effect in `streaming` mode.
+     * The polling interval in seconds when `mode` is `polling`. Has no effect in the other modes.
      * When omitted (or `0`), it defaults to 60 seconds. A value below the minimum of 30 seconds is
      * raised to 30 seconds and a warning is logged.
      * Can be set via the NUXT_PUBLIC_CONFIGDIRECTOR_CONNECTION_POLLING_INTERVAL environment variable.
@@ -118,6 +173,12 @@ interface ConfigDirectorPublicRuntimeConfig {
      */
     timeout?: number;
   };
+  /**
+   * The connection mode the server runs in, written by the module on every request so the browser
+   * knows whether to follow the server into `offline` mode. Not an option: any value set here is
+   * overwritten on every request.
+   */
+  serverConnectionMode?: ConnectionMode;
 }
 declare module "nuxt/schema" {
   interface RuntimeConfig {
@@ -145,4 +206,4 @@ interface ModuleOptions {
 }
 declare const _default: _$_nuxt_schema0.NuxtModule<ModuleOptions, ModuleOptions, false>;
 //#endregion
-export { ModuleOptions, _default as default };
+export { ModuleOptions, type OfflineValue, type OfflineValues, _default as default };

package/dist/module.json

@@ -4,5 +4,5 @@
   "compatibility": {
     "nuxt": ">=4.0.0"
   },
-  "version": "1.9.2"
+  "version": "1.11.0"
 }

package/dist/module.mjs

@@ -1,5 +1,8 @@
 import { addImports, addPlugin, addServerHandler, addServerImports, addServerPlugin, createResolver, defineNuxtModule, useLogger } from "@nuxt/kit";
 import { defu } from "defu";
+//#region src/runtime/offline-values-route.ts
+const OFFLINE_VALUES_ROUTE = "/_configdirector/offline-values";
+//#endregion
 //#region src/module.ts
 var module_default = defineNuxtModule({
 	meta: {
@@ -16,6 +19,7 @@ var module_default = defineNuxtModule({
 			baseUrl: "",
 			connection: {
 				mode: "streaming",
+				file: "",
 				pollingInterval: 0,
 				timeout: 0
 			},
@@ -29,7 +33,7 @@ var module_default = defineNuxtModule({
 			clientSdkKey: "",
 			baseUrl: "",
 			connection: {
-				mode: "streaming",
+				mode: "",
 				pollingInterval: 0,
 				timeout: 0
 			}
@@ -44,10 +48,15 @@ var module_default = defineNuxtModule({
 			middleware: true,
 			handler: resolver.resolve("./runtime/nitro/middleware")
 		});
+		addServerHandler({
+			route: OFFLINE_VALUES_ROUTE,
+			method: "get",
+			handler: resolver.resolve("./runtime/nitro/offline-values")
+		});
 		addServerImports([{
-			name: "useConfigDirectorClient",
-			as: "useConfigDirectorClient",
-			from: resolver.resolve("./runtime/server/composables/useConfigDirectorClient")
+			name: "useConfigDirectorServerClient",
+			as: "useConfigDirectorServerClient",
+			from: resolver.resolve("./runtime/server/composables/useConfigDirectorServerClient")
 		}, {
 			name: "useConfigDirectorServerHooks",
 			as: "useConfigDirectorServerHooks",

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

@@ -1,4 +1,4 @@
-import { n as ConfigDirectorClient } from "../../types-CvmjergQ.mjs";
+import { n as ConfigDirectorClient } from "../../types-Dt3bENKf.mjs";
 
 //#region src/runtime/app/composables/useConfigDirectorClient.d.ts
 declare const useConfigDirectorClient: () => {

package/dist/runtime/app/composables/useConfigDirectorClient.d.ts

@@ -1,4 +1,4 @@
-import { n as ConfigDirectorClient } from "../../types-CvmjergQ.mjs";
+import { n as ConfigDirectorClient } from "../../types-Dt3bENKf.mjs";
 
 //#region src/runtime/app/composables/useConfigDirectorClient.d.ts
 declare const useConfigDirectorClient: () => {

package/dist/runtime/app/composables/useConfigDirectorClientHooks.d.mts

@@ -1,4 +1,4 @@
-import { t as ClientHooks } from "../../types-CvmjergQ.mjs";
+import { t as ClientHooks } from "../../types-Dt3bENKf.mjs";
 
 //#region src/runtime/app/composables/useConfigDirectorClientHooks.d.ts
 declare const useConfigDirectorClientHooks: (hooks: ClientHooks) => void;

package/dist/runtime/app/composables/useConfigDirectorClientHooks.d.ts

@@ -1,4 +1,4 @@
-import { t as ClientHooks } from "../../types-CvmjergQ.mjs";
+import { t as ClientHooks } from "../../types-Dt3bENKf.mjs";
 
 //#region src/runtime/app/composables/useConfigDirectorClientHooks.d.ts
 declare const useConfigDirectorClientHooks: (hooks: ClientHooks) => void;

package/dist/runtime/app/composables/useConfigDirectorContext.d.mts

@@ -1,4 +1,4 @@
-import { t as ConfigDirectorContext } from "../../types-CHmsCChN.mjs";
+import { n as ConfigDirectorContext } from "../../native-values-BV2k_xR2.mjs";
 import { Ref } from "vue";
 
 //#region src/runtime/app/composables/useConfigDirectorContext.d.ts

package/dist/runtime/app/composables/useConfigDirectorContext.d.ts

@@ -1,4 +1,4 @@
-import { t as ConfigDirectorContext } from "../../types-CHmsCChN.mjs";
+import { n as ConfigDirectorContext } from "../../native-values-BV2k_xR2.mjs";
 import { Ref } from "vue";
 
 //#region src/runtime/app/composables/useConfigDirectorContext.d.ts

package/dist/runtime/app/composables/useConfigDirectorContext.mjs

@@ -1,4 +1,5 @@
 import { useConfigDirectorClient } from "./useConfigDirectorClient.mjs";
+import { n as admittedContextOrNone } from "../../context-kind-D6YBNij2.mjs";
 import { useState } from "#app";
 import { readonly, toRaw } from "vue";
 //#region src/runtime/app/composables/useConfigDirectorContext.ts
@@ -13,7 +14,7 @@ const useConfigDirectorContext = () => {
 		const rawContext = toRaw(context);
 		const oldContext = JSON.stringify(state.value);
 		const newContext = JSON.stringify(rawContext);
-		state.value = rawContext;
+		state.value = admittedContextOrNone(rawContext);
 		if (oldContext != newContext) {
 			const timeout = getEffectiveTimeout(options?.timeoutMilliseconds);
 			let timer;

package/dist/runtime/app/composables/useConfigDirectorStatus.d.mts

@@ -1,4 +1,4 @@
-import { t as ClientStatus } from "../../types-CkzBXJwA.mjs";
+import { t as ClientStatus } from "../../types-C30VJ25l.mjs";
 import { Ref, ShallowRef } from "vue";
 
 //#region src/runtime/app/composables/useConfigDirectorStatus.d.ts

package/dist/runtime/app/composables/useConfigDirectorStatus.d.ts

@@ -1,4 +1,4 @@
-import { t as ClientStatus } from "../../types-CkzBXJwA.mjs";
+import { t as ClientStatus } from "../../types-C30VJ25l.mjs";
 import { Ref, ShallowRef } from "vue";
 
 //#region src/runtime/app/composables/useConfigDirectorStatus.d.ts

package/dist/runtime/app/composables/useConfigDirectorValue.d.mts

@@ -1,5 +1,5 @@
-import { i as ConfigValueType } from "../../types-CHmsCChN.mjs";
-import { t as ClientStatus } from "../../types-CkzBXJwA.mjs";
+import { a as ConfigValueType } from "../../native-values-BV2k_xR2.mjs";
+import { t as ClientStatus } from "../../types-C30VJ25l.mjs";
 import { DeepReadonly, Ref, ShallowRef } from "vue";
 
 //#region src/runtime/app/composables/useConfigDirectorValue.d.ts

package/dist/runtime/app/composables/useConfigDirectorValue.d.ts

@@ -1,5 +1,5 @@
-import { i as ConfigValueType } from "../../types-CHmsCChN.mjs";
-import { t as ClientStatus } from "../../types-CkzBXJwA.mjs";
+import { a as ConfigValueType } from "../../native-values-BV2k_xR2.mjs";
+import { t as ClientStatus } from "../../types-C30VJ25l.mjs";
 import { DeepReadonly, Ref, ShallowRef } from "vue";
 
 //#region src/runtime/app/composables/useConfigDirectorValue.d.ts

package/dist/runtime/context-kind-D6YBNij2.mjs

@@ -0,0 +1,45 @@
+//#region ../shared/src/context-kind.ts
+const CONTEXT_KIND_MAXIMUM_LENGTH = 64;
+const KIND_SAMPLE_MAXIMUM_CHARACTERS = 128;
+const isContextKindCharacter = (character) => character >= "a" && character <= "z" || character >= "0" && character <= "9" || character === "-" || character === "_";
+const isValidContextKind = (kind) => {
+	if (kind.length < 1 || kind.length > CONTEXT_KIND_MAXIMUM_LENGTH) return false;
+	for (const character of kind) if (!isContextKindCharacter(character)) return false;
+	return true;
+};
+const isAcceptedKind = (kind) => kind === void 0 || kind === null || typeof kind === "string" && isValidContextKind(kind);
+const stringFormOf = (kind) => {
+	if (typeof kind === "string") return kind;
+	try {
+		return String(kind);
+	} catch {
+		return Object.prototype.toString.call(kind);
+	}
+};
+const firstCharactersOf = (text, maximumCharacters) => {
+	let sample = "";
+	let characterCount = 0;
+	for (const character of text) {
+		if (characterCount === maximumCharacters) break;
+		sample += character;
+		characterCount += 1;
+	}
+	return sample;
+};
+const admittedContextOrNone = (context) => {
+	const admission = admitContext(context);
+	return admission.outcome === "admitted" ? admission.context : void 0;
+};
+const admitContext = (context) => {
+	const kind = context?.kind;
+	if (isAcceptedKind(kind)) return {
+		outcome: "admitted",
+		context
+	};
+	return {
+		outcome: "ignored",
+		kindSample: firstCharactersOf(stringFormOf(kind), KIND_SAMPLE_MAXIMUM_CHARACTERS)
+	};
+};
+//#endregion
+export { admittedContextOrNone as n, admitContext as t };

package/dist/runtime/native-values-BV2k_xR2.d.mts

@@ -0,0 +1,83 @@
+//#region ../shared/src/types.d.ts
+declare const ConfigTypeList: readonly ["custom", "boolean", "string", "integer", "float", "enum", "url", "json"];
+type ConfigType = (typeof ConfigTypeList)[number];
+type ConfigEnumLikeType = {
+  [key: string]: string | number;
+};
+type ConfigValueType = string | number | boolean | object | ConfigEnumLikeType;
+type ConfigState = {
+  id: string;
+  key: string;
+  type: ConfigType;
+  value: string | undefined | null;
+  valueId?: string | undefined | null;
+};
+type EvaluationReason = "found-match" | "config-state-missing" | "client-not-ready" | "type-mismatch" | "value-missing" | "invalid-number" | "invalid-json" | "invalid-boolean";
+type ConfigEvaluation = {
+  key: string;
+  value: ConfigValueType;
+  valueId?: string;
+  isDefaultValue: boolean;
+  reason: EvaluationReason;
+  context?: ConfigDirectorContext;
+};
+/**
+ * The context to be sent to ConfigDirector: the user or other entity, such as a device or an
+ * organization, that configs are evaluated for. This context will be used for targeting rules
+ * evaluation.
+ */
+type ConfigDirectorContext = {
+  /**
+   * The context's identifier. This should be a value that uniquely identifies the user or other
+   * entity among contexts of the same {@link kind}.
+   * In the case of anonymous users, you could generate a UUID or alternatively not provide
+   * the {@link id} and the SDK will generate a random UUID. However, keep in mind that this
+   * value is used for segmenting contexts in percentage rollouts, and changes to the {@link id}
+   * could result in the context being assigned to a different percentile.
+   */
+  id?: string;
+  /**
+   * The kind of entity this context represents, such as `user`, `device`, `organization`,
+   * `tenant` or `listing`. You can use any other kind that fits your application. A kind has 1
+   * to 64 characters, using only lowercase letters (`a`-`z`), digits, `-` and `_`. It is used
+   * exactly as given, without trimming or changing its case.
+   *
+   * A context with an invalid kind is ignored as a whole: the SDK logs an error and evaluates
+   * as if no context had been provided.
+   *
+   * @default "user"
+   */
+  kind?: string;
+  /**
+   * The context's display name. This will be shown in the ConfigDirector dashboard and may be
+   * used for targeting rules.
+   */
+  name?: string;
+  /**
+   * Any arbitrary traits for the context. They will be shown in the ConfigDirector dashboard
+   * and may be used for targeting rules.
+   */
+  traits?: {
+    [key: string]: unknown;
+  };
+  /**
+   * Whether or not to treat the context as anonymous during evaluation. When `true`, the
+   * context values will be used for targeting rules evaluation but the context will not be
+   * persisted and will not appear in the dashboard.
+   *
+   * @default false
+   */
+  anonymous?: boolean;
+};
+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
+export { ConfigValueType as a, ConfigState as i, ConfigDirectorContext as n, ConnectionMode as o, ConfigEvaluation as r, NativeValues as t };

package/dist/runtime/native-values-DZJjFBvk.mjs

@@ -0,0 +1,116 @@
+//#region ../shared/src/errors.ts
+var ConfigDirectorConnectionError = class ConfigDirectorConnectionError extends Error {
+	name = "ConfigDirectorConnectionError";
+	status;
+	constructor(message, status) {
+		super(message);
+		this.status = status;
+		Object.setPrototypeOf(this, ConfigDirectorConnectionError.prototype);
+	}
+};
+var ConfigDirectorValidationError = class ConfigDirectorValidationError extends Error {
+	name = "ConfigDirectorValidationError";
+	constructor(message) {
+		super(message);
+		Object.setPrototypeOf(this, ConfigDirectorValidationError.prototype);
+	}
+};
+var ConfigDirectorInitializationError = class ConfigDirectorInitializationError extends Error {
+	name = "ConfigDirectorInitializationError";
+	constructor(message) {
+		super(message);
+		Object.setPrototypeOf(this, ConfigDirectorInitializationError.prototype);
+	}
+};
+//#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 decoders = {
+	boolean: (value) => value === "true",
+	integer: Number,
+	float: Number,
+	string: (value) => value,
+	enum: (value) => value,
+	url: (value) => value,
+	custom: (value) => value,
+	json: (value) => JSON.parse(value)
+};
+const decodeNativeValue = (type, value) => decoders[type](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
+export { ConfigDirectorValidationError as a, ConfigDirectorInitializationError as i, encodeNativeValue as n, ConfigDirectorConnectionError as r, decodeNativeValue as t };

package/dist/runtime/nitro/middleware.mjs

@@ -3,8 +3,12 @@ import { defineEventHandler } from "h3";
 //#region src/runtime/nitro/middleware.ts
 var middleware_default = defineEventHandler(async (event) => {
 	const nitroApp = useNitroApp();
-	if (useRuntimeConfig(event).configdirector.waitForInitialization) await nitroApp.configDirectorInitialization;
+	if (decideRequestHold(useRuntimeConfig(event).configdirector.waitForInitialization, nitroApp.configDirectorConnectionMode) === "hold-until-initialized") await nitroApp.configDirectorInitialization;
 	event.context.configDirectorClient = nitroApp.configDirectorClient;
 });
+const decideRequestHold = (waitForInitialization, connectionMode) => {
+	if (connectionMode === "offline") return "hold-until-initialized";
+	return waitForInitialization ? "hold-until-initialized" : "pass-through";
+};
 //#endregion
 export { middleware_default as default };

package/dist/runtime/nitro/offline-values.d.mts

@@ -0,0 +1,7 @@
+import { t as NativeValues } from "../native-values-BV2k_xR2.mjs";
+import * as _$h3 from "h3";
+
+//#region src/runtime/nitro/offline-values.d.ts
+declare const _default: _$h3.EventHandler<_$h3.EventHandlerRequest, NativeValues>;
+//#endregion
+export { _default as default };

package/dist/runtime/nitro/offline-values.d.ts

@@ -0,0 +1,7 @@
+import { t as NativeValues } from "../native-values-BV2k_xR2.mjs";
+import * as _$h3 from "h3";
+
+//#region src/runtime/nitro/offline-values.d.ts
+declare const _default: _$h3.EventHandler<_$h3.EventHandlerRequest, NativeValues>;
+//#endregion
+export { _default as default };

package/dist/runtime/nitro/offline-values.mjs

@@ -0,0 +1,15 @@
+import { t as decodeNativeValue } from "../native-values-DZJjFBvk.mjs";
+import { useNitroApp } from "nitropack/runtime";
+import { createError, defineEventHandler } from "h3";
+//#region ../shared/src/browser-half.ts
+const holdsAValue = (config) => typeof config.value === "string";
+const offlineValuesOf = (configs) => Object.fromEntries(Object.values(configs).filter(holdsAValue).map((config) => [config.key, decodeNativeValue(config.type, config.value)]));
+//#endregion
+//#region src/runtime/nitro/offline-values.ts
+var offline_values_default = defineEventHandler(() => {
+	const nitroApp = useNitroApp();
+	if (nitroApp.configDirectorConnectionMode !== "offline") throw createError({ statusCode: 404 });
+	return offlineValuesOf(nitroApp.configDirectorClient.getAllConfigs());
+});
+//#endregion
+export { offline_values_default as default };

package/dist/runtime/nitro/plugin.d.mts

@@ -1,4 +1,5 @@
-import { n as ConfigDirectorClient } from "../types-Bgx2-3dY.mjs";
+import { o as ConnectionMode } from "../native-values-BV2k_xR2.mjs";
+import { n as ConfigDirectorClient } from "../types-CS7AMNWe.mjs";
 import * as _$nitropack from "nitropack";
 
 //#region src/runtime/nitro/plugin.d.ts
@@ -6,6 +7,7 @@ declare const _default: _$nitropack.NitroAppPlugin;
 declare module "nitropack" {
   interface NitroApp {
     configDirectorClient: ConfigDirectorClient;
+    configDirectorConnectionMode: ConnectionMode;
     configDirectorInitialization: Promise<void>;
   }
 }

package/dist/runtime/nitro/plugin.d.ts

@@ -1,4 +1,5 @@
-import { n as ConfigDirectorClient } from "../types-Bgx2-3dY.mjs";
+import { o as ConnectionMode } from "../native-values-BV2k_xR2.mjs";
+import { n as ConfigDirectorClient } from "../types-CS7AMNWe.mjs";
 import * as _$nitropack from "nitropack";
 
 //#region src/runtime/nitro/plugin.d.ts
@@ -6,6 +7,7 @@ declare const _default: _$nitropack.NitroAppPlugin;
 declare module "nitropack" {
   interface NitroApp {
     configDirectorClient: ConfigDirectorClient;
+    configDirectorConnectionMode: ConnectionMode;
     configDirectorInitialization: Promise<void>;
   }
 }