@kollors/deep-json-server 0.7.0 → 0.8.0

package/dist/src/database.js

@@ -0,0 +1,136 @@
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { JSONFilePreset } from 'lowdb/node';
+import { createHttpError, createSerialQueue, createUniqueId, isObject, isSafeKey, isSystemError, resolveDatabasePath } from './utils.js';
+const RESOURCE_NAME_PATTERN = /^[A-Za-z][A-Za-z0-9_-]*$/;
+export const validateJsonValue = (value, path, ancestors = new WeakSet()) => {
+    if (value === null || typeof value === 'string' || typeof value === 'boolean') {
+        return;
+    }
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value)) {
+            throw new Error(`${path} должен содержать конечное число`);
+        }
+        return;
+    }
+    if (typeof value !== 'object') {
+        throw new Error(`${path} содержит значение, несовместимое с JSON`);
+    }
+    if (ancestors.has(value)) {
+        throw new Error(`${path} содержит циклическую ссылку`);
+    }
+    const prototype = Object.getPrototypeOf(value);
+    if (!Array.isArray(value) && prototype !== Object.prototype && prototype !== null) {
+        throw new Error(`${path} должен содержать обычный JSON-объект`);
+    }
+    ancestors.add(value);
+    if (Array.isArray(value)) {
+        for (let index = 0; index < value.length; index += 1) {
+            if (!Object.hasOwn(value, index)) {
+                throw new Error(`${path}[${index}] отсутствует; разреженные массивы несовместимы с JSON`);
+            }
+            validateJsonValue(value[index], `${path}[${index}]`, ancestors);
+        }
+    }
+    else {
+        Object.entries(value).forEach(([key, item]) => {
+            validateJsonValue(item, `${path}.${key}`, ancestors);
+        });
+    }
+    ancestors.delete(value);
+};
+export const validateDatabase = (data) => {
+    if (!isObject(data)) {
+        throw new Error('База данных должна содержать JSON-объект');
+    }
+    validateJsonValue(data, 'База данных');
+    Object.entries(data).forEach(([resource, records]) => {
+        if (!RESOURCE_NAME_PATTERN.test(resource) || !isSafeKey(resource)) {
+            throw new Error(`Недопустимое имя ресурса «${resource}»`);
+        }
+        if (!Array.isArray(records)) {
+            throw new Error(`Ресурс «${resource}» должен содержать JSON-массив`);
+        }
+        const ids = new Set();
+        records.forEach((record, index) => {
+            if (!isObject(record)) {
+                throw new Error(`Запись ${index} ресурса «${resource}» должна содержать JSON-объект`);
+            }
+            if (typeof record.id !== 'string' && !(typeof record.id === 'number' && Number.isFinite(record.id))) {
+                throw new Error(`Запись ${index} ресурса «${resource}» должна содержать строковый или числовой id`);
+            }
+            if (String(record.id) === '') {
+                throw new Error(`Запись ${index} ресурса «${resource}» должна содержать непустой id`);
+            }
+            const id = String(record.id);
+            if (ids.has(id)) {
+                throw new Error(`Ресурс «${resource}» содержит повторяющийся id «${id}»`);
+            }
+            ids.add(id);
+        });
+    });
+    return data;
+};
+export const readJsonObjectFile = async (path, label) => {
+    const resolvedPath = resolve(path);
+    let source;
+    try {
+        source = await readFile(resolvedPath, 'utf8');
+    }
+    catch (error) {
+        if (isSystemError(error) && error.code === 'ENOENT') {
+            throw new Error(`${label} не найден: ${resolvedPath}`);
+        }
+        throw error;
+    }
+    const value = JSON.parse(source);
+    if (!isObject(value)) {
+        throw new Error(`${label} должен содержать JSON-объект`);
+    }
+    return value;
+};
+export const readDatabaseFile = async (databasePath) => validateDatabase(await readJsonObjectFile(databasePath, 'Файл базы данных'));
+const createDiskDatabaseStore = async (databasePath) => {
+    const resolvedDatabasePath = resolveDatabasePath(databasePath);
+    const initialData = await readDatabaseFile(resolvedDatabasePath);
+    const database = await JSONFilePreset(resolvedDatabasePath, initialData);
+    const schedule = createSerialQueue();
+    const read = async () => {
+        database.data = await readDatabaseFile(resolvedDatabasePath);
+        return database.data;
+    };
+    const update = (operation) => schedule(async () => {
+        await read();
+        const result = operation(database);
+        validateDatabase(database.data);
+        await database.write();
+        return result;
+    });
+    return { database, path: resolvedDatabasePath, read, update };
+};
+const createMemoryDatabaseStore = (sourceData) => {
+    validateDatabase(sourceData);
+    const database = { data: structuredClone(sourceData) };
+    const schedule = createSerialQueue();
+    const read = async () => database.data;
+    const update = (operation) => schedule(() => {
+        const draft = { data: structuredClone(database.data) };
+        const result = operation(draft);
+        validateDatabase(draft.data);
+        database.data = draft.data;
+        return result;
+    });
+    return { database, read, update };
+};
+/** Creates a disk- or memory-backed database with serialized updates. */
+export const createDatabaseStore = async (config) => (config.data != null ? createMemoryDatabaseStore(config.data) : createDiskDatabaseStore(config.path));
+export const getCollection = (database, resource) => {
+    const collection = isSafeKey(resource) ? database.data[resource] : undefined;
+    if (!Array.isArray(collection)) {
+        throw createHttpError(404, 'Ресурс не найден');
+    }
+    return collection;
+};
+export const findItemIndex = (collection, id) => collection.findIndex((item) => String(item.id) === String(id));
+export const createId = (collection) => createUniqueId((id) => findItemIndex(collection, id) !== -1);
+//# sourceMappingURL=database.js.map

package/dist/src/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/database.ts"],"names":[],"mappings":"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"}

package/dist/src/files/contract.d.ts

@@ -0,0 +1,67 @@
+import type { Readable } from 'node:stream';
+import type { OpenapiSchema } from '../types.js';
+export interface StoredFileMetadata {
+    directory: string;
+    mimeType: string;
+    name: string;
+}
+export interface FileRecord extends StoredFileMetadata {
+    size: number;
+}
+export interface FileMetadata extends FileRecord {
+    downloadUrl: string;
+    metadataUrl: string;
+    url: string;
+}
+export interface FileUpload extends StoredFileMetadata {
+    maxFileSize: number;
+    override: boolean;
+    stream: Readable;
+}
+export interface FileUpdate {
+    directory?: string;
+    name?: string;
+}
+export interface FileStore {
+    get(path: string): Promise<{
+        file: FileRecord;
+        stream: Readable;
+    }>;
+    metadata(path: string): Promise<FileRecord>;
+    remove(path: string): Promise<void>;
+    update(path: string, update: FileUpdate): Promise<FileRecord>;
+    upload(upload: FileUpload): Promise<{
+        created: boolean;
+        file: FileRecord;
+    }>;
+}
+export declare const FILE_HEADERS: {
+    readonly directory: {
+        readonly key: 'content-directory';
+        readonly name: 'Content-Directory';
+    };
+    readonly name: {
+        readonly key: 'content-name';
+        readonly name: 'Content-Name';
+    };
+    readonly override: {
+        readonly key: 'content-override';
+        readonly name: 'Content-Override';
+    };
+};
+export declare const FILE_ROUTES: {
+    readonly download: '/_files/download';
+    readonly metadata: '/_files/metadata';
+    readonly storage: '/_files/storage';
+};
+export declare const PATCH_BODY_LIMIT: number;
+export declare const FILE_METADATA_SCHEMA: OpenapiSchema;
+export declare const FILE_UPDATE_SCHEMA: OpenapiSchema;
+export declare const getFileKey: ({ directory, name }: Pick<StoredFileMetadata, 'directory' | 'name'>) => string;
+export declare const validateName: (value: unknown, source: string) => string;
+export declare const validateDirectory: (value: unknown, source: string) => string;
+export declare const normalizeMimeType: (value: unknown, source?: string) => string;
+export declare const normalizeStoredFileMetadata: (value: unknown, source: string) => StoredFileMetadata;
+export declare const getPathLocation: (path: string) => Pick<StoredFileMetadata, 'directory' | 'name'>;
+export declare const createFileMetadata: (file: FileRecord) => FileMetadata;
+export declare const getDownloadName: (name: string) => string;

package/dist/src/files/contract.js

@@ -0,0 +1,106 @@
+import { basename } from 'node:path';
+import { createHttpError, isObject } from '../utils.js';
+export const FILE_HEADERS = {
+    directory: { key: 'content-directory', name: 'Content-Directory' },
+    name: { key: 'content-name', name: 'Content-Name' },
+    override: { key: 'content-override', name: 'Content-Override' },
+};
+export const FILE_ROUTES = {
+    download: '/_files/download',
+    metadata: '/_files/metadata',
+    storage: '/_files/storage',
+};
+export const PATCH_BODY_LIMIT = 64 * 1024;
+const MIME_TYPE_PATTERN = /^[A-Za-z0-9!#$%&'*+.^_`|~-]+\/[A-Za-z0-9!#$%&'*+.^_`|~-]+$/;
+export const FILE_METADATA_SCHEMA = {
+    properties: {
+        directory: { type: 'string' },
+        downloadUrl: { format: 'uri-reference', type: 'string' },
+        metadataUrl: { format: 'uri-reference', type: 'string' },
+        mimeType: { type: 'string' },
+        name: { type: 'string' },
+        size: { minimum: 0, type: 'integer' },
+        url: { format: 'uri-reference', type: 'string' },
+    },
+    required: ['directory', 'downloadUrl', 'metadataUrl', 'mimeType', 'name', 'size', 'url'],
+    type: 'object',
+};
+export const FILE_UPDATE_SCHEMA = {
+    additionalProperties: false,
+    anyOf: [{ required: ['directory'] }, { required: ['name'] }],
+    properties: { directory: { type: 'string' }, name: { type: 'string' } },
+    type: 'object',
+};
+export const getFileKey = ({ directory, name }) => [directory, name].filter(Boolean).join('/');
+const WINDOWS_RESERVED_NAME = /^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\..*)?$/i;
+const hasControlCharacter = (value) => [...value].some((character) => {
+    const code = character.charCodeAt(0);
+    return code <= 31 || code === 127;
+});
+export const validateName = (value, source) => {
+    if (typeof value !== 'string' ||
+        value === '' ||
+        value === '.' ||
+        value === '..' ||
+        value.endsWith('.') ||
+        value.endsWith(' ') ||
+        /[<>:"/\\|?*]/.test(value) ||
+        hasControlCharacter(value) ||
+        WINDOWS_RESERVED_NAME.test(value)) {
+        throw createHttpError(400, `${source} должен содержать безопасное имя файла`);
+    }
+    return value;
+};
+export const validateDirectory = (value, source) => {
+    if (typeof value !== 'string') {
+        throw createHttpError(400, `${source} должен содержать безопасный относительный путь`);
+    }
+    if (value === '') {
+        return value;
+    }
+    const parts = value.split('/');
+    if (value.startsWith('/') || value.endsWith('/') || value.includes('\\') || value.includes('\0') || parts.some((part) => part === '' || part === '.' || part === '..')) {
+        throw createHttpError(400, `${source} должен содержать безопасный относительный путь`);
+    }
+    return value;
+};
+export const normalizeMimeType = (value, source = 'Заголовок Content-Type') => {
+    const mimeType = typeof value === 'string' ? value.split(';', 1)[0].trim().toLowerCase() : '';
+    if (mimeType === '' || !MIME_TYPE_PATTERN.test(mimeType)) {
+        throw createHttpError(400, `${source} должен содержать корректный MIME-тип`);
+    }
+    return mimeType;
+};
+export const normalizeStoredFileMetadata = (value, source) => {
+    if (!isObject(value)) {
+        throw new Error(`${source} должна содержать JSON-объект`);
+    }
+    try {
+        return {
+            directory: validateDirectory(value.directory ?? '', `${source}.directory`),
+            mimeType: normalizeMimeType(value.mimeType, `${source}.mimeType`),
+            name: validateName(value.name, `${source}.name`),
+        };
+    }
+    catch (error) {
+        throw new Error(error instanceof Error ? error.message : String(error), { cause: error });
+    }
+};
+export const getPathLocation = (path) => {
+    const normalizedPath = validateDirectory(path, 'Путь файла');
+    const parts = normalizedPath.split('/');
+    const name = validateName(parts.pop(), 'Путь файла');
+    return { directory: parts.join('/'), name };
+};
+const encodeFilePath = (file) => getFileKey(file).split('/').map(encodeURIComponent).join('/');
+export const createFileMetadata = (file) => {
+    const path = encodeFilePath(file);
+    return {
+        ...file,
+        downloadUrl: `${FILE_ROUTES.download}/${path}`,
+        metadataUrl: `${FILE_ROUTES.metadata}/${path}`,
+        url: `${FILE_ROUTES.storage}/${path}`,
+    };
+};
+export const getDownloadName = (name) => encodeURIComponent(basename(name)).replaceAll("'", '%27');
+//# sourceMappingURL=contract.js.map

package/dist/src/files/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../../src/files/contract.ts"],"names":[],"mappings":"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"}

package/dist/src/files/disk-store.d.ts

@@ -0,0 +1,5 @@
+import { type FileStore } from './contract.js';
+export declare const createDiskFileStore: ({ directory: sourceDirectoryPath, metadata: sourceMetadataPath }: {
+    directory: string;
+    metadata: string;
+}) => Promise<FileStore>;

package/dist/src/files/disk-store.js

@@ -0,0 +1,313 @@
+import { randomBytes } from 'node:crypto';
+import { createWriteStream } from 'node:fs';
+import { access, lstat, mkdir, open, readFile, realpath, rename, rm, stat, writeFile } from 'node:fs/promises';
+import { dirname, isAbsolute, relative, resolve, sep } from 'node:path';
+import { Transform } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import { createHttpError, createSerialQueue, isSystemError } from '../utils.js';
+import { getFileKey, normalizeStoredFileMetadata } from './contract.js';
+const createSizeLimiter = (maxFileSize, onSize) => {
+    let size = 0;
+    return new Transform({
+        transform(chunk, _encoding, callback) {
+            size += chunk.length;
+            if (size > maxFileSize) {
+                callback(createHttpError(413, `Размер файла не должен превышать ${maxFileSize} байт`));
+                return;
+            }
+            onSize(size);
+            callback(null, chunk);
+        },
+    });
+};
+const pathExists = async (path) => {
+    try {
+        await access(path);
+        return true;
+    }
+    catch (error) {
+        if (isSystemError(error) && error.code === 'ENOENT') {
+            return false;
+        }
+        throw error;
+    }
+};
+const isPathInside = (rootPath, targetPath) => {
+    const relativePath = relative(rootPath, targetPath);
+    return relativePath === '' || (relativePath !== '..' && !relativePath.startsWith(`..${sep}`) && !isAbsolute(relativePath));
+};
+const readMetadata = async (metadataPath) => {
+    let source;
+    try {
+        source = JSON.parse(await readFile(metadataPath, 'utf8'));
+    }
+    catch (error) {
+        if (isSystemError(error) && error.code === 'ENOENT') {
+            return new Map();
+        }
+        throw error;
+    }
+    if (!Array.isArray(source)) {
+        throw new Error(`Файл метаданных ${metadataPath} должен содержать JSON-массив`);
+    }
+    const files = new Map();
+    source.forEach((value, index) => {
+        const file = normalizeStoredFileMetadata(value, `Запись ${index} в файле метаданных ${metadataPath}`);
+        const path = getFileKey(file);
+        if (files.has(path)) {
+            throw new Error(`Файл метаданных ${metadataPath} содержит повторяющийся путь «${path}»`);
+        }
+        files.set(path, file);
+    });
+    return files;
+};
+const writeMetadata = async (metadataPath, files) => {
+    const temporaryPath = `${metadataPath}.${randomBytes(6).toString('hex')}.tmp`;
+    try {
+        await writeFile(temporaryPath, JSON.stringify([...files.values()], null, 2), { encoding: 'utf8', flag: 'wx' });
+        await rename(temporaryPath, metadataPath);
+    }
+    catch (error) {
+        await rm(temporaryPath, { force: true }).catch(() => undefined);
+        throw error;
+    }
+};
+const getFileSize = async (path) => {
+    try {
+        return (await stat(path)).size;
+    }
+    catch (error) {
+        if (isSystemError(error) && error.code === 'ENOENT') {
+            throw createHttpError(404, 'Файл не найден');
+        }
+        throw error;
+    }
+};
+export const createDiskFileStore = async ({ directory: sourceDirectoryPath, metadata: sourceMetadataPath }) => {
+    const directoryPath = resolve(sourceDirectoryPath);
+    const metadataPath = resolve(sourceMetadataPath);
+    const stagingPath = resolve(directoryPath, '.deep-json-server');
+    const schedule = createSerialQueue();
+    const pendingCleanup = new Set();
+    await Promise.all([mkdir(directoryPath, { recursive: true }), mkdir(dirname(metadataPath), { recursive: true }), mkdir(stagingPath, { recursive: true })]);
+    const realDirectoryPath = await realpath(directoryPath);
+    let files = await readMetadata(metadataPath);
+    const commitMetadata = async (nextFiles, rollback, rollbackMessage) => {
+        try {
+            await writeMetadata(metadataPath, nextFiles);
+        }
+        catch (error) {
+            try {
+                await rollback();
+            }
+            catch (rollbackError) {
+                throw new AggregateError([error, rollbackError], rollbackMessage);
+            }
+            throw error;
+        }
+        files = nextFiles;
+    };
+    const assertContained = (path) => {
+        if (!isPathInside(realDirectoryPath, path)) {
+            throw createHttpError(400, 'Путь файла выходит за пределы директории хранения');
+        }
+    };
+    const resolveFilePath = (path) => {
+        const filePath = resolve(directoryPath, path);
+        if (filePath === directoryPath || !isPathInside(directoryPath, filePath) || filePath === metadataPath || isPathInside(stagingPath, filePath)) {
+            throw createHttpError(400, 'Путь файла выходит за пределы директории хранения');
+        }
+        return filePath;
+    };
+    const assertNoSymlinks = async (targetPath) => {
+        const relativePath = relative(directoryPath, targetPath);
+        const parts = relativePath === '' ? [] : relativePath.split(sep);
+        let currentPath = directoryPath;
+        for (const part of parts) {
+            currentPath = resolve(currentPath, part);
+            try {
+                if ((await lstat(currentPath)).isSymbolicLink()) {
+                    throw createHttpError(400, 'Путь файла не должен содержать символические ссылки');
+                }
+            }
+            catch (error) {
+                if (!isSystemError(error) || error.code !== 'ENOENT') {
+                    throw error;
+                }
+            }
+        }
+    };
+    const prepareTargetPath = async (path) => {
+        const filePath = resolveFilePath(path);
+        const targetDirectory = dirname(filePath);
+        const parts = relative(directoryPath, targetDirectory).split(sep).filter(Boolean);
+        let currentPath = directoryPath;
+        for (const part of parts) {
+            currentPath = resolve(currentPath, part);
+            try {
+                await mkdir(currentPath);
+            }
+            catch (error) {
+                if (!isSystemError(error) || error.code !== 'EEXIST') {
+                    throw error;
+                }
+            }
+            const currentStats = await lstat(currentPath);
+            if (currentStats.isSymbolicLink() || !currentStats.isDirectory()) {
+                throw createHttpError(400, 'Путь файла должен содержать только обычные директории');
+            }
+            assertContained(await realpath(currentPath));
+        }
+        if (await pathExists(filePath)) {
+            await assertNoSymlinks(filePath);
+            assertContained(await realpath(filePath));
+        }
+        return filePath;
+    };
+    const resolveExistingPath = async (path) => {
+        const filePath = resolveFilePath(path);
+        try {
+            await assertNoSymlinks(filePath);
+            assertContained(await realpath(filePath));
+        }
+        catch (error) {
+            if (isSystemError(error) && error.code === 'ENOENT') {
+                throw createHttpError(404, 'Файл не найден');
+            }
+            throw error;
+        }
+        return filePath;
+    };
+    const cleanupLater = async (path) => {
+        try {
+            await rm(path, { force: true });
+            pendingCleanup.delete(path);
+        }
+        catch {
+            pendingCleanup.add(path);
+        }
+    };
+    const flushCleanup = async () => {
+        await Promise.all([...pendingCleanup].map(cleanupLater));
+    };
+    const findFile = (path) => {
+        const file = files.get(path);
+        if (file == null) {
+            throw createHttpError(404, 'Файл не найден');
+        }
+        return file;
+    };
+    const metadata = async (path) => {
+        const file = findFile(path);
+        const filePath = await resolveExistingPath(path);
+        return { ...file, size: await getFileSize(filePath) };
+    };
+    const get = async (path) => {
+        const file = findFile(path);
+        const filePath = await resolveExistingPath(path);
+        const handle = await open(filePath, 'r');
+        try {
+            const size = (await handle.stat()).size;
+            return { file: { ...file, size }, stream: handle.createReadStream() };
+        }
+        catch (error) {
+            await handle.close();
+            throw error;
+        }
+    };
+    const upload = async ({ directory, maxFileSize, mimeType, name, override, stream }) => {
+        const storedFile = { directory, mimeType, name };
+        const key = getFileKey(storedFile);
+        if (files.has(key) && !override) {
+            throw createHttpError(409, 'Файл уже существует');
+        }
+        const stagedPath = resolve(stagingPath, `${randomBytes(12).toString('hex')}.upload`);
+        let size = 0;
+        try {
+            await pipeline(stream, createSizeLimiter(maxFileSize, (value) => {
+                size = value;
+            }), createWriteStream(stagedPath, { flags: 'wx' }));
+            return await schedule(async () => {
+                await flushCleanup();
+                const path = await prepareTargetPath(key);
+                const existsOnDisk = await pathExists(path);
+                const exists = files.has(key) || existsOnDisk;
+                if (exists && !override) {
+                    throw createHttpError(409, 'Файл уже существует');
+                }
+                const backupPath = `${path}.${randomBytes(6).toString('hex')}.backup`;
+                let backedUp = false;
+                let installed = false;
+                let committed = false;
+                try {
+                    if (existsOnDisk) {
+                        await rename(path, backupPath);
+                        backedUp = true;
+                    }
+                    await rename(stagedPath, path);
+                    installed = true;
+                    const nextFiles = new Map(files);
+                    nextFiles.set(key, storedFile);
+                    await writeMetadata(metadataPath, nextFiles);
+                    files = nextFiles;
+                    committed = true;
+                    return { created: !exists, file: { ...storedFile, size } };
+                }
+                catch (error) {
+                    const rollbackErrors = [];
+                    if (installed) {
+                        await rm(path, { force: true }).catch((rollbackError) => rollbackErrors.push(rollbackError));
+                    }
+                    if (backedUp) {
+                        await rename(backupPath, path).catch((rollbackError) => rollbackErrors.push(rollbackError));
+                    }
+                    if (rollbackErrors.length > 0) {
+                        throw new AggregateError([error, ...rollbackErrors], 'Не удалось сохранить файл и полностью откатить операцию');
+                    }
+                    throw error;
+                }
+                finally {
+                    if (committed && backedUp) {
+                        await cleanupLater(backupPath);
+                    }
+                }
+            });
+        }
+        finally {
+            await cleanupLater(stagedPath);
+        }
+    };
+    const update = (sourcePath, updates) => schedule(async () => {
+        await flushCleanup();
+        const file = findFile(sourcePath);
+        const updatedFile = { ...file, ...updates };
+        const targetPath = getFileKey(updatedFile);
+        const sourceFilePath = await resolveExistingPath(sourcePath);
+        if (sourcePath === targetPath) {
+            return { ...file, size: await getFileSize(sourceFilePath) };
+        }
+        const targetFilePath = await prepareTargetPath(targetPath);
+        if (files.has(targetPath) || (await pathExists(targetFilePath))) {
+            throw createHttpError(409, 'Файл с таким путём уже существует');
+        }
+        await rename(sourceFilePath, targetFilePath);
+        const nextFiles = new Map(files);
+        nextFiles.delete(sourcePath);
+        nextFiles.set(targetPath, updatedFile);
+        await commitMetadata(nextFiles, () => rename(targetFilePath, sourceFilePath), 'Не удалось обновить файл и откатить перемещение');
+        return { ...updatedFile, size: await getFileSize(targetFilePath) };
+    });
+    const remove = (path) => schedule(async () => {
+        await flushCleanup();
+        findFile(path);
+        const filePath = await resolveExistingPath(path);
+        const temporaryPath = `${filePath}.${randomBytes(6).toString('hex')}.delete`;
+        await rename(filePath, temporaryPath);
+        const nextFiles = new Map(files);
+        nextFiles.delete(path);
+        await commitMetadata(nextFiles, () => rename(temporaryPath, filePath), 'Не удалось удалить файл и откатить операцию');
+        await cleanupLater(temporaryPath);
+    });
+    return { get, metadata, remove, update, upload };
+};
+//# sourceMappingURL=disk-store.js.map