@asterxsk/kiln 0.1.0 → 0.3.0

package/agent/extensions/pi-web-access/declared-web-links.ts

@@ -1,173 +1,173 @@
-const MAX_DECLARED_LINKS = 20;
-const MAX_DECLARED_URL_LENGTH = 4096;
-const DECLARATION_RELATIONS = new Set([
-	"api-catalog",
-	"describedby",
-	"service-desc",
-	"service-doc",
-	"service-meta",
-]);
-
-const RELATION_LABELS: Record<string, string> = {
-	"api-catalog": "API catalog",
-	"describedby": "Description",
-	"service-desc": "Service description",
-	"service-doc": "Service documentation",
-	"service-meta": "Service metadata",
-};
-
-export interface DeclaredWebLink {
-	url: string;
-	relations: string[];
-	type?: string;
-}
-
-export function discoverDeclaredWebLinks(
-	document: Document,
-	linkHeader: string | null,
-	responseUrl: string,
-): DeclaredWebLink[] {
-	const links = new Map<string, DeclaredWebLink>();
-	for (const value of splitLinkHeader(linkHeader ?? "")) {
-		const target = /^\s*<([^>]*)>/.exec(value);
-		if (!target) continue;
-		const parameters = parseLinkParameters(value.slice(target[0].length));
-		if (!parameters || parameters.has("anchor")) continue;
-		addDeclaredLink(links, {
-			url: resolveHttpUrl(target[1], responseUrl),
-			relations: declaredRelations(parameters.get("rel")),
-			type: parameters.get("type"),
-		});
-		if (links.size >= MAX_DECLARED_LINKS) break;
-	}
-
-	if (links.size < MAX_DECLARED_LINKS) {
-		const declaredBase = document.querySelector("base[href]")?.getAttribute("href");
-		const documentBase = resolveHttpUrl(declaredBase, responseUrl) ?? responseUrl;
-		for (const element of document.querySelectorAll("link[rel][href], a[rel][href]")) {
-			addDeclaredLink(links, {
-				url: resolveHttpUrl(element.getAttribute("href"), documentBase),
-				relations: declaredRelations(element.getAttribute("rel")),
-				type: element.getAttribute("type"),
-			});
-			if (links.size >= MAX_DECLARED_LINKS) break;
-		}
-	}
-
-	return [...links.values()];
-}
-
-export function appendDeclaredWebLinks(content: string, links: DeclaredWebLink[]): string {
-	if (links.length === 0) return content;
-	const section = [
-		"## Declared links",
-		"",
-		...links.map(formatDeclaredLink),
-	].join("\n");
-	return content.trim() ? `${content.trim()}\n\n${section}` : section;
-}
-
-function addDeclaredLink(
-	links: Map<string, DeclaredWebLink>,
-	candidate: { url: string | null; relations: string[]; type?: string | null },
-): void {
-	if (!candidate.url || candidate.relations.length === 0) return;
-	const existing = links.get(candidate.url);
-	if (existing) {
-		for (const relation of candidate.relations) {
-			if (!existing.relations.includes(relation)) existing.relations.push(relation);
-		}
-		if (!existing.type) existing.type = normalizeMetadata(candidate.type);
-		return;
-	}
-	if (links.size >= MAX_DECLARED_LINKS) return;
-	const type = normalizeMetadata(candidate.type);
-	links.set(candidate.url, {
-		url: candidate.url,
-		relations: candidate.relations,
-		...(type ? { type } : {}),
-	});
-}
-
-function declaredRelations(value: string | null | undefined): string[] {
-	if (!value) return [];
-	return [...new Set(
-		value.trim().toLowerCase().split(/\s+/).filter((relation) => DECLARATION_RELATIONS.has(relation)),
-	)];
-}
-
-function resolveHttpUrl(value: string | null | undefined, baseUrl: string): string | null {
-	if (!value || value.length > MAX_DECLARED_URL_LENGTH) return null;
-	try {
-		const url = new URL(value, baseUrl);
-		if (url.href.length > MAX_DECLARED_URL_LENGTH) return null;
-		return url.protocol === "http:" || url.protocol === "https:" ? url.href : null;
-	} catch {
-		return null;
-	}
-}
-
-function splitOutsideSyntax(input: string, separator: string, protectTargets: boolean): string[] | null {
-	const parts: string[] = [];
-	let start = 0;
-	let inTarget = false;
-	let inQuotes = false;
-	let escaped = false;
-	for (let index = 0; index < input.length; index++) {
-		const character = input[index];
-		if (inQuotes) {
-			if (escaped) escaped = false;
-			else if (character === "\\") escaped = true;
-			else if (character === '"') inQuotes = false;
-			continue;
-		}
-		if (character === '"' && !inTarget) inQuotes = true;
-		else if (protectTargets && character === "<") inTarget = true;
-		else if (protectTargets && character === ">") inTarget = false;
-		else if (character === separator && !inTarget) {
-			parts.push(input.slice(start, index));
-			start = index + 1;
-		}
-	}
-	if (inQuotes || inTarget) return null;
-	parts.push(input.slice(start));
-	return parts;
-}
-
-function splitLinkHeader(header: string): string[] {
-	return (splitOutsideSyntax(header, ",", true) ?? [])
-		.map((value) => value.trim())
-		.filter(Boolean);
-}
-
-function parseLinkParameters(input: string): Map<string, string> | null {
-	const parts = splitOutsideSyntax(input, ";", false);
-	if (!parts || parts.shift()?.trim()) return null;
-
-	const parameters = new Map<string, string>();
-	for (const part of parts) {
-		const match = /^\s*([!#$%&'*+\-.^_`|~A-Za-z0-9]+)(?:\s*=\s*(?:"((?:\\.|[^"])*)"|(\S+)))?\s*$/.exec(part);
-		if (!match) return null;
-		const name = match[1].toLowerCase();
-		const value = match[2] === undefined ? (match[3] ?? "") : match[2].replace(/\\(.)/g, "$1");
-		if (!parameters.has(name)) parameters.set(name, value);
-	}
-	return parameters;
-}
-
-function normalizeMetadata(value: string | null | undefined): string | undefined {
-	if (!value) return undefined;
-	const normalized = value.replace(/\s+/g, " ").trim().slice(0, 160);
-	return normalized || undefined;
-}
-
-function formatDeclaredLink(link: DeclaredWebLink): string {
-	const relation = link.relations.map(inlineCode).join(", ");
-	const type = link.type ? `; ${inlineCode(link.type)}` : "";
-	const label = RELATION_LABELS[link.relations[0]] ?? "Declared link";
-	return `- ${label} (${relation}${type}): <${link.url}>`;
-}
-
-function inlineCode(value: string): string {
-	return `\`${value.replace(/`/g, "'")}\``;
-}
+const MAX_DECLARED_LINKS = 20;
+const MAX_DECLARED_URL_LENGTH = 4096;
+const DECLARATION_RELATIONS = new Set([
+	"api-catalog",
+	"describedby",
+	"service-desc",
+	"service-doc",
+	"service-meta",
+]);
+
+const RELATION_LABELS: Record<string, string> = {
+	"api-catalog": "API catalog",
+	"describedby": "Description",
+	"service-desc": "Service description",
+	"service-doc": "Service documentation",
+	"service-meta": "Service metadata",
+};
+
+export interface DeclaredWebLink {
+	url: string;
+	relations: string[];
+	type?: string;
+}
+
+export function discoverDeclaredWebLinks(
+	document: Document,
+	linkHeader: string | null,
+	responseUrl: string,
+): DeclaredWebLink[] {
+	const links = new Map<string, DeclaredWebLink>();
+	for (const value of splitLinkHeader(linkHeader ?? "")) {
+		const target = /^\s*<([^>]*)>/.exec(value);
+		if (!target) continue;
+		const parameters = parseLinkParameters(value.slice(target[0].length));
+		if (!parameters || parameters.has("anchor")) continue;
+		addDeclaredLink(links, {
+			url: resolveHttpUrl(target[1], responseUrl),
+			relations: declaredRelations(parameters.get("rel")),
+			type: parameters.get("type"),
+		});
+		if (links.size >= MAX_DECLARED_LINKS) break;
+	}
+
+	if (links.size < MAX_DECLARED_LINKS) {
+		const declaredBase = document.querySelector("base[href]")?.getAttribute("href");
+		const documentBase = resolveHttpUrl(declaredBase, responseUrl) ?? responseUrl;
+		for (const element of document.querySelectorAll("link[rel][href], a[rel][href]")) {
+			addDeclaredLink(links, {
+				url: resolveHttpUrl(element.getAttribute("href"), documentBase),
+				relations: declaredRelations(element.getAttribute("rel")),
+				type: element.getAttribute("type"),
+			});
+			if (links.size >= MAX_DECLARED_LINKS) break;
+		}
+	}
+
+	return [...links.values()];
+}
+
+export function appendDeclaredWebLinks(content: string, links: DeclaredWebLink[]): string {
+	if (links.length === 0) return content;
+	const section = [
+		"## Declared links",
+		"",
+		...links.map(formatDeclaredLink),
+	].join("\n");
+	return content.trim() ? `${content.trim()}\n\n${section}` : section;
+}
+
+function addDeclaredLink(
+	links: Map<string, DeclaredWebLink>,
+	candidate: { url: string | null; relations: string[]; type?: string | null },
+): void {
+	if (!candidate.url || candidate.relations.length === 0) return;
+	const existing = links.get(candidate.url);
+	if (existing) {
+		for (const relation of candidate.relations) {
+			if (!existing.relations.includes(relation)) existing.relations.push(relation);
+		}
+		if (!existing.type) existing.type = normalizeMetadata(candidate.type);
+		return;
+	}
+	if (links.size >= MAX_DECLARED_LINKS) return;
+	const type = normalizeMetadata(candidate.type);
+	links.set(candidate.url, {
+		url: candidate.url,
+		relations: candidate.relations,
+		...(type ? { type } : {}),
+	});
+}
+
+function declaredRelations(value: string | null | undefined): string[] {
+	if (!value) return [];
+	return [...new Set(
+		value.trim().toLowerCase().split(/\s+/).filter((relation) => DECLARATION_RELATIONS.has(relation)),
+	)];
+}
+
+function resolveHttpUrl(value: string | null | undefined, baseUrl: string): string | null {
+	if (!value || value.length > MAX_DECLARED_URL_LENGTH) return null;
+	try {
+		const url = new URL(value, baseUrl);
+		if (url.href.length > MAX_DECLARED_URL_LENGTH) return null;
+		return url.protocol === "http:" || url.protocol === "https:" ? url.href : null;
+	} catch {
+		return null;
+	}
+}
+
+function splitOutsideSyntax(input: string, separator: string, protectTargets: boolean): string[] | null {
+	const parts: string[] = [];
+	let start = 0;
+	let inTarget = false;
+	let inQuotes = false;
+	let escaped = false;
+	for (let index = 0; index < input.length; index++) {
+		const character = input[index];
+		if (inQuotes) {
+			if (escaped) escaped = false;
+			else if (character === "\\") escaped = true;
+			else if (character === '"') inQuotes = false;
+			continue;
+		}
+		if (character === '"' && !inTarget) inQuotes = true;
+		else if (protectTargets && character === "<") inTarget = true;
+		else if (protectTargets && character === ">") inTarget = false;
+		else if (character === separator && !inTarget) {
+			parts.push(input.slice(start, index));
+			start = index + 1;
+		}
+	}
+	if (inQuotes || inTarget) return null;
+	parts.push(input.slice(start));
+	return parts;
+}
+
+function splitLinkHeader(header: string): string[] {
+	return (splitOutsideSyntax(header, ",", true) ?? [])
+		.map((value) => value.trim())
+		.filter(Boolean);
+}
+
+function parseLinkParameters(input: string): Map<string, string> | null {
+	const parts = splitOutsideSyntax(input, ";", false);
+	if (!parts || parts.shift()?.trim()) return null;
+
+	const parameters = new Map<string, string>();
+	for (const part of parts) {
+		const match = /^\s*([!#$%&'*+\-.^_`|~A-Za-z0-9]+)(?:\s*=\s*(?:"((?:\\.|[^"])*)"|(\S+)))?\s*$/.exec(part);
+		if (!match) return null;
+		const name = match[1].toLowerCase();
+		const value = match[2] === undefined ? (match[3] ?? "") : match[2].replace(/\\(.)/g, "$1");
+		if (!parameters.has(name)) parameters.set(name, value);
+	}
+	return parameters;
+}
+
+function normalizeMetadata(value: string | null | undefined): string | undefined {
+	if (!value) return undefined;
+	const normalized = value.replace(/\s+/g, " ").trim().slice(0, 160);
+	return normalized || undefined;
+}
+
+function formatDeclaredLink(link: DeclaredWebLink): string {
+	const relation = link.relations.map(inlineCode).join(", ");
+	const type = link.type ? `; ${inlineCode(link.type)}` : "";
+	const label = RELATION_LABELS[link.relations[0]] ?? "Declared link";
+	return `- ${label} (${relation}${type}): <${link.url}>`;
+}
+
+function inlineCode(value: string): string {
+	return `\`${value.replace(/`/g, "'")}\``;
+}