@djangocfg/nextjs 2.1.576 → 2.1.577

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/nextjs",
-  "version": "2.1.576",
+  "version": "2.1.577",
   "description": "Next.js server utilities: sitemap, health, OG images, contact forms, navigation, config",
   "keywords": [
     "nextjs",
@@ -149,9 +149,9 @@
     "ai-docs": "tsx src/ai/cli.ts"
   },
   "peerDependencies": {
-    "@djangocfg/devtools": "^2.1.576",
-    "@djangocfg/i18n": "^2.1.576",
-    "@djangocfg/ui-core": "^2.1.576",
+    "@djangocfg/devtools": "^2.1.577",
+    "@djangocfg/i18n": "^2.1.577",
+    "@djangocfg/ui-core": "^2.1.577",
     "next": "^16.2.2"
   },
   "peerDependenciesMeta": {
@@ -170,11 +170,11 @@
     "semver": "^7.8.5"
   },
   "devDependencies": {
-    "@djangocfg/devtools": "^2.1.576",
-    "@djangocfg/i18n": "^2.1.576",
-    "@djangocfg/layouts": "^2.1.576",
-    "@djangocfg/typescript-config": "^2.1.576",
-    "@djangocfg/ui-core": "^2.1.576",
+    "@djangocfg/devtools": "^2.1.577",
+    "@djangocfg/i18n": "^2.1.577",
+    "@djangocfg/layouts": "^2.1.577",
+    "@djangocfg/typescript-config": "^2.1.577",
+    "@djangocfg/ui-core": "^2.1.577",
     "@types/node": "^25.9.5",
     "@types/react": "19.2.15",
     "@types/react-dom": "19.2.3",

package/src/config/index.ts

@@ -15,6 +15,9 @@
 // Main config factory
 export { createBaseNextConfig, type BaseNextConfigOptions } from './createNextConfig';
 
+// IndexNow key file → Django
+export { indexNowKeyRewrite } from './indexnow';
+
 // Constants
 export {
   PACKAGE_NAME,

package/src/config/indexnow.test.ts

@@ -0,0 +1,23 @@
+import assert from 'node:assert/strict';
+import { test } from 'node:test';
+
+// @ts-expect-error — Next's vendored copy ships no types; it is the matcher rewrites use.
+import { pathToRegexp } from 'next/dist/compiled/path-to-regexp';
+
+import { indexNowKeyRewrite } from './indexnow';
+
+test('the rewrite matches a key at the root and nothing deeper', () => {
+  const { source } = indexNowKeyRewrite('https://api.example.com');
+  const re: RegExp = pathToRegexp(source, []);
+  assert.ok(re.test('/865178f53dba1db23f3fc4fe95e9b64a.txt'));
+  assert.ok(!re.test('/robots.txt'), 'under 8 chars is not a key');
+  assert.ok(!re.test('/a/865178f53dba1db23f3fc4fe95e9b64a.txt'));
+  assert.ok(!re.test('/has_underscore_.txt'));
+});
+
+test('the destination is Django, without a doubled slash', () => {
+  assert.equal(
+    indexNowKeyRewrite('https://api.example.com/').destination,
+    'https://api.example.com/cfg/sitemap/indexnow/:key.txt',
+  );
+});

package/src/config/indexnow.ts

@@ -0,0 +1,27 @@
+/**
+ * IndexNow key file, served by Django.
+ *
+ * The protocol proves host ownership by fetching `https://<host>/<key>.txt`.
+ * Django answers it at `/cfg/sitemap/indexnow/<key>.txt` from
+ * `IndexNowConfig` — only the configured key, every other name 404s — so the
+ * key lives in one place and the frontend ships no file.
+ *
+ * Put it in `fallback`: real public files and routes (`robots.txt`,
+ * `llms-full.txt`) match the same shape and must win.
+ *
+ * @example
+ * ```ts
+ * import { indexNowKeyRewrite } from '@djangocfg/nextjs/config';
+ *
+ * async rewrites() {
+ *   return { beforeFiles: [], afterFiles: [], fallback: [indexNowKeyRewrite(API_URL)] };
+ * }
+ * ```
+ */
+export function indexNowKeyRewrite(apiUrl: string): { source: string; destination: string } {
+  return {
+    // The protocol's key alphabet and length, at the site root only.
+    source: '/:key([A-Za-z0-9-]{8,128}).txt',
+    destination: `${apiUrl.replace(/\/+$/, '')}/cfg/sitemap/indexnow/:key.txt`,
+  };
+}