Documentation: utils / sitemapService
Purpose:
Build site sitemap including static pages, posts, tags.
Lifecycle Role:
Handles sitemap endpoint generation.
Dependencies:
Upstream:
- static JSON file
- filesystem frontmatter parsing
- getAllPosts
- fast‑glob
- slugify, link utils, hashing
Downstream:
- sitemap route handler
- SEO tools
Data Flow:
Inputs:
various content directories
Outputs:
hierarchical sitemap + flattened URL list
Side Effects:
filesystem reads
Performance and Scalability:
Bottlenecks:
- extensive file I/O and parsing
Concurrency:
None
Security and Stability:
Validation:
frontmatter validation missing
Vulnerabilities:
- may include unpublished pages
Architecture Assessment:
Coupling:
Broad across content modules
Abstraction:
Sitemap aggregator
Recommendations:
- Add caching
- Limit Concurrency on file reads
- Validate frontmatter
- Separate static vs dynamic parts