@vue-storefront/next 7.0.2 → 8.0.0-next.4

package/dist/asyncToGenerator-BI_VpA62.cjs

@@ -0,0 +1,32 @@
+//#region \0@oxc-project+runtime@0.115.0/helpers/asyncToGenerator.js
+function asyncGeneratorStep(n, t, e, r, o, a, c) {
+	try {
+		var i = n[a](c), u = i.value;
+	} catch (n) {
+		e(n);
+		return;
+	}
+	i.done ? t(u) : Promise.resolve(u).then(r, o);
+}
+function _asyncToGenerator(n) {
+	return function() {
+		var t = this, e = arguments;
+		return new Promise(function(r, o) {
+			var a = n.apply(t, e);
+			function _next(n) {
+				asyncGeneratorStep(a, r, o, _next, _throw, "next", n);
+			}
+			function _throw(n) {
+				asyncGeneratorStep(a, r, o, _next, _throw, "throw", n);
+			}
+			_next(void 0);
+		});
+	};
+}
+//#endregion
+Object.defineProperty(exports, "_asyncToGenerator", {
+	enumerable: true,
+	get: function() {
+		return _asyncToGenerator;
+	}
+});

package/dist/asyncToGenerator-Co5zHbo3.mjs

@@ -0,0 +1,27 @@
+//#region \0@oxc-project+runtime@0.115.0/helpers/asyncToGenerator.js
+function asyncGeneratorStep(n, t, e, r, o, a, c) {
+	try {
+		var i = n[a](c), u = i.value;
+	} catch (n) {
+		e(n);
+		return;
+	}
+	i.done ? t(u) : Promise.resolve(u).then(r, o);
+}
+function _asyncToGenerator(n) {
+	return function() {
+		var t = this, e = arguments;
+		return new Promise(function(r, o) {
+			var a = n.apply(t, e);
+			function _next(n) {
+				asyncGeneratorStep(a, r, o, _next, _throw, "next", n);
+			}
+			function _throw(n) {
+				asyncGeneratorStep(a, r, o, _next, _throw, "throw", n);
+			}
+			_next(void 0);
+		});
+	};
+}
+//#endregion
+export { _asyncToGenerator as t };

package/dist/client.cjs

@@ -206,7 +206,79 @@ function createAlokaiContext() {
 	}, rest);
 }
 //#endregion
+//#region src/storefront-events.ts
+/**
+* Creates a typed pub/sub for storefront domain events. The app defines its own event map and creates
+* the bound helpers once; modules (analytics, personalization, search) emit and subscribe without the
+* core knowing who listens. Client-only — the subscriber registry is created per call, so emitting from
+* a server component reaches no listeners.
+*
+* @example
+* ```ts
+* 'use client';
+* import { createStorefrontEvents } from '@vue-storefront/next/client';
+*
+* export interface StorefrontEventMap {
+*   'cart:productAdded': { productId: string };
+* }
+*
+* export const { emitStorefrontEvent, subscribeStorefrontEvent, useStorefrontEvent } =
+*   createStorefrontEvents<StorefrontEventMap>();
+* ```
+*/
+function createStorefrontEvents() {
+	const handlers = /* @__PURE__ */ new Map();
+	/**
+	* Emit a domain event. No-op when nothing is subscribed.
+	*/
+	function emitStorefrontEvent(type, payload) {
+		var _handlers$get;
+		(_handlers$get = handlers.get(type)) === null || _handlers$get === void 0 || _handlers$get.forEach((handler) => handler(payload));
+	}
+	/**
+	* Subscribe to a domain event. Returns an unsubscribe function.
+	*/
+	function subscribeStorefrontEvent(type, handler) {
+		var _handlers$get2;
+		const set = (_handlers$get2 = handlers.get(type)) !== null && _handlers$get2 !== void 0 ? _handlers$get2 : /* @__PURE__ */ new Set();
+		set.add(handler);
+		handlers.set(type, set);
+		return () => set.delete(handler);
+	}
+	/**
+	* Subscribe to a domain event for the lifetime of the calling component. The handler is read through
+	* a ref so an inline (unmemoized) handler doesn't re-subscribe on every render.
+	*/
+	function useStorefrontEvent(type, handler) {
+		const handlerRef = (0, react.useRef)(handler);
+		handlerRef.current = handler;
+		(0, react.useEffect)(() => subscribeStorefrontEvent(type, (payload) => handlerRef.current(payload)), [type]);
+	}
+	/**
+	* Emits a domain event once on mount. Lets server-rendered pages (which cannot call the client
+	* emitter directly) announce page-level events such as a PDP view. Give it a `key` tied to the entity
+	* (e.g. the product id + sku) so it remounts — and re-emits — when navigating between same-route
+	* pages. A ref guard keeps React Strict Mode's double-invoked effect (dev) to a single emit per mount.
+	*/
+	function StorefrontEventEmitter({ event, payload }) {
+		const didEmit = (0, react.useRef)(false);
+		(0, react.useEffect)(() => {
+			if (didEmit.current) return;
+			didEmit.current = true;
+			emitStorefrontEvent(event, payload);
+		}, []);
+		return null;
+	}
+	return {
+		emitStorefrontEvent,
+		StorefrontEventEmitter,
+		subscribeStorefrontEvent,
+		useStorefrontEvent
+	};
+}
+//#endregion
 exports.__toESM = __toESM;
 exports.createAlokaiContext = createAlokaiContext;
 exports.createSfStateProvider = createSfStateProvider;
+exports.createStorefrontEvents = createStorefrontEvents;
 exports.env = require_env.env;

package/dist/client.d.cts

@@ -40,4 +40,41 @@ import { SDKApi } from "@alokai/connect/sdk";
  */
 declare function createAlokaiContext<TSdk extends SDKApi<any>, TSfContract extends SfContract>(): CreateSdkContextReturn<TSdk, TSfContract>;
 //#endregion
-export { type CreateSdkContextReturn, Maybe, SfContract, SfState, SfStateProps, createAlokaiContext, createSfStateProvider, env };
+//#region src/storefront-events.d.ts
+/**
+ * Handler for a storefront event of type `TType` in the event map `TMap`.
+ */
+type StorefrontEventHandler<TMap, TType extends keyof TMap> = (payload: TMap[TType]) => void;
+/**
+ * Creates a typed pub/sub for storefront domain events. The app defines its own event map and creates
+ * the bound helpers once; modules (analytics, personalization, search) emit and subscribe without the
+ * core knowing who listens. Client-only — the subscriber registry is created per call, so emitting from
+ * a server component reaches no listeners.
+ *
+ * @example
+ * ```ts
+ * 'use client';
+ * import { createStorefrontEvents } from '@vue-storefront/next/client';
+ *
+ * export interface StorefrontEventMap {
+ *   'cart:productAdded': { productId: string };
+ * }
+ *
+ * export const { emitStorefrontEvent, subscribeStorefrontEvent, useStorefrontEvent } =
+ *   createStorefrontEvents<StorefrontEventMap>();
+ * ```
+ */
+declare function createStorefrontEvents<TMap>(): {
+  emitStorefrontEvent: <TType extends keyof TMap>(type: TType, payload: TMap[TType]) => void;
+  StorefrontEventEmitter: <TType extends keyof TMap>({
+    event,
+    payload
+  }: {
+    event: TType;
+    payload: TMap[TType];
+  }) => null;
+  subscribeStorefrontEvent: <TType extends keyof TMap>(type: TType, handler: StorefrontEventHandler<TMap, TType>) => () => void;
+  useStorefrontEvent: <TType extends keyof TMap>(type: TType, handler: StorefrontEventHandler<TMap, TType>) => void;
+};
+//#endregion
+export { type CreateSdkContextReturn, Maybe, SfContract, SfState, SfStateProps, StorefrontEventHandler, createAlokaiContext, createSfStateProvider, createStorefrontEvents, env };

package/dist/client.d.mts

@@ -1,4 +1,4 @@
-import { c as SfContract, d as createSfStateProvider, l as SfState, r as CreateSdkContextReturn, s as Maybe, t as env, u as SfStateProps } from "./index-BPhD221E.mjs";
+import { c as SfContract, d as createSfStateProvider, l as SfState, r as CreateSdkContextReturn, s as Maybe, t as env, u as SfStateProps } from "./index-7rf5ab-V.mjs";
 import { SDKApi } from "@alokai/connect/sdk";
 
 //#region src/alokai-provider.d.ts
@@ -40,4 +40,41 @@ import { SDKApi } from "@alokai/connect/sdk";
  */
 declare function createAlokaiContext<TSdk extends SDKApi<any>, TSfContract extends SfContract>(): CreateSdkContextReturn<TSdk, TSfContract>;
 //#endregion
-export { type CreateSdkContextReturn, Maybe, SfContract, SfState, SfStateProps, createAlokaiContext, createSfStateProvider, env };
+//#region src/storefront-events.d.ts
+/**
+ * Handler for a storefront event of type `TType` in the event map `TMap`.
+ */
+type StorefrontEventHandler<TMap, TType extends keyof TMap> = (payload: TMap[TType]) => void;
+/**
+ * Creates a typed pub/sub for storefront domain events. The app defines its own event map and creates
+ * the bound helpers once; modules (analytics, personalization, search) emit and subscribe without the
+ * core knowing who listens. Client-only — the subscriber registry is created per call, so emitting from
+ * a server component reaches no listeners.
+ *
+ * @example
+ * ```ts
+ * 'use client';
+ * import { createStorefrontEvents } from '@vue-storefront/next/client';
+ *
+ * export interface StorefrontEventMap {
+ *   'cart:productAdded': { productId: string };
+ * }
+ *
+ * export const { emitStorefrontEvent, subscribeStorefrontEvent, useStorefrontEvent } =
+ *   createStorefrontEvents<StorefrontEventMap>();
+ * ```
+ */
+declare function createStorefrontEvents<TMap>(): {
+  emitStorefrontEvent: <TType extends keyof TMap>(type: TType, payload: TMap[TType]) => void;
+  StorefrontEventEmitter: <TType extends keyof TMap>({
+    event,
+    payload
+  }: {
+    event: TType;
+    payload: TMap[TType];
+  }) => null;
+  subscribeStorefrontEvent: <TType extends keyof TMap>(type: TType, handler: StorefrontEventHandler<TMap, TType>) => () => void;
+  useStorefrontEvent: <TType extends keyof TMap>(type: TType, handler: StorefrontEventHandler<TMap, TType>) => void;
+};
+//#endregion
+export { type CreateSdkContextReturn, Maybe, SfContract, SfState, SfStateProps, StorefrontEventHandler, createAlokaiContext, createSfStateProvider, createStorefrontEvents, env };

package/dist/client.mjs

@@ -2,7 +2,7 @@
 import { n as _objectSpread2, r as PUBLIC_ENV_KEY, t as env } from "./env-9UiGUnbx.mjs";
 import { AlokaiInstrumentation } from "@alokai/instrumentation-next-component";
 import Script from "next/script";
-import React, { createContext, useContext, useRef } from "react";
+import React, { createContext, useContext, useEffect, useRef } from "react";
 import { createStore, useStore } from "zustand";
 //#region src/env/get-public-env.ts
 /**
@@ -181,4 +181,75 @@ function createAlokaiContext() {
 	}, rest);
 }
 //#endregion
-export { createAlokaiContext, createSfStateProvider, env };
+//#region src/storefront-events.ts
+/**
+* Creates a typed pub/sub for storefront domain events. The app defines its own event map and creates
+* the bound helpers once; modules (analytics, personalization, search) emit and subscribe without the
+* core knowing who listens. Client-only — the subscriber registry is created per call, so emitting from
+* a server component reaches no listeners.
+*
+* @example
+* ```ts
+* 'use client';
+* import { createStorefrontEvents } from '@vue-storefront/next/client';
+*
+* export interface StorefrontEventMap {
+*   'cart:productAdded': { productId: string };
+* }
+*
+* export const { emitStorefrontEvent, subscribeStorefrontEvent, useStorefrontEvent } =
+*   createStorefrontEvents<StorefrontEventMap>();
+* ```
+*/
+function createStorefrontEvents() {
+	const handlers = /* @__PURE__ */ new Map();
+	/**
+	* Emit a domain event. No-op when nothing is subscribed.
+	*/
+	function emitStorefrontEvent(type, payload) {
+		var _handlers$get;
+		(_handlers$get = handlers.get(type)) === null || _handlers$get === void 0 || _handlers$get.forEach((handler) => handler(payload));
+	}
+	/**
+	* Subscribe to a domain event. Returns an unsubscribe function.
+	*/
+	function subscribeStorefrontEvent(type, handler) {
+		var _handlers$get2;
+		const set = (_handlers$get2 = handlers.get(type)) !== null && _handlers$get2 !== void 0 ? _handlers$get2 : /* @__PURE__ */ new Set();
+		set.add(handler);
+		handlers.set(type, set);
+		return () => set.delete(handler);
+	}
+	/**
+	* Subscribe to a domain event for the lifetime of the calling component. The handler is read through
+	* a ref so an inline (unmemoized) handler doesn't re-subscribe on every render.
+	*/
+	function useStorefrontEvent(type, handler) {
+		const handlerRef = useRef(handler);
+		handlerRef.current = handler;
+		useEffect(() => subscribeStorefrontEvent(type, (payload) => handlerRef.current(payload)), [type]);
+	}
+	/**
+	* Emits a domain event once on mount. Lets server-rendered pages (which cannot call the client
+	* emitter directly) announce page-level events such as a PDP view. Give it a `key` tied to the entity
+	* (e.g. the product id + sku) so it remounts — and re-emits — when navigating between same-route
+	* pages. A ref guard keeps React Strict Mode's double-invoked effect (dev) to a single emit per mount.
+	*/
+	function StorefrontEventEmitter({ event, payload }) {
+		const didEmit = useRef(false);
+		useEffect(() => {
+			if (didEmit.current) return;
+			didEmit.current = true;
+			emitStorefrontEvent(event, payload);
+		}, []);
+		return null;
+	}
+	return {
+		emitStorefrontEvent,
+		StorefrontEventEmitter,
+		subscribeStorefrontEvent,
+		useStorefrontEvent
+	};
+}
+//#endregion
+export { createAlokaiContext, createSfStateProvider, createStorefrontEvents, env };

package/dist/index.cjs

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_env = require("./env-BK6gqfbp.cjs");
 require("./client.cjs");
+const require_asyncToGenerator = require("./asyncToGenerator-BI_VpA62.cjs");
 let _alokai_connect_logger = require("@alokai/connect/logger");
 let _alokai_connect_sdk = require("@alokai/connect/sdk");
 //#region src/logger/injectMetadata.ts
@@ -20,6 +21,207 @@ const createLogger = (options) => {
 	return injectMetadata(_alokai_connect_logger.LoggerFactory.create(_alokai_connect_logger.LoggerType.ConsolaGcp, options), { alokai: { context: "storefront" } });
 };
 //#endregion
+//#region src/image-optimizer/constants.ts
+/**
+* URL prefix the loader emits and the route folder must use:
+* `app/img-proxy/[host]/[...path]/route.ts`.
+*/
+const IMG_PROXY_PREFIX = "/img-proxy";
+/**
+* Cache-Control applied to successful (2xx) upstream responses unless
+* overridden per host via `cacheControl`.
+*/
+const DEFAULT_CACHE_CONTROL = "public, max-age=3600, s-maxage=86400";
+/**
+* Cache-Control applied to every non-2xx or failed response so errors are
+* never cached by the browser or the CDN.
+*/
+const ERROR_CACHE_CONTROL = "no-store, no-cache, must-revalidate";
+const variants = {
+	default: {
+		buildUpstreamUrl: (mediaHost, segments) => `${mediaHost}/${joinEncoded(segments)}`,
+		encodePath: (pathname) => pathname === "" ? void 0 : pathname
+	},
+	sapcc: {
+		buildUpstreamUrl: (mediaHost, segments) => {
+			const [context = "", ...path] = segments;
+			return `${mediaHost}/${joinEncoded(path)}?context=${encodeURIComponent(context)}`;
+		},
+		encodePath: (pathname, searchParams) => {
+			var _pathname$split$pop;
+			const context = searchParams.get("context");
+			if (!context) return;
+			const hasExtension = ((_pathname$split$pop = pathname.split("/").pop()) !== null && _pathname$split$pop !== void 0 ? _pathname$split$pop : "").includes(".");
+			const separator = pathname.endsWith("/") ? "" : "/";
+			const safePathname = hasExtension ? pathname : `${pathname}${separator}image.png`;
+			return `/${encodeURIComponent(context)}${safePathname}`;
+		}
+	}
+};
+function joinEncoded(segments) {
+	return segments.map((segment) => encodeURIComponent(segment)).join("/");
+}
+//#endregion
+//#region src/image-optimizer/resolve-hosts.ts
+/**
+* Normalizes the `hosts` config into an ordered list of fully-resolved host
+* configs. Throws on misconfiguration so mistakes surface at module init
+* instead of as silently unoptimized images.
+*
+* @internal
+*/
+function resolveHosts(hosts) {
+	return Object.entries(hosts).map(([key, config]) => resolveHost(key, config));
+}
+/**
+* Derives the conventional env variable name from a host key, e.g.
+* `ct` -> `NEXT_PUBLIC_CT_MEDIA_HOST`, `my-cms` -> `NEXT_PUBLIC_MY_CMS_MEDIA_HOST`.
+*
+* @internal
+*/
+function deriveMediaHostEnvName(hostKey) {
+	return `NEXT_PUBLIC_${hostKey.replaceAll("-", "_").toUpperCase()}_MEDIA_HOST`;
+}
+const HOST_KEY_PATTERN = /^(?=.*[a-z])[a-z0-9-]+$/;
+function resolveHost(key, config) {
+	var _config$variant, _config$buildUpstream, _config$cacheControl, _config$encodePath;
+	if (!HOST_KEY_PATTERN.test(key)) throw new Error(`Invalid image optimizer host key "${key}". Use lowercase letters, digits and hyphens only - the key becomes a URL segment and an env variable name fragment.`);
+	const variant = variants[(_config$variant = config.variant) !== null && _config$variant !== void 0 ? _config$variant : "default"];
+	return {
+		buildUpstreamUrl: (_config$buildUpstream = config.buildUpstreamUrl) !== null && _config$buildUpstream !== void 0 ? _config$buildUpstream : variant.buildUpstreamUrl,
+		cacheControl: (_config$cacheControl = config.cacheControl) !== null && _config$cacheControl !== void 0 ? _config$cacheControl : DEFAULT_CACHE_CONTROL,
+		encodePath: (_config$encodePath = config.encodePath) !== null && _config$encodePath !== void 0 ? _config$encodePath : variant.encodePath,
+		key,
+		loader: config.loader,
+		mediaHostEnvName: deriveMediaHostEnvName(key)
+	};
+}
+//#endregion
+//#region src/image-optimizer/create-image-optimizer.ts
+/**
+* Creates a Next.js custom image `loader` and a proxy route-handler `GET`
+* that together let an image CDN in front of the storefront (the Alokai
+* Image Optimizer)
+* optimize media-host images.
+*
+* The loader rewrites `src` values matching a configured media host to
+* `/img-proxy/{key}/{path}?width=&quality=&format=auto`; the route handler
+* proxies that path back to the media host and streams the body so the CDN
+* can transform it on the way to the browser. Non-matching `src` values are
+* returned unchanged.
+*
+* @example
+* ```ts
+* // config/image-optimizer.ts - the single place the config exists; the
+* // default export lets `images.loaderFile` point straight at this file
+* import { createImageOptimizer } from "@vue-storefront/next";
+*
+* export const { GET, loader } = createImageOptimizer({ hosts: { ct: {} } });
+*
+* export default loader;
+*
+* // app/img-proxy/[host]/[...path]/route.ts
+* export { GET } from "@/config/image-optimizer";
+* ```
+*/
+function createImageOptimizer(config) {
+	if (Object.keys(config.hosts).length === 0) throw new Error([
+		"createImageOptimizer requires at least one host in \"hosts\".",
+		"Add the media hosts whose images the loader should optimize, e.g.:",
+		"",
+		"  createImageOptimizer({",
+		"    hosts: {",
+		"      ct: {},",
+		"      sapcc: { variant: \"sapcc\" },",
+		"    },",
+		"  });",
+		"",
+		"Each key becomes a URL segment and derives the env variable holding",
+		"the media host URL, e.g. \"ct\" reads NEXT_PUBLIC_CT_MEDIA_HOST."
+	].join("\n"));
+	const hosts = resolveHosts(config.hosts);
+	const warnedMissingHosts = /* @__PURE__ */ new Set();
+	function loader({ quality, src, width }) {
+		for (const host of hosts) {
+			const mediaHost = require_env.env(host.mediaHostEnvName);
+			if (!mediaHost) {
+				if (!warnedMissingHosts.has(host.key)) {
+					warnedMissingHosts.add(host.key);
+					getLogger().warning(`${host.mediaHostEnvName} is not defined, skipping image optimization for host "${host.key}".`);
+				}
+				continue;
+			}
+			const normalizedHost = mediaHost.replace(/\/$/, "");
+			if (!matchesMediaHost(src, normalizedHost)) continue;
+			if (host.loader) return host.loader({
+				quality,
+				src,
+				width
+			});
+			const localPath = src.slice(normalizedHost.length);
+			const queryIndex = localPath.indexOf("?");
+			const pathname = queryIndex === -1 ? localPath : localPath.slice(0, queryIndex);
+			const queryString = queryIndex === -1 ? "" : localPath.slice(queryIndex + 1);
+			const proxyPath = host.encodePath(pathname, new URLSearchParams(queryString));
+			if (proxyPath === void 0) return src;
+			return `${IMG_PROXY_PREFIX}/${host.key}${proxyPath}?width=${width}&quality=${quality || 85}&format=auto`;
+		}
+		return src;
+	}
+	function GET(_x, _x2) {
+		return _GET.apply(this, arguments);
+	}
+	function _GET() {
+		_GET = require_asyncToGenerator._asyncToGenerator(function* (_request, { params }) {
+			var _env, _upstream$headers$get;
+			const { host: hostKey, path } = yield params;
+			const host = hosts.find((entry) => entry.key === hostKey);
+			if (!host) return errorResponse(`Unknown image proxy host "${hostKey}"`, 404);
+			if (path.length === 0 || path.some(isUnsafeSegment)) return errorResponse("Invalid image path", 400);
+			const mediaHost = (_env = require_env.env(host.mediaHostEnvName)) === null || _env === void 0 ? void 0 : _env.replace(/\/$/, "");
+			if (!mediaHost) return errorResponse(`${host.mediaHostEnvName} is not defined`, 500);
+			let upstream;
+			try {
+				upstream = yield fetch(host.buildUpstreamUrl(mediaHost, path), { redirect: "manual" });
+			} catch (error) {
+				getLogger().error(`Failed to fetch upstream image for host "${hostKey}": ${String(error)}`);
+				return errorResponse("Failed to fetch upstream image", 502);
+			}
+			if (upstream.status >= 300 && upstream.status < 400) return errorResponse("Upstream redirect is not allowed", 502);
+			return new Response(upstream.body, {
+				headers: {
+					"cache-control": upstream.ok ? host.cacheControl : ERROR_CACHE_CONTROL,
+					"content-type": (_upstream$headers$get = upstream.headers.get("content-type")) !== null && _upstream$headers$get !== void 0 ? _upstream$headers$get : "application/octet-stream"
+				},
+				status: upstream.status
+			});
+		});
+		return _GET.apply(this, arguments);
+	}
+	return {
+		GET,
+		loader
+	};
+}
+let logger;
+function getLogger() {
+	var _logger;
+	(_logger = logger) !== null && _logger !== void 0 || (logger = createLogger());
+	return logger;
+}
+function matchesMediaHost(src, normalizedHost) {
+	return src === normalizedHost || src.startsWith(`${normalizedHost}/`) || src.startsWith(`${normalizedHost}?`);
+}
+function isUnsafeSegment(segment) {
+	return segment === "" || segment === "." || segment === "..";
+}
+function errorResponse(message, status) {
+	return new Response(message, {
+		headers: { "cache-control": ERROR_CACHE_CONTROL },
+		status
+	});
+}
+//#endregion
 //#region src/middleware.ts
 /**
 * Creates an Alokai middleware wrapper that adds pathname information to request headers.
@@ -64,32 +266,6 @@ const defaultMethodsRequestConfig = {
 	} }
 };
 //#endregion
-//#region \0@oxc-project+runtime@0.115.0/helpers/asyncToGenerator.js
-function asyncGeneratorStep(n, t, e, r, o, a, c) {
-	try {
-		var i = n[a](c), u = i.value;
-	} catch (n) {
-		e(n);
-		return;
-	}
-	i.done ? t(u) : Promise.resolve(u).then(r, o);
-}
-function _asyncToGenerator(n) {
-	return function() {
-		var t = this, e = arguments;
-		return new Promise(function(r, o) {
-			var a = n.apply(t, e);
-			function _next(n) {
-				asyncGeneratorStep(a, r, o, _next, _throw, "next", n);
-			}
-			function _throw(n) {
-				asyncGeneratorStep(a, r, o, _next, _throw, "throw", n);
-			}
-			_next(void 0);
-		});
-	};
-}
-//#endregion
 //#region src/sdk/helpers/resolveDynamicContext.ts
 const BLACKLISTED_HEADERS = new Set(["host"]);
 function isAppRouterHeaders(headers) {
@@ -112,7 +288,7 @@ function normalizeRequestHeaders(requestHeaders) {
 }
 function resolveDynamicContext(context) {
 	return require_env._objectSpread2(require_env._objectSpread2({}, context), {}, { getRequestHeaders() {
-		return _asyncToGenerator(function* () {
+		return require_asyncToGenerator._asyncToGenerator(function* () {
 			var _context$getRequestHe;
 			const normalizedHeaders = normalizeRequestHeaders(yield (_context$getRequestHe = context.getRequestHeaders) === null || _context$getRequestHe === void 0 ? void 0 : _context$getRequestHe.call(context));
 			const requestHeaders = Object.fromEntries(Object.entries(normalizedHeaders).filter(([key]) => !BLACKLISTED_HEADERS.has(key)));
@@ -237,6 +413,7 @@ function buildModules(modules) {
 }
 //#endregion
 exports.createAlokaiMiddleware = createAlokaiMiddleware;
+exports.createImageOptimizer = createImageOptimizer;
 exports.createLogger = createLogger;
 exports.createSdk = createSdk;
 Object.defineProperty(exports, "defineGetConfigSwitcherHeader", {

package/dist/index.d.cts

@@ -1,8 +1,128 @@
 import { a as CreateSdkReturn, i as CreateSdkOptions, n as Config, o as InjectedContext, t as env } from "./index-w0GzdXwC.cjs";
 import { buildModule, defineGetConfigSwitcherHeader } from "@alokai/connect/sdk";
+import { ImageLoaderProps } from "next/image";
 import * as _alokai_connect_logger0 from "@alokai/connect/logger";
 import { NextRequest, NextResponse } from "next/server";
 
+//#region src/image-optimizer/types.d.ts
+/**
+ * Next.js custom image loader produced by `createImageOptimizer`. Pass it as
+ * the default export of the file referenced by `images.loaderFile`.
+ */
+type ImageOptimizerLoader = (props: ImageLoaderProps) => string;
+/**
+ * Route handler produced by `createImageOptimizer`. Re-export it as `GET`
+ * from `app/img-proxy/[host]/[...path]/route.ts`.
+ */
+type ImageOptimizerRouteHandler = (request: Request, context: ImageOptimizerRouteContext) => Promise<Response>;
+interface ImageOptimizer {
+  GET: ImageOptimizerRouteHandler;
+  loader: ImageOptimizerLoader;
+}
+interface CreateImageOptimizerConfig {
+  /**
+   * Media hosts whose images should be optimized, keyed by host key. An
+   * empty object means all defaults. The key becomes the `[host]` URL
+   * segment and derives the default env variable name:
+   * `NEXT_PUBLIC_{KEY}_MEDIA_HOST`.
+   */
+  hosts: ImageOptimizerHosts;
+}
+type ImageOptimizerHosts = Record<string, ImageOptimizerHostConfig>;
+type ImageOptimizerHostConfig = ImageOptimizerDelegatedHostConfig | ImageOptimizerProxiedHostConfig;
+/**
+ * Host with its own image CDN (e.g. Contentful): matching `src` values are
+ * delegated to the given loader and never proxied, so the proxy-side options
+ * do not apply.
+ */
+interface ImageOptimizerDelegatedHostConfig {
+  buildUpstreamUrl?: never;
+  cacheControl?: never;
+  encodePath?: never;
+  /**
+   * Rewrites a matching `src` directly to the host's own CDN. Same signature
+   * as a Next.js image loader, so existing loader implementations plug in.
+   */
+  loader: ImageOptimizerLoader;
+  variant?: never;
+}
+/**
+ * Host proxied through `/img-proxy/{key}/...` so the image CDN in front of
+ * the storefront (Alokai Image Optimizer) can transform the response.
+ */
+interface ImageOptimizerProxiedHostConfig {
+  /** Server-side hook overriding the variant's upstream URL reconstruction. */
+  buildUpstreamUrl?: BuildUpstreamUrlHook;
+  /**
+   * Cache-Control for successful (2xx) upstream responses.
+   *
+   * @default "public, max-age=3600, s-maxage=86400"
+   */
+  cacheControl?: string;
+  /** Client-side hook overriding the variant's path encoding. */
+  encodePath?: EncodePathHook;
+  loader?: never;
+  /**
+   * Built-in URL scheme. `sapcc` encodes the `?context=` query parameter as
+   * a path segment and appends a synthetic filename when the path has none.
+   * Ignored for a side when the corresponding hook is provided.
+   *
+   * @default "default"
+   */
+  variant?: ImageOptimizerVariant;
+}
+type ImageOptimizerVariant = "default" | "sapcc";
+/**
+ * Builds the path emitted after `/img-proxy/{key}` on the loader (client)
+ * side. Receives the pathname relative to the media host (with leading
+ * slash, without query string) and the parsed query string of the original
+ * `src`. Return the proxy path (starting with `/`), or `undefined` to skip
+ * proxying and return the original `src` unchanged.
+ */
+type EncodePathHook = (pathname: string, searchParams: URLSearchParams) => string | undefined;
+/**
+ * Rebuilds the upstream URL on the route-handler (server) side. Receives the
+ * media host (without trailing slash) and the decoded `[...path]` segments
+ * from the route params. Must return an absolute URL.
+ */
+type BuildUpstreamUrlHook = (mediaHost: string, segments: string[]) => string;
+interface ImageOptimizerRouteContext {
+  params: Promise<ImageOptimizerRouteParams>;
+}
+interface ImageOptimizerRouteParams {
+  host: string;
+  path: string[];
+}
+//#endregion
+//#region src/image-optimizer/create-image-optimizer.d.ts
+/**
+ * Creates a Next.js custom image `loader` and a proxy route-handler `GET`
+ * that together let an image CDN in front of the storefront (the Alokai
+ * Image Optimizer)
+ * optimize media-host images.
+ *
+ * The loader rewrites `src` values matching a configured media host to
+ * `/img-proxy/{key}/{path}?width=&quality=&format=auto`; the route handler
+ * proxies that path back to the media host and streams the body so the CDN
+ * can transform it on the way to the browser. Non-matching `src` values are
+ * returned unchanged.
+ *
+ * @example
+ * ```ts
+ * // config/image-optimizer.ts - the single place the config exists; the
+ * // default export lets `images.loaderFile` point straight at this file
+ * import { createImageOptimizer } from "@vue-storefront/next";
+ *
+ * export const { GET, loader } = createImageOptimizer({ hosts: { ct: {} } });
+ *
+ * export default loader;
+ *
+ * // app/img-proxy/[host]/[...path]/route.ts
+ * export { GET } from "@/config/image-optimizer";
+ * ```
+ */
+declare function createImageOptimizer(config: CreateImageOptimizerConfig): ImageOptimizer;
+//#endregion
 //#region src/logger/types.d.ts
 type LogVerbosity = "alert" | "critical" | "debug" | "emergency" | "error" | "info" | "notice" | "warning";
 type LoggerOptions = Partial<{
@@ -176,4 +296,4 @@ type DefineSdkModule = (context: InjectedContext) => ReturnType<typeof buildModu
  */
 declare function defineSdkModule<TModuleDefinition extends DefineSdkModule>(moduleDefinition: TModuleDefinition): TModuleDefinition;
 //#endregion
-export { type CreateSdkOptions, createAlokaiMiddleware, createLogger, createSdk, defineGetConfigSwitcherHeader, defineSdkConfig, defineSdkModule, env, resolveSdkOptions };
+export { BuildUpstreamUrlHook, CreateImageOptimizerConfig, type CreateSdkOptions, EncodePathHook, ImageOptimizer, ImageOptimizerDelegatedHostConfig, ImageOptimizerHostConfig, ImageOptimizerHosts, ImageOptimizerLoader, ImageOptimizerProxiedHostConfig, ImageOptimizerRouteContext, ImageOptimizerRouteHandler, ImageOptimizerRouteParams, ImageOptimizerVariant, createAlokaiMiddleware, createImageOptimizer, createLogger, createSdk, defineGetConfigSwitcherHeader, defineSdkConfig, defineSdkModule, env, resolveSdkOptions };

package/dist/index.d.mts

@@ -1,8 +1,128 @@
-import { a as CreateSdkReturn, i as CreateSdkOptions, n as Config, o as InjectedContext, t as env } from "./index-BPhD221E.mjs";
+import { a as CreateSdkReturn, i as CreateSdkOptions, n as Config, o as InjectedContext, t as env } from "./index-7rf5ab-V.mjs";
 import * as _alokai_connect_logger0 from "@alokai/connect/logger";
 import { buildModule, defineGetConfigSwitcherHeader } from "@alokai/connect/sdk";
+import { ImageLoaderProps } from "next/image";
 import { NextRequest, NextResponse } from "next/server";
 
+//#region src/image-optimizer/types.d.ts
+/**
+ * Next.js custom image loader produced by `createImageOptimizer`. Pass it as
+ * the default export of the file referenced by `images.loaderFile`.
+ */
+type ImageOptimizerLoader = (props: ImageLoaderProps) => string;
+/**
+ * Route handler produced by `createImageOptimizer`. Re-export it as `GET`
+ * from `app/img-proxy/[host]/[...path]/route.ts`.
+ */
+type ImageOptimizerRouteHandler = (request: Request, context: ImageOptimizerRouteContext) => Promise<Response>;
+interface ImageOptimizer {
+  GET: ImageOptimizerRouteHandler;
+  loader: ImageOptimizerLoader;
+}
+interface CreateImageOptimizerConfig {
+  /**
+   * Media hosts whose images should be optimized, keyed by host key. An
+   * empty object means all defaults. The key becomes the `[host]` URL
+   * segment and derives the default env variable name:
+   * `NEXT_PUBLIC_{KEY}_MEDIA_HOST`.
+   */
+  hosts: ImageOptimizerHosts;
+}
+type ImageOptimizerHosts = Record<string, ImageOptimizerHostConfig>;
+type ImageOptimizerHostConfig = ImageOptimizerDelegatedHostConfig | ImageOptimizerProxiedHostConfig;
+/**
+ * Host with its own image CDN (e.g. Contentful): matching `src` values are
+ * delegated to the given loader and never proxied, so the proxy-side options
+ * do not apply.
+ */
+interface ImageOptimizerDelegatedHostConfig {
+  buildUpstreamUrl?: never;
+  cacheControl?: never;
+  encodePath?: never;
+  /**
+   * Rewrites a matching `src` directly to the host's own CDN. Same signature
+   * as a Next.js image loader, so existing loader implementations plug in.
+   */
+  loader: ImageOptimizerLoader;
+  variant?: never;
+}
+/**
+ * Host proxied through `/img-proxy/{key}/...` so the image CDN in front of
+ * the storefront (Alokai Image Optimizer) can transform the response.
+ */
+interface ImageOptimizerProxiedHostConfig {
+  /** Server-side hook overriding the variant's upstream URL reconstruction. */
+  buildUpstreamUrl?: BuildUpstreamUrlHook;
+  /**
+   * Cache-Control for successful (2xx) upstream responses.
+   *
+   * @default "public, max-age=3600, s-maxage=86400"
+   */
+  cacheControl?: string;
+  /** Client-side hook overriding the variant's path encoding. */
+  encodePath?: EncodePathHook;
+  loader?: never;
+  /**
+   * Built-in URL scheme. `sapcc` encodes the `?context=` query parameter as
+   * a path segment and appends a synthetic filename when the path has none.
+   * Ignored for a side when the corresponding hook is provided.
+   *
+   * @default "default"
+   */
+  variant?: ImageOptimizerVariant;
+}
+type ImageOptimizerVariant = "default" | "sapcc";
+/**
+ * Builds the path emitted after `/img-proxy/{key}` on the loader (client)
+ * side. Receives the pathname relative to the media host (with leading
+ * slash, without query string) and the parsed query string of the original
+ * `src`. Return the proxy path (starting with `/`), or `undefined` to skip
+ * proxying and return the original `src` unchanged.
+ */
+type EncodePathHook = (pathname: string, searchParams: URLSearchParams) => string | undefined;
+/**
+ * Rebuilds the upstream URL on the route-handler (server) side. Receives the
+ * media host (without trailing slash) and the decoded `[...path]` segments
+ * from the route params. Must return an absolute URL.
+ */
+type BuildUpstreamUrlHook = (mediaHost: string, segments: string[]) => string;
+interface ImageOptimizerRouteContext {
+  params: Promise<ImageOptimizerRouteParams>;
+}
+interface ImageOptimizerRouteParams {
+  host: string;
+  path: string[];
+}
+//#endregion
+//#region src/image-optimizer/create-image-optimizer.d.ts
+/**
+ * Creates a Next.js custom image `loader` and a proxy route-handler `GET`
+ * that together let an image CDN in front of the storefront (the Alokai
+ * Image Optimizer)
+ * optimize media-host images.
+ *
+ * The loader rewrites `src` values matching a configured media host to
+ * `/img-proxy/{key}/{path}?width=&quality=&format=auto`; the route handler
+ * proxies that path back to the media host and streams the body so the CDN
+ * can transform it on the way to the browser. Non-matching `src` values are
+ * returned unchanged.
+ *
+ * @example
+ * ```ts
+ * // config/image-optimizer.ts - the single place the config exists; the
+ * // default export lets `images.loaderFile` point straight at this file
+ * import { createImageOptimizer } from "@vue-storefront/next";
+ *
+ * export const { GET, loader } = createImageOptimizer({ hosts: { ct: {} } });
+ *
+ * export default loader;
+ *
+ * // app/img-proxy/[host]/[...path]/route.ts
+ * export { GET } from "@/config/image-optimizer";
+ * ```
+ */
+declare function createImageOptimizer(config: CreateImageOptimizerConfig): ImageOptimizer;
+//#endregion
 //#region src/logger/types.d.ts
 type LogVerbosity = "alert" | "critical" | "debug" | "emergency" | "error" | "info" | "notice" | "warning";
 type LoggerOptions = Partial<{
@@ -176,4 +296,4 @@ type DefineSdkModule = (context: InjectedContext) => ReturnType<typeof buildModu
  */
 declare function defineSdkModule<TModuleDefinition extends DefineSdkModule>(moduleDefinition: TModuleDefinition): TModuleDefinition;
 //#endregion
-export { type CreateSdkOptions, createAlokaiMiddleware, createLogger, createSdk, defineGetConfigSwitcherHeader, defineSdkConfig, defineSdkModule, env, resolveSdkOptions };
+export { BuildUpstreamUrlHook, CreateImageOptimizerConfig, type CreateSdkOptions, EncodePathHook, ImageOptimizer, ImageOptimizerDelegatedHostConfig, ImageOptimizerHostConfig, ImageOptimizerHosts, ImageOptimizerLoader, ImageOptimizerProxiedHostConfig, ImageOptimizerRouteContext, ImageOptimizerRouteHandler, ImageOptimizerRouteParams, ImageOptimizerVariant, createAlokaiMiddleware, createImageOptimizer, createLogger, createSdk, defineGetConfigSwitcherHeader, defineSdkConfig, defineSdkModule, env, resolveSdkOptions };

package/dist/index.mjs

@@ -1,4 +1,5 @@
 import { n as _objectSpread2, t as env } from "./env-9UiGUnbx.mjs";
+import { t as _asyncToGenerator } from "./asyncToGenerator-Co5zHbo3.mjs";
 import { LoggerFactory, LoggerType } from "@alokai/connect/logger";
 import { buildModule, defineGetConfigSwitcherHeader, initSDK, middlewareModule } from "@alokai/connect/sdk";
 //#region src/logger/injectMetadata.ts
@@ -18,6 +19,207 @@ const createLogger = (options) => {
 	return injectMetadata(LoggerFactory.create(LoggerType.ConsolaGcp, options), { alokai: { context: "storefront" } });
 };
 //#endregion
+//#region src/image-optimizer/constants.ts
+/**
+* URL prefix the loader emits and the route folder must use:
+* `app/img-proxy/[host]/[...path]/route.ts`.
+*/
+const IMG_PROXY_PREFIX = "/img-proxy";
+/**
+* Cache-Control applied to successful (2xx) upstream responses unless
+* overridden per host via `cacheControl`.
+*/
+const DEFAULT_CACHE_CONTROL = "public, max-age=3600, s-maxage=86400";
+/**
+* Cache-Control applied to every non-2xx or failed response so errors are
+* never cached by the browser or the CDN.
+*/
+const ERROR_CACHE_CONTROL = "no-store, no-cache, must-revalidate";
+const variants = {
+	default: {
+		buildUpstreamUrl: (mediaHost, segments) => `${mediaHost}/${joinEncoded(segments)}`,
+		encodePath: (pathname) => pathname === "" ? void 0 : pathname
+	},
+	sapcc: {
+		buildUpstreamUrl: (mediaHost, segments) => {
+			const [context = "", ...path] = segments;
+			return `${mediaHost}/${joinEncoded(path)}?context=${encodeURIComponent(context)}`;
+		},
+		encodePath: (pathname, searchParams) => {
+			var _pathname$split$pop;
+			const context = searchParams.get("context");
+			if (!context) return;
+			const hasExtension = ((_pathname$split$pop = pathname.split("/").pop()) !== null && _pathname$split$pop !== void 0 ? _pathname$split$pop : "").includes(".");
+			const separator = pathname.endsWith("/") ? "" : "/";
+			const safePathname = hasExtension ? pathname : `${pathname}${separator}image.png`;
+			return `/${encodeURIComponent(context)}${safePathname}`;
+		}
+	}
+};
+function joinEncoded(segments) {
+	return segments.map((segment) => encodeURIComponent(segment)).join("/");
+}
+//#endregion
+//#region src/image-optimizer/resolve-hosts.ts
+/**
+* Normalizes the `hosts` config into an ordered list of fully-resolved host
+* configs. Throws on misconfiguration so mistakes surface at module init
+* instead of as silently unoptimized images.
+*
+* @internal
+*/
+function resolveHosts(hosts) {
+	return Object.entries(hosts).map(([key, config]) => resolveHost(key, config));
+}
+/**
+* Derives the conventional env variable name from a host key, e.g.
+* `ct` -> `NEXT_PUBLIC_CT_MEDIA_HOST`, `my-cms` -> `NEXT_PUBLIC_MY_CMS_MEDIA_HOST`.
+*
+* @internal
+*/
+function deriveMediaHostEnvName(hostKey) {
+	return `NEXT_PUBLIC_${hostKey.replaceAll("-", "_").toUpperCase()}_MEDIA_HOST`;
+}
+const HOST_KEY_PATTERN = /^(?=.*[a-z])[a-z0-9-]+$/;
+function resolveHost(key, config) {
+	var _config$variant, _config$buildUpstream, _config$cacheControl, _config$encodePath;
+	if (!HOST_KEY_PATTERN.test(key)) throw new Error(`Invalid image optimizer host key "${key}". Use lowercase letters, digits and hyphens only - the key becomes a URL segment and an env variable name fragment.`);
+	const variant = variants[(_config$variant = config.variant) !== null && _config$variant !== void 0 ? _config$variant : "default"];
+	return {
+		buildUpstreamUrl: (_config$buildUpstream = config.buildUpstreamUrl) !== null && _config$buildUpstream !== void 0 ? _config$buildUpstream : variant.buildUpstreamUrl,
+		cacheControl: (_config$cacheControl = config.cacheControl) !== null && _config$cacheControl !== void 0 ? _config$cacheControl : DEFAULT_CACHE_CONTROL,
+		encodePath: (_config$encodePath = config.encodePath) !== null && _config$encodePath !== void 0 ? _config$encodePath : variant.encodePath,
+		key,
+		loader: config.loader,
+		mediaHostEnvName: deriveMediaHostEnvName(key)
+	};
+}
+//#endregion
+//#region src/image-optimizer/create-image-optimizer.ts
+/**
+* Creates a Next.js custom image `loader` and a proxy route-handler `GET`
+* that together let an image CDN in front of the storefront (the Alokai
+* Image Optimizer)
+* optimize media-host images.
+*
+* The loader rewrites `src` values matching a configured media host to
+* `/img-proxy/{key}/{path}?width=&quality=&format=auto`; the route handler
+* proxies that path back to the media host and streams the body so the CDN
+* can transform it on the way to the browser. Non-matching `src` values are
+* returned unchanged.
+*
+* @example
+* ```ts
+* // config/image-optimizer.ts - the single place the config exists; the
+* // default export lets `images.loaderFile` point straight at this file
+* import { createImageOptimizer } from "@vue-storefront/next";
+*
+* export const { GET, loader } = createImageOptimizer({ hosts: { ct: {} } });
+*
+* export default loader;
+*
+* // app/img-proxy/[host]/[...path]/route.ts
+* export { GET } from "@/config/image-optimizer";
+* ```
+*/
+function createImageOptimizer(config) {
+	if (Object.keys(config.hosts).length === 0) throw new Error([
+		"createImageOptimizer requires at least one host in \"hosts\".",
+		"Add the media hosts whose images the loader should optimize, e.g.:",
+		"",
+		"  createImageOptimizer({",
+		"    hosts: {",
+		"      ct: {},",
+		"      sapcc: { variant: \"sapcc\" },",
+		"    },",
+		"  });",
+		"",
+		"Each key becomes a URL segment and derives the env variable holding",
+		"the media host URL, e.g. \"ct\" reads NEXT_PUBLIC_CT_MEDIA_HOST."
+	].join("\n"));
+	const hosts = resolveHosts(config.hosts);
+	const warnedMissingHosts = /* @__PURE__ */ new Set();
+	function loader({ quality, src, width }) {
+		for (const host of hosts) {
+			const mediaHost = env(host.mediaHostEnvName);
+			if (!mediaHost) {
+				if (!warnedMissingHosts.has(host.key)) {
+					warnedMissingHosts.add(host.key);
+					getLogger().warning(`${host.mediaHostEnvName} is not defined, skipping image optimization for host "${host.key}".`);
+				}
+				continue;
+			}
+			const normalizedHost = mediaHost.replace(/\/$/, "");
+			if (!matchesMediaHost(src, normalizedHost)) continue;
+			if (host.loader) return host.loader({
+				quality,
+				src,
+				width
+			});
+			const localPath = src.slice(normalizedHost.length);
+			const queryIndex = localPath.indexOf("?");
+			const pathname = queryIndex === -1 ? localPath : localPath.slice(0, queryIndex);
+			const queryString = queryIndex === -1 ? "" : localPath.slice(queryIndex + 1);
+			const proxyPath = host.encodePath(pathname, new URLSearchParams(queryString));
+			if (proxyPath === void 0) return src;
+			return `${IMG_PROXY_PREFIX}/${host.key}${proxyPath}?width=${width}&quality=${quality || 85}&format=auto`;
+		}
+		return src;
+	}
+	function GET(_x, _x2) {
+		return _GET.apply(this, arguments);
+	}
+	function _GET() {
+		_GET = _asyncToGenerator(function* (_request, { params }) {
+			var _env, _upstream$headers$get;
+			const { host: hostKey, path } = yield params;
+			const host = hosts.find((entry) => entry.key === hostKey);
+			if (!host) return errorResponse(`Unknown image proxy host "${hostKey}"`, 404);
+			if (path.length === 0 || path.some(isUnsafeSegment)) return errorResponse("Invalid image path", 400);
+			const mediaHost = (_env = env(host.mediaHostEnvName)) === null || _env === void 0 ? void 0 : _env.replace(/\/$/, "");
+			if (!mediaHost) return errorResponse(`${host.mediaHostEnvName} is not defined`, 500);
+			let upstream;
+			try {
+				upstream = yield fetch(host.buildUpstreamUrl(mediaHost, path), { redirect: "manual" });
+			} catch (error) {
+				getLogger().error(`Failed to fetch upstream image for host "${hostKey}": ${String(error)}`);
+				return errorResponse("Failed to fetch upstream image", 502);
+			}
+			if (upstream.status >= 300 && upstream.status < 400) return errorResponse("Upstream redirect is not allowed", 502);
+			return new Response(upstream.body, {
+				headers: {
+					"cache-control": upstream.ok ? host.cacheControl : ERROR_CACHE_CONTROL,
+					"content-type": (_upstream$headers$get = upstream.headers.get("content-type")) !== null && _upstream$headers$get !== void 0 ? _upstream$headers$get : "application/octet-stream"
+				},
+				status: upstream.status
+			});
+		});
+		return _GET.apply(this, arguments);
+	}
+	return {
+		GET,
+		loader
+	};
+}
+let logger;
+function getLogger() {
+	var _logger;
+	(_logger = logger) !== null && _logger !== void 0 || (logger = createLogger());
+	return logger;
+}
+function matchesMediaHost(src, normalizedHost) {
+	return src === normalizedHost || src.startsWith(`${normalizedHost}/`) || src.startsWith(`${normalizedHost}?`);
+}
+function isUnsafeSegment(segment) {
+	return segment === "" || segment === "." || segment === "..";
+}
+function errorResponse(message, status) {
+	return new Response(message, {
+		headers: { "cache-control": ERROR_CACHE_CONTROL },
+		status
+	});
+}
+//#endregion
 //#region src/middleware.ts
 /**
 * Creates an Alokai middleware wrapper that adds pathname information to request headers.
@@ -62,32 +264,6 @@ const defaultMethodsRequestConfig = {
 	} }
 };
 //#endregion
-//#region \0@oxc-project+runtime@0.115.0/helpers/asyncToGenerator.js
-function asyncGeneratorStep(n, t, e, r, o, a, c) {
-	try {
-		var i = n[a](c), u = i.value;
-	} catch (n) {
-		e(n);
-		return;
-	}
-	i.done ? t(u) : Promise.resolve(u).then(r, o);
-}
-function _asyncToGenerator(n) {
-	return function() {
-		var t = this, e = arguments;
-		return new Promise(function(r, o) {
-			var a = n.apply(t, e);
-			function _next(n) {
-				asyncGeneratorStep(a, r, o, _next, _throw, "next", n);
-			}
-			function _throw(n) {
-				asyncGeneratorStep(a, r, o, _next, _throw, "throw", n);
-			}
-			_next(void 0);
-		});
-	};
-}
-//#endregion
 //#region src/sdk/helpers/resolveDynamicContext.ts
 const BLACKLISTED_HEADERS = new Set(["host"]);
 function isAppRouterHeaders(headers) {
@@ -234,4 +410,4 @@ function buildModules(modules) {
 	return (context) => Object.fromEntries(Object.entries(modules).map(([key, module]) => [key, module(context)]));
 }
 //#endregion
-export { createAlokaiMiddleware, createLogger, createSdk, defineGetConfigSwitcherHeader, defineSdkConfig, defineSdkModule, env, resolveSdkOptions };
+export { createAlokaiMiddleware, createImageOptimizer, createLogger, createSdk, defineGetConfigSwitcherHeader, defineSdkConfig, defineSdkModule, env, resolveSdkOptions };

package/dist/server.cjs

@@ -0,0 +1,23 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("./client.cjs");
+const require_asyncToGenerator = require("./asyncToGenerator-BI_VpA62.cjs");
+let next_headers = require("next/headers");
+//#region src/current-path.ts
+/**
+* Returns the current request path (`pathname` + `search`) inside a Server Component, as exposed by
+* {@link createAlokaiMiddleware} on the request headers. Reading it through this helper keeps the
+* underlying header names (`x-pathname` / `x-search`) an implementation detail of the framework.
+*/
+function getCurrentPath() {
+	return _getCurrentPath.apply(this, arguments);
+}
+function _getCurrentPath() {
+	_getCurrentPath = require_asyncToGenerator._asyncToGenerator(function* () {
+		var _requestHeaders$get, _requestHeaders$get2;
+		const requestHeaders = yield (0, next_headers.headers)();
+		return `${(_requestHeaders$get = requestHeaders.get("x-pathname")) !== null && _requestHeaders$get !== void 0 ? _requestHeaders$get : ""}${(_requestHeaders$get2 = requestHeaders.get("x-search")) !== null && _requestHeaders$get2 !== void 0 ? _requestHeaders$get2 : ""}`;
+	});
+	return _getCurrentPath.apply(this, arguments);
+}
+//#endregion
+exports.getCurrentPath = getCurrentPath;

package/dist/server.d.cts

@@ -0,0 +1,9 @@
+//#region src/current-path.d.ts
+/**
+ * Returns the current request path (`pathname` + `search`) inside a Server Component, as exposed by
+ * {@link createAlokaiMiddleware} on the request headers. Reading it through this helper keeps the
+ * underlying header names (`x-pathname` / `x-search`) an implementation detail of the framework.
+ */
+declare function getCurrentPath(): Promise<string>;
+//#endregion
+export { getCurrentPath };

package/dist/server.d.mts

@@ -0,0 +1,9 @@
+//#region src/current-path.d.ts
+/**
+ * Returns the current request path (`pathname` + `search`) inside a Server Component, as exposed by
+ * {@link createAlokaiMiddleware} on the request headers. Reading it through this helper keeps the
+ * underlying header names (`x-pathname` / `x-search`) an implementation detail of the framework.
+ */
+declare function getCurrentPath(): Promise<string>;
+//#endregion
+export { getCurrentPath };

package/dist/server.mjs

@@ -0,0 +1,21 @@
+import { t as _asyncToGenerator } from "./asyncToGenerator-Co5zHbo3.mjs";
+import { headers } from "next/headers";
+//#region src/current-path.ts
+/**
+* Returns the current request path (`pathname` + `search`) inside a Server Component, as exposed by
+* {@link createAlokaiMiddleware} on the request headers. Reading it through this helper keeps the
+* underlying header names (`x-pathname` / `x-search`) an implementation detail of the framework.
+*/
+function getCurrentPath() {
+	return _getCurrentPath.apply(this, arguments);
+}
+function _getCurrentPath() {
+	_getCurrentPath = _asyncToGenerator(function* () {
+		var _requestHeaders$get, _requestHeaders$get2;
+		const requestHeaders = yield headers();
+		return `${(_requestHeaders$get = requestHeaders.get("x-pathname")) !== null && _requestHeaders$get !== void 0 ? _requestHeaders$get : ""}${(_requestHeaders$get2 = requestHeaders.get("x-search")) !== null && _requestHeaders$get2 !== void 0 ? _requestHeaders$get2 : ""}`;
+	});
+	return _getCurrentPath.apply(this, arguments);
+}
+//#endregion
+export { getCurrentPath };

package/package.json

@@ -6,7 +6,7 @@
     "type": "git",
     "url": "git+https://github.com/vuestorefront/enterprise.git"
   },
-  "version": "7.0.2",
+  "version": "8.0.0-next.4",
   "exports": {
     ".": {
       "types": "./dist/index.d.mts",
@@ -17,6 +17,11 @@
       "types": "./dist/client.d.mts",
       "import": "./dist/client.mjs",
       "require": "./dist/client.cjs"
+    },
+    "./server": {
+      "types": "./dist/server.d.mts",
+      "import": "./dist/server.mjs",
+      "require": "./dist/server.cjs"
     }
   },
   "files": [
@@ -31,11 +36,11 @@
     "version": "cp CHANGELOG.md ../../docs/enterprise/content/storefront/6.change-log/next.md"
   },
   "dependencies": {
-    "@alokai/instrumentation-next-component": "1.0.3",
+    "@alokai/instrumentation-next-component": "1.0.4-next.0",
     "zustand": "^4.5.4"
   },
   "devDependencies": {
-    "@alokai/connect": "^2.1.0",
+    "@alokai/connect": "2.3.0-next.7",
     "@shared/typescript-config": "1.0.0",
     "@types/react": "^19",
     "@types/react-dom": "^19",
@@ -50,13 +55,12 @@
     "vitest": "4.0.18"
   },
   "peerDependencies": {
-    "@alokai/connect": "^2.1.0",
+    "@alokai/connect": "2.3.0-next.7",
     "next": "^16.0.0",
     "react": "^19.0.0"
   },
   "engines": {
-    "npm": ">=8.0.0",
-    "node": ">=18.0.0"
+    "node": "^20.10.0 || >=22.14.0"
   },
   "publishConfig": {
     "access": "public"