Initialize local Tabularium documentation monorepo

apps/docs/src/lib/docs.ts

@@ -0,0 +1,25 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+
+const directory = path.resolve(process.cwd(), "../../content/docs");
+const validSlug = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+
+export type DocLink = { slug: string; title: string };
+export type Doc = DocLink & { content: string };
+
+export async function readDoc(slug: string): Promise<Doc> {
+  if (!validSlug.test(slug)) throw new Error("Invalid document slug");
+  const content = await fs.readFile(path.join(directory, `${slug}.md`), "utf8");
+  const title = content.match(/^# (.+)$/m)?.[1]?.trim() ?? slug;
+  return { slug, title, content };
+}
+
+export async function listDocs(): Promise<DocLink[]> {
+  const files = (await fs.readdir(directory)).filter((file) =>
+    file.endsWith(".md") && validSlug.test(file.slice(0, -3)),
+  ).sort();
+  return Promise.all(files.map(async (file) => {
+    const { slug, title } = await readDoc(file.slice(0, -3));
+    return { slug, title };
+  }));
+}