next-advanced-sitemap 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 fomadev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,139 @@
+# next-advanced-sitemap
+
+A robust and type-safe sitemap generator for Next.js (App Router). This library extends standard sitemap capabilities by providing native support for Google-specific metadata including Images, Videos, News, and Internationalization (Hreflang).
+
+## Overview
+
+While Next.js provides a built-in `MetadataRoute.Sitemap` utility, it currently lacks support for advanced SEO attributes required by high-performance web applications. `next-advanced-sitemap` bridges this gap, allowing developers to programmatically generate complex XML sitemaps that comply with Google's extended schemas.
+
+## Features
+
+- **Google Images Support**: Index visual assets such as dashboard charts, infographics, and banners.
+- **Google Video Support**: Improve search visibility for video content with thumbnail and description metadata.
+- **Google News Support**: Comply with Google News requirements including publication names and dates.
+- **Internationalization**: Seamless integration of `xhtml:link` tags for Hreflang and multi-regional SEO.
+- **Developer Experience**: Fully typed with TypeScript, zero external dependencies, and optimized for Next.js Route Handlers.
+
+## Installation
+
+```bash
+npm install next-advanced-sitemap
+```
+
+## Usage
+
+To implement an advanced sitemap in the Next.js App Router, create a Route Handler at `app/sitemap.xml/route.ts`.
+
+```ts
+import { getServerSitemapResponse } from 'next-advanced-sitemap';
+
+export async function GET() {
+  const entries = [
+    {
+      url: 'https://fomadev.com',
+      lastmod: new Date(),
+      changefreq: 'daily',
+      priority: 1.0,
+      alternates: [
+        { hreflang: 'fr', href: 'https://fomadev.com/fr' },
+        { hreflang: 'en', href: 'https://fomadev.com/en' }
+      ]
+    },
+    {
+      url: 'https://fomadev.com/dashboard',
+      images: [
+        {
+          loc: 'https://fomadev.com/charts/analytics.png',
+          title: 'Growth Analytics Chart',
+          caption: 'Visual representation of monthly user growth.'
+        }
+      ]
+    },
+    {
+      url: 'https://fomadev.com/video-tutorial',
+      videos: [
+        {
+          thumbnail_loc: 'https://fomadev.com/thumbs/tutorial.jpg',
+          title: 'Next.js Advanced SEO Tutorial',
+          description: 'Learn how to implement advanced sitemaps in Next.js.',
+          publication_date: new Date('2026-04-22')
+        }
+      ]
+    }
+  ];
+
+  return getServerSitemapResponse(entries);
+}
+```
+
+## API Reference
+
+### getServerSitemapResponse(entries: SitemapEntry[])
+
+Generates a standard Next.js `Response` object with the correct `application/xml` content-type and optimized cache headers.
+
+### SitemapEntry Object
+
+<table>
+    <thead>
+        <tr>
+            <th>Property</th>
+            <th>Type</th>
+            <th>Description</th>
+        </tr>
+    </thead>
+    <tbody>
+        <tr>
+            <td><code>url</code></td>
+            <td>string</td>
+            <td>The absolute URL of the page.</td>
+        </tr>
+        <tr>
+            <td><code>lastmod</code></td>
+            <td>Date | string</td>
+            <td>(Optional) Last modification date in ISO format.</td>
+        </tr>
+        <tr>
+            <td><code>changefreq</code></td>
+            <td>string</td>
+            <td>(Optional) Search engine hint for crawl frequency.</td>
+        </tr>
+        <tr>
+            <td><code>priority</code></td>
+            <td>number</td>
+            <td>(Optional) Priority of the URL (0.0 to 1.0).</td>
+        </tr>
+        <tr>
+            <td><code>images</code></td>
+            <td>SitemapImage[]</td>
+            <td>(Optional) Array of image metadata for Google Images.</td>
+        </tr>
+        <tr>
+            <td><code>videos</code></td>
+            <td>SitemapVideo[]</td>
+            <td>(Optional) Array of video metadata for Google Videos.</td>
+        </tr>
+        <tr>
+            <td><code>news</code></td>
+            <td>SitemapNews</td>
+            <td>(Optional) Metadata for Google News indexing.</td>
+        </tr>
+        <tr>
+            <td><code>alternates</code></td>
+            <td>SitemapAlternate[]</td>
+            <td>(Optional) Language and regional alternate URLs (Hreflang).</td>
+        </tr>
+    </tbody>
+</table>
+
+## Technical Implementation
+
+This library uses a stream-aligned string builder approach to ensure minimal memory footprint during XML generation. It automatically handles XML entity escaping for special characters (e.g., `&`, `<`, `>`) to prevent sitemap corruption.
+
+## License
+
+Distributed under the MIT License. See <a href="LICENSE">LICENSE</a> for more information.
+
+## Author
+
+Created by <a href="https://github.com/fomadev">fomadev</a>.

package/dist/index.cjs

@@ -0,0 +1,162 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  getServerSitemapResponse: () => getServerSitemapResponse
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/utils/xml-escape.ts
+function escapeXml(unsafe) {
+  return unsafe.replace(/[<>&"']/g, (c) => {
+    switch (c) {
+      case "<":
+        return "&lt;";
+      case ">":
+        return "&gt;";
+      case "&":
+        return "&amp;";
+      case '"':
+        return "&quot;";
+      case "'":
+        return "&apos;";
+      default:
+        return c;
+    }
+  });
+}
+
+// src/core/generator.ts
+function generateXml(entries) {
+  let xml = `<?xml version="1.0" encoding="UTF-8"?>
+`;
+  xml += `<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
+`;
+  xml += `        xmlns:image="http://www.google.com/schemas/sitemap-image/1.1"
+`;
+  xml += `        xmlns:video="http://www.google.com/schemas/sitemap-video/1.1"
+`;
+  xml += `        xmlns:news="http://www.google.com/schemas/sitemap-news/0.9"
+`;
+  xml += `        xmlns:xhtml="http://www.w3.org/1999/xhtml">
+`;
+  for (const entry of entries) {
+    xml += `  <url>
+`;
+    xml += `    <loc>${escapeXml(entry.url)}</loc>
+`;
+    if (entry.alternates?.length) {
+      for (const alt of entry.alternates) {
+        xml += `    <xhtml:link rel="alternate" hreflang="${escapeXml(alt.hreflang)}" href="${escapeXml(alt.href)}" />
+`;
+      }
+    }
+    if (entry.lastmod) {
+      const date = entry.lastmod instanceof Date ? entry.lastmod.toISOString() : entry.lastmod;
+      xml += `    <lastmod>${date}</lastmod>
+`;
+    }
+    if (entry.changefreq) {
+      xml += `    <changefreq>${entry.changefreq}</changefreq>
+`;
+    }
+    if (entry.priority !== void 0) {
+      xml += `    <priority>${entry.priority.toFixed(1)}</priority>
+`;
+    }
+    if (entry.images?.length) {
+      for (const img of entry.images) {
+        xml += `    <image:image>
+`;
+        xml += `      <image:loc>${escapeXml(img.loc)}</image:loc>
+`;
+        if (img.title) xml += `      <image:title>${escapeXml(img.title)}</image:title>
+`;
+        if (img.caption) xml += `      <image:caption>${escapeXml(img.caption)}</image:caption>
+`;
+        xml += `    </image:image>
+`;
+      }
+    }
+    if (entry.videos?.length) {
+      for (const vid of entry.videos) {
+        xml += `    <video:video>
+`;
+        xml += `      <video:thumbnail_loc>${escapeXml(vid.thumbnail_loc)}</video:thumbnail_loc>
+`;
+        xml += `      <video:title>${escapeXml(vid.title)}</video:title>
+`;
+        xml += `      <video:description>${escapeXml(vid.description)}</video:description>
+`;
+        if (vid.content_loc) xml += `      <video:content_loc>${escapeXml(vid.content_loc)}</video:content_loc>
+`;
+        if (vid.player_loc) xml += `      <video:player_loc>${escapeXml(vid.player_loc)}</video:player_loc>
+`;
+        if (vid.publication_date) {
+          const vDate = vid.publication_date instanceof Date ? vid.publication_date.toISOString() : vid.publication_date;
+          xml += `      <video:publication_date>${vDate}</video:publication_date>
+`;
+        }
+        xml += `    </video:video>
+`;
+      }
+    }
+    if (entry.news) {
+      const nDate = entry.news.publication_date instanceof Date ? entry.news.publication_date.toISOString() : entry.news.publication_date;
+      xml += `    <news:news>
+`;
+      xml += `      <news:publication>
+`;
+      xml += `        <news:name>${escapeXml(entry.news.name)}</news:name>
+`;
+      xml += `        <news:language>${escapeXml(entry.news.language)}</news:language>
+`;
+      xml += `      </news:publication>
+`;
+      xml += `      <news:publication_date>${nDate}</news:publication_date>
+`;
+      xml += `      <news:title>${escapeXml(entry.news.title)}</news:title>
+`;
+      xml += `    </news:news>
+`;
+    }
+    xml += `  </url>
+`;
+  }
+  xml += `</urlset>`;
+  return xml;
+}
+
+// src/index.ts
+function getServerSitemapResponse(entries) {
+  const xml = generateXml(entries);
+  return new Response(xml, {
+    headers: {
+      "Content-Type": "application/xml",
+      "Cache-Control": "public, s-maxage=86400, stale-while-revalidate"
+    }
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getServerSitemapResponse
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/utils/xml-escape.ts","../src/core/generator.ts"],"sourcesContent":["import { SitemapEntry } from './types/sitemap.js';\r\nimport { generateXml } from './core/generator.js';\r\n\r\nexport * from './types/sitemap.js';\r\n\r\n/**\r\n * Génère une réponse HTTP compatible Next.js (App Router)\r\n * * @param entries - Liste des entrées du sitemap\r\n * @returns Une instance de Response contenant le flux XML\r\n */\r\nexport function getServerSitemapResponse(entries: SitemapEntry[]): Response {\r\n  const xml = generateXml(entries);\r\n\r\n  return new Response(xml, {\r\n    headers: {\r\n      'Content-Type': 'application/xml',\r\n      'Cache-Control': 'public, s-maxage=86400, stale-while-revalidate',\r\n    },\r\n  });\r\n}","export function escapeXml(unsafe: string): string {\r\n  return unsafe.replace(/[<>&\"']/g, (c) => {\r\n    switch (c) {\r\n      case '<': return '&lt;';\r\n      case '>': return '&gt;';\r\n      case '&': return '&amp;';\r\n      case '\"': return '&quot;';\r\n      case \"'\": return '&apos;';\r\n      default: return c;\r\n    }\r\n  });\r\n}","import { SitemapEntry } from '../types/sitemap.js';\r\nimport { escapeXml } from '../utils/xml-escape.js';\r\n\r\n/**\r\n * Génère le flux XML complet du sitemap incluant les extensions Images, Vidéos, News et Hreflang.\r\n */\r\nexport function generateXml(entries: SitemapEntry[]): string {\r\n  let xml = `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\\n`;\r\n  xml += `<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\"\\n`;\r\n  xml += `        xmlns:image=\"http://www.google.com/schemas/sitemap-image/1.1\"\\n`;\r\n  xml += `        xmlns:video=\"http://www.google.com/schemas/sitemap-video/1.1\"\\n`;\r\n  xml += `        xmlns:news=\"http://www.google.com/schemas/sitemap-news/0.9\"\\n`;\r\n  xml += `        xmlns:xhtml=\"http://www.w3.org/1999/xhtml\">\\n`;\r\n\r\n  for (const entry of entries) {\r\n    xml += `  <url>\\n`;\r\n    xml += `    <loc>${escapeXml(entry.url)}</loc>\\n`;\r\n\r\n    // Support Hreflang (Internationalisation)\r\n    if (entry.alternates?.length) {\r\n      for (const alt of entry.alternates) {\r\n        xml += `    <xhtml:link rel=\"alternate\" hreflang=\"${escapeXml(alt.hreflang)}\" href=\"${escapeXml(alt.href)}\" />\\n`;\r\n      }\r\n    }\r\n\r\n    // Métadonnées standard\r\n    if (entry.lastmod) {\r\n      const date = entry.lastmod instanceof Date ? entry.lastmod.toISOString() : entry.lastmod;\r\n      xml += `    <lastmod>${date}</lastmod>\\n`;\r\n    }\r\n\r\n    if (entry.changefreq) {\r\n      xml += `    <changefreq>${entry.changefreq}</changefreq>\\n`;\r\n    }\r\n\r\n    if (entry.priority !== undefined) {\r\n      xml += `    <priority>${entry.priority.toFixed(1)}</priority>\\n`;\r\n    }\r\n\r\n    // Extension Images\r\n    if (entry.images?.length) {\r\n      for (const img of entry.images) {\r\n        xml += `    <image:image>\\n`;\r\n        xml += `      <image:loc>${escapeXml(img.loc)}</image:loc>\\n`;\r\n        if (img.title) xml += `      <image:title>${escapeXml(img.title)}</image:title>\\n`;\r\n        if (img.caption) xml += `      <image:caption>${escapeXml(img.caption)}</image:caption>\\n`;\r\n        xml += `    </image:image>\\n`;\r\n      }\r\n    }\r\n\r\n    // Extension Vidéos\r\n    if (entry.videos?.length) {\r\n      for (const vid of entry.videos) {\r\n        xml += `    <video:video>\\n`;\r\n        xml += `      <video:thumbnail_loc>${escapeXml(vid.thumbnail_loc)}</video:thumbnail_loc>\\n`;\r\n        xml += `      <video:title>${escapeXml(vid.title)}</video:title>\\n`;\r\n        xml += `      <video:description>${escapeXml(vid.description)}</video:description>\\n`;\r\n        if (vid.content_loc) xml += `      <video:content_loc>${escapeXml(vid.content_loc)}</video:content_loc>\\n`;\r\n        if (vid.player_loc) xml += `      <video:player_loc>${escapeXml(vid.player_loc)}</video:player_loc>\\n`;\r\n        if (vid.publication_date) {\r\n           const vDate = vid.publication_date instanceof Date ? vid.publication_date.toISOString() : vid.publication_date;\r\n           xml += `      <video:publication_date>${vDate}</video:publication_date>\\n`;\r\n        }\r\n        xml += `    </video:video>\\n`;\r\n      }\r\n    }\r\n\r\n    // Extension News\r\n    if (entry.news) {\r\n      const nDate = entry.news.publication_date instanceof Date ? entry.news.publication_date.toISOString() : entry.news.publication_date;\r\n      xml += `    <news:news>\\n`;\r\n      xml += `      <news:publication>\\n`;\r\n      xml += `        <news:name>${escapeXml(entry.news.name)}</news:name>\\n`;\r\n      xml += `        <news:language>${escapeXml(entry.news.language)}</news:language>\\n`;\r\n      xml += `      </news:publication>\\n`;\r\n      xml += `      <news:publication_date>${nDate}</news:publication_date>\\n`;\r\n      xml += `      <news:title>${escapeXml(entry.news.title)}</news:title>\\n`;\r\n      xml += `    </news:news>\\n`;\r\n    }\r\n\r\n    xml += `  </url>\\n`;\r\n  }\r\n\r\n  xml += `</urlset>`;\r\n  return xml;\r\n}"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,66 @@
+/**
+ * Interface pour les liens alternatifs (Hreflang / Multilingue)
+ * @see https://developers.google.com/search/docs/specialty/international/localized-versions#sitemap
+ */
+interface SitemapAlternate {
+    hreflang: string;
+    href: string;
+}
+/**
+ * Interface pour les images dans le sitemap
+ * @see https://developers.google.com/search/docs/crawling-indexing/sitemaps/image-sitemaps
+ */
+interface SitemapImage {
+    loc: string;
+    caption?: string;
+    title?: string;
+    geoLocation?: string;
+    license?: string;
+}
+/**
+ * Interface pour les vidéos dans le sitemap
+ * @see https://developers.google.com/search/docs/crawling-indexing/sitemaps/video-sitemaps
+ */
+interface SitemapVideo {
+    thumbnail_loc: string;
+    title: string;
+    description: string;
+    content_loc?: string;
+    player_loc?: string;
+    duration?: number;
+    view_count?: number;
+    publication_date?: string | Date;
+    family_friendly?: 'yes' | 'no';
+}
+/**
+ * Interface pour Google News
+ * @see https://developers.google.com/search/docs/crawling-indexing/sitemaps/news-sitemaps
+ */
+interface SitemapNews {
+    name: string;
+    language: string;
+    publication_date: string | Date;
+    title: string;
+}
+/**
+ * Interface principale représentant une entrée du sitemap
+ */
+interface SitemapEntry {
+    url: string;
+    lastmod?: string | Date;
+    changefreq?: 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
+    priority?: number;
+    images?: SitemapImage[];
+    videos?: SitemapVideo[];
+    news?: SitemapNews;
+    alternates?: SitemapAlternate[];
+}
+
+/**
+ * Génère une réponse HTTP compatible Next.js (App Router)
+ * * @param entries - Liste des entrées du sitemap
+ * @returns Une instance de Response contenant le flux XML
+ */
+declare function getServerSitemapResponse(entries: SitemapEntry[]): Response;
+
+export { type SitemapAlternate, type SitemapEntry, type SitemapImage, type SitemapNews, type SitemapVideo, getServerSitemapResponse };

package/dist/index.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Interface pour les liens alternatifs (Hreflang / Multilingue)
+ * @see https://developers.google.com/search/docs/specialty/international/localized-versions#sitemap
+ */
+interface SitemapAlternate {
+    hreflang: string;
+    href: string;
+}
+/**
+ * Interface pour les images dans le sitemap
+ * @see https://developers.google.com/search/docs/crawling-indexing/sitemaps/image-sitemaps
+ */
+interface SitemapImage {
+    loc: string;
+    caption?: string;
+    title?: string;
+    geoLocation?: string;
+    license?: string;
+}
+/**
+ * Interface pour les vidéos dans le sitemap
+ * @see https://developers.google.com/search/docs/crawling-indexing/sitemaps/video-sitemaps
+ */
+interface SitemapVideo {
+    thumbnail_loc: string;
+    title: string;
+    description: string;
+    content_loc?: string;
+    player_loc?: string;
+    duration?: number;
+    view_count?: number;
+    publication_date?: string | Date;
+    family_friendly?: 'yes' | 'no';
+}
+/**
+ * Interface pour Google News
+ * @see https://developers.google.com/search/docs/crawling-indexing/sitemaps/news-sitemaps
+ */
+interface SitemapNews {
+    name: string;
+    language: string;
+    publication_date: string | Date;
+    title: string;
+}
+/**
+ * Interface principale représentant une entrée du sitemap
+ */
+interface SitemapEntry {
+    url: string;
+    lastmod?: string | Date;
+    changefreq?: 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
+    priority?: number;
+    images?: SitemapImage[];
+    videos?: SitemapVideo[];
+    news?: SitemapNews;
+    alternates?: SitemapAlternate[];
+}
+
+/**
+ * Génère une réponse HTTP compatible Next.js (App Router)
+ * * @param entries - Liste des entrées du sitemap
+ * @returns Une instance de Response contenant le flux XML
+ */
+declare function getServerSitemapResponse(entries: SitemapEntry[]): Response;
+
+export { type SitemapAlternate, type SitemapEntry, type SitemapImage, type SitemapNews, type SitemapVideo, getServerSitemapResponse };

package/dist/index.js

@@ -0,0 +1,135 @@
+// src/utils/xml-escape.ts
+function escapeXml(unsafe) {
+  return unsafe.replace(/[<>&"']/g, (c) => {
+    switch (c) {
+      case "<":
+        return "&lt;";
+      case ">":
+        return "&gt;";
+      case "&":
+        return "&amp;";
+      case '"':
+        return "&quot;";
+      case "'":
+        return "&apos;";
+      default:
+        return c;
+    }
+  });
+}
+
+// src/core/generator.ts
+function generateXml(entries) {
+  let xml = `<?xml version="1.0" encoding="UTF-8"?>
+`;
+  xml += `<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
+`;
+  xml += `        xmlns:image="http://www.google.com/schemas/sitemap-image/1.1"
+`;
+  xml += `        xmlns:video="http://www.google.com/schemas/sitemap-video/1.1"
+`;
+  xml += `        xmlns:news="http://www.google.com/schemas/sitemap-news/0.9"
+`;
+  xml += `        xmlns:xhtml="http://www.w3.org/1999/xhtml">
+`;
+  for (const entry of entries) {
+    xml += `  <url>
+`;
+    xml += `    <loc>${escapeXml(entry.url)}</loc>
+`;
+    if (entry.alternates?.length) {
+      for (const alt of entry.alternates) {
+        xml += `    <xhtml:link rel="alternate" hreflang="${escapeXml(alt.hreflang)}" href="${escapeXml(alt.href)}" />
+`;
+      }
+    }
+    if (entry.lastmod) {
+      const date = entry.lastmod instanceof Date ? entry.lastmod.toISOString() : entry.lastmod;
+      xml += `    <lastmod>${date}</lastmod>
+`;
+    }
+    if (entry.changefreq) {
+      xml += `    <changefreq>${entry.changefreq}</changefreq>
+`;
+    }
+    if (entry.priority !== void 0) {
+      xml += `    <priority>${entry.priority.toFixed(1)}</priority>
+`;
+    }
+    if (entry.images?.length) {
+      for (const img of entry.images) {
+        xml += `    <image:image>
+`;
+        xml += `      <image:loc>${escapeXml(img.loc)}</image:loc>
+`;
+        if (img.title) xml += `      <image:title>${escapeXml(img.title)}</image:title>
+`;
+        if (img.caption) xml += `      <image:caption>${escapeXml(img.caption)}</image:caption>
+`;
+        xml += `    </image:image>
+`;
+      }
+    }
+    if (entry.videos?.length) {
+      for (const vid of entry.videos) {
+        xml += `    <video:video>
+`;
+        xml += `      <video:thumbnail_loc>${escapeXml(vid.thumbnail_loc)}</video:thumbnail_loc>
+`;
+        xml += `      <video:title>${escapeXml(vid.title)}</video:title>
+`;
+        xml += `      <video:description>${escapeXml(vid.description)}</video:description>
+`;
+        if (vid.content_loc) xml += `      <video:content_loc>${escapeXml(vid.content_loc)}</video:content_loc>
+`;
+        if (vid.player_loc) xml += `      <video:player_loc>${escapeXml(vid.player_loc)}</video:player_loc>
+`;
+        if (vid.publication_date) {
+          const vDate = vid.publication_date instanceof Date ? vid.publication_date.toISOString() : vid.publication_date;
+          xml += `      <video:publication_date>${vDate}</video:publication_date>
+`;
+        }
+        xml += `    </video:video>
+`;
+      }
+    }
+    if (entry.news) {
+      const nDate = entry.news.publication_date instanceof Date ? entry.news.publication_date.toISOString() : entry.news.publication_date;
+      xml += `    <news:news>
+`;
+      xml += `      <news:publication>
+`;
+      xml += `        <news:name>${escapeXml(entry.news.name)}</news:name>
+`;
+      xml += `        <news:language>${escapeXml(entry.news.language)}</news:language>
+`;
+      xml += `      </news:publication>
+`;
+      xml += `      <news:publication_date>${nDate}</news:publication_date>
+`;
+      xml += `      <news:title>${escapeXml(entry.news.title)}</news:title>
+`;
+      xml += `    </news:news>
+`;
+    }
+    xml += `  </url>
+`;
+  }
+  xml += `</urlset>`;
+  return xml;
+}
+
+// src/index.ts
+function getServerSitemapResponse(entries) {
+  const xml = generateXml(entries);
+  return new Response(xml, {
+    headers: {
+      "Content-Type": "application/xml",
+      "Cache-Control": "public, s-maxage=86400, stale-while-revalidate"
+    }
+  });
+}
+export {
+  getServerSitemapResponse
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/xml-escape.ts","../src/core/generator.ts","../src/index.ts"],"sourcesContent":["export function escapeXml(unsafe: string): string {\r\n  return unsafe.replace(/[<>&\"']/g, (c) => {\r\n    switch (c) {\r\n      case '<': return '&lt;';\r\n      case '>': return '&gt;';\r\n      case '&': return '&amp;';\r\n      case '\"': return '&quot;';\r\n      case \"'\": return '&apos;';\r\n      default: return c;\r\n    }\r\n  });\r\n}","import { SitemapEntry } from '../types/sitemap.js';\r\nimport { escapeXml } from '../utils/xml-escape.js';\r\n\r\n/**\r\n * Génère le flux XML complet du sitemap incluant les extensions Images, Vidéos, News et Hreflang.\r\n */\r\nexport function generateXml(entries: SitemapEntry[]): string {\r\n  let xml = `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\\n`;\r\n  xml += `<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\"\\n`;\r\n  xml += `        xmlns:image=\"http://www.google.com/schemas/sitemap-image/1.1\"\\n`;\r\n  xml += `        xmlns:video=\"http://www.google.com/schemas/sitemap-video/1.1\"\\n`;\r\n  xml += `        xmlns:news=\"http://www.google.com/schemas/sitemap-news/0.9\"\\n`;\r\n  xml += `        xmlns:xhtml=\"http://www.w3.org/1999/xhtml\">\\n`;\r\n\r\n  for (const entry of entries) {\r\n    xml += `  <url>\\n`;\r\n    xml += `    <loc>${escapeXml(entry.url)}</loc>\\n`;\r\n\r\n    // Support Hreflang (Internationalisation)\r\n    if (entry.alternates?.length) {\r\n      for (const alt of entry.alternates) {\r\n        xml += `    <xhtml:link rel=\"alternate\" hreflang=\"${escapeXml(alt.hreflang)}\" href=\"${escapeXml(alt.href)}\" />\\n`;\r\n      }\r\n    }\r\n\r\n    // Métadonnées standard\r\n    if (entry.lastmod) {\r\n      const date = entry.lastmod instanceof Date ? entry.lastmod.toISOString() : entry.lastmod;\r\n      xml += `    <lastmod>${date}</lastmod>\\n`;\r\n    }\r\n\r\n    if (entry.changefreq) {\r\n      xml += `    <changefreq>${entry.changefreq}</changefreq>\\n`;\r\n    }\r\n\r\n    if (entry.priority !== undefined) {\r\n      xml += `    <priority>${entry.priority.toFixed(1)}</priority>\\n`;\r\n    }\r\n\r\n    // Extension Images\r\n    if (entry.images?.length) {\r\n      for (const img of entry.images) {\r\n        xml += `    <image:image>\\n`;\r\n        xml += `      <image:loc>${escapeXml(img.loc)}</image:loc>\\n`;\r\n        if (img.title) xml += `      <image:title>${escapeXml(img.title)}</image:title>\\n`;\r\n        if (img.caption) xml += `      <image:caption>${escapeXml(img.caption)}</image:caption>\\n`;\r\n        xml += `    </image:image>\\n`;\r\n      }\r\n    }\r\n\r\n    // Extension Vidéos\r\n    if (entry.videos?.length) {\r\n      for (const vid of entry.videos) {\r\n        xml += `    <video:video>\\n`;\r\n        xml += `      <video:thumbnail_loc>${escapeXml(vid.thumbnail_loc)}</video:thumbnail_loc>\\n`;\r\n        xml += `      <video:title>${escapeXml(vid.title)}</video:title>\\n`;\r\n        xml += `      <video:description>${escapeXml(vid.description)}</video:description>\\n`;\r\n        if (vid.content_loc) xml += `      <video:content_loc>${escapeXml(vid.content_loc)}</video:content_loc>\\n`;\r\n        if (vid.player_loc) xml += `      <video:player_loc>${escapeXml(vid.player_loc)}</video:player_loc>\\n`;\r\n        if (vid.publication_date) {\r\n           const vDate = vid.publication_date instanceof Date ? vid.publication_date.toISOString() : vid.publication_date;\r\n           xml += `      <video:publication_date>${vDate}</video:publication_date>\\n`;\r\n        }\r\n        xml += `    </video:video>\\n`;\r\n      }\r\n    }\r\n\r\n    // Extension News\r\n    if (entry.news) {\r\n      const nDate = entry.news.publication_date instanceof Date ? entry.news.publication_date.toISOString() : entry.news.publication_date;\r\n      xml += `    <news:news>\\n`;\r\n      xml += `      <news:publication>\\n`;\r\n      xml += `        <news:name>${escapeXml(entry.news.name)}</news:name>\\n`;\r\n      xml += `        <news:language>${escapeXml(entry.news.language)}</news:language>\\n`;\r\n      xml += `      </news:publication>\\n`;\r\n      xml += `      <news:publication_date>${nDate}</news:publication_date>\\n`;\r\n      xml += `      <news:title>${escapeXml(entry.news.title)}</news:title>\\n`;\r\n      xml += `    </news:news>\\n`;\r\n    }\r\n\r\n    xml += `  </url>\\n`;\r\n  }\r\n\r\n  xml += `</urlset>`;\r\n  return xml;\r\n}","import { SitemapEntry } from './types/sitemap.js';\r\nimport { generateXml } from './core/generator.js';\r\n\r\nexport * from './types/sitemap.js';\r\n\r\n/**\r\n * Génère une réponse HTTP compatible Next.js (App Router)\r\n * * @param entries - Liste des entrées du sitemap\r\n * @returns Une instance de Response contenant le flux XML\r\n */\r\nexport function getServerSitemapResponse(entries: SitemapEntry[]): Response {\r\n  const xml = generateXml(entries);\r\n\r\n  return new Response(xml, {\r\n    headers: {\r\n      'Content-Type': 'application/xml',\r\n      'Cache-Control': 'public, s-maxage=86400, stale-while-revalidate',\r\n    },\r\n  });\r\n}"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "next-advanced-sitemap",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Advanced sitemap generator for Next.js. Powerful support for Google Images, Video, News, and Hreflang (multilingual). Type-safe, zero-dependency, and built for App Router.",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "tsup src/index.ts --watch",
+    "build": "tsup",
+    "test": "vitest run",
+    "prepublishOnly": "npm run test && npm run build"
+  },
+  "keywords": [
+    "nextjs",
+    "sitemap",
+    "seo",
+    "google-images",
+    "google-video",
+    "google-news",
+    "hreflang",
+    "multilingual",
+    "typescript",
+    "app-router"
+  ],
+  "author": "fomadev",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fomadev/next-advanced-sitemap.git"
+  },
+  "bugs": {
+    "url": "https://github.com/fomadev/next-advanced-sitemap/issues"
+  },
+  "homepage": "https://github.com/fomadev/next-advanced-sitemap#readme"
+}