@kollors/deep-json-server 1.0.0-alpha.1 → 1.0.0-alpha.11

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

@@ -1,5 +1,18 @@
+import type { Storage } from '../core/storage.js';
+export interface MemoryFile {
+    content: Uint8Array;
+    directory?: string;
+    mimeType: string;
+    name: string;
+}
+export type FilesConfig<S extends Storage = Storage> = S extends 'file' ? {
+    source: string;
+    metadata?: string;
+} : {
+    source: MemoryFile[];
+    metadata?: never;
+};
 import type { Readable } from 'node:stream';
-import type { OpenapiSchema } from '../types.js';
 export interface StoredFileMetadata {
     directory: string;
     mimeType: string;
@@ -8,11 +21,6 @@ export interface StoredFileMetadata {
 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;
@@ -35,33 +43,27 @@ export interface FileStore {
         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;
+/** Соединяет непустой каталог и имя через косую черту, не проверяя безопасность пути.
+ * @example getFileKey({ directory: 'photos', name: 'a.jpg' }) → 'photos/a.jpg'.
+ */
 export declare const getFileKey: ({ directory, name }: Pick<StoredFileMetadata, 'directory' | 'name'>) => string;
+/** Проверяет безопасное имя файла, включая зарезервированные имена Windows.
+ * @example validateName('a.txt', 'name') → 'a.txt'; validateName('../a', 'name') → ошибка.
+ */
 export declare const validateName: (value: unknown, source: string) => string;
+/** Проверяет относительный путь с разделителем /; пустой путь обозначает корень.
+ * @example validateDirectory('photos/2026', 'path') → 'photos/2026'; '../photos' → ошибка.
+ */
 export declare const validateDirectory: (value: unknown, source: string) => string;
+/** Удаляет параметры MIME-типа, приводит его к нижнему регистру и проверяет формат.
+ * @example normalizeMimeType('Text/Plain; charset=utf-8') → 'text/plain'.
+ */
 export declare const normalizeMimeType: (value: unknown, source?: string) => string;
+/** Проверяет метаданные и возвращает объект из каталога, имени и MIME-типа.
+ * @example { name: 'a.txt', mimeType: 'TEXT/PLAIN' } → { directory: '', name: 'a.txt', mimeType: 'text/plain' }.
+ */
 export declare const normalizeStoredFileMetadata: (value: unknown, source: string) => StoredFileMetadata;
+/** Разделяет проверенный относительный путь на каталог и имя файла.
+ * @example getPathLocation('photos/a.jpg') → { directory: 'photos', name: 'a.jpg' }.
+ */
 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

@@ -1,42 +1,22 @@
-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;
+import { errorMessage } from '../core/utils.js';
+import { domainError } from '../core/errors.js';
+import { isObject } from '../core/utils.js';
 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',
-};
+/** Соединяет непустой каталог и имя через косую черту, не проверяя безопасность пути.
+ * @example getFileKey({ directory: 'photos', name: 'a.jpg' }) → 'photos/a.jpg'.
+ */
 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;
+/** Ищет управляющие символы ASCII с кодами 0–31 или 127.
+ * @example hasControlCharacter('abc') → false; строка с переводом строки → true.
+ */
 const hasControlCharacter = (value) => [...value].some((character) => {
     const code = character.charCodeAt(0);
     return code <= 31 || code === 127;
 });
+/** Проверяет безопасное имя файла, включая зарезервированные имена Windows.
+ * @example validateName('a.txt', 'name') → 'a.txt'; validateName('../a', 'name') → ошибка.
+ */
 export const validateName = (value, source) => {
     if (typeof value !== 'string' ||
         value === '' ||
@@ -47,30 +27,39 @@ export const validateName = (value, source) => {
         /[<>:"/\\|?*]/.test(value) ||
         hasControlCharacter(value) ||
         WINDOWS_RESERVED_NAME.test(value)) {
-        throw createHttpError(400, `${source} должен содержать безопасное имя файла`);
+        throw domainError('INVALID_INPUT', `${source} должен содержать безопасное имя файла`);
     }
     return value;
 };
+/** Проверяет относительный путь с разделителем /; пустой путь обозначает корень.
+ * @example validateDirectory('photos/2026', 'path') → 'photos/2026'; '../photos' → ошибка.
+ */
 export const validateDirectory = (value, source) => {
     if (typeof value !== 'string') {
-        throw createHttpError(400, `${source} должен содержать безопасный относительный путь`);
+        throw domainError('INVALID_INPUT', `${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} должен содержать безопасный относительный путь`);
+        throw domainError('INVALID_INPUT', `${source} должен содержать безопасный относительный путь`);
     }
     return value;
 };
+/** Удаляет параметры MIME-типа, приводит его к нижнему регистру и проверяет формат.
+ * @example normalizeMimeType('Text/Plain; charset=utf-8') → 'text/plain'.
+ */
 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-тип`);
+        throw domainError('INVALID_INPUT', `${source} должен содержать корректный MIME-тип`);
     }
     return mimeType;
 };
+/** Проверяет метаданные и возвращает объект из каталога, имени и MIME-типа.
+ * @example { name: 'a.txt', mimeType: 'TEXT/PLAIN' } → { directory: '', name: 'a.txt', mimeType: 'text/plain' }.
+ */
 export const normalizeStoredFileMetadata = (value, source) => {
     if (!isObject(value)) {
         throw new Error(`${source} должна содержать JSON-объект`);
@@ -83,24 +72,16 @@ export const normalizeStoredFileMetadata = (value, source) => {
         };
     }
     catch (error) {
-        throw new Error(error instanceof Error ? error.message : String(error), { cause: error });
+        throw new Error(errorMessage(error), { cause: error });
     }
 };
+/** Разделяет проверенный относительный путь на каталог и имя файла.
+ * @example getPathLocation('photos/a.jpg') → { directory: 'photos', name: 'a.jpg' }.
+ */
 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

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

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

@@ -0,0 +1,9 @@
+import { type StoredFileMetadata } from './contract.js';
+/** Читает массив метаданных и индексирует его по относительному пути файла.
+ * @example Отсутствующий файл → пустой Map; две одинаковые записи → ошибка.
+ */
+export declare function readDiskMetadata(metadataPath: string): Promise<Map<string, StoredFileMetadata>>;
+/** Атомарно заменяет файл метаданных через соседний временный файл.
+ * @example Map с одной записью → JSON-массив в metadataPath.
+ */
+export declare function writeDiskMetadata(metadataPath: string, files: Map<string, StoredFileMetadata>): Promise<void>;

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

@@ -0,0 +1,44 @@
+import { randomBytes } from 'node:crypto';
+import { readFile, rename, rm, writeFile } from 'node:fs/promises';
+import { isSystemError } from '../core/utils.js';
+import { getFileKey, normalizeStoredFileMetadata } from './contract.js';
+/** Читает массив метаданных и индексирует его по относительному пути файла.
+ * @example Отсутствующий файл → пустой Map; две одинаковые записи → ошибка.
+ */
+export async function readDiskMetadata(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;
+}
+/** Атомарно заменяет файл метаданных через соседний временный файл.
+ * @example Map с одной записью → JSON-массив в metadataPath.
+ */
+export async function writeDiskMetadata(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;
+    }
+}
+//# sourceMappingURL=disk-metadata.js.map

package/dist/src/files/disk-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disk-metadata.js","sourceRoot":"","sources":["../../../src/files/disk-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,2BAA2B,EAA2B,MAAM,eAAe,CAAC;AAEjG;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,YAAoB;IACzD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,GAAG,EAAE,CAAC;QACtE,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,YAAY,+BAA+B,CAAC,CAAC;IAC5G,MAAM,KAAK,GAAG,IAAI,GAAG,EAA8B,CAAC;IACpD,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG,2BAA2B,CAAC,KAAK,EAAE,UAAU,KAAK,uBAAuB,YAAY,EAAE,CAAC,CAAC;QACtG,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,YAAY,iCAAiC,IAAI,GAAG,CAAC,CAAC;QAC9G,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,YAAoB,EAAE,KAAsC;IAClG,MAAM,aAAa,GAAG,GAAG,YAAY,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;IAC9E,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/G,MAAM,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,EAAE,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAChE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,15 @@
+declare const pathExists: (path: string) => Promise<boolean>;
+/** Готовит и проверяет пути дискового хранилища, не выполняя операций с содержимым файлов.
+ * @example resolveExistingPath('images/a.png') → абсолютный путь внутри directory.
+ */
+export declare function createDiskPaths({ directory, metadata, staging, protectedPaths }: {
+    directory: string;
+    metadata: string;
+    staging: string;
+    protectedPaths: Set<string>;
+}): Promise<{
+    pathExists: typeof pathExists;
+    prepareTargetPath: (path: string) => Promise<string>;
+    resolveExistingPath: (path: string) => Promise<string>;
+}>;
+export {};

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

@@ -0,0 +1,100 @@
+import { access, lstat, mkdir, realpath } from 'node:fs/promises';
+import { dirname, isAbsolute, relative, resolve, sep } from 'node:path';
+import { domainError } from '../core/errors.js';
+import { isSystemError } from '../core/utils.js';
+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 assertRegularFile = (stats) => {
+    if (!stats.isFile())
+        throw domainError('INVALID_INPUT', 'Путь должен указывать на обычный файл');
+};
+/** Готовит и проверяет пути дискового хранилища, не выполняя операций с содержимым файлов.
+ * @example resolveExistingPath('images/a.png') → абсолютный путь внутри directory.
+ */
+export async function createDiskPaths({ directory, metadata, staging, protectedPaths }) {
+    const realDirectory = await realpath(directory);
+    const assertContained = (path) => {
+        if (!isPathInside(realDirectory, path))
+            throw domainError('INVALID_INPUT', 'Путь файла выходит за пределы директории хранения');
+    };
+    const resolveFilePath = (path) => {
+        const filePath = resolve(directory, path);
+        const canonical = resolve(realDirectory, relative(directory, filePath));
+        if (protectedPaths.has(canonical))
+            throw domainError('INVALID_INPUT', 'Path is reserved for a server input file');
+        if (filePath === directory || !isPathInside(directory, filePath) || filePath === metadata || isPathInside(staging, filePath))
+            throw domainError('INVALID_INPUT', 'Путь файла выходит за пределы директории хранения');
+        return filePath;
+    };
+    const assertNoSymlinks = async (targetPath) => {
+        const relativePath = relative(directory, targetPath);
+        const parts = relativePath === '' ? [] : relativePath.split(sep);
+        let currentPath = directory;
+        for (const part of parts) {
+            currentPath = resolve(currentPath, part);
+            try {
+                if ((await lstat(currentPath)).isSymbolicLink())
+                    throw domainError('INVALID_INPUT', 'Путь файла не должен содержать символические ссылки');
+            }
+            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(directory, targetDirectory).split(sep).filter(Boolean);
+        let currentPath = directory;
+        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 domainError('INVALID_INPUT', 'Путь файла должен содержать только обычные директории');
+            assertContained(await realpath(currentPath));
+        }
+        if (await pathExists(filePath)) {
+            await assertNoSymlinks(filePath);
+            assertContained(await realpath(filePath));
+            assertRegularFile(await lstat(filePath));
+        }
+        return filePath;
+    };
+    const resolveExistingPath = async (path) => {
+        const filePath = resolveFilePath(path);
+        try {
+            await assertNoSymlinks(filePath);
+            assertContained(await realpath(filePath));
+            assertRegularFile(await lstat(filePath));
+        }
+        catch (error) {
+            if (isSystemError(error) && error.code === 'ENOENT')
+                throw domainError('NOT_FOUND', 'Файл не найден');
+            throw error;
+        }
+        return filePath;
+    };
+    return { pathExists, prepareTargetPath, resolveExistingPath };
+}
+//# sourceMappingURL=disk-paths.js.map

package/dist/src/files/disk-paths.js.map

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

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

@@ -1,5 +1,9 @@
 import { type FileStore } from './contract.js';
-export declare const createDiskFileStore: ({ directory: sourceDirectoryPath, metadata: sourceMetadataPath }: {
+/** Открывает дисковое хранилище с проверками путей, защитой входных файлов и последовательными изменениями.
+ * @example Каталог и файл метаданных → Promise<FileStore>; операции сохраняют байты и метаданные на диске.
+ */
+export declare const createDiskFileStore: ({ directory: sourceDirectoryPath, metadata: sourceMetadataPath, protectedPaths, }: {
     directory: string;
     metadata: string;
+    protectedPaths?: string[];
 }) => Promise<FileStore>;