@interactive-inc/docs-client 1.0.0 → 1.0.2

package/build/index.js

@@ -1878,6 +1878,9 @@ var DocFileRelationReference = class {
   }
   async read() {
     const files = await this.readFiles();
+    if (files instanceof Error) {
+      return files;
+    }
     return new DocRelationValue({
       path: this.path,
       files: files.map((value) => value.toJson())
@@ -1892,9 +1895,15 @@ var DocFileRelationReference = class {
       return [];
     }
     const filePaths = await this.fileSystem.readDirectoryFilePaths(this.path);
+    if (filePaths instanceof Error) {
+      return filePaths;
+    }
     const files = [];
     for (const filePath of filePaths) {
       const file = await this.readFile(filePath);
+      if (file instanceof Error) {
+        return file;
+      }
       if (file === null) continue;
       files.push(file);
     }
@@ -1908,6 +1917,9 @@ var DocFileRelationReference = class {
       return null;
     }
     const content = await this.fileSystem.readFile(filePath);
+    if (content instanceof Error) {
+      return content;
+    }
     if (content === null) {
       return null;
     }
@@ -1940,6 +1952,9 @@ var DocFileRelationReference = class {
    */
   async readSlugs() {
     const files = await this.readFiles();
+    if (files instanceof Error) {
+      return files;
+    }
     return files.map((file) => file.id);
   }
   /**
@@ -1947,6 +1962,9 @@ var DocFileRelationReference = class {
    */
   async count() {
     const files = await this.readFiles();
+    if (files instanceof Error) {
+      return files;
+    }
     return files.length;
   }
   /**
@@ -1954,6 +1972,9 @@ var DocFileRelationReference = class {
    */
   async isEmpty() {
     const count = await this.count();
+    if (count instanceof Error) {
+      return count;
+    }
     return count === 0;
   }
 };
@@ -3273,6 +3294,9 @@ var DocFileIndexReference = class _DocFileIndexReference {
   }
   async read() {
     const content = await this.fileSystem.readFile(this.filePath);
+    if (content instanceof Error) {
+      return content;
+    }
     if (content === null) {
       const dirPath = this.pathSystem.dirname(this.filePath);
       const dirName = this.pathSystem.basename(dirPath);
@@ -3330,14 +3354,14 @@ var DocFileIndexReference = class _DocFileIndexReference {
    * Write content to file
    */
   async writeContent(content) {
-    await this.fileSystem.writeFile(this.filePath, content);
+    return await this.fileSystem.writeFile(this.filePath, content);
   }
   /**
    * Write entity
    */
   async write(entity) {
     const content = entity.content.toText();
-    await this.fileSystem.writeFile(this.filePath, content);
+    return await this.fileSystem.writeFile(this.filePath, content);
   }
   /**
    * Create new file with default content
@@ -3350,7 +3374,13 @@ var DocFileIndexReference = class _DocFileIndexReference {
       "",
       `Please describe the overview of ${dirName} here.`
     ].join("\n");
-    await this.fileSystem.writeFile(this.filePath, defaultContent);
+    const writeResult = await this.fileSystem.writeFile(
+      this.filePath,
+      defaultContent
+    );
+    if (writeResult instanceof Error) {
+      return writeResult;
+    }
     return null;
   }
   /**
@@ -3367,6 +3397,9 @@ var DocFileIndexReference = class _DocFileIndexReference {
   }
   async relations() {
     const indexFile = await this.read();
+    if (indexFile instanceof Error) {
+      return indexFile;
+    }
     const schema = indexFile.content.meta().schema();
     if (!schema) {
       return [];
@@ -3391,10 +3424,14 @@ var DocFileIndexReference = class _DocFileIndexReference {
   }
   async readRelations() {
     const relations = await this.relations();
+    if (relations instanceof Error) {
+      return relations;
+    }
     const files = [];
     for (const relation of relations) {
       const entity = await relation.read();
       if (entity === null) continue;
+      if (entity instanceof Error) continue;
       files.push(entity);
     }
     return files;
@@ -3428,7 +3465,13 @@ var DocFileIndexReference = class _DocFileIndexReference {
       archiveDirectoryName,
       fileName
     );
-    await this.fileSystem.moveFile(this.filePath, archivePath);
+    const moveResult = await this.fileSystem.moveFile(
+      this.filePath,
+      archivePath
+    );
+    if (moveResult instanceof Error) {
+      throw moveResult;
+    }
     return new _DocFileIndexReference({
       path: archivePath,
       fileSystem: this.fileSystem,
@@ -3451,7 +3494,13 @@ var DocFileIndexReference = class _DocFileIndexReference {
       this.pathSystem.dirname(dirPath),
       fileName
     );
-    await this.fileSystem.moveFile(this.filePath, restorePath);
+    const moveResult = await this.fileSystem.moveFile(
+      this.filePath,
+      restorePath
+    );
+    if (moveResult instanceof Error) {
+      throw moveResult;
+    }
     return new _DocFileIndexReference({
       path: restorePath,
       fileSystem: this.fileSystem,
@@ -3507,9 +3556,15 @@ var DocFileMdReference = class _DocFileMdReference {
   }
   async read() {
     const content = await this.fileSystem.readFile(this.path);
+    if (content instanceof Error) {
+      return content;
+    }
     const actualPath = this.path;
     if (content === null) {
       const archivedContent = await this.fileSystem.readFile(this.archivedPath);
+      if (archivedContent instanceof Error) {
+        return archivedContent;
+      }
       if (archivedContent !== null) {
         const contentValue2 = DocFileMdContentValue.fromMarkdown(
           archivedContent,
@@ -3569,7 +3624,10 @@ var DocFileMdReference = class _DocFileMdReference {
    */
   async write(entity) {
     const content = entity.content.toText();
-    await this.fileSystem.writeFile(this.path, content);
+    const writeResult = await this.fileSystem.writeFile(this.path, content);
+    if (writeResult instanceof Error) {
+      return writeResult;
+    }
     return null;
   }
   async writeText(text) {
@@ -3597,13 +3655,13 @@ var DocFileMdReference = class _DocFileMdReference {
    * Copy file
    */
   async copyTo(destinationPath) {
-    await this.fileSystem.copyFile(this.path, destinationPath);
+    return await this.fileSystem.copyFile(this.path, destinationPath);
   }
   /**
    * Move file
    */
   async moveTo(destinationPath) {
-    await this.fileSystem.moveFile(this.path, destinationPath);
+    return await this.fileSystem.moveFile(this.path, destinationPath);
   }
   /**
    * Move file to archive and return new reference
@@ -3616,7 +3674,10 @@ var DocFileMdReference = class _DocFileMdReference {
       archiveDirectoryName,
       fileName
     );
-    await this.moveTo(archivePath);
+    const moveResult = await this.moveTo(archivePath);
+    if (moveResult instanceof Error) {
+      throw moveResult;
+    }
     return new _DocFileMdReference({
       path: archivePath,
       fileSystem: this.fileSystem,
@@ -3639,7 +3700,10 @@ var DocFileMdReference = class _DocFileMdReference {
       this.pathSystem.dirname(dirPath),
       fileName
     );
-    await this.moveTo(restorePath);
+    const moveResult = await this.moveTo(restorePath);
+    if (moveResult instanceof Error) {
+      throw moveResult;
+    }
     return new _DocFileMdReference({
       path: restorePath,
       fileSystem: this.fileSystem,
@@ -3902,6 +3966,9 @@ var DocFileUnknownReference = class _DocFileUnknownReference {
   }
   async read() {
     const content = await this.fileSystem.readFile(this.path);
+    if (content instanceof Error) {
+      return content;
+    }
     if (content === null) {
       return new Error(`File not found at ${this.path}.`);
     }
@@ -3937,19 +4004,19 @@ var DocFileUnknownReference = class _DocFileUnknownReference {
    * Write content to file
    */
   async writeContent(content) {
-    await this.fileSystem.writeFile(this.path, content);
+    return await this.fileSystem.writeFile(this.path, content);
   }
   /**
    * Write entity
    */
   async write(entity) {
-    await this.fileSystem.writeFile(this.path, entity.value.content);
+    return await this.fileSystem.writeFile(this.path, entity.value.content);
   }
   /**
    * Write raw content
    */
   async writeRaw(content) {
-    await this.fileSystem.writeFile(this.path, content);
+    return await this.fileSystem.writeFile(this.path, content);
   }
   /**
    * Delete file
@@ -3967,13 +4034,13 @@ var DocFileUnknownReference = class _DocFileUnknownReference {
    * Copy file
    */
   async copyTo(destinationPath) {
-    await this.fileSystem.copyFile(this.path, destinationPath);
+    return await this.fileSystem.copyFile(this.path, destinationPath);
   }
   /**
    * Move file
    */
   async moveTo(destinationPath) {
-    await this.fileSystem.moveFile(this.path, destinationPath);
+    return await this.fileSystem.moveFile(this.path, destinationPath);
   }
   /**
    * Get file size in bytes
@@ -4004,7 +4071,10 @@ var DocFileUnknownReference = class _DocFileUnknownReference {
       archiveDirectoryName,
       fileName
     );
-    await this.moveTo(archivePath);
+    const moveResult = await this.moveTo(archivePath);
+    if (moveResult instanceof Error) {
+      throw moveResult;
+    }
     return new _DocFileUnknownReference({
       path: archivePath,
       fileSystem: this.fileSystem,
@@ -4026,7 +4096,10 @@ var DocFileUnknownReference = class _DocFileUnknownReference {
       this.pathSystem.dirname(dirPath),
       fileName
     );
-    await this.moveTo(restorePath);
+    const moveResult = await this.moveTo(restorePath);
+    if (moveResult instanceof Error) {
+      throw moveResult;
+    }
     return new _DocFileUnknownReference({
       path: restorePath,
       fileSystem: this.fileSystem,
@@ -4078,6 +4151,9 @@ var DocDirectoryReference = class _DocDirectoryReference {
     const filePaths = await this.fileSystem.readDirectoryFilePaths(
       this.relativePath
     );
+    if (filePaths instanceof Error) {
+      return filePaths;
+    }
     return filePaths.map((p) => this.pathSystem.basename(p)).filter((name) => name.includes("."));
   }
   async archivedFileNames() {
@@ -4086,10 +4162,17 @@ var DocDirectoryReference = class _DocDirectoryReference {
       this.archiveDirectoryName
     );
     const filePaths = await this.fileSystem.readDirectoryFilePaths(archivePath);
+    if (filePaths instanceof Error) {
+      return filePaths;
+    }
     return filePaths.map((p) => this.pathSystem.basename(p)).filter((name) => name.includes("."));
   }
   async *filesGenerator() {
     const fileNames = await this.fileNames();
+    if (fileNames instanceof Error) {
+      yield fileNames;
+      return;
+    }
     for (const fileName of fileNames) {
       if (fileName === "index.md") continue;
       if (fileName.endsWith(".md")) {
@@ -4110,6 +4193,10 @@ var DocDirectoryReference = class _DocDirectoryReference {
       });
     }
     const archivedFileNames = await this.archivedFileNames();
+    if (archivedFileNames instanceof Error) {
+      yield archivedFileNames;
+      return;
+    }
     for (const fileName of archivedFileNames) {
       if (fileName === this.indexFileName) continue;
       if (fileName.endsWith(".md")) {
@@ -4141,6 +4228,10 @@ var DocDirectoryReference = class _DocDirectoryReference {
   async *mdFilesGenerator() {
     const generator = this.filesGenerator();
     for await (const file of generator) {
+      if (file instanceof Error) {
+        yield file;
+        return;
+      }
       if (file instanceof DocFileMdReference) {
         yield file;
       }
@@ -4149,6 +4240,9 @@ var DocDirectoryReference = class _DocDirectoryReference {
   async files() {
     const files = [];
     for await (const ref of this.filesGenerator()) {
+      if (ref instanceof Error) {
+        return ref;
+      }
       files.push(ref);
     }
     return files;
@@ -4156,6 +4250,9 @@ var DocDirectoryReference = class _DocDirectoryReference {
   async mdFiles() {
     const refs = [];
     for await (const file of this.mdFilesGenerator()) {
+      if (file instanceof Error) {
+        return file;
+      }
       refs.push(file);
     }
     return refs;
@@ -4190,6 +4287,9 @@ var DocDirectoryReference = class _DocDirectoryReference {
   async readFiles() {
     const entities = [];
     for await (const file of this.filesGenerator()) {
+      if (file instanceof Error) {
+        return file;
+      }
       const entity = await file.read();
       if (entity instanceof Error) continue;
       entities.push(entity);
@@ -4199,6 +4299,9 @@ var DocDirectoryReference = class _DocDirectoryReference {
   async readMdFiles() {
     const entities = [];
     for await (const file of this.filesGenerator()) {
+      if (file instanceof Error) {
+        return file;
+      }
       const entity = await file.read();
       if (entity instanceof Error) continue;
       if (entity instanceof DocFileUnknownEntity) continue;
@@ -4209,6 +4312,9 @@ var DocDirectoryReference = class _DocDirectoryReference {
   async readUnknownFiles() {
     const entities = [];
     for await (const file of this.filesGenerator()) {
+      if (file instanceof Error) {
+        return file;
+      }
       const entity = await file.read();
       if (entity instanceof Error) continue;
       if (entity instanceof DocFileMdEntity) continue;
@@ -4223,6 +4329,9 @@ var DocDirectoryReference = class _DocDirectoryReference {
     const allFileNames = await this.fileSystem.readDirectoryFileNames(
       this.relativePath
     );
+    if (allFileNames instanceof Error) {
+      return allFileNames;
+    }
     const directoryNames = [];
     for (const fileName of allFileNames) {
       if (fileName.startsWith(this.archiveDirectoryName)) continue;
@@ -4240,6 +4349,9 @@ var DocDirectoryReference = class _DocDirectoryReference {
    */
   async directories() {
     const directoryNames = await this.directoryNames();
+    if (directoryNames instanceof Error) {
+      return directoryNames;
+    }
     return directoryNames.map((dirName) => {
       const dirPath = this.pathSystem.join(this.relativePath, dirName);
       return new _DocDirectoryReference({
@@ -4306,7 +4418,10 @@ var DocDirectoryReference = class _DocDirectoryReference {
     if (content === null) {
       return new Error("Entity content is undefined");
     }
-    await this.fileSystem.writeFile(filePath, content);
+    const writeResult = await this.fileSystem.writeFile(filePath, content);
+    if (writeResult instanceof Error) {
+      return writeResult;
+    }
     return null;
   }
   async exists() {
@@ -4333,7 +4448,10 @@ var DocDirectoryReference = class _DocDirectoryReference {
       pathSystem: this.pathSystem,
       config: this.props.config
     });
-    await fileRef.writeDefault();
+    const writeResult = await fileRef.writeDefault();
+    if (writeResult instanceof Error) {
+      throw writeResult;
+    }
     return fileRef;
   }
 };
@@ -4470,6 +4588,9 @@ var DocFileTreeSystem = class {
    */
   async buildFileTree(directoryPath = "") {
     const fileNames = await this.props.fileSystem.readDirectoryFileNames(directoryPath);
+    if (fileNames instanceof Error) {
+      return fileNames;
+    }
     const results = [];
     for (const fileName of fileNames) {
       if (fileName === this.props.archiveDirectoryName) continue;
@@ -4478,10 +4599,16 @@ var DocFileTreeSystem = class {
       const isDirectory = await this.props.fileSystem.isDirectory(filePath);
       if (!isDirectory) {
         const fileNode = await this.createFileNode(fileName, filePath);
+        if (fileNode instanceof Error) {
+          return fileNode;
+        }
         results.push(fileNode);
         continue;
       }
       const directoryNode = await this.createDirectoryNode(fileName, filePath);
+      if (directoryNode instanceof Error) {
+        return directoryNode;
+      }
       results.push(directoryNode);
     }
     return results;
@@ -4520,6 +4647,9 @@ var DocFileTreeSystem = class {
     const indexFile = this.createIndexFileReference(filePath);
     if (await indexFile.exists()) {
       const entity = await indexFile.read();
+      if (entity instanceof Error) {
+        return entity;
+      }
       title = entity.value.content.title || fileName;
       const content = entity.content;
       const frontMatter = content.meta();
@@ -4528,6 +4658,9 @@ var DocFileTreeSystem = class {
       }
     }
     const children = await this.buildFileTree(filePath);
+    if (children instanceof Error) {
+      return children;
+    }
     return DocTreeDirectoryNodeValue.from({
       name: fileName,
       path: filePath,
@@ -4566,6 +4699,9 @@ var DocFileTreeSystem = class {
    */
   async buildDirectoryTree(directoryPath = "") {
     const fileNames = await this.props.fileSystem.readDirectoryFileNames(directoryPath);
+    if (fileNames instanceof Error) {
+      return fileNames;
+    }
     const results = [];
     for (const fileName of fileNames) {
       if (fileName === this.props.archiveDirectoryName) continue;
@@ -4577,6 +4713,9 @@ var DocFileTreeSystem = class {
         fileName,
         filePath
       );
+      if (directoryNode instanceof Error) {
+        return directoryNode;
+      }
       results.push(directoryNode);
     }
     return results;
@@ -4590,6 +4729,9 @@ var DocFileTreeSystem = class {
     const indexFile = this.createIndexFileReference(filePath);
     if (await indexFile.exists()) {
       const entity = await indexFile.read();
+      if (entity instanceof Error) {
+        return entity;
+      }
       title = entity.value.content.title || fileName;
       const content = entity.content;
       const frontMatter = content.meta();
@@ -4598,6 +4740,9 @@ var DocFileTreeSystem = class {
       }
     }
     const children = await this.buildDirectoryTree(filePath);
+    if (children instanceof Error) {
+      return children;
+    }
     return DocTreeDirectoryNodeValue.from({
       name: fileName,
       path: filePath,
@@ -4852,10 +4997,16 @@ var DocClient = class {
   }
   async fileTree(directoryPath = "") {
     const results = await this.fileTreeSystem.buildFileTree(directoryPath);
+    if (results instanceof Error) {
+      throw results;
+    }
     return results.map((node) => node.toJson());
   }
   async directoryTree(directoryPath = "") {
     const results = await this.fileTreeSystem.buildDirectoryTree(directoryPath);
+    if (results instanceof Error) {
+      throw results;
+    }
     return results.map((node) => node.toJson());
   }
 };
@@ -4873,29 +5024,27 @@ var DocFileSystem = class {
    * Read file content at the specified path
    */
   async readFile(relativePath) {
-    const exists = await this.exists(relativePath);
-    if (!exists) return null;
-    const fullPath = this.pathSystem.join(this.basePath, relativePath);
     try {
+      const exists = await this.exists(relativePath);
+      if (!exists) return null;
+      const fullPath = this.pathSystem.join(this.basePath, relativePath);
       return await fs.readFile(fullPath, "utf-8");
-    } catch {
-      return null;
+    } catch (error) {
+      return error instanceof Error ? error : new Error(`Failed to read file at ${relativePath}`);
     }
   }
   /**
    * Write content to file at the specified path (creates directory if needed)
    */
   async writeFile(relativePath, content) {
-    const fullPath = this.pathSystem.join(this.basePath, relativePath);
-    const dirPath = this.pathSystem.dirname(fullPath);
     try {
+      const fullPath = this.pathSystem.join(this.basePath, relativePath);
+      const dirPath = this.pathSystem.dirname(fullPath);
       await fs.mkdir(dirPath, { recursive: true });
       await fs.writeFile(fullPath, content, "utf-8");
+      return null;
     } catch (error) {
-      if (error instanceof Error) {
-        throw error;
-      }
-      throw new Error(`Failed to write file at ${fullPath}`);
+      return error instanceof Error ? error : new Error(`Failed to write file at ${relativePath}`);
     }
   }
   /**
@@ -4932,18 +5081,25 @@ var DocFileSystem = class {
    * Get list of entries in directory
    */
   async readDirectoryFileNames(relativePath = "") {
-    const fullPath = this.pathSystem.join(this.basePath, relativePath);
     try {
+      const fullPath = this.pathSystem.join(this.basePath, relativePath);
       return await fs.readdir(fullPath);
-    } catch {
-      return [];
+    } catch (error) {
+      return error instanceof Error ? error : new Error(`Failed to read directory at ${relativePath}`);
     }
   }
   async readDirectoryFilePaths(relativePath) {
-    const fileNames = await this.readDirectoryFileNames(relativePath);
-    return fileNames.map(
-      (fileName) => this.pathSystem.join(relativePath, fileName)
-    );
+    try {
+      const fileNames = await this.readDirectoryFileNames(relativePath);
+      if (fileNames instanceof Error) {
+        return fileNames;
+      }
+      return fileNames.map(
+        (fileName) => this.pathSystem.join(relativePath, fileName)
+      );
+    } catch (error) {
+      return error instanceof Error ? error : new Error(`Failed to read directory file paths at ${relativePath}`);
+    }
   }
   /**
    * Check if path is a directory
@@ -5009,66 +5165,138 @@ var DocFileSystem = class {
    * Create directory
    */
   async createDirectory(relativePath) {
-    const fullPath = this.pathSystem.join(this.basePath, relativePath);
-    await fs.mkdir(fullPath, { recursive: true });
+    try {
+      const fullPath = this.pathSystem.join(this.basePath, relativePath);
+      await fs.mkdir(fullPath, { recursive: true });
+      return null;
+    } catch (error) {
+      return error instanceof Error ? error : new Error(`Failed to create directory at ${relativePath}`);
+    }
   }
   /**
    * Get file size in bytes
    */
   async getFileSize(relativePath) {
-    const fullPath = this.pathSystem.join(this.basePath, relativePath);
-    const stats = await fs.stat(fullPath);
-    return stats.size;
+    try {
+      const fullPath = this.pathSystem.join(this.basePath, relativePath);
+      const stats = await fs.stat(fullPath);
+      return stats.size;
+    } catch (error) {
+      return error instanceof Error ? error : new Error(`Failed to get file size at ${relativePath}`);
+    }
   }
   /**
    * Create directory if it doesn't exist
    */
   async ensureDirectoryExists(relativePath) {
-    if (!await this.exists(relativePath)) {
-      await this.createDirectory(relativePath);
+    try {
+      if (!await this.exists(relativePath)) {
+        const result = await this.createDirectory(relativePath);
+        if (result instanceof Error) {
+          return result;
+        }
+      }
+      return null;
+    } catch (error) {
+      return error instanceof Error ? error : new Error(`Failed to ensure directory exists at ${relativePath}`);
     }
   }
   /**
    * Copy file
    */
   async copyFile(sourcePath, destinationPath) {
-    const sourceFullPath = this.pathSystem.join(this.basePath, sourcePath);
-    const destFullPath = this.pathSystem.join(this.basePath, destinationPath);
-    await fs.copyFile(sourceFullPath, destFullPath);
+    try {
+      const sourceFullPath = this.pathSystem.join(this.basePath, sourcePath);
+      const destFullPath = this.pathSystem.join(this.basePath, destinationPath);
+      await fs.copyFile(sourceFullPath, destFullPath);
+      return null;
+    } catch (error) {
+      return error instanceof Error ? error : new Error(
+        `Failed to copy file from ${sourcePath} to ${destinationPath}`
+      );
+    }
   }
   /**
    * Move file
    */
   async moveFile(sourcePath, destinationPath) {
-    const sourceFullPath = this.pathSystem.join(this.basePath, sourcePath);
-    const destFullPath = this.pathSystem.join(this.basePath, destinationPath);
-    await fs.rename(sourceFullPath, destFullPath);
+    try {
+      const sourceFullPath = this.pathSystem.join(this.basePath, sourcePath);
+      const destFullPath = this.pathSystem.join(this.basePath, destinationPath);
+      await fs.rename(sourceFullPath, destFullPath);
+      return null;
+    } catch (error) {
+      return error instanceof Error ? error : new Error(
+        `Failed to move file from ${sourcePath} to ${destinationPath}`
+      );
+    }
   }
   /**
    * Get file last modified time
    */
   async getFileModifiedTime(relativePath) {
-    const fullPath = this.pathSystem.join(this.basePath, relativePath);
-    const stats = await fs.stat(fullPath);
-    return stats.mtime;
+    try {
+      const fullPath = this.pathSystem.join(this.basePath, relativePath);
+      const stats = await fs.stat(fullPath);
+      return stats.mtime;
+    } catch (error) {
+      return error instanceof Error ? error : new Error(`Failed to get file modified time at ${relativePath}`);
+    }
   }
   /**
    * Get file creation time
    */
   async getFileCreatedTime(relativePath) {
-    const fullPath = this.pathSystem.join(this.basePath, relativePath);
-    const stats = await fs.stat(fullPath);
-    return stats.birthtime;
+    try {
+      const fullPath = this.pathSystem.join(this.basePath, relativePath);
+      const stats = await fs.stat(fullPath);
+      return stats.birthtime;
+    } catch (error) {
+      return error instanceof Error ? error : new Error(`Failed to get file created time at ${relativePath}`);
+    }
   }
 };
 
-// lib/doc-file-system-debug.ts
-var DocFileSystemDebug = class _DocFileSystemDebug extends DocFileSystem {
+// lib/doc-file-system-mock.ts
+var mockDirectoryData = {
+  "docs/index.md": `---
+icon: \u{1F4DA}
+---
+
+# Documentation
+
+Welcome to the documentation!`,
+  "docs/guide/index.md": `---
+icon: \u{1F4D6}
+---
+
+# Guide
+
+This is a guide.`,
+  "docs/guide/getting-started.md": `# Getting Started
+
+Let's get started!`,
+  "docs/guide/advanced.md": `# Advanced
+
+Advanced topics here.`,
+  "docs/api/index.md": `---
+icon: \u{1F527}
+---
+
+# API
+
+API documentation.`,
+  "docs/api/reference.md": `# API Reference
+
+Complete API reference.`
+};
+var DocFileSystemMock = class _DocFileSystemMock extends DocFileSystem {
   files = /* @__PURE__ */ new Map();
   _pathSystem;
   constructor(props) {
     super(props);
     this._pathSystem = props.pathSystem;
+    this.setupTestFiles(mockDirectoryData);
     Object.freeze(this);
   }
   /**
@@ -5077,13 +5305,20 @@ var DocFileSystemDebug = class _DocFileSystemDebug extends DocFileSystem {
   getPathSystem() {
     return this._pathSystem;
   }
+  /**
+   * Create instance (mock data is automatically loaded)
+   */
+  static create(basePath = "/test") {
+    const pathSystem = new DocPathSystem();
+    return new _DocFileSystemMock({ basePath, pathSystem });
+  }
   /**
    * Factory method for testing
    */
   static createWithFiles(props) {
     const pathSystem = new DocPathSystem();
     const basePath = props.basePath ?? "/test";
-    const fileSystem = new _DocFileSystemDebug({ basePath, pathSystem });
+    const fileSystem = new _DocFileSystemMock({ basePath, pathSystem });
     if (props.fileContents) {
       const now = /* @__PURE__ */ new Date();
       for (const [path, content] of Object.entries(props.fileContents)) {
@@ -5098,20 +5333,29 @@ var DocFileSystemDebug = class _DocFileSystemDebug extends DocFileSystem {
     return fileSystem;
   }
   async readFile(filePath) {
-    const normalizedPath = filePath.startsWith("docs/") ? filePath : `docs/${filePath}`;
-    const file = this.files.get(normalizedPath);
-    return file ? file.content : null;
+    try {
+      const normalizedPath = filePath.startsWith("docs/") ? filePath : `docs/${filePath}`;
+      const file = this.files.get(normalizedPath);
+      return file ? file.content : null;
+    } catch (error) {
+      return error instanceof Error ? error : new Error(`Failed to read file at ${filePath}`);
+    }
   }
   async writeFile(filePath, content) {
-    const normalizedPath = filePath.startsWith("docs/") ? filePath : `docs/${filePath}`;
-    const now = /* @__PURE__ */ new Date();
-    const existing = this.files.get(normalizedPath);
-    this.files.set(normalizedPath, {
-      content,
-      modifiedTime: now,
-      createdTime: existing?.createdTime ?? now,
-      size: new TextEncoder().encode(content).length
-    });
+    try {
+      const normalizedPath = filePath.startsWith("docs/") ? filePath : `docs/${filePath}`;
+      const now = /* @__PURE__ */ new Date();
+      const existing = this.files.get(normalizedPath);
+      this.files.set(normalizedPath, {
+        content,
+        modifiedTime: now,
+        createdTime: existing?.createdTime ?? now,
+        size: new TextEncoder().encode(content).length
+      });
+      return null;
+    } catch (error) {
+      return error instanceof Error ? error : new Error(`Failed to write file at ${filePath}`);
+    }
   }
   async deleteFile(filePath) {
     const normalizedPath = filePath.startsWith("docs/") ? filePath : `docs/${filePath}`;
@@ -5136,26 +5380,36 @@ var DocFileSystemDebug = class _DocFileSystemDebug extends DocFileSystem {
     return false;
   }
   async copyFile(source, destination) {
-    const normalizedSource = source.startsWith("docs/") ? source : `docs/${source}`;
-    const normalizedDest = destination.startsWith("docs/") ? destination : `docs/${destination}`;
-    const file = this.files.get(normalizedSource);
-    if (!file) {
-      throw new Error(`Source file not found: ${normalizedSource}`);
-    }
-    this.files.set(normalizedDest, {
-      ...file,
-      createdTime: /* @__PURE__ */ new Date()
-    });
+    try {
+      const normalizedSource = source.startsWith("docs/") ? source : `docs/${source}`;
+      const normalizedDest = destination.startsWith("docs/") ? destination : `docs/${destination}`;
+      const file = this.files.get(normalizedSource);
+      if (!file) {
+        return new Error(`Source file not found: ${normalizedSource}`);
+      }
+      this.files.set(normalizedDest, {
+        ...file,
+        createdTime: /* @__PURE__ */ new Date()
+      });
+      return null;
+    } catch (error) {
+      return error instanceof Error ? error : new Error(`Failed to copy file from ${source} to ${destination}`);
+    }
   }
   async moveFile(source, destination) {
-    const normalizedSource = source.startsWith("docs/") ? source : `docs/${source}`;
-    const normalizedDest = destination.startsWith("docs/") ? destination : `docs/${destination}`;
-    const file = this.files.get(normalizedSource);
-    if (!file) {
-      throw new Error(`Source file not found: ${normalizedSource}`);
+    try {
+      const normalizedSource = source.startsWith("docs/") ? source : `docs/${source}`;
+      const normalizedDest = destination.startsWith("docs/") ? destination : `docs/${destination}`;
+      const file = this.files.get(normalizedSource);
+      if (!file) {
+        return new Error(`Source file not found: ${normalizedSource}`);
+      }
+      this.files.set(normalizedDest, file);
+      this.files.delete(normalizedSource);
+      return null;
+    } catch (error) {
+      return error instanceof Error ? error : new Error(`Failed to move file from ${source} to ${destination}`);
     }
-    this.files.set(normalizedDest, file);
-    this.files.delete(normalizedSource);
   }
   async readDirectory(directoryPath) {
     const dirPath = directoryPath.endsWith("/") ? directoryPath : `${directoryPath}/`;
@@ -5182,16 +5436,21 @@ var DocFileSystemDebug = class _DocFileSystemDebug extends DocFileSystem {
     return files.sort();
   }
   async readDirectoryFilePaths(directoryPath) {
-    const dirPath = directoryPath.endsWith("/") ? directoryPath : `${directoryPath}/`;
-    const files = [];
-    for (const path of this.files.keys()) {
-      if (path.startsWith(dirPath) && !path.slice(dirPath.length).includes("/")) {
-        files.push(path);
+    try {
+      const dirPath = directoryPath.endsWith("/") ? directoryPath : `${directoryPath}/`;
+      const files = [];
+      for (const path of this.files.keys()) {
+        if (path.startsWith(dirPath) && !path.slice(dirPath.length).includes("/")) {
+          files.push(path);
+        }
       }
+      return files.sort();
+    } catch (error) {
+      return error instanceof Error ? error : new Error(`Failed to read directory file paths at ${directoryPath}`);
     }
-    return files.sort();
   }
   async createDirectory(_directoryPath) {
+    return null;
   }
   async deleteDirectory(directoryPath) {
     const dirPath = directoryPath.endsWith("/") ? directoryPath : `${directoryPath}/`;
@@ -5202,28 +5461,40 @@ var DocFileSystemDebug = class _DocFileSystemDebug extends DocFileSystem {
     }
   }
   async getFileSize(filePath) {
-    const normalizedPath = filePath.startsWith("docs/") ? filePath : `docs/${filePath}`;
-    const file = this.files.get(normalizedPath);
-    if (!file) {
-      throw new Error(`File not found: ${normalizedPath}`);
+    try {
+      const normalizedPath = filePath.startsWith("docs/") ? filePath : `docs/${filePath}`;
+      const file = this.files.get(normalizedPath);
+      if (!file) {
+        return new Error(`File not found: ${normalizedPath}`);
+      }
+      return file.size;
+    } catch (error) {
+      return error instanceof Error ? error : new Error(`Failed to get file size at ${filePath}`);
     }
-    return file.size;
   }
   async getFileModifiedTime(filePath) {
-    const normalizedPath = filePath.startsWith("docs/") ? filePath : `docs/${filePath}`;
-    const file = this.files.get(normalizedPath);
-    if (!file) {
-      throw new Error(`File not found: ${normalizedPath}`);
+    try {
+      const normalizedPath = filePath.startsWith("docs/") ? filePath : `docs/${filePath}`;
+      const file = this.files.get(normalizedPath);
+      if (!file) {
+        return new Error(`File not found: ${normalizedPath}`);
+      }
+      return file.modifiedTime;
+    } catch (error) {
+      return error instanceof Error ? error : new Error(`Failed to get file modified time at ${filePath}`);
     }
-    return file.modifiedTime;
   }
   async getFileCreatedTime(filePath) {
-    const normalizedPath = filePath.startsWith("docs/") ? filePath : `docs/${filePath}`;
-    const file = this.files.get(normalizedPath);
-    if (!file) {
-      throw new Error(`File not found: ${normalizedPath}`);
+    try {
+      const normalizedPath = filePath.startsWith("docs/") ? filePath : `docs/${filePath}`;
+      const file = this.files.get(normalizedPath);
+      if (!file) {
+        return new Error(`File not found: ${normalizedPath}`);
+      }
+      return file.createdTime;
+    } catch (error) {
+      return error instanceof Error ? error : new Error(`Failed to get file created time at ${filePath}`);
     }
-    return file.createdTime;
   }
   async isDirectory(relativePath) {
     const normalizedPath = relativePath.startsWith("docs/") ? relativePath : `docs/${relativePath}`;
@@ -5243,19 +5514,23 @@ var DocFileSystemDebug = class _DocFileSystemDebug extends DocFileSystem {
    * Get list of entries in directory
    */
   async readDirectoryFileNames(directoryPath = "") {
-    const normalizedDir = directoryPath === "" ? "docs" : directoryPath.startsWith("docs/") ? directoryPath : `docs/${directoryPath}`;
-    const dirPath = normalizedDir.endsWith("/") ? normalizedDir : `${normalizedDir}/`;
-    const entries = /* @__PURE__ */ new Set();
-    for (const path of this.files.keys()) {
-      if (path.startsWith(dirPath)) {
-        const relativePath = path.slice(dirPath.length);
-        const firstSegment = relativePath.split("/")[0];
-        if (firstSegment) {
-          entries.add(firstSegment);
+    try {
+      const normalizedDir = directoryPath === "" ? "docs" : directoryPath === "docs" ? "docs" : directoryPath.startsWith("docs/") ? directoryPath : `docs/${directoryPath}`;
+      const dirPath = normalizedDir.endsWith("/") ? normalizedDir : `${normalizedDir}/`;
+      const entries = /* @__PURE__ */ new Set();
+      for (const path of this.files.keys()) {
+        if (path.startsWith(dirPath)) {
+          const relativePath = path.slice(dirPath.length);
+          const firstSegment = relativePath.split("/")[0];
+          if (firstSegment) {
+            entries.add(firstSegment);
+          }
         }
       }
+      return Array.from(entries).sort();
+    } catch (error) {
+      return error instanceof Error ? error : new Error(`Failed to read directory at ${directoryPath}`);
     }
-    return Array.from(entries).sort();
   }
   /**
    * Check if directory exists
@@ -5273,6 +5548,7 @@ var DocFileSystemDebug = class _DocFileSystemDebug extends DocFileSystem {
    * Create directory if it doesn't exist
    */
   async ensureDirectoryExists(_relativePath) {
+    return null;
   }
   /**
    * Clear all files
@@ -5320,6 +5596,109 @@ var DocFileSystemDebug = class _DocFileSystemDebug extends DocFileSystem {
   }
 };
 
+// lib/doc-path-system-mock.ts
+var DocPathSystemMock = class _DocPathSystemMock extends DocPathSystem {
+  _separator;
+  constructor(separator = "/") {
+    super();
+    this._separator = separator;
+    Object.freeze(this);
+  }
+  join(...paths) {
+    return paths.filter((path) => path !== "").join(this._separator).replace(new RegExp(`${this._separator}+`, "g"), this._separator);
+  }
+  basename(path, ext) {
+    const normalizedPath = path.replace(/\\/g, "/");
+    const lastSlashIndex = normalizedPath.lastIndexOf("/");
+    let base = lastSlashIndex === -1 ? normalizedPath : normalizedPath.slice(lastSlashIndex + 1);
+    if (ext && base.endsWith(ext)) {
+      base = base.slice(0, -ext.length);
+    }
+    return base;
+  }
+  dirname(path) {
+    const normalizedPath = path.replace(/\\/g, "/");
+    const lastSlashIndex = normalizedPath.lastIndexOf("/");
+    if (lastSlashIndex === -1) {
+      return ".";
+    }
+    if (lastSlashIndex === 0) {
+      return "/";
+    }
+    return normalizedPath.slice(0, lastSlashIndex);
+  }
+  extname(path) {
+    const base = this.basename(path);
+    const lastDotIndex = base.lastIndexOf(".");
+    if (lastDotIndex === -1 || lastDotIndex === 0) {
+      return "";
+    }
+    return base.slice(lastDotIndex);
+  }
+  relative(from, to) {
+    const fromParts = from.split("/").filter(Boolean);
+    const toParts = to.split("/").filter(Boolean);
+    let commonLength = 0;
+    for (let i = 0; i < Math.min(fromParts.length, toParts.length); i++) {
+      if (fromParts[i] === toParts[i]) {
+        commonLength++;
+      } else {
+        break;
+      }
+    }
+    const upLevels = fromParts.length - commonLength;
+    const downParts = toParts.slice(commonLength);
+    const result = Array(upLevels).fill("..").concat(downParts);
+    return result.length === 0 ? "." : result.join("/");
+  }
+  resolve(...paths) {
+    let resolved = "";
+    let isAbsolute = false;
+    for (let i = paths.length - 1; i >= 0 && !isAbsolute; i--) {
+      const path = paths[i];
+      if (path) {
+        resolved = path + (resolved ? `/${resolved}` : "");
+        isAbsolute = path.startsWith("/");
+      }
+    }
+    if (!isAbsolute) {
+      resolved = `/mock-cwd/${resolved}`;
+    }
+    return this.normalize(resolved);
+  }
+  normalize(path) {
+    if (!path) return ".";
+    const isAbsolute = path.startsWith("/");
+    const parts = path.split("/").filter(Boolean);
+    const normalizedParts = [];
+    for (const part of parts) {
+      if (part === "..") {
+        if (normalizedParts.length > 0 && normalizedParts[normalizedParts.length - 1] !== "..") {
+          normalizedParts.pop();
+        } else if (!isAbsolute) {
+          normalizedParts.push("..");
+        }
+      } else if (part !== ".") {
+        normalizedParts.push(part);
+      }
+    }
+    const result = (isAbsolute ? "/" : "") + normalizedParts.join("/");
+    return result || (isAbsolute ? "/" : ".");
+  }
+  isAbsolute(path) {
+    return path.startsWith("/");
+  }
+  get sep() {
+    return this._separator;
+  }
+  /**
+   * Set custom separator for testing
+   */
+  static createWithSeparator(separator) {
+    return new _DocPathSystemMock(separator);
+  }
+};
+
 // lib/doc-schema-builder.ts
 var DocSchemaBuilder = class _DocSchemaBuilder {
   constructor(schema = {}) {
@@ -5489,12 +5868,13 @@ export {
   DocFileMdReference,
   DocFileRelationReference,
   DocFileSystem,
-  DocFileSystemDebug,
+  DocFileSystemMock,
   DocFileTreeSystem,
   DocFileUnknownEntity,
   DocFileUnknownReference,
   DocMarkdownSystem,
   DocPathSystem,
+  DocPathSystemMock,
   DocSchemaBuilder,
   assertType,
   defaultTestConfig,