@answerfox/sitemap 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Anuj Ojha
+
+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,62 @@
+# @answerfox/sitemap
+
+Sitemap builder for the [Answerfox](https://github.com/Anuj7411/answerfox) SEO toolkit. Takes a list of paths, applies smart defaults inferred from path patterns, and returns a Next.js-compatible `MetadataRoute.Sitemap`.
+
+> **v0.1.0.** `buildSitemap()` and `sitemapIndex()` ship today with smart path-based defaults for priority and change frequency.
+
+## Install
+
+```bash
+pnpm add @answerfox/sitemap
+# requires next >= 14
+```
+
+## Usage
+
+```ts
+// app/sitemap.ts
+import { buildSitemap } from '@answerfox/sitemap';
+
+export default function sitemap() {
+  return buildSitemap(
+    [
+      { path: '/' },
+      { path: '/about' },
+      { path: '/privacy' },
+      { path: '/blog/launch' },
+      { path: '/blog/post-1', lastModified: '2026-05-14' },
+    ],
+    { baseUrl: 'https://acme.com' },
+  );
+}
+```
+
+## Smart defaults
+
+Priority and `changeFrequency` are inferred from path patterns when you don't set them explicitly:
+
+| Path pattern | priority | changeFrequency |
+|---|---|---|
+| `/` (home) | 1.0 | daily |
+| `/blog/*`, `/news/*`, `/posts/*` | 0.7 | weekly |
+| `/docs/*` | 0.6 | weekly |
+| `/products/*`, `/pricing` | 0.8 | weekly |
+| `/about`, `/privacy`, `/terms`, `/contact`, `/faq` | 0.3 | yearly |
+| Anything else | 0.5 | monthly |
+
+Explicit `priority` or `changeFrequency` on a route always wins over inferred defaults.
+
+## Large sites (>50k URLs)
+
+```ts
+import { sitemapIndex } from '@answerfox/sitemap';
+
+const index = sitemapIndex([
+  { url: 'https://acme.com/sitemap-1.xml' },
+  { url: 'https://acme.com/sitemap-2.xml', lastModified: new Date() },
+]);
+```
+
+## License
+
+[MIT](../../LICENSE) © 2026 Anuj Ojha

package/dist/build-sitemap.d.ts

@@ -0,0 +1,42 @@
+import type { MetadataRoute } from 'next';
+export type ChangeFrequency = 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
+export interface SitemapRouteInput {
+    /**
+     * Path-only segment. Must start with `/`. Combined with `baseUrl`
+     * to produce the final `url` field. Don't pass a full URL.
+     */
+    readonly path: string;
+    readonly lastModified?: Date | string | undefined;
+    readonly changeFrequency?: ChangeFrequency | undefined;
+    /** Float between 0.0 and 1.0 inclusive. */
+    readonly priority?: number | undefined;
+    /**
+     * Locale → absolute-URL map for hreflang alternates. Each URL is
+     * validated as an absolute http(s) URL.
+     *
+     * @example { 'en-US': 'https://acme.com/about', 'es-ES': 'https://acme.com/es/about' }
+     */
+    readonly alternates?: Record<string, string> | undefined;
+}
+export interface BuildSitemapOptions {
+    /** Absolute http(s) base URL. Trailing slash is stripped. */
+    readonly baseUrl: string;
+}
+/**
+ * Internal helper used by both `buildSitemap()` and `sitemapIndex()`.
+ * Returns a validated value to assign, or pushes an issue and returns
+ * `undefined`.
+ */
+export declare function validateAndCoerceLastModified(input: Date | string, prefix: string, issues: string[]): Date | string | undefined;
+/**
+ * Build a Next.js-compatible sitemap from a list of paths + a base URL.
+ * Smart defaults for `priority` and `changeFrequency` are inferred from
+ * each path's pattern; explicit values on a route always win.
+ *
+ * @throws InvalidUrlError if `baseUrl` or any `alternates` URL is
+ *   not a valid absolute http(s) URL.
+ * @throws SchemaValidationError batching every issue across paths,
+ *   priorities, duplicates, and `lastModified` values.
+ */
+export declare function buildSitemap(routes: readonly SitemapRouteInput[], options: BuildSitemapOptions): MetadataRoute.Sitemap;
+//# sourceMappingURL=build-sitemap.d.ts.map

package/dist/build-sitemap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-sitemap.d.ts","sourceRoot":"","sources":["../src/build-sitemap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAE1C,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,OAAO,CAAC;AAEZ,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IACvD,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC1D;AAED,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAgDD;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,IAAI,GAAG,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EAAE,GACf,IAAI,GAAG,MAAM,GAAG,SAAS,CAa3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,iBAAiB,EAAE,EACpC,OAAO,EAAE,mBAAmB,GAC3B,aAAa,CAAC,OAAO,CAgDvB"}

package/dist/build-sitemap.js

@@ -0,0 +1,121 @@
+import { SchemaValidationError, parseAbsoluteUrl } from '@answerfox/core';
+/**
+ * Priority + changeFrequency defaults inferred from the path. Used
+ * whenever the corresponding field isn't supplied explicitly.
+ */
+function inferDefaults(path) {
+    if (path === '/')
+        return { priority: 1.0, changeFrequency: 'daily' };
+    if (/^\/(blog|news|posts)(\/|$)/.test(path)) {
+        return { priority: 0.7, changeFrequency: 'weekly' };
+    }
+    if (/^\/docs(\/|$)/.test(path)) {
+        return { priority: 0.6, changeFrequency: 'weekly' };
+    }
+    if (/^\/(products|pricing)(\/|$)/.test(path)) {
+        return { priority: 0.8, changeFrequency: 'weekly' };
+    }
+    if (/^\/(about|privacy|terms|contact|faq)(\/|$)/.test(path)) {
+        return { priority: 0.3, changeFrequency: 'yearly' };
+    }
+    return { priority: 0.5, changeFrequency: 'monthly' };
+}
+function composeUrl(baseUrl, path) {
+    const trimmed = baseUrl.replace(/\/$/, '');
+    return `${trimmed}${path}`;
+}
+/** Validate a string lastModified as ISO 8601 (date or date-time). */
+const ISO_DATE_OR_DATETIME = /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}(:\d{2}(\.\d{1,9})?)?(Z|[+-]\d{2}:?\d{2})?)?$/;
+function isValidIso8601Date(s) {
+    if (!ISO_DATE_OR_DATETIME.test(s))
+        return false;
+    if (Number.isNaN(Date.parse(s)))
+        return false;
+    // Catch silent rollovers like "2026-02-30" → March 2.
+    const parts = s.slice(0, 10).split('-');
+    const yearStr = parts[0];
+    const monthStr = parts[1];
+    const dayStr = parts[2];
+    if (yearStr === undefined || monthStr === undefined || dayStr === undefined)
+        return false;
+    const year = Number(yearStr);
+    const month = Number(monthStr);
+    const day = Number(dayStr);
+    const d = new Date(Date.UTC(year, month - 1, day));
+    return d.getUTCFullYear() === year && d.getUTCMonth() === month - 1 && d.getUTCDate() === day;
+}
+/**
+ * Internal helper used by both `buildSitemap()` and `sitemapIndex()`.
+ * Returns a validated value to assign, or pushes an issue and returns
+ * `undefined`.
+ */
+export function validateAndCoerceLastModified(input, prefix, issues) {
+    if (input instanceof Date) {
+        if (Number.isNaN(input.getTime())) {
+            issues.push(`${prefix}.lastModified is an Invalid Date`);
+            return undefined;
+        }
+        return input;
+    }
+    if (!isValidIso8601Date(input)) {
+        issues.push(`${prefix}.lastModified is not a valid ISO 8601 date (got "${input}")`);
+        return undefined;
+    }
+    return input;
+}
+/**
+ * Build a Next.js-compatible sitemap from a list of paths + a base URL.
+ * Smart defaults for `priority` and `changeFrequency` are inferred from
+ * each path's pattern; explicit values on a route always win.
+ *
+ * @throws InvalidUrlError if `baseUrl` or any `alternates` URL is
+ *   not a valid absolute http(s) URL.
+ * @throws SchemaValidationError batching every issue across paths,
+ *   priorities, duplicates, and `lastModified` values.
+ */
+export function buildSitemap(routes, options) {
+    const baseUrl = parseAbsoluteUrl(options.baseUrl);
+    const issues = [];
+    const seen = new Set();
+    routes.forEach((r, i) => {
+        if (!r.path.startsWith('/')) {
+            issues.push(`routes[${i}].path must start with "/" (got "${r.path}")`);
+        }
+        if (r.path.includes('://')) {
+            issues.push(`routes[${i}].path must be a path, not a full URL (got "${r.path}"). Use the \`baseUrl\` option for the origin.`);
+        }
+        if (r.priority !== undefined && (r.priority < 0 || r.priority > 1)) {
+            issues.push(`routes[${i}].priority must be between 0.0 and 1.0 (got ${r.priority})`);
+        }
+        if (seen.has(r.path)) {
+            issues.push(`routes[${i}].path is a duplicate of an earlier entry: "${r.path}"`);
+        }
+        seen.add(r.path);
+        if (r.lastModified !== undefined) {
+            validateAndCoerceLastModified(r.lastModified, `routes[${i}]`, issues);
+        }
+    });
+    if (issues.length > 0) {
+        throw new SchemaValidationError(issues);
+    }
+    return routes.map((r) => {
+        const defaults = inferDefaults(r.path);
+        const entry = {
+            url: composeUrl(baseUrl, r.path),
+            changeFrequency: r.changeFrequency ?? defaults.changeFrequency,
+            priority: r.priority ?? defaults.priority,
+        };
+        if (r.lastModified !== undefined) {
+            entry.lastModified = r.lastModified;
+        }
+        if (r.alternates !== undefined) {
+            const languages = {};
+            for (const [locale, url] of Object.entries(r.alternates)) {
+                languages[locale] = parseAbsoluteUrl(url);
+            }
+            entry.alternates = { languages };
+        }
+        return entry;
+    });
+}
+//# sourceMappingURL=build-sitemap.js.map

package/dist/build-sitemap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-sitemap.js","sourceRoot":"","sources":["../src/build-sitemap.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @answerfox/sitemap — sitemap builder with smart path-based defaults
+ * for the Answerfox SEO toolkit. Wraps Next.js's `MetadataRoute.Sitemap`
+ * type with priority/changeFrequency inference, URL composition,
+ * duplicate-path detection, and a sitemap-index helper for large sites.
+ */
+export declare const VERSION = "0.0.0";
+export { buildSitemap, type BuildSitemapOptions, type ChangeFrequency, type SitemapRouteInput, } from './build-sitemap.js';
+export { sitemapIndex, type SitemapIndexEntry } from './sitemap-index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * @answerfox/sitemap — sitemap builder with smart path-based defaults
+ * for the Answerfox SEO toolkit. Wraps Next.js's `MetadataRoute.Sitemap`
+ * type with priority/changeFrequency inference, URL composition,
+ * duplicate-path detection, and a sitemap-index helper for large sites.
+ */
+export const VERSION = '0.0.0';
+export { buildSitemap, } from './build-sitemap.js';
+export { sitemapIndex } from './sitemap-index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,OAAO,EACL,YAAY,GAIb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,YAAY,EAA0B,MAAM,oBAAoB,CAAC"}

package/dist/sitemap-index.d.ts

@@ -0,0 +1,16 @@
+export interface SitemapIndexEntry {
+    /** Absolute http(s) URL to a child sitemap file. */
+    readonly url: string;
+    readonly lastModified?: Date | string | undefined;
+}
+/**
+ * Build a sitemap-index structure for sites that exceed Google's 50,000-URL
+ * per-file limit. Each entry points at a child sitemap; the caller serializes
+ * the returned array to whatever format their host expects (Next.js's XML
+ * generator, custom route handler, etc.).
+ *
+ * @throws InvalidUrlError if any `url` is not a valid absolute http(s) URL.
+ * @throws SchemaValidationError batching every bad `lastModified` value.
+ */
+export declare function sitemapIndex(entries: readonly SitemapIndexEntry[]): SitemapIndexEntry[];
+//# sourceMappingURL=sitemap-index.d.ts.map

package/dist/sitemap-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap-index.d.ts","sourceRoot":"","sources":["../src/sitemap-index.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;CACnD;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,CAiBvF"}

package/dist/sitemap-index.js

@@ -0,0 +1,29 @@
+import { SchemaValidationError, parseAbsoluteUrl } from '@answerfox/core';
+import { validateAndCoerceLastModified } from './build-sitemap.js';
+/**
+ * Build a sitemap-index structure for sites that exceed Google's 50,000-URL
+ * per-file limit. Each entry points at a child sitemap; the caller serializes
+ * the returned array to whatever format their host expects (Next.js's XML
+ * generator, custom route handler, etc.).
+ *
+ * @throws InvalidUrlError if any `url` is not a valid absolute http(s) URL.
+ * @throws SchemaValidationError batching every bad `lastModified` value.
+ */
+export function sitemapIndex(entries) {
+    // First pass: batch lastModified issues so callers see every problem at once.
+    const issues = [];
+    entries.forEach((e, i) => {
+        if (e.lastModified !== undefined) {
+            validateAndCoerceLastModified(e.lastModified, `entries[${i}]`, issues);
+        }
+    });
+    if (issues.length > 0) {
+        throw new SchemaValidationError(issues);
+    }
+    // Second pass: URL validation throws InvalidUrlError on the first bad URL.
+    return entries.map((e) => {
+        const url = parseAbsoluteUrl(e.url);
+        return e.lastModified !== undefined ? { url, lastModified: e.lastModified } : { url };
+    });
+}
+//# sourceMappingURL=sitemap-index.js.map

package/dist/sitemap-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap-index.js","sourceRoot":"","sources":["../src/sitemap-index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AAQnE;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,OAAqC;IAChE,8EAA8E;IAC9E,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACvB,IAAI,CAAC,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACjC,6BAA6B,CAAC,CAAC,CAAC,YAAY,EAAE,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACzE,CAAC;IACH,CAAC,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,2EAA2E;IAC3E,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACvB,MAAM,GAAG,GAAG,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACpC,OAAO,CAAC,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;IACxF,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@answerfox/sitemap",
+  "version": "0.1.1",
+  "description": "Sitemap builder with smart path-based defaults for the Answerfox SEO toolkit.",
+  "license": "MIT",
+  "author": "Anuj Ojha",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Anuj7411/answerfox.git",
+    "directory": "packages/sitemap"
+  },
+  "homepage": "https://github.com/Anuj7411/answerfox/tree/main/packages/sitemap#readme",
+  "bugs": "https://github.com/Anuj7411/answerfox/issues",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@answerfox/core": "0.1.1"
+  },
+  "peerDependencies": {
+    "next": ">=14.0.0"
+  },
+  "devDependencies": {
+    "next": "^15.0.0",
+    "react": "^19.0.0",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist .tsbuildinfo"
+  }
+}