@interactive-inc/docs-client 1.0.1 → 1.0.2

package/build/index.d.ts

@@ -55,11 +55,11 @@ declare class DocFileSystem {
     /**
      * Read file content at the specified path
      */
-    readFile(relativePath: string): Promise<string | null>;
+    readFile(relativePath: string): Promise<string | null | Error>;
     /**
      * Write content to file at the specified path (creates directory if needed)
      */
-    writeFile(relativePath: string, content: string): Promise<void>;
+    writeFile(relativePath: string, content: string): Promise<Error | null>;
     /**
      * Delete file at the specified path
      */
@@ -79,8 +79,8 @@ declare class DocFileSystem {
     /**
      * Get list of entries in directory
      */
-    readDirectoryFileNames(relativePath?: string): Promise<string[]>;
-    readDirectoryFilePaths(relativePath: string): Promise<string[]>;
+    readDirectoryFileNames(relativePath?: string): Promise<string[] | Error>;
+    readDirectoryFilePaths(relativePath: string): Promise<string[] | Error>;
     /**
      * Check if path is a directory
      */
@@ -112,31 +112,31 @@ declare class DocFileSystem {
     /**
      * Create directory
      */
-    createDirectory(relativePath: string): Promise<void>;
+    createDirectory(relativePath: string): Promise<Error | null>;
     /**
      * Get file size in bytes
      */
-    getFileSize(relativePath: string): Promise<number>;
+    getFileSize(relativePath: string): Promise<number | Error>;
     /**
      * Create directory if it doesn't exist
      */
-    ensureDirectoryExists(relativePath: string): Promise<void>;
+    ensureDirectoryExists(relativePath: string): Promise<Error | null>;
     /**
      * Copy file
      */
-    copyFile(sourcePath: string, destinationPath: string): Promise<void>;
+    copyFile(sourcePath: string, destinationPath: string): Promise<Error | null>;
     /**
      * Move file
      */
-    moveFile(sourcePath: string, destinationPath: string): Promise<void>;
+    moveFile(sourcePath: string, destinationPath: string): Promise<Error | null>;
     /**
      * Get file last modified time
      */
-    getFileModifiedTime(relativePath: string): Promise<Date>;
+    getFileModifiedTime(relativePath: string): Promise<Date | Error>;
     /**
      * Get file creation time
      */
-    getFileCreatedTime(relativePath: string): Promise<Date>;
+    getFileCreatedTime(relativePath: string): Promise<Date | Error>;
 }
 
 /**
@@ -307,12 +307,12 @@ declare class DocFileMdReference<T extends DocCustomSchema> {
     /**
      * Write entity
      */
-    write(entity: DocFileMdEntity<T>): Promise<null>;
-    writeText(text: string): Promise<void>;
+    write(entity: DocFileMdEntity<T>): Promise<Error | null>;
+    writeText(text: string): Promise<Error | null>;
     /**
      * Create new file with default content
      */
-    writeDefault(): Promise<void>;
+    writeDefault(): Promise<Error | null>;
     /**
      * Delete file
      */
@@ -320,11 +320,11 @@ declare class DocFileMdReference<T extends DocCustomSchema> {
     /**
      * Copy file
      */
-    copyTo(destinationPath: string): Promise<void>;
+    copyTo(destinationPath: string): Promise<Error | null>;
     /**
      * Move file
      */
-    moveTo(destinationPath: string): Promise<void>;
+    moveTo(destinationPath: string): Promise<Error | null>;
     /**
      * Move file to archive and return new reference
      */
@@ -336,15 +336,15 @@ declare class DocFileMdReference<T extends DocCustomSchema> {
     /**
      * Get file size in bytes
      */
-    size(): Promise<number>;
+    size(): Promise<number | Error>;
     /**
      * Get file last modified time
      */
-    lastModified(): Promise<Date>;
+    lastModified(): Promise<Date | Error>;
     /**
      * Get file creation time
      */
-    createdAt(): Promise<Date>;
+    createdAt(): Promise<Date | Error>;
     directory(): DocDirectoryReference<T>;
     /**
      * Get relation based on schema
@@ -422,15 +422,15 @@ declare class DocFileUnknownReference {
     /**
      * Write content to file
      */
-    writeContent(content: string): Promise<void>;
+    writeContent(content: string): Promise<Error | null>;
     /**
      * Write entity
      */
-    write(entity: DocFileUnknownEntity): Promise<void>;
+    write(entity: DocFileUnknownEntity): Promise<Error | null>;
     /**
      * Write raw content
      */
-    writeRaw(content: string): Promise<void>;
+    writeRaw(content: string): Promise<Error | null>;
     /**
      * Delete file
      */
@@ -442,23 +442,23 @@ declare class DocFileUnknownReference {
     /**
      * Copy file
      */
-    copyTo(destinationPath: string): Promise<void>;
+    copyTo(destinationPath: string): Promise<Error | null>;
     /**
      * Move file
      */
-    moveTo(destinationPath: string): Promise<void>;
+    moveTo(destinationPath: string): Promise<Error | null>;
     /**
      * Get file size in bytes
      */
-    size(): Promise<number>;
+    size(): Promise<number | Error>;
     /**
      * Get file last modified time
      */
-    lastModified(): Promise<Date>;
+    lastModified(): Promise<Date | Error>;
     /**
      * Get file creation time
      */
-    createdAt(): Promise<Date>;
+    createdAt(): Promise<Date | Error>;
     /**
      * Move file to archive and return new reference
      */
@@ -1172,15 +1172,15 @@ declare class DocFileRelationReference {
      * Full path
      */
     get fullPath(): string;
-    read(): Promise<DocRelationValue | null>;
+    read(): Promise<DocRelationValue | Error | null>;
     /**
      * Read list of relation files
      */
-    readFiles(): Promise<DocRelationFileValue[]>;
+    readFiles(): Promise<DocRelationFileValue[] | Error>;
     /**
      * Read single relation file
      */
-    readFile(filePath: string): Promise<DocRelationFileValue | null>;
+    readFile(filePath: string): Promise<DocRelationFileValue | Error | null>;
     /**
      * Check if file exists
      */
@@ -1188,15 +1188,15 @@ declare class DocFileRelationReference {
     /**
      * Get list of file names (without extension)
      */
-    readSlugs(): Promise<string[]>;
+    readSlugs(): Promise<string[] | Error>;
     /**
      * Get file count
      */
-    count(): Promise<number>;
+    count(): Promise<number | Error>;
     /**
      * Check if empty
      */
-    isEmpty(): Promise<boolean>;
+    isEmpty(): Promise<boolean | Error>;
 }
 
 /**
@@ -1416,7 +1416,7 @@ declare class DocFileIndexReference<T extends DocCustomSchema> {
     get filePath(): string;
     get fileFullPath(): string;
     get durectoryPath(): string;
-    read(): Promise<DocFileIndexEntity<T>>;
+    read(): Promise<DocFileIndexEntity<T> | Error>;
     /**
      * Read file content
      */
@@ -1424,15 +1424,15 @@ declare class DocFileIndexReference<T extends DocCustomSchema> {
     /**
      * Write content to file
      */
-    writeContent(content: string): Promise<void>;
+    writeContent(content: string): Promise<Error | null>;
     /**
      * Write entity
      */
-    write(entity: DocFileIndexEntity<T>): Promise<void>;
+    write(entity: DocFileIndexEntity<T>): Promise<Error | null>;
     /**
      * Create new file with default content
      */
-    writeDefault(): Promise<null>;
+    writeDefault(): Promise<Error | null>;
     /**
      * Delete file
      */
@@ -1441,20 +1441,20 @@ declare class DocFileIndexReference<T extends DocCustomSchema> {
      * Check if file exists
      */
     exists(): Promise<boolean>;
-    relations(): Promise<DocFileRelationReference[]>;
-    readRelations(): Promise<DocRelationValue[]>;
+    relations(): Promise<DocFileRelationReference[] | Error>;
+    readRelations(): Promise<DocRelationValue[] | Error>;
     /**
      * Get file size in bytes
      */
-    size(): Promise<number>;
+    size(): Promise<number | Error>;
     /**
      * Get last modified date
      */
-    lastModified(): Promise<Date>;
+    lastModified(): Promise<Date | Error>;
     /**
      * Get file creation date
      */
-    createdAt(): Promise<Date>;
+    createdAt(): Promise<Date | Error>;
     /**
      * Move file to archive and return new reference
      */
@@ -1490,25 +1490,25 @@ declare class DocDirectoryReference<T extends DocCustomSchema> {
     get indexFileName(): string;
     get indexFilePath(): string;
     get archiveDirectoryName(): string;
-    fileNames(): Promise<string[]>;
-    archivedFileNames(): Promise<string[]>;
-    filesGenerator(): AsyncGenerator<DocFileMdReference<T> | DocFileUnknownReference, void, unknown>;
-    mdFilesGenerator(): AsyncGenerator<DocFileMdReference<T>, void, unknown>;
-    files(): Promise<(DocFileMdReference<T> | DocFileUnknownReference)[]>;
-    mdFiles(): Promise<DocFileMdReference<T>[]>;
+    fileNames(): Promise<string[] | Error>;
+    archivedFileNames(): Promise<string[] | Error>;
+    filesGenerator(): AsyncGenerator<DocFileMdReference<T> | DocFileUnknownReference | Error, void, unknown>;
+    mdFilesGenerator(): AsyncGenerator<DocFileMdReference<T> | Error, void, unknown>;
+    files(): Promise<(DocFileMdReference<T> | DocFileUnknownReference)[] | Error>;
+    mdFiles(): Promise<DocFileMdReference<T>[] | Error>;
     file<FileName extends string>(fileName: FileName): InferReference<FileName, T>;
     mdFile(fileName: string): DocFileMdReference<T>;
-    readFiles(): Promise<(DocFileMdEntity<T> | DocFileUnknownEntity)[]>;
-    readMdFiles(): Promise<DocFileMdEntity<T>[]>;
-    readUnknownFiles(): Promise<DocFileUnknownEntity[]>;
+    readFiles(): Promise<(DocFileMdEntity<T> | DocFileUnknownEntity)[] | Error>;
+    readMdFiles(): Promise<DocFileMdEntity<T>[] | Error>;
+    readUnknownFiles(): Promise<DocFileUnknownEntity[] | Error>;
     /**
      * Get list of subdirectory names
      */
-    directoryNames(): Promise<string[]>;
+    directoryNames(): Promise<string[] | Error>;
     /**
      * Get subdirectory references
      */
-    directories(): Promise<DocDirectoryReference<T>[]>;
+    directories(): Promise<DocDirectoryReference<T>[] | Error>;
     /**
      * Get single subdirectory reference
      */
@@ -1611,7 +1611,7 @@ declare class DocFileTreeSystem {
     /**
      * Build file tree recursively
      */
-    buildFileTree(directoryPath?: string): Promise<DocTreeNodeValue[]>;
+    buildFileTree(directoryPath?: string): Promise<DocTreeNodeValue[] | Error>;
     /**
      * Create file node
      */
@@ -1631,7 +1631,7 @@ declare class DocFileTreeSystem {
     /**
      * Build directory tree recursively (directories only)
      */
-    buildDirectoryTree(directoryPath?: string): Promise<DocTreeDirectoryNodeValue[]>;
+    buildDirectoryTree(directoryPath?: string): Promise<DocTreeDirectoryNodeValue[] | Error>;
     /**
      * Create directory node for directory tree
      */
@@ -1737,26 +1737,26 @@ declare class DocFileSystemMock extends DocFileSystem {
         basePath?: string;
         fileContents?: Record<string, string>;
     }): DocFileSystemMock;
-    readFile(filePath: string): Promise<string | null>;
-    writeFile(filePath: string, content: string): Promise<void>;
+    readFile(filePath: string): Promise<string | null | Error>;
+    writeFile(filePath: string, content: string): Promise<Error | null>;
     deleteFile(filePath: string): Promise<Error | null>;
     exists(filePath: string): Promise<boolean>;
-    copyFile(source: string, destination: string): Promise<void>;
-    moveFile(source: string, destination: string): Promise<void>;
+    copyFile(source: string, destination: string): Promise<Error | null>;
+    moveFile(source: string, destination: string): Promise<Error | null>;
     readDirectory(directoryPath: string): Promise<string[]>;
     readDirectoryRecursive(directoryPath: string): Promise<string[]>;
-    readDirectoryFilePaths(directoryPath: string): Promise<string[]>;
-    createDirectory(_directoryPath: string): Promise<void>;
+    readDirectoryFilePaths(directoryPath: string): Promise<string[] | Error>;
+    createDirectory(_directoryPath: string): Promise<Error | null>;
     deleteDirectory(directoryPath: string): Promise<void>;
-    getFileSize(filePath: string): Promise<number>;
-    getFileModifiedTime(filePath: string): Promise<Date>;
-    getFileCreatedTime(filePath: string): Promise<Date>;
+    getFileSize(filePath: string): Promise<number | Error>;
+    getFileModifiedTime(filePath: string): Promise<Date | Error>;
+    getFileCreatedTime(filePath: string): Promise<Date | Error>;
     isDirectory(relativePath: string): Promise<boolean>;
     isFile(relativePath: string): Promise<boolean>;
     /**
      * Get list of entries in directory
      */
-    readDirectoryFileNames(directoryPath?: string): Promise<string[]>;
+    readDirectoryFileNames(directoryPath?: string): Promise<string[] | Error>;
     /**
      * Check if directory exists
      */
@@ -1768,7 +1768,7 @@ declare class DocFileSystemMock extends DocFileSystem {
     /**
      * Create directory if it doesn't exist
      */
-    ensureDirectoryExists(_relativePath: string): Promise<void>;
+    ensureDirectoryExists(_relativePath: string): Promise<Error | null>;
     /**
      * Clear all files
      */

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,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}`);
+    }
   }
 };
 
@@ -5138,20 +5333,29 @@ 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 = 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}`;
@@ -5176,26 +5380,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 = 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}/`;
@@ -5222,16 +5436,21 @@ 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 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}/`;
@@ -5242,28 +5461,40 @@ 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 = 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}`;
@@ -5283,19 +5514,23 @@ var DocFileSystemMock = class _DocFileSystemMock extends DocFileSystem {
    * 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 === "" ? "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
@@ -5313,6 +5548,7 @@ var DocFileSystemMock = class _DocFileSystemMock extends DocFileSystem {
    * Create directory if it doesn't exist
    */
   async ensureDirectoryExists(_relativePath) {
+    return null;
   }
   /**
    * Clear all files

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@interactive-inc/docs-client",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "type": "module",
   "scripts": {
     "check": "tsgo --noEmit",