@j0hanz/filesystem-context-mcp 1.2.6 → 1.2.7

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

@@ -0,0 +1,21 @@
+import * as path from 'node:path';
+import { expect, it } from 'vitest';
+import { readMediaFile } from '../../../lib/file-operations.js';
+import { useFileOpsFixture } from '../fixtures/file-ops-hooks.js';
+const getTestDir = useFileOpsFixture();
+it('readMediaFile reads binary file as base64', async () => {
+    const result = await readMediaFile(path.join(getTestDir(), 'image.png'));
+    expect(result.mimeType).toBe('image/png');
+    expect(result.data).toBeTruthy();
+    expect(result.size).toBeGreaterThan(0);
+});
+it('readMediaFile returns correct MIME type for markdown files', async () => {
+    const result = await readMediaFile(path.join(getTestDir(), 'README.md'));
+    expect(result.mimeType).toBe('text/markdown');
+    expect(result.data).toBeTruthy();
+    expect(result.size).toBeGreaterThan(0);
+});
+it('readMediaFile rejects files too large', async () => {
+    await expect(readMediaFile(path.join(getTestDir(), 'image.png'), { maxSize: 1 })).rejects.toThrow('too large');
+});
+//# sourceMappingURL=read-media-file.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-media-file.test.js","sourceRoot":"","sources":["../../../../src/__tests__/lib/file-operations/read-media-file.test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;AAEvC,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;IACzD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC;IACzE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;IACjC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;IAC1E,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC;IACzE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC9C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;IACjC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;IACrD,MAAM,MAAM,CACV,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CACpE,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;AACjC,CAAC,CAAC,CAAC"}

package/dist/__tests__/lib/file-operations/read-multiple-files-edge-cases.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=read-multiple-files-edge-cases.test.d.ts.map

package/dist/__tests__/lib/file-operations/read-multiple-files-edge-cases.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-multiple-files-edge-cases.test.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/lib/file-operations/read-multiple-files-edge-cases.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/lib/file-operations/read-multiple-files-edge-cases.test.js

@@ -0,0 +1,19 @@
+import * as path from 'node:path';
+import { expect, it } from 'vitest';
+import { readMultipleFiles } from '../../../lib/file-operations.js';
+import { useFileOpsFixture } from '../fixtures/file-ops-hooks.js';
+const getTestDir = useFileOpsFixture();
+it('readMultipleFiles handles empty array', async () => {
+    const results = await readMultipleFiles([]);
+    expect(results.length).toBe(0);
+});
+it('readMultipleFiles handles all files failing', async () => {
+    const paths = [
+        path.join(getTestDir(), 'nonexistent1.txt'),
+        path.join(getTestDir(), 'nonexistent2.txt'),
+    ];
+    const results = await readMultipleFiles(paths);
+    expect(results.length).toBe(2);
+    expect(results.every((r) => r.error !== undefined)).toBe(true);
+});
+//# sourceMappingURL=read-multiple-files-edge-cases.test.js.map

package/dist/__tests__/lib/file-operations/read-multiple-files-edge-cases.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-multiple-files-edge-cases.test.js","sourceRoot":"","sources":["../../../../src/__tests__/lib/file-operations/read-multiple-files-edge-cases.test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;AAEvC,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;IACrD,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,EAAE,CAAC,CAAC;IAC5C,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjC,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;IAC3D,MAAM,KAAK,GAAG;QACZ,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,kBAAkB,CAAC;QAC3C,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,kBAAkB,CAAC;KAC5C,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC,CAAC,CAAC"}

package/dist/__tests__/lib/file-operations/read-multiple-files.test.d.ts

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

package/dist/__tests__/lib/file-operations/read-multiple-files.test.d.ts.map

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

package/dist/__tests__/lib/file-operations/read-multiple-files.test.js

@@ -0,0 +1,39 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { expect, it } from 'vitest';
+import { readMultipleFiles } from '../../../lib/file-operations.js';
+import { useFileOpsFixture } from '../fixtures/file-ops-hooks.js';
+const getTestDir = useFileOpsFixture();
+it('readMultipleFiles reads multiple files in parallel', async () => {
+    const paths = [
+        path.join(getTestDir(), 'README.md'),
+        path.join(getTestDir(), 'src', 'index.ts'),
+    ];
+    const results = await readMultipleFiles(paths);
+    expect(results.length).toBe(2);
+    expect(results.every((r) => r.content !== undefined)).toBe(true);
+});
+it('readMultipleFiles handles individual file errors gracefully', async () => {
+    const paths = [
+        path.join(getTestDir(), 'README.md'),
+        path.join(getTestDir(), 'non-existent.txt'),
+    ];
+    const results = await readMultipleFiles(paths);
+    expect(results.length).toBe(2);
+    expect(results[0]?.content).toBeDefined();
+    expect(results[1]?.error).toBeDefined();
+});
+it('readMultipleFiles enforces total size cap for head/tail reads', async () => {
+    const big1 = path.join(getTestDir(), 'big1.log');
+    const big2 = path.join(getTestDir(), 'big2.log');
+    const largeContent = 'A'.repeat(50_000);
+    await fs.writeFile(big1, largeContent);
+    await fs.writeFile(big2, largeContent);
+    const results = await readMultipleFiles([big1, big2], {
+        head: 1,
+        maxTotalSize: 10,
+    });
+    expect(results.every((r) => r.error !== undefined)).toBe(true);
+    await Promise.all([fs.rm(big1), fs.rm(big2)]).catch(() => { });
+});
+//# sourceMappingURL=read-multiple-files.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-multiple-files.test.js","sourceRoot":"","sources":["../../../../src/__tests__/lib/file-operations/read-multiple-files.test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;AAEvC,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;IAClE,MAAM,KAAK,GAAG;QACZ,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,WAAW,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC;KAC3C,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnE,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;IAC3E,MAAM,KAAK,GAAG;QACZ,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,WAAW,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,kBAAkB,CAAC;KAC5C,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1C,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;AAC1C,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;IAC7E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,UAAU,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,UAAU,CAAC,CAAC;IACjD,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACvC,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAEvC,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE;QACpD,IAAI,EAAE,CAAC;QACP,YAAY,EAAE,EAAE;KACjB,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AAChE,CAAC,CAAC,CAAC"}

package/dist/__tests__/lib/file-operations/search-content-edge-cases.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=search-content-edge-cases.test.d.ts.map

package/dist/__tests__/lib/file-operations/search-content-edge-cases.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-content-edge-cases.test.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/lib/file-operations/search-content-edge-cases.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/lib/file-operations/search-content-edge-cases.test.js

@@ -0,0 +1,57 @@
+import { expect, it } from 'vitest';
+import { searchContent } from '../../../lib/file-operations.js';
+import { useFileOpsFixture } from '../fixtures/file-ops-hooks.js';
+const getTestDir = useFileOpsFixture();
+it('searchContent handles empty search results', async () => {
+    const result = await searchContent(getTestDir(), 'xyznonexistent123', {
+        filePattern: '**/*.ts',
+    });
+    expect(result.matches.length).toBe(0);
+    expect(result.summary.filesMatched).toBe(0);
+});
+it('searchContent handles special regex characters safely', async () => {
+    const result = await searchContent(getTestDir(), 'hello\\.world', {
+        filePattern: '**/*.ts',
+    });
+    expect(result).toBeDefined();
+});
+it('searchContent throws on invalid regex syntax', async () => {
+    await expect(searchContent(getTestDir(), '(?')).rejects.toThrow(/Invalid regular expression|ReDoS/i);
+});
+it('searchContent respects maxResults limit', async () => {
+    const result = await searchContent(getTestDir(), '\\w+', {
+        filePattern: '**/*.ts',
+        maxResults: 1,
+    });
+    expect(result.matches.length).toBeLessThanOrEqual(1);
+    if (result.matches.length === 1) {
+        expect(result.summary.truncated).toBe(true);
+    }
+});
+it('searchContent respects maxFilesScanned limit', async () => {
+    const result = await searchContent(getTestDir(), 'export', {
+        filePattern: '**/*',
+        maxFilesScanned: 1,
+    });
+    expect(result.summary.filesScanned).toBeLessThanOrEqual(1);
+});
+it('searchContent handles timeout correctly', async () => {
+    const result = await searchContent(getTestDir(), 'export', {
+        filePattern: '**/*',
+        timeoutMs: 1,
+    });
+    expect(result).toBeDefined();
+});
+it('searchContent stops early when maxResults is 0', async () => {
+    const result = await searchContent(getTestDir(), 'Line', { maxResults: 0 });
+    expect(result.summary.truncated).toBe(true);
+    expect(result.summary.stoppedReason).toBe('maxResults');
+});
+it('searchContent matches literal strings when isLiteral=true', async () => {
+    const result = await searchContent(getTestDir(), 'Test.*Project', {
+        isLiteral: true,
+        filePattern: '**/*.md',
+    });
+    expect(result.matches.length).toBe(0);
+});
+//# sourceMappingURL=search-content-edge-cases.test.js.map

package/dist/__tests__/lib/file-operations/search-content-edge-cases.test.js.map

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

package/dist/__tests__/lib/file-operations/search-content.test.d.ts

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

package/dist/__tests__/lib/file-operations/search-content.test.d.ts.map

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

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

@@ -0,0 +1,73 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { expect, it } from 'vitest';
+import { searchContent } from '../../../lib/file-operations.js';
+import { useFileOpsFixture } from '../fixtures/file-ops-hooks.js';
+const getTestDir = useFileOpsFixture();
+it('searchContent finds content in files', async () => {
+    const result = await searchContent(getTestDir(), 'hello');
+    expect(result.matches.length).toBeGreaterThan(0);
+    expect(result.matches[0]?.file).toContain('index.ts');
+});
+it('searchContent rejects file base path', async () => {
+    const filePath = path.join(getTestDir(), 'README.md');
+    await expect(searchContent(filePath, 'hello')).rejects.toThrow(/not a directory/i);
+});
+it('searchContent searches case-insensitively by default', async () => {
+    const result = await searchContent(getTestDir(), 'HELLO');
+    expect(result.matches.length).toBeGreaterThan(0);
+});
+it('searchContent respects case sensitivity when specified', async () => {
+    const result = await searchContent(getTestDir(), 'HELLO', {
+        caseSensitive: true,
+    });
+    expect(result.matches.length).toBe(0);
+});
+it('searchContent enforces wholeWord when literal', async () => {
+    const literalFile = path.join(getTestDir(), 'literal.txt');
+    await fs.writeFile(literalFile, 'concatenate cat scatter catapult cat\n');
+    const result = await searchContent(getTestDir(), 'cat', {
+        isLiteral: true,
+        wholeWord: true,
+        filePattern: '**/*.txt',
+    });
+    expect(result.matches.length).toBe(1);
+    expect(result.matches[0]?.matchCount).toBe(2);
+    await fs.rm(literalFile).catch(() => { });
+});
+it('searchContent skips binary files by default', async () => {
+    const result = await searchContent(getTestDir(), 'PNG');
+    expect(result.summary.skippedBinary).toBeGreaterThanOrEqual(0);
+});
+it('searchContent respects file pattern filter', async () => {
+    const result = await searchContent(getTestDir(), 'export', {
+        filePattern: '**/*.ts',
+    });
+    expect(result.matches.length).toBeGreaterThan(0);
+    expect(result.matches.every((m) => m.file.endsWith('.ts'))).toBe(true);
+});
+it('searchContent includes hidden files when requested', async () => {
+    const result = await searchContent(getTestDir(), 'hidden', {
+        includeHidden: true,
+        filePattern: '**/*',
+        isLiteral: true,
+    });
+    expect(result.matches.length).toBeGreaterThan(0);
+    expect(result.matches.some((m) => m.file.includes(`.hidden${path.sep}`))).toBe(true);
+});
+it('searchContent rejects unsafe regex patterns', async () => {
+    const unsafePatterns = ['(a+)+', '([a-zA-Z]+)*', '(.*a){25}'];
+    for (const pattern of unsafePatterns) {
+        await expect(searchContent(getTestDir(), pattern)).rejects.toThrow(/ReDoS|unsafe/i);
+    }
+});
+it('searchContent accepts safe regex patterns', async () => {
+    const safePatterns = ['hello', 'world\\d+', '[a-z]+', 'function\\s+\\w+'];
+    for (const pattern of safePatterns) {
+        const result = await searchContent(getTestDir(), pattern, {
+            filePattern: '**/*.ts',
+        });
+        expect(result).toBeDefined();
+    }
+});
+//# sourceMappingURL=search-content.test.js.map

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

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

package/dist/__tests__/lib/file-operations/search-files-edge-cases.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=search-files-edge-cases.test.d.ts.map

package/dist/__tests__/lib/file-operations/search-files-edge-cases.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-files-edge-cases.test.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/lib/file-operations/search-files-edge-cases.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/lib/file-operations/search-files-edge-cases.test.js

@@ -0,0 +1,13 @@
+import { expect, it } from 'vitest';
+import { searchFiles } from '../../../lib/file-operations.js';
+import { useFileOpsFixture } from '../fixtures/file-ops-hooks.js';
+const getTestDir = useFileOpsFixture();
+it('searchFiles handles complex glob patterns', async () => {
+    const result = await searchFiles(getTestDir(), '**/*.{ts,md}');
+    expect(result.results.length).toBeGreaterThan(0);
+});
+it('searchFiles handles negation in exclude patterns', async () => {
+    const result = await searchFiles(getTestDir(), '**/*', ['**/docs/**']);
+    expect(result.results.every((r) => !r.path.includes('docs'))).toBe(true);
+});
+//# sourceMappingURL=search-files-edge-cases.test.js.map

package/dist/__tests__/lib/file-operations/search-files-edge-cases.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-files-edge-cases.test.js","sourceRoot":"","sources":["../../../../src/__tests__/lib/file-operations/search-files-edge-cases.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;AAEvC,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;IACzD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,EAAE,cAAc,CAAC,CAAC;IAC/D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;IAChE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IACvE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3E,CAAC,CAAC,CAAC"}

package/dist/__tests__/lib/file-operations/search-files.test.d.ts

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

package/dist/__tests__/lib/file-operations/search-files.test.d.ts.map

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

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

@@ -0,0 +1,31 @@
+import * as path from 'node:path';
+import { expect, it } from 'vitest';
+import { searchFiles } from '../../../lib/file-operations.js';
+import { useFileOpsFixture } from '../fixtures/file-ops-hooks.js';
+const getTestDir = useFileOpsFixture();
+it('searchFiles finds files by glob pattern', async () => {
+    const result = await searchFiles(getTestDir(), '**/*.ts');
+    expect(result.results.length).toBe(2);
+    expect(result.results.some((r) => r.path.includes('index.ts'))).toBe(true);
+    const first = result.results.find((r) => r.type === 'file');
+    if (first) {
+        expect(first.modified).toBeInstanceOf(Date);
+    }
+});
+it('searchFiles finds markdown files', async () => {
+    const result = await searchFiles(getTestDir(), '**/*.md');
+    expect(result.results.length).toBe(2);
+});
+it('searchFiles returns empty results for non-matching patterns', async () => {
+    const result = await searchFiles(getTestDir(), '**/*.xyz');
+    expect(result.results.length).toBe(0);
+});
+it('searchFiles respects maxResults', async () => {
+    const result = await searchFiles(getTestDir(), '**/*', [], { maxResults: 1 });
+    expect(result.results.length).toBeLessThanOrEqual(1);
+});
+it('searchFiles rejects file base path', async () => {
+    const filePath = path.join(getTestDir(), 'README.md');
+    await expect(searchFiles(filePath, '**/*.ts')).rejects.toThrow(/not a directory/i);
+});
+//# sourceMappingURL=search-files.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-files.test.js","sourceRoot":"","sources":["../../../../src/__tests__/lib/file-operations/search-files.test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;AAEvC,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;IACvD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,EAAE,SAAS,CAAC,CAAC;IAC1D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IAC5D,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;IAChD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,EAAE,SAAS,CAAC,CAAC;IAC1D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;IAC3E,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,EAAE,UAAU,CAAC,CAAC;IAC3D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;IAC/C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;IAC9E,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,WAAW,CAAC,CAAC;IACtD,MAAM,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAC5D,kBAAkB,CACnB,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/__tests__/lib/fixtures/file-ops-fixture.d.ts

@@ -0,0 +1,7 @@
+interface FileOpsFixture {
+    testDir: string;
+}
+export declare function acquireFileOpsFixture(): Promise<FileOpsFixture>;
+export declare function releaseFileOpsFixture(): Promise<void>;
+export {};
+//# sourceMappingURL=file-ops-fixture.d.ts.map

package/dist/__tests__/lib/fixtures/file-ops-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-ops-fixture.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/lib/fixtures/file-ops-fixture.ts"],"names":[],"mappings":"AAOA,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AA+FD,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,cAAc,CAAC,CAKrE;AAED,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ3D"}

package/dist/__tests__/lib/fixtures/file-ops-fixture.js

@@ -0,0 +1,87 @@
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { normalizePath } from '../../../lib/path-utils.js';
+import { setAllowedDirectories } from '../../../lib/path-validation.js';
+const TEST_DIR_PREFIX = 'mcp-fileops-test-';
+async function createBaseDir() {
+    return await fs.mkdtemp(path.join(os.tmpdir(), TEST_DIR_PREFIX));
+}
+async function createDirectories(base) {
+    await Promise.all([
+        fs.mkdir(path.join(base, 'src')),
+        fs.mkdir(path.join(base, 'docs')),
+        fs.mkdir(path.join(base, '.hidden')),
+    ]);
+}
+async function writeReadme(base) {
+    await fs.writeFile(path.join(base, 'README.md'), '# Test Project\nThis is a test.\n');
+}
+async function writeSourceFiles(base) {
+    await Promise.all([
+        fs.writeFile(path.join(base, 'src', 'index.ts'), 'export const hello = "world";\n'),
+        fs.writeFile(path.join(base, 'src', 'utils.ts'), 'export function add(a: number, b: number) { return a + b; }\n'),
+    ]);
+}
+async function writeDocs(base) {
+    await fs.writeFile(path.join(base, 'docs', 'guide.md'), '# Guide\nSome documentation.\n');
+}
+async function writeHidden(base) {
+    await fs.writeFile(path.join(base, '.hidden', 'secret.txt'), 'hidden content');
+}
+async function writeMultiline(base) {
+    const lines = Array.from({ length: 100 }, (_, i) => `Line ${i + 1}`).join('\n');
+    await fs.writeFile(path.join(base, 'multiline.txt'), lines);
+}
+async function writeBinary(base) {
+    const binaryData = Buffer.from([
+        0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a, 0x00, 0x00,
+    ]);
+    await fs.writeFile(path.join(base, 'image.png'), binaryData);
+}
+async function populateTestDir(base) {
+    await Promise.all([
+        writeReadme(base),
+        writeSourceFiles(base),
+        writeDocs(base),
+        writeHidden(base),
+        writeMultiline(base),
+        writeBinary(base),
+    ]);
+}
+async function createFixture() {
+    const testDir = await createBaseDir();
+    await createDirectories(testDir);
+    await populateTestDir(testDir);
+    setAllowedDirectories([normalizePath(testDir)]);
+    return { testDir };
+}
+async function cleanupFixture(testDir) {
+    try {
+        await fs.rm(testDir, { recursive: true, force: true });
+    }
+    catch {
+        // ignore cleanup errors
+    }
+}
+let activeUsers = 0;
+let fixturePromise = null;
+let sharedFixture = null;
+export async function acquireFileOpsFixture() {
+    activeUsers += 1;
+    fixturePromise ??= createFixture();
+    sharedFixture = await fixturePromise;
+    return sharedFixture;
+}
+export async function releaseFileOpsFixture() {
+    if (activeUsers === 0)
+        return;
+    activeUsers -= 1;
+    if (activeUsers !== 0 || !sharedFixture)
+        return;
+    const { testDir } = sharedFixture;
+    sharedFixture = null;
+    fixturePromise = null;
+    await cleanupFixture(testDir);
+}
+//# sourceMappingURL=file-ops-fixture.js.map

package/dist/__tests__/lib/fixtures/file-ops-fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-ops-fixture.js","sourceRoot":"","sources":["../../../../src/__tests__/lib/fixtures/file-ops-fixture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAMxE,MAAM,eAAe,GAAG,mBAAmB,CAAC;AAE5C,KAAK,UAAU,aAAa;IAC1B,OAAO,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,IAAY;IAC3C,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAChC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACjC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;KACrC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,IAAY;IACrC,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,EAC5B,mCAAmC,CACpC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,IAAY;IAC1C,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,EAAE,CAAC,SAAS,CACV,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,EAClC,iCAAiC,CAClC;QACD,EAAE,CAAC,SAAS,CACV,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,EAClC,+DAA+D,CAChE;KACF,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAY;IACnC,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EACnC,gCAAgC,CACjC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,IAAY;IACrC,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,CAAC,EACxC,gBAAgB,CACjB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,IAAY;IACxC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CACvE,IAAI,CACL,CAAC;IACF,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,IAAY;IACrC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC;QAC7B,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;KAC3D,CAAC,CAAC;IACH,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,UAAU,CAAC,CAAC;AAC/D,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,IAAY;IACzC,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,WAAW,CAAC,IAAI,CAAC;QACjB,gBAAgB,CAAC,IAAI,CAAC;QACtB,SAAS,CAAC,IAAI,CAAC;QACf,WAAW,CAAC,IAAI,CAAC;QACjB,cAAc,CAAC,IAAI,CAAC;QACpB,WAAW,CAAC,IAAI,CAAC;KAClB,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,aAAa;IAC1B,MAAM,OAAO,GAAG,MAAM,aAAa,EAAE,CAAC;IACtC,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACjC,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;IAC/B,qBAAqB,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAChD,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,OAAe;IAC3C,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,wBAAwB;IAC1B,CAAC;AACH,CAAC;AAED,IAAI,WAAW,GAAG,CAAC,CAAC;AACpB,IAAI,cAAc,GAAmC,IAAI,CAAC;AAC1D,IAAI,aAAa,GAA0B,IAAI,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,WAAW,IAAI,CAAC,CAAC;IACjB,cAAc,KAAK,aAAa,EAAE,CAAC;IACnC,aAAa,GAAG,MAAM,cAAc,CAAC;IACrC,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,IAAI,WAAW,KAAK,CAAC;QAAE,OAAO;IAC9B,WAAW,IAAI,CAAC,CAAC;IACjB,IAAI,WAAW,KAAK,CAAC,IAAI,CAAC,aAAa;QAAE,OAAO;IAChD,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,CAAC;IAClC,aAAa,GAAG,IAAI,CAAC;IACrB,cAAc,GAAG,IAAI,CAAC;IACtB,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC"}

package/dist/__tests__/lib/fixtures/file-ops-hooks.d.ts

@@ -0,0 +1,2 @@
+export declare function useFileOpsFixture(): () => string;
+//# sourceMappingURL=file-ops-hooks.d.ts.map

package/dist/__tests__/lib/fixtures/file-ops-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-ops-hooks.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/lib/fixtures/file-ops-hooks.ts"],"names":[],"mappings":"AAOA,wBAAgB,iBAAiB,IAAI,MAAM,MAAM,CAShD"}

package/dist/__tests__/lib/fixtures/file-ops-hooks.js

@@ -0,0 +1,13 @@
+import { afterAll, beforeAll } from 'vitest';
+import { acquireFileOpsFixture, releaseFileOpsFixture, } from './file-ops-fixture.js';
+export function useFileOpsFixture() {
+    let testDir = '';
+    beforeAll(async () => {
+        ({ testDir } = await acquireFileOpsFixture());
+    });
+    afterAll(async () => {
+        await releaseFileOpsFixture();
+    });
+    return () => testDir;
+}
+//# sourceMappingURL=file-ops-hooks.js.map

package/dist/__tests__/lib/fixtures/file-ops-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-ops-hooks.js","sourceRoot":"","sources":["../../../../src/__tests__/lib/fixtures/file-ops-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAE7C,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,UAAU,iBAAiB;IAC/B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,CAAC,EAAE,OAAO,EAAE,GAAG,MAAM,qBAAqB,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,KAAK,IAAI,EAAE;QAClB,MAAM,qBAAqB,EAAE,CAAC;IAChC,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC;AACvB,CAAC"}

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

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

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

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

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

@@ -0,0 +1,15 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { expect, it } from 'vitest';
+import { getFileType } from '../../../lib/fs-helpers.js';
+import { useFileOpsFixture } from '../fixtures/file-ops-hooks.js';
+const getTestDir = useFileOpsFixture();
+it('getFileType identifies files', async () => {
+    const stats = await fs.stat(path.join(getTestDir(), 'README.md'));
+    expect(getFileType(stats)).toBe('file');
+});
+it('getFileType identifies directories', async () => {
+    const stats = await fs.stat(getTestDir());
+    expect(getFileType(stats)).toBe('directory');
+});
+//# sourceMappingURL=file-type.test.js.map

package/dist/__tests__/lib/fs-helpers/file-type.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-type.test.js","sourceRoot":"","sources":["../../../../src/__tests__/lib/fs-helpers/file-type.test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;AAEvC,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;IAC5C,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC;IAClE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;IAClD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAC1C,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AAC/C,CAAC,CAAC,CAAC"}

package/dist/__tests__/lib/fs-helpers/head-file-edge-cases.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=head-file-edge-cases.test.d.ts.map

package/dist/__tests__/lib/fs-helpers/head-file-edge-cases.test.d.ts.map

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

package/dist/__tests__/lib/fs-helpers/head-file-edge-cases.test.js

@@ -0,0 +1,19 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { expect, it } from 'vitest';
+import { headFile } from '../../../lib/fs-helpers.js';
+import { useFileOpsFixture } from '../fixtures/file-ops-hooks.js';
+const getTestDir = useFileOpsFixture();
+it('headFile handles requesting more lines than file has', async () => {
+    const content = await headFile(path.join(getTestDir(), 'multiline.txt'), 200);
+    const lines = content.split('\n');
+    expect(lines.length).toBe(100);
+});
+it('headFile handles empty file', async () => {
+    const emptyFile = path.join(getTestDir(), 'empty-head.txt');
+    await fs.writeFile(emptyFile, '');
+    const content = await headFile(emptyFile, 5);
+    expect(content).toBe('');
+    await fs.rm(emptyFile);
+});
+//# sourceMappingURL=head-file-edge-cases.test.js.map

package/dist/__tests__/lib/fs-helpers/head-file-edge-cases.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"head-file-edge-cases.test.js","sourceRoot":"","sources":["../../../../src/__tests__/lib/fs-helpers/head-file-edge-cases.test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;AAEvC,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;IACpE,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,eAAe,CAAC,EAAE,GAAG,CAAC,CAAC;IAC9E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;IAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAC5D,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAElC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAC7C,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEzB,MAAM,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;AACzB,CAAC,CAAC,CAAC"}

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

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

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

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

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

@@ -0,0 +1,12 @@
+import * as path from 'node:path';
+import { expect, it } from 'vitest';
+import { headFile } from '../../../lib/fs-helpers.js';
+import { useFileOpsFixture } from '../fixtures/file-ops-hooks.js';
+const getTestDir = useFileOpsFixture();
+it('headFile returns first N lines', async () => {
+    const content = await headFile(path.join(getTestDir(), 'multiline.txt'), 5);
+    const lines = content.split('\n');
+    expect(lines[0]).toBe('Line 1');
+    expect(lines.length).toBeLessThanOrEqual(5);
+});
+//# sourceMappingURL=head-file.test.js.map

package/dist/__tests__/lib/fs-helpers/head-file.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"head-file.test.js","sourceRoot":"","sources":["../../../../src/__tests__/lib/fs-helpers/head-file.test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;AAEvC,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;IAC9C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC"}

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

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

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

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

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

@@ -0,0 +1,7 @@
+import { expect, it } from 'vitest';
+import { isHidden } from '../../../lib/fs-helpers.js';
+it('isHidden identifies hidden files', () => {
+    expect(isHidden('.git')).toBe(true);
+    expect(isHidden('file.txt')).toBe(false);
+});
+//# sourceMappingURL=is-hidden.test.js.map

package/dist/__tests__/lib/fs-helpers/is-hidden.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-hidden.test.js","sourceRoot":"","sources":["../../../../src/__tests__/lib/fs-helpers/is-hidden.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;IAC1C,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3C,CAAC,CAAC,CAAC"}

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

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

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

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