@djangocfg/nextjs 2.1.411 → 2.1.413

package/README.md

@@ -27,7 +27,7 @@
 - **i18n** — full next-intl integration with routing, middleware, and components
 - **PWA** — zero-config service worker and manifest
 - **Base Next.js Config** — reusable `createBaseNextConfig()` factory for monorepos
-- **Sitemap** — dynamic XML sitemap with i18n hreflang support
+- **Sitemap** — paginated sitemap-index backed by `django_cfg.modules.django_sitemap` (handles 2M+ URLs)
 - **Health Checks** — production-ready health monitoring endpoints
 - **Navigation** — route definitions, menu generation, and active-state helpers
 - **AI Documentation** — search DjangoCFG docs via MCP server and CLI
@@ -294,50 +294,44 @@ import { LocaleSwitcher } from '@djangocfg/nextjs/i18n/components';
 
 ### Sitemap Generation
 
-Generate dynamic XML sitemaps with i18n hreflang support:
+Paginated sitemap-index integrated with `django_cfg.modules.django_sitemap`.
+Backed by a typed JSON contract: Django streams keyset-paginated chunks,
+Next.js's native `generateSitemaps()` turns each chunk into one XML file
+plus an auto-generated `<sitemapindex>` at `/sitemap.xml`. Handles
+catalogs up to Google's 50 000-URLs-per-file cap without materialising
+data on the frontend.
 
 ```tsx
-// app/sitemap.xml/route.ts
-import { createSitemapHandler } from '@djangocfg/nextjs/sitemap';
-import { routing } from '@djangocfg/nextjs/i18n';
-
-export const GET = createSitemapHandler({
-  siteUrl: 'https://example.com',
-  // i18n support with hreflang tags
-  i18n: {
-    locales: routing.locales,
-    defaultLocale: routing.defaultLocale,
-  },
-  staticPages: [
-    { loc: '/', changefreq: 'daily', priority: 1.0 },
-    { loc: '/about', changefreq: 'monthly', priority: 0.8 },
+// app/sitemap.ts
+import { createDjangoSitemap } from '@djangocfg/nextjs/sitemap';
+
+const { generateSitemaps, sitemap } = createDjangoSitemap({
+  host: process.env.NEXT_PUBLIC_SITE_URL!,
+  apiUrl: process.env.NEXT_PUBLIC_API_URL,  // optional — omit for static-only
+  staticRoutes: [
+    { path: '/', changeFrequency: 'daily', priority: 1.0 },
+    { path: '/catalog', changeFrequency: 'daily', priority: 0.9 },
   ],
-  dynamicPages: async () => {
-    const posts = await fetchPosts();
-    return posts.map(post => ({
-      loc: `/posts/${post.slug}`,
-      lastmod: post.updatedAt,
-      changefreq: 'weekly',
-      priority: 0.7,
-    }));
-  },
 });
+
+export { generateSitemaps, sitemap as default };
+export const revalidate = 3600;
 ```
 
-**Generated XML with hreflang:**
+```tsx
+// app/robots.ts
+import { createRobots } from '@djangocfg/nextjs/sitemap';
 
-```xml
-<url>
-  <loc>https://example.com/en/about</loc>
-  <xhtml:link rel="alternate" hreflang="en" href="https://example.com/en/about"/>
-  <xhtml:link rel="alternate" hreflang="ru" href="https://example.com/ru/about"/>
-  <xhtml:link rel="alternate" hreflang="ko" href="https://example.com/ko/about"/>
-  <xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/en/about"/>
-  <changefreq>monthly</changefreq>
-  <priority>0.8</priority>
-</url>
+export default createRobots({
+  host: process.env.NEXT_PUBLIC_SITE_URL!,
+  disallow: ['/account/', '/auth', '/api/'],
+});
 ```
 
+See [`src/sitemap/README.md`](./src/sitemap/README.md) for the full
+backend ↔ frontend integration guide, including the Django source
+registration, cache layers, and deployment notes.
+
 ### Health Check Endpoint
 
 Create a health monitoring endpoint:

package/dist/config/index.mjs

@@ -14,7 +14,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@djangocfg/nextjs",
-      version: "2.1.411",
+      version: "2.1.413",
       description: "Next.js server utilities: sitemap, health, OG images, contact forms, navigation, config",
       keywords: [
         "nextjs",