@puzzle-ui/seo 0.0.0-stage → 0.5.0

package/dist/server/routes.d.ts

@@ -0,0 +1,2 @@
+import { SeoRouteHandlers, SeoRouteOptions } from "./types.js";
+export declare const createSeoRouteHandlers: (options: SeoRouteOptions) => SeoRouteHandlers;

package/dist/server/routes.js

@@ -0,0 +1,17 @@
+import { createRobotsHandler, createSitemapHandler } from "./handlers.js";
+// src/server/routes.ts
+const toResponse = (result) => new Response(result.body, {
+	status: result.status,
+	headers: result.headers
+});
+const createSeoRouteHandlers = (options) => {
+	const sitemapHandler = createSitemapHandler(options.sitemap);
+	const robotsHandler = createRobotsHandler(options.robots);
+	return {
+		sitemap: async (request) => toResponse(await sitemapHandler(request)),
+		robots: async (request) => toResponse(await robotsHandler(request))
+	};
+};
+export { createSeoRouteHandlers };
+
+//# sourceMappingURL=routes.js.map

package/dist/server/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","names":[],"sources":["../../src/server/routes.ts"],"sourcesContent":["import { createRobotsHandler, createSitemapHandler } from \"./handlers\";\n\nimport type {\n  SeoRouteHandlers,\n  SeoRouteOptions,\n  SeoTextResponse,\n} from \"./types\";\n\nconst toResponse = (result: SeoTextResponse): Response =>\n  new Response(result.body, {\n    status: result.status,\n    headers: result.headers,\n  });\n\nexport const createSeoRouteHandlers = (\n  options: SeoRouteOptions,\n): SeoRouteHandlers => {\n  const sitemapHandler = createSitemapHandler(options.sitemap);\n  const robotsHandler = createRobotsHandler(options.robots);\n\n  return {\n    sitemap: async (request) => toResponse(await sitemapHandler(request)),\n\n    robots: async (request) => toResponse(await robotsHandler(request)),\n  };\n};\n"],"mappings":";;AAQA,MAAM,cAAc,WAClB,IAAI,SAAS,OAAO,MAAM;CACxB,QAAQ,OAAO;CACf,SAAS,OAAO;AAClB,CAAC;AAEH,MAAa,0BACX,YACqB;CACrB,MAAM,iBAAiB,qBAAqB,QAAQ,OAAO;CAC3D,MAAM,gBAAgB,oBAAoB,QAAQ,MAAM;CAExD,OAAO;EACL,SAAS,OAAO,YAAY,WAAW,MAAM,eAAe,OAAO,CAAC;EAEpE,QAAQ,OAAO,YAAY,WAAW,MAAM,cAAc,OAAO,CAAC;CACpE;AACF"}

package/dist/server/types.d.cts

@@ -0,0 +1,61 @@
+import { SeoConfig } from "../context/types.cjs";
+import { SeoGraph } from "../core/types.cjs";
+import { SeoPageMetadata } from "../metadata/types.cjs";
+import { RobotsOptions } from "../robots/types.cjs";
+import { SitemapGenerationOptions } from "../sitemap/types.cjs";
+export interface SeoRequestContext {
+  requestId?: string;
+  url: string;
+  locale?: string;
+  config: SeoConfig;
+}
+export interface SeoServerResult {
+  metadata?: SeoPageMetadata;
+  graph?: SeoGraph;
+}
+export interface SeoServerAdapter {
+  resolve(context: SeoRequestContext): Promise<SeoServerResult>;
+}
+export interface SeoTextResponse {
+  status: number;
+  headers: Record<string, string>;
+  body: string;
+}
+export interface SeoTextHandlerOptions {
+  contentType: string;
+  cacheControl?: string;
+  headers?: Record<string, string>;
+  status?: number;
+}
+export interface SeoTextHandler {
+  (request?: Request): SeoTextResponse | Promise<SeoTextResponse>;
+}
+export interface SeoSitemapHandlerOptions {
+  sitemap: SitemapGenerationOptions;
+  cacheControl?: string;
+  /**
+   * Public URL of the sitemap index.
+   *
+   * Defaults to /{filename}.xml, where filename defaults to "sitemap".
+   */
+  path?: string;
+}
+export interface SeoRobotsHandlerOptions {
+  robots: RobotsOptions;
+  cacheControl?: string;
+  /**
+   * Public URL of robots.txt.
+   *
+   * Defaults to /robots.txt.
+   */
+  path?: string;
+}
+export interface SeoRouteOptions {
+  sitemap: SeoSitemapHandlerOptions;
+  robots: SeoRobotsHandlerOptions;
+}
+export type SeoHttpHandler = (request: Request) => Promise<Response>;
+export interface SeoRouteHandlers {
+  sitemap: SeoHttpHandler;
+  robots: SeoHttpHandler;
+}

package/dist/server/types.d.ts

@@ -0,0 +1,61 @@
+import { SeoConfig } from "../context/types.js";
+import { SeoGraph } from "../core/types.js";
+import { SeoPageMetadata } from "../metadata/types.js";
+import { RobotsOptions } from "../robots/types.js";
+import { SitemapGenerationOptions } from "../sitemap/types.js";
+export interface SeoRequestContext {
+  requestId?: string;
+  url: string;
+  locale?: string;
+  config: SeoConfig;
+}
+export interface SeoServerResult {
+  metadata?: SeoPageMetadata;
+  graph?: SeoGraph;
+}
+export interface SeoServerAdapter {
+  resolve(context: SeoRequestContext): Promise<SeoServerResult>;
+}
+export interface SeoTextResponse {
+  status: number;
+  headers: Record<string, string>;
+  body: string;
+}
+export interface SeoTextHandlerOptions {
+  contentType: string;
+  cacheControl?: string;
+  headers?: Record<string, string>;
+  status?: number;
+}
+export interface SeoTextHandler {
+  (request?: Request): SeoTextResponse | Promise<SeoTextResponse>;
+}
+export interface SeoSitemapHandlerOptions {
+  sitemap: SitemapGenerationOptions;
+  cacheControl?: string;
+  /**
+   * Public URL of the sitemap index.
+   *
+   * Defaults to /{filename}.xml, where filename defaults to "sitemap".
+   */
+  path?: string;
+}
+export interface SeoRobotsHandlerOptions {
+  robots: RobotsOptions;
+  cacheControl?: string;
+  /**
+   * Public URL of robots.txt.
+   *
+   * Defaults to /robots.txt.
+   */
+  path?: string;
+}
+export interface SeoRouteOptions {
+  sitemap: SeoSitemapHandlerOptions;
+  robots: SeoRobotsHandlerOptions;
+}
+export type SeoHttpHandler = (request: Request) => Promise<Response>;
+export interface SeoRouteHandlers {
+  sitemap: SeoHttpHandler;
+  robots: SeoHttpHandler;
+}

package/dist/sitemap/generate.cjs

@@ -0,0 +1,147 @@
+const require_normalize = require("../urls/normalize.cjs");
+const require_xml = require("./xml.cjs");
+// src/sitemap/generate.ts
+const DEFAULT_MAX_ENTRIES = 5e4;
+const DEFAULT_MAX_BYTES = 52428800;
+const normalizeEntries = (entries, baseUrl, allowExternalUrls) => {
+	const unique = /* @__PURE__ */ new Map();
+	for (const entry of entries) {
+		if (entry.indexable === false || entry.statusCode !== void 0 && entry.statusCode !== 200 || entry.redirectTo) continue;
+		try {
+			const url = require_normalize.normalizeSeoUrl(entry.url, {
+				baseUrl,
+				allowExternal: allowExternalUrls
+			});
+			if (unique.has(url)) continue;
+			const alternates = (entry.alternates ?? []).flatMap((alternate) => {
+				try {
+					return [{
+						...alternate,
+						url: require_normalize.normalizeSeoUrl(alternate.url, {
+							baseUrl,
+							allowExternal: allowExternalUrls
+						})
+					}];
+				} catch {
+					return [];
+				}
+			});
+			const images = (entry.images ?? []).flatMap((image) => {
+				try {
+					return [{
+						...image,
+						url: require_normalize.normalizeSeoUrl(image.url, {
+							baseUrl,
+							allowExternal: true
+						})
+					}];
+				} catch {
+					return [];
+				}
+			});
+			unique.set(url, {
+				...entry,
+				url,
+				alternates,
+				images
+			});
+		} catch {}
+	}
+	return [...unique.values()].sort((a, b) => String(a.url).localeCompare(String(b.url)));
+};
+const serializeSitemap = (options) => {
+	const baseUrl = require_normalize.normalizeSeoOrigin(options.baseUrl);
+	const issues = require_xml.validateSitemapEntries(options.entries, {
+		baseUrl,
+		allowExternalUrls: options.allowExternalUrls
+	});
+	const entries = normalizeEntries(options.entries, baseUrl, options.allowExternalUrls ?? false);
+	return {
+		xml: require_xml.createSitemapXml(entries, {
+			baseUrl,
+			includeLastModified: options.includeLastModified,
+			allowExternalUrls: options.allowExternalUrls
+		}),
+		entries,
+		issues
+	};
+};
+const createSitemapIndexXml = (files) => {
+	return [
+		"<?xml version=\"1.0\" encoding=\"UTF-8\"?>",
+		"<sitemapindex xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">",
+		files.map((file) => `<sitemap><loc>${require_xml.escapeXml(file.url)}</loc></sitemap>`).join(""),
+		"</sitemapindex>"
+	].join("");
+};
+const generateSitemap = (options) => {
+	const baseUrl = require_normalize.normalizeSeoOrigin(options.baseUrl);
+	const maxEntries = options.maxEntries ?? DEFAULT_MAX_ENTRIES;
+	const maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;
+	if (!Number.isInteger(maxEntries) || maxEntries < 1 || maxEntries > DEFAULT_MAX_ENTRIES) throw new Error("Sitemap maxEntries must be between 1 and 50,000.");
+	if (!Number.isInteger(maxBytes) || maxBytes < 1024 || maxBytes > DEFAULT_MAX_BYTES) throw new Error("Sitemap maxBytes must be between 1 KB and 50 MB.");
+	const issues = require_xml.validateSitemapEntries(options.entries, {
+		baseUrl,
+		allowExternalUrls: options.allowExternalUrls,
+		validateAlternates: options.validateAlternates
+	});
+	const entries = normalizeEntries(options.entries, baseUrl, options.allowExternalUrls ?? false);
+	const files = [];
+	let current = [];
+	const createXml = (items) => require_xml.createSitemapXml(items, {
+		baseUrl,
+		includeLastModified: options.includeLastModified,
+		allowExternalUrls: options.allowExternalUrls
+	});
+	const emptyDocumentBytes = require_xml.sitemapByteLength(createXml([]));
+	let currentBytes = emptyDocumentBytes;
+	const flush = () => {
+		if (current.length === 0) return;
+		const number = files.length + 1;
+		const filename = `${options.filename ?? "sitemap"}-${number}.xml`;
+		const url = require_normalize.normalizeSeoUrl(`/${filename}`, {
+			baseUrl,
+			allowExternal: false
+		});
+		files.push({
+			filename,
+			url,
+			xml: createXml(current),
+			entries: current
+		});
+		current = [];
+		currentBytes = emptyDocumentBytes;
+	};
+	for (const entry of entries) {
+		const singleXml = createXml([entry]);
+		const singleBytes = require_xml.sitemapByteLength(singleXml);
+		if (singleBytes > maxBytes) {
+			issues.push({
+				code: "ENTRY_TOO_LARGE",
+				message: `Sitemap entry exceeds the configured byte limit: ${entry.url}.`,
+				url: String(entry.url)
+			});
+			continue;
+		}
+		const entryBytes = singleBytes - emptyDocumentBytes;
+		const exceedsCount = current.length + 1 > maxEntries;
+		const exceedsBytes = currentBytes + entryBytes > maxBytes;
+		if (current.length > 0 && (exceedsCount || exceedsBytes)) flush();
+		current.push(entry);
+		currentBytes += entryBytes;
+	}
+	flush();
+	if (files.length > DEFAULT_MAX_ENTRIES) throw new Error("Sitemap index exceeds the maximum of 50,000 sitemap references.");
+	const indexXml = files.length > 1 ? createSitemapIndexXml(files) : void 0;
+	return {
+		files,
+		indexXml,
+		indexUrl: indexXml ? require_normalize.normalizeSeoUrl(`/${options.filename ?? "sitemap"}.xml`, { baseUrl }) : void 0,
+		totalEntries: files.reduce((total, file) => total + file.entries.length, 0),
+		issues
+	};
+};
+exports.generateSitemap = generateSitemap;
+exports.serializeSitemap = serializeSitemap;
+
+//# sourceMappingURL=generate.cjs.map

package/dist/sitemap/generate.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.cjs","names":["normalizeSeoUrl","normalizeSeoOrigin","validateSitemapEntries","createSitemapXml","escapeXml","sitemapByteLength"],"sources":["../../src/sitemap/generate.ts"],"sourcesContent":["import type {\n  SitemapEntry,\n  SitemapOptions,\n  SitemapGenerationOptions,\n  SitemapResult,\n  SitemapCollection,\n  SitemapFile,\n} from \"./types\";\n\nimport { normalizeSeoUrl, normalizeSeoOrigin } from \"../urls\";\n\nimport {\n  createSitemapXml,\n  escapeXml,\n  sitemapByteLength,\n  validateSitemapEntries,\n} from \"./xml\";\n\nconst DEFAULT_MAX_ENTRIES = 50_000;\nconst DEFAULT_MAX_BYTES = 50 * 1024 * 1024;\n\nconst normalizeEntries = (\n  entries: readonly SitemapEntry[],\n  baseUrl: string,\n  allowExternalUrls: boolean,\n): SitemapEntry[] => {\n  const unique = new Map<string, SitemapEntry>();\n\n  for (const entry of entries) {\n    if (\n      entry.indexable === false ||\n      (entry.statusCode !== undefined && entry.statusCode !== 200) ||\n      entry.redirectTo\n    ) {\n      continue;\n    }\n\n    try {\n      const url = normalizeSeoUrl(entry.url, {\n        baseUrl,\n        allowExternal: allowExternalUrls,\n      });\n\n      if (unique.has(url)) {\n        continue;\n      }\n\n      const alternates = (entry.alternates ?? []).flatMap((alternate) => {\n        try {\n          return [\n            {\n              ...alternate,\n              url: normalizeSeoUrl(alternate.url, {\n                baseUrl,\n                allowExternal: allowExternalUrls,\n              }),\n            },\n          ];\n        } catch {\n          return [];\n        }\n      });\n\n      const images = (entry.images ?? []).flatMap((image) => {\n        try {\n          return [\n            {\n              ...image,\n              url: normalizeSeoUrl(image.url, {\n                baseUrl,\n                allowExternal: true,\n              }),\n            },\n          ];\n        } catch {\n          return [];\n        }\n      });\n\n      unique.set(url, {\n        ...entry,\n        url,\n        alternates,\n        images,\n      });\n    } catch {\n      // Invalid URLs are reported by validateSitemapEntries.\n    }\n  }\n\n  return [...unique.values()].sort((a, b) =>\n    String(a.url).localeCompare(String(b.url)),\n  );\n};\n\nexport const serializeSitemap = (options: SitemapOptions): SitemapResult => {\n  const baseUrl = normalizeSeoOrigin(options.baseUrl);\n\n  const issues = validateSitemapEntries(options.entries, {\n    baseUrl,\n    allowExternalUrls: options.allowExternalUrls,\n  });\n\n  const entries = normalizeEntries(\n    options.entries,\n    baseUrl,\n    options.allowExternalUrls ?? false,\n  );\n\n  return {\n    xml: createSitemapXml(entries, {\n      baseUrl,\n      includeLastModified: options.includeLastModified,\n      allowExternalUrls: options.allowExternalUrls,\n    }),\n    entries,\n    issues,\n  };\n};\n\nconst createSitemapIndexXml = (files: readonly SitemapFile[]): string => {\n  const content = files\n    .map((file) => `<sitemap><loc>${escapeXml(file.url)}</loc></sitemap>`)\n    .join(\"\");\n\n  return [\n    '<?xml version=\"1.0\" encoding=\"UTF-8\"?>',\n    '<sitemapindex xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">',\n    content,\n    \"</sitemapindex>\",\n  ].join(\"\");\n};\n\nexport const generateSitemap = (\n  options: SitemapGenerationOptions,\n): SitemapCollection => {\n  const baseUrl = normalizeSeoOrigin(options.baseUrl);\n\n  const maxEntries = options.maxEntries ?? DEFAULT_MAX_ENTRIES;\n  const maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;\n\n  if (\n    !Number.isInteger(maxEntries) ||\n    maxEntries < 1 ||\n    maxEntries > DEFAULT_MAX_ENTRIES\n  ) {\n    throw new Error(\"Sitemap maxEntries must be between 1 and 50,000.\");\n  }\n\n  if (\n    !Number.isInteger(maxBytes) ||\n    maxBytes < 1024 ||\n    maxBytes > DEFAULT_MAX_BYTES\n  ) {\n    throw new Error(\"Sitemap maxBytes must be between 1 KB and 50 MB.\");\n  }\n\n  const issues = validateSitemapEntries(options.entries, {\n    baseUrl,\n    allowExternalUrls: options.allowExternalUrls,\n    validateAlternates: options.validateAlternates,\n  });\n\n  const entries = normalizeEntries(\n    options.entries,\n    baseUrl,\n    options.allowExternalUrls ?? false,\n  );\n\n  const files: SitemapFile[] = [];\n\n  let current: SitemapEntry[] = [];\n\n  const createXml = (items: readonly SitemapEntry[]) =>\n    createSitemapXml(items, {\n      baseUrl,\n      includeLastModified: options.includeLastModified,\n      allowExternalUrls: options.allowExternalUrls,\n    });\n\n  // The empty document represents the fixed XML header and footer.\n  const emptyDocumentBytes = sitemapByteLength(createXml([]));\n\n  let currentBytes = emptyDocumentBytes;\n\n  const flush = () => {\n    if (current.length === 0) {\n      return;\n    }\n\n    const number = files.length + 1;\n\n    const filename = `${options.filename ?? \"sitemap\"}-${number}.xml`;\n\n    const url = normalizeSeoUrl(`/${filename}`, {\n      baseUrl,\n      allowExternal: false,\n    });\n\n    files.push({\n      filename,\n      url,\n      xml: createXml(current),\n      entries: current,\n    });\n\n    current = [];\n    currentBytes = emptyDocumentBytes;\n  };\n\n  for (const entry of entries) {\n    const singleXml = createXml([entry]);\n    const singleBytes = sitemapByteLength(singleXml);\n\n    if (singleBytes > maxBytes) {\n      issues.push({\n        code: \"ENTRY_TOO_LARGE\",\n        message: `Sitemap entry exceeds the configured byte limit: ${entry.url}.`,\n        url: String(entry.url),\n      });\n\n      continue;\n    }\n\n    // This includes the entry fragment and its namespace overhead.\n    // Counting namespace overhead per entry is intentionally conservative.\n    const entryBytes = singleBytes - emptyDocumentBytes;\n\n    const exceedsCount = current.length + 1 > maxEntries;\n    const exceedsBytes = currentBytes + entryBytes > maxBytes;\n\n    if (current.length > 0 && (exceedsCount || exceedsBytes)) {\n      flush();\n    }\n\n    current.push(entry);\n    currentBytes += entryBytes;\n  }\n\n  flush();\n\n  if (files.length > DEFAULT_MAX_ENTRIES) {\n    throw new Error(\n      \"Sitemap index exceeds the maximum of 50,000 sitemap references.\",\n    );\n  }\n\n  const indexXml = files.length > 1 ? createSitemapIndexXml(files) : undefined;\n\n  const indexUrl = indexXml\n    ? normalizeSeoUrl(`/${options.filename ?? \"sitemap\"}.xml`, { baseUrl })\n    : undefined;\n\n  return {\n    files,\n    indexXml,\n    indexUrl,\n    totalEntries: files.reduce((total, file) => total + file.entries.length, 0),\n    issues,\n  };\n};\n"],"mappings":"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"}

package/dist/sitemap/generate.d.cts

@@ -0,0 +1,3 @@
+import { SitemapCollection, SitemapGenerationOptions, SitemapOptions, SitemapResult } from "./types.cjs";
+export declare const serializeSitemap: (options: SitemapOptions) => SitemapResult;
+export declare const generateSitemap: (options: SitemapGenerationOptions) => SitemapCollection;

package/dist/sitemap/generate.d.ts

@@ -0,0 +1,3 @@
+import { SitemapCollection, SitemapGenerationOptions, SitemapOptions, SitemapResult } from "./types.js";
+export declare const serializeSitemap: (options: SitemapOptions) => SitemapResult;
+export declare const generateSitemap: (options: SitemapGenerationOptions) => SitemapCollection;

package/dist/sitemap/generate.js

@@ -0,0 +1,146 @@
+import { normalizeSeoOrigin, normalizeSeoUrl } from "../urls/normalize.js";
+import { createSitemapXml, escapeXml, sitemapByteLength, validateSitemapEntries } from "./xml.js";
+// src/sitemap/generate.ts
+const DEFAULT_MAX_ENTRIES = 5e4;
+const DEFAULT_MAX_BYTES = 52428800;
+const normalizeEntries = (entries, baseUrl, allowExternalUrls) => {
+	const unique = /* @__PURE__ */ new Map();
+	for (const entry of entries) {
+		if (entry.indexable === false || entry.statusCode !== void 0 && entry.statusCode !== 200 || entry.redirectTo) continue;
+		try {
+			const url = normalizeSeoUrl(entry.url, {
+				baseUrl,
+				allowExternal: allowExternalUrls
+			});
+			if (unique.has(url)) continue;
+			const alternates = (entry.alternates ?? []).flatMap((alternate) => {
+				try {
+					return [{
+						...alternate,
+						url: normalizeSeoUrl(alternate.url, {
+							baseUrl,
+							allowExternal: allowExternalUrls
+						})
+					}];
+				} catch {
+					return [];
+				}
+			});
+			const images = (entry.images ?? []).flatMap((image) => {
+				try {
+					return [{
+						...image,
+						url: normalizeSeoUrl(image.url, {
+							baseUrl,
+							allowExternal: true
+						})
+					}];
+				} catch {
+					return [];
+				}
+			});
+			unique.set(url, {
+				...entry,
+				url,
+				alternates,
+				images
+			});
+		} catch {}
+	}
+	return [...unique.values()].sort((a, b) => String(a.url).localeCompare(String(b.url)));
+};
+const serializeSitemap = (options) => {
+	const baseUrl = normalizeSeoOrigin(options.baseUrl);
+	const issues = validateSitemapEntries(options.entries, {
+		baseUrl,
+		allowExternalUrls: options.allowExternalUrls
+	});
+	const entries = normalizeEntries(options.entries, baseUrl, options.allowExternalUrls ?? false);
+	return {
+		xml: createSitemapXml(entries, {
+			baseUrl,
+			includeLastModified: options.includeLastModified,
+			allowExternalUrls: options.allowExternalUrls
+		}),
+		entries,
+		issues
+	};
+};
+const createSitemapIndexXml = (files) => {
+	return [
+		"<?xml version=\"1.0\" encoding=\"UTF-8\"?>",
+		"<sitemapindex xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">",
+		files.map((file) => `<sitemap><loc>${escapeXml(file.url)}</loc></sitemap>`).join(""),
+		"</sitemapindex>"
+	].join("");
+};
+const generateSitemap = (options) => {
+	const baseUrl = normalizeSeoOrigin(options.baseUrl);
+	const maxEntries = options.maxEntries ?? DEFAULT_MAX_ENTRIES;
+	const maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;
+	if (!Number.isInteger(maxEntries) || maxEntries < 1 || maxEntries > DEFAULT_MAX_ENTRIES) throw new Error("Sitemap maxEntries must be between 1 and 50,000.");
+	if (!Number.isInteger(maxBytes) || maxBytes < 1024 || maxBytes > DEFAULT_MAX_BYTES) throw new Error("Sitemap maxBytes must be between 1 KB and 50 MB.");
+	const issues = validateSitemapEntries(options.entries, {
+		baseUrl,
+		allowExternalUrls: options.allowExternalUrls,
+		validateAlternates: options.validateAlternates
+	});
+	const entries = normalizeEntries(options.entries, baseUrl, options.allowExternalUrls ?? false);
+	const files = [];
+	let current = [];
+	const createXml = (items) => createSitemapXml(items, {
+		baseUrl,
+		includeLastModified: options.includeLastModified,
+		allowExternalUrls: options.allowExternalUrls
+	});
+	const emptyDocumentBytes = sitemapByteLength(createXml([]));
+	let currentBytes = emptyDocumentBytes;
+	const flush = () => {
+		if (current.length === 0) return;
+		const number = files.length + 1;
+		const filename = `${options.filename ?? "sitemap"}-${number}.xml`;
+		const url = normalizeSeoUrl(`/${filename}`, {
+			baseUrl,
+			allowExternal: false
+		});
+		files.push({
+			filename,
+			url,
+			xml: createXml(current),
+			entries: current
+		});
+		current = [];
+		currentBytes = emptyDocumentBytes;
+	};
+	for (const entry of entries) {
+		const singleXml = createXml([entry]);
+		const singleBytes = sitemapByteLength(singleXml);
+		if (singleBytes > maxBytes) {
+			issues.push({
+				code: "ENTRY_TOO_LARGE",
+				message: `Sitemap entry exceeds the configured byte limit: ${entry.url}.`,
+				url: String(entry.url)
+			});
+			continue;
+		}
+		const entryBytes = singleBytes - emptyDocumentBytes;
+		const exceedsCount = current.length + 1 > maxEntries;
+		const exceedsBytes = currentBytes + entryBytes > maxBytes;
+		if (current.length > 0 && (exceedsCount || exceedsBytes)) flush();
+		current.push(entry);
+		currentBytes += entryBytes;
+	}
+	flush();
+	if (files.length > DEFAULT_MAX_ENTRIES) throw new Error("Sitemap index exceeds the maximum of 50,000 sitemap references.");
+	const indexXml = files.length > 1 ? createSitemapIndexXml(files) : void 0;
+	return {
+		files,
+		indexXml,
+		indexUrl: indexXml ? normalizeSeoUrl(`/${options.filename ?? "sitemap"}.xml`, { baseUrl }) : void 0,
+		totalEntries: files.reduce((total, file) => total + file.entries.length, 0),
+		issues
+	};
+};
+export { generateSitemap, serializeSitemap };
+
+//# sourceMappingURL=generate.js.map

package/dist/sitemap/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","names":[],"sources":["../../src/sitemap/generate.ts"],"sourcesContent":["import type {\n  SitemapEntry,\n  SitemapOptions,\n  SitemapGenerationOptions,\n  SitemapResult,\n  SitemapCollection,\n  SitemapFile,\n} from \"./types\";\n\nimport { normalizeSeoUrl, normalizeSeoOrigin } from \"../urls\";\n\nimport {\n  createSitemapXml,\n  escapeXml,\n  sitemapByteLength,\n  validateSitemapEntries,\n} from \"./xml\";\n\nconst DEFAULT_MAX_ENTRIES = 50_000;\nconst DEFAULT_MAX_BYTES = 50 * 1024 * 1024;\n\nconst normalizeEntries = (\n  entries: readonly SitemapEntry[],\n  baseUrl: string,\n  allowExternalUrls: boolean,\n): SitemapEntry[] => {\n  const unique = new Map<string, SitemapEntry>();\n\n  for (const entry of entries) {\n    if (\n      entry.indexable === false ||\n      (entry.statusCode !== undefined && entry.statusCode !== 200) ||\n      entry.redirectTo\n    ) {\n      continue;\n    }\n\n    try {\n      const url = normalizeSeoUrl(entry.url, {\n        baseUrl,\n        allowExternal: allowExternalUrls,\n      });\n\n      if (unique.has(url)) {\n        continue;\n      }\n\n      const alternates = (entry.alternates ?? []).flatMap((alternate) => {\n        try {\n          return [\n            {\n              ...alternate,\n              url: normalizeSeoUrl(alternate.url, {\n                baseUrl,\n                allowExternal: allowExternalUrls,\n              }),\n            },\n          ];\n        } catch {\n          return [];\n        }\n      });\n\n      const images = (entry.images ?? []).flatMap((image) => {\n        try {\n          return [\n            {\n              ...image,\n              url: normalizeSeoUrl(image.url, {\n                baseUrl,\n                allowExternal: true,\n              }),\n            },\n          ];\n        } catch {\n          return [];\n        }\n      });\n\n      unique.set(url, {\n        ...entry,\n        url,\n        alternates,\n        images,\n      });\n    } catch {\n      // Invalid URLs are reported by validateSitemapEntries.\n    }\n  }\n\n  return [...unique.values()].sort((a, b) =>\n    String(a.url).localeCompare(String(b.url)),\n  );\n};\n\nexport const serializeSitemap = (options: SitemapOptions): SitemapResult => {\n  const baseUrl = normalizeSeoOrigin(options.baseUrl);\n\n  const issues = validateSitemapEntries(options.entries, {\n    baseUrl,\n    allowExternalUrls: options.allowExternalUrls,\n  });\n\n  const entries = normalizeEntries(\n    options.entries,\n    baseUrl,\n    options.allowExternalUrls ?? false,\n  );\n\n  return {\n    xml: createSitemapXml(entries, {\n      baseUrl,\n      includeLastModified: options.includeLastModified,\n      allowExternalUrls: options.allowExternalUrls,\n    }),\n    entries,\n    issues,\n  };\n};\n\nconst createSitemapIndexXml = (files: readonly SitemapFile[]): string => {\n  const content = files\n    .map((file) => `<sitemap><loc>${escapeXml(file.url)}</loc></sitemap>`)\n    .join(\"\");\n\n  return [\n    '<?xml version=\"1.0\" encoding=\"UTF-8\"?>',\n    '<sitemapindex xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">',\n    content,\n    \"</sitemapindex>\",\n  ].join(\"\");\n};\n\nexport const generateSitemap = (\n  options: SitemapGenerationOptions,\n): SitemapCollection => {\n  const baseUrl = normalizeSeoOrigin(options.baseUrl);\n\n  const maxEntries = options.maxEntries ?? DEFAULT_MAX_ENTRIES;\n  const maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;\n\n  if (\n    !Number.isInteger(maxEntries) ||\n    maxEntries < 1 ||\n    maxEntries > DEFAULT_MAX_ENTRIES\n  ) {\n    throw new Error(\"Sitemap maxEntries must be between 1 and 50,000.\");\n  }\n\n  if (\n    !Number.isInteger(maxBytes) ||\n    maxBytes < 1024 ||\n    maxBytes > DEFAULT_MAX_BYTES\n  ) {\n    throw new Error(\"Sitemap maxBytes must be between 1 KB and 50 MB.\");\n  }\n\n  const issues = validateSitemapEntries(options.entries, {\n    baseUrl,\n    allowExternalUrls: options.allowExternalUrls,\n    validateAlternates: options.validateAlternates,\n  });\n\n  const entries = normalizeEntries(\n    options.entries,\n    baseUrl,\n    options.allowExternalUrls ?? false,\n  );\n\n  const files: SitemapFile[] = [];\n\n  let current: SitemapEntry[] = [];\n\n  const createXml = (items: readonly SitemapEntry[]) =>\n    createSitemapXml(items, {\n      baseUrl,\n      includeLastModified: options.includeLastModified,\n      allowExternalUrls: options.allowExternalUrls,\n    });\n\n  // The empty document represents the fixed XML header and footer.\n  const emptyDocumentBytes = sitemapByteLength(createXml([]));\n\n  let currentBytes = emptyDocumentBytes;\n\n  const flush = () => {\n    if (current.length === 0) {\n      return;\n    }\n\n    const number = files.length + 1;\n\n    const filename = `${options.filename ?? \"sitemap\"}-${number}.xml`;\n\n    const url = normalizeSeoUrl(`/${filename}`, {\n      baseUrl,\n      allowExternal: false,\n    });\n\n    files.push({\n      filename,\n      url,\n      xml: createXml(current),\n      entries: current,\n    });\n\n    current = [];\n    currentBytes = emptyDocumentBytes;\n  };\n\n  for (const entry of entries) {\n    const singleXml = createXml([entry]);\n    const singleBytes = sitemapByteLength(singleXml);\n\n    if (singleBytes > maxBytes) {\n      issues.push({\n        code: \"ENTRY_TOO_LARGE\",\n        message: `Sitemap entry exceeds the configured byte limit: ${entry.url}.`,\n        url: String(entry.url),\n      });\n\n      continue;\n    }\n\n    // This includes the entry fragment and its namespace overhead.\n    // Counting namespace overhead per entry is intentionally conservative.\n    const entryBytes = singleBytes - emptyDocumentBytes;\n\n    const exceedsCount = current.length + 1 > maxEntries;\n    const exceedsBytes = currentBytes + entryBytes > maxBytes;\n\n    if (current.length > 0 && (exceedsCount || exceedsBytes)) {\n      flush();\n    }\n\n    current.push(entry);\n    currentBytes += entryBytes;\n  }\n\n  flush();\n\n  if (files.length > DEFAULT_MAX_ENTRIES) {\n    throw new Error(\n      \"Sitemap index exceeds the maximum of 50,000 sitemap references.\",\n    );\n  }\n\n  const indexXml = files.length > 1 ? createSitemapIndexXml(files) : undefined;\n\n  const indexUrl = indexXml\n    ? normalizeSeoUrl(`/${options.filename ?? \"sitemap\"}.xml`, { baseUrl })\n    : undefined;\n\n  return {\n    files,\n    indexXml,\n    indexUrl,\n    totalEntries: files.reduce((total, file) => total + file.entries.length, 0),\n    issues,\n  };\n};\n"],"mappings":"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"}

package/dist/sitemap/index.cjs

@@ -0,0 +1,11 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_xml = require("./xml.cjs");
+const require_generate = require("./generate.cjs");
+exports.createSitemapXml = require_xml.createSitemapXml;
+exports.escapeXml = require_xml.escapeXml;
+exports.formatSitemapDate = require_xml.formatSitemapDate;
+exports.generateSitemap = require_generate.generateSitemap;
+exports.serializeSitemap = require_generate.serializeSitemap;
+exports.serializeSitemapEntry = require_xml.serializeSitemapEntry;
+exports.sitemapByteLength = require_xml.sitemapByteLength;
+exports.validateSitemapEntries = require_xml.validateSitemapEntries;

package/dist/sitemap/index.d.cts

@@ -0,0 +1,4 @@
+import { SitemapAlternate, SitemapCollection, SitemapEntry, SitemapFile, SitemapGenerationOptions, SitemapImage, SitemapOptions, SitemapResult, SitemapValidationIssue, SitemapVideo } from "./types.cjs";
+import { createSitemapXml, escapeXml, formatSitemapDate, serializeSitemapEntry, sitemapByteLength, validateSitemapEntries } from "./xml.cjs";
+import { generateSitemap, serializeSitemap } from "./generate.cjs";
+export { type SitemapAlternate, type SitemapCollection, type SitemapEntry, type SitemapFile, type SitemapGenerationOptions, type SitemapImage, type SitemapOptions, type SitemapResult, type SitemapValidationIssue, type SitemapVideo, createSitemapXml, escapeXml, formatSitemapDate, generateSitemap, serializeSitemap, serializeSitemapEntry, sitemapByteLength, validateSitemapEntries };

package/dist/sitemap/index.d.ts

@@ -0,0 +1,4 @@
+import { SitemapAlternate, SitemapCollection, SitemapEntry, SitemapFile, SitemapGenerationOptions, SitemapImage, SitemapOptions, SitemapResult, SitemapValidationIssue, SitemapVideo } from "./types.js";
+import { createSitemapXml, escapeXml, formatSitemapDate, serializeSitemapEntry, sitemapByteLength, validateSitemapEntries } from "./xml.js";
+import { generateSitemap, serializeSitemap } from "./generate.js";
+export { type SitemapAlternate, type SitemapCollection, type SitemapEntry, type SitemapFile, type SitemapGenerationOptions, type SitemapImage, type SitemapOptions, type SitemapResult, type SitemapValidationIssue, type SitemapVideo, createSitemapXml, escapeXml, formatSitemapDate, generateSitemap, serializeSitemap, serializeSitemapEntry, sitemapByteLength, validateSitemapEntries };

package/dist/sitemap/index.js

@@ -0,0 +1,3 @@
+import { createSitemapXml, escapeXml, formatSitemapDate, serializeSitemapEntry, sitemapByteLength, validateSitemapEntries } from "./xml.js";
+import { generateSitemap, serializeSitemap } from "./generate.js";
+export { createSitemapXml, escapeXml, formatSitemapDate, generateSitemap, serializeSitemap, serializeSitemapEntry, sitemapByteLength, validateSitemapEntries };

package/dist/sitemap/types.d.cts

@@ -0,0 +1,82 @@
+import { SeoUrl } from "../core/types.cjs";
+export interface SitemapImage {
+  url: SeoUrl | string;
+  title?: string;
+  caption?: string;
+}
+export interface SitemapVideo {
+  thumbnailUrl: string;
+  title: string;
+  description: string;
+  contentUrl?: string;
+  playerUrl?: string;
+  duration?: number;
+  expirationDate?: Date | string;
+  rating?: number;
+  viewCount?: number;
+  publicationDate?: Date | string;
+  familyFriendly?: boolean;
+  restriction?: {
+    relationship: "allow" | "deny";
+    countries: string[];
+  };
+  requiresSubscription?: boolean;
+  live?: boolean;
+  tags?: string[];
+  category?: string;
+}
+export interface SitemapAlternate {
+  locale: string;
+  url: SeoUrl | string;
+}
+export interface SitemapEntry {
+  url: SeoUrl | string;
+  lastModified?: Date | string;
+  changeFrequency?: "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
+  priority?: number;
+  images?: SitemapImage[];
+  videos?: SitemapVideo[];
+  alternates?: SitemapAlternate[];
+  /** Excludes the entry when false. */
+  indexable?: boolean;
+  /** Only HTTP 200 entries are included. */
+  statusCode?: number;
+  /** Excludes redirect entries. */
+  redirectTo?: string;
+}
+export interface SitemapOptions {
+  baseUrl: SeoUrl | string;
+  entries: SitemapEntry[];
+  includeLastModified?: boolean;
+  allowExternalUrls?: boolean;
+}
+export interface SitemapGenerationOptions extends SitemapOptions {
+  maxEntries?: number;
+  maxBytes?: number;
+  filename?: string;
+  validateAlternates?: boolean;
+}
+export interface SitemapValidationIssue {
+  code: string;
+  message: string;
+  url?: string;
+  path?: string;
+}
+export interface SitemapResult {
+  xml: string;
+  entries: SitemapEntry[];
+  issues: SitemapValidationIssue[];
+}
+export interface SitemapFile {
+  filename: string;
+  url: SeoUrl;
+  xml: string;
+  entries: SitemapEntry[];
+}
+export interface SitemapCollection {
+  files: SitemapFile[];
+  indexXml?: string;
+  indexUrl?: SeoUrl;
+  totalEntries: number;
+  issues: SitemapValidationIssue[];
+}