developer-roadmap/src/lib/roadmap.ts

import type { MarkdownFileType } from "./File";

type RoadmapFileType = MarkdownFileType<RoadmapFrontmatter>;

export interface RoadmapFrontmatter {
  id: string;
  jsonUrl: string;
  pdfUrl: string;
  order: number;
  featuredTitle: string;
  featuredDescription: string;
  title: string;
  description: string;
  hasTopics: boolean;
  isNew: boolean;
  dimensions: {
    width: number;
    height: number;
  };
  seo: {
    title: string;
    description: string;
    keywords: string[];
  };
  relatedRoadmaps: string[];
  sitemap: {
    priority: number;
    changefreq: string;
  };
  tags: string[];
}

/**
 * Gets the IDs of all the roadmaps available on the website
 * 
 * @returns string[] Array of roadmap IDs
 */
export async function getRoadmapIds() {
  const roadmapFiles = await import.meta.glob<string>("/src/roadmaps/*/*.md", {
    eager: true,
  });

  return Object.keys(roadmapFiles).map((filePath) => {
    const fileName = filePath.split("/").pop() || "";

    return fileName.replace(".md", "");
  });
}

/**
 * Gets the roadmap files which have the given tag assigned
 * 
 * @param tag Tag assigned to roadmap
 * @returns Promisified RoadmapFileType[]
 */
export async function getRoadmapsByTag(tag: string): Promise<RoadmapFileType[]> {
  const roadmapFilesMap = await import.meta.glob<RoadmapFileType>(
    '/src/roadmaps/*/*.md',
    {
      eager: true,
    }
  );
  
  const roadmapFiles: MarkdownFileType<RoadmapFrontmatter>[] = Object.values(roadmapFilesMap);
  const filteredRoadmaps = roadmapFiles.filter(roadmapFile => roadmapFile.frontmatter.tags.includes(tag));

  return filteredRoadmaps.sort(
    (a, b) => a.frontmatter.order - b.frontmatter.order
  );
}