powerlines 0.42.41 → 0.43.0

package/dist/virtual-BNy8T32w.cjs

@@ -1,548 +0,0 @@
-const require_chunk = require('./chunk-AIJqnxB6.cjs');
-const require_utils = require('./utils.cjs');
-let _stryke_fs_exists = require("@stryke/fs/exists");
-let _stryke_fs_helpers = require("@stryke/fs/helpers");
-let _stryke_fs_list_files = require("@stryke/fs/list-files");
-let _stryke_path_append = require("@stryke/path/append");
-let _stryke_path_is_parent_path = require("@stryke/path/is-parent-path");
-let _stryke_type_checks_is_error = require("@stryke/type-checks/is-error");
-let _stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
-let _stryke_path_join = require("@stryke/path/join");
-let _stryke_path_correct_path = require("@stryke/path/correct-path");
-let _stryke_fs_is_file = require("@stryke/fs/is-file");
-let _stryke_fs_read_file = require("@stryke/fs/read-file");
-let _stryke_fs_write_file = require("@stryke/fs/write-file");
-let node_fs = require("node:fs");
-let node_fs_promises = require("node:fs/promises");
-let node_path = require("node:path");
-
-//#region src/storage/base.ts
-/**
-* Abstract base class for storage adapters, providing a template for storage operations.
-*/
-var BaseStorageAdapter = class {
-	/**
-	* Indicates whether the storage adapter has been disposed.
-	*/
-	#isDisposed = false;
-	/**
-	* Configuration options for the storage adapter.
-	*/
-	options;
-	/**
-	* The storage preset for the adapter.
-	*
-	* @remarks
-	* This can be used as an alternate way to identify the type of storage being used.
-	*/
-	preset = null;
-	/**
-	* Constructor for the BaseStorageAdapter.
-	*
-	* @param context - The Powerlines context.
-	* @param options - Configuration options for the storage adapter.
-	*/
-	constructor(context, options = { base: "/" }) {
-		this.context = context;
-		this.options = options;
-		this.options.base = (0, node_path.resolve)(options.base);
-		this.options.isReadOnly = !!options.isReadOnly;
-	}
-	/**
-	* Asynchronously checks if a key exists in the storage.
-	*
-	* @param key - The key to check for existence.
-	* @returns A promise that resolves to `true` if the key exists, otherwise `false`.
-	*/
-	async exists(key) {
-		return this.existsSync(key);
-	}
-	/**
-	* Asynchronously retrieves the value associated with a given key.
-	*
-	* @param key - The key whose value is to be retrieved.
-	* @returns A promise that resolves to the value associated with the key, or `null` if the key does not exist.
-	*/
-	async get(key) {
-		return this.getSync(key);
-	}
-	/**
-	* Asynchronously sets the value for a given key.
-	*
-	* @param key - The key to set the value for.
-	* @param value - The value to set.
-	*/
-	async set(key, value) {
-		if (!this.isReadOnly && (!this.existsSync(key) || this.overwrite)) this.setSync(key, value);
-	}
-	/**
-	* Synchronously creates a directory at the specified path.
-	*
-	* @param _ - The path of the directory to create.
-	*/
-	mkdirSync(_) {}
-	/**
-	* Creates a directory at the specified path.
-	*
-	* @param dirPath - The path of the directory to create.
-	*/
-	async mkdir(dirPath) {
-		return Promise.resolve(this.mkdirSync(dirPath));
-	}
-	/**
-	* Asynchronously removes a key from the storage.
-	*
-	* @param key - The key to remove.
-	*/
-	async remove(key) {
-		if (!this.isReadOnly && this.overwrite) this.removeSync(key);
-	}
-	/**
-	* Synchronously removes all entries from the storage that match the provided base path.
-	*
-	* @param base - The base path to clear keys from.
-	*/
-	clearSync(base) {
-		if (!this.isReadOnly && this.overwrite) {
-			const keys = this.listSync(base || this.options.base);
-			if (!keys.length) return;
-			keys.map((key) => this.removeSync(base && !key.startsWith(base) ? (0, _stryke_path_join.joinPaths)(base, key) : key));
-		}
-	}
-	/**
-	* Asynchronously removes all entries from the storage that match the provided base path.
-	*
-	* @param base - The base path to clear keys from.
-	* @returns A promise that resolves when the operation is complete.
-	*/
-	async clear(base) {
-		if (!this.isReadOnly && this.overwrite) {
-			const keys = await this.list(base || this.options.base);
-			if (!keys.length) return;
-			await Promise.all(keys.map(async (key) => this.remove(base && !key.startsWith(base) ? (0, _stryke_path_join.joinPaths)(base, key) : key)));
-		}
-	}
-	/**
-	* Asynchronously lists all keys under a given base path.
-	*
-	* @param base - The base path to list keys from.
-	* @returns A promise that resolves to an array of keys under the specified base path.
-	*/
-	async list(base) {
-		return this.listSync(base);
-	}
-	/**
-	* Synchronously checks if the given key is a directory.
-	*
-	* @param _ - The key to check.
-	* @returns `true` if the key is a directory, otherwise `false`.
-	*/
-	isDirectorySync(_) {
-		return false;
-	}
-	/**
-	* Checks if the given key is a directory.
-	*
-	* @param key - The key to check.
-	* @returns A promise that resolves to `true` if the key is a directory, otherwise `false`.
-	*/
-	async isDirectory(key) {
-		return Promise.resolve(this.isDirectorySync(key));
-	}
-	/**
-	* Synchronously checks if the given key is a file.
-	*
-	* @param key - The key to check.
-	* @returns `true` if the key is a file, otherwise `false`.
-	*/
-	isFileSync(key) {
-		return this.existsSync(key) && !this.isDirectorySync(key);
-	}
-	/**
-	* Checks if the given key is a file.
-	*
-	* @param key - The key to check.
-	* @returns A promise that resolves to `true` if the key is a file, otherwise `false`.
-	*/
-	async isFile(key) {
-		return Promise.resolve(this.isFileSync(key));
-	}
-	/**
-	* Disposes of the storage adapter, releasing any held resources.
-	*
-	* @returns A promise that resolves when the disposal is complete.
-	*/
-	dispose() {
-		return Promise.resolve();
-	}
-	/**
-	* Async dispose method to clean up resources.
-	*
-	* @returns A promise that resolves when disposal is complete.
-	*/
-	async [Symbol.asyncDispose]() {
-		return this._dispose();
-	}
-	/**
-	* Determines if the storage adapter is read-only based on the provided options.
-	*
-	* @returns `true` if the storage adapter is read-only, otherwise `false`.
-	*/
-	get isReadOnly() {
-		return !!this.options.isReadOnly;
-	}
-	/**
-	* Determines if the storage adapter should overwrite existing keys based on the provided options and context configuration.
-	*
-	* @returns `true` if the storage adapter should overwrite existing keys, otherwise `false`.
-	*/
-	get overwrite() {
-		return !this.isReadOnly && this.context.config.output.overwrite !== false;
-	}
-	/**
-	* Resolves a given key to its full path within the storage adapter.
-	*
-	* @param key - The key to resolve.
-	* @returns The resolved full path for the key.
-	*/
-	resolve(key) {
-		if (!key) return this.options.base;
-		if (/\.\.:|\.\.$/.test(key)) throw new Error(`[${this.name}]: Invalid key: ${JSON.stringify(key)} provided to storage adapter.`);
-		return (0, _stryke_path_append.appendPath)((0, _stryke_path_correct_path.correctPath)(key).replace(/:/g, "/"), this.options.base);
-	}
-	/**
-	* Disposes of the storage adapter, releasing any held resources.
-	*
-	* @returns A promise that resolves when the disposal is complete.
-	*/
-	async _dispose() {
-		if (!this.#isDisposed) {
-			await Promise.resolve(this.dispose());
-			this.#isDisposed = true;
-		}
-	}
-};
-
-//#endregion
-//#region src/storage/helpers.ts
-/**
-* Checks if an error is a file system error.
-*
-* @param err - The error to check.
-* @returns `true` if the error is a file system error, otherwise `false`.
-*/
-function isFileError(err) {
-	return (0, _stryke_type_checks_is_error.isError)(err) && "code" in err && err.code;
-}
-/**
-* Ignores file not found errors.
-*
-* @param err - The error to check.
-* @returns `null` if the error is a file not found error, otherwise returns the error.
-*/
-function ignoreNotfound(err) {
-	return isFileError(err) && (err.code === "ENOENT" || err.code === "EISDIR" ? null : err);
-}
-/**
-* Ignores file exists errors.
-*
-* @param err - The error to check.
-* @returns `null` if the error is a file exists error, otherwise returns the error.
-*/
-function ignoreExists(err) {
-	return isFileError(err) && err.code === "EEXIST" ? null : err;
-}
-
-//#endregion
-//#region src/storage/file-system.ts
-/**
-* File system storage adapter implementation.
-*/
-var FileSystemStorageAdapter = class extends BaseStorageAdapter {
-	/**
-	* A name identifying the storage adapter type.
-	*/
-	name = "file-system";
-	/**
-	* The storage preset for the adapter.
-	*
-	* @remarks
-	* This can be used as an alternate way to identify the type of storage being used.
-	*/
-	preset = "fs";
-	/**
-	* Constructor for the FileSystemStorageAdapter.
-	*
-	* @param context - The Powerlines context.
-	* @param options - Configuration options for the storage adapter.
-	*/
-	constructor(context, options) {
-		super(context, options);
-	}
-	/**
-	* Synchronously checks if a key exists in the storage.
-	*
-	* @param key - The key to check for existence.
-	* @returns Returns `true` if the key exists, otherwise `false`.
-	*/
-	existsSync(key) {
-		return (0, _stryke_fs_exists.existsSync)(this.resolve(key));
-	}
-	/**
-	* Asynchronously checks if a key exists in the storage.
-	*
-	* @param key - The key to check for existence.
-	* @returns A promise that resolves to `true` if the key exists, otherwise `false`.
-	*/
-	async exists(key) {
-		return (0, _stryke_fs_exists.exists)(this.resolve(key));
-	}
-	/**
-	* Synchronously retrieves the value associated with a given key.
-	*
-	* @param key - The key whose value is to be retrieved.
-	* @returns The value associated with the key, or `null` if the key does not exist.
-	*/
-	getSync(key) {
-		return (0, _stryke_fs_read_file.readFileSync)(this.resolve(key));
-	}
-	/**
-	* Asynchronously retrieves the value associated with a given key.
-	*
-	* @param key - The key whose value is to be retrieved.
-	* @returns A promise that resolves to the value associated with the key, or `null` if the key does not exist.
-	*/
-	async get(key) {
-		return (0, _stryke_fs_read_file.readFile)(this.resolve(key));
-	}
-	/**
-	* Synchronously sets the value for a given key.
-	*
-	* @param key - The key to set the value for.
-	* @param value - The value to set.
-	*/
-	setSync(key, value) {
-		if (!this.isReadOnly) if (this.existsSync(this.resolve(key)) && !this.overwrite) {
-			const existingValue = this.getSync(this.resolve(key));
-			if ((0, _stryke_type_checks_is_set_string.isSetString)(existingValue) && existingValue.includes((0, require_utils.utils_exports.getFileHeaderWarningText)(true, this.context.config.framework))) return (0, _stryke_fs_write_file.writeFileSync)(this.resolve(key), existingValue.replace((0, require_utils.utils_exports.getFileHeaderWarningText)(true, this.context.config.framework), (0, require_utils.utils_exports.getFileHeaderWarningText)(false, this.context.config.framework)));
-		} else return (0, _stryke_fs_write_file.writeFileSync)(this.resolve(key), value);
-	}
-	/**
-	* Asynchronously sets the value for a given key.
-	*
-	* @param key - The key to set the value for.
-	* @param value - The value to set.
-	*/
-	async set(key, value) {
-		if (!this.isReadOnly) if (this.existsSync(this.resolve(key)) && !this.overwrite) {
-			const existingValue = await this.get(this.resolve(key));
-			if ((0, _stryke_type_checks_is_set_string.isSetString)(existingValue) && existingValue.includes((0, require_utils.utils_exports.getFileHeaderWarningText)(true, this.context.config.framework))) return (0, _stryke_fs_write_file.writeFile)(this.resolve(key), existingValue.replace((0, require_utils.utils_exports.getFileHeaderWarningText)(true, this.context.config.framework), (0, require_utils.utils_exports.getFileHeaderWarningText)(false, this.context.config.framework)));
-		} else return (0, _stryke_fs_write_file.writeFile)(this.resolve(key), value);
-	}
-	/**
-	* Synchronously removes a key from the storage.
-	*
-	* @param key - The key to remove.
-	*/
-	removeSync(key) {
-		if (!this.isReadOnly && this.overwrite) try {
-			return (0, node_fs.unlinkSync)(this.resolve(key));
-		} catch (err) {
-			return ignoreNotfound(err);
-		}
-	}
-	/**
-	* Asynchronously removes a key from the storage.
-	*
-	* @param key - The key to remove.
-	*/
-	async remove(key) {
-		if (!this.isReadOnly && this.overwrite) return (0, node_fs_promises.unlink)(this.resolve(key)).catch(ignoreNotfound);
-	}
-	/**
-	* Synchronously creates a directory at the specified path.
-	*
-	* @param dirPath - The path of the directory to create.
-	*/
-	mkdirSync(dirPath) {
-		(0, _stryke_fs_helpers.createDirectorySync)(this.resolve(dirPath));
-	}
-	/**
-	* Creates a directory at the specified path.
-	*
-	* @param dirPath - The path of the directory to create.
-	*/
-	async mkdir(dirPath) {
-		await (0, _stryke_fs_helpers.createDirectory)(this.resolve(dirPath));
-	}
-	/**
-	* Lists all keys under a given base path synchronously.
-	*
-	* @param base - The base path to list keys from.
-	* @returns An array of keys under the specified base path.
-	*/
-	listSync(base) {
-		try {
-			return (0, _stryke_fs_list_files.listFilesSync)(this.resolve(base), { ignore: this.options.ignore });
-		} catch (err) {
-			return ignoreNotfound(err) ?? [];
-		}
-	}
-	/**
-	* Asynchronously lists all keys under a given base path.
-	*
-	* @param base - The base path to list keys from.
-	* @returns A promise that resolves to an array of keys under the specified base path.
-	*/
-	async list(base) {
-		return (0, _stryke_fs_list_files.listFiles)(this.resolve(base), { ignore: this.options.ignore }).catch(ignoreNotfound).then((r) => r || []);
-	}
-	/**
-	* Synchronously checks if the given key is a directory.
-	*
-	* @param key - The key to check.
-	* @returns `true` if the key is a directory, otherwise `false`.
-	*/
-	isDirectorySync(key) {
-		return (0, _stryke_fs_is_file.isDirectory)(this.resolve(key));
-	}
-	/**
-	* Synchronously checks if the given key is a file.
-	*
-	* @param key - The key to check.
-	* @returns `true` if the key is a file, otherwise `false`.
-	*/
-	isFileSync(key) {
-		return (0, _stryke_fs_is_file.isFile)(this.resolve(key));
-	}
-};
-
-//#endregion
-//#region src/storage/virtual.ts
-/**
-* Virtual/in-memory storage adapter implementation.
-*/
-var VirtualStorageAdapter = class extends BaseStorageAdapter {
-	/**
-	* A name identifying the storage adapter type.
-	*/
-	name = "virtual";
-	/**
-	* The storage preset for the adapter.
-	*
-	* @remarks
-	* This can be used as an alternate way to identify the type of storage being used.
-	*/
-	preset = "virtual";
-	/**
-	* In-memory data storage.
-	*/
-	data = /* @__PURE__ */ new Map();
-	/**
-	* Constructor for the VirtualStorageAdapter.
-	*
-	* @param context - The Powerlines context.
-	* @param options - Configuration options for the storage adapter.
-	*/
-	constructor(context, options) {
-		super(context, options);
-	}
-	/**
-	* Synchronously checks if a key exists in the storage.
-	*
-	* @param key - The key to check for existence.
-	* @returns Returns `true` if the key exists, otherwise `false`.
-	*/
-	existsSync(key) {
-		return this.data.has(this.resolve(key));
-	}
-	/**
-	* Synchronously retrieves the value associated with a given key.
-	*
-	* @param key - The key whose value is to be retrieved.
-	* @returns The value associated with the key, or `null` if the key does not exist.
-	*/
-	getSync(key) {
-		return this.data.get(this.resolve(key)) ?? null;
-	}
-	/**
-	* Synchronously sets the value for a given key.
-	*
-	* @param key - The key to set the value for.
-	* @param value - The value to set.
-	*/
-	setSync(key, value) {
-		if (!this.isReadOnly && (!this.existsSync(key) || this.overwrite)) this.data.set(this.resolve(key), value);
-	}
-	/**
-	* Synchronously removes a key from the storage.
-	*
-	* @param key - The key to remove.
-	*/
-	removeSync(key) {
-		if (!this.isReadOnly && this.overwrite) this.data.delete(this.resolve(key));
-	}
-	/**
-	* Lists all keys under a given base path synchronously.
-	*
-	* @param base - The base path to list keys from.
-	* @returns An array of keys under the specified base path.
-	*/
-	listSync(base) {
-		return [...this.data.keys().filter((key) => !base ? true : (0, _stryke_path_is_parent_path.isParentPath)(key, this.resolve(base)))];
-	}
-	/**
-	* Disposes of the storage adapter, releasing any held resources.
-	*
-	* @returns A promise that resolves when the disposal is complete.
-	*/
-	async dispose() {
-		return this.clear();
-	}
-	/**
-	* Determines if the storage adapter should overwrite existing keys based on the provided options and context configuration.
-	*
-	* @returns `true` if the storage adapter should overwrite existing keys, otherwise `false`.
-	*/
-	get overwrite() {
-		return !this.isReadOnly;
-	}
-};
-
-//#endregion
-Object.defineProperty(exports, 'BaseStorageAdapter', {
-  enumerable: true,
-  get: function () {
-    return BaseStorageAdapter;
-  }
-});
-Object.defineProperty(exports, 'FileSystemStorageAdapter', {
-  enumerable: true,
-  get: function () {
-    return FileSystemStorageAdapter;
-  }
-});
-Object.defineProperty(exports, 'VirtualStorageAdapter', {
-  enumerable: true,
-  get: function () {
-    return VirtualStorageAdapter;
-  }
-});
-Object.defineProperty(exports, 'ignoreExists', {
-  enumerable: true,
-  get: function () {
-    return ignoreExists;
-  }
-});
-Object.defineProperty(exports, 'ignoreNotfound', {
-  enumerable: true,
-  get: function () {
-    return ignoreNotfound;
-  }
-});
-Object.defineProperty(exports, 'isFileError', {
-  enumerable: true,
-  get: function () {
-    return isFileError;
-  }
-});