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

package/dist/custom-site-preferences.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"custom-site-preferences.js","names":[],"sources":["../src/data-store/middleware/custom-site-preferences.ts"],"sourcesContent":["/**\n * Copyright 2026 Salesforce, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { RouterContextProvider } from 'react-router';\nimport { createDataStoreContext, createDataStoreMiddleware, prefixWithSiteId } from '../utils';\n\nexport type SitePreferences = Record<string, unknown>;\n\nexport const DEFAULT_SITE_PREFERENCES_KEY = 'site-preferences';\nexport const sitePreferencesContext = createDataStoreContext<SitePreferences>();\nconst DATA_STORE_UNAVAILABLE_MODE = process.env.SFNEXT_DATA_STORE_UNAVAILABLE_MODE;\n\n/**\n * Read site preferences from router context.\n *\n * @param context - Router context provider\n * @returns Site preferences data stored by data-store middleware\n * @throws Error when the data-store context is not available\n */\nexport function getSitePreferences(context: Readonly<RouterContextProvider>): SitePreferences {\n    const data = context.get(sitePreferencesContext);\n    if (!data) {\n        // eslint-disable-next-line no-console\n        console.warn(\n            'Data store context not found. Ensure data-store middleware runs before loaders and the required env vars are set.'\n        );\n        return {};\n    }\n    return data;\n}\n\nexport const customSitePreferencesMiddleware = createDataStoreMiddleware({\n    entryKey: prefixWithSiteId('custom-site-preferences'),\n    context: sitePreferencesContext,\n    onUnavailable: DATA_STORE_UNAVAILABLE_MODE === 'fallback' ? 'fallback' : 'throw',\n    fallbackValue: {},\n});\n"],"mappings":";;;AAqBA,MAAa,+BAA+B;AAC5C,MAAa,yBAAyB,wBAAyC;AAC/E,MAAM,8BAA8B,QAAQ,IAAI;;;;;;;;AAShD,SAAgB,mBAAmB,SAA2D;CAC1F,MAAM,OAAO,QAAQ,IAAI,uBAAuB;AAChD,KAAI,CAAC,MAAM;AAEP,UAAQ,KACJ,oHACH;AACD,SAAO,EAAE;;AAEb,QAAO;;AAGX,MAAa,kCAAkC,0BAA0B;CACrE,UAAU,iBAAiB,0BAA0B;CACrD,SAAS;CACT,eAAe,gCAAgC,aAAa,aAAa;CACzE,eAAe,EAAE;CACpB,CAAC"}

package/dist/data-store-custom-global-preferences.d.ts

@@ -1,2 +0,0 @@
-import { a as getCustomGlobalPreferences, i as customGlobalPreferencesMiddleware, n as DEFAULT_CUSTOM_GLOBAL_PREFERENCES_KEY, r as customGlobalPreferencesContext, t as CustomGlobalPreferences } from "./custom-global-preferences.js";
-export { CustomGlobalPreferences, DEFAULT_CUSTOM_GLOBAL_PREFERENCES_KEY, customGlobalPreferencesContext, customGlobalPreferencesMiddleware, getCustomGlobalPreferences };

package/dist/data-store-custom-global-preferences.js

@@ -1,6 +0,0 @@
-import "./site-context2.js";
-import "./apply-url-config.js";
-import "./utils.js";
-import { i as getCustomGlobalPreferences, n as customGlobalPreferencesContext, r as customGlobalPreferencesMiddleware, t as DEFAULT_CUSTOM_GLOBAL_PREFERENCES_KEY } from "./custom-global-preferences.js";
-
-export { DEFAULT_CUSTOM_GLOBAL_PREFERENCES_KEY, customGlobalPreferencesContext, customGlobalPreferencesMiddleware, getCustomGlobalPreferences };

package/dist/data-store-custom-site-preferences.d.ts

@@ -1,2 +0,0 @@
-import { a as sitePreferencesContext, i as getSitePreferences, n as SitePreferences, r as customSitePreferencesMiddleware, t as DEFAULT_SITE_PREFERENCES_KEY } from "./custom-site-preferences.js";
-export { DEFAULT_SITE_PREFERENCES_KEY, SitePreferences, customSitePreferencesMiddleware, getSitePreferences, sitePreferencesContext };

package/dist/data-store-custom-site-preferences.js

@@ -1,6 +0,0 @@
-import "./site-context2.js";
-import "./apply-url-config.js";
-import "./utils.js";
-import { i as sitePreferencesContext, n as customSitePreferencesMiddleware, r as getSitePreferences, t as DEFAULT_SITE_PREFERENCES_KEY } from "./custom-site-preferences.js";
-
-export { DEFAULT_SITE_PREFERENCES_KEY, customSitePreferencesMiddleware, getSitePreferences, sitePreferencesContext };

package/dist/data-store-gcp-preferences.d.ts

@@ -1,2 +0,0 @@
-import { a as getGcpApiKey, i as gcpPreferencesMiddleware, n as GcpPreferences, o as getGcpPreferences, r as gcpPreferencesContext, t as DEFAULT_GCP_PREFERENCES_KEY } from "./gcp-preferences.js";
-export { DEFAULT_GCP_PREFERENCES_KEY, GcpPreferences, gcpPreferencesContext, gcpPreferencesMiddleware, getGcpApiKey, getGcpPreferences };

package/dist/data-store-gcp-preferences.js

@@ -1,6 +0,0 @@
-import "./site-context2.js";
-import "./apply-url-config.js";
-import "./utils.js";
-import { a as getGcpPreferences, i as getGcpApiKey, n as gcpPreferencesContext, r as gcpPreferencesMiddleware, t as DEFAULT_GCP_PREFERENCES_KEY } from "./gcp-preferences.js";
-
-export { DEFAULT_GCP_PREFERENCES_KEY, gcpPreferencesContext, gcpPreferencesMiddleware, getGcpApiKey, getGcpPreferences };

package/dist/gcp-preferences.d.ts

@@ -1,52 +0,0 @@
-import * as react_router1 from "react-router";
-import { RouterContextProvider } from "react-router";
-
-//#region src/data-store/middleware/gcp-preferences.d.ts
-
-/**
- * OOTB Google Cloud Platform preferences sourced from the MRT data store.
- *
- * Additional fields (e.g. `projectId`, `region`) may be added here as the
- * ECOM MRT sync job expands the `gcp` entry. Consumers should read the
- * object as a whole via `getGcpPreferences`, or use a specific convenience
- * getter like `getGcpApiKey` for a single field.
- */
-type GcpPreferences = {
-  apiKey: string;
-};
-declare const DEFAULT_GCP_PREFERENCES_KEY = "gcp";
-declare const gcpPreferencesContext: react_router1.RouterContext<GcpPreferences | null>;
-/**
- * Read the GCP (Google Cloud Platform) preferences object from router context.
- *
- * The preferences are sourced from the MRT data store entry `gcp`, which is
- * populated only for storefronts connecting to production ECOM instances.
- * In non-production environments, or when the entry is missing, returns an
- * object whose fields are all empty/default.
- *
- * @param context - Router context provider
- * @returns GCP preferences object; fields are empty/default when the entry is unavailable
- */
-declare function getGcpPreferences(context: Readonly<RouterContextProvider>): GcpPreferences;
-/**
- * Convenience getter for the Google Cloud API key alone.
- *
- * Equivalent to `getGcpPreferences(context).apiKey`.
- *
- * @param context - Router context provider
- * @returns The GCP API key, or an empty string when unavailable
- */
-declare function getGcpApiKey(context: Readonly<RouterContextProvider>): string;
-/**
- * Middleware that reads the OOTB GCP preferences from the MRT data store and
- * stores them in the router context. The entry shape is `{ "api-key": string, ... }`
- * under data store key `gcp`. Missing/invalid fields coerce to empty/default values.
- *
- * Only available for storefronts connecting to production ECOM instances.
- * Must run before any loader/middleware that reads `getGcpPreferences(context)`
- * or `getGcpApiKey(context)`.
- */
-declare const gcpPreferencesMiddleware: react_router1.MiddlewareFunction<Response>;
-//#endregion
-export { getGcpApiKey as a, gcpPreferencesMiddleware as i, GcpPreferences as n, getGcpPreferences as o, gcpPreferencesContext as r, DEFAULT_GCP_PREFERENCES_KEY as t };
-//# sourceMappingURL=gcp-preferences.d.ts.map

package/dist/gcp-preferences.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"gcp-preferences.d.ts","names":[],"sources":["../src/data-store/middleware/gcp-preferences.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;KA2BY,cAAA;;;cAIC,2BAAA;cASA,uBAAqB,aAAA,CAAA,cAAA;;;;;;;;;;;;iBAalB,iBAAA,UAA2B,SAAS,yBAAyB;;;;;;;;;iBAoB7D,YAAA,UAAsB,SAAS;;;;;;;;;;cAalC,0BAAwB,aAAA,CAAA,mBAAA"}

package/dist/gcp-preferences.js

@@ -1,64 +0,0 @@
-import { n as createDataStoreMiddleware, t as createDataStoreContext } from "./utils.js";
-
-//#region src/data-store/middleware/gcp-preferences.ts
-const DEFAULT_GCP_PREFERENCES_KEY = "gcp";
-const DATA_STORE_UNAVAILABLE_MODE = process.env.SFNEXT_DATA_STORE_UNAVAILABLE_MODE;
-/**
-* Map keys inside the `gcp` data store entry. The ECOM MRT sync job writes
-* to these exact keys; keep in sync with the sync job contract.
-*/
-const API_KEY_MAP_KEY = "api-key";
-const gcpPreferencesContext = createDataStoreContext();
-/**
-* Read the GCP (Google Cloud Platform) preferences object from router context.
-*
-* The preferences are sourced from the MRT data store entry `gcp`, which is
-* populated only for storefronts connecting to production ECOM instances.
-* In non-production environments, or when the entry is missing, returns an
-* object whose fields are all empty/default.
-*
-* @param context - Router context provider
-* @returns GCP preferences object; fields are empty/default when the entry is unavailable
-*/
-function getGcpPreferences(context) {
-	const data = context.get(gcpPreferencesContext);
-	if (data === null) {
-		console.warn("GCP preferences context not found. Ensure gcpPreferencesMiddleware runs before loaders, or expect empty values in environments without the MRT data store entry.");
-		return { apiKey: "" };
-	}
-	return data;
-}
-/**
-* Convenience getter for the Google Cloud API key alone.
-*
-* Equivalent to `getGcpPreferences(context).apiKey`.
-*
-* @param context - Router context provider
-* @returns The GCP API key, or an empty string when unavailable
-*/
-function getGcpApiKey(context) {
-	return getGcpPreferences(context).apiKey;
-}
-/**
-* Middleware that reads the OOTB GCP preferences from the MRT data store and
-* stores them in the router context. The entry shape is `{ "api-key": string, ... }`
-* under data store key `gcp`. Missing/invalid fields coerce to empty/default values.
-*
-* Only available for storefronts connecting to production ECOM instances.
-* Must run before any loader/middleware that reads `getGcpPreferences(context)`
-* or `getGcpApiKey(context)`.
-*/
-const gcpPreferencesMiddleware = createDataStoreMiddleware({
-	entryKey: DEFAULT_GCP_PREFERENCES_KEY,
-	context: gcpPreferencesContext,
-	onUnavailable: DATA_STORE_UNAVAILABLE_MODE === "fallback" ? "fallback" : "throw",
-	fallbackValue: { apiKey: "" },
-	transform: (value) => {
-		const rawKey = value[API_KEY_MAP_KEY];
-		return { apiKey: typeof rawKey === "string" ? rawKey : "" };
-	}
-});
-
-//#endregion
-export { getGcpPreferences as a, getGcpApiKey as i, gcpPreferencesContext as n, gcpPreferencesMiddleware as r, DEFAULT_GCP_PREFERENCES_KEY as t };
-//# sourceMappingURL=gcp-preferences.js.map

package/dist/gcp-preferences.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"gcp-preferences.js","names":[],"sources":["../src/data-store/middleware/gcp-preferences.ts"],"sourcesContent":["/**\n * Copyright 2026 Salesforce, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { RouterContextProvider } from 'react-router';\nimport { createDataStoreContext, createDataStoreMiddleware } from '../utils';\n\n/**\n * OOTB Google Cloud Platform preferences sourced from the MRT data store.\n *\n * Additional fields (e.g. `projectId`, `region`) may be added here as the\n * ECOM MRT sync job expands the `gcp` entry. Consumers should read the\n * object as a whole via `getGcpPreferences`, or use a specific convenience\n * getter like `getGcpApiKey` for a single field.\n */\nexport type GcpPreferences = {\n    apiKey: string;\n};\n\nexport const DEFAULT_GCP_PREFERENCES_KEY = 'gcp';\nconst DATA_STORE_UNAVAILABLE_MODE = process.env.SFNEXT_DATA_STORE_UNAVAILABLE_MODE;\n\n/**\n * Map keys inside the `gcp` data store entry. The ECOM MRT sync job writes\n * to these exact keys; keep in sync with the sync job contract.\n */\nconst API_KEY_MAP_KEY = 'api-key';\n\nexport const gcpPreferencesContext = createDataStoreContext<GcpPreferences>();\n\n/**\n * Read the GCP (Google Cloud Platform) preferences object from router context.\n *\n * The preferences are sourced from the MRT data store entry `gcp`, which is\n * populated only for storefronts connecting to production ECOM instances.\n * In non-production environments, or when the entry is missing, returns an\n * object whose fields are all empty/default.\n *\n * @param context - Router context provider\n * @returns GCP preferences object; fields are empty/default when the entry is unavailable\n */\nexport function getGcpPreferences(context: Readonly<RouterContextProvider>): GcpPreferences {\n    const data = context.get(gcpPreferencesContext);\n    if (data === null) {\n        // eslint-disable-next-line no-console\n        console.warn(\n            'GCP preferences context not found. Ensure gcpPreferencesMiddleware runs before loaders, or expect empty values in environments without the MRT data store entry.'\n        );\n        return { apiKey: '' };\n    }\n    return data;\n}\n\n/**\n * Convenience getter for the Google Cloud API key alone.\n *\n * Equivalent to `getGcpPreferences(context).apiKey`.\n *\n * @param context - Router context provider\n * @returns The GCP API key, or an empty string when unavailable\n */\nexport function getGcpApiKey(context: Readonly<RouterContextProvider>): string {\n    return getGcpPreferences(context).apiKey;\n}\n\n/**\n * Middleware that reads the OOTB GCP preferences from the MRT data store and\n * stores them in the router context. The entry shape is `{ \"api-key\": string, ... }`\n * under data store key `gcp`. Missing/invalid fields coerce to empty/default values.\n *\n * Only available for storefronts connecting to production ECOM instances.\n * Must run before any loader/middleware that reads `getGcpPreferences(context)`\n * or `getGcpApiKey(context)`.\n */\nexport const gcpPreferencesMiddleware = createDataStoreMiddleware<GcpPreferences>({\n    entryKey: DEFAULT_GCP_PREFERENCES_KEY,\n    context: gcpPreferencesContext,\n    onUnavailable: DATA_STORE_UNAVAILABLE_MODE === 'fallback' ? 'fallback' : 'throw',\n    fallbackValue: { apiKey: '' },\n    transform: (value) => {\n        const rawKey = value[API_KEY_MAP_KEY];\n        return { apiKey: typeof rawKey === 'string' ? rawKey : '' };\n    },\n});\n"],"mappings":";;;AA+BA,MAAa,8BAA8B;AAC3C,MAAM,8BAA8B,QAAQ,IAAI;;;;;AAMhD,MAAM,kBAAkB;AAExB,MAAa,wBAAwB,wBAAwC;;;;;;;;;;;;AAa7E,SAAgB,kBAAkB,SAA0D;CACxF,MAAM,OAAO,QAAQ,IAAI,sBAAsB;AAC/C,KAAI,SAAS,MAAM;AAEf,UAAQ,KACJ,mKACH;AACD,SAAO,EAAE,QAAQ,IAAI;;AAEzB,QAAO;;;;;;;;;;AAWX,SAAgB,aAAa,SAAkD;AAC3E,QAAO,kBAAkB,QAAQ,CAAC;;;;;;;;;;;AAYtC,MAAa,2BAA2B,0BAA0C;CAC9E,UAAU;CACV,SAAS;CACT,eAAe,gCAAgC,aAAa,aAAa;CACzE,eAAe,EAAE,QAAQ,IAAI;CAC7B,YAAY,UAAU;EAClB,MAAM,SAAS,MAAM;AACrB,SAAO,EAAE,QAAQ,OAAO,WAAW,WAAW,SAAS,IAAI;;CAElE,CAAC"}

package/dist/utils.js

@@ -1,90 +0,0 @@
-import { i as siteContext } from "./site-context2.js";
-import { createContext } from "react-router";
-import { DataStore, DataStoreNotFoundError, DataStoreServiceError, DataStoreUnavailableError } from "@salesforce/mrt-utilities/data-store";
-
-//#region src/data-store/utils.ts
-/**
-* Creates a typed React Router context for data store entries.
-*
-* Initializes the context with `null` so middleware can populate it during requests.
-*
-* @returns React Router context key for data store values
-*/
-function createDataStoreContext() {
-	return createContext(null);
-}
-/**
-* Creates a data-store middleware that fetches site preferences from MRT data access layer
-* and stores them in the router context.
-*
-* Environment variables:
-* - `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")
-*
-* @param options - Middleware options for data store entry and context
-* @returns React Router middleware for server requests
-*/
-function createDataStoreMiddleware(options) {
-	const { entryKey, context: contextKey, onUnavailable = "throw", fallbackValue } = options;
-	const transform = options.transform ?? ((value) => value);
-	const dataStoreMiddleware = async ({ context }, next) => {
-		const resolvedEntryKey = typeof entryKey === "function" ? entryKey(context) : entryKey;
-		try {
-			const entry = await getDataStoreEntry(resolvedEntryKey);
-			if (!entry?.value || typeof entry.value !== "object") {
-				console.warn(`Data store entry '${resolvedEntryKey}' not found or invalid.`);
-				return next();
-			}
-			context.set(contextKey, transform(entry.value));
-		} catch (error) {
-			if (error instanceof DataStoreUnavailableError) {
-				if (onUnavailable === "fallback" && typeof fallbackValue !== "undefined") {
-					const resolvedFallbackValue = typeof fallbackValue === "function" ? fallbackValue(context) : fallbackValue;
-					context.set(contextKey, resolvedFallbackValue);
-					console.warn(`Data store unavailable for '${resolvedEntryKey}'. Using configured fallback value.`);
-					return next();
-				}
-				throw new Error("Data store is unavailable. Ensure AWS_REGION, MOBIFY_PROPERTY_ID, and DEPLOY_TARGET are set.");
-			}
-			if (error instanceof DataStoreNotFoundError) {
-				console.warn(`Data store entry '${resolvedEntryKey}' not found.`);
-				return next();
-			}
-			if (error instanceof DataStoreServiceError) throw new Error(`Data store request failed for '${resolvedEntryKey}'.`);
-			throw error;
-		}
-		return next();
-	};
-	return dataStoreMiddleware;
-}
-/**
-* Read a data-store entry through the singleton MRT utilities API.
-* The underlying implementation (production DynamoDB vs development pseudo store)
-* is resolved by `@salesforce/mrt-utilities/data-store` export conditions.
-*
-* @param key - Data-store entry key
-* @returns Data-store entry or null when missing/invalid shape
-*/
-async function getDataStoreEntry(key) {
-	const entry = await DataStore.getDataStore().getEntry(key);
-	if (!entry || typeof entry !== "object") return null;
-	return entry;
-}
-/**
-* Creates an entryKey function that prefixes the given suffix with the current site ID.
-*
-* @param suffix - The entry key suffix (e.g., "custom-site-preferences")
-* @returns A function compatible with `DataStoreMiddlewareOptions.entryKey`
-*/
-function prefixWithSiteId(suffix) {
-	return (context) => {
-		const siteId = context.get(siteContext)?.site?.id;
-		if (!siteId) throw new Error("Site id not found. Ensure site context middleware runs before data-store middleware.");
-		return `${siteId}-${suffix}`;
-	};
-}
-
-//#endregion
-export { prefixWithSiteId as i, createDataStoreMiddleware as n, getDataStoreEntry as r, createDataStoreContext as t };
-//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.js","names":["dataStoreMiddleware: MiddlewareFunction<Response>"],"sources":["../src/data-store/utils.ts"],"sourcesContent":["/**\n * Copyright 2026 Salesforce, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { type MiddlewareFunction, type RouterContextProvider, createContext } from 'react-router';\nimport {\n    DataStore,\n    DataStoreNotFoundError,\n    DataStoreServiceError,\n    DataStoreUnavailableError,\n} from '@salesforce/mrt-utilities/data-store';\nimport { siteContext } from '../site-context';\n\nexport type DataStoreContextKey<T> = ReturnType<typeof createContext<T | null>>;\n\nexport type DataStoreEntryKey = string | ((context: Readonly<RouterContextProvider>) => string);\n\nexport type DataStoreEntry<TValue = unknown> = {\n    value?: TValue;\n};\n\nexport type DataStoreMiddlewareOptions<T> = {\n    entryKey: DataStoreEntryKey;\n    context: DataStoreContextKey<T>;\n    transform?: (value: Record<string, unknown>) => T;\n    onUnavailable?: 'throw' | 'fallback';\n    fallbackValue?: T | ((context: Readonly<RouterContextProvider>) => T);\n};\n\n/**\n * Creates a typed React Router context for data store entries.\n *\n * Initializes the context with `null` so middleware can populate it during requests.\n *\n * @returns React Router context key for data store values\n */\nexport function createDataStoreContext<T>(): DataStoreContextKey<T> {\n    return createContext<T | null>(null);\n}\n\n/**\n * Creates a data-store middleware that fetches site preferences from MRT data access layer\n * and stores them in the router context.\n *\n * Environment variables:\n * - `AWS_REGION` (required): AWS region for the data store table (e.g., \"us-east-1\")\n * - `MOBIFY_PROPERTY_ID` (required): MRT property identifier (e.g., \"abcd1234\")\n * - `DEPLOY_TARGET` (required): MRT deploy target (e.g., \"production\")\n *\n * @param options - Middleware options for data store entry and context\n * @returns React Router middleware for server requests\n */\nexport function createDataStoreMiddleware<T>(options: DataStoreMiddlewareOptions<T>): MiddlewareFunction<Response> {\n    const { entryKey, context: contextKey, onUnavailable = 'throw', fallbackValue } = options;\n    const transform = options.transform ?? ((value: Record<string, unknown>) => value as T);\n\n    const dataStoreMiddleware: MiddlewareFunction<Response> = async ({ context }, next) => {\n        const resolvedEntryKey = typeof entryKey === 'function' ? entryKey(context) : entryKey;\n        try {\n            const entry = await getDataStoreEntry(resolvedEntryKey);\n\n            if (!entry?.value || typeof entry.value !== 'object') {\n                // eslint-disable-next-line no-console\n                console.warn(`Data store entry '${resolvedEntryKey}' not found or invalid.`);\n                return next();\n            }\n            context.set(contextKey, transform(entry.value as Record<string, unknown>));\n        } catch (error) {\n            if (error instanceof DataStoreUnavailableError) {\n                if (onUnavailable === 'fallback' && typeof fallbackValue !== 'undefined') {\n                    const resolvedFallbackValue =\n                        typeof fallbackValue === 'function'\n                            ? (fallbackValue as (ctx: Readonly<RouterContextProvider>) => T)(context)\n                            : fallbackValue;\n                    context.set(contextKey, resolvedFallbackValue);\n                    // eslint-disable-next-line no-console\n                    console.warn(`Data store unavailable for '${resolvedEntryKey}'. Using configured fallback value.`);\n                    return next();\n                }\n                throw new Error(\n                    'Data store is unavailable. Ensure AWS_REGION, MOBIFY_PROPERTY_ID, and DEPLOY_TARGET are set.'\n                );\n            }\n            if (error instanceof DataStoreNotFoundError) {\n                // eslint-disable-next-line no-console\n                console.warn(`Data store entry '${resolvedEntryKey}' not found.`);\n                return next();\n            }\n            if (error instanceof DataStoreServiceError) {\n                throw new Error(`Data store request failed for '${resolvedEntryKey}'.`);\n            }\n            throw error;\n        }\n\n        return next();\n    };\n\n    return dataStoreMiddleware;\n}\n\n/**\n * Read a data-store entry through the singleton MRT utilities API.\n * The underlying implementation (production DynamoDB vs development pseudo store)\n * is resolved by `@salesforce/mrt-utilities/data-store` export conditions.\n *\n * @param key - Data-store entry key\n * @returns Data-store entry or null when missing/invalid shape\n */\nexport async function getDataStoreEntry<TValue = unknown>(key: string): Promise<DataStoreEntry<TValue> | null> {\n    const entry = (await DataStore.getDataStore().getEntry(key)) as DataStoreEntry<TValue> | undefined;\n    if (!entry || typeof entry !== 'object') {\n        return null;\n    }\n    return entry;\n}\n\n/**\n * Creates an entryKey function that prefixes the given suffix with the current site ID.\n *\n * @param suffix - The entry key suffix (e.g., \"custom-site-preferences\")\n * @returns A function compatible with `DataStoreMiddlewareOptions.entryKey`\n */\nexport function prefixWithSiteId(suffix: string): (context: Readonly<RouterContextProvider>) => string {\n    return (context) => {\n        const siteId = context.get(siteContext)?.site?.id;\n        if (!siteId)\n            throw new Error('Site id not found. Ensure site context middleware runs before data-store middleware.');\n        return `${siteId}-${suffix}`;\n    };\n}\n"],"mappings":";;;;;;;;;;;;AAgDA,SAAgB,yBAAoD;AAChE,QAAO,cAAwB,KAAK;;;;;;;;;;;;;;AAexC,SAAgB,0BAA6B,SAAsE;CAC/G,MAAM,EAAE,UAAU,SAAS,YAAY,gBAAgB,SAAS,kBAAkB;CAClF,MAAM,YAAY,QAAQ,eAAe,UAAmC;CAE5E,MAAMA,sBAAoD,OAAO,EAAE,WAAW,SAAS;EACnF,MAAM,mBAAmB,OAAO,aAAa,aAAa,SAAS,QAAQ,GAAG;AAC9E,MAAI;GACA,MAAM,QAAQ,MAAM,kBAAkB,iBAAiB;AAEvD,OAAI,CAAC,OAAO,SAAS,OAAO,MAAM,UAAU,UAAU;AAElD,YAAQ,KAAK,qBAAqB,iBAAiB,yBAAyB;AAC5E,WAAO,MAAM;;AAEjB,WAAQ,IAAI,YAAY,UAAU,MAAM,MAAiC,CAAC;WACrE,OAAO;AACZ,OAAI,iBAAiB,2BAA2B;AAC5C,QAAI,kBAAkB,cAAc,OAAO,kBAAkB,aAAa;KACtE,MAAM,wBACF,OAAO,kBAAkB,aAClB,cAA8D,QAAQ,GACvE;AACV,aAAQ,IAAI,YAAY,sBAAsB;AAE9C,aAAQ,KAAK,+BAA+B,iBAAiB,qCAAqC;AAClG,YAAO,MAAM;;AAEjB,UAAM,IAAI,MACN,+FACH;;AAEL,OAAI,iBAAiB,wBAAwB;AAEzC,YAAQ,KAAK,qBAAqB,iBAAiB,cAAc;AACjE,WAAO,MAAM;;AAEjB,OAAI,iBAAiB,sBACjB,OAAM,IAAI,MAAM,kCAAkC,iBAAiB,IAAI;AAE3E,SAAM;;AAGV,SAAO,MAAM;;AAGjB,QAAO;;;;;;;;;;AAWX,eAAsB,kBAAoC,KAAqD;CAC3G,MAAM,QAAS,MAAM,UAAU,cAAc,CAAC,SAAS,IAAI;AAC3D,KAAI,CAAC,SAAS,OAAO,UAAU,SAC3B,QAAO;AAEX,QAAO;;;;;;;;AASX,SAAgB,iBAAiB,QAAsE;AACnG,SAAQ,YAAY;EAChB,MAAM,SAAS,QAAQ,IAAI,YAAY,EAAE,MAAM;AAC/C,MAAI,CAAC,OACD,OAAM,IAAI,MAAM,uFAAuF;AAC3G,SAAO,GAAG,OAAO,GAAG"}