authscape 1.0.714 → 1.0.718

package/.claude/settings.local.json

@@ -0,0 +1,10 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(dir:*)",
+      "Bash(npm run build:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

package/SITEMAP_SETUP.md

@@ -0,0 +1,215 @@
+# AuthScape Sitemap Integration
+
+Automatically generate and serve a sitemap.xml for your Next.js application using the AuthScape API.
+
+## Features
+
+- Automatic sitemap.xml generation from your AuthScape API
+- Server-side rendering for SEO optimization
+- Automatic caching with stale-while-revalidate strategy
+- Domain-aware (works with multi-tenant setups)
+- Zero configuration required (uses existing AuthScape settings)
+
+## Quick Setup (2 minutes)
+
+### Step 1: Copy the Template File
+
+Copy the sitemap template to your Next.js pages directory:
+
+```bash
+# From your project root
+cp node_modules/authscape/src/templates/sitemap.xml.js pages/sitemap.xml.js
+```
+
+Or manually create `pages/sitemap.xml.js` with this content:
+
+```javascript
+import { createSitemapHandler } from 'authscape/src/services/sitemapService';
+
+export default function Sitemap() {
+  return null;
+}
+
+export const getServerSideProps = createSitemapHandler();
+```
+
+### Step 2: Ensure Environment Variable is Set
+
+Make sure your `.env.local` file has the `apiUri` configured:
+
+```env
+apiUri=https://your-authscape-api.com
+```
+
+### Step 3: Test It
+
+Visit your sitemap in your browser:
+
+```
+http://localhost:3000/sitemap.xml
+```
+
+Or in production:
+
+```
+https://yourdomain.com/sitemap.xml
+```
+
+That's it! Your sitemap is now live and automatically updating.
+
+## How It Works
+
+1. When a user requests `/sitemap.xml`, Next.js calls the `getServerSideProps` function
+2. The sitemap service extracts the current domain from the request headers
+3. It calls your AuthScape API at `/api/Sitemap?domain={yourdomain}`
+4. The API returns the sitemap XML based on your content
+5. The response is cached for 24 hours with stale-while-revalidate
+
+## Advanced Usage
+
+### Custom API URI
+
+If you need to override the API URI for a specific environment:
+
+```javascript
+import { createSitemapHandler } from 'authscape/src/services/sitemapService';
+
+export default function Sitemap() {
+  return null;
+}
+
+// Override the API URI
+export const getServerSideProps = createSitemapHandler('https://custom-api.com');
+```
+
+### Manual Control
+
+If you need more control over the sitemap generation:
+
+```javascript
+import { generateSitemap } from 'authscape/src/services/sitemapService';
+
+export default function Sitemap() {
+  return null;
+}
+
+export async function getServerSideProps({ req, res }) {
+  const apiUri = process.env.apiUri;
+
+  // Add custom logic here
+  console.log('Generating sitemap for:', req.headers.host);
+
+  // Call the sitemap generator
+  return await generateSitemap(req, res, apiUri);
+}
+```
+
+### Custom Cache Headers
+
+To change the cache duration, modify the response headers:
+
+```javascript
+import { generateSitemap } from 'authscape/src/services/sitemapService';
+
+export default function Sitemap() {
+  return null;
+}
+
+export async function getServerSideProps({ req, res }) {
+  const result = await generateSitemap(req, res, process.env.apiUri);
+
+  // Override cache to 1 hour instead of 24 hours
+  res.setHeader('Cache-Control', 'public, s-maxage=3600, stale-while-revalidate');
+
+  return result;
+}
+```
+
+## Multi-Tenant Support
+
+The sitemap service automatically detects the current domain from the request headers, making it work seamlessly with AuthScape's multi-tenant features. Each domain will receive its own sitemap based on the content configured in the AuthScape API.
+
+## Troubleshooting
+
+### Sitemap returns 500 error
+
+- Check that `process.env.apiUri` is properly configured
+- Verify your AuthScape API is accessible
+- Check the server logs for the error message
+
+### Sitemap is empty
+
+- Verify your AuthScape API returns valid sitemap data at `/api/Sitemap?domain={yourdomain}`
+- Test the API endpoint directly in your browser or Postman
+
+### Sitemap not updating
+
+- The sitemap is cached for 24 hours by default
+- Clear your browser cache or use incognito mode
+- Modify the cache headers to a shorter duration during development
+
+## API Reference
+
+### `createSitemapHandler(apiUri?)`
+
+Creates a `getServerSideProps` function configured for sitemap generation.
+
+**Parameters:**
+- `apiUri` (string, optional): Override the API URI. Defaults to `process.env.apiUri`
+
+**Returns:**
+- Function: A `getServerSideProps` function
+
+**Example:**
+```javascript
+export const getServerSideProps = createSitemapHandler();
+```
+
+### `generateSitemap(req, res, apiUri)`
+
+Lower-level function for generating sitemaps with custom logic.
+
+**Parameters:**
+- `req` (NextApiRequest): Next.js request object
+- `res` (NextApiResponse): Next.js response object
+- `apiUri` (string): The AuthScape API base URI
+
+**Returns:**
+- Promise<{ props: {} }>: Next.js getServerSideProps return value
+
+**Example:**
+```javascript
+export async function getServerSideProps({ req, res }) {
+  return await generateSitemap(req, res, process.env.apiUri);
+}
+```
+
+## SEO Benefits
+
+Having a sitemap.xml provides several SEO benefits:
+
+1. **Faster Indexing**: Search engines discover your content faster
+2. **Complete Coverage**: Ensures all pages are found, even if not linked
+3. **Priority Signals**: Can indicate which pages are most important
+4. **Change Frequency**: Signals how often content is updated
+5. **Multi-lingual Support**: Can include alternate language versions
+
+## Integration with robots.txt
+
+Don't forget to reference your sitemap in your `robots.txt` file:
+
+Create `public/robots.txt`:
+
+```txt
+User-agent: *
+Allow: /
+
+Sitemap: https://yourdomain.com/sitemap.xml
+```
+
+## Support
+
+For issues or questions:
+- Check the [AuthScape Documentation](https://authscape.com/docs)
+- Contact AuthScape Support
+- Review the source code in `node_modules/authscape/src/services/sitemapService.js`

package/index.js

@@ -9284,6 +9284,138 @@ var signInValidator = exports.signInValidator = /*#__PURE__*/function () {
 }();
 "use strict";
 
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createSitemapHandler = createSitemapHandler;
+exports["default"] = void 0;
+exports.generateSitemap = generateSitemap;
+function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return e; }; var t, e = {}, r = Object.prototype, n = r.hasOwnProperty, o = Object.defineProperty || function (t, e, r) { t[e] = r.value; }, i = "function" == typeof Symbol ? Symbol : {}, a = i.iterator || "@@iterator", c = i.asyncIterator || "@@asyncIterator", u = i.toStringTag || "@@toStringTag"; function define(t, e, r) { return Object.defineProperty(t, e, { value: r, enumerable: !0, configurable: !0, writable: !0 }), t[e]; } try { define({}, ""); } catch (t) { define = function define(t, e, r) { return t[e] = r; }; } function wrap(t, e, r, n) { var i = e && e.prototype instanceof Generator ? e : Generator, a = Object.create(i.prototype), c = new Context(n || []); return o(a, "_invoke", { value: makeInvokeMethod(t, r, c) }), a; } function tryCatch(t, e, r) { try { return { type: "normal", arg: t.call(e, r) }; } catch (t) { return { type: "throw", arg: t }; } } e.wrap = wrap; var h = "suspendedStart", l = "suspendedYield", f = "executing", s = "completed", y = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var p = {}; define(p, a, function () { return this; }); var d = Object.getPrototypeOf, v = d && d(d(values([]))); v && v !== r && n.call(v, a) && (p = v); var g = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(p); function defineIteratorMethods(t) { ["next", "throw", "return"].forEach(function (e) { define(t, e, function (t) { return this._invoke(e, t); }); }); } function AsyncIterator(t, e) { function invoke(r, o, i, a) { var c = tryCatch(t[r], t, o); if ("throw" !== c.type) { var u = c.arg, h = u.value; return h && "object" == _typeof(h) && n.call(h, "__await") ? e.resolve(h.__await).then(function (t) { invoke("next", t, i, a); }, function (t) { invoke("throw", t, i, a); }) : e.resolve(h).then(function (t) { u.value = t, i(u); }, function (t) { return invoke("throw", t, i, a); }); } a(c.arg); } var r; o(this, "_invoke", { value: function value(t, n) { function callInvokeWithMethodAndArg() { return new e(function (e, r) { invoke(t, n, e, r); }); } return r = r ? r.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(e, r, n) { var o = h; return function (i, a) { if (o === f) throw Error("Generator is already running"); if (o === s) { if ("throw" === i) throw a; return { value: t, done: !0 }; } for (n.method = i, n.arg = a;;) { var c = n.delegate; if (c) { var u = maybeInvokeDelegate(c, n); if (u) { if (u === y) continue; return u; } } if ("next" === n.method) n.sent = n._sent = n.arg;else if ("throw" === n.method) { if (o === h) throw o = s, n.arg; n.dispatchException(n.arg); } else "return" === n.method && n.abrupt("return", n.arg); o = f; var p = tryCatch(e, r, n); if ("normal" === p.type) { if (o = n.done ? s : l, p.arg === y) continue; return { value: p.arg, done: n.done }; } "throw" === p.type && (o = s, n.method = "throw", n.arg = p.arg); } }; } function maybeInvokeDelegate(e, r) { var n = r.method, o = e.iterator[n]; if (o === t) return r.delegate = null, "throw" === n && e.iterator["return"] && (r.method = "return", r.arg = t, maybeInvokeDelegate(e, r), "throw" === r.method) || "return" !== n && (r.method = "throw", r.arg = new TypeError("The iterator does not provide a '" + n + "' method")), y; var i = tryCatch(o, e.iterator, r.arg); if ("throw" === i.type) return r.method = "throw", r.arg = i.arg, r.delegate = null, y; var a = i.arg; return a ? a.done ? (r[e.resultName] = a.value, r.next = e.nextLoc, "return" !== r.method && (r.method = "next", r.arg = t), r.delegate = null, y) : a : (r.method = "throw", r.arg = new TypeError("iterator result is not an object"), r.delegate = null, y); } function pushTryEntry(t) { var e = { tryLoc: t[0] }; 1 in t && (e.catchLoc = t[1]), 2 in t && (e.finallyLoc = t[2], e.afterLoc = t[3]), this.tryEntries.push(e); } function resetTryEntry(t) { var e = t.completion || {}; e.type = "normal", delete e.arg, t.completion = e; } function Context(t) { this.tryEntries = [{ tryLoc: "root" }], t.forEach(pushTryEntry, this), this.reset(!0); } function values(e) { if (e || "" === e) { var r = e[a]; if (r) return r.call(e); if ("function" == typeof e.next) return e; if (!isNaN(e.length)) { var o = -1, i = function next() { for (; ++o < e.length;) if (n.call(e, o)) return next.value = e[o], next.done = !1, next; return next.value = t, next.done = !0, next; }; return i.next = i; } } throw new TypeError(_typeof(e) + " is not iterable"); } return GeneratorFunction.prototype = GeneratorFunctionPrototype, o(g, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), o(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, u, "GeneratorFunction"), e.isGeneratorFunction = function (t) { var e = "function" == typeof t && t.constructor; return !!e && (e === GeneratorFunction || "GeneratorFunction" === (e.displayName || e.name)); }, e.mark = function (t) { return Object.setPrototypeOf ? Object.setPrototypeOf(t, GeneratorFunctionPrototype) : (t.__proto__ = GeneratorFunctionPrototype, define(t, u, "GeneratorFunction")), t.prototype = Object.create(g), t; }, e.awrap = function (t) { return { __await: t }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, c, function () { return this; }), e.AsyncIterator = AsyncIterator, e.async = function (t, r, n, o, i) { void 0 === i && (i = Promise); var a = new AsyncIterator(wrap(t, r, n, o), i); return e.isGeneratorFunction(r) ? a : a.next().then(function (t) { return t.done ? t.value : a.next(); }); }, defineIteratorMethods(g), define(g, u, "Generator"), define(g, a, function () { return this; }), define(g, "toString", function () { return "[object Generator]"; }), e.keys = function (t) { var e = Object(t), r = []; for (var n in e) r.push(n); return r.reverse(), function next() { for (; r.length;) { var t = r.pop(); if (t in e) return next.value = t, next.done = !1, next; } return next.done = !0, next; }; }, e.values = values, Context.prototype = { constructor: Context, reset: function reset(e) { if (this.prev = 0, this.next = 0, this.sent = this._sent = t, this.done = !1, this.delegate = null, this.method = "next", this.arg = t, this.tryEntries.forEach(resetTryEntry), !e) for (var r in this) "t" === r.charAt(0) && n.call(this, r) && !isNaN(+r.slice(1)) && (this[r] = t); }, stop: function stop() { this.done = !0; var t = this.tryEntries[0].completion; if ("throw" === t.type) throw t.arg; return this.rval; }, dispatchException: function dispatchException(e) { if (this.done) throw e; var r = this; function handle(n, o) { return a.type = "throw", a.arg = e, r.next = n, o && (r.method = "next", r.arg = t), !!o; } for (var o = this.tryEntries.length - 1; o >= 0; --o) { var i = this.tryEntries[o], a = i.completion; if ("root" === i.tryLoc) return handle("end"); if (i.tryLoc <= this.prev) { var c = n.call(i, "catchLoc"), u = n.call(i, "finallyLoc"); if (c && u) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } else if (c) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); } else { if (!u) throw Error("try statement without catch or finally"); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } } } }, abrupt: function abrupt(t, e) { for (var r = this.tryEntries.length - 1; r >= 0; --r) { var o = this.tryEntries[r]; if (o.tryLoc <= this.prev && n.call(o, "finallyLoc") && this.prev < o.finallyLoc) { var i = o; break; } } i && ("break" === t || "continue" === t) && i.tryLoc <= e && e <= i.finallyLoc && (i = null); var a = i ? i.completion : {}; return a.type = t, a.arg = e, i ? (this.method = "next", this.next = i.finallyLoc, y) : this.complete(a); }, complete: function complete(t, e) { if ("throw" === t.type) throw t.arg; return "break" === t.type || "continue" === t.type ? this.next = t.arg : "return" === t.type ? (this.rval = this.arg = t.arg, this.method = "return", this.next = "end") : "normal" === t.type && e && (this.next = e), y; }, finish: function finish(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.finallyLoc === t) return this.complete(r.completion, r.afterLoc), resetTryEntry(r), y; } }, "catch": function _catch(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.tryLoc === t) { var n = r.completion; if ("throw" === n.type) { var o = n.arg; resetTryEntry(r); } return o; } } throw Error("illegal catch attempt"); }, delegateYield: function delegateYield(e, r, n) { return this.delegate = { iterator: values(e), resultName: r, nextLoc: n }, "next" === this.method && (this.arg = t), y; } }, e; }
+function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
+/**
+ * AuthScape Sitemap Service
+ * Provides automatic sitemap.xml generation by fetching from AuthScape API
+ */
+/**
+ * Generates a sitemap XML response by fetching from the AuthScape API
+ * @param {Object} req - Next.js request object
+ * @param {Object} res - Next.js response object
+ * @param {string} apiUri - The AuthScape API base URI (from process.env.apiUri)
+ * @returns {Promise<void>}
+ */
+function generateSitemap(_x, _x2, _x3) {
+  return _generateSitemap.apply(this, arguments);
+}
+/**
+ * Higher-order function that returns a getServerSideProps function
+ * configured with the API URI from environment variables
+ *
+ * @param {string} apiUri - Optional API URI override (defaults to process.env.apiUri)
+ * @returns {Function} getServerSideProps function
+ */
+function _generateSitemap() {
+  _generateSitemap = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee2(req, res, apiUri) {
+    var protocol, host, domain, encodedDomain, response, sitemap;
+    return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+      while (1) switch (_context2.prev = _context2.next) {
+        case 0:
+          _context2.prev = 0;
+          // Get the domain from the request
+          protocol = req.headers['x-forwarded-proto'] || 'http';
+          host = req.headers.host;
+          domain = "".concat(protocol, "://").concat(host); // URL encode the domain for the API request
+          encodedDomain = encodeURIComponent(domain); // Make a basic HTTP GET request to AuthScape API
+          _context2.next = 7;
+          return fetch("".concat(apiUri, "/api/Sitemap?domain=").concat(encodedDomain));
+        case 7:
+          response = _context2.sent;
+          if (response.ok) {
+            _context2.next = 10;
+            break;
+          }
+          throw new Error("API request failed with status ".concat(response.status));
+        case 10:
+          _context2.next = 12;
+          return response.text();
+        case 12:
+          sitemap = _context2.sent;
+          // Set the appropriate headers for XML
+          res.setHeader('Content-Type', 'text/xml; charset=utf-8');
+          res.setHeader('Cache-Control', 'public, s-maxage=86400, stale-while-revalidate');
+
+          // Send the XML response
+          res.write(sitemap);
+          res.end();
+          return _context2.abrupt("return", {
+            props: {}
+          });
+        case 20:
+          _context2.prev = 20;
+          _context2.t0 = _context2["catch"](0);
+          console.error('AuthScape Sitemap Error:', _context2.t0);
+
+          // Return 500 error
+          res.statusCode = 500;
+          res.setHeader('Content-Type', 'text/plain');
+          res.write('Error generating sitemap');
+          res.end();
+          return _context2.abrupt("return", {
+            props: {}
+          });
+        case 28:
+        case "end":
+          return _context2.stop();
+      }
+    }, _callee2, null, [[0, 20]]);
+  }));
+  return _generateSitemap.apply(this, arguments);
+}
+function createSitemapHandler(apiUri) {
+  return /*#__PURE__*/function () {
+    var _getServerSideProps = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee(_ref) {
+      var req, res, apiBaseUri;
+      return _regeneratorRuntime().wrap(function _callee$(_context) {
+        while (1) switch (_context.prev = _context.next) {
+          case 0:
+            req = _ref.req, res = _ref.res;
+            apiBaseUri = apiUri || process.env.apiUri;
+            if (apiBaseUri) {
+              _context.next = 9;
+              break;
+            }
+            console.error('AuthScape Sitemap Error: apiUri is not configured');
+            res.statusCode = 500;
+            res.setHeader('Content-Type', 'text/plain');
+            res.write('Sitemap configuration error: API URI not set');
+            res.end();
+            return _context.abrupt("return", {
+              props: {}
+            });
+          case 9:
+            _context.next = 11;
+            return generateSitemap(req, res, apiBaseUri);
+          case 11:
+            return _context.abrupt("return", _context.sent);
+          case 12:
+          case "end":
+            return _context.stop();
+        }
+      }, _callee);
+    }));
+    function getServerSideProps(_x4) {
+      return _getServerSideProps.apply(this, arguments);
+    }
+    return getServerSideProps;
+  }();
+}
+var _default = exports["default"] = {
+  generateSitemap: generateSitemap,
+  createSitemapHandler: createSitemapHandler
+};
+"use strict";
+
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
@@ -9360,3 +9492,33 @@ var setCookie = exports.setCookie = function setCookie(name, value) {
     resolve();
   });
 };
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = Sitemap;
+exports.getServerSideProps = void 0;
+var _sitemapService = require("authscape/src/services/sitemapService");
+/**
+ * AuthScape Sitemap.xml Template
+ *
+ * USAGE:
+ * Copy this file to your Next.js pages directory as: pages/sitemap.xml.js
+ *
+ * The sitemap will automatically be generated and available at:
+ * https://yourdomain.com/sitemap.xml
+ *
+ * CONFIGURATION:
+ * Ensure process.env.apiUri is set in your .env.local file:
+ * apiUri=https://your-authscape-api.com
+ */
+
+function Sitemap() {
+  // This component will never render - sitemap is generated server-side
+  return null;
+}
+
+// Export the pre-configured sitemap handler
+// It will automatically use process.env.apiUri from your environment
+var getServerSideProps = exports.getServerSideProps = (0, _sitemapService.createSitemapHandler)();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "authscape",
-  "version": "1.0.714",
+  "version": "1.0.718",
   "description": "",
   "main": "index.js",
   "scripts": {

package/src/services/sitemapService.js

@@ -0,0 +1,86 @@
+/**
+ * AuthScape Sitemap Service
+ * Provides automatic sitemap.xml generation by fetching from AuthScape API
+ */
+
+/**
+ * Generates a sitemap XML response by fetching from the AuthScape API
+ * @param {Object} req - Next.js request object
+ * @param {Object} res - Next.js response object
+ * @param {string} apiUri - The AuthScape API base URI (from process.env.apiUri)
+ * @returns {Promise<void>}
+ */
+export async function generateSitemap(req, res, apiUri) {
+  try {
+    // Get the domain from the request
+    const protocol = req.headers['x-forwarded-proto'] || 'http';
+    const host = req.headers.host;
+    const domain = `${protocol}://${host}`;
+
+    // URL encode the domain for the API request
+    const encodedDomain = encodeURIComponent(domain);
+
+    // Make a basic HTTP GET request to AuthScape API
+    const response = await fetch(`${apiUri}/api/Sitemap?domain=${encodedDomain}`);
+
+    if (!response.ok) {
+      throw new Error(`API request failed with status ${response.status}`);
+    }
+
+    // Get the sitemap XML from the API
+    const sitemap = await response.text();
+
+    // Set the appropriate headers for XML
+    res.setHeader('Content-Type', 'text/xml; charset=utf-8');
+    res.setHeader('Cache-Control', 'public, s-maxage=86400, stale-while-revalidate');
+
+    // Send the XML response
+    res.write(sitemap);
+    res.end();
+
+    return {
+      props: {},
+    };
+  } catch (error) {
+    console.error('AuthScape Sitemap Error:', error);
+
+    // Return 500 error
+    res.statusCode = 500;
+    res.setHeader('Content-Type', 'text/plain');
+    res.write('Error generating sitemap');
+    res.end();
+
+    return {
+      props: {},
+    };
+  }
+}
+
+/**
+ * Higher-order function that returns a getServerSideProps function
+ * configured with the API URI from environment variables
+ *
+ * @param {string} apiUri - Optional API URI override (defaults to process.env.apiUri)
+ * @returns {Function} getServerSideProps function
+ */
+export function createSitemapHandler(apiUri) {
+  return async function getServerSideProps({ req, res }) {
+    const apiBaseUri = apiUri || process.env.apiUri;
+
+    if (!apiBaseUri) {
+      console.error('AuthScape Sitemap Error: apiUri is not configured');
+      res.statusCode = 500;
+      res.setHeader('Content-Type', 'text/plain');
+      res.write('Sitemap configuration error: API URI not set');
+      res.end();
+      return { props: {} };
+    }
+
+    return await generateSitemap(req, res, apiBaseUri);
+  };
+}
+
+export default {
+  generateSitemap,
+  createSitemapHandler
+};

package/src/templates/sitemap.xml.js

@@ -0,0 +1,24 @@
+/**
+ * AuthScape Sitemap.xml Template
+ *
+ * USAGE:
+ * Copy this file to your Next.js pages directory as: pages/sitemap.xml.js
+ *
+ * The sitemap will automatically be generated and available at:
+ * https://yourdomain.com/sitemap.xml
+ *
+ * CONFIGURATION:
+ * Ensure process.env.apiUri is set in your .env.local file:
+ * apiUri=https://your-authscape-api.com
+ */
+
+import { createSitemapHandler } from 'authscape/src/services/sitemapService';
+
+export default function Sitemap() {
+  // This component will never render - sitemap is generated server-side
+  return null;
+}
+
+// Export the pre-configured sitemap handler
+// It will automatically use process.env.apiUri from your environment
+export const getServerSideProps = createSitemapHandler();