snapshot of https://github.com/RocketChat/Rocket.Chat.git (develop, 2026-09-16; blobs > 131072B omitted)

apps/meteor/server/ufs/ufs-local.ts

@@ -0,0 +1,111 @@
+import fs from 'node:fs';
+import { unlink } from 'node:fs/promises';
+import { isNativeError } from 'node:util/types';
+
+import type { IUpload } from '@rocket.chat/core-typings';
+import mkdirp from 'mkdirp';
+
+import { UploadFS } from './ufs';
+import type { StoreOptions } from './ufs-store';
+import { Store } from './ufs-store';
+
+type LocalStoreOptions = StoreOptions & {
+	mode?: string;
+	path?: string;
+	writeMode?: number;
+};
+
+export class LocalStore extends Store {
+	protected getPath: (file: string) => string;
+
+	constructor(options: LocalStoreOptions) {
+		// Default options
+		options = {
+			mode: '0744',
+			path: 'ufs/uploads',
+			writeMode: 0o744,
+			...options,
+		};
+
+		// Check options
+		if (typeof options.mode !== 'string') {
+			throw new TypeError('LocalStore: mode is not a string');
+		}
+		if (typeof options.path !== 'string') {
+			throw new TypeError('LocalStore: path is not a string');
+		}
+		if (typeof options.writeMode !== 'number') {
+			throw new TypeError('LocalStore: writeMode is not a string');
+		}
+
+		super(options);
+
+		// Private attributes
+		const { mode } = options;
+		const { path } = options;
+		const { writeMode } = options;
+
+		fs.stat(path, (err) => {
+			if (err) {
+				// Create the directory
+				mkdirp(path, { mode })
+					.then(() => {
+						console.info(`LocalStore: store created at ${path}`);
+					})
+					.catch((err) => {
+						console.error(`LocalStore: cannot create store at ${path} (${err.message})`);
+					});
+			} else {
+				// Set directory permissions
+				fs.chmod(path, mode, (err) => {
+					err && console.error(`LocalStore: cannot set store permissions ${mode} (${err.message})`);
+				});
+			}
+		});
+
+		this.getPath = function (file) {
+			return path + (file ? `/${file}` : '');
+		};
+
+		this.delete = async (fileId, options) => {
+			const path = await this.getFilePath(fileId);
+			try {
+				await unlink(path);
+			} catch (error) {
+				if (!isNativeError(error) || !('code' in error) || !(error.code === 'ENOENT')) {
+					throw error;
+				}
+			}
+			await this.removeById(fileId, { session: options?.session }, true);
+		};
+
+		this.getReadStream = async (fileId: string, file: IUpload, options?: { start?: number; end?: number }) => {
+			options = Object.assign({}, options);
+			return fs.createReadStream(await this.getFilePath(fileId, file), {
+				flags: 'r',
+				encoding: undefined,
+				autoClose: true,
+				start: options.start,
+				end: options.end,
+			});
+		};
+
+		this.getWriteStream = async (fileId: string, file: IUpload, options?: { start?: number }) => {
+			options = Object.assign({}, options);
+			return fs.createWriteStream(await this.getFilePath(fileId, file), {
+				flags: 'a',
+				encoding: undefined,
+				mode: writeMode,
+				start: options.start,
+			});
+		};
+	}
+
+	override async getFilePath(fileId: string, fileParam?: IUpload): Promise<string> {
+		const file = fileParam || (await this.getCollection().findOne(fileId, { projection: { extension: 1 } }));
+		return (file && this.getPath(fileId + (file.extension ? `.${file.extension}` : ''))) || '';
+	}
+}
+
+// Add store to UFS namespace
+UploadFS.store.Local = LocalStore;