@arkstack/filesystem 0.12.0 → 0.12.1

package/README.md

@@ -1,3 +1,69 @@
 # @arkstack/filesystem
 
 Filesystem module for Arkstack, providing shared file storage and filesystem utitlities for the framework.
+
+## Custom Drivers
+
+@arkstack/filesystem allows you to configure and use custom storage drivers.
+
+**CloudinaryFileDriver.ts**
+
+```ts
+import type { DriverContract, ObjectVisibility } from 'flydrive/types';
+import type { CustomDiskConfig } from '@arkstack/filesystem';
+
+export class CloudinaryFileDriver implements DriverContract {
+  constructor(private config?: CustomDiskConfig) {}
+  async exists(key: string) {}
+  async get(key: string) {}
+  async getStream(key: string) {}
+  async getBytes(key: string) {}
+  async getMetaData(key: string) {}
+  async getVisibility(): Promise<ObjectVisibility> {}
+  async getUrl(key: string) {}
+  async getSignedUrl(key: string) {}
+  async getSignedUploadUrl(key: string) {}
+  async setVisibility() {}
+  async put() {}
+  async putStream() {}
+  async copy() {}
+  async move() {}
+  async delete() {}
+  async deleteAll() {}
+  async listAll() {}
+  async bucket() {}
+}
+```
+
+**src/config/filesystem.ts**
+
+```ts
+import { CloudinaryFileDriver } from '../CloudinaryFileDriver';
+export default () => {
+  return {
+    default: 'memory',
+    disks: {
+      images: {
+        //...Other Disks Here
+        driver: 'cloudinary',
+      },
+    },
+    links: {},
+    custom_drivers: {
+      cloudinary: CloudinaryFileDriver,
+    },
+  };
+};
+```
+
+To improve type safety and auto complete, you may augment the `CustomDiskDriverRegistry`
+
+**env.d.ts**
+
+```ts
+declare module '@arkstack/filesystem' {
+  interface CustomDiskDriverRegistry {
+    cloudinary: { cloud_name: string; api_key: string; api_secret: string };
+  }
+}
+```

package/dist/commands/StorageLinkCommand.js

@@ -1,4 +1,4 @@
-import { t as Storage } from "../src-MCtnsHF4.js";
+import { t as Storage } from "../src-Sdprva2c.js";
 import { Command } from "@h3ravel/musket";
 //#region src/commands/StorageLinkCommand.ts
 var StorageLinkCommand = class extends Command {

package/dist/index.d.ts

@@ -2,12 +2,80 @@ 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
+//#region src/types.d.ts
 interface FileLike {
   originalname: string;
   buffer: Buffer;
   mimetype: string;
 }
+interface CustomDiskDriverRegistry {}
+interface FtpDriverConfig {
+  host: string;
+  username: string;
+  password: string;
+  port?: number;
+  verbose?: boolean | undefined;
+  privateKey?: string | undefined;
+}
+interface S3DriverConfig {
+  credentials?: {
+    accessKeyId: string;
+    secretAccessKey: string;
+    sessionToken?: string | undefined;
+    credentialScope?: string | undefined;
+    accountId?: string | undefined;
+  };
+  url?: string;
+  key?: string;
+  secret?: string;
+  endpoint?: string;
+  region?: string;
+  bucket: string;
+  visibility: ObjectVisibility;
+  cdnUrl?: string;
+}
+interface LocalDriverConfig {
+  root?: string;
+  location?: string | URL;
+  visibility: ObjectVisibility;
+}
+type CustomDiskConfig = keyof CustomDiskDriverRegistry extends never ? {
+  driver: string;
+  [key: string]: any;
+} : { [K in keyof CustomDiskDriverRegistry]: CustomDiskDriverRegistry[K] & {
+  driver: K;
+} }[keyof CustomDiskDriverRegistry];
+type DiskConfig = LocalDriverConfig & {
+  driver: 'local';
+} | FtpDriverConfig & {
+  driver: 'ftp';
+} | S3DriverConfig & {
+  driver: 's3';
+} | CustomDiskConfig;
+type DriverConfig<K extends 'ftp' | 'local' | 's3' | (string & {}) = string & {}> = K extends 'ftp' ? FtpDriverConfig : K extends 's3' ? S3DriverConfig : K extends 'local' ? LocalDriverConfig : K extends keyof CustomDiskDriverRegistry ? CustomDiskDriverRegistry[K] : DiskConfig;
+type KnownDisks = {
+  local: LocalDriverConfig & {
+    driver: 'local';
+  };
+  public: LocalDriverConfig & {
+    driver: 'local';
+  };
+  ftp: FtpDriverConfig & {
+    driver: 'ftp';
+  };
+  s3: S3DriverConfig & {
+    driver: 's3';
+  };
+};
+interface FilesystemConfig {
+  default: 'local' | 'ftp' | 's3' | keyof CustomDiskDriverRegistry | (string & {});
+  disks: KnownDisks & CustomDiskDriverRegistry;
+  links: Record<string, string>;
+  custom_drivers?: Record<keyof CustomDiskDriverRegistry | (string & {}), DriverContract | (new (config?: CustomDiskConfig) => DriverContract)>;
+  fileNameGenerator?: (originalName: string) => string;
+}
+//#endregion
+//#region src/Storage.d.ts
 declare class Storage implements DriverContract {
   driver: DriveManager<any>;
   services: Record<string, () => DriverContract>;
@@ -49,8 +117,61 @@ declare class Storage implements DriverContract {
   }?: {
     force?: boolean;
   }): void;
-  private driversMap;
 }
 //#endregion
-export { Storage };
+//#region src/FtpDriver.d.ts
+declare class FtpDriver implements DriverContract {
+  private config;
+  constructor(config: string | {
+    host: string;
+    username: string;
+    password: string;
+    port?: number;
+    verbose?: boolean;
+    privateKey?: string;
+  });
+  getConfig(): {
+    host: string;
+    username: string;
+    password: string;
+    port?: number;
+    verbose?: boolean;
+    privateKey?: string;
+  };
+  private init;
+  private load;
+  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, 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>;
+  bucket(config: string | {
+    host: string;
+    username: string;
+    password: string;
+    port?: number;
+    verbose?: boolean;
+    privateKey?: string;
+  }): DriverContract;
+  listAll(prefix: string, options?: {
+    recursive?: boolean;
+    paginationToken?: string;
+  }): Promise<{
+    paginationToken?: string;
+    objects: Iterable<DriveFile | DriveDirectory>;
+  }>;
+}
+//#endregion
+export { CustomDiskConfig, CustomDiskDriverRegistry, DiskConfig, DriverConfig, FileLike, FilesystemConfig, FtpDriver, FtpDriverConfig, KnownDisks, LocalDriverConfig, S3DriverConfig, Storage };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,2 +1,2 @@
-import { t as Storage } from "./src-MCtnsHF4.js";
-export { Storage };
+import { n as FtpDriver, t as Storage } from "./src-Sdprva2c.js";
+export { FtpDriver, Storage };

package/dist/{src-MCtnsHF4.js → src-Sdprva2c.js}

@@ -1,13 +1,13 @@
 import { DriveDirectory, DriveFile, DriveManager } from "flydrive";
-import { appUrl, config } from "@arkstack/common";
 import { createReadStream, createWriteStream, rmSync, symlinkSync } from "node:fs";
 import { Arkstack } from "@arkstack/contract";
 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";
+import { appUrl, config } from "@arkstack/common";
+import { Logger } from "@h3ravel/shared";
 //#region src/FtpDriver.ts
 var FtpDriver = class FtpDriver {
 	config;
@@ -236,18 +236,101 @@ var FtpDriver = class FtpDriver {
 	}
 };
 //#endregion
-//#region src/index.ts
+//#region src/Driver.ts
+var Driver = class Driver {
+	config;
+	static customDrivers = /* @__PURE__ */ new Map();
+	constructor(config) {
+		this.config = config;
+	}
+	static make(name, config) {
+		if (![
+			"local",
+			"ftp",
+			"s3"
+		].includes(name) && !this.customDrivers.has(name)) throw new Error(`Unsupported driver: ${name}`);
+		const driver = new Driver(config);
+		if (this.customDrivers.has(name)) return driver.custom(name);
+		return driver["ftp"].apply(this);
+	}
+	local() {
+		const config = this.config;
+		return new FSDriver({
+			location: config.location ?? new URL(config.root, import.meta.url),
+			visibility: config.visibility ?? "public",
+			urlBuilder: {
+				async generateURL(key, _path) {
+					return appUrl(key);
+				},
+				async generateSignedURL(key, _path, _opts) {
+					return appUrl(key);
+				}
+			}
+		});
+	}
+	s3() {
+		const config = this.config;
+		return new S3Driver({
+			credentials: config.credentials ?? {
+				accessKeyId: config.key,
+				secretAccessKey: config.secret
+			},
+			endpoint: config.endpoint,
+			region: config.region,
+			bucket: config.bucket,
+			visibility: "private",
+			cdnUrl: config.cdnUrl ?? config.url
+		});
+	}
+	ftp() {
+		const config = this.config;
+		return new FtpDriver({
+			host: config.host,
+			username: config.username,
+			password: config.password,
+			port: config.port,
+			verbose: config.verbose,
+			privateKey: config.privateKey
+		});
+	}
+	custom(name) {
+		if (!Driver.customDrivers.has(name)) throw new Error(`Unsupported driver: ${name} has not been registered`);
+		const DriverInstance = Driver.customDrivers.get(name);
+		if (typeof DriverInstance === "function") {
+			const config = this.config;
+			return new DriverInstance(config);
+		}
+		return DriverInstance;
+	}
+	/**
+	* Register a new custom driver
+	* 
+	* @param name 
+	* @param driver 
+	*/
+	static registerDriver(name, driver) {
+		Driver.customDrivers.set(name, driver);
+	}
+	/**
+	* Unregister a new custom driver
+	* 
+	* @param name 
+	*/
+	static removeDriver(name) {
+		Driver.customDrivers.delete(name);
+	}
+};
+//#endregion
+//#region src/Storage.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);
-		}
+		const disks = Object.entries(config("filesystem.disks", {}));
+		const customDrivers = config("filesystem.custom_drivers", {});
+		for (const [name, driver] of Object.entries(customDrivers)) Driver.registerDriver(name, driver);
+		for (const [disk, conf] of disks) this.services[disk] = () => Driver.make(disk, conf);
 		this.diskName = config("filesystem.default");
 		this.driver = new DriveManager({
 			default: config("filesystem.default"),
@@ -471,41 +554,8 @@ var Storage = class Storage {
 			}
 		}
 	}
-	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 };
+export { FtpDriver as n, Storage as t };
 
-//# sourceMappingURL=src-MCtnsHF4.js.map
+//# sourceMappingURL=src-Sdprva2c.js.map

package/dist/src-Sdprva2c.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"src-Sdprva2c.js","names":[],"sources":["../src/FtpDriver.ts","../src/Driver.ts","../src/Storage.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 { CustomDiskConfig, CustomDiskDriverRegistry, DriverConfig, FtpDriverConfig, LocalDriverConfig, S3DriverConfig } from './types'\nimport { DriverContract, SignedURLOptions } from 'flydrive/types'\n\nimport { FSDriver } from 'flydrive/drivers/fs'\nimport { FtpDriver } from './FtpDriver'\nimport { S3Driver } from 'flydrive/drivers/s3'\nimport { appUrl } from '@arkstack/common'\n\ntype BuiltInDriverMap = { [K in keyof Driver]: Driver[K] }\n\ntype DriverFor<K extends string> = K extends keyof BuiltInDriverMap\n    ? ReturnType<BuiltInDriverMap[K]>\n    : ReturnType<BuiltInDriverMap['custom']>\n\nexport class Driver {\n    private static customDrivers = new Map<\n        keyof CustomDiskDriverRegistry | (string & {}),\n        DriverContract | (new (config?: CustomDiskConfig) => DriverContract)\n    >()\n\n    constructor(private config: DriverConfig) { }\n\n    static make<K extends 'local' | 'ftp' | 's3' | (string & {})> (\n        name: K,\n        config: DriverConfig<K>\n    ): DriverFor<K> {\n        if (!['local', 'ftp', 's3'].includes(name) && !this.customDrivers.has(name)) {\n            throw new Error(`Unsupported driver: ${name}`)\n        }\n\n        const driver = new Driver(config as never)\n\n        if (this.customDrivers.has(name)) {\n            return driver.custom(name) as DriverFor<K>\n        }\n\n        return driver['ftp'].apply(this) as DriverFor<K>\n\n    }\n\n    local () {\n        const config = this.config as LocalDriverConfig\n\n        return new FSDriver({\n            location: config.location ?? new URL(config.root!, import.meta.url),\n            visibility: config.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    }\n\n    s3 () {\n        const config = this.config as S3DriverConfig\n\n        return new S3Driver({\n            credentials: config.credentials ?? {\n                accessKeyId: config.key!,\n                secretAccessKey: config.secret!,\n            },\n            endpoint: config.endpoint,\n            region: config.region,\n            bucket: config.bucket,\n            visibility: 'private',\n            cdnUrl: config.cdnUrl ?? config.url,\n        })\n    }\n\n    ftp () {\n        const config = this.config as FtpDriverConfig\n\n        return new FtpDriver({\n            host: config.host,\n            username: config.username,\n            password: config.password,\n            port: config.port,\n            verbose: config.verbose,\n            privateKey: config.privateKey,\n        })\n    }\n\n    custom (name: string): DriverContract {\n        if (!Driver.customDrivers.has(name)) {\n            throw new Error(`Unsupported driver: ${name} has not been registered`)\n        }\n\n        const DriverInstance = Driver.customDrivers.get(name)!\n\n        if (typeof DriverInstance === 'function') {\n            const config = this.config as CustomDiskConfig\n\n            return new DriverInstance(config)\n        }\n\n        return DriverInstance\n    }\n\n    /**\n     * Register a new custom driver\n     * \n     * @param name \n     * @param driver \n     */\n    static registerDriver (name: string, driver: DriverContract) {\n        Driver.customDrivers.set(name, driver)\n    }\n\n    /**\n     * Unregister a new custom driver\n     * \n     * @param name \n     */\n    static removeDriver (name: string) {\n        Driver.customDrivers.delete(name)\n    }\n}","import { DriveDirectory, DriveFile, DriveManager } from 'flydrive'\nimport { DriverConfig, FileLike } from './types'\nimport { DriverContract, ObjectMetaData, ObjectVisibility, SignedURLOptions, WriteOptions } from 'flydrive/types'\nimport { rmSync, symlinkSync } from 'node:fs'\n\nimport { Arkstack } from '@arkstack/contract'\nimport { Driver } from './Driver'\nimport { Logger } from '@h3ravel/shared'\nimport { Readable } from 'node:stream'\nimport { config } from '@arkstack/common'\nimport path from 'node:path'\n\nexport class Storage implements DriverContract {\n    driver: DriveManager<any>\n    services: Record<string, () => DriverContract> = {}\n    diskName: string\n\n    constructor() {\n        const disks = Object.entries(config('filesystem.disks', {})) as Array<[string, DriverConfig]>\n        const customDrivers = config('filesystem.custom_drivers', {}) as Record<string, DriverContract>\n\n        for (const [name, driver] of Object.entries(customDrivers)) {\n            Driver.registerDriver(name, driver)\n        }\n\n        for (const [disk, conf] of disks) {\n            this.services[disk] = () => Driver.make(disk, conf)\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(Arkstack.rootDir(), '')\n            const untarget = target.replace(Arkstack.rootDir(), '')\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}"],"mappings":"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"}

package/package.json

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

package/dist/src-MCtnsHF4.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"src-MCtnsHF4.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 { Arkstack } from '@arkstack/contract'\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(Arkstack.rootDir(), '')\n            const untarget = target.replace(Arkstack.rootDir(), '')\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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"}