@interactive-inc/docs-client 1.0.1 → 1.0.3

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;
   }
 };
@@ -3178,7 +3199,7 @@ schema: {}
 ${yamlStr}
 ---
 
-${this.body}`;
+${this.toMarkdownText()}`;
   }
   /**
    * Output in JSON format
@@ -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,56 +5165,95 @@ 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}`);
+    }
   }
 };
 
@@ -5098,10 +5293,14 @@ Complete API reference.`
 var DocFileSystemMock = class _DocFileSystemMock extends DocFileSystem {
   files = /* @__PURE__ */ new Map();
   _pathSystem;
+  _basePath;
   constructor(props) {
     super(props);
     this._pathSystem = props.pathSystem;
-    this.setupTestFiles(mockDirectoryData);
+    this._basePath = props.basePath.endsWith("/") ? props.basePath.slice(0, -1) : props.basePath;
+    if (!props.skipDefaultFiles) {
+      this.setupTestFiles(mockDirectoryData);
+    }
     Object.freeze(this);
   }
   /**
@@ -5110,6 +5309,16 @@ var DocFileSystemMock = class _DocFileSystemMock extends DocFileSystem {
   getPathSystem() {
     return this._pathSystem;
   }
+  /**
+   * Normalize path using basePath
+   */
+  normalizePath(filePath) {
+    if (filePath.startsWith(this._basePath)) {
+      return filePath;
+    }
+    const cleanPath = filePath.startsWith("/") ? filePath.slice(1) : filePath;
+    return `${this._basePath}/${cleanPath}`;
+  }
   /**
    * Create instance (mock data is automatically loaded)
    */
@@ -5123,11 +5332,17 @@ var DocFileSystemMock = class _DocFileSystemMock extends DocFileSystem {
   static createWithFiles(props) {
     const pathSystem = new DocPathSystem();
     const basePath = props.basePath ?? "/test";
-    const fileSystem = new _DocFileSystemMock({ basePath, pathSystem });
+    const fileSystem = new _DocFileSystemMock({
+      basePath,
+      pathSystem,
+      skipDefaultFiles: true
+    });
     if (props.fileContents) {
       const now = /* @__PURE__ */ new Date();
       for (const [path, content] of Object.entries(props.fileContents)) {
-        fileSystem.files.set(path, {
+        const cleanPath = path.startsWith("/") ? path.slice(1) : path;
+        const normalizedPath = path.startsWith(basePath) ? path : `${basePath}/${cleanPath}`;
+        fileSystem.files.set(normalizedPath, {
           content,
           modifiedTime: now,
           createdTime: now,
@@ -5138,24 +5353,33 @@ var DocFileSystemMock = class _DocFileSystemMock 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 = this.normalizePath(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 = this.normalizePath(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}`;
     try {
+      const normalizedPath = this.normalizePath(filePath);
       this.files.delete(normalizedPath);
       return null;
     } catch (error) {
@@ -5163,7 +5387,7 @@ var DocFileSystemMock = class _DocFileSystemMock extends DocFileSystem {
     }
   }
   async exists(filePath) {
-    const normalizedPath = filePath.startsWith("docs/") ? filePath : `docs/${filePath}`;
+    const normalizedPath = this.normalizePath(filePath);
     if (this.files.has(normalizedPath)) {
       return true;
     }
@@ -5176,26 +5400,36 @@ var DocFileSystemMock = class _DocFileSystemMock 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 = this.normalizePath(source);
+      const normalizedDest = this.normalizePath(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 = this.normalizePath(source);
+      const normalizedDest = this.normalizePath(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}/`;
@@ -5222,16 +5456,23 @@ var DocFileSystemMock = class _DocFileSystemMock 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 normalizedDir = this.normalizePath(directoryPath);
+      const dirPath = normalizedDir.endsWith("/") ? normalizedDir : `${normalizedDir}/`;
+      const files = [];
+      for (const path of this.files.keys()) {
+        if (path.startsWith(dirPath) && !path.slice(dirPath.length).includes("/")) {
+          const relativePath = path.startsWith(`${this._basePath}/`) ? path.slice(this._basePath.length + 1) : path;
+          files.push(relativePath);
+        }
       }
+      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}/`;
@@ -5242,31 +5483,43 @@ var DocFileSystemMock = class _DocFileSystemMock 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 = this.normalizePath(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 = this.normalizePath(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 = this.normalizePath(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}`;
+    const normalizedPath = this.normalizePath(relativePath);
     const dirPath = normalizedPath.endsWith("/") ? normalizedPath : `${normalizedPath}/`;
     for (const path of this.files.keys()) {
       if (path.startsWith(dirPath)) {
@@ -5276,26 +5529,30 @@ var DocFileSystemMock = class _DocFileSystemMock extends DocFileSystem {
     return false;
   }
   async isFile(relativePath) {
-    const normalizedPath = relativePath.startsWith("docs/") ? relativePath : `docs/${relativePath}`;
+    const normalizedPath = this.normalizePath(relativePath);
     return this.files.has(normalizedPath);
   }
   /**
    * Get list of entries in directory
    */
   async readDirectoryFileNames(directoryPath = "") {
-    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);
+    try {
+      const normalizedDir = directoryPath === "" ? this._basePath : this.normalizePath(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
@@ -5313,6 +5570,7 @@ var DocFileSystemMock = class _DocFileSystemMock extends DocFileSystem {
    * Create directory if it doesn't exist
    */
   async ensureDirectoryExists(_relativePath) {
+    return null;
   }
   /**
    * Clear all files
@@ -5324,19 +5582,23 @@ var DocFileSystemMock = class _DocFileSystemMock extends DocFileSystem {
    * Check file existence (for testing)
    */
   hasFile(filePath) {
-    return this.files.has(filePath);
+    const normalizedPath = this.normalizePath(filePath);
+    return this.files.has(normalizedPath);
   }
   /**
    * Get file content (sync version, for testing)
    */
   getFileContent(filePath) {
-    return this.files.get(filePath)?.content;
+    const normalizedPath = this.normalizePath(filePath);
+    return this.files.get(normalizedPath)?.content;
   }
   /**
    * Get all file paths (for testing)
    */
   getAllFilePaths() {
-    return Array.from(this.files.keys()).sort();
+    return Array.from(this.files.keys()).map((path) => {
+      return path.startsWith(`${this._basePath}/`) ? path.slice(this._basePath.length + 1) : path;
+    }).sort();
   }
   /**
    * Get file count (for testing)
@@ -5350,7 +5612,8 @@ var DocFileSystemMock = class _DocFileSystemMock extends DocFileSystem {
   setupTestFiles(files) {
     const now = /* @__PURE__ */ new Date();
     for (const [path, content] of Object.entries(files)) {
-      this.files.set(path, {
+      const normalizedPath = this.normalizePath(path);
+      this.files.set(normalizedPath, {
         content,
         modifiedTime: now,
         createdTime: now,