vinext 0.0.44 → 0.0.46

package/dist/server/file-based-metadata.js

@@ -0,0 +1,356 @@
+import { fillRoutePatternSegments, routePattern } from "../routing/route-pattern.js";
+import { getMetadataImageRouteKind, getMetadataRouteKind, isValidMetadataImageId } from "./metadata-routes.js";
+import { makeThenableParams } from "../shims/thenable-params.js";
+//#region src/server/file-based-metadata.ts
+function routeApplies(routePath, routePrefix) {
+	if (!routePrefix) return true;
+	return routePath === routePrefix || routePath.startsWith(`${routePrefix}/`);
+}
+function routeScore(routePrefix) {
+	return routePrefix.split("/").filter(Boolean).length;
+}
+function routeSegmentsApply(routeSegments, routePrefixSegments) {
+	if (routePrefixSegments.length > routeSegments.length) return false;
+	for (let index = 0; index < routePrefixSegments.length; index++) if (routeSegments[index] !== routePrefixSegments[index]) return false;
+	return true;
+}
+function removeParallelRouteSegments(routeSegments) {
+	return routeSegments.filter((segment) => !segment.startsWith("@"));
+}
+function routeSegmentsApplyWithParallelSlots(routeSegments, routePrefixSegments) {
+	if (routeSegmentsApply(routeSegments, routePrefixSegments)) return true;
+	const visiblePrefixSegments = removeParallelRouteSegments(routePrefixSegments);
+	return visiblePrefixSegments.length !== routePrefixSegments.length && routeSegmentsApply(routeSegments, visiblePrefixSegments);
+}
+function routeSpecificity(route) {
+	return route.routeSegments?.length ?? routeScore(route.routePrefix);
+}
+function selectDeepestRoutes(metadataRoutes, kind, routePath, params, routeSegments) {
+	if (!metadataRoutes || metadataRoutes.length === 0) return [];
+	let selectedScore = -1;
+	const selectedRoutes = [];
+	for (const route of metadataRoutes) {
+		if ((route.headData?.kind ?? getMetadataRouteKind(route)) !== kind) continue;
+		if (routeSegments && route.routeSegments) {
+			if (!routeSegmentsApplyWithParallelSlots(routeSegments, route.routeSegments)) continue;
+			const currentScore = routeSpecificity(route);
+			if (currentScore > selectedScore) {
+				selectedScore = currentScore;
+				selectedRoutes.length = 0;
+				selectedRoutes.push(route);
+				continue;
+			}
+			if (currentScore === selectedScore) selectedRoutes.push(route);
+			continue;
+		}
+		const routePrefix = route.routePrefix;
+		const resolvedRoutePrefix = fillRoutePatternSegments(routePrefix, params);
+		const normalizedRoutePrefix = routePattern(routePrefix);
+		if (!routeApplies(routePath, routePrefix) && !routeApplies(routePath, normalizedRoutePrefix) && (!resolvedRoutePrefix || !routeApplies(routePath, resolvedRoutePrefix))) continue;
+		const currentScore = routeSpecificity(route);
+		if (currentScore > selectedScore) {
+			selectedScore = currentScore;
+			selectedRoutes.length = 0;
+			selectedRoutes.push(route);
+			continue;
+		}
+		if (currentScore === selectedScore) selectedRoutes.push(route);
+	}
+	return selectedRoutes;
+}
+function isStringOrUrl(value) {
+	return typeof value === "string" || typeof value === "object" && value instanceof URL;
+}
+function normalizeIconDescriptor(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return null;
+	const urlValue = Reflect.get(value, "url");
+	if (!isStringOrUrl(urlValue)) return null;
+	const entry = { url: urlValue };
+	const sizesValue = Reflect.get(value, "sizes");
+	if (typeof sizesValue === "string") entry.sizes = sizesValue;
+	const typeValue = Reflect.get(value, "type");
+	if (typeof typeValue === "string") entry.type = typeValue;
+	const mediaValue = Reflect.get(value, "media");
+	if (typeof mediaValue === "string") entry.media = mediaValue;
+	return entry;
+}
+function normalizeIconValue(value) {
+	if (isStringOrUrl(value)) return { url: value };
+	return normalizeIconDescriptor(value);
+}
+function normalizeIconValueList(values) {
+	const normalizedEntries = [];
+	for (const value of values) {
+		const normalizedValue = normalizeIconValue(value);
+		if (normalizedValue) normalizedEntries.push(normalizedValue);
+	}
+	return normalizedEntries;
+}
+function normalizeIconEntries(icon) {
+	const normalizedTopLevelValue = normalizeIconValue(icon);
+	if (normalizedTopLevelValue) return [normalizedTopLevelValue];
+	if (Array.isArray(icon)) return normalizeIconValueList(icon);
+	if (!isIconMap(icon)) return [];
+	const iconValue = icon.icon;
+	if (!iconValue) return [];
+	if (Array.isArray(iconValue)) return normalizeIconValueList(iconValue);
+	const normalizedValue = normalizeIconValue(iconValue);
+	return normalizedValue ? [normalizedValue] : [];
+}
+function isIconMap(value) {
+	if (!value || typeof value !== "object" || value instanceof URL || Array.isArray(value)) return false;
+	return normalizeIconValue(value) === null;
+}
+function cloneIconMap(value) {
+	if (!value) return {};
+	if (isIconMap(value)) return { ...value };
+	const iconEntries = normalizeIconEntries(value);
+	return iconEntries.length > 0 ? { icon: iconEntries } : {};
+}
+function buildIconEntry(headData) {
+	if (headData.kind !== "favicon" && headData.kind !== "icon") return null;
+	const iconEntry = { url: headData.href };
+	if (headData.sizes) iconEntry.sizes = headData.sizes;
+	if (headData.type) iconEntry.type = headData.type;
+	return iconEntry;
+}
+function buildAppleEntry(headData) {
+	if (headData.kind !== "apple") return null;
+	const appleEntry = { url: headData.href };
+	if (headData.sizes) appleEntry.sizes = headData.sizes;
+	if (headData.type) appleEntry.type = headData.type;
+	return appleEntry;
+}
+function normalizeAppleEntry(value) {
+	if (isStringOrUrl(value)) return { url: value };
+	return { ...value };
+}
+function buildSocialEntry(headData) {
+	if (headData.kind !== "openGraph" && headData.kind !== "twitter") return null;
+	const socialEntry = { url: headData.href };
+	if (headData.width !== void 0) socialEntry.width = headData.width;
+	if (headData.height !== void 0) socialEntry.height = headData.height;
+	if (headData.alt) socialEntry.alt = headData.alt;
+	if (headData.type) socialEntry.type = headData.type;
+	return socialEntry;
+}
+function normalizeMetadataImageId(route, id) {
+	const normalizedId = String(id);
+	if (!isValidMetadataImageId(normalizedId)) {
+		console.warn(`[vinext] Skipping metadata route ${route.servedUrl} image id "${normalizedId}" because metadata image ids must match /^[a-zA-Z0-9-_.]+$/.`);
+		return null;
+	}
+	return normalizedId;
+}
+function withContentHash(href, contentHash) {
+	if (!contentHash) return href;
+	return `${href}?${contentHash}`;
+}
+function hasOwnProperty(source, key) {
+	return Boolean(source && Object.prototype.hasOwnProperty.call(source, key));
+}
+function hasOpenGraphImages(metadata) {
+	return hasOwnProperty(metadata?.openGraph, "images");
+}
+function hasTwitterImages(metadata) {
+	return hasOwnProperty(metadata?.twitter, "images");
+}
+function hasIcons(metadata) {
+	return Boolean(metadata?.icons);
+}
+function getMetadataSourceForRoute(route, options, fallbackMetadata) {
+	if (!options?.metadataSources) return fallbackMetadata;
+	if (!route.routeSegments) return null;
+	for (let index = options.metadataSources.length - 1; index >= 0; index--) {
+		const source = options.metadataSources[index];
+		if (routeSegmentsApplyWithParallelSlots(source.routeSegments, route.routeSegments)) return source.metadata;
+	}
+	return null;
+}
+function socialRouteHasExplicitImagesAtSource(route, kind, options, fallbackMetadata) {
+	const sourceMetadata = getMetadataSourceForRoute(route, options, fallbackMetadata);
+	return kind === "openGraph" ? hasOpenGraphImages(sourceMetadata) : hasTwitterImages(sourceMetadata);
+}
+function iconRouteHasExplicitIconsAtSource(route, options, fallbackMetadata) {
+	return hasIcons(fallbackMetadata) || hasIcons(getMetadataSourceForRoute(route, options, null));
+}
+function readStringProperty(source, key) {
+	const value = Reflect.get(source, key);
+	return typeof value === "string" ? value : void 0;
+}
+function readNumberProperty(source, key) {
+	const value = Reflect.get(source, key);
+	return typeof value === "number" ? value : void 0;
+}
+function readStringOrNumberProperty(source, key) {
+	const value = Reflect.get(source, key);
+	if (typeof value === "string" || typeof value === "number") return value;
+}
+function readSizeProperty(source) {
+	const sizeValue = Reflect.get(source, "size");
+	if (typeof sizeValue !== "object" || sizeValue === null) return;
+	const width = readNumberProperty(sizeValue, "width");
+	const height = readNumberProperty(sizeValue, "height");
+	if (width === void 0 && height === void 0) return;
+	return {
+		width,
+		height
+	};
+}
+function readDynamicImageMetadataSource(source) {
+	return {
+		id: readStringOrNumberProperty(source, "id"),
+		alt: readStringProperty(source, "alt"),
+		contentType: readStringProperty(source, "contentType"),
+		size: readSizeProperty(source)
+	};
+}
+async function resolveDynamicImageMetadataSources(route, params) {
+	if (!route.module || typeof route.module !== "object") return [];
+	const generateImageMetadata = Reflect.get(route.module, "generateImageMetadata");
+	if (typeof generateImageMetadata !== "function") return [readDynamicImageMetadataSource(route.module)];
+	const result = await generateImageMetadata({ params: makeThenableParams(params) });
+	if (!Array.isArray(result)) return [];
+	const sources = [];
+	for (const entry of result) if (typeof entry === "object" && entry !== null) {
+		const source = readDynamicImageMetadataSource(entry);
+		if (source.id === void 0) {
+			console.warn(`[vinext] Skipping metadata route ${route.servedUrl} image metadata entry because generateImageMetadata entries must include an id.`);
+			continue;
+		}
+		sources.push(source);
+	}
+	return sources;
+}
+async function resolveRouteHeadData(route, params) {
+	if (!route.isDynamic || !route.module || typeof route.module !== "object") return route.headData ? [route.headData] : [];
+	const routeKind = getMetadataImageRouteKind(route);
+	if (!routeKind) return route.headData ? [route.headData] : [];
+	const resolvedUrl = fillRoutePatternSegments(route.servedUrl, params);
+	if (!resolvedUrl) {
+		console.warn(`[vinext] Skipping metadata route ${route.servedUrl} because params did not fill all dynamic segments.`);
+		return [];
+	}
+	const metadataSources = await resolveDynamicImageMetadataSources(route, params);
+	const resolvedHeadData = [];
+	for (const metadataSource of metadataSources) {
+		let hrefBase = resolvedUrl;
+		if (metadataSource.id !== void 0) {
+			const normalizedId = normalizeMetadataImageId(route, metadataSource.id);
+			if (!normalizedId) continue;
+			hrefBase = `${resolvedUrl}/${normalizedId}`;
+		}
+		const href = withContentHash(hrefBase, route.contentHash);
+		const contentType = metadataSource.contentType ?? route.contentType;
+		const size = metadataSource.size;
+		if (routeKind === "icon" || routeKind === "apple") {
+			let sizes;
+			if (size?.width !== void 0 && size.height !== void 0) sizes = `${size.width}x${size.height}`;
+			resolvedHeadData.push({
+				kind: routeKind,
+				href,
+				sizes,
+				type: contentType
+			});
+			continue;
+		}
+		resolvedHeadData.push({
+			kind: routeKind,
+			href,
+			alt: metadataSource.alt,
+			height: size?.height,
+			type: contentType,
+			width: size?.width
+		});
+	}
+	return resolvedHeadData;
+}
+async function resolveHeadDataList(routes, params) {
+	return (await Promise.all(routes.map((route) => resolveRouteHeadData(route, params)))).flat();
+}
+async function applyFileBasedMetadata(metadata, routePath, params, metadataRoutes, options) {
+	if (!metadataRoutes || metadataRoutes.length === 0) return metadata;
+	const routeSegments = options?.routeSegments ?? null;
+	const faviconRoutes = selectDeepestRoutes(metadataRoutes, "favicon", routePath, params, routeSegments);
+	const iconRoutes = selectDeepestRoutes(metadataRoutes, "icon", routePath, params, routeSegments).filter((route) => !iconRouteHasExplicitIconsAtSource(route, options, metadata));
+	const appleRoutes = selectDeepestRoutes(metadataRoutes, "apple", routePath, params, routeSegments).filter((route) => !iconRouteHasExplicitIconsAtSource(route, options, metadata));
+	const openGraphRoutes = selectDeepestRoutes(metadataRoutes, "openGraph", routePath, params, routeSegments).filter((route) => !socialRouteHasExplicitImagesAtSource(route, "openGraph", options, metadata));
+	const twitterRoutes = selectDeepestRoutes(metadataRoutes, "twitter", routePath, params, routeSegments).filter((route) => !socialRouteHasExplicitImagesAtSource(route, "twitter", options, metadata));
+	const manifestRoutes = selectDeepestRoutes(metadataRoutes, "manifest", routePath, params, routeSegments);
+	const [faviconHeadData, iconHeadData, appleHeadData, openGraphHeadData, twitterHeadData, manifestHeadData] = await Promise.all([
+		resolveHeadDataList(faviconRoutes, params),
+		resolveHeadDataList(iconRoutes, params),
+		resolveHeadDataList(appleRoutes, params),
+		resolveHeadDataList(openGraphRoutes, params),
+		resolveHeadDataList(twitterRoutes, params),
+		resolveHeadDataList(manifestRoutes, params)
+	]);
+	if (!metadata && faviconHeadData.length === 0 && iconHeadData.length === 0 && appleHeadData.length === 0 && openGraphHeadData.length === 0 && twitterHeadData.length === 0 && manifestHeadData.length === 0) return null;
+	const nextMetadata = metadata ? { ...metadata } : {};
+	const faviconEntries = [];
+	for (const headData of faviconHeadData) {
+		const iconEntry = buildIconEntry(headData);
+		if (iconEntry) faviconEntries.push(iconEntry);
+	}
+	if (faviconEntries.length > 0) {
+		const nextIcons = cloneIconMap(nextMetadata.icons);
+		const normalizedIcons = normalizeIconEntries(nextIcons);
+		nextIcons.icon = [...faviconEntries, ...normalizedIcons];
+		nextMetadata.icons = nextIcons;
+	}
+	{
+		const nextIcons = cloneIconMap(nextMetadata.icons);
+		const iconEntries = [];
+		for (const headData of iconHeadData) {
+			const iconEntry = buildIconEntry(headData);
+			if (iconEntry) iconEntries.push(iconEntry);
+		}
+		if (iconEntries.length > 0) {
+			const normalizedIcons = normalizeIconEntries(nextIcons);
+			nextIcons.icon = [...iconEntries, ...normalizedIcons];
+		}
+		const appleEntries = [];
+		for (const headData of appleHeadData) {
+			const appleEntry = buildAppleEntry(headData);
+			if (appleEntry) appleEntries.push(appleEntry);
+		}
+		if (appleEntries.length > 0) {
+			const existingApple = nextIcons.apple;
+			const normalizedAppleEntries = [];
+			if (Array.isArray(existingApple)) for (const entry of existingApple) normalizedAppleEntries.push(normalizeAppleEntry(entry));
+			else if (existingApple) normalizedAppleEntries.push(normalizeAppleEntry(existingApple));
+			nextIcons.apple = [...appleEntries, ...normalizedAppleEntries];
+		}
+		if (iconEntries.length > 0 || appleEntries.length > 0) nextMetadata.icons = nextIcons;
+	}
+	if (openGraphHeadData.length > 0) {
+		const socialEntries = [];
+		for (const headData of openGraphHeadData) {
+			const socialEntry = buildSocialEntry(headData);
+			if (socialEntry) socialEntries.push(socialEntry);
+		}
+		if (socialEntries.length > 0) {
+			const nextOpenGraph = nextMetadata.openGraph ? { ...nextMetadata.openGraph } : {};
+			nextOpenGraph.images = socialEntries;
+			nextMetadata.openGraph = nextOpenGraph;
+		}
+	}
+	if (twitterHeadData.length > 0) {
+		const socialEntries = [];
+		for (const headData of twitterHeadData) {
+			const socialEntry = buildSocialEntry(headData);
+			if (socialEntry) socialEntries.push(socialEntry);
+		}
+		if (socialEntries.length > 0) {
+			const nextTwitter = nextMetadata.twitter ? { ...nextMetadata.twitter } : {};
+			nextTwitter.images = socialEntries;
+			nextMetadata.twitter = nextTwitter;
+		}
+	}
+	if (manifestHeadData.length > 0 && manifestHeadData[0].kind === "manifest") nextMetadata.manifest = manifestHeadData[0].href;
+	return nextMetadata;
+}
+//#endregion
+export { applyFileBasedMetadata };
+
+//# sourceMappingURL=file-based-metadata.js.map

package/dist/server/file-based-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-based-metadata.js","names":[],"sources":["../../src/server/file-based-metadata.ts"],"sourcesContent":["import type { Metadata } from \"vinext/shims/metadata\";\nimport { makeThenableParams } from \"vinext/shims/thenable-params\";\nimport { fillRoutePatternSegments, routePattern } from \"../routing/route-pattern.js\";\nimport {\n  getMetadataImageRouteKind,\n  getMetadataRouteKind,\n  isValidMetadataImageId,\n  type MetadataFileRoute,\n  type MetadataRouteHeadData,\n} from \"./metadata-routes.js\";\n\ntype AppPageParams = Record<string, string | string[]>;\n\ntype IconEntry = {\n  url: string | URL;\n  sizes?: string;\n  type?: string;\n  media?: string;\n};\n\ntype AppleIconEntry = {\n  url: string | URL;\n  sizes?: string;\n  type?: string;\n};\n\ntype SocialImageEntry = {\n  url: string | URL;\n  width?: number;\n  height?: number;\n  alt?: string;\n  type?: string;\n};\n\ntype DynamicImageSize = {\n  width?: number;\n  height?: number;\n};\n\ntype DynamicImageMetadataSource = {\n  id?: string | number;\n  alt?: string;\n  contentType?: string;\n  size?: DynamicImageSize;\n};\n\ntype FileBasedMetadataSource = {\n  routeSegments: readonly string[];\n  metadata: Metadata | null;\n};\n\ntype FileBasedMetadataOptions = {\n  routeSegments?: readonly string[] | null;\n  metadataSources?: readonly FileBasedMetadataSource[] | null;\n};\n\ntype IconMap = {\n  icon?: string | URL | IconEntry | IconEntry[];\n  shortcut?: string | URL | Array<string | URL>;\n  apple?: string | URL | AppleIconEntry | AppleIconEntry[];\n  other?: Array<{ rel: string; url: string | URL; sizes?: string; type?: string }>;\n};\n\nfunction routeApplies(routePath: string, routePrefix: string): boolean {\n  if (!routePrefix) {\n    return true;\n  }\n  return routePath === routePrefix || routePath.startsWith(`${routePrefix}/`);\n}\n\nfunction routeScore(routePrefix: string): number {\n  return routePrefix.split(\"/\").filter(Boolean).length;\n}\n\nfunction routeSegmentsApply(\n  routeSegments: readonly string[],\n  routePrefixSegments: readonly string[],\n): boolean {\n  if (routePrefixSegments.length > routeSegments.length) {\n    return false;\n  }\n\n  for (let index = 0; index < routePrefixSegments.length; index++) {\n    if (routeSegments[index] !== routePrefixSegments[index]) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\nfunction removeParallelRouteSegments(routeSegments: readonly string[]): string[] {\n  return routeSegments.filter((segment) => !segment.startsWith(\"@\"));\n}\n\nfunction routeSegmentsApplyWithParallelSlots(\n  routeSegments: readonly string[],\n  routePrefixSegments: readonly string[],\n): boolean {\n  if (routeSegmentsApply(routeSegments, routePrefixSegments)) {\n    return true;\n  }\n\n  const visiblePrefixSegments = removeParallelRouteSegments(routePrefixSegments);\n  return (\n    visiblePrefixSegments.length !== routePrefixSegments.length &&\n    routeSegmentsApply(routeSegments, visiblePrefixSegments)\n  );\n}\n\nfunction routeSpecificity(route: MetadataFileRoute): number {\n  return route.routeSegments?.length ?? routeScore(route.routePrefix);\n}\n\nfunction selectDeepestRoutes(\n  metadataRoutes: readonly MetadataFileRoute[] | null | undefined,\n  kind: MetadataRouteHeadData[\"kind\"],\n  routePath: string,\n  params: AppPageParams,\n  routeSegments: readonly string[] | null | undefined,\n): MetadataFileRoute[] {\n  if (!metadataRoutes || metadataRoutes.length === 0) {\n    return [];\n  }\n\n  let selectedScore = -1;\n  const selectedRoutes: MetadataFileRoute[] = [];\n\n  for (const route of metadataRoutes) {\n    const routeKind = route.headData?.kind ?? getMetadataRouteKind(route);\n\n    if (routeKind !== kind) {\n      continue;\n    }\n\n    if (routeSegments && route.routeSegments) {\n      // Raw app-tree segments are authoritative when present. Falling back to\n      // visible URL prefixes here would reintroduce route-group collisions.\n      if (!routeSegmentsApplyWithParallelSlots(routeSegments, route.routeSegments)) {\n        continue;\n      }\n      const currentScore = routeSpecificity(route);\n      if (currentScore > selectedScore) {\n        selectedScore = currentScore;\n        selectedRoutes.length = 0;\n        selectedRoutes.push(route);\n        continue;\n      }\n\n      if (currentScore === selectedScore) {\n        selectedRoutes.push(route);\n      }\n      continue;\n    }\n\n    const routePrefix = route.routePrefix;\n    const resolvedRoutePrefix = fillRoutePatternSegments(routePrefix, params);\n    const normalizedRoutePrefix = routePattern(routePrefix);\n    if (\n      !routeApplies(routePath, routePrefix) &&\n      !routeApplies(routePath, normalizedRoutePrefix) &&\n      (!resolvedRoutePrefix || !routeApplies(routePath, resolvedRoutePrefix))\n    ) {\n      continue;\n    }\n\n    const currentScore = routeSpecificity(route);\n    if (currentScore > selectedScore) {\n      selectedScore = currentScore;\n      selectedRoutes.length = 0;\n      selectedRoutes.push(route);\n      continue;\n    }\n\n    if (currentScore === selectedScore) {\n      selectedRoutes.push(route);\n    }\n  }\n\n  return selectedRoutes;\n}\n\nfunction isStringOrUrl(value: unknown): value is string | URL {\n  return typeof value === \"string\" || (typeof value === \"object\" && value instanceof URL);\n}\n\nfunction normalizeIconDescriptor(value: unknown): IconEntry | null {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    return null;\n  }\n\n  const urlValue = Reflect.get(value, \"url\");\n  if (!isStringOrUrl(urlValue)) {\n    return null;\n  }\n\n  const entry: IconEntry = { url: urlValue };\n\n  const sizesValue = Reflect.get(value, \"sizes\");\n  if (typeof sizesValue === \"string\") {\n    entry.sizes = sizesValue;\n  }\n\n  const typeValue = Reflect.get(value, \"type\");\n  if (typeof typeValue === \"string\") {\n    entry.type = typeValue;\n  }\n\n  const mediaValue = Reflect.get(value, \"media\");\n  if (typeof mediaValue === \"string\") {\n    entry.media = mediaValue;\n  }\n\n  return entry;\n}\n\nfunction normalizeIconValue(value: unknown): IconEntry | null {\n  if (isStringOrUrl(value)) {\n    return { url: value };\n  }\n\n  return normalizeIconDescriptor(value);\n}\n\nfunction normalizeIconValueList(values: readonly unknown[]): IconEntry[] {\n  const normalizedEntries: IconEntry[] = [];\n  for (const value of values) {\n    const normalizedValue = normalizeIconValue(value);\n    if (normalizedValue) {\n      normalizedEntries.push(normalizedValue);\n    }\n  }\n  return normalizedEntries;\n}\n\nfunction normalizeIconEntries(icon: NonNullable<Metadata[\"icons\"]>): IconEntry[] {\n  const normalizedTopLevelValue = normalizeIconValue(icon);\n  if (normalizedTopLevelValue) {\n    return [normalizedTopLevelValue];\n  }\n\n  if (Array.isArray(icon)) {\n    return normalizeIconValueList(icon);\n  }\n\n  if (!isIconMap(icon)) {\n    return [];\n  }\n\n  const iconValue = icon.icon;\n  if (!iconValue) {\n    return [];\n  }\n\n  if (Array.isArray(iconValue)) {\n    return normalizeIconValueList(iconValue);\n  }\n\n  const normalizedValue = normalizeIconValue(iconValue);\n  return normalizedValue ? [normalizedValue] : [];\n}\n\nfunction isIconMap(value: Metadata[\"icons\"]): value is IconMap {\n  if (!value || typeof value !== \"object\" || value instanceof URL || Array.isArray(value)) {\n    return false;\n  }\n  return normalizeIconValue(value) === null;\n}\n\nfunction cloneIconMap(value: Metadata[\"icons\"]): IconMap {\n  if (!value) {\n    return {};\n  }\n\n  if (isIconMap(value)) {\n    return { ...value };\n  }\n\n  const iconEntries = normalizeIconEntries(value);\n  return iconEntries.length > 0 ? { icon: iconEntries } : {};\n}\n\nfunction buildIconEntry(headData: MetadataRouteHeadData): IconEntry | null {\n  if (headData.kind !== \"favicon\" && headData.kind !== \"icon\") {\n    return null;\n  }\n\n  const iconEntry: IconEntry = {\n    url: headData.href,\n  };\n  if (headData.sizes) {\n    iconEntry.sizes = headData.sizes;\n  }\n  if (headData.type) {\n    iconEntry.type = headData.type;\n  }\n  return iconEntry;\n}\n\nfunction buildAppleEntry(headData: MetadataRouteHeadData): AppleIconEntry | null {\n  if (headData.kind !== \"apple\") {\n    return null;\n  }\n\n  const appleEntry: AppleIconEntry = {\n    url: headData.href,\n  };\n  if (headData.sizes) {\n    appleEntry.sizes = headData.sizes;\n  }\n  if (headData.type) {\n    appleEntry.type = headData.type;\n  }\n  return appleEntry;\n}\n\nfunction normalizeAppleEntry(value: string | URL | AppleIconEntry): AppleIconEntry {\n  if (isStringOrUrl(value)) {\n    return { url: value };\n  }\n  return { ...value };\n}\n\nfunction buildSocialEntry(headData: MetadataRouteHeadData): SocialImageEntry | null {\n  if (headData.kind !== \"openGraph\" && headData.kind !== \"twitter\") {\n    return null;\n  }\n\n  const socialEntry: SocialImageEntry = {\n    url: headData.href,\n  };\n  if (headData.width !== undefined) {\n    socialEntry.width = headData.width;\n  }\n  if (headData.height !== undefined) {\n    socialEntry.height = headData.height;\n  }\n  if (headData.alt) {\n    socialEntry.alt = headData.alt;\n  }\n  if (headData.type) {\n    socialEntry.type = headData.type;\n  }\n  return socialEntry;\n}\n\nfunction normalizeMetadataImageId(route: MetadataFileRoute, id: string | number): string | null {\n  const normalizedId = String(id);\n  if (!isValidMetadataImageId(normalizedId)) {\n    console.warn(\n      `[vinext] Skipping metadata route ${route.servedUrl} image id \"${normalizedId}\" because metadata image ids must match /^[a-zA-Z0-9-_.]+$/.`,\n    );\n    return null;\n  }\n  return normalizedId;\n}\n\nfunction withContentHash(href: string, contentHash?: string): string {\n  if (!contentHash) {\n    return href;\n  }\n  return `${href}?${contentHash}`;\n}\n\nfunction hasOwnProperty(source: object | null | undefined, key: string): boolean {\n  return Boolean(source && Object.prototype.hasOwnProperty.call(source, key));\n}\n\nfunction hasOpenGraphImages(metadata: Metadata | null | undefined): boolean {\n  return hasOwnProperty(metadata?.openGraph, \"images\");\n}\n\nfunction hasTwitterImages(metadata: Metadata | null | undefined): boolean {\n  return hasOwnProperty(metadata?.twitter, \"images\");\n}\n\nfunction hasIcons(metadata: Metadata | null | undefined): boolean {\n  return Boolean(metadata?.icons);\n}\n\nfunction getMetadataSourceForRoute(\n  route: MetadataFileRoute,\n  options: FileBasedMetadataOptions | undefined,\n  fallbackMetadata: Metadata | null,\n): Metadata | null {\n  if (!options?.metadataSources) {\n    return fallbackMetadata;\n  }\n\n  if (!route.routeSegments) {\n    return null;\n  }\n\n  for (let index = options.metadataSources.length - 1; index >= 0; index--) {\n    const source = options.metadataSources[index];\n    if (routeSegmentsApplyWithParallelSlots(source.routeSegments, route.routeSegments)) {\n      return source.metadata;\n    }\n  }\n\n  return null;\n}\n\nfunction socialRouteHasExplicitImagesAtSource(\n  route: MetadataFileRoute,\n  kind: \"openGraph\" | \"twitter\",\n  options: FileBasedMetadataOptions | undefined,\n  fallbackMetadata: Metadata | null,\n): boolean {\n  const sourceMetadata = getMetadataSourceForRoute(route, options, fallbackMetadata);\n  return kind === \"openGraph\"\n    ? hasOpenGraphImages(sourceMetadata)\n    : hasTwitterImages(sourceMetadata);\n}\n\nfunction iconRouteHasExplicitIconsAtSource(\n  route: MetadataFileRoute,\n  options: FileBasedMetadataOptions | undefined,\n  fallbackMetadata: Metadata | null,\n): boolean {\n  // Next suppresses file icon routes when any resolved icons metadata exists.\n  // Social image routes stay segment-scoped instead of using this merged fallback.\n  return hasIcons(fallbackMetadata) || hasIcons(getMetadataSourceForRoute(route, options, null));\n}\n\nfunction readStringProperty(source: object, key: string): string | undefined {\n  const value = Reflect.get(source, key);\n  return typeof value === \"string\" ? value : undefined;\n}\n\nfunction readNumberProperty(source: object, key: string): number | undefined {\n  const value = Reflect.get(source, key);\n  return typeof value === \"number\" ? value : undefined;\n}\n\nfunction readStringOrNumberProperty(source: object, key: string): string | number | undefined {\n  const value = Reflect.get(source, key);\n  if (typeof value === \"string\" || typeof value === \"number\") {\n    return value;\n  }\n  return undefined;\n}\n\nfunction readSizeProperty(source: object): DynamicImageSize | undefined {\n  const sizeValue = Reflect.get(source, \"size\");\n  if (typeof sizeValue !== \"object\" || sizeValue === null) {\n    return undefined;\n  }\n\n  const width = readNumberProperty(sizeValue, \"width\");\n  const height = readNumberProperty(sizeValue, \"height\");\n  if (width === undefined && height === undefined) {\n    return undefined;\n  }\n\n  return { width, height };\n}\n\nfunction readDynamicImageMetadataSource(source: object): DynamicImageMetadataSource {\n  return {\n    id: readStringOrNumberProperty(source, \"id\"),\n    alt: readStringProperty(source, \"alt\"),\n    contentType: readStringProperty(source, \"contentType\"),\n    size: readSizeProperty(source),\n  };\n}\n\nasync function resolveDynamicImageMetadataSources(\n  route: MetadataFileRoute,\n  params: AppPageParams,\n): Promise<DynamicImageMetadataSource[]> {\n  if (!route.module || typeof route.module !== \"object\") {\n    return [];\n  }\n\n  const generateImageMetadata = Reflect.get(route.module, \"generateImageMetadata\");\n  if (typeof generateImageMetadata !== \"function\") {\n    return [readDynamicImageMetadataSource(route.module)];\n  }\n\n  const result = await generateImageMetadata({ params: makeThenableParams(params) });\n  if (!Array.isArray(result)) {\n    return [];\n  }\n\n  const sources: DynamicImageMetadataSource[] = [];\n  for (const entry of result) {\n    if (typeof entry === \"object\" && entry !== null) {\n      const source = readDynamicImageMetadataSource(entry);\n      if (source.id === undefined) {\n        console.warn(\n          `[vinext] Skipping metadata route ${route.servedUrl} image metadata entry because generateImageMetadata entries must include an id.`,\n        );\n        continue;\n      }\n      sources.push(source);\n    }\n  }\n  return sources;\n}\n\nasync function resolveRouteHeadData(\n  route: MetadataFileRoute,\n  params: AppPageParams,\n): Promise<MetadataRouteHeadData[]> {\n  if (!route.isDynamic || !route.module || typeof route.module !== \"object\") {\n    return route.headData ? [route.headData] : [];\n  }\n\n  const routeKind = getMetadataImageRouteKind(route);\n  if (!routeKind) {\n    return route.headData ? [route.headData] : [];\n  }\n\n  // servedUrl must stay query-free here; content hashes are appended after dynamic segment filling.\n  const resolvedUrl = fillRoutePatternSegments(route.servedUrl, params);\n  if (!resolvedUrl) {\n    console.warn(\n      `[vinext] Skipping metadata route ${route.servedUrl} because params did not fill all dynamic segments.`,\n    );\n    return [];\n  }\n  const metadataSources = await resolveDynamicImageMetadataSources(route, params);\n  const resolvedHeadData: MetadataRouteHeadData[] = [];\n\n  for (const metadataSource of metadataSources) {\n    let hrefBase = resolvedUrl;\n    if (metadataSource.id !== undefined) {\n      const normalizedId = normalizeMetadataImageId(route, metadataSource.id);\n      if (!normalizedId) {\n        continue;\n      }\n      hrefBase = `${resolvedUrl}/${normalizedId}`;\n    }\n    const href = withContentHash(hrefBase, route.contentHash);\n    const contentType = metadataSource.contentType ?? route.contentType;\n    const size = metadataSource.size;\n\n    if (routeKind === \"icon\" || routeKind === \"apple\") {\n      let sizes: string | undefined;\n      if (size?.width !== undefined && size.height !== undefined) {\n        sizes = `${size.width}x${size.height}`;\n      }\n\n      resolvedHeadData.push({\n        kind: routeKind,\n        href,\n        sizes,\n        type: contentType,\n      });\n      continue;\n    }\n\n    resolvedHeadData.push({\n      kind: routeKind,\n      href,\n      alt: metadataSource.alt,\n      height: size?.height,\n      type: contentType,\n      width: size?.width,\n    });\n  }\n\n  return resolvedHeadData;\n}\n\nasync function resolveHeadDataList(\n  routes: MetadataFileRoute[],\n  params: AppPageParams,\n): Promise<MetadataRouteHeadData[]> {\n  const headDataList = await Promise.all(\n    routes.map((route) => resolveRouteHeadData(route, params)),\n  );\n  return headDataList.flat();\n}\n\nexport async function applyFileBasedMetadata(\n  metadata: Metadata | null,\n  routePath: string,\n  params: AppPageParams,\n  metadataRoutes: readonly MetadataFileRoute[] | null | undefined,\n  options?: FileBasedMetadataOptions,\n): Promise<Metadata | null> {\n  if (!metadataRoutes || metadataRoutes.length === 0) {\n    return metadata;\n  }\n\n  const routeSegments = options?.routeSegments ?? null;\n  const faviconRoutes = selectDeepestRoutes(\n    metadataRoutes,\n    \"favicon\",\n    routePath,\n    params,\n    routeSegments,\n  );\n  const iconRoutes = selectDeepestRoutes(\n    metadataRoutes,\n    \"icon\",\n    routePath,\n    params,\n    routeSegments,\n  ).filter((route) => !iconRouteHasExplicitIconsAtSource(route, options, metadata));\n  const appleRoutes = selectDeepestRoutes(\n    metadataRoutes,\n    \"apple\",\n    routePath,\n    params,\n    routeSegments,\n  ).filter((route) => !iconRouteHasExplicitIconsAtSource(route, options, metadata));\n  const openGraphRoutes = selectDeepestRoutes(\n    metadataRoutes,\n    \"openGraph\",\n    routePath,\n    params,\n    routeSegments,\n  ).filter((route) => !socialRouteHasExplicitImagesAtSource(route, \"openGraph\", options, metadata));\n  const twitterRoutes = selectDeepestRoutes(\n    metadataRoutes,\n    \"twitter\",\n    routePath,\n    params,\n    routeSegments,\n  ).filter((route) => !socialRouteHasExplicitImagesAtSource(route, \"twitter\", options, metadata));\n  const manifestRoutes = selectDeepestRoutes(\n    metadataRoutes,\n    \"manifest\",\n    routePath,\n    params,\n    routeSegments,\n  );\n\n  const [\n    faviconHeadData,\n    iconHeadData,\n    appleHeadData,\n    openGraphHeadData,\n    twitterHeadData,\n    manifestHeadData,\n  ] = await Promise.all([\n    resolveHeadDataList(faviconRoutes, params),\n    resolveHeadDataList(iconRoutes, params),\n    resolveHeadDataList(appleRoutes, params),\n    resolveHeadDataList(openGraphRoutes, params),\n    resolveHeadDataList(twitterRoutes, params),\n    resolveHeadDataList(manifestRoutes, params),\n  ]);\n\n  if (\n    !metadata &&\n    faviconHeadData.length === 0 &&\n    iconHeadData.length === 0 &&\n    appleHeadData.length === 0 &&\n    openGraphHeadData.length === 0 &&\n    twitterHeadData.length === 0 &&\n    manifestHeadData.length === 0\n  ) {\n    return null;\n  }\n\n  const nextMetadata: Metadata = metadata ? { ...metadata } : {};\n\n  const faviconEntries: IconEntry[] = [];\n  for (const headData of faviconHeadData) {\n    const iconEntry = buildIconEntry(headData);\n    if (iconEntry) {\n      faviconEntries.push(iconEntry);\n    }\n  }\n  if (faviconEntries.length > 0) {\n    const nextIcons = cloneIconMap(nextMetadata.icons);\n    const normalizedIcons = normalizeIconEntries(nextIcons);\n    nextIcons.icon = [...faviconEntries, ...normalizedIcons];\n    nextMetadata.icons = nextIcons;\n  }\n\n  {\n    const nextIcons = cloneIconMap(nextMetadata.icons);\n\n    const iconEntries: IconEntry[] = [];\n    for (const headData of iconHeadData) {\n      const iconEntry = buildIconEntry(headData);\n      if (iconEntry) {\n        iconEntries.push(iconEntry);\n      }\n    }\n    if (iconEntries.length > 0) {\n      const normalizedIcons = normalizeIconEntries(nextIcons);\n      nextIcons.icon = [...iconEntries, ...normalizedIcons];\n    }\n\n    const appleEntries: AppleIconEntry[] = [];\n    for (const headData of appleHeadData) {\n      const appleEntry = buildAppleEntry(headData);\n      if (appleEntry) {\n        appleEntries.push(appleEntry);\n      }\n    }\n    if (appleEntries.length > 0) {\n      const existingApple = nextIcons.apple;\n      const normalizedAppleEntries: AppleIconEntry[] = [];\n      if (Array.isArray(existingApple)) {\n        for (const entry of existingApple) {\n          normalizedAppleEntries.push(normalizeAppleEntry(entry));\n        }\n      } else if (existingApple) {\n        normalizedAppleEntries.push(normalizeAppleEntry(existingApple));\n      }\n      nextIcons.apple = [...appleEntries, ...normalizedAppleEntries];\n    }\n\n    if (iconEntries.length > 0 || appleEntries.length > 0) {\n      nextMetadata.icons = nextIcons;\n    }\n  }\n\n  if (openGraphHeadData.length > 0) {\n    const socialEntries: SocialImageEntry[] = [];\n    for (const headData of openGraphHeadData) {\n      const socialEntry = buildSocialEntry(headData);\n      if (socialEntry) {\n        socialEntries.push(socialEntry);\n      }\n    }\n    if (socialEntries.length > 0) {\n      const nextOpenGraph: NonNullable<Metadata[\"openGraph\"]> = nextMetadata.openGraph\n        ? { ...nextMetadata.openGraph }\n        : {};\n      nextOpenGraph.images = socialEntries;\n      nextMetadata.openGraph = nextOpenGraph;\n    }\n  }\n\n  if (twitterHeadData.length > 0) {\n    const socialEntries: SocialImageEntry[] = [];\n    for (const headData of twitterHeadData) {\n      const socialEntry = buildSocialEntry(headData);\n      if (socialEntry) {\n        socialEntries.push(socialEntry);\n      }\n    }\n    if (socialEntries.length > 0) {\n      const nextTwitter: NonNullable<Metadata[\"twitter\"]> = nextMetadata.twitter\n        ? { ...nextMetadata.twitter }\n        : {};\n      nextTwitter.images = socialEntries;\n      nextMetadata.twitter = nextTwitter;\n    }\n  }\n\n  if (manifestHeadData.length > 0 && manifestHeadData[0].kind === \"manifest\") {\n    nextMetadata.manifest = manifestHeadData[0].href;\n  }\n\n  return nextMetadata;\n}\n"],"mappings":"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"}

package/dist/server/implicit-tags.d.ts

@@ -0,0 +1,6 @@
+//#region src/server/implicit-tags.d.ts
+type AppCacheLeafKind = "page" | "route";
+declare function buildPageCacheTags(pathname: string, extraTags: string[], routeSegments: string[], leafKind: AppCacheLeafKind): string[];
+//#endregion
+export { buildPageCacheTags };
+//# sourceMappingURL=implicit-tags.d.ts.map

package/dist/server/implicit-tags.js

@@ -0,0 +1,42 @@
+//#region src/server/implicit-tags.ts
+const NEXT_CACHE_IMPLICIT_TAG_ID = "_N_T_";
+function appendUnique(tags, tag) {
+	if (!tags.includes(tag)) tags.push(tag);
+}
+function normalizeRouteSegment(segment) {
+	if (!segment || segment === "." || segment.startsWith("@")) return null;
+	return segment;
+}
+function buildRouteCachePath(routeSegments, leafKind) {
+	const parts = [];
+	for (const segment of routeSegments) {
+		const normalized = normalizeRouteSegment(segment);
+		if (normalized) parts.push(normalized);
+	}
+	parts.push(leafKind);
+	return `/${parts.join("/")}`;
+}
+function appendDerivedTags(tags, routePath) {
+	appendUnique(tags, `${NEXT_CACHE_IMPLICIT_TAG_ID}/layout`);
+	if (!routePath.startsWith("/")) return;
+	const routeParts = routePath.split("/");
+	const leafIndex = routeParts.length - 1;
+	for (let i = 1; i <= routeParts.length; i++) {
+		let currentPathname = routeParts.slice(0, i).join("/");
+		if (!currentPathname) continue;
+		if (!(i - 1 === leafIndex)) currentPathname = `${currentPathname}/layout`;
+		appendUnique(tags, `${NEXT_CACHE_IMPLICIT_TAG_ID}${currentPathname}`);
+	}
+}
+function buildPageCacheTags(pathname, extraTags, routeSegments, leafKind) {
+	const tags = [pathname, `${NEXT_CACHE_IMPLICIT_TAG_ID}${pathname}`];
+	if (pathname === "/") appendUnique(tags, `${NEXT_CACHE_IMPLICIT_TAG_ID}/index`);
+	if (pathname === "/index") appendUnique(tags, `${NEXT_CACHE_IMPLICIT_TAG_ID}/`);
+	appendDerivedTags(tags, buildRouteCachePath(routeSegments, leafKind));
+	for (const tag of extraTags) appendUnique(tags, tag);
+	return tags;
+}
+//#endregion
+export { buildPageCacheTags };
+
+//# sourceMappingURL=implicit-tags.js.map

package/dist/server/implicit-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"implicit-tags.js","names":[],"sources":["../../src/server/implicit-tags.ts"],"sourcesContent":["const NEXT_CACHE_IMPLICIT_TAG_ID = \"_N_T_\";\n\ntype AppCacheLeafKind = \"page\" | \"route\";\n\nfunction appendUnique(tags: string[], tag: string): void {\n  if (!tags.includes(tag)) tags.push(tag);\n}\n\n// App route segments come from raw filesystem directories, so dynamic\n// segments are already in bracket notation such as [slug] or [...all].\nfunction normalizeRouteSegment(segment: string): string | null {\n  if (!segment || segment === \".\" || segment.startsWith(\"@\")) return null;\n  return segment;\n}\n\nfunction buildRouteCachePath(routeSegments: string[], leafKind: AppCacheLeafKind): string {\n  const parts: string[] = [];\n  for (const segment of routeSegments) {\n    const normalized = normalizeRouteSegment(segment);\n    if (normalized) parts.push(normalized);\n  }\n  parts.push(leafKind);\n  return `/${parts.join(\"/\")}`;\n}\n\nfunction appendDerivedTags(tags: string[], routePath: string): void {\n  appendUnique(tags, `${NEXT_CACHE_IMPLICIT_TAG_ID}/layout`);\n\n  if (!routePath.startsWith(\"/\")) return;\n\n  const routeParts = routePath.split(\"/\");\n  const leafIndex = routeParts.length - 1;\n  for (let i = 1; i <= routeParts.length; i++) {\n    let currentPathname = routeParts.slice(0, i).join(\"/\");\n    if (!currentPathname) continue;\n\n    const isLeaf = i - 1 === leafIndex;\n    if (!isLeaf) {\n      currentPathname = `${currentPathname}/layout`;\n    }\n\n    appendUnique(tags, `${NEXT_CACHE_IMPLICIT_TAG_ID}${currentPathname}`);\n  }\n}\n\nexport function buildPageCacheTags(\n  pathname: string,\n  extraTags: string[],\n  routeSegments: string[],\n  leafKind: AppCacheLeafKind,\n): string[] {\n  const tags = [pathname, `${NEXT_CACHE_IMPLICIT_TAG_ID}${pathname}`];\n  if (pathname === \"/\") appendUnique(tags, `${NEXT_CACHE_IMPLICIT_TAG_ID}/index`);\n  if (pathname === \"/index\") appendUnique(tags, `${NEXT_CACHE_IMPLICIT_TAG_ID}/`);\n  appendDerivedTags(tags, buildRouteCachePath(routeSegments, leafKind));\n\n  for (const tag of extraTags) {\n    appendUnique(tags, tag);\n  }\n\n  return tags;\n}\n"],"mappings":";AAAA,MAAM,6BAA6B;AAInC,SAAS,aAAa,MAAgB,KAAmB;AACvD,KAAI,CAAC,KAAK,SAAS,IAAI,CAAE,MAAK,KAAK,IAAI;;AAKzC,SAAS,sBAAsB,SAAgC;AAC7D,KAAI,CAAC,WAAW,YAAY,OAAO,QAAQ,WAAW,IAAI,CAAE,QAAO;AACnE,QAAO;;AAGT,SAAS,oBAAoB,eAAyB,UAAoC;CACxF,MAAM,QAAkB,EAAE;AAC1B,MAAK,MAAM,WAAW,eAAe;EACnC,MAAM,aAAa,sBAAsB,QAAQ;AACjD,MAAI,WAAY,OAAM,KAAK,WAAW;;AAExC,OAAM,KAAK,SAAS;AACpB,QAAO,IAAI,MAAM,KAAK,IAAI;;AAG5B,SAAS,kBAAkB,MAAgB,WAAyB;AAClE,cAAa,MAAM,GAAG,2BAA2B,SAAS;AAE1D,KAAI,CAAC,UAAU,WAAW,IAAI,CAAE;CAEhC,MAAM,aAAa,UAAU,MAAM,IAAI;CACvC,MAAM,YAAY,WAAW,SAAS;AACtC,MAAK,IAAI,IAAI,GAAG,KAAK,WAAW,QAAQ,KAAK;EAC3C,IAAI,kBAAkB,WAAW,MAAM,GAAG,EAAE,CAAC,KAAK,IAAI;AACtD,MAAI,CAAC,gBAAiB;AAGtB,MAAI,EADW,IAAI,MAAM,WAEvB,mBAAkB,GAAG,gBAAgB;AAGvC,eAAa,MAAM,GAAG,6BAA6B,kBAAkB;;;AAIzE,SAAgB,mBACd,UACA,WACA,eACA,UACU;CACV,MAAM,OAAO,CAAC,UAAU,GAAG,6BAA6B,WAAW;AACnE,KAAI,aAAa,IAAK,cAAa,MAAM,GAAG,2BAA2B,QAAQ;AAC/E,KAAI,aAAa,SAAU,cAAa,MAAM,GAAG,2BAA2B,GAAG;AAC/E,mBAAkB,MAAM,oBAAoB,eAAe,SAAS,CAAC;AAErE,MAAK,MAAM,OAAO,UAChB,cAAa,MAAM,IAAI;AAGzB,QAAO"}

package/dist/server/instrumentation.js.map

@@ -1 +1 @@
-{"version":3,"file":"instrumentation.js","names":[],"sources":["../../src/server/instrumentation.ts"],"sourcesContent":["/**\n * instrumentation.ts support\n *\n * Next.js supports an `instrumentation.ts` file at the project root that\n * exports a `register()` function. This function is called once when the\n * server starts, before any request handling. It's the recommended way to\n * set up observability tools (Sentry, Datadog, OpenTelemetry, etc.).\n *\n * Optionally, it can also export `onRequestError()` which is called when\n * an unhandled error occurs during request handling.\n *\n * References:\n * - https://nextjs.org/docs/app/building-your-application/optimizing/instrumentation\n *\n * ## App Router\n *\n * For App Router, `register()` is baked directly into the generated RSC entry\n * as a top-level `await` at module evaluation time (see `entries/app-rsc-entry.ts`\n * `generateRscEntry`). This means it runs inside the Worker process (or RSC\n * Vite environment) — the same process that handles requests — before any\n * request is served. `runInstrumentation()` is NOT called from `configureServer`\n * for App Router.\n *\n * The `onRequestError` handler is stored on `globalThis` so it is visible across\n * the RSC and SSR Vite environments (separate module graphs, same Node.js process).\n * With `@cloudflare/vite-plugin` it runs entirely inside the Worker, so\n * `globalThis` is the Worker's global — also correct.\n *\n * ## Pages Router\n *\n * Pages Router has no RSC entry, so `configureServer()` is the right place to\n * call `register()`. `runInstrumentation()` accepts a `ModuleRunner` (created\n * via `createDirectRunner()`) rather than `server.ssrLoadModule()` so it is\n * safe when `@cloudflare/vite-plugin` is present — that plugin replaces the\n * SSR environment's hot channel, causing `ssrLoadModule()` to crash with\n * `TypeError: Cannot read properties of undefined (reading 'outsideEmitter')`.\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { getRequestExecutionContext } from \"../shims/request-context.js\";\nimport { ValidFileMatcher } from \"../routing/file-matcher.js\";\n/**\n * Minimal duck-typed interface for the module runner passed to\n * `runInstrumentation`. Only `.import()` is used — this avoids requiring\n * callers (including tests) to provide a full `ModuleRunner` instance.\n */\nexport type ModuleImporter = {\n  import(id: string): Promise<unknown>;\n};\n\n/**\n * Import a module via the runner and cast the result to `Record<string, any>`.\n *\n * Centralises the `as Record<string, any>` cast so callers don't need\n * per-call oxlint-disable comments.\n */\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\nexport async function importModule(\n  runner: ModuleImporter,\n  id: string,\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n): Promise<Record<string, any>> {\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  return (await runner.import(id)) as Record<string, any>;\n}\n\nconst INSTRUMENTATION_LOCATIONS = [\"\", \"src/\"];\n\nfunction findInstrumentationHookFile(\n  root: string,\n  basename: string,\n  fileMatcher: ValidFileMatcher,\n): string | null {\n  for (const dir of INSTRUMENTATION_LOCATIONS) {\n    for (const ext of fileMatcher.dottedExtensions) {\n      const fullPath = path.join(root, dir, `${basename}${ext}`);\n      if (fs.existsSync(fullPath)) {\n        return fullPath;\n      }\n    }\n  }\n  return null;\n}\n\n/**\n * Find the instrumentation file in the project root.\n */\nexport function findInstrumentationFile(\n  root: string,\n  fileMatcher: ValidFileMatcher,\n): string | null {\n  return findInstrumentationHookFile(root, \"instrumentation\", fileMatcher);\n}\n\n/**\n * Find the instrumentation-client file in the project root.\n */\nexport function findInstrumentationClientFile(\n  root: string,\n  fileMatcher: ValidFileMatcher,\n): string | null {\n  return findInstrumentationHookFile(root, \"instrumentation-client\", fileMatcher);\n}\n\n/**\n * The onRequestError handler type from Next.js instrumentation.\n *\n * Called when an unhandled error occurs during request handling.\n * Provides the error, the request info, and an error context.\n */\nexport type OnRequestErrorContext = {\n  /** The route path (e.g., '/blog/[slug]') */\n  routerKind: \"Pages Router\" | \"App Router\";\n  /** The matched route pattern */\n  routePath: string;\n  /** The route type */\n  routeType: \"render\" | \"route\" | \"action\" | \"middleware\";\n  /** HTTP status code that will be sent */\n  revalidateReason?: \"on-demand\" | \"stale\" | undefined;\n};\n\nexport type OnRequestErrorHandler = (\n  error: Error,\n  request: { path: string; method: string; headers: Record<string, string> },\n  context: OnRequestErrorContext,\n) => void | Promise<void>;\n\n/**\n * Get the registered onRequestError handler (if any).\n *\n * Reads from globalThis so it works across Vite environment boundaries.\n */\nexport function getOnRequestErrorHandler(): OnRequestErrorHandler | null {\n  return globalThis.__VINEXT_onRequestErrorHandler__ ?? null;\n}\n\n/**\n * Load and execute the instrumentation file via a ModuleRunner.\n *\n * Called once during Pages Router server startup (`configureServer`). It:\n * 1. Loads the instrumentation module via `runner.import()`.\n * 2. Calls the `register()` function if exported.\n * 3. Stores the `onRequestError()` handler on `globalThis` so it is visible\n *    to all Vite environment module graphs (SSR and the host process share\n *    the same Node.js `globalThis`).\n *\n * **App Router** does not use this function. For App Router, `register()` is\n * emitted as a top-level `await` inside the generated RSC entry module so it\n * runs in the same Worker/environment as request handling.\n *\n * @param runner - A ModuleRunner created via `createDirectRunner()`. Must be\n *   the same long-lived runner used for middleware and SSR so the module graph\n *   is shared. Safe with all Vite plugin combinations, including\n *   `@cloudflare/vite-plugin`, because it never touches the hot channel.\n * @param instrumentationPath - Absolute path to the instrumentation file\n */\nexport async function runInstrumentation(\n  runner: ModuleImporter,\n  instrumentationPath: string,\n): Promise<void> {\n  try {\n    const mod = (await runner.import(instrumentationPath)) as Record<string, unknown>;\n\n    // Call register() if exported\n    if (typeof mod.register === \"function\") {\n      await mod.register();\n    }\n\n    // Store onRequestError handler on globalThis so environments can reach the\n    // same handler.\n    if (typeof mod.onRequestError === \"function\") {\n      globalThis.__VINEXT_onRequestErrorHandler__ = mod.onRequestError as OnRequestErrorHandler;\n    }\n  } catch (err) {\n    console.error(\n      \"[vinext] Failed to load instrumentation:\",\n      err instanceof Error ? err.message : String(err),\n    );\n  }\n}\n\n/**\n * Report a request error via the instrumentation handler.\n *\n * No-op if no onRequestError handler is registered.\n *\n * Reads the handler from globalThis so this function works correctly regardless\n * of which environment it is called from.\n */\nexport function reportRequestError(\n  error: Error,\n  request: { path: string; method: string; headers: Record<string, string> },\n  context: OnRequestErrorContext,\n): Promise<void> {\n  const handler = getOnRequestErrorHandler();\n  if (!handler) return Promise.resolve();\n\n  const promise = (async () => {\n    try {\n      await handler(error, request, context);\n    } catch (reportErr) {\n      console.error(\n        \"[vinext] onRequestError handler threw:\",\n        reportErr instanceof Error ? reportErr.message : String(reportErr),\n      );\n    }\n  })();\n\n  // On Cloudflare Workers, register with ctx.waitUntil() so the isolate\n  // stays alive until the report completes (e.g. Sentry HTTP request).\n  // On Node.js (dev or vinext start), getRequestExecutionContext() returns\n  // null — fire-and-forget is fine because the process doesn't die.\n  getRequestExecutionContext()?.waitUntil(promise);\n\n  return promise;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0DA,eAAsB,aACpB,QACA,IAE8B;AAE9B,QAAQ,MAAM,OAAO,OAAO,GAAG;;AAGjC,MAAM,4BAA4B,CAAC,IAAI,OAAO;AAE9C,SAAS,4BACP,MACA,UACA,aACe;AACf,MAAK,MAAM,OAAO,0BAChB,MAAK,MAAM,OAAO,YAAY,kBAAkB;EAC9C,MAAM,WAAW,KAAK,KAAK,MAAM,KAAK,GAAG,WAAW,MAAM;AAC1D,MAAI,GAAG,WAAW,SAAS,CACzB,QAAO;;AAIb,QAAO;;;;;AAMT,SAAgB,wBACd,MACA,aACe;AACf,QAAO,4BAA4B,MAAM,mBAAmB,YAAY;;;;;AAM1E,SAAgB,8BACd,MACA,aACe;AACf,QAAO,4BAA4B,MAAM,0BAA0B,YAAY;;;;;;;AA+BjF,SAAgB,2BAAyD;AACvE,QAAO,WAAW,oCAAoC;;;;;;;;;;;;;;;;;;;;;;AAuBxD,eAAsB,mBACpB,QACA,qBACe;AACf,KAAI;EACF,MAAM,MAAO,MAAM,OAAO,OAAO,oBAAoB;AAGrD,MAAI,OAAO,IAAI,aAAa,WAC1B,OAAM,IAAI,UAAU;AAKtB,MAAI,OAAO,IAAI,mBAAmB,WAChC,YAAW,mCAAmC,IAAI;UAE7C,KAAK;AACZ,UAAQ,MACN,4CACA,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,CACjD;;;;;;;;;;;AAYL,SAAgB,mBACd,OACA,SACA,SACe;CACf,MAAM,UAAU,0BAA0B;AAC1C,KAAI,CAAC,QAAS,QAAO,QAAQ,SAAS;CAEtC,MAAM,WAAW,YAAY;AAC3B,MAAI;AACF,SAAM,QAAQ,OAAO,SAAS,QAAQ;WAC/B,WAAW;AAClB,WAAQ,MACN,0CACA,qBAAqB,QAAQ,UAAU,UAAU,OAAO,UAAU,CACnE;;KAED;AAMJ,6BAA4B,EAAE,UAAU,QAAQ;AAEhD,QAAO"}
+{"version":3,"file":"instrumentation.js","names":[],"sources":["../../src/server/instrumentation.ts"],"sourcesContent":["/**\n * instrumentation.ts support\n *\n * Next.js supports an `instrumentation.ts` file at the project root that\n * exports a `register()` function. This function is called once when the\n * server starts, before any request handling. It's the recommended way to\n * set up observability tools (Sentry, Datadog, OpenTelemetry, etc.).\n *\n * Optionally, it can also export `onRequestError()` which is called when\n * an unhandled error occurs during request handling.\n *\n * References:\n * - https://nextjs.org/docs/app/building-your-application/optimizing/instrumentation\n *\n * ## App Router\n *\n * For App Router, `register()` is baked directly into the generated RSC entry\n * as a top-level `await` at module evaluation time (see `entries/app-rsc-entry.ts`\n * `generateRscEntry`). This means it runs inside the Worker process (or RSC\n * Vite environment) — the same process that handles requests — before any\n * request is served. `runInstrumentation()` is NOT called from `configureServer`\n * for App Router.\n *\n * The `onRequestError` handler is stored on `globalThis` so it is visible across\n * the RSC and SSR Vite environments (separate module graphs, same Node.js process).\n * With `@cloudflare/vite-plugin` it runs entirely inside the Worker, so\n * `globalThis` is the Worker's global — also correct.\n *\n * ## Pages Router\n *\n * Pages Router has no RSC entry, so `configureServer()` is the right place to\n * call `register()`. `runInstrumentation()` accepts a `ModuleRunner` (created\n * via `createDirectRunner()`) rather than `server.ssrLoadModule()` so it is\n * safe when `@cloudflare/vite-plugin` is present — that plugin replaces the\n * SSR environment's hot channel, causing `ssrLoadModule()` to crash with\n * `TypeError: Cannot read properties of undefined (reading 'outsideEmitter')`.\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { getRequestExecutionContext } from \"vinext/shims/request-context\";\nimport { ValidFileMatcher } from \"../routing/file-matcher.js\";\n/**\n * Minimal duck-typed interface for the module runner passed to\n * `runInstrumentation`. Only `.import()` is used — this avoids requiring\n * callers (including tests) to provide a full `ModuleRunner` instance.\n */\nexport type ModuleImporter = {\n  import(id: string): Promise<unknown>;\n};\n\n/**\n * Import a module via the runner and cast the result to `Record<string, any>`.\n *\n * Centralises the `as Record<string, any>` cast so callers don't need\n * per-call oxlint-disable comments.\n */\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\nexport async function importModule(\n  runner: ModuleImporter,\n  id: string,\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n): Promise<Record<string, any>> {\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  return (await runner.import(id)) as Record<string, any>;\n}\n\nconst INSTRUMENTATION_LOCATIONS = [\"\", \"src/\"];\n\nfunction findInstrumentationHookFile(\n  root: string,\n  basename: string,\n  fileMatcher: ValidFileMatcher,\n): string | null {\n  for (const dir of INSTRUMENTATION_LOCATIONS) {\n    for (const ext of fileMatcher.dottedExtensions) {\n      const fullPath = path.join(root, dir, `${basename}${ext}`);\n      if (fs.existsSync(fullPath)) {\n        return fullPath;\n      }\n    }\n  }\n  return null;\n}\n\n/**\n * Find the instrumentation file in the project root.\n */\nexport function findInstrumentationFile(\n  root: string,\n  fileMatcher: ValidFileMatcher,\n): string | null {\n  return findInstrumentationHookFile(root, \"instrumentation\", fileMatcher);\n}\n\n/**\n * Find the instrumentation-client file in the project root.\n */\nexport function findInstrumentationClientFile(\n  root: string,\n  fileMatcher: ValidFileMatcher,\n): string | null {\n  return findInstrumentationHookFile(root, \"instrumentation-client\", fileMatcher);\n}\n\n/**\n * The onRequestError handler type from Next.js instrumentation.\n *\n * Called when an unhandled error occurs during request handling.\n * Provides the error, the request info, and an error context.\n */\nexport type OnRequestErrorContext = {\n  /** The route path (e.g., '/blog/[slug]') */\n  routerKind: \"Pages Router\" | \"App Router\";\n  /** The matched route pattern */\n  routePath: string;\n  /** The route type */\n  routeType: \"render\" | \"route\" | \"action\" | \"middleware\";\n  /** HTTP status code that will be sent */\n  revalidateReason?: \"on-demand\" | \"stale\" | undefined;\n};\n\nexport type OnRequestErrorHandler = (\n  error: Error,\n  request: { path: string; method: string; headers: Record<string, string> },\n  context: OnRequestErrorContext,\n) => void | Promise<void>;\n\n/**\n * Get the registered onRequestError handler (if any).\n *\n * Reads from globalThis so it works across Vite environment boundaries.\n */\nexport function getOnRequestErrorHandler(): OnRequestErrorHandler | null {\n  return globalThis.__VINEXT_onRequestErrorHandler__ ?? null;\n}\n\n/**\n * Load and execute the instrumentation file via a ModuleRunner.\n *\n * Called once during Pages Router server startup (`configureServer`). It:\n * 1. Loads the instrumentation module via `runner.import()`.\n * 2. Calls the `register()` function if exported.\n * 3. Stores the `onRequestError()` handler on `globalThis` so it is visible\n *    to all Vite environment module graphs (SSR and the host process share\n *    the same Node.js `globalThis`).\n *\n * **App Router** does not use this function. For App Router, `register()` is\n * emitted as a top-level `await` inside the generated RSC entry module so it\n * runs in the same Worker/environment as request handling.\n *\n * @param runner - A ModuleRunner created via `createDirectRunner()`. Must be\n *   the same long-lived runner used for middleware and SSR so the module graph\n *   is shared. Safe with all Vite plugin combinations, including\n *   `@cloudflare/vite-plugin`, because it never touches the hot channel.\n * @param instrumentationPath - Absolute path to the instrumentation file\n */\nexport async function runInstrumentation(\n  runner: ModuleImporter,\n  instrumentationPath: string,\n): Promise<void> {\n  try {\n    const mod = (await runner.import(instrumentationPath)) as Record<string, unknown>;\n\n    // Call register() if exported\n    if (typeof mod.register === \"function\") {\n      await mod.register();\n    }\n\n    // Store onRequestError handler on globalThis so environments can reach the\n    // same handler.\n    if (typeof mod.onRequestError === \"function\") {\n      globalThis.__VINEXT_onRequestErrorHandler__ = mod.onRequestError as OnRequestErrorHandler;\n    }\n  } catch (err) {\n    console.error(\n      \"[vinext] Failed to load instrumentation:\",\n      err instanceof Error ? err.message : String(err),\n    );\n  }\n}\n\n/**\n * Report a request error via the instrumentation handler.\n *\n * No-op if no onRequestError handler is registered.\n *\n * Reads the handler from globalThis so this function works correctly regardless\n * of which environment it is called from.\n */\nexport function reportRequestError(\n  error: Error,\n  request: { path: string; method: string; headers: Record<string, string> },\n  context: OnRequestErrorContext,\n): Promise<void> {\n  const handler = getOnRequestErrorHandler();\n  if (!handler) return Promise.resolve();\n\n  const promise = (async () => {\n    try {\n      await handler(error, request, context);\n    } catch (reportErr) {\n      console.error(\n        \"[vinext] onRequestError handler threw:\",\n        reportErr instanceof Error ? reportErr.message : String(reportErr),\n      );\n    }\n  })();\n\n  // On Cloudflare Workers, register with ctx.waitUntil() so the isolate\n  // stays alive until the report completes (e.g. Sentry HTTP request).\n  // On Node.js (dev or vinext start), getRequestExecutionContext() returns\n  // null — fire-and-forget is fine because the process doesn't die.\n  getRequestExecutionContext()?.waitUntil(promise);\n\n  return promise;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0DA,eAAsB,aACpB,QACA,IAE8B;AAE9B,QAAQ,MAAM,OAAO,OAAO,GAAG;;AAGjC,MAAM,4BAA4B,CAAC,IAAI,OAAO;AAE9C,SAAS,4BACP,MACA,UACA,aACe;AACf,MAAK,MAAM,OAAO,0BAChB,MAAK,MAAM,OAAO,YAAY,kBAAkB;EAC9C,MAAM,WAAW,KAAK,KAAK,MAAM,KAAK,GAAG,WAAW,MAAM;AAC1D,MAAI,GAAG,WAAW,SAAS,CACzB,QAAO;;AAIb,QAAO;;;;;AAMT,SAAgB,wBACd,MACA,aACe;AACf,QAAO,4BAA4B,MAAM,mBAAmB,YAAY;;;;;AAM1E,SAAgB,8BACd,MACA,aACe;AACf,QAAO,4BAA4B,MAAM,0BAA0B,YAAY;;;;;;;AA+BjF,SAAgB,2BAAyD;AACvE,QAAO,WAAW,oCAAoC;;;;;;;;;;;;;;;;;;;;;;AAuBxD,eAAsB,mBACpB,QACA,qBACe;AACf,KAAI;EACF,MAAM,MAAO,MAAM,OAAO,OAAO,oBAAoB;AAGrD,MAAI,OAAO,IAAI,aAAa,WAC1B,OAAM,IAAI,UAAU;AAKtB,MAAI,OAAO,IAAI,mBAAmB,WAChC,YAAW,mCAAmC,IAAI;UAE7C,KAAK;AACZ,UAAQ,MACN,4CACA,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,CACjD;;;;;;;;;;;AAYL,SAAgB,mBACd,OACA,SACA,SACe;CACf,MAAM,UAAU,0BAA0B;AAC1C,KAAI,CAAC,QAAS,QAAO,QAAQ,SAAS;CAEtC,MAAM,WAAW,YAAY;AAC3B,MAAI;AACF,SAAM,QAAQ,OAAO,SAAS,QAAQ;WAC/B,WAAW;AAClB,WAAQ,MACN,0CACA,qBAAqB,QAAQ,UAAU,UAAU,OAAO,UAAU,CACnE;;KAED;AAMJ,6BAA4B,EAAE,UAAU,QAAQ;AAEhD,QAAO"}

package/dist/server/isr-cache.d.ts

@@ -1,4 +1,5 @@
 import { CacheHandlerValue, CachedAppPageValue, CachedPagesValue, IncrementalCacheValue } from "../shims/cache.js";
+import { OnRequestErrorContext } from "./instrumentation.js";
 
 //#region src/server/isr-cache.d.ts
 type ISRCacheEntry = {
@@ -26,8 +27,16 @@ declare function isrSet(key: string, data: IncrementalCacheValue, revalidateSeco
  * On Cloudflare Workers the regeneration promise is registered with
  * `ctx.waitUntil()` via the ALS-backed ExecutionContext, keeping the isolate
  * alive until the regeneration completes even after the Response is returned.
+ *
+ * When `errorContext` is provided and the render function fails, the error
+ * is reported via `reportRequestError` (instrumentation hook) with
+ * `revalidateReason: "stale"`.
  */
-declare function triggerBackgroundRegeneration(key: string, renderFn: () => Promise<void>): void;
+declare function triggerBackgroundRegeneration(key: string, renderFn: () => Promise<void>, errorContext?: {
+  routerKind: OnRequestErrorContext["routerKind"];
+  routePath: string;
+  routeType: OnRequestErrorContext["routeType"];
+}): void;
 /**
  * Build a CachedPagesValue for the Pages Router ISR cache.
  */
@@ -41,6 +50,15 @@ declare function buildAppPageCacheValue(html: string, rscData?: ArrayBuffer, sta
  * Long pathnames are hashed to stay within KV key-length limits (512 bytes).
  */
 declare function isrCacheKey(router: "pages" | "app", pathname: string, buildId?: string): string;
+/**
+ * Normalize the App Router mounted-slot header before it participates in cache
+ * keys. The client can send mounted slot ids in different orders as navigation
+ * state changes, but equivalent slot sets must map to the same RSC cache entry.
+ */
+declare function normalizeMountedSlotsHeader(raw: string | null | undefined): string | null;
+declare function appIsrHtmlKey(pathname: string): string;
+declare function appIsrRscKey(pathname: string, mountedSlotsHeader?: string | null): string;
+declare function appIsrRouteKey(pathname: string): string;
 /**
  * Store the revalidate duration for a cache key.
  * Uses insertion-order LRU eviction to prevent unbounded growth.
@@ -51,5 +69,5 @@ declare function setRevalidateDuration(key: string, seconds: number): void;
  */
 declare function getRevalidateDuration(key: string): number | undefined;
 //#endregion
-export { ISRCacheEntry, buildAppPageCacheValue, buildPagesCacheValue, getRevalidateDuration, isrCacheKey, isrGet, isrSet, setRevalidateDuration, triggerBackgroundRegeneration };
+export { ISRCacheEntry, appIsrHtmlKey, appIsrRouteKey, appIsrRscKey, buildAppPageCacheValue, buildPagesCacheValue, getRevalidateDuration, isrCacheKey, isrGet, isrSet, normalizeMountedSlotsHeader, setRevalidateDuration, triggerBackgroundRegeneration };
 //# sourceMappingURL=isr-cache.d.ts.map