@gravito/constellation 3.1.1 → 3.1.3

package/README.md

@@ -13,19 +13,34 @@ Powerful, high-performance SEO and Sitemap orchestration module for **Gravito ap
 ## 🌟 Key Features
 
 ### 🚀 High Performance & Scalability
-- **Streaming Generation**: Uses `SitemapStream` for memory-efficient XML building.
-- **Stream Writing (v3.1+)**: Reduces memory peaks by 40%+ with async iterable streaming to storage.
-- **Gzip Compression (v3.1+)**: Automatically compress sitemaps to reduce file size by 70%+ and save bandwidth.
+- **🪐 Galaxy-Ready Indexing**: Native integration with PlanetCore for universal sitemap management across all Satellites.
+- **✨ Atomic SEO Deployments**: Shadow-processing engine for "Blue-Green" sitemap swaps, ensuring zero downtime for search crawlers.
+- **Streaming Generation**: Uses `SitemapStream` for memory-efficient XML building with 40%+ memory peak reduction.
 - **Auto-Sharding**: Automatically splits large sitemaps into multiple files (50,000 URLs limit) and generates sitemap indexes.
-- **Async Iterators**: Support for streaming data directly from databases via async generators.
-- **Distributed Locking**: Prevents "cache stampedes" in distributed environments (e.g., Kubernetes) using Redis locks.
+- **Distributed Locking**: Plasma-backed Redis locks to prevent "cache stampedes" in multi-node clusters.
 
 ### 🏢 Enterprise SEO Orchestration
 - **Incremental Generation**: Only update modified URLs instead of regenerating the entire sitemap.
-- **Shadow Processing**: Atomic "blue-green" deployments for sitemaps using temporary staging and swapping.
-- **301/302 Redirect Handling**: Intelligent detection and removal/replacement of redirected URLs to ensure search engines only see canonical links.
+- **301/302 Redirect Handling**: Intelligent detection and removal/replacement of redirected URLs.
 - **Cloud Storage Integration**: Built-in support for AWS S3 and Google Cloud Storage (GCS).
 
+## 🌌 Role in Galaxy Architecture
+
+In the **Gravito Galaxy Architecture**, Constellation acts as the **Star Chart (Navigation Layer)**.
+
+- **Galaxy Map**: Aggregates the public-facing "Coodinates" (URLs) of all isolated Satellites, creating a unified map for search engines to navigate the entire ecosystem.
+- **Discovery Pulse**: Works with the `Photon` Sensing Layer to identify and index new content as soon as it is manifested by a Satellite.
+- **SEO Orchestrator**: Coordinates the deployment of metadata across multiple domains and environments, ensuring consistent brand visibility.
+
+```mermaid
+graph TD
+    S1[Satellite: Blog] -- "URLs" --> Const{Constellation Chart}
+    S2[Satellite: Shop] -- "URLs" --> Const
+    Const -->|Stream| S3[(S3 Storage)]
+    Const -->|Index| Google([Search Engines])
+    Const -.->|Lock| Plasma[(Plasma Redis)]
+```
+
 ### 🛠️ Advanced Capabilities
 - **Rich Extensions**: Support for Images, Videos, News, and i18n alternate links (hreflang).
 - **Background Jobs**: Non-blocking generation with persistent progress tracking.
@@ -95,6 +110,14 @@ await sitemap.generate()
 
 ---
 
+## 📚 Documentation
+
+Detailed guides and references for the Galaxy Architecture:
+
+- [🏗️ **Architecture Overview**](./README.md) — SEO and Sitemap orchestration engine.
+- [🛰️ **Galaxy SEO**](./doc/GALAXY_SEO.md) — **NEW**: Multi-satellite sitemaps and shadow deployment.
+- [💎 **Advanced Usage**](#-advanced-usage) — Compression, AWS S3, and streaming.
+
 ## 🏗️ Architecture & Modules
 
 Constellation is composed of several specialized sub-modules:

package/dist/{DiskSitemapStorage-VLN5I24C.js → DiskSitemapStorage-6VXPMKLB.js}

@@ -1,6 +1,6 @@
 import {
   DiskSitemapStorage
-} from "./chunk-3IZTXYU7.js";
+} from "./chunk-O3SCFF44.js";
 export {
   DiskSitemapStorage
 };

package/dist/{chunk-3IZTXYU7.js → chunk-O3SCFF44.js}

@@ -1,32 +1,26 @@
 // src/storage/DiskSitemapStorage.ts
 import { createReadStream, createWriteStream } from "fs";
-import fs from "fs/promises";
 import path from "path";
-import { Readable as Readable2 } from "stream";
+import { Readable } from "stream";
 import { pipeline } from "stream/promises";
+import { getRuntimeAdapter, runtimeMkdir, runtimeReadText } from "@gravito/core";
 
 // src/utils/Compression.ts
-import { Readable } from "stream";
 import { createGzip } from "zlib";
+import { getCompressionAdapter } from "@gravito/core";
 async function compressToBuffer(source, config) {
   const level = config?.level ?? 6;
   if (level < 1 || level > 9) {
     throw new Error(`Invalid compression level: ${level}. Must be between 1 and 9.`);
   }
-  const chunks = [];
-  const gzip = createGzip({ level });
-  const readable = Readable.from(source, { encoding: "utf-8" });
-  try {
-    readable.pipe(gzip);
-    for await (const chunk of gzip) {
-      chunks.push(chunk);
-    }
-    return Buffer.concat(chunks);
-  } catch (error) {
-    readable.destroy();
-    gzip.destroy();
-    throw error;
+  const parts = [];
+  for await (const chunk of source) {
+    parts.push(chunk);
   }
+  const input = new TextEncoder().encode(parts.join(""));
+  const adapter = getCompressionAdapter();
+  const compressed = await adapter.gzip(input, { level });
+  return Buffer.from(compressed);
 }
 function createCompressionStream(config) {
   const level = config?.level ?? 6;
@@ -63,6 +57,7 @@ var DiskSitemapStorage = class {
     this.outDir = outDir;
     this.baseUrl = baseUrl;
   }
+  runtime = getRuntimeAdapter();
   /**
    * Writes sitemap content to a file on the local disk.
    *
@@ -71,8 +66,8 @@ var DiskSitemapStorage = class {
    */
   async write(filename, content) {
     const safeName = sanitizeFilename(filename);
-    await fs.mkdir(this.outDir, { recursive: true });
-    await fs.writeFile(path.join(this.outDir, safeName), content);
+    await runtimeMkdir(this.runtime, this.outDir, { recursive: true });
+    await this.runtime.writeFile(path.join(this.outDir, safeName), content);
   }
   /**
    * 使用串流方式寫入 sitemap 檔案，可選擇性啟用 gzip 壓縮。
@@ -86,10 +81,10 @@ var DiskSitemapStorage = class {
    */
   async writeStream(filename, stream, options) {
     const safeName = sanitizeFilename(options?.compress ? toGzipFilename(filename) : filename);
-    await fs.mkdir(this.outDir, { recursive: true });
+    await runtimeMkdir(this.runtime, this.outDir, { recursive: true });
     const filePath = path.join(this.outDir, safeName);
     const writeStream = createWriteStream(filePath);
-    const readable = Readable2.from(stream, { encoding: "utf-8" });
+    const readable = Readable.from(stream, { encoding: "utf-8" });
     if (options?.compress) {
       const gzip = createCompressionStream();
       await pipeline(readable, gzip, writeStream);
@@ -106,7 +101,7 @@ var DiskSitemapStorage = class {
   async read(filename) {
     try {
       const safeName = sanitizeFilename(filename);
-      return await fs.readFile(path.join(this.outDir, safeName), "utf-8");
+      return await runtimeReadText(this.runtime, path.join(this.outDir, safeName));
     } catch {
       return null;
     }
@@ -121,7 +116,9 @@ var DiskSitemapStorage = class {
     try {
       const safeName = sanitizeFilename(filename);
       const fullPath = path.join(this.outDir, safeName);
-      await fs.access(fullPath);
+      if (!await this.runtime.exists(fullPath)) {
+        return null;
+      }
       const stream = createReadStream(fullPath, { encoding: "utf-8" });
       return stream;
     } catch {
@@ -135,13 +132,8 @@ var DiskSitemapStorage = class {
    * @returns A promise resolving to true if the file exists, false otherwise.
    */
   async exists(filename) {
-    try {
-      const safeName = sanitizeFilename(filename);
-      await fs.access(path.join(this.outDir, safeName));
-      return true;
-    } catch {
-      return false;
-    }
+    const safeName = sanitizeFilename(filename);
+    return this.runtime.exists(path.join(this.outDir, safeName));
   }
   /**
    * Returns the full public URL for a sitemap file.

package/dist/index.cjs

@@ -1,4 +1,3 @@
-"use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -36,20 +35,14 @@ async function compressToBuffer(source, config) {
   if (level < 1 || level > 9) {
     throw new Error(`Invalid compression level: ${level}. Must be between 1 and 9.`);
   }
-  const chunks = [];
-  const gzip = (0, import_node_zlib.createGzip)({ level });
-  const readable = import_node_stream.Readable.from(source, { encoding: "utf-8" });
-  try {
-    readable.pipe(gzip);
-    for await (const chunk of gzip) {
-      chunks.push(chunk);
-    }
-    return Buffer.concat(chunks);
-  } catch (error) {
-    readable.destroy();
-    gzip.destroy();
-    throw error;
+  const parts = [];
+  for await (const chunk of source) {
+    parts.push(chunk);
   }
+  const input = new TextEncoder().encode(parts.join(""));
+  const adapter = (0, import_core.getCompressionAdapter)();
+  const compressed = await adapter.gzip(input, { level });
+  return Buffer.from(compressed);
 }
 function createCompressionStream(config) {
   const level = config?.level ?? 6;
@@ -64,12 +57,11 @@ function toGzipFilename(filename) {
 function fromGzipFilename(filename) {
   return filename.endsWith(".gz") ? filename.slice(0, -3) : filename;
 }
-var import_node_stream, import_node_zlib;
+var import_node_zlib, import_core;
 var init_Compression = __esm({
   "src/utils/Compression.ts"() {
-    "use strict";
-    import_node_stream = require("stream");
     import_node_zlib = require("zlib");
+    import_core = require("@gravito/core");
   }
 });
 
@@ -93,21 +85,21 @@ function sanitizeFilename(filename) {
   }
   return filename;
 }
-var import_node_fs, import_promises, import_node_path, import_node_stream2, import_promises2, DiskSitemapStorage;
+var import_node_fs, import_node_path, import_node_stream, import_promises, import_core4, DiskSitemapStorage;
 var init_DiskSitemapStorage = __esm({
   "src/storage/DiskSitemapStorage.ts"() {
-    "use strict";
     import_node_fs = require("fs");
-    import_promises = __toESM(require("fs/promises"), 1);
     import_node_path = __toESM(require("path"), 1);
-    import_node_stream2 = require("stream");
-    import_promises2 = require("stream/promises");
+    import_node_stream = require("stream");
+    import_promises = require("stream/promises");
+    import_core4 = require("@gravito/core");
     init_Compression();
     DiskSitemapStorage = class {
       constructor(outDir, baseUrl) {
         this.outDir = outDir;
         this.baseUrl = baseUrl;
       }
+      runtime = (0, import_core4.getRuntimeAdapter)();
       /**
        * Writes sitemap content to a file on the local disk.
        *
@@ -116,8 +108,8 @@ var init_DiskSitemapStorage = __esm({
        */
       async write(filename, content) {
         const safeName = sanitizeFilename(filename);
-        await import_promises.default.mkdir(this.outDir, { recursive: true });
-        await import_promises.default.writeFile(import_node_path.default.join(this.outDir, safeName), content);
+        await (0, import_core4.runtimeMkdir)(this.runtime, this.outDir, { recursive: true });
+        await this.runtime.writeFile(import_node_path.default.join(this.outDir, safeName), content);
       }
       /**
        * 使用串流方式寫入 sitemap 檔案，可選擇性啟用 gzip 壓縮。
@@ -131,15 +123,15 @@ var init_DiskSitemapStorage = __esm({
        */
       async writeStream(filename, stream, options) {
         const safeName = sanitizeFilename(options?.compress ? toGzipFilename(filename) : filename);
-        await import_promises.default.mkdir(this.outDir, { recursive: true });
+        await (0, import_core4.runtimeMkdir)(this.runtime, this.outDir, { recursive: true });
         const filePath = import_node_path.default.join(this.outDir, safeName);
         const writeStream = (0, import_node_fs.createWriteStream)(filePath);
-        const readable = import_node_stream2.Readable.from(stream, { encoding: "utf-8" });
+        const readable = import_node_stream.Readable.from(stream, { encoding: "utf-8" });
         if (options?.compress) {
           const gzip = createCompressionStream();
-          await (0, import_promises2.pipeline)(readable, gzip, writeStream);
+          await (0, import_promises.pipeline)(readable, gzip, writeStream);
         } else {
-          await (0, import_promises2.pipeline)(readable, writeStream);
+          await (0, import_promises.pipeline)(readable, writeStream);
         }
       }
       /**
@@ -151,7 +143,7 @@ var init_DiskSitemapStorage = __esm({
       async read(filename) {
         try {
           const safeName = sanitizeFilename(filename);
-          return await import_promises.default.readFile(import_node_path.default.join(this.outDir, safeName), "utf-8");
+          return await (0, import_core4.runtimeReadText)(this.runtime, import_node_path.default.join(this.outDir, safeName));
         } catch {
           return null;
         }
@@ -166,7 +158,9 @@ var init_DiskSitemapStorage = __esm({
         try {
           const safeName = sanitizeFilename(filename);
           const fullPath = import_node_path.default.join(this.outDir, safeName);
-          await import_promises.default.access(fullPath);
+          if (!await this.runtime.exists(fullPath)) {
+            return null;
+          }
           const stream = (0, import_node_fs.createReadStream)(fullPath, { encoding: "utf-8" });
           return stream;
         } catch {
@@ -180,13 +174,8 @@ var init_DiskSitemapStorage = __esm({
        * @returns A promise resolving to true if the file exists, false otherwise.
        */
       async exists(filename) {
-        try {
-          const safeName = sanitizeFilename(filename);
-          await import_promises.default.access(import_node_path.default.join(this.outDir, safeName));
-          return true;
-        } catch {
-          return false;
-        }
+        const safeName = sanitizeFilename(filename);
+        return this.runtime.exists(import_node_path.default.join(this.outDir, safeName));
       }
       /**
        * Returns the full public URL for a sitemap file.
@@ -419,10 +408,6 @@ var RedisChangeTracker = class {
 
 // src/core/DiffCalculator.ts
 var DiffCalculator = class {
-  batchSize;
-  constructor(options = {}) {
-    this.batchSize = options.batchSize || 1e4;
-  }
   /**
    * Calculates the difference between two sets of sitemap entries.
    *
@@ -633,9 +618,11 @@ var ShadowProcessor = class {
 };
 
 // src/core/SitemapIndex.ts
+var import_core2 = require("@gravito/core");
 var SitemapIndex = class {
   options;
   entries = [];
+  escapeHtml = (0, import_core2.getEscapeHtml)();
   constructor(options) {
     this.options = { ...options };
     if (this.options.baseUrl.endsWith("/")) {
@@ -691,7 +678,7 @@ var SitemapIndex = class {
         loc = baseUrl + loc;
       }
       xml += `${indent}<sitemap>${nl}`;
-      xml += `${subIndent}<loc>${this.escape(loc)}</loc>${nl}`;
+      xml += `${subIndent}<loc>${this.escapeHtml(loc)}</loc>${nl}`;
       if (entry.lastmod) {
         const date = entry.lastmod instanceof Date ? entry.lastmod : new Date(entry.lastmod);
         xml += `${subIndent}<lastmod>${date.toISOString().split("T")[0]}</lastmod>${nl}`;
@@ -704,12 +691,10 @@ var SitemapIndex = class {
   /**
    * Escapes special XML characters in a string.
    */
-  escape(str) {
-    return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
-  }
 };
 
 // src/core/SitemapStream.ts
+var import_core3 = require("@gravito/core");
 var SitemapStream = class {
   options;
   entries = [];
@@ -719,6 +704,7 @@ var SitemapStream = class {
     hasNews: false,
     hasAlternates: false
   };
+  escapeHtml = (0, import_core3.getEscapeHtml)();
   constructor(options) {
     this.options = { ...options };
     if (this.options.baseUrl.endsWith("/")) {
@@ -798,8 +784,19 @@ var SitemapStream = class {
     yield '<?xml version="1.0" encoding="UTF-8"?>\n';
     yield this.buildUrlsetOpenTag();
     const { baseUrl, pretty } = this.options;
+    let buffer = "";
+    let count = 0;
     for (const entry of this.entries) {
-      yield this.renderUrl(entry, baseUrl, pretty);
+      buffer += this.renderUrl(entry, baseUrl, pretty);
+      count++;
+      if (count >= 5e3) {
+        yield buffer;
+        buffer = "";
+        count = 0;
+      }
+    }
+    if (buffer) {
+      yield buffer;
     }
     yield "</urlset>";
   }
@@ -852,7 +849,7 @@ var SitemapStream = class {
       loc = baseUrl + loc;
     }
     parts.push(`${indent}<url>${nl}`);
-    parts.push(`${subIndent}<loc>${this.escape(loc)}</loc>${nl}`);
+    parts.push(`${subIndent}<loc>${this.escapeHtml(loc)}</loc>${nl}`);
     if (entry.lastmod) {
       const date = entry.lastmod instanceof Date ? entry.lastmod : new Date(entry.lastmod);
       parts.push(`${subIndent}<lastmod>${date.toISOString().split("T")[0]}</lastmod>${nl}`);
@@ -873,7 +870,7 @@ var SitemapStream = class {
           altLoc = baseUrl + altLoc;
         }
         parts.push(
-          `${subIndent}<xhtml:link rel="alternate" hreflang="${alt.lang}" href="${this.escape(altLoc)}"/>${nl}`
+          `${subIndent}<xhtml:link rel="alternate" hreflang="${alt.lang}" href="${this.escapeHtml(altLoc)}"/>${nl}`
         );
       }
     }
@@ -886,7 +883,7 @@ var SitemapStream = class {
         canonicalUrl = baseUrl + canonicalUrl;
       }
       parts.push(
-        `${subIndent}<xhtml:link rel="canonical" href="${this.escape(canonicalUrl)}"/>${nl}`
+        `${subIndent}<xhtml:link rel="canonical" href="${this.escapeHtml(canonicalUrl)}"/>${nl}`
       );
     }
     if (entry.redirect && !entry.redirect.canonical) {
@@ -904,23 +901,23 @@ var SitemapStream = class {
           loc2 = baseUrl + loc2;
         }
         parts.push(`${subIndent}<image:image>${nl}`);
-        parts.push(`${subIndent}  <image:loc>${this.escape(loc2)}</image:loc>${nl}`);
+        parts.push(`${subIndent}  <image:loc>${this.escapeHtml(loc2)}</image:loc>${nl}`);
         if (img.title) {
-          parts.push(`${subIndent}  <image:title>${this.escape(img.title)}</image:title>${nl}`);
+          parts.push(`${subIndent}  <image:title>${this.escapeHtml(img.title)}</image:title>${nl}`);
         }
         if (img.caption) {
           parts.push(
-            `${subIndent}  <image:caption>${this.escape(img.caption)}</image:caption>${nl}`
+            `${subIndent}  <image:caption>${this.escapeHtml(img.caption)}</image:caption>${nl}`
           );
         }
         if (img.geo_location) {
           parts.push(
-            `${subIndent}  <image:geo_location>${this.escape(img.geo_location)}</image:geo_location>${nl}`
+            `${subIndent}  <image:geo_location>${this.escapeHtml(img.geo_location)}</image:geo_location>${nl}`
           );
         }
         if (img.license) {
           parts.push(
-            `${subIndent}  <image:license>${this.escape(img.license)}</image:license>${nl}`
+            `${subIndent}  <image:license>${this.escapeHtml(img.license)}</image:license>${nl}`
           );
         }
         parts.push(`${subIndent}</image:image>${nl}`);
@@ -930,20 +927,20 @@ var SitemapStream = class {
       for (const video of entry.videos) {
         parts.push(`${subIndent}<video:video>${nl}`);
         parts.push(
-          `${subIndent}  <video:thumbnail_loc>${this.escape(video.thumbnail_loc)}</video:thumbnail_loc>${nl}`
+          `${subIndent}  <video:thumbnail_loc>${this.escapeHtml(video.thumbnail_loc)}</video:thumbnail_loc>${nl}`
         );
-        parts.push(`${subIndent}  <video:title>${this.escape(video.title)}</video:title>${nl}`);
+        parts.push(`${subIndent}  <video:title>${this.escapeHtml(video.title)}</video:title>${nl}`);
         parts.push(
-          `${subIndent}  <video:description>${this.escape(video.description)}</video:description>${nl}`
+          `${subIndent}  <video:description>${this.escapeHtml(video.description)}</video:description>${nl}`
         );
         if (video.content_loc) {
           parts.push(
-            `${subIndent}  <video:content_loc>${this.escape(video.content_loc)}</video:content_loc>${nl}`
+            `${subIndent}  <video:content_loc>${this.escapeHtml(video.content_loc)}</video:content_loc>${nl}`
           );
         }
         if (video.player_loc) {
           parts.push(
-            `${subIndent}  <video:player_loc>${this.escape(video.player_loc)}</video:player_loc>${nl}`
+            `${subIndent}  <video:player_loc>${this.escapeHtml(video.player_loc)}</video:player_loc>${nl}`
           );
         }
         if (video.duration) {
@@ -965,7 +962,7 @@ var SitemapStream = class {
         }
         if (video.tag) {
           for (const tag of video.tag) {
-            parts.push(`${subIndent}  <video:tag>${this.escape(tag)}</video:tag>${nl}`);
+            parts.push(`${subIndent}  <video:tag>${this.escapeHtml(tag)}</video:tag>${nl}`);
           }
         }
         parts.push(`${subIndent}</video:video>${nl}`);
@@ -975,25 +972,25 @@ var SitemapStream = class {
       parts.push(`${subIndent}<news:news>${nl}`);
       parts.push(`${subIndent}  <news:publication>${nl}`);
       parts.push(
-        `${subIndent}    <news:name>${this.escape(entry.news.publication.name)}</news:name>${nl}`
+        `${subIndent}    <news:name>${this.escapeHtml(entry.news.publication.name)}</news:name>${nl}`
       );
       parts.push(
-        `${subIndent}    <news:language>${this.escape(entry.news.publication.language)}</news:language>${nl}`
+        `${subIndent}    <news:language>${this.escapeHtml(entry.news.publication.language)}</news:language>${nl}`
       );
       parts.push(`${subIndent}  </news:publication>${nl}`);
       const pubDate = entry.news.publication_date instanceof Date ? entry.news.publication_date : new Date(entry.news.publication_date);
       parts.push(
         `${subIndent}  <news:publication_date>${pubDate.toISOString()}</news:publication_date>${nl}`
       );
-      parts.push(`${subIndent}  <news:title>${this.escape(entry.news.title)}</news:title>${nl}`);
+      parts.push(`${subIndent}  <news:title>${this.escapeHtml(entry.news.title)}</news:title>${nl}`);
       if (entry.news.genres) {
         parts.push(
-          `${subIndent}  <news:genres>${this.escape(entry.news.genres)}</news:genres>${nl}`
+          `${subIndent}  <news:genres>${this.escapeHtml(entry.news.genres)}</news:genres>${nl}`
         );
       }
       if (entry.news.keywords) {
         parts.push(
-          `${subIndent}  <news:keywords>${entry.news.keywords.map((k) => this.escape(k)).join(", ")}</news:keywords>${nl}`
+          `${subIndent}  <news:keywords>${entry.news.keywords.map((k) => this.escapeHtml(k)).join(", ")}</news:keywords>${nl}`
         );
       }
       parts.push(`${subIndent}</news:news>${nl}`);
@@ -1004,9 +1001,6 @@ var SitemapStream = class {
   /**
    * Escapes special XML characters in a string.
    */
-  escape(str) {
-    return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
-  }
   /**
    * Returns all entries currently in the stream.
    *
@@ -1326,7 +1320,6 @@ var SitemapParser = class {
 var IncrementalGenerator = class {
   options;
   changeTracker;
-  diffCalculator;
   generator;
   mutex = new Mutex();
   constructor(options) {
@@ -1336,7 +1329,6 @@ var IncrementalGenerator = class {
       ...options
     };
     this.changeTracker = this.options.changeTracker;
-    this.diffCalculator = this.options.diffCalculator || new DiffCalculator();
     this.generator = new SitemapGenerator(this.options);
   }
   /**
@@ -1584,6 +1576,7 @@ var ProgressTracker = class {
           console.error("[ProgressTracker] Failed to flush progress:", err);
         });
       }, this.updateInterval);
+      this.updateTimer.unref?.();
     }
   }
   /**
@@ -2041,7 +2034,6 @@ var MemoryLock = class {
 };
 
 // src/locks/RedisLock.ts
-var import_node_crypto = require("crypto");
 var RedisLock = class {
   /**
    * Constructs a new RedisLock instance with the specified configuration.
@@ -2074,7 +2066,7 @@ var RedisLock = class {
    * UUIDs are sufficiently random to prevent lock hijacking across instances.
    * However, they are stored in plain text in Redis (not encrypted).
    */
-  lockId = (0, import_node_crypto.randomUUID)();
+  lockId = crypto.randomUUID();
   /**
    * Redis key prefix for all locks acquired through this instance.
    *
@@ -2304,9 +2296,6 @@ var RedisLock = class {
   }
 };
 
-// src/OrbitSitemap.ts
-var import_node_crypto2 = require("crypto");
-
 // src/redirect/RedirectHandler.ts
 var RedirectHandler = class {
   options;
@@ -2321,7 +2310,6 @@ var RedirectHandler = class {
    */
   async processEntries(entries) {
     const { manager, strategy, followChains, maxChainLength } = this.options;
-    const _processedEntries = [];
     const redirectMap = /* @__PURE__ */ new Map();
     for (const entry of entries) {
       const redirectTarget = await manager.resolve(entry.url, followChains, maxChainLength);
@@ -2745,7 +2733,7 @@ var OrbitSitemap = class _OrbitSitemap {
       throw new Error("generateAsync() can only be called in static mode");
     }
     const opts = this.options;
-    const jobId = (0, import_node_crypto2.randomUUID)();
+    const jobId = crypto.randomUUID();
     let storage = opts.storage;
     if (!storage) {
       const { DiskSitemapStorage: DiskSitemapStorage2 } = await Promise.resolve().then(() => (init_DiskSitemapStorage(), DiskSitemapStorage_exports));
@@ -3002,7 +2990,11 @@ var RedirectDetector = class {
     }
     try {
       const { connection, table, columns } = database;
-      const query = `SELECT ${columns.from}, ${columns.to}, ${columns.type} FROM ${table} WHERE ${columns.from} = ? LIMIT 1`;
+      const safeTable = this.assertSafeIdentifier(table);
+      const safeFrom = this.assertSafeIdentifier(columns.from);
+      const safeTo = this.assertSafeIdentifier(columns.to);
+      const safeType = this.assertSafeIdentifier(columns.type);
+      const query = `SELECT ${safeFrom}, ${safeTo}, ${safeType} FROM ${safeTable} WHERE ${safeFrom} = ? LIMIT 1`;
       const results = await connection.query(query, [url]);
       if (results.length === 0) {
         return null;
@@ -3026,8 +3018,8 @@ var RedirectDetector = class {
       return null;
     }
     try {
-      const fs2 = await import("fs/promises");
-      const data = await fs2.readFile(config.path, "utf-8");
+      const fs = await import("fs/promises");
+      const data = await fs.readFile(config.path, "utf-8");
       const redirects = JSON.parse(data);
       const rule = redirects.find((r) => r.from === url);
       return rule || null;
@@ -3048,6 +3040,7 @@ var RedirectDetector = class {
       const timeout = autoDetect.timeout || 5e3;
       const controller = new AbortController();
       const timeoutId = setTimeout(() => controller.abort(), timeout);
+      timeoutId.unref?.();
       try {
         const response = await fetch(fullUrl, {
           method: "HEAD",
@@ -3089,6 +3082,12 @@ var RedirectDetector = class {
       expires: Date.now() + ttl
     });
   }
+  assertSafeIdentifier(identifier) {
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(identifier)) {
+      throw new Error(`Invalid database identifier: ${identifier}`);
+    }
+    return identifier;
+  }
 };
 
 // src/redirect/RedirectManager.ts
@@ -3278,8 +3277,8 @@ var RedisRedirectManager = class {
 init_DiskSitemapStorage();
 
 // src/storage/GCPSitemapStorage.ts
-var import_node_stream3 = require("stream");
-var import_promises3 = require("stream/promises");
+var import_node_stream2 = require("stream");
+var import_promises2 = require("stream/promises");
 init_Compression();
 var GCPSitemapStorage = class {
   bucket;
@@ -3357,12 +3356,12 @@ var GCPSitemapStorage = class {
         cacheControl: "public, max-age=3600"
       }
     });
-    const readable = import_node_stream3.Readable.from(stream, { encoding: "utf-8" });
+    const readable = import_node_stream2.Readable.from(stream, { encoding: "utf-8" });
     if (options?.compress) {
       const gzip = createCompressionStream();
-      await (0, import_promises3.pipeline)(readable, gzip, writeStream);
+      await (0, import_promises2.pipeline)(readable, gzip, writeStream);
     } else {
-      await (0, import_promises3.pipeline)(readable, writeStream);
+      await (0, import_promises2.pipeline)(readable, writeStream);
     }
   }
   /**
@@ -3487,7 +3486,6 @@ var GCPSitemapStorage = class {
     });
     for (const shadowFile of shadowFiles) {
       const originalKey = shadowFile.name.replace(/\.shadow\.[^/]+$/, "");
-      const _originalFilename = originalKey.replace(prefix, "");
       if (this.shadowMode === "atomic") {
         await shadowFile.copy(bucket.file(originalKey));
         await shadowFile.delete();
@@ -3975,7 +3973,6 @@ var S3SitemapStorage = class {
         continue;
       }
       const originalKey = shadowFile.Key.replace(/\.shadow\.[^/]+$/, "");
-      const _originalFilename = originalKey.replace(prefix, "");
       if (this.shadowMode === "atomic") {
         await s3.client.send(
           new s3.CopyObjectCommand({

package/dist/index.d.cts

@@ -677,16 +677,6 @@ interface DiffResult {
     /** URLs that were present in the old set but are missing from the new one. */
     removed: string[];
 }
-/**
- * Options for configuring the `DiffCalculator`.
- *
- * @public
- * @since 3.0.0
- */
-interface DiffCalculatorOptions {
-    /** Batch size for processing large datasets. @default 10000 */
-    batchSize?: number;
-}
 /**
  * DiffCalculator compares two sets of sitemap entries to identify changes.
  *
@@ -698,8 +688,6 @@ interface DiffCalculatorOptions {
  * @since 3.0.0
  */
 declare class DiffCalculator {
-    private batchSize;
-    constructor(options?: DiffCalculatorOptions);
     /**
      * Calculates the difference between two sets of sitemap entries.
      *
@@ -922,7 +910,6 @@ interface IncrementalGeneratorOptions extends SitemapGeneratorOptions {
 declare class IncrementalGenerator {
     private options;
     private changeTracker;
-    private diffCalculator;
     private generator;
     private mutex;
     constructor(options: IncrementalGeneratorOptions);
@@ -1063,6 +1050,7 @@ declare class ProgressTracker {
 declare class SitemapIndex {
     private options;
     private entries;
+    private escapeHtml;
     constructor(options: SitemapStreamOptions);
     /**
      * Adds a single entry to the sitemap index.
@@ -1084,10 +1072,6 @@ declare class SitemapIndex {
      * @returns The complete XML string for the sitemap index.
      */
     toXML(): string;
-    /**
-     * Escapes special XML characters in a string.
-     */
-    private escape;
 }
 
 /**
@@ -1114,6 +1098,7 @@ declare class SitemapStream {
     private options;
     private entries;
     private flags;
+    private escapeHtml;
     constructor(options: SitemapStreamOptions);
     /**
      * Adds a single entry to the sitemap stream.
@@ -1173,7 +1158,6 @@ declare class SitemapStream {
     /**
      * Escapes special XML characters in a string.
      */
-    private escape;
     /**
      * Returns all entries currently in the stream.
      *
@@ -2341,6 +2325,7 @@ declare class RedirectDetector {
      * Caches the detection result for a URL.
      */
     private cacheResult;
+    private assertSafeIdentifier;
 }
 
 /**
@@ -2555,6 +2540,7 @@ declare class RedisRedirectManager implements RedirectManager {
 declare class DiskSitemapStorage implements SitemapStorage {
     private outDir;
     private baseUrl;
+    private runtime;
     constructor(outDir: string, baseUrl: string);
     /**
      * Writes sitemap content to a file on the local disk.
@@ -3065,6 +3051,10 @@ interface CompressionConfig {
  * 將 AsyncIterable<string> 壓縮為 Buffer。
  * 適用於需要完整壓縮結果的場景（如 S3 Upload）。
  *
+ * 使用 RuntimeCompressionAdapter 自動選擇最佳壓縮實作：
+ * - Bun: 原生 C++ 壓縮（2-5x 更快）
+ * - Node.js: node:zlib fallback
+ *
  * @param source - 輸入的字串串流
  * @param config - 壓縮設定
  * @returns 壓縮後的 Buffer

package/dist/index.d.ts

@@ -677,16 +677,6 @@ interface DiffResult {
     /** URLs that were present in the old set but are missing from the new one. */
     removed: string[];
 }
-/**
- * Options for configuring the `DiffCalculator`.
- *
- * @public
- * @since 3.0.0
- */
-interface DiffCalculatorOptions {
-    /** Batch size for processing large datasets. @default 10000 */
-    batchSize?: number;
-}
 /**
  * DiffCalculator compares two sets of sitemap entries to identify changes.
  *
@@ -698,8 +688,6 @@ interface DiffCalculatorOptions {
  * @since 3.0.0
  */
 declare class DiffCalculator {
-    private batchSize;
-    constructor(options?: DiffCalculatorOptions);
     /**
      * Calculates the difference between two sets of sitemap entries.
      *
@@ -922,7 +910,6 @@ interface IncrementalGeneratorOptions extends SitemapGeneratorOptions {
 declare class IncrementalGenerator {
     private options;
     private changeTracker;
-    private diffCalculator;
     private generator;
     private mutex;
     constructor(options: IncrementalGeneratorOptions);
@@ -1063,6 +1050,7 @@ declare class ProgressTracker {
 declare class SitemapIndex {
     private options;
     private entries;
+    private escapeHtml;
     constructor(options: SitemapStreamOptions);
     /**
      * Adds a single entry to the sitemap index.
@@ -1084,10 +1072,6 @@ declare class SitemapIndex {
      * @returns The complete XML string for the sitemap index.
      */
     toXML(): string;
-    /**
-     * Escapes special XML characters in a string.
-     */
-    private escape;
 }
 
 /**
@@ -1114,6 +1098,7 @@ declare class SitemapStream {
     private options;
     private entries;
     private flags;
+    private escapeHtml;
     constructor(options: SitemapStreamOptions);
     /**
      * Adds a single entry to the sitemap stream.
@@ -1173,7 +1158,6 @@ declare class SitemapStream {
     /**
      * Escapes special XML characters in a string.
      */
-    private escape;
     /**
      * Returns all entries currently in the stream.
      *
@@ -2341,6 +2325,7 @@ declare class RedirectDetector {
      * Caches the detection result for a URL.
      */
     private cacheResult;
+    private assertSafeIdentifier;
 }
 
 /**
@@ -2555,6 +2540,7 @@ declare class RedisRedirectManager implements RedirectManager {
 declare class DiskSitemapStorage implements SitemapStorage {
     private outDir;
     private baseUrl;
+    private runtime;
     constructor(outDir: string, baseUrl: string);
     /**
      * Writes sitemap content to a file on the local disk.
@@ -3065,6 +3051,10 @@ interface CompressionConfig {
  * 將 AsyncIterable<string> 壓縮為 Buffer。
  * 適用於需要完整壓縮結果的場景（如 S3 Upload）。
  *
+ * 使用 RuntimeCompressionAdapter 自動選擇最佳壓縮實作：
+ * - Bun: 原生 C++ 壓縮（2-5x 更快）
+ * - Node.js: node:zlib fallback
+ *
  * @param source - 輸入的字串串流
  * @param config - 壓縮設定
  * @returns 壓縮後的 Buffer

package/dist/index.js

@@ -4,7 +4,7 @@ import {
   createCompressionStream,
   fromGzipFilename,
   toGzipFilename
-} from "./chunk-3IZTXYU7.js";
+} from "./chunk-O3SCFF44.js";
 
 // src/core/ChangeTracker.ts
 var MemoryChangeTracker = class {
@@ -185,10 +185,6 @@ var RedisChangeTracker = class {
 
 // src/core/DiffCalculator.ts
 var DiffCalculator = class {
-  batchSize;
-  constructor(options = {}) {
-    this.batchSize = options.batchSize || 1e4;
-  }
   /**
    * Calculates the difference between two sets of sitemap entries.
    *
@@ -396,9 +392,11 @@ var ShadowProcessor = class {
 };
 
 // src/core/SitemapIndex.ts
+import { getEscapeHtml } from "@gravito/core";
 var SitemapIndex = class {
   options;
   entries = [];
+  escapeHtml = getEscapeHtml();
   constructor(options) {
     this.options = { ...options };
     if (this.options.baseUrl.endsWith("/")) {
@@ -454,7 +452,7 @@ var SitemapIndex = class {
         loc = baseUrl + loc;
       }
       xml += `${indent}<sitemap>${nl}`;
-      xml += `${subIndent}<loc>${this.escape(loc)}</loc>${nl}`;
+      xml += `${subIndent}<loc>${this.escapeHtml(loc)}</loc>${nl}`;
       if (entry.lastmod) {
         const date = entry.lastmod instanceof Date ? entry.lastmod : new Date(entry.lastmod);
         xml += `${subIndent}<lastmod>${date.toISOString().split("T")[0]}</lastmod>${nl}`;
@@ -467,12 +465,10 @@ var SitemapIndex = class {
   /**
    * Escapes special XML characters in a string.
    */
-  escape(str) {
-    return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
-  }
 };
 
 // src/core/SitemapStream.ts
+import { getEscapeHtml as getEscapeHtml2 } from "@gravito/core";
 var SitemapStream = class {
   options;
   entries = [];
@@ -482,6 +478,7 @@ var SitemapStream = class {
     hasNews: false,
     hasAlternates: false
   };
+  escapeHtml = getEscapeHtml2();
   constructor(options) {
     this.options = { ...options };
     if (this.options.baseUrl.endsWith("/")) {
@@ -561,8 +558,19 @@ var SitemapStream = class {
     yield '<?xml version="1.0" encoding="UTF-8"?>\n';
     yield this.buildUrlsetOpenTag();
     const { baseUrl, pretty } = this.options;
+    let buffer = "";
+    let count = 0;
     for (const entry of this.entries) {
-      yield this.renderUrl(entry, baseUrl, pretty);
+      buffer += this.renderUrl(entry, baseUrl, pretty);
+      count++;
+      if (count >= 5e3) {
+        yield buffer;
+        buffer = "";
+        count = 0;
+      }
+    }
+    if (buffer) {
+      yield buffer;
     }
     yield "</urlset>";
   }
@@ -615,7 +623,7 @@ var SitemapStream = class {
       loc = baseUrl + loc;
     }
     parts.push(`${indent}<url>${nl}`);
-    parts.push(`${subIndent}<loc>${this.escape(loc)}</loc>${nl}`);
+    parts.push(`${subIndent}<loc>${this.escapeHtml(loc)}</loc>${nl}`);
     if (entry.lastmod) {
       const date = entry.lastmod instanceof Date ? entry.lastmod : new Date(entry.lastmod);
       parts.push(`${subIndent}<lastmod>${date.toISOString().split("T")[0]}</lastmod>${nl}`);
@@ -636,7 +644,7 @@ var SitemapStream = class {
           altLoc = baseUrl + altLoc;
         }
         parts.push(
-          `${subIndent}<xhtml:link rel="alternate" hreflang="${alt.lang}" href="${this.escape(altLoc)}"/>${nl}`
+          `${subIndent}<xhtml:link rel="alternate" hreflang="${alt.lang}" href="${this.escapeHtml(altLoc)}"/>${nl}`
         );
       }
     }
@@ -649,7 +657,7 @@ var SitemapStream = class {
         canonicalUrl = baseUrl + canonicalUrl;
       }
       parts.push(
-        `${subIndent}<xhtml:link rel="canonical" href="${this.escape(canonicalUrl)}"/>${nl}`
+        `${subIndent}<xhtml:link rel="canonical" href="${this.escapeHtml(canonicalUrl)}"/>${nl}`
       );
     }
     if (entry.redirect && !entry.redirect.canonical) {
@@ -667,23 +675,23 @@ var SitemapStream = class {
           loc2 = baseUrl + loc2;
         }
         parts.push(`${subIndent}<image:image>${nl}`);
-        parts.push(`${subIndent}  <image:loc>${this.escape(loc2)}</image:loc>${nl}`);
+        parts.push(`${subIndent}  <image:loc>${this.escapeHtml(loc2)}</image:loc>${nl}`);
         if (img.title) {
-          parts.push(`${subIndent}  <image:title>${this.escape(img.title)}</image:title>${nl}`);
+          parts.push(`${subIndent}  <image:title>${this.escapeHtml(img.title)}</image:title>${nl}`);
         }
         if (img.caption) {
           parts.push(
-            `${subIndent}  <image:caption>${this.escape(img.caption)}</image:caption>${nl}`
+            `${subIndent}  <image:caption>${this.escapeHtml(img.caption)}</image:caption>${nl}`
           );
         }
         if (img.geo_location) {
           parts.push(
-            `${subIndent}  <image:geo_location>${this.escape(img.geo_location)}</image:geo_location>${nl}`
+            `${subIndent}  <image:geo_location>${this.escapeHtml(img.geo_location)}</image:geo_location>${nl}`
           );
         }
         if (img.license) {
           parts.push(
-            `${subIndent}  <image:license>${this.escape(img.license)}</image:license>${nl}`
+            `${subIndent}  <image:license>${this.escapeHtml(img.license)}</image:license>${nl}`
           );
         }
         parts.push(`${subIndent}</image:image>${nl}`);
@@ -693,20 +701,20 @@ var SitemapStream = class {
       for (const video of entry.videos) {
         parts.push(`${subIndent}<video:video>${nl}`);
         parts.push(
-          `${subIndent}  <video:thumbnail_loc>${this.escape(video.thumbnail_loc)}</video:thumbnail_loc>${nl}`
+          `${subIndent}  <video:thumbnail_loc>${this.escapeHtml(video.thumbnail_loc)}</video:thumbnail_loc>${nl}`
         );
-        parts.push(`${subIndent}  <video:title>${this.escape(video.title)}</video:title>${nl}`);
+        parts.push(`${subIndent}  <video:title>${this.escapeHtml(video.title)}</video:title>${nl}`);
         parts.push(
-          `${subIndent}  <video:description>${this.escape(video.description)}</video:description>${nl}`
+          `${subIndent}  <video:description>${this.escapeHtml(video.description)}</video:description>${nl}`
         );
         if (video.content_loc) {
           parts.push(
-            `${subIndent}  <video:content_loc>${this.escape(video.content_loc)}</video:content_loc>${nl}`
+            `${subIndent}  <video:content_loc>${this.escapeHtml(video.content_loc)}</video:content_loc>${nl}`
           );
         }
         if (video.player_loc) {
           parts.push(
-            `${subIndent}  <video:player_loc>${this.escape(video.player_loc)}</video:player_loc>${nl}`
+            `${subIndent}  <video:player_loc>${this.escapeHtml(video.player_loc)}</video:player_loc>${nl}`
           );
         }
         if (video.duration) {
@@ -728,7 +736,7 @@ var SitemapStream = class {
         }
         if (video.tag) {
           for (const tag of video.tag) {
-            parts.push(`${subIndent}  <video:tag>${this.escape(tag)}</video:tag>${nl}`);
+            parts.push(`${subIndent}  <video:tag>${this.escapeHtml(tag)}</video:tag>${nl}`);
           }
         }
         parts.push(`${subIndent}</video:video>${nl}`);
@@ -738,25 +746,25 @@ var SitemapStream = class {
       parts.push(`${subIndent}<news:news>${nl}`);
       parts.push(`${subIndent}  <news:publication>${nl}`);
       parts.push(
-        `${subIndent}    <news:name>${this.escape(entry.news.publication.name)}</news:name>${nl}`
+        `${subIndent}    <news:name>${this.escapeHtml(entry.news.publication.name)}</news:name>${nl}`
       );
       parts.push(
-        `${subIndent}    <news:language>${this.escape(entry.news.publication.language)}</news:language>${nl}`
+        `${subIndent}    <news:language>${this.escapeHtml(entry.news.publication.language)}</news:language>${nl}`
       );
       parts.push(`${subIndent}  </news:publication>${nl}`);
       const pubDate = entry.news.publication_date instanceof Date ? entry.news.publication_date : new Date(entry.news.publication_date);
       parts.push(
         `${subIndent}  <news:publication_date>${pubDate.toISOString()}</news:publication_date>${nl}`
       );
-      parts.push(`${subIndent}  <news:title>${this.escape(entry.news.title)}</news:title>${nl}`);
+      parts.push(`${subIndent}  <news:title>${this.escapeHtml(entry.news.title)}</news:title>${nl}`);
       if (entry.news.genres) {
         parts.push(
-          `${subIndent}  <news:genres>${this.escape(entry.news.genres)}</news:genres>${nl}`
+          `${subIndent}  <news:genres>${this.escapeHtml(entry.news.genres)}</news:genres>${nl}`
         );
       }
       if (entry.news.keywords) {
         parts.push(
-          `${subIndent}  <news:keywords>${entry.news.keywords.map((k) => this.escape(k)).join(", ")}</news:keywords>${nl}`
+          `${subIndent}  <news:keywords>${entry.news.keywords.map((k) => this.escapeHtml(k)).join(", ")}</news:keywords>${nl}`
         );
       }
       parts.push(`${subIndent}</news:news>${nl}`);
@@ -767,9 +775,6 @@ var SitemapStream = class {
   /**
    * Escapes special XML characters in a string.
    */
-  escape(str) {
-    return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
-  }
   /**
    * Returns all entries currently in the stream.
    *
@@ -1089,7 +1094,6 @@ var SitemapParser = class {
 var IncrementalGenerator = class {
   options;
   changeTracker;
-  diffCalculator;
   generator;
   mutex = new Mutex();
   constructor(options) {
@@ -1099,7 +1103,6 @@ var IncrementalGenerator = class {
       ...options
     };
     this.changeTracker = this.options.changeTracker;
-    this.diffCalculator = this.options.diffCalculator || new DiffCalculator();
     this.generator = new SitemapGenerator(this.options);
   }
   /**
@@ -1347,6 +1350,7 @@ var ProgressTracker = class {
           console.error("[ProgressTracker] Failed to flush progress:", err);
         });
       }, this.updateInterval);
+      this.updateTimer.unref?.();
     }
   }
   /**
@@ -1804,7 +1808,6 @@ var MemoryLock = class {
 };
 
 // src/locks/RedisLock.ts
-import { randomUUID } from "crypto";
 var RedisLock = class {
   /**
    * Constructs a new RedisLock instance with the specified configuration.
@@ -1837,7 +1840,7 @@ var RedisLock = class {
    * UUIDs are sufficiently random to prevent lock hijacking across instances.
    * However, they are stored in plain text in Redis (not encrypted).
    */
-  lockId = randomUUID();
+  lockId = crypto.randomUUID();
   /**
    * Redis key prefix for all locks acquired through this instance.
    *
@@ -2067,9 +2070,6 @@ var RedisLock = class {
   }
 };
 
-// src/OrbitSitemap.ts
-import { randomUUID as randomUUID2 } from "crypto";
-
 // src/redirect/RedirectHandler.ts
 var RedirectHandler = class {
   options;
@@ -2084,7 +2084,6 @@ var RedirectHandler = class {
    */
   async processEntries(entries) {
     const { manager, strategy, followChains, maxChainLength } = this.options;
-    const _processedEntries = [];
     const redirectMap = /* @__PURE__ */ new Map();
     for (const entry of entries) {
       const redirectTarget = await manager.resolve(entry.url, followChains, maxChainLength);
@@ -2435,7 +2434,7 @@ var OrbitSitemap = class _OrbitSitemap {
     const opts = this.options;
     let storage = opts.storage;
     if (!storage) {
-      const { DiskSitemapStorage: DiskSitemapStorage2 } = await import("./DiskSitemapStorage-VLN5I24C.js");
+      const { DiskSitemapStorage: DiskSitemapStorage2 } = await import("./DiskSitemapStorage-6VXPMKLB.js");
       storage = new DiskSitemapStorage2(opts.outDir, opts.baseUrl);
     }
     let providers = opts.providers;
@@ -2481,7 +2480,7 @@ var OrbitSitemap = class _OrbitSitemap {
     }
     let storage = opts.storage;
     if (!storage) {
-      const { DiskSitemapStorage: DiskSitemapStorage2 } = await import("./DiskSitemapStorage-VLN5I24C.js");
+      const { DiskSitemapStorage: DiskSitemapStorage2 } = await import("./DiskSitemapStorage-6VXPMKLB.js");
       storage = new DiskSitemapStorage2(opts.outDir, opts.baseUrl);
     }
     const incrementalGenerator = new IncrementalGenerator({
@@ -2507,10 +2506,10 @@ var OrbitSitemap = class _OrbitSitemap {
       throw new Error("generateAsync() can only be called in static mode");
     }
     const opts = this.options;
-    const jobId = randomUUID2();
+    const jobId = crypto.randomUUID();
     let storage = opts.storage;
     if (!storage) {
-      const { DiskSitemapStorage: DiskSitemapStorage2 } = await import("./DiskSitemapStorage-VLN5I24C.js");
+      const { DiskSitemapStorage: DiskSitemapStorage2 } = await import("./DiskSitemapStorage-6VXPMKLB.js");
       storage = new DiskSitemapStorage2(opts.outDir, opts.baseUrl);
     }
     let providers = opts.providers;
@@ -2764,7 +2763,11 @@ var RedirectDetector = class {
     }
     try {
       const { connection, table, columns } = database;
-      const query = `SELECT ${columns.from}, ${columns.to}, ${columns.type} FROM ${table} WHERE ${columns.from} = ? LIMIT 1`;
+      const safeTable = this.assertSafeIdentifier(table);
+      const safeFrom = this.assertSafeIdentifier(columns.from);
+      const safeTo = this.assertSafeIdentifier(columns.to);
+      const safeType = this.assertSafeIdentifier(columns.type);
+      const query = `SELECT ${safeFrom}, ${safeTo}, ${safeType} FROM ${safeTable} WHERE ${safeFrom} = ? LIMIT 1`;
       const results = await connection.query(query, [url]);
       if (results.length === 0) {
         return null;
@@ -2810,6 +2813,7 @@ var RedirectDetector = class {
       const timeout = autoDetect.timeout || 5e3;
       const controller = new AbortController();
       const timeoutId = setTimeout(() => controller.abort(), timeout);
+      timeoutId.unref?.();
       try {
         const response = await fetch(fullUrl, {
           method: "HEAD",
@@ -2851,6 +2855,12 @@ var RedirectDetector = class {
       expires: Date.now() + ttl
     });
   }
+  assertSafeIdentifier(identifier) {
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(identifier)) {
+      throw new Error(`Invalid database identifier: ${identifier}`);
+    }
+    return identifier;
+  }
 };
 
 // src/redirect/RedirectManager.ts
@@ -3245,7 +3255,6 @@ var GCPSitemapStorage = class {
     });
     for (const shadowFile of shadowFiles) {
       const originalKey = shadowFile.name.replace(/\.shadow\.[^/]+$/, "");
-      const _originalFilename = originalKey.replace(prefix, "");
       if (this.shadowMode === "atomic") {
         await shadowFile.copy(bucket.file(originalKey));
         await shadowFile.delete();
@@ -3732,7 +3741,6 @@ var S3SitemapStorage = class {
         continue;
       }
       const originalKey = shadowFile.Key.replace(/\.shadow\.[^/]+$/, "");
-      const _originalFilename = originalKey.replace(prefix, "");
       if (this.shadowMode === "atomic") {
         await s3.client.send(
           new s3.CopyObjectCommand({

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@gravito/constellation",
-  "version": "3.1.1",
+  "sideEffects": false,
+  "version": "3.1.3",
   "description": "Powerful sitemap generation for Gravito applications with dynamic/static support, sharding, and caching.",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -8,6 +9,7 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
+      "bun": "./dist/index.js",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
@@ -20,6 +22,7 @@
   ],
   "scripts": {
     "build": "bun run build.ts",
+    "build:dts": "bun run build.ts --dts-only",
     "typecheck": "bun tsc -p tsconfig.json --noEmit --skipLibCheck",
     "test": "bun test --timeout=10000",
     "test:coverage": "bun test --timeout=10000 --coverage --coverage-reporter=lcov --coverage-dir coverage && bun run --bun scripts/check-coverage.ts",
@@ -28,18 +31,18 @@
     "test:integration": "test $(find tests -name '*.integration.test.ts' 2>/dev/null | wc -l) -gt 0 && find tests -name '*.integration.test.ts' -print0 | xargs -0 bun test --timeout=10000 || echo 'No integration tests found'"
   },
   "peerDependencies": {
-    "@gravito/core": "^1.6.1"
+    "@gravito/core": "^2.0.0"
   },
   "dependencies": {
     "@aws-sdk/client-s3": "^3.956.0",
     "@google-cloud/storage": "^7.18.0",
-    "@gravito/stream": "^2.0.2",
-    "@gravito/photon": "^1.0.1"
+    "@gravito/stream": "^2.1.1",
+    "@gravito/photon": "^1.1.3"
   },
   "devDependencies": {
     "bun-plugin-dts": "^0.3.0",
     "bun-types": "latest",
-    "@gravito/core": "^1.6.1",
+    "@gravito/core": "^2.0.6",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3"
   },