@axiom-lattice/core 2.1.88 → 2.1.89

package/dist/index.d.mts

@@ -1410,6 +1410,26 @@ interface BackendProtocol {
      * @returns Raw file content as FileData
      */
     readRaw(filePath: string): MaybePromise<FileData>;
+    /**
+     * Read file content as raw binary Buffer.
+     *
+     * Optional method for backends that support binary file access.
+     * Backends that store files as text (StateBackend, MemoryBackend, StoreBackend)
+     * may omit this method.
+     *
+     * @param filePath - Absolute file path
+     * @returns Raw file content as Buffer
+     */
+    readBinary?(filePath: string): Promise<Buffer>;
+    /**
+     * Write raw binary data to a file.
+     *
+     * Optional method for backends that support binary file writing.
+     *
+     * @param filePath - Absolute file path
+     * @param data - Binary data to write
+     */
+    writeBinary?(filePath: string, data: Buffer): Promise<void>;
     /**
      * Structured search results or error string for invalid input.
      *
@@ -5582,6 +5602,8 @@ declare class VolumeFilesystem implements BackendProtocol {
     lsInfo(path: string): Promise<FileInfo[]>;
     read(filePath: string, offset?: number, limit?: number): Promise<string>;
     readRaw(filePath: string): Promise<FileData>;
+    readBinary(filePath: string): Promise<Buffer>;
+    writeBinary(filePath: string, data: Buffer): Promise<void>;
     grepRaw(_pattern: string, _path?: string | null, _glob?: string | null): string | GrepMatch[];
     globInfo(_pattern: string, _path?: string): FileInfo[];
     write(filePath: string, content: string): Promise<WriteResult>;

package/dist/index.d.ts

@@ -1410,6 +1410,26 @@ interface BackendProtocol {
      * @returns Raw file content as FileData
      */
     readRaw(filePath: string): MaybePromise<FileData>;
+    /**
+     * Read file content as raw binary Buffer.
+     *
+     * Optional method for backends that support binary file access.
+     * Backends that store files as text (StateBackend, MemoryBackend, StoreBackend)
+     * may omit this method.
+     *
+     * @param filePath - Absolute file path
+     * @returns Raw file content as Buffer
+     */
+    readBinary?(filePath: string): Promise<Buffer>;
+    /**
+     * Write raw binary data to a file.
+     *
+     * Optional method for backends that support binary file writing.
+     *
+     * @param filePath - Absolute file path
+     * @param data - Binary data to write
+     */
+    writeBinary?(filePath: string, data: Buffer): Promise<void>;
     /**
      * Structured search results or error string for invalid input.
      *
@@ -5582,6 +5602,8 @@ declare class VolumeFilesystem implements BackendProtocol {
     lsInfo(path: string): Promise<FileInfo[]>;
     read(filePath: string, offset?: number, limit?: number): Promise<string>;
     readRaw(filePath: string): Promise<FileData>;
+    readBinary(filePath: string): Promise<Buffer>;
+    writeBinary(filePath: string, data: Buffer): Promise<void>;
     grepRaw(_pattern: string, _path?: string | null, _glob?: string | null): string | GrepMatch[];
     globInfo(_pattern: string, _path?: string): FileInfo[];
     write(filePath: string, content: string): Promise<WriteResult>;

package/dist/index.js

@@ -7482,7 +7482,8 @@ var VolumeFilesystem = class {
     }).join("\n");
   }
   async readRaw(filePath) {
-    const content = await this.client.read(filePath);
+    const buf = await this.client.readRaw(filePath);
+    const content = buf.toString("utf-8");
     const lines = content.split("\n");
     const now = (/* @__PURE__ */ new Date()).toISOString();
     return {
@@ -7491,6 +7492,12 @@ var VolumeFilesystem = class {
       modified_at: now
     };
   }
+  async readBinary(filePath) {
+    return this.client.readRaw(filePath);
+  }
+  async writeBinary(filePath, data) {
+    await this.client.writeRaw(filePath, data);
+  }
   grepRaw(_pattern, _path, _glob) {
     throw new Error("Not supported on volume backend");
   }