@gravito/constellation 1.0.0-alpha.6 → 1.0.0

package/README.md

@@ -4,7 +4,7 @@ title: Constellation
 
 # Constellation
 
-Dynamic and static sitemap generation for Gravito applications.
+Dynamic and static sitemap generation for Gravito applications. Constellation can be used standalone or as the sitemap and route-scanning engine for Luminosity.
 
 **Constellation** provides a flexible way to generate XML sitemaps for your Gravito application, supporting both dynamic generation (via routes) and static generation (for build time). It includes support for Google Sitemap extensions like Images, Videos, News, and i18n alternates.
 

package/README.zh-TW.md

@@ -1,6 +1,6 @@
 # Constellation
 
-> Gravito 的 Sitemap 產生器，支援動態輸出與靜態生成。
+> Gravito 的 Sitemap 產生器，支援動態輸出與靜態生成，可被 Luminosity 作為 sitemap 與路由掃描的工具層使用。
 
 ## 特色
 

package/dist/DiskSitemapStorage-7ZZMGC4K.js

@@ -0,0 +1,6 @@
+import {
+  DiskSitemapStorage
+} from "./chunk-7WHLC3OJ.js";
+export {
+  DiskSitemapStorage
+};

package/dist/chunk-7WHLC3OJ.js

@@ -0,0 +1,56 @@
+// src/storage/DiskSitemapStorage.ts
+import fs from "fs/promises";
+import path from "path";
+function sanitizeFilename(filename) {
+  if (!filename) {
+    throw new Error("Invalid sitemap filename.");
+  }
+  if (filename.includes("\0")) {
+    throw new Error("Invalid sitemap filename.");
+  }
+  if (filename.includes("/") || filename.includes("\\")) {
+    throw new Error("Invalid sitemap filename.");
+  }
+  if (filename.includes("..")) {
+    throw new Error("Invalid sitemap filename.");
+  }
+  return filename;
+}
+var DiskSitemapStorage = class {
+  constructor(outDir, baseUrl) {
+    this.outDir = outDir;
+    this.baseUrl = baseUrl;
+  }
+  async write(filename, content) {
+    const safeName = sanitizeFilename(filename);
+    await fs.mkdir(this.outDir, { recursive: true });
+    await fs.writeFile(path.join(this.outDir, safeName), content);
+  }
+  async read(filename) {
+    try {
+      const safeName = sanitizeFilename(filename);
+      return await fs.readFile(path.join(this.outDir, safeName), "utf-8");
+    } catch {
+      return null;
+    }
+  }
+  async exists(filename) {
+    try {
+      const safeName = sanitizeFilename(filename);
+      await fs.access(path.join(this.outDir, safeName));
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  getUrl(filename) {
+    const safeName = sanitizeFilename(filename);
+    const base = this.baseUrl.endsWith("/") ? this.baseUrl.slice(0, -1) : this.baseUrl;
+    const file = safeName.startsWith("/") ? safeName.slice(1) : safeName;
+    return `${base}/${file}`;
+  }
+};
+
+export {
+  DiskSitemapStorage
+};