@powerlines/core 0.48.57 → 0.48.58

package/dist/lib/vfs.cjs

@@ -26,6 +26,7 @@ let _stryke_fs_resolve = require("@stryke/fs/resolve");
 let _stryke_string_format_pretty_bytes = require("@stryke/string-format/pretty-bytes");
 let _stryke_capnp = require("@stryke/capnp");
 _stryke_capnp = require_runtime.__toESM(_stryke_capnp, 1);
+let _stryke_convert = require("@stryke/convert");
 let _stryke_fs_buffer = require("@stryke/fs/buffer");
 let _stryke_path_correct_path = require("@stryke/path/correct-path");
 let _stryke_path_glob_to_regex = require("@stryke/path/glob-to-regex");
@@ -39,6 +40,9 @@ let node_url = require("node:url");
 function toFilePath(path) {
 	return (0, _stryke_path_correct_path.correctPath)((0, _stryke_path_slash.slash)(path?.toString() || ".").replace(/^file:\/\//, ""));
 }
+function toUint8Array(view) {
+	return new Uint8Array(view.buffer, view.byteOffset, view.byteLength);
+}
 /**
 * Checks if a given file id is valid based on the specified prefix.
 *
@@ -843,7 +847,9 @@ var VirtualFileSystem = class VirtualFileSystem {
 		if (!filePath || !this.existsSync(filePath)) return;
 		const { adapter } = this.#getStorage(filePath);
 		this.#logger.trace(`Reading ${adapter.name} file: ${filePath}`);
-		return await adapter.get(filePath) ?? void 0;
+		const result = await adapter.get(filePath);
+		if (!result) return;
+		return (0, _stryke_type_checks_is_string.isString)(result) ? result : (0, _stryke_convert.uint8ArrayToString)(toUint8Array(result));
 	}
 	/**
 	* Synchronously reads a file from the virtual file system (VFS).
@@ -856,7 +862,39 @@ var VirtualFileSystem = class VirtualFileSystem {
 		if (!filePath || !this.existsSync(filePath)) return;
 		const { adapter } = this.#getStorage(filePath);
 		this.#logger.trace(`Reading ${adapter.name} file: ${filePath}`);
-		return adapter.getSync(filePath) ?? void 0;
+		const result = adapter.getSync(filePath);
+		if (!result) return;
+		return (0, _stryke_type_checks_is_string.isString)(result) ? result : (0, _stryke_convert.uint8ArrayToString)(toUint8Array(result));
+	}
+	/**
+	* Asynchronously reads a file from the virtual file system (VFS) as a buffer.
+	*
+	* @param path - The path or ID of the file to read.
+	* @returns A promise that resolves to the file contents as a buffer, or `undefined` if the file does not exist.
+	*/
+	async readBuffer(path) {
+		const filePath = await this.resolve(path, void 0, { isFile: true });
+		if (!filePath || !this.existsSync(filePath)) return;
+		const { adapter } = this.#getStorage(filePath);
+		this.#logger.trace(`Reading ${adapter.name} file buffer: ${filePath}`);
+		const result = await adapter.get(filePath);
+		if (!result) return;
+		return (0, _stryke_type_checks_is_string.isString)(result) ? (0, _stryke_convert.stringToUint8Array)(result) : result;
+	}
+	/**
+	* Synchronously reads a file from the virtual file system (VFS) as a buffer.
+	*
+	* @param path - The path or ID of the file to read.
+	* @returns The file contents as a buffer, or `undefined` if the file does not exist.
+	*/
+	readBufferSync(path) {
+		const filePath = this.resolveSync(path, void 0, { isFile: true });
+		if (!filePath || !this.existsSync(filePath)) return;
+		const { adapter } = this.#getStorage(filePath);
+		this.#logger.trace(`Reading ${adapter.name} file buffer: ${filePath}`);
+		const result = adapter.getSync(filePath);
+		if (!result) return;
+		return (0, _stryke_type_checks_is_string.isString)(result) ? (0, _stryke_convert.stringToUint8Array)(result) : result;
 	}
 	/**
 	* Writes a file to the virtual file system (VFS).
@@ -870,15 +908,14 @@ var VirtualFileSystem = class VirtualFileSystem {
 		const meta = options.meta ?? {};
 		const resolvedPath = await this.resolve(this.#normalizePath(path)) || path;
 		const { relativeKey, adapter } = this.#getStorage(resolvedPath, options.storage);
-		this.#logger.trace(`Writing ${resolvedPath} to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${(0, _stryke_string_format_pretty_bytes.prettyBytes)(new node_buffer.Blob((0, _stryke_convert_to_array.toArray)(data)).size)})`);
 		let code = data;
-		try {
+		if ((0, _stryke_type_checks_is_string.isString)(data)) try {
 			if (!options.skipFormat) code = await require_lib_utilities_format.format(this.#context, resolvedPath, data);
 		} catch (err) {
 			if (require_constants_extensions.DEFAULT_EXTENSIONS.includes((0, _stryke_path_file_path_fns.findFileExtensionSafe)(resolvedPath, { fullExtension: false }))) this.#logger.warn(`Failed to format file ${resolvedPath} before writing: ${err.message}`);
 			code = data;
 		}
-		this.#logger.trace(`Writing ${resolvedPath} to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${(0, _stryke_string_format_pretty_bytes.prettyBytes)(new node_buffer.Blob((0, _stryke_convert_to_array.toArray)(code)).size)})`);
+		this.#logger.trace(`Writing ${resolvedPath} to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${(0, _stryke_string_format_pretty_bytes.prettyBytes)((0, _stryke_type_checks_is_string.isString)(code) ? new node_buffer.Blob((0, _stryke_convert_to_array.toArray)(code)).size : code.byteLength)})`);
 		const id = this.#normalizeId(meta.id || resolvedPath);
 		this.metadata[id] = {
 			type: "normal",
@@ -888,7 +925,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 		};
 		this.paths[id] = resolvedPath;
 		this.ids[resolvedPath] = id;
-		return adapter.set(relativeKey, code);
+		return adapter.set(relativeKey, (0, _stryke_type_checks_is_string.isString)(code) ? code : (0, _stryke_convert.uint8ArrayToString)(toUint8Array(code)));
 	}
 	/**
 	* Synchronously writes a file to the virtual file system (VFS).
@@ -901,7 +938,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 		const meta = options.meta ?? {};
 		const resolvedPath = this.resolveSync(this.#normalizePath(path)) || path;
 		const { relativeKey, adapter } = this.#getStorage(resolvedPath, options.storage);
-		this.#logger.trace(`Writing ${resolvedPath} file to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${(0, _stryke_string_format_pretty_bytes.prettyBytes)(new node_buffer.Blob((0, _stryke_convert_to_array.toArray)(data)).size)})`);
+		this.#logger.trace(`Writing ${resolvedPath} file to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${(0, _stryke_string_format_pretty_bytes.prettyBytes)((0, _stryke_type_checks_is_string.isString)(data) ? new node_buffer.Blob((0, _stryke_convert_to_array.toArray)(data)).size : data.byteLength)})`);
 		const id = this.#normalizeId(meta.id || resolvedPath);
 		this.metadata[id] = {
 			type: "normal",
@@ -911,7 +948,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 		};
 		this.paths[id] = resolvedPath;
 		this.ids[resolvedPath] = id;
-		return adapter.setSync(relativeKey, data);
+		return adapter.setSync(relativeKey, (0, _stryke_type_checks_is_string.isString)(data) ? data : (0, _stryke_convert.uint8ArrayToString)(toUint8Array(data)));
 	}
 	/**
 	* Synchronously creates a directory at the specified path.

package/dist/lib/vfs.d.cts

@@ -211,6 +211,20 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
    * @returns The contents of the file as a string, or undefined if the file does not exist.
    */
   readSync(path: string): string | undefined;
+  /**
+   * Asynchronously reads a file from the virtual file system (VFS) as a buffer.
+   *
+   * @param path - The path or ID of the file to read.
+   * @returns A promise that resolves to the file contents as a buffer, or `undefined` if the file does not exist.
+   */
+  readBuffer(path: string): Promise<NodeJS.ArrayBufferView | undefined>;
+  /**
+   * Synchronously reads a file from the virtual file system (VFS) as a buffer.
+   *
+   * @param path - The path or ID of the file to read.
+   * @returns The file contents as a buffer, or `undefined` if the file does not exist.
+   */
+  readBufferSync(path: string): NodeJS.ArrayBufferView | undefined;
   /**
    * Writes a file to the virtual file system (VFS).
    *
@@ -219,7 +233,7 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
    * @param options - Optional parameters for writing the file.
    * @returns A promise that resolves when the file is written.
    */
-  write(path: string, data?: string, options?: WriteOptions): Promise<void>;
+  write(path: string, data?: string | NodeJS.ArrayBufferView, options?: WriteOptions): Promise<void>;
   /**
    * Synchronously writes a file to the virtual file system (VFS).
    *
@@ -227,7 +241,7 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
    * @param data - The contents of the file.
    * @param options - Optional parameters for writing the file.
    */
-  writeSync(path: string, data?: string, options?: WriteOptions): void;
+  writeSync(path: string, data?: string | NodeJS.ArrayBufferView, options?: WriteOptions): void;
   /**
    * Synchronously creates a directory at the specified path.
    *

package/dist/lib/vfs.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"vfs.d.cts","names":[],"sources":["../../src/lib/vfs.ts"],"mappings":"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"}
+{"version":3,"file":"vfs.d.cts","names":[],"sources":["../../src/lib/vfs.ts"],"mappings":"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"}

package/dist/lib/vfs.d.mts

@@ -211,6 +211,20 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
    * @returns The contents of the file as a string, or undefined if the file does not exist.
    */
   readSync(path: string): string | undefined;
+  /**
+   * Asynchronously reads a file from the virtual file system (VFS) as a buffer.
+   *
+   * @param path - The path or ID of the file to read.
+   * @returns A promise that resolves to the file contents as a buffer, or `undefined` if the file does not exist.
+   */
+  readBuffer(path: string): Promise<NodeJS.ArrayBufferView | undefined>;
+  /**
+   * Synchronously reads a file from the virtual file system (VFS) as a buffer.
+   *
+   * @param path - The path or ID of the file to read.
+   * @returns The file contents as a buffer, or `undefined` if the file does not exist.
+   */
+  readBufferSync(path: string): NodeJS.ArrayBufferView | undefined;
   /**
    * Writes a file to the virtual file system (VFS).
    *
@@ -219,7 +233,7 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
    * @param options - Optional parameters for writing the file.
    * @returns A promise that resolves when the file is written.
    */
-  write(path: string, data?: string, options?: WriteOptions): Promise<void>;
+  write(path: string, data?: string | NodeJS.ArrayBufferView, options?: WriteOptions): Promise<void>;
   /**
    * Synchronously writes a file to the virtual file system (VFS).
    *
@@ -227,7 +241,7 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
    * @param data - The contents of the file.
    * @param options - Optional parameters for writing the file.
    */
-  writeSync(path: string, data?: string, options?: WriteOptions): void;
+  writeSync(path: string, data?: string | NodeJS.ArrayBufferView, options?: WriteOptions): void;
   /**
    * Synchronously creates a directory at the specified path.
    *

package/dist/lib/vfs.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"vfs.d.mts","names":[],"sources":["../../src/lib/vfs.ts"],"mappings":"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"}
+{"version":3,"file":"vfs.d.mts","names":[],"sources":["../../src/lib/vfs.ts"],"mappings":"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"}

package/dist/lib/vfs.mjs

@@ -23,6 +23,7 @@ import { murmurhash } from "@stryke/hash";
 import { getResolutionCombinations, resolve, resolveSync } from "@stryke/fs/resolve";
 import { prettyBytes } from "@stryke/string-format/pretty-bytes";
 import * as capnp from "@stryke/capnp";
+import { stringToUint8Array, uint8ArrayToString } from "@stryke/convert";
 import { readFileBuffer, readFileBufferSync, writeFileBuffer } from "@stryke/fs/buffer";
 import { correctPath, stripStars } from "@stryke/path/correct-path";
 import { globToRegex } from "@stryke/path/glob-to-regex";
@@ -36,6 +37,9 @@ import { fileURLToPath } from "node:url";
 function toFilePath(path) {
 	return correctPath(slash(path?.toString() || ".").replace(/^file:\/\//, ""));
 }
+function toUint8Array(view) {
+	return new Uint8Array(view.buffer, view.byteOffset, view.byteLength);
+}
 /**
 * Checks if a given file id is valid based on the specified prefix.
 *
@@ -840,7 +844,9 @@ var VirtualFileSystem = class VirtualFileSystem {
 		if (!filePath || !this.existsSync(filePath)) return;
 		const { adapter } = this.#getStorage(filePath);
 		this.#logger.trace(`Reading ${adapter.name} file: ${filePath}`);
-		return await adapter.get(filePath) ?? void 0;
+		const result = await adapter.get(filePath);
+		if (!result) return;
+		return isString(result) ? result : uint8ArrayToString(toUint8Array(result));
 	}
 	/**
 	* Synchronously reads a file from the virtual file system (VFS).
@@ -853,7 +859,39 @@ var VirtualFileSystem = class VirtualFileSystem {
 		if (!filePath || !this.existsSync(filePath)) return;
 		const { adapter } = this.#getStorage(filePath);
 		this.#logger.trace(`Reading ${adapter.name} file: ${filePath}`);
-		return adapter.getSync(filePath) ?? void 0;
+		const result = adapter.getSync(filePath);
+		if (!result) return;
+		return isString(result) ? result : uint8ArrayToString(toUint8Array(result));
+	}
+	/**
+	* Asynchronously reads a file from the virtual file system (VFS) as a buffer.
+	*
+	* @param path - The path or ID of the file to read.
+	* @returns A promise that resolves to the file contents as a buffer, or `undefined` if the file does not exist.
+	*/
+	async readBuffer(path) {
+		const filePath = await this.resolve(path, void 0, { isFile: true });
+		if (!filePath || !this.existsSync(filePath)) return;
+		const { adapter } = this.#getStorage(filePath);
+		this.#logger.trace(`Reading ${adapter.name} file buffer: ${filePath}`);
+		const result = await adapter.get(filePath);
+		if (!result) return;
+		return isString(result) ? stringToUint8Array(result) : result;
+	}
+	/**
+	* Synchronously reads a file from the virtual file system (VFS) as a buffer.
+	*
+	* @param path - The path or ID of the file to read.
+	* @returns The file contents as a buffer, or `undefined` if the file does not exist.
+	*/
+	readBufferSync(path) {
+		const filePath = this.resolveSync(path, void 0, { isFile: true });
+		if (!filePath || !this.existsSync(filePath)) return;
+		const { adapter } = this.#getStorage(filePath);
+		this.#logger.trace(`Reading ${adapter.name} file buffer: ${filePath}`);
+		const result = adapter.getSync(filePath);
+		if (!result) return;
+		return isString(result) ? stringToUint8Array(result) : result;
 	}
 	/**
 	* Writes a file to the virtual file system (VFS).
@@ -867,15 +905,14 @@ var VirtualFileSystem = class VirtualFileSystem {
 		const meta = options.meta ?? {};
 		const resolvedPath = await this.resolve(this.#normalizePath(path)) || path;
 		const { relativeKey, adapter } = this.#getStorage(resolvedPath, options.storage);
-		this.#logger.trace(`Writing ${resolvedPath} to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${prettyBytes(new Blob(toArray(data)).size)})`);
 		let code = data;
-		try {
+		if (isString(data)) try {
 			if (!options.skipFormat) code = await format(this.#context, resolvedPath, data);
 		} catch (err) {
 			if (DEFAULT_EXTENSIONS.includes(findFileExtensionSafe(resolvedPath, { fullExtension: false }))) this.#logger.warn(`Failed to format file ${resolvedPath} before writing: ${err.message}`);
 			code = data;
 		}
-		this.#logger.trace(`Writing ${resolvedPath} to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${prettyBytes(new Blob(toArray(code)).size)})`);
+		this.#logger.trace(`Writing ${resolvedPath} to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${prettyBytes(isString(code) ? new Blob(toArray(code)).size : code.byteLength)})`);
 		const id = this.#normalizeId(meta.id || resolvedPath);
 		this.metadata[id] = {
 			type: "normal",
@@ -885,7 +922,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 		};
 		this.paths[id] = resolvedPath;
 		this.ids[resolvedPath] = id;
-		return adapter.set(relativeKey, code);
+		return adapter.set(relativeKey, isString(code) ? code : uint8ArrayToString(toUint8Array(code)));
 	}
 	/**
 	* Synchronously writes a file to the virtual file system (VFS).
@@ -898,7 +935,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 		const meta = options.meta ?? {};
 		const resolvedPath = this.resolveSync(this.#normalizePath(path)) || path;
 		const { relativeKey, adapter } = this.#getStorage(resolvedPath, options.storage);
-		this.#logger.trace(`Writing ${resolvedPath} file to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${prettyBytes(new Blob(toArray(data)).size)})`);
+		this.#logger.trace(`Writing ${resolvedPath} file to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${prettyBytes(isString(data) ? new Blob(toArray(data)).size : data.byteLength)})`);
 		const id = this.#normalizeId(meta.id || resolvedPath);
 		this.metadata[id] = {
 			type: "normal",
@@ -908,7 +945,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 		};
 		this.paths[id] = resolvedPath;
 		this.ids[resolvedPath] = id;
-		return adapter.setSync(relativeKey, data);
+		return adapter.setSync(relativeKey, isString(data) ? data : uint8ArrayToString(toUint8Array(data)));
 	}
 	/**
 	* Synchronously creates a directory at the specified path.