fix: extract .mdx files from GitHub tarballs

The tarball extraction and local path validation only matched .md files,
causing repos with .mdx content (e.g. Astro docs) to download 0 files.

v0.6.4

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: christopherarter

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamik-dev/refdocs",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "type": "module",
   "description": "Local CLI tool that indexes markdown documentation and exposes fast fuzzy search with intelligent chunking",
   "main": "dist/index.js",

src/add.ts

@@ -142,7 +142,7 @@ export function addLocalPath(
   }
 
   if (!hasMarkdownFiles(absolutePath)) {
-    throw new Error(`No .md files found in ${inputPath}`);
+    throw new Error(`No .md/.mdx files found in ${inputPath}`);
   }
 
   const localPath = relative(configDir, absolutePath);
@@ -189,7 +189,7 @@ export function removePath(
 function hasMarkdownFiles(dir: string): boolean {
   const entries = readdirSync(dir, { withFileTypes: true });
   for (const entry of entries) {
-    if (entry.isFile() && entry.name.endsWith(".md")) return true;
+    if (entry.isFile() && (entry.name.endsWith(".md") || entry.name.endsWith(".mdx"))) return true;
     if (entry.isDirectory()) {
       if (hasMarkdownFiles(join(dir, entry.name))) return true;
     }
@@ -210,7 +210,7 @@ export async function extractMarkdownFiles(
       const chunks: Buffer[] = [];
       stream.on("data", (chunk: Buffer) => chunks.push(chunk));
       stream.on("end", () => {
-        if (header.type === "file" && header.name.endsWith(".md")) {
+        if (header.type === "file" && (header.name.endsWith(".md") || header.name.endsWith(".mdx"))) {
           const relativePath = stripTarPrefix(header.name);
 
           if (subpath && !relativePath.startsWith(subpath + "/") && relativePath !== subpath) {

tests/add.test.ts

@@ -6,6 +6,7 @@ import { extractMarkdownFiles, updateSources, addLocalPath, removePath, isPathCo
 import type { RefdocsConfig } from "../src/types.js";
 
 const FIXTURE_PATH = join(import.meta.dirname, "fixtures", "test-repo.tar.gz");
+const MDX_FIXTURE_PATH = join(import.meta.dirname, "fixtures", "test-repo-mdx.tar.gz");
 
 describe("extractMarkdownFiles", () => {
   let tmpDir: string;
@@ -70,6 +71,27 @@ describe("extractMarkdownFiles", () => {
     const count = await extractMarkdownFiles(tarball, "nonexistent", join(tmpDir, "out"));
     expect(count).toBe(0);
   });
+
+  it("extracts .mdx files alongside .md files", async () => {
+    const mdxTarball = readFileSync(MDX_FIXTURE_PATH);
+    const count = await extractMarkdownFiles(mdxTarball, "", join(tmpDir, "out"));
+    expect(count).toBe(3);
+
+    expect(existsSync(join(tmpDir, "out", "docs", "guide.md"))).toBe(true);
+    expect(existsSync(join(tmpDir, "out", "docs", "component.mdx"))).toBe(true);
+    expect(existsSync(join(tmpDir, "out", "docs", "page.mdx"))).toBe(true);
+    expect(existsSync(join(tmpDir, "out", "package.json"))).toBe(false);
+  });
+
+  it("filters .mdx files by subpath", async () => {
+    const mdxTarball = readFileSync(MDX_FIXTURE_PATH);
+    const count = await extractMarkdownFiles(mdxTarball, "docs", join(tmpDir, "out"));
+    expect(count).toBe(3);
+
+    expect(existsSync(join(tmpDir, "out", "guide.md"))).toBe(true);
+    expect(existsSync(join(tmpDir, "out", "component.mdx"))).toBe(true);
+    expect(existsSync(join(tmpDir, "out", "page.mdx"))).toBe(true);
+  });
 });
 
 vi.mock("../src/github.js", async (importOriginal) => {
@@ -261,12 +283,21 @@ describe("addLocalPath", () => {
     expect(() => addLocalPath("nope", tmpDir, baseConfig)).toThrow("Directory not found: nope");
   });
 
-  it("throws if directory has no .md files", () => {
+  it("throws if directory has no .md/.mdx files", () => {
     const emptyDir = join(tmpDir, "empty");
     mkdirSync(emptyDir, { recursive: true });
     writeFileSync(join(emptyDir, "data.json"), "{}");
 
-    expect(() => addLocalPath("empty", tmpDir, baseConfig)).toThrow("No .md files found");
+    expect(() => addLocalPath("empty", tmpDir, baseConfig)).toThrow("No .md/.mdx files found");
+  });
+
+  it("accepts a directory with only .mdx files", () => {
+    const mdxDir = join(tmpDir, "mdx-docs");
+    mkdirSync(mdxDir, { recursive: true });
+    writeFileSync(join(mdxDir, "page.mdx"), "# MDX Page");
+
+    const result = addLocalPath("mdx-docs", tmpDir, baseConfig);
+    expect(result.localPath).toBe("mdx-docs");
   });
 
   it("finds .md files in subdirectories", () => {