shennian 0.2.89 → 0.2.90

package/dist/src/session/handlers/fs.js

@@ -1,783 +1 @@
-// @arch docs/architecture/cli/daemon.md#会话管理
-// @test src/__tests__/session-manager.test.ts
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { convertMarkdownToPdf, defaultPdfOutputPath, MarkdownPdfBrowserMissingError, } from '../../tools/markdown-to-pdf.js';
-import { createZipArchive } from '../archive-zip.js';
-import { BinaryTextPreviewError, decodeTextBufferAuto, isAutoTextEncoding, } from '../../fs/text-decoder.js';
-const FILE_SYSTEM_ROOTS_PATH = '__roots__';
-const MAX_FOLDER_UPLOAD_FILES = 2000;
-const MAX_FOLDER_UPLOAD_TOTAL_SIZE = 1024 * 1024 * 1024;
-const MAX_ARCHIVE_FILES = 5000;
-const MAX_ARCHIVE_TOTAL_SIZE = 1024 * 1024 * 1024;
-function isWindowsAbsolutePath(pathValue) {
-    return /^[A-Za-z]:([\\/]|$)/.test(pathValue) || /^\\\\[^\\]+\\[^\\]+/.test(pathValue);
-}
-function pathApiForPath(pathValue) {
-    return isWindowsAbsolutePath(pathValue) ? path.win32 : path.posix;
-}
-function makeFsEntry(entryPath) {
-    const stat = fs.statSync(entryPath);
-    const api = pathApiForPath(entryPath);
-    return {
-        name: api.basename(entryPath),
-        path: entryPath,
-        isDir: stat.isDirectory(),
-        size: stat.isFile() ? stat.size : undefined,
-        modifiedAt: stat.mtimeMs,
-    };
-}
-function listFileSystemRoots() {
-    if (os.platform() === 'win32') {
-        const entries = [];
-        for (let code = 65; code <= 90; code += 1) {
-            const drive = `${String.fromCharCode(code)}:\\`;
-            if (fs.existsSync(drive))
-                entries.push({ name: drive, path: drive, isDir: true });
-        }
-        return entries;
-    }
-    return [{ name: '/', path: '/', isDir: true }];
-}
-function fsErrorMessage(err, fallbackPath) {
-    const code = typeof err === 'object' && err && 'code' in err
-        ? String(err.code)
-        : '';
-    if (code === 'ENOENT')
-        return `Directory not found: ${fallbackPath}`;
-    if (code === 'EACCES' || code === 'EPERM')
-        return `Permission denied: ${fallbackPath}`;
-    return err instanceof Error ? err.message : String(err);
-}
-function isSafeRelativeUploadPath(relativePath) {
-    if (!relativePath || relativePath === '.' || relativePath.trim() !== relativePath)
-        return false;
-    if (path.posix.isAbsolute(relativePath) || path.win32.isAbsolute(relativePath))
-        return false;
-    const normalized = relativePath.replace(/\\/g, '/');
-    if (normalized !== relativePath)
-        return false;
-    return normalized
-        .split('/')
-        .every((segment) => segment && segment !== '.' && segment !== '..' && !hasControlChar(segment));
-}
-function isSafeRenameName(name) {
-    const trimmed = name.trim();
-    if (!trimmed || trimmed !== name)
-        return false;
-    if (name === '.' || name === '..')
-        return false;
-    if (hasControlChar(name) || /[\\/:]/.test(name))
-        return false;
-    if (/[<>|"?*]/.test(name))
-        return false;
-    if (/[. ]$/.test(name))
-        return false;
-    const upper = name.split('.')[0]?.toUpperCase();
-    if (upper && /^(CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])$/.test(upper))
-        return false;
-    return true;
-}
-function hasControlChar(value) {
-    return Array.from(value).some((char) => {
-        const code = char.charCodeAt(0);
-        return code >= 0x00 && code <= 0x1f;
-    });
-}
-function decodeManifest(value) {
-    if (!Array.isArray(value))
-        return [];
-    return value.map((item) => ({
-        relativePath: String(item.relativePath || ''),
-        size: Number(item.size || 0),
-        mimeType: item.mimeType,
-        modifiedAt: item.modifiedAt,
-    }));
-}
-export async function handleFsLs(runtime, req) {
-    const requestedPath = req.params.path || os.homedir();
-    const rootPath = req.params.rootPath || requestedPath;
-    if (requestedPath === FILE_SYSTEM_ROOTS_PATH) {
-        runtime.client.sendRes({
-            type: 'res',
-            id: req.id,
-            ok: true,
-            payload: { path: FILE_SYSTEM_ROOTS_PATH, entries: listFileSystemRoots() },
-        });
-        return;
-    }
-    const resolved = runtime.resolveAuthorizedPath(requestedPath, rootPath);
-    if (!resolved.ok) {
-        runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: resolved.error });
-        return;
-    }
-    const dirPath = resolved.path;
-    try {
-        const raw = fs.readdirSync(dirPath, { withFileTypes: true });
-        const joinPath = isWindowsAbsolutePath(dirPath) ? path.win32.join : path.join;
-        const entries = raw
-            .map((entry) => ({
-            name: entry.name,
-            path: joinPath(dirPath, entry.name),
-            isDir: entry.isDirectory(),
-        }))
-            .sort((left, right) => {
-            if (left.isDir !== right.isDir)
-                return left.isDir ? -1 : 1;
-            return left.name.localeCompare(right.name);
-        });
-        runtime.client.sendRes({
-            type: 'res',
-            id: req.id,
-            ok: true,
-            payload: { path: dirPath, entries },
-        });
-    }
-    catch (err) {
-        runtime.client.sendRes({
-            type: 'res',
-            id: req.id,
-            ok: false,
-            error: fsErrorMessage(err, dirPath),
-        });
-    }
-}
-export async function handleFsRead(runtime, req) {
-    const requestedPath = req.params.path;
-    const rootPath = req.params.rootPath || requestedPath;
-    const resolved = runtime.resolveAuthorizedPath(requestedPath, rootPath);
-    if (!resolved.ok) {
-        runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: resolved.error });
-        return;
-    }
-    const filePath = resolved.path;
-    const requestedEncoding = req.params.encoding;
-    const encoding = typeof requestedEncoding === 'string' ? requestedEncoding : 'utf8';
-    const offset = req.params.offset;
-    const length = req.params.length;
-    try {
-        const stat = fs.statSync(filePath);
-        if (!stat.isFile()) {
-            runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: 'Not a file' });
-            return;
-        }
-        if (offset != null && length != null) {
-            const readLen = Math.min(length, Math.max(0, stat.size - offset));
-            if (readLen <= 0) {
-                runtime.client.sendRes({
-                    type: 'res',
-                    id: req.id,
-                    ok: true,
-                    payload: { data: '', offset, length: 0, totalSize: stat.size, path: filePath },
-                });
-                return;
-            }
-            const fd = fs.openSync(filePath, 'r');
-            try {
-                const buffer = Buffer.alloc(readLen);
-                const bytesRead = fs.readSync(fd, buffer, 0, readLen, offset);
-                runtime.client.sendRes({
-                    type: 'res',
-                    id: req.id,
-                    ok: true,
-                    payload: {
-                        data: buffer.subarray(0, bytesRead).toString('base64'),
-                        offset,
-                        length: bytesRead,
-                        totalSize: stat.size,
-                        path: filePath,
-                    },
-                });
-            }
-            finally {
-                fs.closeSync(fd);
-            }
-            return;
-        }
-        const maxSize = req.params.maxSize || (encoding === 'base64' ? 5 * 1024 * 1024 : 512 * 1024);
-        if (stat.size > maxSize) {
-            runtime.client.sendRes({
-                type: 'res',
-                id: req.id,
-                ok: false,
-                error: `File too large: ${stat.size} bytes (max ${maxSize})`,
-                payload: { size: stat.size, path: filePath },
-            });
-            return;
-        }
-        if (encoding === 'base64') {
-            const buffer = fs.readFileSync(filePath);
-            runtime.client.sendRes({
-                type: 'res',
-                id: req.id,
-                ok: true,
-                payload: { data: buffer.toString('base64'), path: filePath, size: stat.size },
-            });
-            return;
-        }
-        if (isAutoTextEncoding(encoding)) {
-            const buffer = fs.readFileSync(filePath);
-            const decoded = decodeTextBufferAuto(buffer);
-            runtime.client.sendRes({
-                type: 'res',
-                id: req.id,
-                ok: true,
-                payload: {
-                    content: decoded.content,
-                    path: filePath,
-                    size: stat.size,
-                    encoding: decoded.encoding,
-                    encodingFallback: decoded.fallback,
-                },
-            });
-            return;
-        }
-        const content = fs.readFileSync(filePath, 'utf-8');
-        runtime.client.sendRes({
-            type: 'res',
-            id: req.id,
-            ok: true,
-            payload: { content, path: filePath, size: stat.size },
-        });
-    }
-    catch (err) {
-        runtime.client.sendRes({
-            type: 'res',
-            id: req.id,
-            ok: false,
-            error: err instanceof BinaryTextPreviewError ? err.message : String(err),
-        });
-    }
-}
-export async function handleFsWrite(runtime, req) {
-    const requestedPath = req.params.path;
-    const content = req.params.content;
-    const rootPath = req.params.rootPath || requestedPath;
-    if (!requestedPath || typeof content !== 'string') {
-        runtime.client.sendRes({
-            type: 'res',
-            id: req.id,
-            ok: false,
-            error: 'path and content are required',
-        });
-        return;
-    }
-    const resolved = runtime.resolveAuthorizedPath(requestedPath, rootPath);
-    if (!resolved.ok) {
-        runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: resolved.error });
-        return;
-    }
-    try {
-        const existing = fs.existsSync(resolved.path) ? fs.statSync(resolved.path) : null;
-        if (existing && !existing.isFile()) {
-            runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: 'Not a file' });
-            return;
-        }
-        fs.writeFileSync(resolved.path, content, 'utf-8');
-        const stat = fs.statSync(resolved.path);
-        runtime.client.sendRes({
-            type: 'res',
-            id: req.id,
-            ok: true,
-            payload: { path: resolved.path, size: stat.size, modifiedAt: stat.mtimeMs },
-        });
-    }
-    catch (err) {
-        runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: String(err) });
-    }
-}
-export async function handleFsRename(runtime, req) {
-    const requestedPath = req.params.path;
-    const newName = req.params.newName;
-    if (!requestedPath || !newName) {
-        runtime.client.sendRes({
-            type: 'res',
-            id: req.id,
-            ok: false,
-            error: 'path and newName are required',
-        });
-        return;
-    }
-    if (!isSafeRenameName(newName)) {
-        runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: 'Invalid newName' });
-        return;
-    }
-    const api = pathApiForPath(requestedPath);
-    const rootPath = req.params.rootPath || api.dirname(requestedPath);
-    const resolved = runtime.resolveAuthorizedPath(requestedPath, rootPath);
-    if (!resolved.ok) {
-        runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: resolved.error });
-        return;
-    }
-    try {
-        const api = pathApiForPath(resolved.path);
-        const newPath = api.join(api.dirname(resolved.path), newName);
-        const checkedNewPath = runtime.resolveAuthorizedPath(newPath, rootPath);
-        if (!checkedNewPath.ok) {
-            runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: checkedNewPath.error });
-            return;
-        }
-        if (fs.existsSync(checkedNewPath.path)) {
-            runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: 'Target already exists' });
-            return;
-        }
-        fs.renameSync(resolved.path, checkedNewPath.path);
-        runtime.client.sendRes({
-            type: 'res',
-            id: req.id,
-            ok: true,
-            payload: {
-                oldPath: resolved.path,
-                newPath: checkedNewPath.path,
-                entry: makeFsEntry(checkedNewPath.path),
-            },
-        });
-    }
-    catch (err) {
-        runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: String(err) });
-    }
-}
-export async function handleFsExportMarkdownPdf(runtime, req) {
-    const requestedPath = req.params.path;
-    const rootPath = req.params.rootPath || path.dirname(requestedPath || '.');
-    const title = typeof req.params.title === 'string' ? req.params.title : undefined;
-    if (!requestedPath) {
-        runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: 'path is required' });
-        return;
-    }
-    const resolved = runtime.resolveAuthorizedPath(requestedPath, rootPath);
-    if (!resolved.ok) {
-        runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: resolved.error });
-        return;
-    }
-    if (!/\.mdx?$/i.test(resolved.path)) {
-        runtime.client.sendRes({
-            type: 'res',
-            id: req.id,
-            ok: false,
-            error: 'Only Markdown files can be exported to PDF',
-        });
-        return;
-    }
-    const outputPath = defaultPdfOutputPath(resolved.path);
-    const checkedOutput = runtime.resolveAuthorizedPath(outputPath, rootPath);
-    if (!checkedOutput.ok) {
-        runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: checkedOutput.error });
-        return;
-    }
-    try {
-        const result = await convertMarkdownToPdf(resolved.path, {
-            outputPath: checkedOutput.path,
-            title,
-        });
-        runtime.client.sendRes({
-            type: 'res',
-            id: req.id,
-            ok: true,
-            payload: {
-                sourcePath: resolved.path,
-                outputPath: result.outputPath,
-                entry: makeFsEntry(result.outputPath),
-            },
-        });
-    }
-    catch (err) {
-        if (err instanceof MarkdownPdfBrowserMissingError) {
-            runtime.client.sendRes({
-                type: 'res',
-                id: req.id,
-                ok: false,
-                error: 'This machine needs the PDF export component before Markdown files can be exported to PDF.',
-                payload: err.setup,
-            });
-            return;
-        }
-        runtime.client.sendRes({
-            type: 'res',
-            id: req.id,
-            ok: false,
-            error: err instanceof Error ? err.message : String(err),
-        });
-    }
-}
-function safeArchiveBaseName(name) {
-    let safeName = '';
-    for (const char of name.trim()) {
-        const code = char.charCodeAt(0);
-        const unsafe = code <= 0x1f || '<>:"/\\|?*'.includes(char);
-        if (unsafe) {
-            if (!safeName.endsWith('-'))
-                safeName += '-';
-        }
-        else {
-            safeName += char;
-        }
-    }
-    const trimmed = safeName.replace(/[. ]+$/g, '');
-    return trimmed || 'folder';
-}
-export async function handleFsArchiveZip(runtime, req) {
-    const requestedPath = req.params.path;
-    const rootPath = req.params.rootPath || requestedPath;
-    if (!requestedPath) {
-        runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: 'path is required' });
-        return;
-    }
-    const resolved = runtime.resolveAuthorizedPath(requestedPath, rootPath);
-    if (!resolved.ok) {
-        runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: resolved.error });
-        return;
-    }
-    try {
-        const stat = fs.statSync(resolved.path);
-        if (!stat.isDirectory()) {
-            runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: 'Not a directory' });
-            return;
-        }
-        const api = pathApiForPath(resolved.path);
-        const baseName = safeArchiveBaseName(api.basename(resolved.path));
-        const archiveDir = path.join(os.tmpdir(), 'shennian-archives');
-        const outputPath = path.join(archiveDir, `${baseName}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}.zip`);
-        const result = createZipArchive(resolved.path, outputPath, {
-            maxFiles: MAX_ARCHIVE_FILES,
-            maxTotalSize: MAX_ARCHIVE_TOTAL_SIZE,
-        });
-        runtime.client.sendRes({
-            type: 'res',
-            id: req.id,
-            ok: true,
-            payload: {
-                sourcePath: resolved.path,
-                outputPath: result.outputPath,
-                entry: makeFsEntry(result.outputPath),
-                fileCount: result.fileCount,
-                totalSize: result.totalSize,
-            },
-        });
-    }
-    catch (err) {
-        runtime.client.sendRes({
-            type: 'res',
-            id: req.id,
-            ok: false,
-            error: err instanceof Error ? err.message : String(err),
-        });
-    }
-}
-export async function handleFsTransfer(runtime, req) {
-    const { name, targetPath, data, direct } = req.params;
-    if (!name || !data) {
-        runtime.client.sendRes({
-            type: 'res',
-            id: req.id,
-            ok: false,
-            error: 'name and data are required',
-        });
-        return;
-    }
-    try {
-        const rootPath = req.params.rootPath || targetPath || os.homedir();
-        const resolved = runtime.resolveAuthorizedPath(targetPath || rootPath, rootPath);
-        if (!resolved.ok) {
-            runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: resolved.error });
-            return;
-        }
-        const baseDir = resolved.path;
-        const uploadDir = direct ? baseDir : path.join(baseDir, '.uploads');
-        if (!direct)
-            fs.mkdirSync(uploadDir, { recursive: true });
-        const filePath = path.join(uploadDir, path.basename(name));
-        const buffer = Buffer.from(data, 'base64');
-        fs.writeFileSync(filePath, buffer);
-        runtime.client.sendRes({ type: 'res', id: req.id, ok: true, payload: { path: filePath } });
-    }
-    catch (err) {
-        runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: String(err) });
-    }
-}
-export async function handleFsTransferStart(runtime, req) {
-    const { name, targetPath, totalSize, direct, kind, baseName } = req.params;
-    const manifest = decodeManifest(req.params.manifest);
-    const isFolder = kind === 'folder';
-    const transferName = isFolder ? baseName || name : name;
-    if (!transferName || (!isFolder && !totalSize)) {
-        runtime.client.sendRes({
-            type: 'res',
-            id: req.id,
-            ok: false,
-            error: 'name and totalSize are required',
-        });
-        return;
-    }
-    try {
-        const rootPath = req.params.rootPath || targetPath || os.homedir();
-        const resolved = runtime.resolveAuthorizedPath(targetPath || rootPath, rootPath);
-        if (!resolved.ok) {
-            runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: resolved.error });
-            return;
-        }
-        const baseDir = resolved.path;
-        const destinationDir = direct ? baseDir : path.join(baseDir, '.uploads');
-        if (!direct)
-            fs.mkdirSync(destinationDir, { recursive: true });
-        const transferId = `tf-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
-        if (isFolder) {
-            if (!manifest.length) {
-                runtime.client.sendRes({
-                    type: 'res',
-                    id: req.id,
-                    ok: false,
-                    error: 'manifest is required for folder uploads',
-                });
-                return;
-            }
-            if (manifest.length > MAX_FOLDER_UPLOAD_FILES) {
-                runtime.client.sendRes({
-                    type: 'res',
-                    id: req.id,
-                    ok: false,
-                    error: `Too many files: ${manifest.length}`,
-                });
-                return;
-            }
-            const folderName = path.basename(transferName);
-            if (!isSafeRenameName(folderName)) {
-                runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: 'Invalid folder name' });
-                return;
-            }
-            const targetDir = path.join(destinationDir, folderName);
-            const checkedTargetDir = runtime.resolveAuthorizedPath(targetDir, rootPath);
-            if (!checkedTargetDir.ok) {
-                runtime.client.sendRes({
-                    type: 'res',
-                    id: req.id,
-                    ok: false,
-                    error: checkedTargetDir.error,
-                });
-                return;
-            }
-            const seen = new Set();
-            let aggregateSize = 0;
-            const files = new Map();
-            for (const item of manifest) {
-                if (!isSafeRelativeUploadPath(item.relativePath)) {
-                    runtime.client.sendRes({
-                        type: 'res',
-                        id: req.id,
-                        ok: false,
-                        error: `Invalid relativePath: ${item.relativePath}`,
-                    });
-                    return;
-                }
-                if (!Number.isFinite(item.size) || item.size < 0) {
-                    runtime.client.sendRes({
-                        type: 'res',
-                        id: req.id,
-                        ok: false,
-                        error: `Invalid size: ${item.relativePath}`,
-                    });
-                    return;
-                }
-                if (seen.has(item.relativePath)) {
-                    runtime.client.sendRes({
-                        type: 'res',
-                        id: req.id,
-                        ok: false,
-                        error: `Duplicate relativePath: ${item.relativePath}`,
-                    });
-                    return;
-                }
-                seen.add(item.relativePath);
-                aggregateSize += item.size;
-                if (aggregateSize > MAX_FOLDER_UPLOAD_TOTAL_SIZE) {
-                    runtime.client.sendRes({
-                        type: 'res',
-                        id: req.id,
-                        ok: false,
-                        error: `Folder too large: ${aggregateSize} bytes`,
-                    });
-                    return;
-                }
-                const finalPath = path.join(checkedTargetDir.path, ...item.relativePath.split('/'));
-                const checkedFinalPath = runtime.resolveAuthorizedPath(finalPath, rootPath);
-                if (!checkedFinalPath.ok) {
-                    runtime.client.sendRes({
-                        type: 'res',
-                        id: req.id,
-                        ok: false,
-                        error: checkedFinalPath.error,
-                    });
-                    return;
-                }
-                const tempPath = path.join(os.tmpdir(), `.shennian-upload-${transferId}-${files.size}`);
-                fs.writeFileSync(tempPath, Buffer.alloc(0));
-                files.set(item.relativePath, {
-                    relativePath: item.relativePath,
-                    tempPath,
-                    targetPath: checkedFinalPath.path,
-                    size: item.size,
-                });
-            }
-            runtime.pendingTransfers.set(transferId, {
-                tempPath: '',
-                targetPath: checkedTargetDir.path,
-                totalSize: aggregateSize,
-                kind: 'folder',
-                rootPath,
-                targetDir: checkedTargetDir.path,
-                files,
-            });
-            runtime.client.sendRes({
-                type: 'res',
-                id: req.id,
-                ok: true,
-                payload: { transferId, path: checkedTargetDir.path },
-            });
-            return;
-        }
-        const tempPath = path.join(os.tmpdir(), `.shennian-upload-${transferId}`);
-        const finalPath = path.join(destinationDir, path.basename(transferName));
-        fs.writeFileSync(tempPath, Buffer.alloc(0));
-        runtime.pendingTransfers.set(transferId, {
-            tempPath,
-            targetPath: finalPath,
-            totalSize,
-            kind: 'file',
-        });
-        runtime.client.sendRes({ type: 'res', id: req.id, ok: true, payload: { transferId } });
-    }
-    catch (err) {
-        runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: String(err) });
-    }
-}
-export async function handleFsTransferChunk(runtime, req) {
-    const { transferId, offset, data, relativePath } = req.params;
-    const transfer = runtime.pendingTransfers.get(transferId);
-    if (!transfer) {
-        runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: 'Invalid transferId' });
-        return;
-    }
-    try {
-        const target = transfer.kind === 'folder'
-            ? transfer.files?.get(String(relativePath || ''))
-            : { tempPath: transfer.tempPath, size: transfer.totalSize };
-        if (!target) {
-            runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: 'Invalid relativePath' });
-            return;
-        }
-        const buffer = Buffer.from(data, 'base64');
-        if (offset < 0 || offset + buffer.length > target.size) {
-            runtime.client.sendRes({
-                type: 'res',
-                id: req.id,
-                ok: false,
-                error: 'Chunk exceeds declared size',
-            });
-            return;
-        }
-        const fd = fs.openSync(target.tempPath, 'r+');
-        try {
-            fs.writeSync(fd, buffer, 0, buffer.length, offset);
-        }
-        finally {
-            fs.closeSync(fd);
-        }
-        runtime.client.sendRes({
-            type: 'res',
-            id: req.id,
-            ok: true,
-            payload: { written: buffer.length },
-        });
-    }
-    catch (err) {
-        runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: String(err) });
-    }
-}
-export async function handleFsTransferFinish(runtime, req) {
-    const { transferId } = req.params;
-    const transfer = runtime.pendingTransfers.get(transferId);
-    if (!transfer) {
-        runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: 'Invalid transferId' });
-        return;
-    }
-    try {
-        if (transfer.kind === 'folder') {
-            let count = 0;
-            for (const file of transfer.files?.values() ?? []) {
-                fs.mkdirSync(path.dirname(file.targetPath), { recursive: true });
-                fs.renameSync(file.tempPath, file.targetPath);
-                count += 1;
-            }
-            runtime.pendingTransfers.delete(transferId);
-            runtime.client.sendRes({
-                type: 'res',
-                id: req.id,
-                ok: true,
-                payload: { path: transfer.targetDir ?? transfer.targetPath, count },
-            });
-            return;
-        }
-        fs.renameSync(transfer.tempPath, transfer.targetPath);
-        runtime.pendingTransfers.delete(transferId);
-        runtime.client.sendRes({
-            type: 'res',
-            id: req.id,
-            ok: true,
-            payload: { path: transfer.targetPath },
-        });
-    }
-    catch {
-        try {
-            fs.copyFileSync(transfer.tempPath, transfer.targetPath);
-            fs.unlinkSync(transfer.tempPath);
-            runtime.pendingTransfers.delete(transferId);
-            runtime.client.sendRes({
-                type: 'res',
-                id: req.id,
-                ok: true,
-                payload: { path: transfer.targetPath },
-            });
-        }
-        catch (err) {
-            runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: String(err) });
-        }
-    }
-}
-export async function handleFsTransferAbort(runtime, req) {
-    const { transferId } = req.params;
-    const transfer = runtime.pendingTransfers.get(transferId);
-    if (transfer) {
-        const tempPaths = transfer.kind === 'folder'
-            ? Array.from(transfer.files?.values() ?? []).map((file) => file.tempPath)
-            : [transfer.tempPath];
-        for (const tempPath of tempPaths) {
-            try {
-                if (tempPath)
-                    fs.unlinkSync(tempPath);
-            }
-            catch {
-                // ignore cleanup failures
-            }
-        }
-        runtime.pendingTransfers.delete(transferId);
-    }
-    runtime.client.sendRes({ type: 'res', id: req.id, ok: true });
-}
-export function cleanupPendingTransfers(runtime) {
-    for (const [, transfer] of runtime.pendingTransfers) {
-        const tempPaths = transfer.kind === 'folder'
-            ? Array.from(transfer.files?.values() ?? []).map((file) => file.tempPath)
-            : [transfer.tempPath];
-        for (const tempPath of tempPaths) {
-            try {
-                if (tempPath)
-                    fs.unlinkSync(tempPath);
-            }
-            catch {
-                // ignore cleanup failures
-            }
-        }
-    }
-    runtime.pendingTransfers.clear();
-}
+import d from"node:fs";import g from"node:os";import p from"node:path";import{convertMarkdownToPdf as C,defaultPdfOutputPath as j,MarkdownPdfBrowserMissingError as O}from"../../tools/markdown-to-pdf.js";import{createZipArchive as L}from"../archive-zip.js";import{BinaryTextPreviewError as B,decodeTextBufferAuto as U,isAutoTextEncoding as X}from"../../fs/text-decoder.js";const D="__roots__",Z=2e3,H=1024*1024*1024,W=5e3,V=1024*1024*1024;function E(e){return/^[A-Za-z]:([\\/]|$)/.test(e)||/^\\\\[^\\]+\\[^\\]+/.test(e)}function v(e){return E(e)?p.win32:p.posix}function T(e){const t=d.statSync(e);return{name:v(e).basename(e),path:e,isDir:t.isDirectory(),size:t.isFile()?t.size:void 0,modifiedAt:t.mtimeMs}}function Y(){if(g.platform()==="win32"){const e=[];for(let t=65;t<=90;t+=1){const r=`${String.fromCharCode(t)}:\\`;d.existsSync(r)&&e.push({name:r,path:r,isDir:!0})}return e}return[{name:"/",path:"/",isDir:!0}]}function G(e,t){const r=typeof e=="object"&&e&&"code"in e?String(e.code):"";return r==="ENOENT"?`Directory not found: ${t}`:r==="EACCES"||r==="EPERM"?`Permission denied: ${t}`:e instanceof Error?e.message:String(e)}function J(e){if(!e||e==="."||e.trim()!==e||p.posix.isAbsolute(e)||p.win32.isAbsolute(e))return!1;const t=e.replace(/\\/g,"/");return t!==e?!1:t.split("/").every(r=>r&&r!=="."&&r!==".."&&!M(r))}function $(e){const t=e.trim();if(!t||t!==e||e==="."||e===".."||M(e)||/[\\/:]/.test(e)||/[<>|"?*]/.test(e)||/[. ]$/.test(e))return!1;const r=e.split(".")[0]?.toUpperCase();return!(r&&/^(CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])$/.test(r))}function M(e){return Array.from(e).some(t=>{const r=t.charCodeAt(0);return r>=0&&r<=31})}function K(e){return Array.isArray(e)?e.map(t=>({relativePath:String(t.relativePath||""),size:Number(t.size||0),mimeType:t.mimeType,modifiedAt:t.modifiedAt})):[]}async function ne(e,t){const r=t.params.path||g.homedir(),a=t.params.rootPath||r;if(r===D){e.client.sendRes({type:"res",id:t.id,ok:!0,payload:{path:D,entries:Y()}});return}const n=e.resolveAuthorizedPath(r,a);if(!n.ok){e.client.sendRes({type:"res",id:t.id,ok:!1,error:n.error});return}const s=n.path;try{const o=d.readdirSync(s,{withFileTypes:!0}),c=E(s)?p.win32.join:p.join,i=o.map(l=>({name:l.name,path:c(s,l.name),isDir:l.isDirectory()})).sort((l,f)=>l.isDir!==f.isDir?l.isDir?-1:1:l.name.localeCompare(f.name));e.client.sendRes({type:"res",id:t.id,ok:!0,payload:{path:s,entries:i}})}catch(o){e.client.sendRes({type:"res",id:t.id,ok:!1,error:G(o,s)})}}async function oe(e,t){const r=t.params.path,a=t.params.rootPath||r,n=e.resolveAuthorizedPath(r,a);if(!n.ok){e.client.sendRes({type:"res",id:t.id,ok:!1,error:n.error});return}const s=n.path,o=t.params.encoding,c=typeof o=="string"?o:"utf8",i=t.params.offset,l=t.params.length;try{const f=d.statSync(s);if(!f.isFile()){e.client.sendRes({type:"res",id:t.id,ok:!1,error:"Not a file"});return}if(i!=null&&l!=null){const u=Math.min(l,Math.max(0,f.size-i));if(u<=0){e.client.sendRes({type:"res",id:t.id,ok:!0,payload:{data:"",offset:i,length:0,totalSize:f.size,path:s}});return}const P=d.openSync(s,"r");try{const k=Buffer.alloc(u),S=d.readSync(P,k,0,u,i);e.client.sendRes({type:"res",id:t.id,ok:!0,payload:{data:k.subarray(0,S).toString("base64"),offset:i,length:S,totalSize:f.size,path:s}})}finally{d.closeSync(P)}return}const y=t.params.maxSize||(c==="base64"?5*1024*1024:512*1024);if(f.size>y){e.client.sendRes({type:"res",id:t.id,ok:!1,error:`File too large: ${f.size} bytes (max ${y})`,payload:{size:f.size,path:s}});return}if(c==="base64"){const u=d.readFileSync(s);e.client.sendRes({type:"res",id:t.id,ok:!0,payload:{data:u.toString("base64"),path:s,size:f.size}});return}if(X(c)){const u=d.readFileSync(s),P=U(u);e.client.sendRes({type:"res",id:t.id,ok:!0,payload:{content:P.content,path:s,size:f.size,encoding:P.encoding,encodingFallback:P.fallback}});return}const m=d.readFileSync(s,"utf-8");e.client.sendRes({type:"res",id:t.id,ok:!0,payload:{content:m,path:s,size:f.size}})}catch(f){e.client.sendRes({type:"res",id:t.id,ok:!1,error:f instanceof B?f.message:String(f)})}}async function ie(e,t){const r=t.params.path,a=t.params.content,n=t.params.rootPath||r;if(!r||typeof a!="string"){e.client.sendRes({type:"res",id:t.id,ok:!1,error:"path and content are required"});return}const s=e.resolveAuthorizedPath(r,n);if(!s.ok){e.client.sendRes({type:"res",id:t.id,ok:!1,error:s.error});return}try{const o=d.existsSync(s.path)?d.statSync(s.path):null;if(o&&!o.isFile()){e.client.sendRes({type:"res",id:t.id,ok:!1,error:"Not a file"});return}d.writeFileSync(s.path,a,"utf-8");const c=d.statSync(s.path);e.client.sendRes({type:"res",id:t.id,ok:!0,payload:{path:s.path,size:c.size,modifiedAt:c.mtimeMs}})}catch(o){e.client.sendRes({type:"res",id:t.id,ok:!1,error:String(o)})}}async function de(e,t){const r=t.params.path,a=t.params.newName;if(!r||!a){e.client.sendRes({type:"res",id:t.id,ok:!1,error:"path and newName are required"});return}if(!$(a)){e.client.sendRes({type:"res",id:t.id,ok:!1,error:"Invalid newName"});return}const n=v(r),s=t.params.rootPath||n.dirname(r),o=e.resolveAuthorizedPath(r,s);if(!o.ok){e.client.sendRes({type:"res",id:t.id,ok:!1,error:o.error});return}try{const c=v(o.path),i=c.join(c.dirname(o.path),a),l=e.resolveAuthorizedPath(i,s);if(!l.ok){e.client.sendRes({type:"res",id:t.id,ok:!1,error:l.error});return}if(d.existsSync(l.path)){e.client.sendRes({type:"res",id:t.id,ok:!1,error:"Target already exists"});return}d.renameSync(o.path,l.path),e.client.sendRes({type:"res",id:t.id,ok:!0,payload:{oldPath:o.path,newPath:l.path,entry:T(l.path)}})}catch(c){e.client.sendRes({type:"res",id:t.id,ok:!1,error:String(c)})}}async function ce(e,t){const r=t.params.path,a=t.params.rootPath||p.dirname(r||"."),n=typeof t.params.title=="string"?t.params.title:void 0;if(!r){e.client.sendRes({type:"res",id:t.id,ok:!1,error:"path is required"});return}const s=e.resolveAuthorizedPath(r,a);if(!s.ok){e.client.sendRes({type:"res",id:t.id,ok:!1,error:s.error});return}if(!/\.mdx?$/i.test(s.path)){e.client.sendRes({type:"res",id:t.id,ok:!1,error:"Only Markdown files can be exported to PDF"});return}const o=j(s.path),c=e.resolveAuthorizedPath(o,a);if(!c.ok){e.client.sendRes({type:"res",id:t.id,ok:!1,error:c.error});return}try{const i=await C(s.path,{outputPath:c.path,title:n});e.client.sendRes({type:"res",id:t.id,ok:!0,payload:{sourcePath:s.path,outputPath:i.outputPath,entry:T(i.outputPath)}})}catch(i){if(i instanceof O){e.client.sendRes({type:"res",id:t.id,ok:!1,error:"This machine needs the PDF export component before Markdown files can be exported to PDF.",payload:i.setup});return}e.client.sendRes({type:"res",id:t.id,ok:!1,error:i instanceof Error?i.message:String(i)})}}function Q(e){let t="";for(const a of e.trim())a.charCodeAt(0)<=31||'<>:"/\\|?*'.includes(a)?t.endsWith("-")||(t+="-"):t+=a;return t.replace(/[. ]+$/g,"")||"folder"}async function le(e,t){const r=t.params.path,a=t.params.rootPath||r;if(!r){e.client.sendRes({type:"res",id:t.id,ok:!1,error:"path is required"});return}const n=e.resolveAuthorizedPath(r,a);if(!n.ok){e.client.sendRes({type:"res",id:t.id,ok:!1,error:n.error});return}try{if(!d.statSync(n.path).isDirectory()){e.client.sendRes({type:"res",id:t.id,ok:!1,error:"Not a directory"});return}const o=v(n.path),c=Q(o.basename(n.path)),i=p.join(g.tmpdir(),"shennian-archives"),l=p.join(i,`${c}-${Date.now()}-${Math.random().toString(36).slice(2,8)}.zip`),f=L(n.path,l,{maxFiles:W,maxTotalSize:V});e.client.sendRes({type:"res",id:t.id,ok:!0,payload:{sourcePath:n.path,outputPath:f.outputPath,entry:T(f.outputPath),fileCount:f.fileCount,totalSize:f.totalSize}})}catch(s){e.client.sendRes({type:"res",id:t.id,ok:!1,error:s instanceof Error?s.message:String(s)})}}async function fe(e,t){const{name:r,targetPath:a,data:n,direct:s}=t.params;if(!r||!n){e.client.sendRes({type:"res",id:t.id,ok:!1,error:"name and data are required"});return}try{const o=t.params.rootPath||a||g.homedir(),c=e.resolveAuthorizedPath(a||o,o);if(!c.ok){e.client.sendRes({type:"res",id:t.id,ok:!1,error:c.error});return}const i=c.path,l=s?i:p.join(i,".uploads");s||d.mkdirSync(l,{recursive:!0});const f=p.join(l,p.basename(r)),y=Buffer.from(n,"base64");d.writeFileSync(f,y),e.client.sendRes({type:"res",id:t.id,ok:!0,payload:{path:f}})}catch(o){e.client.sendRes({type:"res",id:t.id,ok:!1,error:String(o)})}}async function pe(e,t){const{name:r,targetPath:a,totalSize:n,direct:s,kind:o,baseName:c}=t.params,i=K(t.params.manifest),l=o==="folder",f=l&&c||r;if(!f||!l&&!n){e.client.sendRes({type:"res",id:t.id,ok:!1,error:"name and totalSize are required"});return}try{const y=t.params.rootPath||a||g.homedir(),m=e.resolveAuthorizedPath(a||y,y);if(!m.ok){e.client.sendRes({type:"res",id:t.id,ok:!1,error:m.error});return}const u=m.path,P=s?u:p.join(u,".uploads");s||d.mkdirSync(P,{recursive:!0});const k=`tf-${Date.now()}-${Math.random().toString(36).slice(2,8)}`;if(l){if(!i.length){e.client.sendRes({type:"res",id:t.id,ok:!1,error:"manifest is required for folder uploads"});return}if(i.length>Z){e.client.sendRes({type:"res",id:t.id,ok:!1,error:`Too many files: ${i.length}`});return}const x=p.basename(f);if(!$(x)){e.client.sendRes({type:"res",id:t.id,ok:!1,error:"Invalid folder name"});return}const I=p.join(P,x),R=e.resolveAuthorizedPath(I,y);if(!R.ok){e.client.sendRes({type:"res",id:t.id,ok:!1,error:R.error});return}const b=new Set;let z=0;const A=new Map;for(const h of i){if(!J(h.relativePath)){e.client.sendRes({type:"res",id:t.id,ok:!1,error:`Invalid relativePath: ${h.relativePath}`});return}if(!Number.isFinite(h.size)||h.size<0){e.client.sendRes({type:"res",id:t.id,ok:!1,error:`Invalid size: ${h.relativePath}`});return}if(b.has(h.relativePath)){e.client.sendRes({type:"res",id:t.id,ok:!1,error:`Duplicate relativePath: ${h.relativePath}`});return}if(b.add(h.relativePath),z+=h.size,z>H){e.client.sendRes({type:"res",id:t.id,ok:!1,error:`Folder too large: ${z} bytes`});return}const _=p.join(R.path,...h.relativePath.split("/")),F=e.resolveAuthorizedPath(_,y);if(!F.ok){e.client.sendRes({type:"res",id:t.id,ok:!1,error:F.error});return}const w=p.join(g.tmpdir(),`.shennian-upload-${k}-${A.size}`);d.writeFileSync(w,Buffer.alloc(0)),A.set(h.relativePath,{relativePath:h.relativePath,tempPath:w,targetPath:F.path,size:h.size})}e.pendingTransfers.set(k,{tempPath:"",targetPath:R.path,totalSize:z,kind:"folder",rootPath:y,targetDir:R.path,files:A}),e.client.sendRes({type:"res",id:t.id,ok:!0,payload:{transferId:k,path:R.path}});return}const S=p.join(g.tmpdir(),`.shennian-upload-${k}`),N=p.join(P,p.basename(f));d.writeFileSync(S,Buffer.alloc(0)),e.pendingTransfers.set(k,{tempPath:S,targetPath:N,totalSize:n,kind:"file"}),e.client.sendRes({type:"res",id:t.id,ok:!0,payload:{transferId:k}})}catch(y){e.client.sendRes({type:"res",id:t.id,ok:!1,error:String(y)})}}async function he(e,t){const{transferId:r,offset:a,data:n,relativePath:s}=t.params,o=e.pendingTransfers.get(r);if(!o){e.client.sendRes({type:"res",id:t.id,ok:!1,error:"Invalid transferId"});return}try{const c=o.kind==="folder"?o.files?.get(String(s||"")):{tempPath:o.tempPath,size:o.totalSize};if(!c){e.client.sendRes({type:"res",id:t.id,ok:!1,error:"Invalid relativePath"});return}const i=Buffer.from(n,"base64");if(a<0||a+i.length>c.size){e.client.sendRes({type:"res",id:t.id,ok:!1,error:"Chunk exceeds declared size"});return}const l=d.openSync(c.tempPath,"r+");try{d.writeSync(l,i,0,i.length,a)}finally{d.closeSync(l)}e.client.sendRes({type:"res",id:t.id,ok:!0,payload:{written:i.length}})}catch(c){e.client.sendRes({type:"res",id:t.id,ok:!1,error:String(c)})}}async function ye(e,t){const{transferId:r}=t.params,a=e.pendingTransfers.get(r);if(!a){e.client.sendRes({type:"res",id:t.id,ok:!1,error:"Invalid transferId"});return}try{if(a.kind==="folder"){let n=0;for(const s of a.files?.values()??[])d.mkdirSync(p.dirname(s.targetPath),{recursive:!0}),d.renameSync(s.tempPath,s.targetPath),n+=1;e.pendingTransfers.delete(r),e.client.sendRes({type:"res",id:t.id,ok:!0,payload:{path:a.targetDir??a.targetPath,count:n}});return}d.renameSync(a.tempPath,a.targetPath),e.pendingTransfers.delete(r),e.client.sendRes({type:"res",id:t.id,ok:!0,payload:{path:a.targetPath}})}catch{try{d.copyFileSync(a.tempPath,a.targetPath),d.unlinkSync(a.tempPath),e.pendingTransfers.delete(r),e.client.sendRes({type:"res",id:t.id,ok:!0,payload:{path:a.targetPath}})}catch(n){e.client.sendRes({type:"res",id:t.id,ok:!1,error:String(n)})}}}async function ue(e,t){const{transferId:r}=t.params,a=e.pendingTransfers.get(r);if(a){const n=a.kind==="folder"?Array.from(a.files?.values()??[]).map(s=>s.tempPath):[a.tempPath];for(const s of n)try{s&&d.unlinkSync(s)}catch{}e.pendingTransfers.delete(r)}e.client.sendRes({type:"res",id:t.id,ok:!0})}function Pe(e){for(const[,t]of e.pendingTransfers){const r=t.kind==="folder"?Array.from(t.files?.values()??[]).map(a=>a.tempPath):[t.tempPath];for(const a of r)try{a&&d.unlinkSync(a)}catch{}}e.pendingTransfers.clear()}export{Pe as cleanupPendingTransfers,le as handleFsArchiveZip,ce as handleFsExportMarkdownPdf,ne as handleFsLs,oe as handleFsRead,de as handleFsRename,fe as handleFsTransfer,ue as handleFsTransferAbort,he as handleFsTransferChunk,ye as handleFsTransferFinish,pe as handleFsTransferStart,ie as handleFsWrite};