@arkstack/filesystem 0.4.3 → 0.5.0

package/README.md

@@ -1,3 +1,3 @@
 # @arkstack/filesystem
 
-Shared Filesystem utilities for ArkStack.
+Filesystem module for Arkstack, providing shared file storage and filesystem utitlities for the framework.

package/dist/commands/StorageLinkCommand.js

@@ -1,7 +1,5 @@
-import "../FtpDriver-CfUSZ1xr.js";
-import { Storage } from "../index.js";
+import { t as Storage } from "../src-wGEPrkk5.js";
 import { Command } from "@h3ravel/musket";
-
 //#region src/commands/StorageLinkCommand.ts
 var StorageLinkCommand = class extends Command {
 	signature = `storage:link
@@ -12,7 +10,7 @@ var StorageLinkCommand = class extends Command {
 		Storage.link(this.options());
 	}
 };
-
 //#endregion
 export { StorageLinkCommand };
+
 //# sourceMappingURL=StorageLinkCommand.js.map

package/dist/commands/StorageLinkCommand.js.map

@@ -1 +1 @@
-{"version":3,"file":"StorageLinkCommand.js","names":[],"sources":["../../src/commands/StorageLinkCommand.ts"],"sourcesContent":["import { Command } from '@h3ravel/musket'\nimport { Storage } from '../'\n\nexport class StorageLinkCommand extends Command {\n    protected signature = `storage:link\n        {--force : Remove existing links before creating new ones.}\n    `\n    protected description = 'Create symbolic links for filesystem.links configuration.'\n\n    async handle () {\n        Storage.link(this.options())\n    }\n}"],"mappings":";;;;;AAGA,IAAa,qBAAb,cAAwC,QAAQ;CAC5C,AAAU,YAAY;;;CAGtB,AAAU,cAAc;CAExB,MAAM,SAAU;AACZ,UAAQ,KAAK,KAAK,SAAS,CAAC"}
+{"version":3,"file":"StorageLinkCommand.js","names":[],"sources":["../../src/commands/StorageLinkCommand.ts"],"sourcesContent":["import { Command } from '@h3ravel/musket'\nimport { Storage } from '../'\n\nexport class StorageLinkCommand extends Command {\n    protected signature = `storage:link\n        {--force : Remove existing links before creating new ones.}\n    `\n    protected description = 'Create symbolic links for filesystem.links configuration.'\n\n    async handle () {\n        Storage.link(this.options())\n    }\n}"],"mappings":";;;AAGA,IAAa,qBAAb,cAAwC,QAAQ;CAC5C,YAAsB;;;CAGtB,cAAwB;CAExB,MAAM,SAAU;EACZ,QAAQ,KAAK,KAAK,SAAS,CAAC"}

package/dist/index.js

@@ -1,282 +1,2 @@
-import { t as FtpDriver } from "./FtpDriver-CfUSZ1xr.js";
-import { DriveManager } from "flydrive";
-import { appUrl, config } from "@arkstack/common";
-import { rmSync, symlinkSync } from "node:fs";
-import { FSDriver } from "flydrive/drivers/fs";
-import path from "node:path";
-import { Logger } from "@h3ravel/shared";
-import { S3Driver } from "flydrive/drivers/s3";
-
-//#region src/index.ts
-var Storage = class Storage {
-	driver;
-	services = {};
-	diskName;
-	constructor() {
-		for (const diskName in config("filesystem.disks")) {
-			const diskConfig = config("filesystem.disks")[diskName];
-			const driverFactory = this.driversMap[diskConfig.driver];
-			if (!driverFactory) throw new Error(`Unsupported driver: ${diskConfig.driver}`);
-			this.services[diskName] = () => driverFactory(diskConfig);
-		}
-		this.diskName = config("filesystem.default");
-		this.driver = new DriveManager({
-			default: config("filesystem.default"),
-			services: this.services
-		});
-	}
-	/**
-	* Static method to get a disk instance directly from the Storage class without needing to instantiate it first.
-	* 
-	* @param diskName The name of the disk to use. If not provided, the default disk will be used.
-	* @returns A Storage instance
-	*/
-	static disk(diskName) {
-		const storage = new Storage();
-		if (diskName) {
-			storage.diskName = diskName;
-			storage.driver = new DriveManager({
-				default: diskName,
-				services: storage.services
-			});
-		}
-		return storage;
-	}
-	/**
-	* Generate a unique name for the file based on random numbers and original extension
-	* 
-	* @param file  The file object containing the original name
-	* @returns     A unique file name
-	*/
-	static generateName = (file) => {
-		const name = file.originalname || file.name || "file";
-		if (typeof config("filesystem.fileNameGenerator") === "function") return config("filesystem.fileNameGenerator")(name);
-		return Math.floor(Math.random() * 999999999999).toString() + "_" + Math.floor(Math.random() * 999999999999) + "." + name.split(".").pop();
-	};
-	/**
-	* Save the file to the storage and return the public URL and the file path
-	* 
-	* @param file      The file object containing the file data
-	* @param filePath  The path where the file should be saved
-	* @param fileName  The name to save the file as (optional)
-	* @returns         A tuple containing the public URL and the file path
-	*/
-	static saveFile = async (file, filePath = "", fileName) => {
-		return new Storage().saveFile(file, filePath, fileName);
-	};
-	/**
-	* Save the file to the storage and return the public URL and the file path
-	* 
-	* @param file      The file object containing the file data
-	* @param filePath  The path where the file should be saved
-	* @param fileName  The name to save the file as (optional)
-	* @returns         A tuple containing the public URL and the file path
-	*/
-	saveFile = async (file, filePath = "", fileName) => {
-		const name = fileName || Storage.generateName(file);
-		const drive = this.driver.use();
-		if (file instanceof File && !file.buffer) file.buffer = Buffer.from(await file.arrayBuffer());
-		await drive.put(path.join(filePath, name), file.buffer);
-		const url = await drive.getUrl(path.join(filePath, name));
-		return [url, this.diskName === "local" ? path.join(filePath, name) : url];
-	};
-	/**
-	* Return a boolean indicating if the file exists
-	*/
-	exists(key) {
-		return this.driver.use().exists(key);
-	}
-	/**
-	* Return contents of a object for the given key as a UTF-8 string.
-	* Should throw "E_CANNOT_READ_FILE" error when the file
-	* does not exists.
-	*/
-	get(key) {
-		return this.driver.use().get(key);
-	}
-	/**
-	* Return contents of a object for the given key as a Readable stream.
-	* Should throw "E_CANNOT_READ_FILE" error when the file
-	* does not exists.
-	*/
-	getStream(key) {
-		return this.driver.use().getStream(key);
-	}
-	/**
-	* Return contents of an object for the given key as an Uint8Array.
-	* Should throw "E_CANNOT_READ_FILE" error when the file
-	* does not exists.
-	*/
-	getBytes(key) {
-		return this.driver.use().getBytes(key);
-	}
-	/**
-	* Return metadata of an object for the given key.
-	*/
-	getMetaData(key) {
-		return this.driver.use().getMetaData(key);
-	}
-	/**
-	* Return the visibility of the file
-	*/
-	getVisibility(key) {
-		return this.driver.use().getVisibility(key);
-	}
-	/**
-	* Return the public URL to access the file
-	*/
-	getUrl(key) {
-		return this.driver.use().getUrl(key);
-	}
-	/**
-	* Return the signed/temporary URL to access the file
-	*/
-	getSignedUrl(key, options) {
-		return this.driver.use().getSignedUrl(key, options);
-	}
-	/**
-	* Return the signed/temporary URL that can be used to directly upload
-	* the file contents to the storage.
-	*/
-	getSignedUploadUrl(key, options) {
-		return this.driver.use().getSignedUploadUrl(key, options);
-	}
-	/**
-	* Update the visibility of the file
-	*/
-	setVisibility(key, visibility) {
-		return this.driver.use().setVisibility(key, visibility);
-	}
-	/**
-	* Write object to the destination with the provided
-	* contents.
-	*/
-	put(key, contents, options) {
-		if (!(contents instanceof Uint8Array) && typeof contents !== "string") contents = contents.buffer;
-		return this.driver.use().put(key, contents, options);
-	}
-	/**
-	* Write object to the destination with the provided
-	* contents as a readable stream
-	*/
-	putStream(key, contents, options) {
-		return this.driver.use().putStream(key, contents, options);
-	}
-	/**
-	* Copy the file from within the disk root location. Both
-	* the "source" and "destination" will be the key names
-	* and not absolute paths.
-	*/
-	copy(source, destination, options) {
-		return this.driver.use().copy(source, destination, options);
-	}
-	/**
-	* Move the file from within the disk root location. Both
-	* the "source" and "destination" will be the key names
-	* and not absolute paths.
-	*/
-	move(source, destination, options) {
-		return this.driver.use().move(source, destination, options);
-	}
-	/**
-	* Delete the file for the given key. Should not throw
-	* error when file does not exist in first place
-	*/
-	delete(key) {
-		return this.driver.use().delete(key);
-	}
-	/**
-	* Delete the files and directories matching the provided prefix.
-	*/
-	deleteAll(prefix) {
-		return this.driver.use().deleteAll(prefix);
-	}
-	/**
-	* The list all method must return an array of objects with
-	* the ability to paginate results (if supported).
-	*/
-	listAll(prefix, options) {
-		return this.driver.use().listAll(prefix, options);
-	}
-	/**
-	* Switch bucket at runtime if supported.
-	*/
-	bucket(bucket) {
-		return this.driver.use().bucket(bucket);
-	}
-	/**
-	* Create symbolic links for all configured links in the application configuration.
-	*/
-	static link({ force = false } = {}) {
-		for (const link in config("filesystem.links")) {
-			const target = config("filesystem.links")[link];
-			const unlink = link.replace(process.cwd(), "");
-			const untarget = target.replace(process.cwd(), "");
-			try {
-				if (force) rmSync(link, {
-					recursive: true,
-					force: true
-				});
-				symlinkSync(target, link);
-				Logger.log([
-					[" SUCCESS ", "bgGreen"],
-					[`[${unlink}]`, "green"],
-					["is now linked to", "white"],
-					[`[${untarget}].`, "green"]
-				], " ");
-			} catch (error) {
-				if (error.code === "EEXIST") Logger.log([
-					[" INFO ", "bgBlue"],
-					[`[${unlink}]`, "green"],
-					["is already linked to", "white"],
-					[`[${untarget}].`, "green"]
-				], " ");
-				else Logger.log([
-					[" ERROR ", "bgRed"],
-					["Failed to create symbolic link from", "white"],
-					[`[${unlink}]`, "green"],
-					["to", "white"],
-					[`[${untarget}]`, "green"],
-					[error.message, "red"]
-				], " ");
-			}
-		}
-	}
-	driversMap = {
-		local: (conf) => new FSDriver({
-			location: new URL(conf.root, import.meta.url),
-			visibility: "public",
-			urlBuilder: {
-				async generateURL(key, _path) {
-					return appUrl(key);
-				},
-				async generateSignedURL(key, _path, _opts) {
-					return appUrl(key);
-				}
-			}
-		}),
-		s3: (conf) => new S3Driver({
-			credentials: {
-				accessKeyId: conf.key,
-				secretAccessKey: conf.secret
-			},
-			endpoint: conf.endpoint,
-			region: conf.region,
-			bucket: conf.bucket,
-			visibility: "private",
-			cdnUrl: conf.url
-		}),
-		ftp: (conf) => new FtpDriver({
-			host: conf.host,
-			username: conf.username,
-			password: conf.password,
-			port: conf.port,
-			verbose: conf.verbose,
-			privateKey: conf.privateKey
-		})
-	};
-};
-
-//#endregion
+import { t as Storage } from "./src-wGEPrkk5.js";
 export { Storage };
-//# sourceMappingURL=index.js.map

package/dist/src-wGEPrkk5.js

@@ -0,0 +1,510 @@
+import { DriveDirectory, DriveFile, DriveManager } from "flydrive";
+import { appUrl, config } from "@arkstack/common";
+import { createReadStream, createWriteStream, rmSync, symlinkSync } from "node:fs";
+import { FSDriver } from "flydrive/drivers/fs";
+import Client from "ssh2-sftp-client";
+import { Readable } from "node:stream";
+import path from "node:path";
+import { Logger } from "@h3ravel/shared";
+import { S3Driver } from "flydrive/drivers/s3";
+//#region src/FtpDriver.ts
+var FtpDriver = class FtpDriver {
+	config;
+	constructor(config) {
+		if (typeof config === "string") {
+			const url = new URL(config);
+			this.config = {
+				host: url.hostname,
+				username: url.username,
+				password: url.password,
+				port: url.port ? parseInt(url.port, 10) : 22,
+				verbose: url.searchParams.get("verbose") === "true"
+			};
+		} else this.config = config;
+	}
+	getConfig() {
+		return this.config;
+	}
+	async init() {
+		const client = new Client();
+		await client.connect({
+			host: this.config.host,
+			username: this.config.username,
+			password: this.config.password,
+			port: this.config.port || 22
+		});
+		return client;
+	}
+	async load(handle) {
+		const client = await this.init();
+		try {
+			return await handle(client);
+		} catch (e) {
+			if (this.config.verbose) throw e;
+		} finally {
+			await client.end();
+		}
+		return null;
+	}
+	/**
+	* Return a boolean value indicating if the file exists
+	* or not.
+	*/
+	async exists(key) {
+		return !!await this.load((client) => {
+			return client.stat(key);
+		}).catch(() => {
+			return null;
+		});
+	}
+	/**
+	* Return the file contents as a UTF-8 string. Throw an exception
+	* if the file is missing.
+	*/
+	async get(key) {
+		const stream = await this.getStream(key);
+		const chunks = [];
+		for await (const chunk of stream) chunks.push(chunk);
+		return Buffer.concat(chunks).toString("utf-8");
+	}
+	/**
+	* Return the file contents as a Readable stream. Throw an exception
+	* if the file is missing.
+	*/
+	async getStream(key) {
+		const dst = createWriteStream("/tmp/" + path.basename(key));
+		await this.load((client) => {
+			return client.get(key, dst);
+		}).catch(() => {
+			return null;
+		});
+		return createReadStream("/tmp/" + path.basename(key));
+	}
+	/**
+	* Return the file contents as a Uint8Array. Throw an exception
+	* if the file is missing.
+	*/
+	async getBytes(key) {
+		const content = await this.get(key);
+		return new Uint8Array(Buffer.from(content, "utf-8"));
+	}
+	/**
+	* Return metadata of the file. Throw an exception
+	* if the file is missing.
+	*/
+	async getMetaData(key) {
+		const stat = await this.load((client) => {
+			return client.stat(key);
+		}).catch(() => {
+			return null;
+		});
+		if (!stat) throw new Error("E_CANNOT_READ_FILE");
+		return {
+			contentType: void 0,
+			contentLength: stat.size,
+			etag: key,
+			lastModified: new Date(stat.modifyTime)
+		};
+	}
+	/**
+	* Return visibility of the file. Infer visibility from the initial
+	* config, when the driver does not support the concept of visibility.
+	*/
+	async getVisibility(key) {
+		return "private";
+	}
+	/**
+	* Return the public URL of the file. Throw an exception when the driver
+	* does not support generating URLs.
+	*/
+	async getUrl(key) {
+		throw new Error("E_URL_GENERATION_UNSUPPORTED");
+	}
+	/**
+	* Return the signed URL to serve a private file. Throw exception
+	* when the driver does not support generating URLs.
+	*/
+	async getSignedUrl(key, options) {
+		throw new Error("E_URL_GENERATION_UNSUPPORTED");
+	}
+	/**
+	* Return the signed/temporary URL that can be used to directly upload
+	* the file contents to the storage.
+	*/
+	async getSignedUploadUrl(key, options) {
+		throw new Error("E_URL_GENERATION_UNSUPPORTED");
+	}
+	/**
+	* Update the visibility of the file. Result in a NOOP
+	* when the driver does not support the concept of
+	* visibility.
+	*/
+	async setVisibility(key, visibility) {}
+	/**
+	* Create a new file or update an existing file. The contents
+	* will be a UTF-8 string or "Uint8Array".
+	*/
+	async put(key, contents, options) {
+		if (contents instanceof Uint8Array) contents = Buffer.from(contents);
+		const stream = Readable.from(contents);
+		await this.putStream(key, stream, options);
+	}
+	/**
+	* Create a new file or update an existing file. The contents
+	* will be a Readable stream.
+	*/
+	async putStream(key, contents, options) {
+		const dst = createWriteStream("/tmp/" + path.basename(key), { encoding: options?.contentEncoding || "utf-8" });
+		await new Promise((resolve, reject) => {
+			contents.pipe(dst);
+			contents.on("error", reject);
+			dst.on("finish", resolve);
+			dst.on("error", reject);
+		});
+		await this.load((client) => {
+			return client.put("/tmp/" + path.basename(key), key);
+		});
+	}
+	/**
+	* Copy the existing file to the destination. Make sure the new file
+	* has the same visibility as the existing file. It might require
+	* manually fetching the visibility of the "source" file.
+	*/
+	async copy(source, destination, options) {
+		await this.load((client) => {
+			return client.rcopy(source, destination);
+		});
+	}
+	/**
+	* Move the existing file to the destination. Make sure the new file
+	* has the same visibility as the existing file. It might require
+	* manually fetching the visibility of the "source" file.
+	*/
+	async move(source, destination, options) {
+		await this.load((client) => {
+			return client.rename(source, destination);
+		});
+	}
+	/**
+	* Delete an existing file. Do not throw an error if the
+	* file is already missing
+	*/
+	async delete(key) {
+		await this.load((client) => {
+			return client.delete(key);
+		}).catch(() => {
+			return null;
+		});
+	}
+	/**
+	* Delete all files inside a folder. Do not throw an error
+	* if the folder does not exist or is empty.
+	*/
+	async deleteAll(prefix) {
+		await this.load((client) => {
+			return client.rmdir(prefix, true);
+		}).catch(() => {
+			return null;
+		});
+	}
+	/**
+	* Switch bucket at runtime if supported.
+	*/
+	bucket(config) {
+		return new FtpDriver(config);
+	}
+	/**
+	* List all files from a given folder or the root of the storage.
+	* Do not throw an error if the request folder does not exist.
+	*/
+	async listAll(prefix, options) {
+		const data = await this.load((client) => {
+			return client.list(prefix);
+		}).catch(() => {
+			return null;
+		});
+		return data ? { objects: data.map((file) => {
+			if (file.type === "d") return new DriveDirectory(file.name);
+			else return new DriveFile(file.name, this, {
+				contentType: void 0,
+				contentLength: file.size,
+				etag: file.name,
+				lastModified: new Date(file.modifyTime)
+			});
+		}) } : { objects: [] };
+	}
+};
+//#endregion
+//#region src/index.ts
+var Storage = class Storage {
+	driver;
+	services = {};
+	diskName;
+	constructor() {
+		for (const diskName in config("filesystem.disks")) {
+			const diskConfig = config("filesystem.disks")[diskName];
+			const driverFactory = this.driversMap[diskConfig.driver];
+			if (!driverFactory) throw new Error(`Unsupported driver: ${diskConfig.driver}`);
+			this.services[diskName] = () => driverFactory(diskConfig);
+		}
+		this.diskName = config("filesystem.default");
+		this.driver = new DriveManager({
+			default: config("filesystem.default"),
+			services: this.services
+		});
+	}
+	/**
+	* Static method to get a disk instance directly from the Storage class without needing to instantiate it first.
+	* 
+	* @param diskName The name of the disk to use. If not provided, the default disk will be used.
+	* @returns A Storage instance
+	*/
+	static disk(diskName) {
+		const storage = new Storage();
+		if (diskName) {
+			storage.diskName = diskName;
+			storage.driver = new DriveManager({
+				default: diskName,
+				services: storage.services
+			});
+		}
+		return storage;
+	}
+	/**
+	* Generate a unique name for the file based on random numbers and original extension
+	* 
+	* @param file  The file object containing the original name
+	* @returns     A unique file name
+	*/
+	static generateName = (file) => {
+		const name = file.originalname || file.name || "file";
+		if (typeof config("filesystem.fileNameGenerator") === "function") return config("filesystem.fileNameGenerator")(name);
+		return Math.floor(Math.random() * 999999999999).toString() + "_" + Math.floor(Math.random() * 999999999999) + "." + name.split(".").pop();
+	};
+	/**
+	* Save the file to the storage and return the public URL and the file path
+	* 
+	* @param file      The file object containing the file data
+	* @param filePath  The path where the file should be saved
+	* @param fileName  The name to save the file as (optional)
+	* @returns         A tuple containing the public URL and the file path
+	*/
+	static saveFile = async (file, filePath = "", fileName) => {
+		return new Storage().saveFile(file, filePath, fileName);
+	};
+	/**
+	* Save the file to the storage and return the public URL and the file path
+	* 
+	* @param file      The file object containing the file data
+	* @param filePath  The path where the file should be saved
+	* @param fileName  The name to save the file as (optional)
+	* @returns         A tuple containing the public URL and the file path
+	*/
+	saveFile = async (file, filePath = "", fileName) => {
+		const name = fileName || Storage.generateName(file);
+		const drive = this.driver.use();
+		if (file instanceof File && !file.buffer) file.buffer = Buffer.from(await file.arrayBuffer());
+		await drive.put(path.join(filePath, name), file.buffer);
+		const url = await drive.getUrl(path.join(filePath, name));
+		return [url, this.diskName === "local" ? path.join(filePath, name) : url];
+	};
+	/**
+	* Return a boolean indicating if the file exists
+	*/
+	exists(key) {
+		return this.driver.use().exists(key);
+	}
+	/**
+	* Return contents of a object for the given key as a UTF-8 string.
+	* Should throw "E_CANNOT_READ_FILE" error when the file
+	* does not exists.
+	*/
+	get(key) {
+		return this.driver.use().get(key);
+	}
+	/**
+	* Return contents of a object for the given key as a Readable stream.
+	* Should throw "E_CANNOT_READ_FILE" error when the file
+	* does not exists.
+	*/
+	getStream(key) {
+		return this.driver.use().getStream(key);
+	}
+	/**
+	* Return contents of an object for the given key as an Uint8Array.
+	* Should throw "E_CANNOT_READ_FILE" error when the file
+	* does not exists.
+	*/
+	getBytes(key) {
+		return this.driver.use().getBytes(key);
+	}
+	/**
+	* Return metadata of an object for the given key.
+	*/
+	getMetaData(key) {
+		return this.driver.use().getMetaData(key);
+	}
+	/**
+	* Return the visibility of the file
+	*/
+	getVisibility(key) {
+		return this.driver.use().getVisibility(key);
+	}
+	/**
+	* Return the public URL to access the file
+	*/
+	getUrl(key) {
+		return this.driver.use().getUrl(key);
+	}
+	/**
+	* Return the signed/temporary URL to access the file
+	*/
+	getSignedUrl(key, options) {
+		return this.driver.use().getSignedUrl(key, options);
+	}
+	/**
+	* Return the signed/temporary URL that can be used to directly upload
+	* the file contents to the storage.
+	*/
+	getSignedUploadUrl(key, options) {
+		return this.driver.use().getSignedUploadUrl(key, options);
+	}
+	/**
+	* Update the visibility of the file
+	*/
+	setVisibility(key, visibility) {
+		return this.driver.use().setVisibility(key, visibility);
+	}
+	/**
+	* Write object to the destination with the provided
+	* contents.
+	*/
+	put(key, contents, options) {
+		if (!(contents instanceof Uint8Array) && typeof contents !== "string") contents = contents.buffer;
+		return this.driver.use().put(key, contents, options);
+	}
+	/**
+	* Write object to the destination with the provided
+	* contents as a readable stream
+	*/
+	putStream(key, contents, options) {
+		return this.driver.use().putStream(key, contents, options);
+	}
+	/**
+	* Copy the file from within the disk root location. Both
+	* the "source" and "destination" will be the key names
+	* and not absolute paths.
+	*/
+	copy(source, destination, options) {
+		return this.driver.use().copy(source, destination, options);
+	}
+	/**
+	* Move the file from within the disk root location. Both
+	* the "source" and "destination" will be the key names
+	* and not absolute paths.
+	*/
+	move(source, destination, options) {
+		return this.driver.use().move(source, destination, options);
+	}
+	/**
+	* Delete the file for the given key. Should not throw
+	* error when file does not exist in first place
+	*/
+	delete(key) {
+		return this.driver.use().delete(key);
+	}
+	/**
+	* Delete the files and directories matching the provided prefix.
+	*/
+	deleteAll(prefix) {
+		return this.driver.use().deleteAll(prefix);
+	}
+	/**
+	* The list all method must return an array of objects with
+	* the ability to paginate results (if supported).
+	*/
+	listAll(prefix, options) {
+		return this.driver.use().listAll(prefix, options);
+	}
+	/**
+	* Switch bucket at runtime if supported.
+	*/
+	bucket(bucket) {
+		return this.driver.use().bucket(bucket);
+	}
+	/**
+	* Create symbolic links for all configured links in the application configuration.
+	*/
+	static link({ force = false } = {}) {
+		for (const link in config("filesystem.links")) {
+			const target = config("filesystem.links")[link];
+			const unlink = link.replace(process.cwd(), "");
+			const untarget = target.replace(process.cwd(), "");
+			try {
+				if (force) rmSync(link, {
+					recursive: true,
+					force: true
+				});
+				symlinkSync(target, link);
+				Logger.log([
+					[" SUCCESS ", "bgGreen"],
+					[`[${unlink}]`, "green"],
+					["is now linked to", "white"],
+					[`[${untarget}].`, "green"]
+				], " ");
+			} catch (error) {
+				if (error.code === "EEXIST") Logger.log([
+					[" INFO ", "bgBlue"],
+					[`[${unlink}]`, "green"],
+					["is already linked to", "white"],
+					[`[${untarget}].`, "green"]
+				], " ");
+				else Logger.log([
+					[" ERROR ", "bgRed"],
+					["Failed to create symbolic link from", "white"],
+					[`[${unlink}]`, "green"],
+					["to", "white"],
+					[`[${untarget}]`, "green"],
+					[error.message, "red"]
+				], " ");
+			}
+		}
+	}
+	driversMap = {
+		local: (conf) => new FSDriver({
+			location: new URL(conf.root, import.meta.url),
+			visibility: "public",
+			urlBuilder: {
+				async generateURL(key, _path) {
+					return appUrl(key);
+				},
+				async generateSignedURL(key, _path, _opts) {
+					return appUrl(key);
+				}
+			}
+		}),
+		s3: (conf) => new S3Driver({
+			credentials: {
+				accessKeyId: conf.key,
+				secretAccessKey: conf.secret
+			},
+			endpoint: conf.endpoint,
+			region: conf.region,
+			bucket: conf.bucket,
+			visibility: "private",
+			cdnUrl: conf.url
+		}),
+		ftp: (conf) => new FtpDriver({
+			host: conf.host,
+			username: conf.username,
+			password: conf.password,
+			port: conf.port,
+			verbose: conf.verbose,
+			privateKey: conf.privateKey
+		})
+	};
+};
+//#endregion
+export { Storage as t };
+
+//# sourceMappingURL=src-wGEPrkk5.js.map

package/dist/src-wGEPrkk5.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"src-wGEPrkk5.js","names":[],"sources":["../src/FtpDriver.ts","../src/index.ts"],"sourcesContent":["import { DriveDirectory, DriveFile } from 'flydrive'\nimport type {\n    DriverContract,\n    ObjectMetaData,\n    ObjectVisibility,\n    SignedURLOptions,\n    WriteOptions,\n} from 'flydrive/types'\nimport { createReadStream, createWriteStream } from 'node:fs'\n\nimport Client from 'ssh2-sftp-client'\nimport { Readable } from 'node:stream'\nimport path from 'node:path'\n\nexport class FtpDriver implements DriverContract {\n    private config: {\n        host: string\n        username: string\n        password: string\n        port?: number\n        verbose?: boolean\n        privateKey?: string\n    }\n\n    constructor(config: string | {\n        host: string\n        username: string\n        password: string\n        port?: number\n        verbose?: boolean\n        privateKey?: string\n    }) {\n        if (typeof config === 'string') {\n            const url = new URL(config)\n\n            this.config = {\n                host: url.hostname,\n                username: url.username,\n                password: url.password,\n                port: url.port ? parseInt(url.port, 10) : 22,\n                verbose: url.searchParams.get('verbose') === 'true',\n            }\n        } else {\n            this.config = config\n        }\n    }\n\n    getConfig () {\n        return this.config\n    }\n\n    private async init () {\n        const client = new Client()\n\n        await client.connect({\n            host: this.config.host,\n            username: this.config.username,\n            password: this.config.password,\n            port: this.config.port || 22,\n        })\n\n        return client\n    }\n\n    private async load<T> (handle: (client: Client) => Promise<T>): Promise<T> {\n        const client = await this.init()\n\n        try {\n            return await handle(client)\n        } catch (e) {\n            if (this.config.verbose) {\n                throw e\n            }\n        } finally {\n            await client.end()\n        }\n\n        return null as any\n    }\n\n    /**\n     * Return a boolean value indicating if the file exists\n     * or not.\n     */\n    async exists (key: string): Promise<boolean> {\n        const client = await this.load((client) => {\n            return client.stat(key)\n        }).catch(() => {\n            return null\n        })\n\n        return !!client\n    }\n\n    /**\n     * Return the file contents as a UTF-8 string. Throw an exception\n     * if the file is missing.\n     */\n    async get (key: string): Promise<string> {\n        const stream = await this.getStream(key)\n\n        const chunks: Uint8Array[] = []\n        for await (const chunk of stream) {\n            chunks.push(chunk)\n        }\n\n        return Buffer.concat(chunks).toString('utf-8')\n    }\n\n    /**\n     * Return the file contents as a Readable stream. Throw an exception\n     * if the file is missing.\n     */\n    async getStream (key: string): Promise<Readable> {\n        const dst = createWriteStream('/tmp/' + path.basename(key))\n        await this.load((client) => {\n            return client.get(key, dst)\n        }).catch(() => {\n            return null\n        })\n\n        return createReadStream('/tmp/' + path.basename(key))\n    }\n\n    /**\n     * Return the file contents as a Uint8Array. Throw an exception\n     * if the file is missing.\n     */\n    async getBytes (key: string): Promise<Uint8Array> {\n        const content = await this.get(key)\n\n        return new Uint8Array(Buffer.from(content, 'utf-8'))\n    }\n\n    /**\n     * Return metadata of the file. Throw an exception\n     * if the file is missing.\n     */\n    async getMetaData (key: string): Promise<ObjectMetaData> {\n        const stat = await this.load((client) => {\n            return client.stat(key)\n        }).catch(() => {\n            return null\n        })\n\n        if (!stat) {\n            throw new Error('E_CANNOT_READ_FILE')\n        }\n\n        return {\n            contentType: undefined,\n            contentLength: stat.size,\n            etag: key,\n            lastModified: new Date(stat.modifyTime),\n        }\n    }\n\n    /**\n     * Return visibility of the file. Infer visibility from the initial\n     * config, when the driver does not support the concept of visibility.\n     */\n    async getVisibility (key: string): Promise<ObjectVisibility> {\n        void key\n\n        return 'private'\n    }\n\n    /**\n     * Return the public URL of the file. Throw an exception when the driver\n     * does not support generating URLs.\n     */\n    async getUrl (key: string): Promise<string> {\n        void key\n        throw new Error('E_URL_GENERATION_UNSUPPORTED')\n    }\n\n    /**\n     * Return the signed URL to serve a private file. Throw exception\n     * when the driver does not support generating URLs.\n     */\n    async getSignedUrl (key: string, options?: SignedURLOptions): Promise<string> {\n        void key\n        void options\n        throw new Error('E_URL_GENERATION_UNSUPPORTED')\n    }\n    /**\n     * Return the signed/temporary URL that can be used to directly upload\n     * the file contents to the storage.\n     */\n    async getSignedUploadUrl (key: string, options?: SignedURLOptions): Promise<string> {\n        void key\n        void options\n        throw new Error('E_URL_GENERATION_UNSUPPORTED')\n    }\n\n    /**\n     * Update the visibility of the file. Result in a NOOP\n     * when the driver does not support the concept of\n     * visibility.\n     */\n    async setVisibility (key: string, visibility: ObjectVisibility): Promise<void> {\n        void key\n        void visibility\n    }\n\n    /**\n     * Create a new file or update an existing file. The contents\n     * will be a UTF-8 string or \"Uint8Array\".\n     */\n    async put (key: string, contents: string | Uint8Array, options?: WriteOptions): Promise<void> {\n        if (contents instanceof Uint8Array) {\n            contents = Buffer.from(contents)\n        }\n\n        const stream = Readable.from(contents)\n\n        await this.putStream(key, stream, options)\n    }\n\n    /**\n     * Create a new file or update an existing file. The contents\n     * will be a Readable stream.\n     */\n    async putStream (key: string, contents: Readable, options?: WriteOptions): Promise<void> {\n        const dst = createWriteStream('/tmp/' + path.basename(key), {\n            encoding: options?.contentEncoding as never || 'utf-8',\n        })\n\n        await new Promise((resolve, reject) => {\n            contents.pipe(dst)\n            contents.on('error', reject)\n            dst.on('finish', resolve)\n            dst.on('error', reject)\n        })\n\n        await this.load((client) => {\n            return client.put('/tmp/' + path.basename(key), key)\n        })\n    }\n\n    /**\n     * Copy the existing file to the destination. Make sure the new file\n     * has the same visibility as the existing file. It might require\n     * manually fetching the visibility of the \"source\" file.\n     */\n    async copy (source: string, destination: string, options?: WriteOptions): Promise<void> {\n        void options\n        await this.load((client) => {\n            return client.rcopy(source, destination)\n        })\n    }\n\n    /**\n     * Move the existing file to the destination. Make sure the new file\n     * has the same visibility as the existing file. It might require\n     * manually fetching the visibility of the \"source\" file.\n     */\n    async move (source: string, destination: string, options?: WriteOptions): Promise<void> {\n        void options\n        await this.load((client) => {\n            return client.rename(source, destination)\n        })\n    }\n\n    /**\n     * Delete an existing file. Do not throw an error if the\n     * file is already missing\n     */\n    async delete (key: string): Promise<void> {\n        await this.load((client) => {\n            return client.delete(key)\n        }).catch(() => {\n            return null\n        })\n    }\n\n    /**\n     * Delete all files inside a folder. Do not throw an error\n     * if the folder does not exist or is empty.\n     */\n    async deleteAll (prefix: string): Promise<void> {\n        await this.load((client) => {\n            return client.rmdir(prefix, true)\n        }).catch(() => {\n            return null\n        })\n    }\n\n\n    /**\n     * Switch bucket at runtime if supported.\n     */\n    bucket (config: string | {\n        host: string\n        username: string\n        password: string\n        port?: number\n        verbose?: boolean\n        privateKey?: string\n    }): DriverContract {\n        return new FtpDriver(config)\n    }\n\n    /**\n     * List all files from a given folder or the root of the storage.\n     * Do not throw an error if the request folder does not exist.\n     */\n    async listAll (\n        prefix: string,\n        options?: {\n            recursive?: boolean\n            paginationToken?: string\n        }\n    ): Promise<{\n        paginationToken?: string\n        objects: Iterable<DriveFile | DriveDirectory>\n    }> {\n        void options\n\n        const data = await this.load((client) => {\n            return client.list(prefix)\n        }).catch(() => {\n            return null\n        })\n\n        return data ? {\n            objects: data.map((file) => {\n                if (file.type === 'd') {\n                    return new DriveDirectory(file.name)\n                } else {\n                    return new DriveFile(file.name, this, {\n                        contentType: undefined,\n                        contentLength: file.size,\n                        etag: file.name,\n                        lastModified: new Date(file.modifyTime),\n                    })\n                }\n            })\n        } : { objects: [] }\n    }\n\n}\n","import { DriveDirectory, DriveFile, DriveManager } from 'flydrive'\nimport { DriverContract, ObjectMetaData, ObjectVisibility, SignedURLOptions, WriteOptions } from 'flydrive/types'\nimport { appUrl, config } from '@arkstack/common'\nimport { rmSync, symlinkSync } from 'node:fs'\n\nimport { FSDriver } from 'flydrive/drivers/fs'\nimport { FtpDriver } from './FtpDriver'\nimport { Logger } from '@h3ravel/shared'\nimport { Readable } from 'node:stream'\nimport { S3Driver } from 'flydrive/drivers/s3'\nimport path from 'node:path'\n\ninterface FileLike {\n    originalname: string\n    buffer: Buffer\n    mimetype: string\n}\n\nexport class Storage implements DriverContract {\n    driver: DriveManager<any>\n    services: Record<string, () => DriverContract> = {}\n    diskName: string\n\n    constructor() {\n        for (const diskName in config('filesystem.disks')) {\n            const diskConfig = config('filesystem.disks')[diskName]\n            const driverFactory = this.driversMap[diskConfig.driver]\n\n            if (!driverFactory) {\n                throw new Error(`Unsupported driver: ${diskConfig.driver}`)\n            }\n\n            this.services[diskName] = () => driverFactory(diskConfig)\n        }\n\n        this.diskName = config('filesystem.default')\n        this.driver = new DriveManager({\n            default: config('filesystem.default'),\n            services: this.services\n        })\n    }\n\n    /**\n     * Static method to get a disk instance directly from the Storage class without needing to instantiate it first.\n     * \n     * @param diskName The name of the disk to use. If not provided, the default disk will be used.\n     * @returns A Storage instance\n     */\n    static disk<K extends string> (diskName?: K): Storage {\n        const storage = new Storage()\n\n        if (diskName) {\n            storage.diskName = diskName\n            storage.driver = new DriveManager({\n                default: diskName,\n                services: storage.services\n            })\n        }\n\n        return storage\n    }\n\n    /**\n     * Generate a unique name for the file based on random numbers and original extension\n     * \n     * @param file  The file object containing the original name\n     * @returns     A unique file name\n     */\n    static generateName = (file: { name?: string; originalname?: string }): string => {\n        const name = file.originalname || file.name || 'file'\n\n        if (typeof config('filesystem.fileNameGenerator') === 'function') {\n            return config('filesystem.fileNameGenerator')(name)\n        }\n\n        return Math.floor(Math.random() * 999999999999).toString() +\n            '_' + Math.floor(Math.random() * 999999999999) +\n            '.' + (name).split('.').pop()\n    }\n\n    /**\n     * Save the file to the storage and return the public URL and the file path\n     * \n     * @param file      The file object containing the file data\n     * @param filePath  The path where the file should be saved\n     * @param fileName  The name to save the file as (optional)\n     * @returns         A tuple containing the public URL and the file path\n     */\n    static saveFile = async (\n        file: FileLike,\n        filePath: string = '',\n        fileName?: string\n    ): Promise<[string, string]> => {\n        return new Storage().saveFile(file, filePath, fileName)\n    }\n\n    /**\n     * Save the file to the storage and return the public URL and the file path\n     * \n     * @param file      The file object containing the file data\n     * @param filePath  The path where the file should be saved\n     * @param fileName  The name to save the file as (optional)\n     * @returns         A tuple containing the public URL and the file path\n     */\n    saveFile = async (\n        file: FileLike,\n        filePath: string = '',\n        fileName?: string\n    ): Promise<[string, string]> => {\n        const name = fileName || Storage.generateName(file)\n        const drive = this.driver.use()\n\n        if (file instanceof File && !file.buffer) {\n            file.buffer = Buffer.from(await file.arrayBuffer())\n        }\n\n        await drive.put(path.join(filePath, name), file.buffer)\n\n        const url = await drive.getUrl(path.join(filePath, name))\n        const pth = this.diskName === 'local' ? path.join(filePath, name) : url\n\n        return [url, pth]\n    }\n\n    /**\n     * Return a boolean indicating if the file exists\n     */\n    exists (key: string): Promise<boolean> {\n        return this.driver.use().exists(key)\n    }\n    /**\n     * Return contents of a object for the given key as a UTF-8 string.\n     * Should throw \"E_CANNOT_READ_FILE\" error when the file\n     * does not exists.\n     */\n    get (key: string): Promise<string> {\n        return this.driver.use().get(key)\n    }\n    /**\n     * Return contents of a object for the given key as a Readable stream.\n     * Should throw \"E_CANNOT_READ_FILE\" error when the file\n     * does not exists.\n     */\n    getStream (key: string): Promise<Readable> {\n        return this.driver.use().getStream(key)\n    }\n    /**\n     * Return contents of an object for the given key as an Uint8Array.\n     * Should throw \"E_CANNOT_READ_FILE\" error when the file\n     * does not exists.\n     */\n    getBytes (key: string): Promise<Uint8Array> {\n        return this.driver.use().getBytes(key)\n    }\n    /**\n     * Return metadata of an object for the given key.\n     */\n    getMetaData (key: string): Promise<ObjectMetaData> {\n        return this.driver.use().getMetaData(key)\n    }\n    /**\n     * Return the visibility of the file\n     */\n    getVisibility (key: string): Promise<ObjectVisibility> {\n        return this.driver.use().getVisibility(key)\n    }\n    /**\n     * Return the public URL to access the file\n     */\n    getUrl (key: string): Promise<string> {\n        return this.driver.use().getUrl(key)\n    }\n    /**\n     * Return the signed/temporary URL to access the file\n     */\n    getSignedUrl (key: string, options?: SignedURLOptions): Promise<string> {\n        return this.driver.use().getSignedUrl(key, options)\n    }\n    /**\n     * Return the signed/temporary URL that can be used to directly upload\n     * the file contents to the storage.\n     */\n    getSignedUploadUrl (key: string, options?: SignedURLOptions): Promise<string> {\n        return this.driver.use().getSignedUploadUrl(key, options)\n    }\n    /**\n     * Update the visibility of the file\n     */\n    setVisibility (key: string, visibility: ObjectVisibility): Promise<void> {\n        return this.driver.use().setVisibility(key, visibility)\n    }\n    /**\n     * Write object to the destination with the provided\n     * contents.\n     */\n    put (key: string, contents: string | Uint8Array | FileLike, options?: WriteOptions): Promise<void> {\n        if (!(contents instanceof Uint8Array) && typeof contents !== 'string') {\n            contents = contents.buffer\n        }\n\n        return this.driver.use().put(key, contents, options)\n    }\n    /**\n     * Write object to the destination with the provided\n     * contents as a readable stream\n     */\n    putStream (key: string, contents: Readable, options?: WriteOptions): Promise<void> {\n        return this.driver.use().putStream(key, contents, options)\n    }\n    /**\n     * Copy the file from within the disk root location. Both\n     * the \"source\" and \"destination\" will be the key names\n     * and not absolute paths.\n     */\n    copy (source: string, destination: string, options?: WriteOptions): Promise<void> {\n        return this.driver.use().copy(source, destination, options)\n    }\n    /**\n     * Move the file from within the disk root location. Both\n     * the \"source\" and \"destination\" will be the key names\n     * and not absolute paths.\n     */\n    move (source: string, destination: string, options?: WriteOptions): Promise<void> {\n        return this.driver.use().move(source, destination, options)\n    }\n    /**\n     * Delete the file for the given key. Should not throw\n     * error when file does not exist in first place\n     */\n    delete (key: string): Promise<void> {\n        return this.driver.use().delete(key)\n    }\n    /**\n     * Delete the files and directories matching the provided prefix.\n     */\n    deleteAll (prefix: string): Promise<void> {\n        return this.driver.use().deleteAll(prefix)\n    }\n    /**\n     * The list all method must return an array of objects with\n     * the ability to paginate results (if supported).\n     */\n    listAll (prefix: string, options?: {\n        recursive?: boolean;\n        paginationToken?: string;\n    }): Promise<{\n        paginationToken?: string;\n        objects: Iterable<DriveFile | DriveDirectory>;\n    }> {\n        return this.driver.use().listAll(prefix, options)\n    }\n    /**\n     * Switch bucket at runtime if supported.\n     */\n    bucket (bucket: string): DriverContract {\n        return (this.driver.use() as any).bucket(bucket)\n    }\n\n    /**\n     * Create symbolic links for all configured links in the application configuration.\n     */\n    static link ({ force = false }: { force?: boolean } = {}): void {\n        for (const link in config('filesystem.links')) {\n            const target = config('filesystem.links')[link]\n\n            const unlink = link.replace(process.cwd(), '')\n            const untarget = target.replace(process.cwd(), '')\n\n            try {\n                if (force) rmSync(link, { recursive: true, force: true })\n                symlinkSync(target, link)\n\n                Logger.log([\n                    [' SUCCESS ', 'bgGreen'],\n                    [`[${unlink}]`, 'green'],\n                    ['is now linked to', 'white'],\n                    [`[${untarget}].`, 'green']\n                ], ' ')\n            } catch (error: any) {\n                if (error.code === 'EEXIST') {\n                    Logger.log([\n                        [' INFO ', 'bgBlue'],\n                        [`[${unlink}]`, 'green'],\n                        ['is already linked to', 'white'],\n                        [`[${untarget}].`, 'green']\n                    ], ' ')\n                } else {\n                    Logger.log([\n                        [' ERROR ', 'bgRed'],\n                        ['Failed to create symbolic link from', 'white'],\n                        [`[${unlink}]`, 'green'],\n                        ['to', 'white'],\n                        [`[${untarget}]`, 'green'],\n                        [error.message, 'red']\n                    ], ' ')\n                }\n            }\n        }\n    }\n\n    private driversMap: Record<string, (conf: Record<string, any>) => DriverContract> = {\n        local: (conf: Record<string, any>) => new FSDriver({\n            location: new URL(conf.root, import.meta.url),\n            visibility: 'public',\n            urlBuilder: {\n                async generateURL (key: string, _path: string) {\n                    return appUrl(key)\n                },\n\n                async generateSignedURL (key: string, _path: string, _opts: SignedURLOptions) {\n                    return appUrl(key)\n                },\n            },\n        }),\n        s3: (conf: Record<string, any>) => new S3Driver({\n            credentials: {\n                accessKeyId: conf.key,\n                secretAccessKey: conf.secret,\n            },\n            endpoint: conf.endpoint,\n            region: conf.region,\n            bucket: conf.bucket,\n            visibility: 'private',\n            cdnUrl: conf.url,\n        }),\n        ftp: (conf: Record<string, any>) => new FtpDriver({\n            host: conf.host,\n            username: conf.username,\n            password: conf.password,\n            port: conf.port,\n            verbose: conf.verbose,\n            privateKey: conf.privateKey,\n        }),\n    }\n}"],"mappings":"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"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@arkstack/filesystem",
-  "version": "0.4.3",
+  "version": "0.5.0",
   "type": "module",
-  "description": "Shared Filesystem utilities for ArkStack.",
+  "description": "Filesystem module for Arkstack, providing shared file storage and filesystem utitlities for the framework.",
   "homepage": "https://arkstack.toneflix.net",
   "repository": {
     "type": "git",
@@ -39,8 +39,8 @@
     "@aws-sdk/s3-request-presigner": "^3.1011.0",
     "flydrive": "^2.0.0",
     "ssh2-sftp-client": "^12.1.0",
-    "@arkstack/contract": "^0.4.3",
-    "@arkstack/common": "^0.4.3"
+    "@arkstack/common": "^0.5.0",
+    "@arkstack/contract": "^0.5.0"
   },
   "devDependencies": {
     "@types/ssh2-sftp-client": "^9.0.6"

package/dist/FtpDriver-CfUSZ1xr.js

@@ -1,237 +0,0 @@
-import { DriveDirectory, DriveFile } from "flydrive";
-import { createReadStream, createWriteStream } from "node:fs";
-import Client from "ssh2-sftp-client";
-import { Readable } from "node:stream";
-import path from "node:path";
-
-//#region src/FtpDriver.ts
-var FtpDriver = class FtpDriver {
-	config;
-	constructor(config) {
-		if (typeof config === "string") {
-			const url = new URL(config);
-			this.config = {
-				host: url.hostname,
-				username: url.username,
-				password: url.password,
-				port: url.port ? parseInt(url.port, 10) : 22,
-				verbose: url.searchParams.get("verbose") === "true"
-			};
-		} else this.config = config;
-	}
-	getConfig() {
-		return this.config;
-	}
-	async init() {
-		const client = new Client();
-		await client.connect({
-			host: this.config.host,
-			username: this.config.username,
-			password: this.config.password,
-			port: this.config.port || 22
-		});
-		return client;
-	}
-	async load(handle) {
-		const client = await this.init();
-		try {
-			return await handle(client);
-		} catch (e) {
-			if (this.config.verbose) throw e;
-		} finally {
-			await client.end();
-		}
-		return null;
-	}
-	/**
-	* Return a boolean value indicating if the file exists
-	* or not.
-	*/
-	async exists(key) {
-		return !!await this.load((client) => {
-			return client.stat(key);
-		}).catch(() => {
-			return null;
-		});
-	}
-	/**
-	* Return the file contents as a UTF-8 string. Throw an exception
-	* if the file is missing.
-	*/
-	async get(key) {
-		const stream = await this.getStream(key);
-		const chunks = [];
-		for await (const chunk of stream) chunks.push(chunk);
-		return Buffer.concat(chunks).toString("utf-8");
-	}
-	/**
-	* Return the file contents as a Readable stream. Throw an exception
-	* if the file is missing.
-	*/
-	async getStream(key) {
-		const dst = createWriteStream("/tmp/" + path.basename(key));
-		await this.load((client) => {
-			return client.get(key, dst);
-		}).catch(() => {
-			return null;
-		});
-		return createReadStream("/tmp/" + path.basename(key));
-	}
-	/**
-	* Return the file contents as a Uint8Array. Throw an exception
-	* if the file is missing.
-	*/
-	async getBytes(key) {
-		const content = await this.get(key);
-		return new Uint8Array(Buffer.from(content, "utf-8"));
-	}
-	/**
-	* Return metadata of the file. Throw an exception
-	* if the file is missing.
-	*/
-	async getMetaData(key) {
-		const stat = await this.load((client) => {
-			return client.stat(key);
-		}).catch(() => {
-			return null;
-		});
-		if (!stat) throw new Error("E_CANNOT_READ_FILE");
-		return {
-			contentType: void 0,
-			contentLength: stat.size,
-			etag: key,
-			lastModified: new Date(stat.modifyTime)
-		};
-	}
-	/**
-	* Return visibility of the file. Infer visibility from the initial
-	* config, when the driver does not support the concept of visibility.
-	*/
-	async getVisibility(key) {
-		return "private";
-	}
-	/**
-	* Return the public URL of the file. Throw an exception when the driver
-	* does not support generating URLs.
-	*/
-	async getUrl(key) {
-		throw new Error("E_URL_GENERATION_UNSUPPORTED");
-	}
-	/**
-	* Return the signed URL to serve a private file. Throw exception
-	* when the driver does not support generating URLs.
-	*/
-	async getSignedUrl(key, options) {
-		throw new Error("E_URL_GENERATION_UNSUPPORTED");
-	}
-	/**
-	* Return the signed/temporary URL that can be used to directly upload
-	* the file contents to the storage.
-	*/
-	async getSignedUploadUrl(key, options) {
-		throw new Error("E_URL_GENERATION_UNSUPPORTED");
-	}
-	/**
-	* Update the visibility of the file. Result in a NOOP
-	* when the driver does not support the concept of
-	* visibility.
-	*/
-	async setVisibility(key, visibility) {}
-	/**
-	* Create a new file or update an existing file. The contents
-	* will be a UTF-8 string or "Uint8Array".
-	*/
-	async put(key, contents, options) {
-		if (contents instanceof Uint8Array) contents = Buffer.from(contents);
-		const stream = Readable.from(contents);
-		await this.putStream(key, stream, options);
-	}
-	/**
-	* Create a new file or update an existing file. The contents
-	* will be a Readable stream.
-	*/
-	async putStream(key, contents, options) {
-		const dst = createWriteStream("/tmp/" + path.basename(key), { encoding: options?.contentEncoding || "utf-8" });
-		await new Promise((resolve, reject) => {
-			contents.pipe(dst);
-			contents.on("error", reject);
-			dst.on("finish", resolve);
-			dst.on("error", reject);
-		});
-		await this.load((client) => {
-			return client.put("/tmp/" + path.basename(key), key);
-		});
-	}
-	/**
-	* Copy the existing file to the destination. Make sure the new file
-	* has the same visibility as the existing file. It might require
-	* manually fetching the visibility of the "source" file.
-	*/
-	async copy(source, destination, options) {
-		await this.load((client) => {
-			return client.rcopy(source, destination);
-		});
-	}
-	/**
-	* Move the existing file to the destination. Make sure the new file
-	* has the same visibility as the existing file. It might require
-	* manually fetching the visibility of the "source" file.
-	*/
-	async move(source, destination, options) {
-		await this.load((client) => {
-			return client.rename(source, destination);
-		});
-	}
-	/**
-	* Delete an existing file. Do not throw an error if the
-	* file is already missing
-	*/
-	async delete(key) {
-		await this.load((client) => {
-			return client.delete(key);
-		}).catch(() => {
-			return null;
-		});
-	}
-	/**
-	* Delete all files inside a folder. Do not throw an error
-	* if the folder does not exist or is empty.
-	*/
-	async deleteAll(prefix) {
-		await this.load((client) => {
-			return client.rmdir(prefix, true);
-		}).catch(() => {
-			return null;
-		});
-	}
-	/**
-	* Switch bucket at runtime if supported.
-	*/
-	bucket(config) {
-		return new FtpDriver(config);
-	}
-	/**
-	* List all files from a given folder or the root of the storage.
-	* Do not throw an error if the request folder does not exist.
-	*/
-	async listAll(prefix, options) {
-		const data = await this.load((client) => {
-			return client.list(prefix);
-		}).catch(() => {
-			return null;
-		});
-		return data ? { objects: data.map((file) => {
-			if (file.type === "d") return new DriveDirectory(file.name);
-			else return new DriveFile(file.name, this, {
-				contentType: void 0,
-				contentLength: file.size,
-				etag: file.name,
-				lastModified: new Date(file.modifyTime)
-			});
-		}) } : { objects: [] };
-	}
-};
-
-//#endregion
-export { FtpDriver as t };
-//# sourceMappingURL=FtpDriver-CfUSZ1xr.js.map

package/dist/FtpDriver-CfUSZ1xr.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"FtpDriver-CfUSZ1xr.js","names":[],"sources":["../src/FtpDriver.ts"],"sourcesContent":["import { DriveDirectory, DriveFile } from 'flydrive'\nimport type {\n    DriverContract,\n    ObjectMetaData,\n    ObjectVisibility,\n    SignedURLOptions,\n    WriteOptions,\n} from 'flydrive/types'\nimport { createReadStream, createWriteStream } from 'node:fs'\n\nimport Client from 'ssh2-sftp-client'\nimport { Readable } from 'node:stream'\nimport path from 'node:path'\n\nexport class FtpDriver implements DriverContract {\n    private config: {\n        host: string\n        username: string\n        password: string\n        port?: number\n        verbose?: boolean\n        privateKey?: string\n    }\n\n    constructor(config: string | {\n        host: string\n        username: string\n        password: string\n        port?: number\n        verbose?: boolean\n        privateKey?: string\n    }) {\n        if (typeof config === 'string') {\n            const url = new URL(config)\n\n            this.config = {\n                host: url.hostname,\n                username: url.username,\n                password: url.password,\n                port: url.port ? parseInt(url.port, 10) : 22,\n                verbose: url.searchParams.get('verbose') === 'true',\n            }\n        } else {\n            this.config = config\n        }\n    }\n\n    getConfig () {\n        return this.config\n    }\n\n    private async init () {\n        const client = new Client()\n\n        await client.connect({\n            host: this.config.host,\n            username: this.config.username,\n            password: this.config.password,\n            port: this.config.port || 22,\n        })\n\n        return client\n    }\n\n    private async load<T> (handle: (client: Client) => Promise<T>): Promise<T> {\n        const client = await this.init()\n\n        try {\n            return await handle(client)\n        } catch (e) {\n            if (this.config.verbose) {\n                throw e\n            }\n        } finally {\n            await client.end()\n        }\n\n        return null as any\n    }\n\n    /**\n     * Return a boolean value indicating if the file exists\n     * or not.\n     */\n    async exists (key: string): Promise<boolean> {\n        const client = await this.load((client) => {\n            return client.stat(key)\n        }).catch(() => {\n            return null\n        })\n\n        return !!client\n    }\n\n    /**\n     * Return the file contents as a UTF-8 string. Throw an exception\n     * if the file is missing.\n     */\n    async get (key: string): Promise<string> {\n        const stream = await this.getStream(key)\n\n        const chunks: Uint8Array[] = []\n        for await (const chunk of stream) {\n            chunks.push(chunk)\n        }\n\n        return Buffer.concat(chunks).toString('utf-8')\n    }\n\n    /**\n     * Return the file contents as a Readable stream. Throw an exception\n     * if the file is missing.\n     */\n    async getStream (key: string): Promise<Readable> {\n        const dst = createWriteStream('/tmp/' + path.basename(key))\n        await this.load((client) => {\n            return client.get(key, dst)\n        }).catch(() => {\n            return null\n        })\n\n        return createReadStream('/tmp/' + path.basename(key))\n    }\n\n    /**\n     * Return the file contents as a Uint8Array. Throw an exception\n     * if the file is missing.\n     */\n    async getBytes (key: string): Promise<Uint8Array> {\n        const content = await this.get(key)\n\n        return new Uint8Array(Buffer.from(content, 'utf-8'))\n    }\n\n    /**\n     * Return metadata of the file. Throw an exception\n     * if the file is missing.\n     */\n    async getMetaData (key: string): Promise<ObjectMetaData> {\n        const stat = await this.load((client) => {\n            return client.stat(key)\n        }).catch(() => {\n            return null\n        })\n\n        if (!stat) {\n            throw new Error('E_CANNOT_READ_FILE')\n        }\n\n        return {\n            contentType: undefined,\n            contentLength: stat.size,\n            etag: key,\n            lastModified: new Date(stat.modifyTime),\n        }\n    }\n\n    /**\n     * Return visibility of the file. Infer visibility from the initial\n     * config, when the driver does not support the concept of visibility.\n     */\n    async getVisibility (key: string): Promise<ObjectVisibility> {\n        void key\n\n        return 'private'\n    }\n\n    /**\n     * Return the public URL of the file. Throw an exception when the driver\n     * does not support generating URLs.\n     */\n    async getUrl (key: string): Promise<string> {\n        void key\n        throw new Error('E_URL_GENERATION_UNSUPPORTED')\n    }\n\n    /**\n     * Return the signed URL to serve a private file. Throw exception\n     * when the driver does not support generating URLs.\n     */\n    async getSignedUrl (key: string, options?: SignedURLOptions): Promise<string> {\n        void key\n        void options\n        throw new Error('E_URL_GENERATION_UNSUPPORTED')\n    }\n    /**\n     * Return the signed/temporary URL that can be used to directly upload\n     * the file contents to the storage.\n     */\n    async getSignedUploadUrl (key: string, options?: SignedURLOptions): Promise<string> {\n        void key\n        void options\n        throw new Error('E_URL_GENERATION_UNSUPPORTED')\n    }\n\n    /**\n     * Update the visibility of the file. Result in a NOOP\n     * when the driver does not support the concept of\n     * visibility.\n     */\n    async setVisibility (key: string, visibility: ObjectVisibility): Promise<void> {\n        void key\n        void visibility\n    }\n\n    /**\n     * Create a new file or update an existing file. The contents\n     * will be a UTF-8 string or \"Uint8Array\".\n     */\n    async put (key: string, contents: string | Uint8Array, options?: WriteOptions): Promise<void> {\n        if (contents instanceof Uint8Array) {\n            contents = Buffer.from(contents)\n        }\n\n        const stream = Readable.from(contents)\n\n        await this.putStream(key, stream, options)\n    }\n\n    /**\n     * Create a new file or update an existing file. The contents\n     * will be a Readable stream.\n     */\n    async putStream (key: string, contents: Readable, options?: WriteOptions): Promise<void> {\n        const dst = createWriteStream('/tmp/' + path.basename(key), {\n            encoding: options?.contentEncoding as never || 'utf-8',\n        })\n\n        await new Promise((resolve, reject) => {\n            contents.pipe(dst)\n            contents.on('error', reject)\n            dst.on('finish', resolve)\n            dst.on('error', reject)\n        })\n\n        await this.load((client) => {\n            return client.put('/tmp/' + path.basename(key), key)\n        })\n    }\n\n    /**\n     * Copy the existing file to the destination. Make sure the new file\n     * has the same visibility as the existing file. It might require\n     * manually fetching the visibility of the \"source\" file.\n     */\n    async copy (source: string, destination: string, options?: WriteOptions): Promise<void> {\n        void options\n        await this.load((client) => {\n            return client.rcopy(source, destination)\n        })\n    }\n\n    /**\n     * Move the existing file to the destination. Make sure the new file\n     * has the same visibility as the existing file. It might require\n     * manually fetching the visibility of the \"source\" file.\n     */\n    async move (source: string, destination: string, options?: WriteOptions): Promise<void> {\n        void options\n        await this.load((client) => {\n            return client.rename(source, destination)\n        })\n    }\n\n    /**\n     * Delete an existing file. Do not throw an error if the\n     * file is already missing\n     */\n    async delete (key: string): Promise<void> {\n        await this.load((client) => {\n            return client.delete(key)\n        }).catch(() => {\n            return null\n        })\n    }\n\n    /**\n     * Delete all files inside a folder. Do not throw an error\n     * if the folder does not exist or is empty.\n     */\n    async deleteAll (prefix: string): Promise<void> {\n        await this.load((client) => {\n            return client.rmdir(prefix, true)\n        }).catch(() => {\n            return null\n        })\n    }\n\n\n    /**\n     * Switch bucket at runtime if supported.\n     */\n    bucket (config: string | {\n        host: string\n        username: string\n        password: string\n        port?: number\n        verbose?: boolean\n        privateKey?: string\n    }): DriverContract {\n        return new FtpDriver(config)\n    }\n\n    /**\n     * List all files from a given folder or the root of the storage.\n     * Do not throw an error if the request folder does not exist.\n     */\n    async listAll (\n        prefix: string,\n        options?: {\n            recursive?: boolean\n            paginationToken?: string\n        }\n    ): Promise<{\n        paginationToken?: string\n        objects: Iterable<DriveFile | DriveDirectory>\n    }> {\n        void options\n\n        const data = await this.load((client) => {\n            return client.list(prefix)\n        }).catch(() => {\n            return null\n        })\n\n        return data ? {\n            objects: data.map((file) => {\n                if (file.type === 'd') {\n                    return new DriveDirectory(file.name)\n                } else {\n                    return new DriveFile(file.name, this, {\n                        contentType: undefined,\n                        contentLength: file.size,\n                        etag: file.name,\n                        lastModified: new Date(file.modifyTime),\n                    })\n                }\n            })\n        } : { objects: [] }\n    }\n\n}\n"],"mappings":"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"}

package/dist/commands/StorageLinkCommand.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"StorageLinkCommand.d.ts","names":[],"sources":["../../src/commands/StorageLinkCommand.ts"],"mappings":";;;cAGa,kBAAA,SAA2B,OAAA;EAAA,UAC1B,SAAA;EAAA,UAGA,WAAA;EAEJ,MAAA,CAAA,GAAM,OAAA;AAAA"}

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;UAYU,QAAA;EACN,YAAA;EACA,MAAA,EAAQ,MAAA;EACR,QAAA;AAAA;AAAA,cAGS,OAAA,YAAmB,cAAA;EAC5B,MAAA,EAAQ,YAAA;EACR,QAAA,EAAU,MAAA,eAAqB,cAAA;EAC/B,QAAA;;SA2BO,IAAA,kBAAA,CAAwB,QAAA,GAAW,CAAA,GAAI,OAAA;EAAA,OAoBvC,YAAA,GAAgB,IAAA;IAAQ,IAAA;IAAe,YAAA;EAAA;EAAA,OAoBvC,QAAA,GACH,IAAA,EAAM,QAAA,EACN,QAAA,WACA,QAAA,cACD,OAAA;EAYH,QAAA,GACI,IAAA,EAAM,QAAA,EACN,QAAA,WACA,QAAA,cACD,OAAA;EAmBH,MAAA,CAAQ,GAAA,WAAc,OAAA;EAQtB,GAAA,CAAK,GAAA,WAAc,OAAA;EAQnB,SAAA,CAAW,GAAA,WAAc,OAAA,CAAQ,QAAA;EAQjC,QAAA,CAAU,GAAA,WAAc,OAAA,CAAQ,UAAA;EAMhC,WAAA,CAAa,GAAA,WAAc,OAAA,CAAQ,cAAA;EAMnC,aAAA,CAAe,GAAA,WAAc,OAAA,CAAQ,gBAAA;EAMrC,MAAA,CAAQ,GAAA,WAAc,OAAA;EAMtB,YAAA,CAAc,GAAA,UAAa,OAAA,GAAU,gBAAA,GAAmB,OAAA;EAOxD,kBAAA,CAAoB,GAAA,UAAa,OAAA,GAAU,gBAAA,GAAmB,OAAA;EAM9D,aAAA,CAAe,GAAA,UAAa,UAAA,EAAY,gBAAA,GAAmB,OAAA;EAO3D,GAAA,CAAK,GAAA,UAAa,QAAA,WAAmB,UAAA,GAAa,QAAA,EAAU,OAAA,GAAU,YAAA,GAAe,OAAA;EAWrF,SAAA,CAAW,GAAA,UAAa,QAAA,EAAU,QAAA,EAAU,OAAA,GAAU,YAAA,GAAe,OAAA;EAQrE,IAAA,CAAM,MAAA,UAAgB,WAAA,UAAqB,OAAA,GAAU,YAAA,GAAe,OAAA;EAQpE,IAAA,CAAM,MAAA,UAAgB,WAAA,UAAqB,OAAA,GAAU,YAAA,GAAe,OAAA;EAOpE,MAAA,CAAQ,GAAA,WAAc,OAAA;EAMtB,SAAA,CAAW,MAAA,WAAiB,OAAA;EAO5B,OAAA,CAAS,MAAA,UAAgB,OAAA;IACrB,SAAA;IACA,eAAA;EAAA,IACA,OAAA;IACA,eAAA;IACA,OAAA,EAAS,QAAA,CAAS,SAAA,GAAY,cAAA;EAAA;EAOlC,MAAA,CAAQ,MAAA,WAAiB,cAAA;EAAA,OAOlB,IAAA,CAAA;IAAQ;EAAA;IAAmB,KAAA;EAAA;EAAA,QAuC1B,UAAA;AAAA"}

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { DriveDirectory, DriveFile, DriveManager } from 'flydrive'\nimport { DriverContract, ObjectMetaData, ObjectVisibility, SignedURLOptions, WriteOptions } from 'flydrive/types'\nimport { appUrl, config } from '@arkstack/common'\nimport { rmSync, symlinkSync } from 'node:fs'\n\nimport { FSDriver } from 'flydrive/drivers/fs'\nimport { FtpDriver } from './FtpDriver'\nimport { Logger } from '@h3ravel/shared'\nimport { Readable } from 'node:stream'\nimport { S3Driver } from 'flydrive/drivers/s3'\nimport path from 'node:path'\n\ninterface FileLike {\n    originalname: string\n    buffer: Buffer\n    mimetype: string\n}\n\nexport class Storage implements DriverContract {\n    driver: DriveManager<any>\n    services: Record<string, () => DriverContract> = {}\n    diskName: string\n\n    constructor() {\n        for (const diskName in config('filesystem.disks')) {\n            const diskConfig = config('filesystem.disks')[diskName]\n            const driverFactory = this.driversMap[diskConfig.driver]\n\n            if (!driverFactory) {\n                throw new Error(`Unsupported driver: ${diskConfig.driver}`)\n            }\n\n            this.services[diskName] = () => driverFactory(diskConfig)\n        }\n\n        this.diskName = config('filesystem.default')\n        this.driver = new DriveManager({\n            default: config('filesystem.default'),\n            services: this.services\n        })\n    }\n\n    /**\n     * Static method to get a disk instance directly from the Storage class without needing to instantiate it first.\n     * \n     * @param diskName The name of the disk to use. If not provided, the default disk will be used.\n     * @returns A Storage instance\n     */\n    static disk<K extends string> (diskName?: K): Storage {\n        const storage = new Storage()\n\n        if (diskName) {\n            storage.diskName = diskName\n            storage.driver = new DriveManager({\n                default: diskName,\n                services: storage.services\n            })\n        }\n\n        return storage\n    }\n\n    /**\n     * Generate a unique name for the file based on random numbers and original extension\n     * \n     * @param file  The file object containing the original name\n     * @returns     A unique file name\n     */\n    static generateName = (file: { name?: string; originalname?: string }): string => {\n        const name = file.originalname || file.name || 'file'\n\n        if (typeof config('filesystem.fileNameGenerator') === 'function') {\n            return config('filesystem.fileNameGenerator')(name)\n        }\n\n        return Math.floor(Math.random() * 999999999999).toString() +\n            '_' + Math.floor(Math.random() * 999999999999) +\n            '.' + (name).split('.').pop()\n    }\n\n    /**\n     * Save the file to the storage and return the public URL and the file path\n     * \n     * @param file      The file object containing the file data\n     * @param filePath  The path where the file should be saved\n     * @param fileName  The name to save the file as (optional)\n     * @returns         A tuple containing the public URL and the file path\n     */\n    static saveFile = async (\n        file: FileLike,\n        filePath: string = '',\n        fileName?: string\n    ): Promise<[string, string]> => {\n        return new Storage().saveFile(file, filePath, fileName)\n    }\n\n    /**\n     * Save the file to the storage and return the public URL and the file path\n     * \n     * @param file      The file object containing the file data\n     * @param filePath  The path where the file should be saved\n     * @param fileName  The name to save the file as (optional)\n     * @returns         A tuple containing the public URL and the file path\n     */\n    saveFile = async (\n        file: FileLike,\n        filePath: string = '',\n        fileName?: string\n    ): Promise<[string, string]> => {\n        const name = fileName || Storage.generateName(file)\n        const drive = this.driver.use()\n\n        if (file instanceof File && !file.buffer) {\n            file.buffer = Buffer.from(await file.arrayBuffer())\n        }\n\n        await drive.put(path.join(filePath, name), file.buffer)\n\n        const url = await drive.getUrl(path.join(filePath, name))\n        const pth = this.diskName === 'local' ? path.join(filePath, name) : url\n\n        return [url, pth]\n    }\n\n    /**\n     * Return a boolean indicating if the file exists\n     */\n    exists (key: string): Promise<boolean> {\n        return this.driver.use().exists(key)\n    }\n    /**\n     * Return contents of a object for the given key as a UTF-8 string.\n     * Should throw \"E_CANNOT_READ_FILE\" error when the file\n     * does not exists.\n     */\n    get (key: string): Promise<string> {\n        return this.driver.use().get(key)\n    }\n    /**\n     * Return contents of a object for the given key as a Readable stream.\n     * Should throw \"E_CANNOT_READ_FILE\" error when the file\n     * does not exists.\n     */\n    getStream (key: string): Promise<Readable> {\n        return this.driver.use().getStream(key)\n    }\n    /**\n     * Return contents of an object for the given key as an Uint8Array.\n     * Should throw \"E_CANNOT_READ_FILE\" error when the file\n     * does not exists.\n     */\n    getBytes (key: string): Promise<Uint8Array> {\n        return this.driver.use().getBytes(key)\n    }\n    /**\n     * Return metadata of an object for the given key.\n     */\n    getMetaData (key: string): Promise<ObjectMetaData> {\n        return this.driver.use().getMetaData(key)\n    }\n    /**\n     * Return the visibility of the file\n     */\n    getVisibility (key: string): Promise<ObjectVisibility> {\n        return this.driver.use().getVisibility(key)\n    }\n    /**\n     * Return the public URL to access the file\n     */\n    getUrl (key: string): Promise<string> {\n        return this.driver.use().getUrl(key)\n    }\n    /**\n     * Return the signed/temporary URL to access the file\n     */\n    getSignedUrl (key: string, options?: SignedURLOptions): Promise<string> {\n        return this.driver.use().getSignedUrl(key, options)\n    }\n    /**\n     * Return the signed/temporary URL that can be used to directly upload\n     * the file contents to the storage.\n     */\n    getSignedUploadUrl (key: string, options?: SignedURLOptions): Promise<string> {\n        return this.driver.use().getSignedUploadUrl(key, options)\n    }\n    /**\n     * Update the visibility of the file\n     */\n    setVisibility (key: string, visibility: ObjectVisibility): Promise<void> {\n        return this.driver.use().setVisibility(key, visibility)\n    }\n    /**\n     * Write object to the destination with the provided\n     * contents.\n     */\n    put (key: string, contents: string | Uint8Array | FileLike, options?: WriteOptions): Promise<void> {\n        if (!(contents instanceof Uint8Array) && typeof contents !== 'string') {\n            contents = contents.buffer\n        }\n\n        return this.driver.use().put(key, contents, options)\n    }\n    /**\n     * Write object to the destination with the provided\n     * contents as a readable stream\n     */\n    putStream (key: string, contents: Readable, options?: WriteOptions): Promise<void> {\n        return this.driver.use().putStream(key, contents, options)\n    }\n    /**\n     * Copy the file from within the disk root location. Both\n     * the \"source\" and \"destination\" will be the key names\n     * and not absolute paths.\n     */\n    copy (source: string, destination: string, options?: WriteOptions): Promise<void> {\n        return this.driver.use().copy(source, destination, options)\n    }\n    /**\n     * Move the file from within the disk root location. Both\n     * the \"source\" and \"destination\" will be the key names\n     * and not absolute paths.\n     */\n    move (source: string, destination: string, options?: WriteOptions): Promise<void> {\n        return this.driver.use().move(source, destination, options)\n    }\n    /**\n     * Delete the file for the given key. Should not throw\n     * error when file does not exist in first place\n     */\n    delete (key: string): Promise<void> {\n        return this.driver.use().delete(key)\n    }\n    /**\n     * Delete the files and directories matching the provided prefix.\n     */\n    deleteAll (prefix: string): Promise<void> {\n        return this.driver.use().deleteAll(prefix)\n    }\n    /**\n     * The list all method must return an array of objects with\n     * the ability to paginate results (if supported).\n     */\n    listAll (prefix: string, options?: {\n        recursive?: boolean;\n        paginationToken?: string;\n    }): Promise<{\n        paginationToken?: string;\n        objects: Iterable<DriveFile | DriveDirectory>;\n    }> {\n        return this.driver.use().listAll(prefix, options)\n    }\n    /**\n     * Switch bucket at runtime if supported.\n     */\n    bucket (bucket: string): DriverContract {\n        return (this.driver.use() as any).bucket(bucket)\n    }\n\n    /**\n     * Create symbolic links for all configured links in the application configuration.\n     */\n    static link ({ force = false }: { force?: boolean } = {}): void {\n        for (const link in config('filesystem.links')) {\n            const target = config('filesystem.links')[link]\n\n            const unlink = link.replace(process.cwd(), '')\n            const untarget = target.replace(process.cwd(), '')\n\n            try {\n                if (force) rmSync(link, { recursive: true, force: true })\n                symlinkSync(target, link)\n\n                Logger.log([\n                    [' SUCCESS ', 'bgGreen'],\n                    [`[${unlink}]`, 'green'],\n                    ['is now linked to', 'white'],\n                    [`[${untarget}].`, 'green']\n                ], ' ')\n            } catch (error: any) {\n                if (error.code === 'EEXIST') {\n                    Logger.log([\n                        [' INFO ', 'bgBlue'],\n                        [`[${unlink}]`, 'green'],\n                        ['is already linked to', 'white'],\n                        [`[${untarget}].`, 'green']\n                    ], ' ')\n                } else {\n                    Logger.log([\n                        [' ERROR ', 'bgRed'],\n                        ['Failed to create symbolic link from', 'white'],\n                        [`[${unlink}]`, 'green'],\n                        ['to', 'white'],\n                        [`[${untarget}]`, 'green'],\n                        [error.message, 'red']\n                    ], ' ')\n                }\n            }\n        }\n    }\n\n    private driversMap: Record<string, (conf: Record<string, any>) => DriverContract> = {\n        local: (conf: Record<string, any>) => new FSDriver({\n            location: new URL(conf.root, import.meta.url),\n            visibility: 'public',\n            urlBuilder: {\n                async generateURL (key: string, _path: string) {\n                    return appUrl(key)\n                },\n\n                async generateSignedURL (key: string, _path: string, _opts: SignedURLOptions) {\n                    return appUrl(key)\n                },\n            },\n        }),\n        s3: (conf: Record<string, any>) => new S3Driver({\n            credentials: {\n                accessKeyId: conf.key,\n                secretAccessKey: conf.secret,\n            },\n            endpoint: conf.endpoint,\n            region: conf.region,\n            bucket: conf.bucket,\n            visibility: 'private',\n            cdnUrl: conf.url,\n        }),\n        ftp: (conf: Record<string, any>) => new FtpDriver({\n            host: conf.host,\n            username: conf.username,\n            password: conf.password,\n            port: conf.port,\n            verbose: conf.verbose,\n            privateKey: conf.privateKey,\n        }),\n    }\n}"],"mappings":"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"}