@salesforce/storefront-next-runtime 0.4.2 → 1.0.0-alpha.0

package/README.md

@@ -55,9 +55,15 @@ Utilities and middleware for reading scoped entries from the MRT data access lay
 - `AWS_REGION` (required): AWS region for the data store table (e.g., `us-east-1`)
 - `MOBIFY_PROPERTY_ID` (required): MRT property identifier (e.g., `abcd1234`)
 - `DEPLOY_TARGET` (required): MRT deploy target (e.g., `production`)
-- `SFNEXT_DATA_STORE_UNAVAILABLE_MODE` (optional): controls middleware behavior when MRT data store is unavailable
-  - `throw` (default): fail fast by throwing
-  - `fallback`: use middleware-defined safe fallback values and continue request execution
+- `SFNEXT_DATA_STORE_UNAVAILABLE_MODE` (optional): controls built-in middleware behavior when the
+  MRT data store is unavailable or returns a service error
+  - `fallback` (default): use middleware-defined safe fallback values and continue request execution
+  - `throw`: opt back into fail-fast behavior — middleware throws and the request errors out
+
+  Applies to the four built-in middlewares (`customSitePreferencesMiddleware`,
+  `customGlobalPreferencesMiddleware`, `gcpPreferencesMiddleware`, `loginPreferencesMiddleware`).
+  Customer-authored middlewares created via `createDataStoreMiddleware` default to `'throw'`; pass
+  `onUnavailable: 'fallback'` and a `fallbackValue` to opt into graceful degradation.
 
 These are managed by Managed Runtime and are not typically set by SDK consumers directly.
 

package/dist/config.d.ts

@@ -1,61 +1,30 @@
 import { n as Site, r as Url, t as Locale } from "./types.js";
 import { n as DefineConfigOptions, r as defineConfig, t as BaseConfig } from "./schema.js";
-import * as react0 from "react";
 import { ReactNode } from "react";
-import * as react_jsx_runtime2 from "react/jsx-runtime";
-import * as react_router11 from "react-router";
-import { MiddlewareFunction, RouterContextProvider } from "react-router";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+import * as react_router0 from "react-router";
+import { RouterContextProvider } from "react-router";
 
-//#region src/config/get-config.d.ts
-
-declare global {
-  interface Window {
-    __APP_CONFIG__?: Record<string, unknown>;
-  }
-}
-/**
- * Get configuration in loaders, actions, and utilities.
- *
- * Pass context parameter in server loaders/actions.
- * Omit context parameter in client loaders (uses window.__APP_CONFIG__).
- *
- * @param context - Router context for server loaders/actions
- * @returns App configuration
- */
-declare function getConfig<T extends Record<string, unknown> = Record<string, unknown>>(context?: Readonly<RouterContextProvider>): T;
-/**
- * Get configuration in React components.
- *
- * Must use this hook (not getConfig) because React Context requires useContext().
- *
- * @returns App configuration
- */
-declare function useConfig<T extends Record<string, unknown> = Record<string, unknown>>(): T;
-//#endregion
 //#region src/config/context.d.ts
+
 /**
- * Router context for application configuration.
- *
- * Populated by `createAppConfigMiddleware` with the `app` section of config.
- * Accessible in loaders, actions, and middleware via `context.get(appConfigContext)`.
- */
-declare const appConfigContext: react_router11.RouterContext<Record<string, unknown>>;
-/**
- * React context for application configuration.
- *
- * Used by the `useConfig()` hook in React components.
- * Populated by `ConfigProvider` in the component tree.
+ * Augmentation hook for typing `getConfig()` / `useConfig()` /
+ * `appConfigContext`. Templates augment once via `declare module` so call
+ * sites don't need a per-call generic. Without augmentation, property
+ * accesses type to `unknown`. See README-CONFIG.md for the augmentation
+ * snippet and the multi-template caveat.
  */
-declare const ConfigContext: react0.Context<Record<string, unknown> | null>;
+interface AppConfigShape {
+  [key: string]: unknown;
+}
 /**
- * Extract the `app` section from a full config object.
- *
- * @param staticConfig - The full config object (output of `defineConfig()`)
- * @returns The `app` section of the config
+ * Router context for application configuration. Populated by the template's
+ * app-config middleware; read via `context.get(appConfigContext)` in loaders,
+ * actions, and other middleware. Returns the augmented `AppConfigShape`.
  */
-declare function createAppConfig<T extends BaseConfig>(staticConfig: T): T['app'];
+declare const appConfigContext: react_router0.RouterContext<AppConfigShape>;
 interface ConfigProviderProps {
-  config: Record<string, unknown>;
+  config: AppConfigShape;
   children: ReactNode;
 }
 /**
@@ -67,183 +36,26 @@ interface ConfigProviderProps {
 declare function ConfigProvider({
   config,
   children
-}: ConfigProviderProps): react_jsx_runtime2.JSX.Element;
-//#endregion
-//#region src/config/middleware.d.ts
-/**
- * Create app config middleware for both server and client.
- *
- * Follows the same factory pattern as `createSiteContextMiddleware`.
- *
- * The server middleware:
- * - Validates required Commerce API fields on first request (one-time)
- * - Sets `appConfigContext` in router context with `config.app`
- *
- * The client middleware:
- * - Reads `window.__APP_CONFIG__` (injected during SSR)
- * - Sets `appConfigContext` in router context
- *
- * Environment variables:
- * - `SCAPI_PROXY_HOST` (optional): When set, skips `shortCode` validation
- *   (workspace environments route through a proxy that doesn't require shortCode)
- * - `NODE_ENV` (optional): When set to 'test', skips validation entirely
- *
- * @param config - The full config object (output of `defineConfig()`)
- * @returns Object with `server` and `client` middleware functions
- *
- * @example
- * import { createAppConfigMiddleware } from '@salesforce/storefront-next-runtime/config';
- * import config from '@/config/server';
- *
- * const appConfigMiddleware = createAppConfigMiddleware(config);
- *
- * export const middleware = [appConfigMiddleware.server, ...otherMiddleware];
- * export const clientMiddleware = [appConfigMiddleware.client, ...otherClientMiddleware];
- */
-declare function createAppConfigMiddleware<T extends BaseConfig>(config: T): {
-  server: MiddlewareFunction<Response>;
-  client: MiddlewareFunction<Record<string, unknown>>;
-};
+}: ConfigProviderProps): react_jsx_runtime0.JSX.Element;
 //#endregion
-//#region src/config/utils.d.ts
-/**
- * Copyright 2026 Salesforce, Inc.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-/**
- * Deep merge two objects, with source values overriding target values
- * Arrays are replaced, not merged
- *
- * @param target - The base object
- * @param source - The object with values to merge in
- * @returns A new merged object
- *
- * @example
- * deepMerge(
- *   { a: { b: 1, c: 2 } },
- *   { a: { b: 3, d: 4 } }
- * )
- * // Returns: { a: { b: 3, c: 2, d: 4 } }
- */
-declare const deepMerge: <T extends Record<string, unknown>>(target: T, source: Record<string, unknown>) => T;
-/**
- * Convert a path string with double underscore separators to a nested object
- * Normalizes keys to match baseConfig casing (case-insensitive lookup, preserves baseConfig case)
- *
- * @param path - The path string (e.g., 'app__pages__cart__quantityUpdateDebounce')
- * @param value - The value to set at the path
- * @param baseConfig - Optional base config for case normalization
- * @returns A nested object
- *
- * @example
- * pathToObject('app__pages__cart__maxQuantity', 999)
- * // Returns: { app: { pages: { cart: { maxQuantity: 999 } } } }
- *
- * @example
- * // With baseConfig normalization:
- * pathToObject('APP__SITE__LOCALE', 'en-GB', { app: { site: { locale: 'en-GB' } } })
- * // Returns: { app: { site: { locale: 'en-GB' } } } (normalized to baseConfig casing)
- */
-declare const pathToObject: (path: string, value: unknown, baseConfig?: Record<string, unknown>) => Record<string, unknown>;
-/**
- * Parse environment variable value with optimistic JSON parsing
- * Tries to parse as JSON first, falls back to string if invalid
- * Supports multi-line formatted JSON by normalizing whitespace before parsing
- *
- * @param varValue - The environment variable value
- * @param varName - Optional variable name for better error messages
- * @returns The parsed value (JSON type if valid JSON, otherwise string)
- *
- * @example
- * // Primitives
- * parseEnvValue('42') // → 42 (number)
- * parseEnvValue('true') // → true (boolean)
- * parseEnvValue('hello') // → 'hello' (string)
- *
- * @example
- * // Single-line JSON
- * parseEnvValue('["Apple","Google"]') // → ['Apple', 'Google'] (array)
- * parseEnvValue('{"key":"value"}') // → {key: 'value'} (object)
- *
- * @example
- * // Multi-line formatted JSON (whitespace normalized automatically)
- * parseEnvValue('[
- *   {"id": "en-GB"},
- *   {"id": "fr-FR"}
- * ]') // → [{id: 'en-GB'}, {id: 'fr-FR'}] (array)
- */
-declare const parseEnvValue: (varValue: string, varName?: string) => unknown;
-/**
- * Extract all valid paths from a config object (recursively traverses the object structure)
- * Returns paths in lowercase with double underscore separators
- *
- * @param obj - The config object to extract paths from
- * @param prefix - Current path prefix (used for recursion)
- * @returns Array of valid config paths
- *
- * @example
- * extractValidPaths({ app: { site: { locale: 'en-GB' } } })
- * // Returns: ['app__site__locale']
- */
-declare const extractValidPaths: (obj: unknown, prefix?: string) => string[];
+//#region src/config/get-config.d.ts
+declare global {
+  interface Window {
+    __APP_CONFIG__?: Record<string, unknown>;
+  }
+}
 /**
- * Options for mergeEnvConfig
+ * Get configuration in loaders, actions, and utilities. Pass `context` on the
+ * server; omit it on the client (reads `window.__APP_CONFIG__`). Returns the
+ * augmented `AppConfigShape` — pass an explicit generic only for narrower or
+ * unrelated shapes (rare).
  */
-interface MergeEnvConfigOptions {
-  /**
-   * Config paths that cannot be overridden by environment variables.
-   * Paths are matched case-insensitively with double underscore separators.
-   * Any env var targeting a protected path or a sub-path of it will throw an error.
-   *
-   * @example ['app__engagement'] — prevents PUBLIC__app__engagement__* from being set via env
-   */
-  protectedPaths?: string[];
-}
+declare function getConfig<T extends Record<string, unknown> = AppConfigShape>(context?: Readonly<RouterContextProvider>): T;
 /**
- * Merge environment variables with PUBLIC__ prefix into config.
- *
- * Uses double underscore (__) to target nested config paths.
- * All PUBLIC__ prefixed variables are exposed to the client (bundled into window.__APP_CONFIG__).
- *
- * Server-only secrets should NEVER use this — read them directly from process.env in server code.
- *
- * Environment variables:
- * - `PUBLIC__<path>` (optional): Override any config path. e.g. `PUBLIC__app__commerce__api__clientId=abc123`
- * - `NODE_ENV` (optional): When set to 'development', enables conflict warnings for overlapping paths
- *
- * @param env - Environment variables object (defaults to process.env)
- * @param baseConfig - Optional base config for strict path validation and case normalization
- * @param options - Optional configuration including protected paths
- * @returns Object with overrides to merge into base config
- *
- * @example
- * // Environment variables:
- * // PUBLIC__app__commerce__api__clientId=abc123
- * // PUBLIC__app__pages__cart__quantityUpdateDebounce=1000
- * // PUBLIC__app__features__socialLogin__providers=["Apple","Google"]
- *
- * mergeEnvConfig()
- * // Returns:
- * // {
- * //   app: {
- * //     commerce: { api: { clientId: 'abc123' } },
- * //     pages: { cart: { quantityUpdateDebounce: 1000 } },
- * //     features: { socialLogin: { providers: ['Apple', 'Google'] } }
- * //   }
- * // }
+ * Get configuration in React components (use this instead of `getConfig` —
+ * React Context requires `useContext`). Returns the augmented `AppConfigShape`.
  */
-declare const mergeEnvConfig: (env?: Record<string, string | undefined>, baseConfig?: Record<string, unknown>, options?: MergeEnvConfigOptions) => Record<string, unknown>;
+declare function useConfig<T extends Record<string, unknown> = AppConfigShape>(): T;
 //#endregion
-export { type BaseConfig, ConfigContext, ConfigProvider, type DefineConfigOptions, type Locale, type MergeEnvConfigOptions, type Site, type Url, appConfigContext, createAppConfig, createAppConfigMiddleware, deepMerge, defineConfig, extractValidPaths, getConfig, mergeEnvConfig, parseEnvValue, pathToObject, useConfig };
+export { type AppConfigShape, type BaseConfig, ConfigProvider, type DefineConfigOptions, type Locale, type Site, type Url, appConfigContext, defineConfig, getConfig, useConfig };
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","names":[],"sources":["../src/config/get-config.ts","../src/config/context.tsx","../src/config/middleware.ts","../src/config/utils.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;QA2C8D,MAAA,CAAA;EACvC,UAAA,MAAA,CAAA;IAAT,cAAA,CAAA,EAdW,MAcX,CAAA,MAAA,EAAA,OAAA,CAAA;EACX;;AA+BH;;;;;;;;AC1CA;AASa,iBDAG,SCAU,CAAA,UDAU,MCAV,CAAA,MAAA,EAAA,OAAA,CAAA,GDAoC,MCApC,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,CAAA,OAAA,CAAA,EDCZ,QCDY,CDCH,qBCDG,CAAA,CAAA,EDEvB,CCFuB;AAS1B;;;;;AAEC;AAaD;AAAiC,iBDSjB,SCTiB,CAAA,UDSG,MCTH,CAAA,MAAA,EAAA,OAAA,CAAA,GDS6B,MCT7B,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,CAAA,CAAA,EDSyD,CCTzD;;;;;;;;;AAjCpB,cAAA,gBAAgB,EAAA,cAAA,CAAA,aAAA,CAAA,MAAA,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA;AAS7B;AASA;;;;;AAIU,cAbG,aAagB,EAbH,MAAA,CAAA,OAeH,CAfG,MAeH,CAAA,MAAA,EAAA,OAAA,CAAA,GAAA,IAAA,CAAA;AASvB;;;;;;iBAfgB,0BAA0B,0BAA0B,IAAI;UAI9D,mBAAA;UACE;ECPI,QAAA,EDQF,SCRE;;;;;;;;iBDiBA,cAAA;;;GAAqC,sBAAmB,kBAAA,CAAA,GAAA,CAAA;;;;;;;ADSxE;;;;;;;;AC1CA;AASA;AASA;;;;;AAEC;AAaD;;;;;;;;;ACjBA;AAAoD,iBAApC,yBAAoC,CAAA,UAAA,UAAA,CAAA,CAAA,MAAA,EACxC,CADwC,CAAA,EAAA;EACxC,MAAA,EAEA,kBAFA,CAEmB,QAFnB,CAAA;EAEmB,MAAA,EACnB,kBADmB,CACA,MADA,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA;CAAnB;;;;;;;;;;;;AF5B8C;;;;;AAkB1D;;;;;;;AAiCA;;;;;;;;AC1CA;AASa,cELA,SFKmE,EAAA,CAAtD,UELU,MFKV,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,CAAA,MAAA,EEL2C,CFK3C,EAAA,MAAA,EELsD,MFKtD,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,GELgF,CFKhF;AAS1B;;;;;AAEC;AAaD;;;;;;;;;ACjBA;;;AAG+B,cCoBlB,YDpBkB,EAAA,CAAA,IAAA,EAAA,MAAA,EAAA,KAAA,EAAA,OAAA,EAAA,UAAA,CAAA,ECuBd,MDvBc,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,GCwB5B,MDxB4B,CAAA,MAAA,EAAA,OAAA,CAAA;;;;;;;;ACf/B;;;;;;AAmCA;AAqEA;AAqCA;AAiCA;AA4CA;;;;;;;;;;cAlHa;;;;;;;;;;;;;cAqCA;;;;UAiCI,qBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA4CJ,uBACJ,iDACQ,mCACH,0BACX"}
+{"version":3,"file":"config.d.ts","names":[],"sources":["../src/config/context.tsx","../src/config/get-config.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;AC4EA;;AAA8D,UDtC7C,cAAA,CCsC6C;EAAmB,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,OAAA;;;;;;;cD5BpE,kBAAgB,aAAA,CAAA,cAAA;UAWnB,mBAAA;UACE;YACE;;;;;;;;iBASE,cAAA;;;GAAqC,sBAAmB,kBAAA,CAAA,GAAA,CAAA;;;;;ICtCzC,cAAA,CAAA,EAIN,MAJM,CAAA,MAAA,EAAA,OAAA,CAAA;EAAA;;;;AAc/B;;;;AACc,iBADE,SACF,CAAA,UADsB,MACtB,CAAA,MAAA,EAAA,OAAA,CAAA,GADgD,cAChD,CAAA,CAAA,OAAA,CAAA,EAAA,QAAA,CAAS,qBAAT,CAAA,CAAA,EACX,CADW;;;AA6Bd;;AAA8D,iBAA9C,SAA8C,CAAA,UAA1B,MAA0B,CAAA,MAAA,EAAA,OAAA,CAAA,GAAA,cAAA,CAAA,CAAA,CAAA,EAAmB,CAAnB"}

package/dist/config.js

@@ -182,18 +182,20 @@ const extractValidPaths = (obj, prefix = "") => {
 * @returns Object with overrides to merge into base config
 *
 * @example
-* // Environment variables:
-* // PUBLIC__app__commerce__api__clientId=abc123
-* // PUBLIC__app__pages__cart__quantityUpdateDebounce=1000
-* // PUBLIC__app__features__socialLogin__providers=["Apple","Google"]
+* // Environment variables (template-specific paths shown):
+* // PUBLIC__app__some__nested__value=abc123
+* // PUBLIC__app__some__numericKnob=1000
+* // PUBLIC__app__some__listKnob=["A","B"]
 *
 * mergeEnvConfig()
 * // Returns:
 * // {
 * //   app: {
-* //     commerce: { api: { clientId: 'abc123' } },
-* //     pages: { cart: { quantityUpdateDebounce: 1000 } },
-* //     features: { socialLogin: { providers: ['Apple', 'Google'] } }
+* //     some: {
+* //       nested: { value: 'abc123' },
+* //       numericKnob: 1000,
+* //       listKnob: ['A', 'B']
+* //     }
 * //   }
 * // }
 */
@@ -214,7 +216,7 @@ const mergeEnvConfig = (env = typeof process !== "undefined" ? process.env : {},
 		const depth = path.split("__").length;
 		if (depth > MAX_DEPTH) throw new Error(`Environment variable "${varName}" exceeds maximum path depth of ${MAX_DEPTH}. Current depth: ${depth}. Consider consolidating with JSON values or reducing nesting levels.`);
 		const normalizedPath = path.toLowerCase();
-		if (protectedPaths.some((protectedPath) => normalizedPath === protectedPath || normalizedPath.startsWith(`${protectedPath}__`))) throw new Error(`Environment variable "${varName}" attempts to override protected config path "${path}".\n\nThe engagement configuration cannot be overridden via environment variables. Update config.server.ts directly to change engagement settings.`);
+		if (protectedPaths.some((protectedPath) => normalizedPath === protectedPath || normalizedPath.startsWith(`${protectedPath}__`))) throw new Error(`Environment variable "${varName}" attempts to override protected config path "${path}".\n\nProtected paths cannot be overridden via environment variables. Update config.server.ts directly, or remove the path from \`protectedPaths\` if env override is intended.`);
 		if (baseConfig && validPaths.length > 0) {
 			if (!validPaths.includes(normalizedPath)) {
 				console.warn(`[Config Warning] Ignoring environment variable "${varName}": Config path "${path}" does not exist in config.server.ts.`);
@@ -256,15 +258,18 @@ const mergeEnvConfig = (env = typeof process !== "undefined" ? process.env : {},
 /**
 * Define a type-safe storefront configuration with IDE autocomplete.
 *
-* Automatically merges `PUBLIC__` prefixed environment variables into the config
-* at load time. Validates env vars against the base config structure (strict mode —
-* only allows overriding existing paths).
+* Reads `process.env` at call time and merges any `PUBLIC__`-prefixed
+* variables into the config (validated against the base config structure —
+* env vars targeting paths that don't exist in the base config are ignored
+* with a warning). This is a server-only side effect by design; calling
+* `defineConfig` from a browser bundle silently no-ops because `PUBLIC__`
+* vars are not present in the client environment.
 *
 * Environment variables:
 * - `PUBLIC__<path>` (optional): Override any config path using double underscore separators.
-*   e.g. `PUBLIC__app__commerce__api__clientId=abc123` maps to `config.app.commerce.api.clientId`
-* - `PUBLIC__app__pages__cart__quantityUpdateDebounce=1000` maps to a number (optimistic JSON parsing)
-* - `PUBLIC__app__features__socialLogin__providers=["Apple","Google"]` maps to an array
+*   e.g. `PUBLIC__app__some__nested__value=abc123` maps to `config.app.some.nested.value`
+* - JSON values are parsed optimistically: numbers, booleans, arrays, and objects all work.
+*   `PUBLIC__app__features__providers=["A","B"]` parses to an array.
 *
 * @param config - The base configuration object with all defaults
 * @param options - Optional settings (e.g., protectedPaths to prevent env var overrides)
@@ -277,10 +282,9 @@ const mergeEnvConfig = (env = typeof process !== "undefined" ? process.env : {},
 * export default defineConfig({
 *     metadata: { projectName: 'My Store', projectSlug: 'my-store' },
 *     app: {
-*         commerce: { api: { clientId: '', organizationId: '', shortCode: '' }, sites: [] },
-*         defaultSiteId: 'RefArch',
+*         // template-specific shape
 *     },
-* }, { protectedPaths: ['app__engagement'] });
+* }, { protectedPaths: ['app__analytics'] });
 */
 function defineConfig(config, options) {
 	return deepMerge(config, mergeEnvConfig(process.env, config, { protectedPaths: options?.protectedPaths }));
@@ -289,29 +293,19 @@ function defineConfig(config, options) {
 //#endregion
 //#region src/config/context.tsx
 /**
-* Router context for application configuration.
-*
-* Populated by `createAppConfigMiddleware` with the `app` section of config.
-* Accessible in loaders, actions, and middleware via `context.get(appConfigContext)`.
+* Router context for application configuration. Populated by the template's
+* app-config middleware; read via `context.get(appConfigContext)` in loaders,
+* actions, and other middleware. Returns the augmented `AppConfigShape`.
 */
 const appConfigContext = createContext$1();
 /**
-* React context for application configuration.
+* Internal React context backing `useConfig()`.
 *
-* Used by the `useConfig()` hook in React components.
-* Populated by `ConfigProvider` in the component tree.
+* Not exported from the public barrel — components must read config via
+* `useConfig()` so the React tree has a single source of truth.
 */
 const ConfigContext = createContext(null);
 /**
-* Extract the `app` section from a full config object.
-*
-* @param staticConfig - The full config object (output of `defineConfig()`)
-* @returns The `app` section of the config
-*/
-function createAppConfig(staticConfig) {
-	return staticConfig.app;
-}
-/**
 * React context provider for application configuration.
 *
 * Wrap your component tree with this to enable `useConfig()` in child components.
@@ -327,13 +321,10 @@ function ConfigProvider({ config, children }) {
 //#endregion
 //#region src/config/get-config.ts
 /**
-* Get configuration in loaders, actions, and utilities.
-*
-* Pass context parameter in server loaders/actions.
-* Omit context parameter in client loaders (uses window.__APP_CONFIG__).
-*
-* @param context - Router context for server loaders/actions
-* @returns App configuration
+* Get configuration in loaders, actions, and utilities. Pass `context` on the
+* server; omit it on the client (reads `window.__APP_CONFIG__`). Returns the
+* augmented `AppConfigShape` — pass an explicit generic only for narrower or
+* unrelated shapes (rare).
 */
 function getConfig(context) {
 	if (context) {
@@ -345,11 +336,8 @@ function getConfig(context) {
 	throw new Error("Configuration not available. This can happen if:\n1. Server: Pass context parameter: getConfig(context)\n2. Client: Ensure window.__APP_CONFIG__ was injected during SSR\n3. React component: Use useConfig() hook instead of getConfig()");
 }
 /**
-* Get configuration in React components.
-*
-* Must use this hook (not getConfig) because React Context requires useContext().
-*
-* @returns App configuration
+* Get configuration in React components (use this instead of `getConfig` —
+* React Context requires `useContext`). Returns the augmented `AppConfigShape`.
 */
 function useConfig() {
 	const config = useContext(ConfigContext);
@@ -358,75 +346,5 @@ function useConfig() {
 }
 
 //#endregion
-//#region src/config/middleware.ts
-/**
-* Create app config middleware for both server and client.
-*
-* Follows the same factory pattern as `createSiteContextMiddleware`.
-*
-* The server middleware:
-* - Validates required Commerce API fields on first request (one-time)
-* - Sets `appConfigContext` in router context with `config.app`
-*
-* The client middleware:
-* - Reads `window.__APP_CONFIG__` (injected during SSR)
-* - Sets `appConfigContext` in router context
-*
-* Environment variables:
-* - `SCAPI_PROXY_HOST` (optional): When set, skips `shortCode` validation
-*   (workspace environments route through a proxy that doesn't require shortCode)
-* - `NODE_ENV` (optional): When set to 'test', skips validation entirely
-*
-* @param config - The full config object (output of `defineConfig()`)
-* @returns Object with `server` and `client` middleware functions
-*
-* @example
-* import { createAppConfigMiddleware } from '@salesforce/storefront-next-runtime/config';
-* import config from '@/config/server';
-*
-* const appConfigMiddleware = createAppConfigMiddleware(config);
-*
-* export const middleware = [appConfigMiddleware.server, ...otherMiddleware];
-* export const clientMiddleware = [appConfigMiddleware.client, ...otherClientMiddleware];
-*/
-function createAppConfigMiddleware(config) {
-	let validationRun = false;
-	function validateConfig() {
-		if (validationRun || process.env.NODE_ENV === "test") return;
-		const api = config.app.commerce?.api;
-		const required = {
-			clientId: api?.clientId ?? "",
-			organizationId: api?.organizationId ?? ""
-		};
-		if (!process.env.SCAPI_PROXY_HOST) required.shortCode = api?.shortCode ?? "";
-		const missing = Object.entries(required).filter(([_, value]) => !value).map(([key]) => key);
-		if (missing.length > 0) {
-			const envVarMap = {
-				clientId: "PUBLIC__app__commerce__api__clientId",
-				organizationId: "PUBLIC__app__commerce__api__organizationId",
-				shortCode: "PUBLIC__app__commerce__api__shortCode"
-			};
-			throw new Error(`Missing required Commerce API configuration: ${missing.join(", ")}\n\nSet these environment variables in your MRT deployment or .env file:\n${missing.map((key) => `  ${envVarMap[key]}=your-value`).join("\n")}\n\nExample .env file:\nPUBLIC__app__commerce__api__clientId=your-client-id\nPUBLIC__app__commerce__api__organizationId=your-org-id\nPUBLIC__app__commerce__api__shortCode=your-short-code\n\nSee docs/README-CONFIG.md for complete configuration documentation.`);
-		}
-		validationRun = true;
-	}
-	const server = ({ context }, next) => {
-		validateConfig();
-		context.set(appConfigContext, config.app);
-		return next();
-	};
-	const client = async ({ context }, next) => {
-		const appConfig = typeof window !== "undefined" ? window.__APP_CONFIG__ : void 0;
-		if (!appConfig) throw new Error("window.__APP_CONFIG__ not available. Check that server loader is injecting config into HTML via Layout component.");
-		context.set(appConfigContext, appConfig);
-		return next();
-	};
-	return {
-		server,
-		client
-	};
-}
-
-//#endregion
-export { ConfigContext, ConfigProvider, appConfigContext, createAppConfig, createAppConfigMiddleware, deepMerge, defineConfig, extractValidPaths, getConfig, mergeEnvConfig, parseEnvValue, pathToObject, useConfig };
+export { ConfigProvider, appConfigContext, defineConfig, getConfig, useConfig };
 //# sourceMappingURL=config.js.map