@j0hanz/filesystem-context-mcp 1.0.0

package/dist/__tests__/lib/file-operations.test.js

@@ -0,0 +1,417 @@
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { afterAll, beforeAll, describe, expect, it } from 'vitest';
+import { analyzeDirectory, getDirectoryTree, getFileInfo, listDirectory, readMediaFile, readMultipleFiles, searchContent, searchFiles, } from '../../lib/file-operations.js';
+import { normalizePath } from '../../lib/path-utils.js';
+import { setAllowedDirectories } from '../../lib/path-validation.js';
+describe('File Operations', () => {
+    let testDir;
+    beforeAll(async () => {
+        // Create a temporary test directory with various files
+        testDir = await fs.mkdtemp(path.join(os.tmpdir(), 'mcp-fileops-test-'));
+        // Create test structure
+        await fs.mkdir(path.join(testDir, 'src'));
+        await fs.mkdir(path.join(testDir, 'docs'));
+        await fs.mkdir(path.join(testDir, '.hidden'));
+        // Create test files
+        await fs.writeFile(path.join(testDir, 'README.md'), '# Test Project\nThis is a test.\n');
+        await fs.writeFile(path.join(testDir, 'src', 'index.ts'), 'export const hello = "world";\n');
+        await fs.writeFile(path.join(testDir, 'src', 'utils.ts'), 'export function add(a: number, b: number) { return a + b; }\n');
+        await fs.writeFile(path.join(testDir, 'docs', 'guide.md'), '# Guide\nSome documentation.\n');
+        await fs.writeFile(path.join(testDir, '.hidden', 'secret.txt'), 'hidden content');
+        // Create a multi-line file for head/tail tests
+        const lines = Array.from({ length: 100 }, (_, i) => `Line ${i + 1}`).join('\n');
+        await fs.writeFile(path.join(testDir, 'multiline.txt'), lines);
+        // Create a simple PNG-like binary file (just bytes, not a real image)
+        const binaryData = Buffer.from([
+            0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a, 0x00, 0x00,
+        ]);
+        await fs.writeFile(path.join(testDir, 'image.png'), binaryData);
+        // Set allowed directories
+        setAllowedDirectories([normalizePath(testDir)]);
+    });
+    afterAll(async () => {
+        try {
+            await fs.rm(testDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    });
+    describe('listDirectory', () => {
+        it('should list directory contents', async () => {
+            const result = await listDirectory(testDir);
+            expect(result.entries.length).toBeGreaterThan(0);
+            expect(result.summary.totalEntries).toBeGreaterThan(0);
+        });
+        it('should list recursively when specified', async () => {
+            const result = await listDirectory(testDir, { recursive: true });
+            expect(result.entries.some((e) => e.name === 'index.ts')).toBe(true);
+        });
+        it('should include hidden files when specified', async () => {
+            const result = await listDirectory(testDir, { includeHidden: true });
+            expect(result.entries.some((e) => e.name === '.hidden')).toBe(true);
+        });
+        it('should exclude hidden files by default', async () => {
+            const result = await listDirectory(testDir, { includeHidden: false });
+            expect(result.entries.some((e) => e.name === '.hidden')).toBe(false);
+        });
+        it('should respect maxEntries limit', async () => {
+            const result = await listDirectory(testDir, { maxEntries: 2 });
+            expect(result.entries.length).toBeLessThanOrEqual(2);
+            expect(result.summary.truncated).toBe(true);
+        });
+    });
+    describe('searchFiles', () => {
+        it('should find files by glob pattern', async () => {
+            const result = await searchFiles(testDir, '**/*.ts');
+            expect(result.results.length).toBe(2);
+            expect(result.results.some((r) => r.path.includes('index.ts'))).toBe(true);
+            // Optional: validate modified is present on file results
+            const first = result.results.find((r) => r.type === 'file');
+            if (first) {
+                expect(first.modified).toBeInstanceOf(Date);
+            }
+        });
+        it('should find markdown files', async () => {
+            const result = await searchFiles(testDir, '**/*.md');
+            expect(result.results.length).toBe(2);
+        });
+        it('should return empty results for non-matching patterns', async () => {
+            const result = await searchFiles(testDir, '**/*.xyz');
+            expect(result.results.length).toBe(0);
+        });
+        it('should respect maxResults', async () => {
+            const result = await searchFiles(testDir, '**/*', [], { maxResults: 1 });
+            expect(result.results.length).toBeLessThanOrEqual(1);
+        });
+    });
+    describe('readMultipleFiles', () => {
+        it('should read multiple files in parallel', async () => {
+            const paths = [
+                path.join(testDir, 'README.md'),
+                path.join(testDir, 'src', 'index.ts'),
+            ];
+            const results = await readMultipleFiles(paths);
+            expect(results.length).toBe(2);
+            expect(results.every((r) => r.content !== undefined)).toBe(true);
+        });
+        it('should handle individual file errors gracefully', async () => {
+            const paths = [
+                path.join(testDir, 'README.md'),
+                path.join(testDir, 'non-existent.txt'),
+            ];
+            const results = await readMultipleFiles(paths);
+            expect(results.length).toBe(2);
+            expect(results[0]?.content).toBeDefined();
+            expect(results[1]?.error).toBeDefined();
+        });
+    });
+    describe('getFileInfo', () => {
+        it('should return file metadata', async () => {
+            const info = await getFileInfo(path.join(testDir, 'README.md'));
+            expect(info.name).toBe('README.md');
+            expect(info.type).toBe('file');
+            expect(info.size).toBeGreaterThan(0);
+            expect(info.created).toBeInstanceOf(Date);
+        });
+        it('should return directory metadata', async () => {
+            const info = await getFileInfo(testDir);
+            expect(info.type).toBe('directory');
+        });
+    });
+    describe('searchContent', () => {
+        it('should find content in files', async () => {
+            const result = await searchContent(testDir, 'hello');
+            expect(result.matches.length).toBeGreaterThan(0);
+            expect(result.matches[0]?.file).toContain('index.ts');
+        });
+        it('should search case-insensitively by default', async () => {
+            const result = await searchContent(testDir, 'HELLO');
+            expect(result.matches.length).toBeGreaterThan(0);
+        });
+        it('should respect case sensitivity when specified', async () => {
+            const result = await searchContent(testDir, 'HELLO', {
+                caseSensitive: true,
+            });
+            expect(result.matches.length).toBe(0);
+        });
+        it('should skip binary files by default', async () => {
+            const result = await searchContent(testDir, 'PNG');
+            // Should not find matches in binary file
+            expect(result.summary.skippedBinary).toBeGreaterThanOrEqual(0);
+        });
+        it('should respect file pattern filter', async () => {
+            const result = await searchContent(testDir, 'export', {
+                filePattern: '**/*.ts',
+            });
+            expect(result.matches.length).toBeGreaterThan(0);
+            expect(result.matches.every((m) => m.file.endsWith('.ts'))).toBe(true);
+        });
+        it('should reject unsafe regex patterns (ReDoS protection)', async () => {
+            // Classic ReDoS patterns detected by safe-regex2:
+            // - Nested quantifiers like (a+)+
+            // - Character class with nested quantifiers like ([a-zA-Z]+)*
+            // - High repetition counts like (.*a){25}
+            const unsafePatterns = [
+                '(a+)+', // Nested quantifiers
+                '([a-zA-Z]+)*', // Nested quantifiers with character class
+                '(.*a){25}', // High repetition count
+            ];
+            for (const pattern of unsafePatterns) {
+                await expect(searchContent(testDir, pattern)).rejects.toThrow(/ReDoS|unsafe/i);
+            }
+        });
+        it('should accept safe regex patterns', async () => {
+            // Safe patterns should work normally
+            const safePatterns = ['hello', 'world\\d+', '[a-z]+', 'function\\s+\\w+'];
+            for (const pattern of safePatterns) {
+                // Should not throw
+                const result = await searchContent(testDir, pattern, {
+                    filePattern: '**/*.ts',
+                });
+                expect(result).toBeDefined();
+            }
+        });
+    });
+    describe('analyzeDirectory', () => {
+        it('should analyze directory structure', async () => {
+            const result = await analyzeDirectory(testDir);
+            expect(result.analysis.totalFiles).toBeGreaterThan(0);
+            expect(result.analysis.totalDirectories).toBeGreaterThan(0);
+            expect(result.analysis.totalSize).toBeGreaterThan(0);
+        });
+        it('should list file types', async () => {
+            const result = await analyzeDirectory(testDir);
+            expect(Object.keys(result.analysis.fileTypes).length).toBeGreaterThan(0);
+        });
+        it('should track largest files', async () => {
+            const result = await analyzeDirectory(testDir, { topN: 5 });
+            expect(result.analysis.largestFiles.length).toBeLessThanOrEqual(5);
+        });
+    });
+    describe('getDirectoryTree', () => {
+        it('should return tree structure', async () => {
+            const result = await getDirectoryTree(testDir);
+            expect(result.tree.type).toBe('directory');
+            expect(result.tree.children).toBeDefined();
+            expect(result.tree.children?.length).toBeGreaterThan(0);
+        });
+        it('should respect maxDepth', async () => {
+            const result = await getDirectoryTree(testDir, { maxDepth: 1 });
+            expect(result.summary.maxDepthReached).toBeLessThanOrEqual(1);
+        });
+        it('should exclude patterns', async () => {
+            const result = await getDirectoryTree(testDir, {
+                excludePatterns: ['docs'],
+            });
+            const hasDocsDir = result.tree.children?.some((c) => c.name === 'docs');
+            expect(hasDocsDir).toBe(false);
+        });
+        it('should include sizes when specified', async () => {
+            const result = await getDirectoryTree(testDir, { includeSize: true });
+            const fileEntry = result.tree.children?.find((c) => c.type === 'file');
+            expect(fileEntry?.size).toBeDefined();
+        });
+        it('should not traverse symlinks that escape allowed directories', async () => {
+            const outsideDir = await fs.mkdtemp(path.join(os.tmpdir(), 'mcp-outside-'));
+            const outsideFile = path.join(outsideDir, 'outside.txt');
+            await fs.writeFile(outsideFile, 'outside');
+            const linkPath = path.join(testDir, 'escape');
+            const linkType = process.platform === 'win32' ? 'junction' : 'dir';
+            let createdLink = false;
+            try {
+                // Symlink creation can fail on some Windows setups without admin/dev mode.
+                // If creation fails, we treat this as a no-op environment limitation.
+                await fs.symlink(outsideDir, linkPath, linkType);
+                createdLink = true;
+                const result = await getDirectoryTree(testDir, { maxDepth: 3 });
+                // The symlink/junction itself should not appear in the tree (we skip symlinks).
+                const childNames = (result.tree.children ?? []).map((c) => c.name);
+                expect(childNames.includes('escape')).toBe(false);
+                // And we must not traverse into the outside directory.
+                const containsName = (entry, name) => {
+                    if (entry.name === name)
+                        return true;
+                    const { children } = entry;
+                    if (!children || !Array.isArray(children))
+                        return false;
+                    for (const child of children) {
+                        if (child &&
+                            typeof child === 'object' &&
+                            containsName(child, name)) {
+                            return true;
+                        }
+                    }
+                    return false;
+                };
+                expect(containsName(result.tree, 'outside.txt')).toBe(false);
+                expect(result.summary.skippedSymlinks).toBeGreaterThanOrEqual(1);
+            }
+            catch {
+                // Skip assertion when symlink creation isn't permitted in the environment.
+                expect(createdLink).toBe(false);
+            }
+            finally {
+                try {
+                    await fs.rm(linkPath, { recursive: true, force: true });
+                }
+                catch {
+                    // ignore cleanup errors
+                }
+                try {
+                    await fs.rm(outsideDir, { recursive: true, force: true });
+                }
+                catch {
+                    // ignore cleanup errors
+                }
+            }
+        });
+    });
+    describe('readMediaFile', () => {
+        it('should read binary file as base64', async () => {
+            const result = await readMediaFile(path.join(testDir, 'image.png'));
+            expect(result.mimeType).toBe('image/png');
+            expect(result.data).toBeTruthy();
+            expect(result.size).toBeGreaterThan(0);
+        });
+        it('should return correct MIME type for markdown files', async () => {
+            const result = await readMediaFile(path.join(testDir, 'README.md'));
+            expect(result.mimeType).toBe('text/markdown');
+            expect(result.data).toBeTruthy();
+            expect(result.size).toBeGreaterThan(0);
+        });
+        it('should reject files too large', async () => {
+            await expect(readMediaFile(path.join(testDir, 'image.png'), { maxSize: 1 })).rejects.toThrow('too large');
+        });
+    });
+    describe('Edge Cases and Input Validation', () => {
+        describe('searchContent edge cases', () => {
+            it('should handle empty search results gracefully', async () => {
+                const result = await searchContent(testDir, 'xyznonexistent123', {
+                    filePattern: '**/*.ts',
+                });
+                expect(result.matches.length).toBe(0);
+                expect(result.summary.filesMatched).toBe(0);
+            });
+            it('should handle special regex characters safely', async () => {
+                // These are valid regex patterns with special chars
+                const result = await searchContent(testDir, 'hello\\.world', {
+                    filePattern: '**/*.ts',
+                });
+                expect(result).toBeDefined();
+            });
+            it('should throw on invalid regex syntax', async () => {
+                // Pattern that passes safe-regex2 but fails RegExp compilation
+                // Using an invalid backreference that's syntactically incorrect
+                await expect(searchContent(testDir, '(?')).rejects.toThrow(/Invalid regular expression|ReDoS/i);
+            });
+            it('should respect maxResults limit', async () => {
+                const result = await searchContent(testDir, '\\w+', {
+                    filePattern: '**/*.ts',
+                    maxResults: 1,
+                });
+                expect(result.matches.length).toBeLessThanOrEqual(1);
+                if (result.matches.length === 1) {
+                    expect(result.summary.truncated).toBe(true);
+                }
+            });
+            it('should respect maxFilesScanned limit', async () => {
+                const result = await searchContent(testDir, 'export', {
+                    filePattern: '**/*',
+                    maxFilesScanned: 1,
+                });
+                expect(result.summary.filesScanned).toBeLessThanOrEqual(1);
+            });
+            it('should handle timeout correctly', async () => {
+                // Very short timeout should trigger timeout behavior
+                const result = await searchContent(testDir, 'export', {
+                    filePattern: '**/*',
+                    timeoutMs: 1, // 1ms timeout
+                });
+                // Either completes quickly or times out
+                expect(result).toBeDefined();
+            });
+        });
+        describe('listDirectory edge cases', () => {
+            it('should handle maxDepth=0', async () => {
+                const result = await listDirectory(testDir, {
+                    recursive: true,
+                    maxDepth: 0,
+                });
+                // Should only list immediate children, not recurse
+                expect(result.summary.maxDepthReached).toBe(0);
+            });
+            it('should handle empty directory', async () => {
+                const emptyDir = path.join(testDir, 'empty-dir');
+                await fs.mkdir(emptyDir, { recursive: true });
+                const result = await listDirectory(emptyDir);
+                expect(result.entries.length).toBe(0);
+                await fs.rm(emptyDir, { recursive: true });
+            });
+        });
+        describe('searchFiles edge cases', () => {
+            it('should handle complex glob patterns', async () => {
+                const result = await searchFiles(testDir, '**/*.{ts,md}');
+                expect(result.results.length).toBeGreaterThan(0);
+            });
+            it('should handle negation in exclude patterns', async () => {
+                const result = await searchFiles(testDir, '**/*', ['**/docs/**']);
+                // Should not include files from docs directory
+                expect(result.results.every((r) => !r.path.includes('docs'))).toBe(true);
+            });
+        });
+        describe('getDirectoryTree edge cases', () => {
+            it('should handle very deep nesting with truncation', async () => {
+                const result = await getDirectoryTree(testDir, { maxDepth: 0 });
+                expect(result.summary.truncated).toBe(true);
+            });
+            it('should sort entries correctly (directories first)', async () => {
+                const result = await getDirectoryTree(testDir);
+                const children = result.tree.children ?? [];
+                const dirs = children.filter((c) => c.type === 'directory');
+                const files = children.filter((c) => c.type === 'file');
+                if (dirs.length > 0 && files.length > 0) {
+                    // Find first file index and last dir index
+                    const firstFileIdx = children.findIndex((c) => c.type === 'file');
+                    const lastDirIdx = children
+                        .map((c, i) => ({ c, i }))
+                        .filter(({ c }) => c.type === 'directory')
+                        .pop()?.i;
+                    if (lastDirIdx !== undefined) {
+                        expect(lastDirIdx).toBeLessThan(firstFileIdx);
+                    }
+                }
+            });
+        });
+        describe('analyzeDirectory edge cases', () => {
+            it('should handle topN=1', async () => {
+                const result = await analyzeDirectory(testDir, { topN: 1 });
+                expect(result.analysis.largestFiles.length).toBeLessThanOrEqual(1);
+                expect(result.analysis.recentlyModified.length).toBeLessThanOrEqual(1);
+            });
+            it('should correctly count file types', async () => {
+                const result = await analyzeDirectory(testDir);
+                expect(result.analysis.fileTypes['.ts']).toBe(2);
+                expect(result.analysis.fileTypes['.md']).toBe(2);
+            });
+        });
+        describe('readMultipleFiles edge cases', () => {
+            it('should handle empty array', async () => {
+                const results = await readMultipleFiles([]);
+                expect(results.length).toBe(0);
+            });
+            it('should handle all files failing', async () => {
+                const paths = [
+                    path.join(testDir, 'nonexistent1.txt'),
+                    path.join(testDir, 'nonexistent2.txt'),
+                ];
+                const results = await readMultipleFiles(paths);
+                expect(results.length).toBe(2);
+                expect(results.every((r) => r.error !== undefined)).toBe(true);
+            });
+        });
+    });
+});
+//# sourceMappingURL=file-operations.test.js.map

package/dist/__tests__/lib/file-operations.test.js.map

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

package/dist/__tests__/lib/fs-helpers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fs-helpers.test.d.ts.map

package/dist/__tests__/lib/fs-helpers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-helpers.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/lib/fs-helpers.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/lib/fs-helpers.test.js

@@ -0,0 +1,183 @@
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { afterAll, beforeAll, describe, expect, it } from 'vitest';
+import { getFileType, headFile, isHidden, isProbablyBinary, readFile, tailFile, } from '../../lib/fs-helpers.js';
+import { normalizePath } from '../../lib/path-utils.js';
+import { setAllowedDirectories } from '../../lib/path-validation.js';
+describe('FS Helpers', () => {
+    let testDir;
+    beforeAll(async () => {
+        testDir = await fs.mkdtemp(path.join(os.tmpdir(), 'mcp-fshelpers-test-'));
+        // Create test files
+        await fs.writeFile(path.join(testDir, 'README.md'), '# Test Project\nThis is a test.\n');
+        // Create a multi-line file for head/tail tests
+        const lines = Array.from({ length: 100 }, (_, i) => `Line ${i + 1}`).join('\n');
+        await fs.writeFile(path.join(testDir, 'multiline.txt'), lines);
+        // Create a simple binary file
+        const binaryData = Buffer.from([0, 1, 2, 3, 4]);
+        await fs.writeFile(path.join(testDir, 'binary.bin'), binaryData);
+        setAllowedDirectories([normalizePath(testDir)]);
+    });
+    afterAll(async () => {
+        try {
+            await fs.rm(testDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    });
+    describe('readFile', () => {
+        it('should read file contents', async () => {
+            const result = await readFile(path.join(testDir, 'README.md'));
+            expect(result.content).toContain('# Test Project');
+        });
+        it('should read specific line ranges', async () => {
+            const result = await readFile(path.join(testDir, 'multiline.txt'), {
+                lineRange: { start: 1, end: 5 },
+            });
+            expect(result.content).toContain('Line 1');
+            expect(result.content).toContain('Line 5');
+            expect(result.truncated).toBe(true);
+        });
+        it('should reject non-files', async () => {
+            await expect(readFile(testDir)).rejects.toThrow('Not a file');
+        });
+    });
+    describe('headFile', () => {
+        it('should return first N lines', async () => {
+            const content = await headFile(path.join(testDir, 'multiline.txt'), 5);
+            const lines = content.split('\n');
+            expect(lines[0]).toBe('Line 1');
+            expect(lines.length).toBeLessThanOrEqual(5);
+        });
+    });
+    describe('tailFile', () => {
+        it('should return last N lines', async () => {
+            const content = await tailFile(path.join(testDir, 'multiline.txt'), 5);
+            const lines = content.split('\n').filter((l) => l);
+            expect(lines[lines.length - 1]).toBe('Line 100');
+        });
+    });
+    describe('getFileType', () => {
+        it('should identify files', async () => {
+            const stats = await fs.stat(path.join(testDir, 'README.md'));
+            expect(getFileType(stats)).toBe('file');
+        });
+        it('should identify directories', async () => {
+            const stats = await fs.stat(testDir);
+            expect(getFileType(stats)).toBe('directory');
+        });
+    });
+    describe('isHidden', () => {
+        it('should identify hidden files', () => {
+            expect(isHidden('.git')).toBe(true);
+            expect(isHidden('file.txt')).toBe(false);
+        });
+    });
+    describe('isProbablyBinary', () => {
+        it('should identify binary files', async () => {
+            const isBinary = await isProbablyBinary(path.join(testDir, 'binary.bin'));
+            expect(isBinary).toBe(true);
+        });
+        it('should identify text files', async () => {
+            const isBinary = await isProbablyBinary(path.join(testDir, 'README.md'));
+            expect(isBinary).toBe(false);
+        });
+        it('should identify empty files as text', async () => {
+            const emptyFile = path.join(testDir, 'empty.txt');
+            await fs.writeFile(emptyFile, '');
+            const isBinary = await isProbablyBinary(emptyFile);
+            expect(isBinary).toBe(false);
+            await fs.rm(emptyFile);
+        });
+        it('should identify UTF-8 BOM files as text', async () => {
+            const bomFile = path.join(testDir, 'bom.txt');
+            // UTF-8 BOM: EF BB BF followed by text
+            const content = Buffer.concat([
+                Buffer.from([0xef, 0xbb, 0xbf]),
+                Buffer.from('Hello World'),
+            ]);
+            await fs.writeFile(bomFile, content);
+            const isBinary = await isProbablyBinary(bomFile);
+            expect(isBinary).toBe(false);
+            await fs.rm(bomFile);
+        });
+    });
+    describe('readFile edge cases', () => {
+        it('should reject reading with both head and tail', async () => {
+            await expect(readFile(path.join(testDir, 'multiline.txt'), {
+                head: 5,
+                tail: 5,
+            })).rejects.toThrow(/Cannot specify multiple/);
+        });
+        it('should reject reading with both lineRange and head', async () => {
+            await expect(readFile(path.join(testDir, 'multiline.txt'), {
+                lineRange: { start: 1, end: 5 },
+                head: 5,
+            })).rejects.toThrow(/Cannot specify multiple/);
+        });
+        it('should reject invalid lineRange start', async () => {
+            await expect(readFile(path.join(testDir, 'multiline.txt'), {
+                lineRange: { start: 0, end: 5 },
+            })).rejects.toThrow(/start must be at least 1/);
+        });
+        it('should reject lineRange where end < start', async () => {
+            await expect(readFile(path.join(testDir, 'multiline.txt'), {
+                lineRange: { start: 10, end: 5 },
+            })).rejects.toThrow(/end.*must be >= start/);
+        });
+        it('should handle reading beyond file length gracefully', async () => {
+            const result = await readFile(path.join(testDir, 'multiline.txt'), {
+                lineRange: { start: 95, end: 200 },
+            });
+            // Should return lines 95-100 (the file has 100 lines)
+            expect(result.content).toContain('Line 100');
+            expect(result.truncated).toBe(true);
+        });
+        it('should handle empty file', async () => {
+            const emptyFile = path.join(testDir, 'empty-read.txt');
+            await fs.writeFile(emptyFile, '');
+            const result = await readFile(emptyFile);
+            expect(result.content).toBe('');
+            expect(result.truncated).toBe(false);
+            await fs.rm(emptyFile);
+        });
+    });
+    describe('headFile edge cases', () => {
+        it('should handle requesting more lines than file has', async () => {
+            const content = await headFile(path.join(testDir, 'multiline.txt'), 200);
+            const lines = content.split('\n');
+            expect(lines.length).toBe(100);
+        });
+        it('should handle empty file', async () => {
+            const emptyFile = path.join(testDir, 'empty-head.txt');
+            await fs.writeFile(emptyFile, '');
+            const content = await headFile(emptyFile, 5);
+            expect(content).toBe('');
+            await fs.rm(emptyFile);
+        });
+    });
+    describe('tailFile edge cases', () => {
+        it('should handle requesting more lines than file has', async () => {
+            const content = await tailFile(path.join(testDir, 'multiline.txt'), 200);
+            const lines = content.split('\n').filter((l) => l);
+            expect(lines.length).toBe(100);
+        });
+        it('should handle empty file', async () => {
+            const emptyFile = path.join(testDir, 'empty-tail.txt');
+            await fs.writeFile(emptyFile, '');
+            const content = await tailFile(emptyFile, 5);
+            expect(content).toBe('');
+            await fs.rm(emptyFile);
+        });
+        it('should handle single line file', async () => {
+            const singleLineFile = path.join(testDir, 'single-line.txt');
+            await fs.writeFile(singleLineFile, 'Only one line');
+            const content = await tailFile(singleLineFile, 5);
+            expect(content).toBe('Only one line');
+            await fs.rm(singleLineFile);
+        });
+    });
+});
+//# sourceMappingURL=fs-helpers.test.js.map