@timber-js/app 0.1.24 → 0.1.26

package/dist/client/use-router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-router.d.ts","sourceRoot":"","sources":["../../src/client/use-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACzD,6DAA6D;IAC7D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5D,sDAAsD;IACtD,OAAO,IAAI,IAAI,CAAC;IAChB,+BAA+B;IAC/B,IAAI,IAAI,IAAI,CAAC;IACb,kCAAkC;IAClC,OAAO,IAAI,IAAI,CAAC;IAChB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,IAAI,iBAAiB,CAuD7C"}
+{"version":3,"file":"use-router.d.ts","sourceRoot":"","sources":["../../src/client/use-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACzD,6DAA6D;IAC7D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5D,sDAAsD;IACtD,OAAO,IAAI,IAAI,CAAC;IAChB,+BAA+B;IAC/B,IAAI,IAAI,IAAI,CAAC;IACb,kCAAkC;IAClC,OAAO,IAAI,IAAI,CAAC;IAChB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,IAAI,iBAAiB,CA4C7C"}

package/dist/server/index.js

@@ -662,6 +662,110 @@ function hasOnRequestError() {
 	return _onRequestError !== null;
 }
 //#endregion
+//#region src/server/pipeline-metadata.ts
+/**
+* Metadata route helpers for the request pipeline.
+*
+* Handles serving static metadata files and serializing sitemap responses.
+* Extracted from pipeline.ts to keep files under 500 lines.
+*
+* See design/16-metadata.md §"Metadata Routes"
+*/
+/**
+* Content types that are text-based and should include charset=utf-8.
+* Binary formats (images) should not include charset.
+*/
+var TEXT_CONTENT_TYPES = new Set([
+	"application/xml",
+	"text/plain",
+	"application/json",
+	"application/manifest+json",
+	"image/svg+xml"
+]);
+/**
+* Serve a static metadata file by reading it from disk.
+*
+* Static metadata route files (.xml, .txt, .json, .png, .ico, .svg, etc.)
+* are served as-is with the appropriate Content-Type header.
+* Text files include charset=utf-8; binary files do not.
+*
+* See design/16-metadata.md §"Metadata Routes"
+*/
+async function serveStaticMetadataFile(metaMatch) {
+	const { contentType, file } = metaMatch;
+	const isText = TEXT_CONTENT_TYPES.has(contentType);
+	const body = await readFile(file.filePath);
+	const headers = {
+		"Content-Type": isText ? `${contentType}; charset=utf-8` : contentType,
+		"Content-Length": String(body.byteLength)
+	};
+	return new Response(body, {
+		status: 200,
+		headers
+	});
+}
+/**
+* Serialize a sitemap array to XML.
+* Follows the sitemap.org protocol: https://www.sitemaps.org/protocol.html
+*/
+function serializeSitemap(entries) {
+	return `<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n${entries.map((e) => {
+		let xml = `  <url>\n    <loc>${escapeXml(e.url)}</loc>`;
+		if (e.lastModified) {
+			const date = e.lastModified instanceof Date ? e.lastModified.toISOString() : e.lastModified;
+			xml += `\n    <lastmod>${escapeXml(date)}</lastmod>`;
+		}
+		if (e.changeFrequency) xml += `\n    <changefreq>${escapeXml(e.changeFrequency)}</changefreq>`;
+		if (e.priority !== void 0) xml += `\n    <priority>${e.priority}</priority>`;
+		xml += "\n  </url>";
+		return xml;
+	}).join("\n")}\n</urlset>`;
+}
+/** Escape special XML characters. */
+function escapeXml(str) {
+	return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+//#endregion
+//#region src/server/pipeline-interception.ts
+/**
+* Check if an intercepting route applies for this soft navigation.
+*
+* Matches the target pathname against interception rewrites, constrained
+* by the source URL (X-Timber-URL header — where the user navigates FROM).
+*
+* Returns the source pathname to re-match if interception applies, or null.
+*/
+function findInterceptionMatch(targetPathname, sourceUrl, rewrites) {
+	for (const rewrite of rewrites) {
+		if (!sourceUrl.startsWith(rewrite.interceptingPrefix)) continue;
+		if (pathnameMatchesPattern(targetPathname, rewrite.interceptedPattern)) return { sourcePathname: rewrite.interceptingPrefix };
+	}
+	return null;
+}
+/**
+* Check if a pathname matches a URL pattern with dynamic segments.
+*
+* Supports [param] (single segment) and [...param] (one or more segments).
+* Static segments must match exactly.
+*/
+function pathnameMatchesPattern(pathname, pattern) {
+	const pathParts = pathname === "/" ? [] : pathname.slice(1).split("/");
+	const patternParts = pattern === "/" ? [] : pattern.slice(1).split("/");
+	let pi = 0;
+	for (let i = 0; i < patternParts.length; i++) {
+		const segment = patternParts[i];
+		if (segment.startsWith("[...") || segment.startsWith("[[...")) return pi < pathParts.length || segment.startsWith("[[...");
+		if (segment.startsWith("[") && segment.endsWith("]")) {
+			if (pi >= pathParts.length) return false;
+			pi++;
+			continue;
+		}
+		if (pi >= pathParts.length || pathParts[pi] !== segment) return false;
+		pi++;
+	}
+	return pi === pathParts.length;
+}
+//#endregion
 //#region src/server/pipeline.ts
 /**
 * Request pipeline — the central dispatch for all timber.js requests.
@@ -909,44 +1013,6 @@ async function fireOnRequestError(error, req, phase) {
 	});
 }
 /**
-* Check if an intercepting route applies for this soft navigation.
-*
-* Matches the target pathname against interception rewrites, constrained
-* by the source URL (X-Timber-URL header — where the user navigates FROM).
-*
-* Returns the source pathname to re-match if interception applies, or null.
-*/
-function findInterceptionMatch(targetPathname, sourceUrl, rewrites) {
-	for (const rewrite of rewrites) {
-		if (!sourceUrl.startsWith(rewrite.interceptingPrefix)) continue;
-		if (pathnameMatchesPattern(targetPathname, rewrite.interceptedPattern)) return { sourcePathname: rewrite.interceptingPrefix };
-	}
-	return null;
-}
-/**
-* Check if a pathname matches a URL pattern with dynamic segments.
-*
-* Supports [param] (single segment) and [...param] (one or more segments).
-* Static segments must match exactly.
-*/
-function pathnameMatchesPattern(pathname, pattern) {
-	const pathParts = pathname === "/" ? [] : pathname.slice(1).split("/");
-	const patternParts = pattern === "/" ? [] : pattern.slice(1).split("/");
-	let pi = 0;
-	for (let i = 0; i < patternParts.length; i++) {
-		const segment = patternParts[i];
-		if (segment.startsWith("[...") || segment.startsWith("[[...")) return pi < pathParts.length || segment.startsWith("[[...");
-		if (segment.startsWith("[") && segment.endsWith("]")) {
-			if (pi >= pathParts.length) return false;
-			pi++;
-			continue;
-		}
-		if (pi >= pathParts.length || pathParts[pi] !== segment) return false;
-		pi++;
-	}
-	return pi === pathParts.length;
-}
-/**
 * Apply all Set-Cookie headers from the cookie jar to a Headers object.
 * Each cookie gets its own Set-Cookie header per RFC 6265 §4.1.
 */
@@ -976,60 +1042,6 @@ function ensureMutableResponse(response) {
 		});
 	}
 }
-/**
-* Serialize a sitemap array to XML.
-* Follows the sitemap.org protocol: https://www.sitemaps.org/protocol.html
-*/
-function serializeSitemap(entries) {
-	return `<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n${entries.map((e) => {
-		let xml = `  <url>\n    <loc>${escapeXml(e.url)}</loc>`;
-		if (e.lastModified) {
-			const date = e.lastModified instanceof Date ? e.lastModified.toISOString() : e.lastModified;
-			xml += `\n    <lastmod>${escapeXml(date)}</lastmod>`;
-		}
-		if (e.changeFrequency) xml += `\n    <changefreq>${escapeXml(e.changeFrequency)}</changefreq>`;
-		if (e.priority !== void 0) xml += `\n    <priority>${e.priority}</priority>`;
-		xml += "\n  </url>";
-		return xml;
-	}).join("\n")}\n</urlset>`;
-}
-/** Escape special XML characters. */
-function escapeXml(str) {
-	return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
-}
-/**
-* Content types that are text-based and should include charset=utf-8.
-* Binary formats (images) should not include charset.
-*/
-var TEXT_CONTENT_TYPES = new Set([
-	"application/xml",
-	"text/plain",
-	"application/json",
-	"application/manifest+json",
-	"image/svg+xml"
-]);
-/**
-* Serve a static metadata file by reading it from disk.
-*
-* Static metadata route files (.xml, .txt, .json, .png, .ico, .svg, etc.)
-* are served as-is with the appropriate Content-Type header.
-* Text files include charset=utf-8; binary files do not.
-*
-* See design/16-metadata.md §"Metadata Routes"
-*/
-async function serveStaticMetadataFile(metaMatch) {
-	const { contentType, file } = metaMatch;
-	const isText = TEXT_CONTENT_TYPES.has(contentType);
-	const body = await readFile(file.filePath);
-	const headers = {
-		"Content-Type": isText ? `${contentType}; charset=utf-8` : contentType,
-		"Content-Length": String(body.byteLength)
-	};
-	return new Response(body, {
-		status: 200,
-		headers
-	});
-}
 //#endregion
 //#region src/server/build-manifest.ts
 /**
@@ -1831,135 +1843,13 @@ function resolveLimit(kind, config) {
 	return userLimits?.uploadBodySize ? parseBodySize(userLimits.uploadBodySize) : DEFAULT_LIMITS.uploadBodySize;
 }
 //#endregion
-//#region src/server/metadata-render.ts
+//#region src/server/metadata-social.ts
 /**
-* Convert resolved metadata into an array of head element descriptors.
-*
-* Each descriptor has a `tag` ('title', 'meta', 'link') and either
-* `content` (for <title>) or `attrs` (for <meta>/<link>).
+* Render Open Graph metadata into head element descriptors.
 *
-* The framework's MetadataResolver component consumes these descriptors
-* and renders them into the <head>.
+* Handles og:title, og:description, og:image (with dimensions/alt),
+* og:video, og:audio, og:article:author, and other OG properties.
 */
-function renderMetadataToElements(metadata) {
-	const elements = [];
-	if (typeof metadata.title === "string") elements.push({
-		tag: "title",
-		content: metadata.title
-	});
-	const simpleMetaProps = [
-		["description", metadata.description],
-		["generator", metadata.generator],
-		["application-name", metadata.applicationName],
-		["referrer", metadata.referrer],
-		["category", metadata.category],
-		["creator", metadata.creator],
-		["publisher", metadata.publisher]
-	];
-	for (const [name, content] of simpleMetaProps) if (content) elements.push({
-		tag: "meta",
-		attrs: {
-			name,
-			content
-		}
-	});
-	if (metadata.keywords) {
-		const content = Array.isArray(metadata.keywords) ? metadata.keywords.join(", ") : metadata.keywords;
-		elements.push({
-			tag: "meta",
-			attrs: {
-				name: "keywords",
-				content
-			}
-		});
-	}
-	if (metadata.robots) {
-		const content = typeof metadata.robots === "string" ? metadata.robots : renderRobotsObject(metadata.robots);
-		elements.push({
-			tag: "meta",
-			attrs: {
-				name: "robots",
-				content
-			}
-		});
-		if (typeof metadata.robots === "object" && metadata.robots.googleBot) {
-			const gbContent = typeof metadata.robots.googleBot === "string" ? metadata.robots.googleBot : renderRobotsObject(metadata.robots.googleBot);
-			elements.push({
-				tag: "meta",
-				attrs: {
-					name: "googlebot",
-					content: gbContent
-				}
-			});
-		}
-	}
-	if (metadata.openGraph) renderOpenGraph(metadata.openGraph, elements);
-	if (metadata.twitter) renderTwitter(metadata.twitter, elements);
-	if (metadata.icons) renderIcons(metadata.icons, elements);
-	if (metadata.manifest) elements.push({
-		tag: "link",
-		attrs: {
-			rel: "manifest",
-			href: metadata.manifest
-		}
-	});
-	if (metadata.alternates) renderAlternates(metadata.alternates, elements);
-	if (metadata.verification) renderVerification(metadata.verification, elements);
-	if (metadata.formatDetection) {
-		const parts = [];
-		if (metadata.formatDetection.telephone === false) parts.push("telephone=no");
-		if (metadata.formatDetection.email === false) parts.push("email=no");
-		if (metadata.formatDetection.address === false) parts.push("address=no");
-		if (parts.length > 0) elements.push({
-			tag: "meta",
-			attrs: {
-				name: "format-detection",
-				content: parts.join(", ")
-			}
-		});
-	}
-	if (metadata.authors) {
-		const authorList = Array.isArray(metadata.authors) ? metadata.authors : [metadata.authors];
-		for (const author of authorList) {
-			if (author.name) elements.push({
-				tag: "meta",
-				attrs: {
-					name: "author",
-					content: author.name
-				}
-			});
-			if (author.url) elements.push({
-				tag: "link",
-				attrs: {
-					rel: "author",
-					href: author.url
-				}
-			});
-		}
-	}
-	if (metadata.appleWebApp) renderAppleWebApp(metadata.appleWebApp, elements);
-	if (metadata.appLinks) renderAppLinks(metadata.appLinks, elements);
-	if (metadata.itunes) renderItunes(metadata.itunes, elements);
-	if (metadata.other) for (const [name, value] of Object.entries(metadata.other)) {
-		const content = Array.isArray(value) ? value.join(", ") : value;
-		elements.push({
-			tag: "meta",
-			attrs: {
-				name,
-				content
-			}
-		});
-	}
-	return elements;
-}
-function renderRobotsObject(robots) {
-	const parts = [];
-	if (robots.index === true) parts.push("index");
-	if (robots.index === false) parts.push("noindex");
-	if (robots.follow === true) parts.push("follow");
-	if (robots.follow === false) parts.push("nofollow");
-	return parts.join(", ");
-}
 function renderOpenGraph(og, elements) {
 	const simpleProps = [
 		["og:title", og.title],
@@ -2040,6 +1930,12 @@ function renderOpenGraph(og, elements) {
 		}
 	});
 }
+/**
+* Render Twitter Card metadata into head element descriptors.
+*
+* Handles twitter:card, twitter:site, twitter:title, twitter:image,
+* twitter:player, and twitter:app (per-platform name/id/url).
+*/
 function renderTwitter(tw, elements) {
 	const simpleProps = [
 		["twitter:card", tw.card],
@@ -2144,6 +2040,11 @@ function renderTwitter(tw, elements) {
 		}
 	}
 }
+//#endregion
+//#region src/server/metadata-platform.ts
+/**
+* Render icon link elements (favicon, shortcut, apple-touch-icon, custom).
+*/
 function renderIcons(icons, elements) {
 	if (icons.icon) {
 		if (typeof icons.icon === "string") elements.push({
@@ -2209,6 +2110,9 @@ function renderIcons(icons, elements) {
 		});
 	}
 }
+/**
+* Render alternate link elements (canonical, hreflang, media, types).
+*/
 function renderAlternates(alternates, elements) {
 	if (alternates.canonical) elements.push({
 		tag: "link",
@@ -2242,6 +2146,9 @@ function renderAlternates(alternates, elements) {
 		}
 	});
 }
+/**
+* Render site verification meta tags (Google, Yahoo, Yandex, custom).
+*/
 function renderVerification(verification, elements) {
 	const verificationProps = [
 		["google-site-verification", verification.google],
@@ -2266,6 +2173,9 @@ function renderVerification(verification, elements) {
 		});
 	}
 }
+/**
+* Render Apple Web App meta tags and startup image links.
+*/
 function renderAppleWebApp(appleWebApp, elements) {
 	if (appleWebApp.capable) elements.push({
 		tag: "meta",
@@ -2303,6 +2213,9 @@ function renderAppleWebApp(appleWebApp, elements) {
 		}
 	}
 }
+/**
+* Render App Links (al:*) meta tags for deep linking across platforms.
+*/
 function renderAppLinks(appLinks, elements) {
 	const platformEntries = [
 		["ios", appLinks.ios],
@@ -2338,6 +2251,9 @@ function renderAppLinks(appLinks, elements) {
 		});
 	}
 }
+/**
+* Render Apple iTunes smart banner meta tag.
+*/
 function renderItunes(itunes, elements) {
 	const parts = [`app-id=${itunes.appId}`];
 	if (itunes.affiliateData) parts.push(`affiliate-data=${itunes.affiliateData}`);
@@ -2351,6 +2267,136 @@ function renderItunes(itunes, elements) {
 	});
 }
 //#endregion
+//#region src/server/metadata-render.ts
+/**
+* Convert resolved metadata into an array of head element descriptors.
+*
+* Each descriptor has a `tag` ('title', 'meta', 'link') and either
+* `content` (for <title>) or `attrs` (for <meta>/<link>).
+*
+* The framework's MetadataResolver component consumes these descriptors
+* and renders them into the <head>.
+*/
+function renderMetadataToElements(metadata) {
+	const elements = [];
+	if (typeof metadata.title === "string") elements.push({
+		tag: "title",
+		content: metadata.title
+	});
+	const simpleMetaProps = [
+		["description", metadata.description],
+		["generator", metadata.generator],
+		["application-name", metadata.applicationName],
+		["referrer", metadata.referrer],
+		["category", metadata.category],
+		["creator", metadata.creator],
+		["publisher", metadata.publisher]
+	];
+	for (const [name, content] of simpleMetaProps) if (content) elements.push({
+		tag: "meta",
+		attrs: {
+			name,
+			content
+		}
+	});
+	if (metadata.keywords) {
+		const content = Array.isArray(metadata.keywords) ? metadata.keywords.join(", ") : metadata.keywords;
+		elements.push({
+			tag: "meta",
+			attrs: {
+				name: "keywords",
+				content
+			}
+		});
+	}
+	if (metadata.robots) {
+		const content = typeof metadata.robots === "string" ? metadata.robots : renderRobotsObject(metadata.robots);
+		elements.push({
+			tag: "meta",
+			attrs: {
+				name: "robots",
+				content
+			}
+		});
+		if (typeof metadata.robots === "object" && metadata.robots.googleBot) {
+			const gbContent = typeof metadata.robots.googleBot === "string" ? metadata.robots.googleBot : renderRobotsObject(metadata.robots.googleBot);
+			elements.push({
+				tag: "meta",
+				attrs: {
+					name: "googlebot",
+					content: gbContent
+				}
+			});
+		}
+	}
+	if (metadata.openGraph) renderOpenGraph(metadata.openGraph, elements);
+	if (metadata.twitter) renderTwitter(metadata.twitter, elements);
+	if (metadata.icons) renderIcons(metadata.icons, elements);
+	if (metadata.manifest) elements.push({
+		tag: "link",
+		attrs: {
+			rel: "manifest",
+			href: metadata.manifest
+		}
+	});
+	if (metadata.alternates) renderAlternates(metadata.alternates, elements);
+	if (metadata.verification) renderVerification(metadata.verification, elements);
+	if (metadata.formatDetection) {
+		const parts = [];
+		if (metadata.formatDetection.telephone === false) parts.push("telephone=no");
+		if (metadata.formatDetection.email === false) parts.push("email=no");
+		if (metadata.formatDetection.address === false) parts.push("address=no");
+		if (parts.length > 0) elements.push({
+			tag: "meta",
+			attrs: {
+				name: "format-detection",
+				content: parts.join(", ")
+			}
+		});
+	}
+	if (metadata.authors) {
+		const authorList = Array.isArray(metadata.authors) ? metadata.authors : [metadata.authors];
+		for (const author of authorList) {
+			if (author.name) elements.push({
+				tag: "meta",
+				attrs: {
+					name: "author",
+					content: author.name
+				}
+			});
+			if (author.url) elements.push({
+				tag: "link",
+				attrs: {
+					rel: "author",
+					href: author.url
+				}
+			});
+		}
+	}
+	if (metadata.appleWebApp) renderAppleWebApp(metadata.appleWebApp, elements);
+	if (metadata.appLinks) renderAppLinks(metadata.appLinks, elements);
+	if (metadata.itunes) renderItunes(metadata.itunes, elements);
+	if (metadata.other) for (const [name, value] of Object.entries(metadata.other)) {
+		const content = Array.isArray(value) ? value.join(", ") : value;
+		elements.push({
+			tag: "meta",
+			attrs: {
+				name,
+				content
+			}
+		});
+	}
+	return elements;
+}
+function renderRobotsObject(robots) {
+	const parts = [];
+	if (robots.index === true) parts.push("index");
+	if (robots.index === false) parts.push("noindex");
+	if (robots.follow === true) parts.push("follow");
+	if (robots.follow === false) parts.push("nofollow");
+	return parts.join(", ");
+}
+//#endregion
 //#region src/server/metadata.ts
 /**
 * Resolve a title value with an optional template.