@arkstack/filesystem 0.2.0

package/README.md

@@ -0,0 +1,3 @@
+# @arkstack/filesystem
+
+Shared Filesystem utilities for ArkStack.

package/dist/FtpDriver-CfUSZ1xr.js

@@ -0,0 +1,237 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,11 @@
+import { Command } from "@h3ravel/musket";
+
+//#region src/commands/StorageLinkCommand.d.ts
+declare class StorageLinkCommand extends Command {
+  protected signature: string;
+  protected description: string;
+  handle(): Promise<void>;
+}
+//#endregion
+export { StorageLinkCommand };
+//# sourceMappingURL=StorageLinkCommand.d.ts.map

package/dist/commands/StorageLinkCommand.js

@@ -0,0 +1,18 @@
+import "../FtpDriver-CfUSZ1xr.js";
+import { Storage } from "../index.js";
+import { Command } from "@h3ravel/musket";
+
+//#region src/commands/StorageLinkCommand.ts
+var StorageLinkCommand = class extends Command {
+	signature = `storage:link
+        {--force : Remove existing links before creating new ones.}
+    `;
+	description = "Create symbolic links for filesystem.links configuration.";
+	async handle() {
+		Storage.link(this.options());
+	}
+};
+
+//#endregion
+export { StorageLinkCommand };
+//# sourceMappingURL=StorageLinkCommand.js.map

package/dist/commands/StorageLinkCommand.js.map

@@ -0,0 +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"}

package/dist/index.d.ts

@@ -0,0 +1,55 @@
+import { DriveDirectory, DriveFile, DriveManager } from "flydrive";
+import { Readable } from "node:stream";
+import { DriverContract, ObjectMetaData, ObjectVisibility, SignedURLOptions, WriteOptions } from "flydrive/types";
+
+//#region src/index.d.ts
+interface FileLike {
+  originalname: string;
+  buffer: Buffer;
+  mimetype: string;
+}
+declare class Storage implements DriverContract {
+  driver: DriveManager<any>;
+  services: Record<string, () => DriverContract>;
+  constructor();
+  static disk<K extends string>(diskName?: K): Storage;
+  static generateName: (file: {
+    name?: string;
+    originalname?: string;
+  }) => string;
+  static saveFile: (file: FileLike, filePath?: string, fileName?: string) => Promise<[string, string]>;
+  saveFile: (file: FileLike, filePath?: string, fileName?: string) => Promise<[string, string]>;
+  exists(key: string): Promise<boolean>;
+  get(key: string): Promise<string>;
+  getStream(key: string): Promise<Readable>;
+  getBytes(key: string): Promise<Uint8Array>;
+  getMetaData(key: string): Promise<ObjectMetaData>;
+  getVisibility(key: string): Promise<ObjectVisibility>;
+  getUrl(key: string): Promise<string>;
+  getSignedUrl(key: string, options?: SignedURLOptions): Promise<string>;
+  getSignedUploadUrl(key: string, options?: SignedURLOptions): Promise<string>;
+  setVisibility(key: string, visibility: ObjectVisibility): Promise<void>;
+  put(key: string, contents: string | Uint8Array | FileLike, options?: WriteOptions): Promise<void>;
+  putStream(key: string, contents: Readable, options?: WriteOptions): Promise<void>;
+  copy(source: string, destination: string, options?: WriteOptions): Promise<void>;
+  move(source: string, destination: string, options?: WriteOptions): Promise<void>;
+  delete(key: string): Promise<void>;
+  deleteAll(prefix: string): Promise<void>;
+  listAll(prefix: string, options?: {
+    recursive?: boolean;
+    paginationToken?: string;
+  }): Promise<{
+    paginationToken?: string;
+    objects: Iterable<DriveFile | DriveDirectory>;
+  }>;
+  bucket(bucket: string): DriverContract;
+  static link({
+    force
+  }?: {
+    force?: boolean;
+  }): void;
+  private driversMap;
+}
+//#endregion
+export { Storage };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,273 @@
+import { t as FtpDriver } from "./FtpDriver-CfUSZ1xr.js";
+import { DriveManager } from "flydrive";
+import { appUrl, config } from "@arkstack/common";
+import { existsSync, 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 = {};
+	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.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.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);
+		return [await drive.getUrl(path.join(filePath, name)), path.join(filePath, name)];
+	};
+	/**
+	* 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 && existsSync(link)) rmSync(link, { recursive: 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 };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"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 { existsSync, 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\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.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.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        return [await drive.getUrl(path.join(filePath, name)), path.join(filePath, name)]\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 && existsSync(link)) rmSync(link, { recursive: 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

@@ -0,0 +1,53 @@
+{
+  "name": "@arkstack/filesystem",
+  "version": "0.2.0",
+  "type": "module",
+  "description": "Shared Filesystem utilities for ArkStack.",
+  "homepage": "https://arkstack.toneflix.net",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/arkstack-hq/arkstack.git",
+    "directory": "packages/filesystem"
+  },
+  "keywords": [
+    "filesystem",
+    "storage",
+    "utilities",
+    "interface",
+    "runtime",
+    "application",
+    "framework",
+    "flydrive"
+  ],
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./commands/StorageLinkCommand": "./dist/commands/StorageLinkCommand.js",
+    "./package.json": "./package.json"
+  },
+  "peerDependencies": {
+    "@h3ravel/musket": "^0.10.1"
+  },
+  "dependencies": {
+    "@h3ravel/shared": "^0.27.13",
+    "@aws-sdk/client-s3": "^3.1011.0",
+    "@aws-sdk/s3-request-presigner": "^3.1011.0",
+    "flydrive": "^2.0.0",
+    "ssh2-sftp-client": "^12.1.0",
+    "@arkstack/common": "^0.2.0",
+    "@arkstack/contract": "^0.2.0"
+  },
+  "devDependencies": {
+    "@types/ssh2-sftp-client": "^9.0.6"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest",
+    "version:patch": "pnpm version patch"
+  }
+}