next-advanced-sitemap 1.0.4 → 1.0.5

package/README.md

@@ -12,6 +12,7 @@ While Next.js provides a built-in `MetadataRoute.Sitemap` utility, it currently
 - **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.
+- **Strict SEO Enum Typing (v1.0.5)**: Compile-time validation and IDE autocompletion for `changefreq` and `priority` values to prevent typos.
 - **Strict Structural Validation (v1.0.4)**: Advanced URL parsing using the platform-native engine to intercept syntax errors and unencoded whitespaces before deployment.
 - **Auto-lastmod (v1.0.3)**: Optional automatic injection of the current system date for entries missing a `lastmod` value.
 - **Advanced XML Escaping (v1.0.2)**: Enhanced processor to handle complex special characters (`&`, `"`, `'`, `<`, `>`) in SEO metadata, ensuring XML integrity.
@@ -35,8 +36,8 @@ export async function GET() {
     {
       url: 'https://fomadev.com',
       lastmod: new Date(),
-      changefreq: 'daily',
-      priority: 1.0,
+      changefreq: 'daily', // Strictly typed
+      priority: 1.0,      // Auto-completed and strictly typed
       alternates: [
         { hreflang: 'fr', href: 'https://fomadev.com/fr' },
         { hreflang: 'en', href: 'https://fomadev.com/en' }
@@ -103,13 +104,13 @@ Generates a standard Next.js `Response` object with the correct `application/xml
       </tr>
       <tr>
           <td><code>changefreq</code></td>
-          <td class="type-label">string</td>
-          <td>(Optional) Search engine hint (always, hourly, daily, etc.).</td>
+          <td class="type-label">SitemapChangeFreq</td>
+          <td>(Optional) Bounded search engine hint ('always', 'daily', etc.).</td>
       </tr>
       <tr>
           <td><code>priority</code></td>
-          <td class="type-label">number</td>
-          <td>(Optional) Priority of the URL (0.0 to 1.0).</td>
+          <td class="type-label">SitemapPriority</td>
+          <td>(Optional) Bounded priority float value (0.0 to 1.0).</td>
       </tr>
       <tr>
           <td><code>images</code></td>
@@ -136,17 +137,24 @@ Generates a standard Next.js `Response` object with the correct `application/xml
 
 ## Technical Implementation
 
-### Validation & Safety (v1.0.4 Update)
+### Compile-Time Parameter Guarding (v1.0.5 Update)
+
+To avoid syntax typos breaking standard crawler schemas (e.g. accidentally writing `"dayly"` instead of `"daily"`), the library replaces generic primitive types with rigid evaluation layers:
+
+* **SitemapChangeFreq**: A literal string union restricting data ingestion exclusively to authorized keywords (`'always'` | `'hourly'` | `'daily'` | `'weekly'` | `'monthly'` | `'yearly'` | `'never'`).
+
+* **SitemapPriority**: A custom intersection schema offering direct autocomplete properties across decimal steps from `0.0` to `1.0` within modern code editors while retaining flexibility for precise custom float variables.
+
+### Validation & Safety
 
-The library executes two layers of deterministic checks on all URL inputs (including primary entries, alternative links, image locations, and video paths):
+The library executes deterministic validation layers on all URL inputs:
 
 1. **Protocol Match**: Enforces that all strings begin strictly with an absolute `http://` or `https://` prefix.
 
-2. **Whitespace Interception**: Instantly isolates and rejects strings containing unencoded internal spaces, preventing indexing failures in search consoles.
+2. **Whitespace Interception**: Instantly isolates and rejects strings containing unencoded internal spaces.
 
-3. **Structural Compliance**: Leverages the native `URL.canParse`() API (with a clean fallback mechanism to the `new URL()` constructor for older environments) to validate structural layout health.
+3. **Structural Compliance**: Leverages the native `URL.canParse`() API (with a clean fallback mechanism to the `new URL()` constructor) to validate layout health.
 
-If any path breaks standard RFC specifications, the generator throws an explicit runtime exception to prevent the application from deploying a malformed payload.
 
 ### Advanced XML Security
 

package/dist/index.d.cts

@@ -1,3 +1,13 @@
+/**
+ * Fréquences de changement autorisées dans la spécification des sitemaps
+ */
+type SitemapChangeFreq = 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
+/**
+ * Priorités recommandées (de 0.0 à 1.0)
+ * L'intersection (number & {}) permet de conserver l'autocomplétion des paliers
+ * tout en acceptant n'importe quel autre nombre flottant.
+ */
+type SitemapPriority = 0.0 | 0.1 | 0.2 | 0.3 | 0.4 | 0.5 | 0.6 | 0.7 | 0.8 | 0.9 | 1.0 | (number & {});
 /**
  * Interface pour les liens alternatifs (Hreflang / Multilingue)
  * @see https://developers.google.com/search/docs/specialty/international/localized-versions#sitemap
@@ -48,8 +58,8 @@ interface SitemapNews {
 interface SitemapEntry {
     url: string;
     lastmod?: string | Date;
-    changefreq?: 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
-    priority?: number;
+    changefreq?: SitemapChangeFreq;
+    priority?: SitemapPriority;
     images?: SitemapImage[];
     videos?: SitemapVideo[];
     news?: SitemapNews;
@@ -74,4 +84,4 @@ interface SitemapOptions {
  */
 declare function getServerSitemapResponse(entries: SitemapEntry[], options?: SitemapOptions): Response;
 
-export { type SitemapAlternate, type SitemapEntry, type SitemapImage, type SitemapNews, type SitemapOptions, type SitemapVideo, getServerSitemapResponse };
+export { type SitemapAlternate, type SitemapChangeFreq, type SitemapEntry, type SitemapImage, type SitemapNews, type SitemapOptions, type SitemapPriority, type SitemapVideo, getServerSitemapResponse };

package/dist/index.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Fréquences de changement autorisées dans la spécification des sitemaps
+ */
+type SitemapChangeFreq = 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
+/**
+ * Priorités recommandées (de 0.0 à 1.0)
+ * L'intersection (number & {}) permet de conserver l'autocomplétion des paliers
+ * tout en acceptant n'importe quel autre nombre flottant.
+ */
+type SitemapPriority = 0.0 | 0.1 | 0.2 | 0.3 | 0.4 | 0.5 | 0.6 | 0.7 | 0.8 | 0.9 | 1.0 | (number & {});
 /**
  * Interface pour les liens alternatifs (Hreflang / Multilingue)
  * @see https://developers.google.com/search/docs/specialty/international/localized-versions#sitemap
@@ -48,8 +58,8 @@ interface SitemapNews {
 interface SitemapEntry {
     url: string;
     lastmod?: string | Date;
-    changefreq?: 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
-    priority?: number;
+    changefreq?: SitemapChangeFreq;
+    priority?: SitemapPriority;
     images?: SitemapImage[];
     videos?: SitemapVideo[];
     news?: SitemapNews;
@@ -74,4 +84,4 @@ interface SitemapOptions {
  */
 declare function getServerSitemapResponse(entries: SitemapEntry[], options?: SitemapOptions): Response;
 
-export { type SitemapAlternate, type SitemapEntry, type SitemapImage, type SitemapNews, type SitemapOptions, type SitemapVideo, getServerSitemapResponse };
+export { type SitemapAlternate, type SitemapChangeFreq, type SitemapEntry, type SitemapImage, type SitemapNews, type SitemapOptions, type SitemapPriority, type SitemapVideo, getServerSitemapResponse };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-advanced-sitemap",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "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",