@j0hanz/filesystem-context-mcp 1.2.9 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (222) hide show
  1. package/README.md +73 -19
  2. package/dist/__tests__/lib/file-operations/compute-checksums.test.d.ts +2 -0
  3. package/dist/__tests__/lib/file-operations/compute-checksums.test.d.ts.map +1 -0
  4. package/dist/__tests__/lib/file-operations/compute-checksums.test.js +59 -0
  5. package/dist/__tests__/lib/file-operations/compute-checksums.test.js.map +1 -0
  6. package/dist/__tests__/lib/file-operations/get-multiple-file-info.test.d.ts +2 -0
  7. package/dist/__tests__/lib/file-operations/get-multiple-file-info.test.d.ts.map +1 -0
  8. package/dist/__tests__/lib/file-operations/get-multiple-file-info.test.js +46 -0
  9. package/dist/__tests__/lib/file-operations/get-multiple-file-info.test.js.map +1 -0
  10. package/dist/__tests__/lib/file-operations/search-definitions.test.js +179 -195
  11. package/dist/__tests__/lib/file-operations/search-definitions.test.js.map +1 -1
  12. package/dist/__tests__/lib/file-operations/sorting.test.d.ts +2 -0
  13. package/dist/__tests__/lib/file-operations/sorting.test.d.ts.map +1 -0
  14. package/dist/__tests__/lib/file-operations/sorting.test.js +47 -0
  15. package/dist/__tests__/lib/file-operations/sorting.test.js.map +1 -0
  16. package/dist/__tests__/lib/fs-helpers/utf8.test.d.ts +2 -0
  17. package/dist/__tests__/lib/fs-helpers/utf8.test.d.ts.map +1 -0
  18. package/dist/__tests__/lib/fs-helpers/utf8.test.js +43 -0
  19. package/dist/__tests__/lib/fs-helpers/utf8.test.js.map +1 -0
  20. package/dist/__tests__/lib/path-validation-errors.test.d.ts +2 -0
  21. package/dist/__tests__/lib/path-validation-errors.test.d.ts.map +1 -0
  22. package/dist/__tests__/lib/path-validation-errors.test.js +35 -0
  23. package/dist/__tests__/lib/path-validation-errors.test.js.map +1 -0
  24. package/dist/__tests__/lib/path-validation-roots.test.d.ts +2 -0
  25. package/dist/__tests__/lib/path-validation-roots.test.d.ts.map +1 -0
  26. package/dist/__tests__/lib/path-validation-roots.test.js +42 -0
  27. package/dist/__tests__/lib/path-validation-roots.test.js.map +1 -0
  28. package/dist/__tests__/lib/path-validation.test.js +5 -0
  29. package/dist/__tests__/lib/path-validation.test.js.map +1 -1
  30. package/dist/__tests__/security/filesystem-boundary.test.js +20 -12
  31. package/dist/__tests__/security/filesystem-boundary.test.js.map +1 -1
  32. package/dist/config/types.d.ts +31 -0
  33. package/dist/config/types.d.ts.map +1 -1
  34. package/dist/config/types.js.map +1 -1
  35. package/dist/instructions.md +46 -17
  36. package/dist/lib/constants.d.ts.map +1 -1
  37. package/dist/lib/constants.js +17 -1
  38. package/dist/lib/constants.js.map +1 -1
  39. package/dist/lib/file-operations/analyze-directory-helpers.d.ts +24 -0
  40. package/dist/lib/file-operations/analyze-directory-helpers.d.ts.map +1 -0
  41. package/dist/lib/file-operations/analyze-directory-helpers.js +50 -0
  42. package/dist/lib/file-operations/analyze-directory-helpers.js.map +1 -0
  43. package/dist/lib/file-operations/analyze-directory.d.ts +1 -0
  44. package/dist/lib/file-operations/analyze-directory.d.ts.map +1 -1
  45. package/dist/lib/file-operations/analyze-directory.js +3 -58
  46. package/dist/lib/file-operations/analyze-directory.js.map +1 -1
  47. package/dist/lib/file-operations/batch-results.d.ts +12 -0
  48. package/dist/lib/file-operations/batch-results.d.ts.map +1 -0
  49. package/dist/lib/file-operations/batch-results.js +23 -0
  50. package/dist/lib/file-operations/batch-results.js.map +1 -0
  51. package/dist/lib/file-operations/compute-checksums.d.ts +9 -0
  52. package/dist/lib/file-operations/compute-checksums.d.ts.map +1 -0
  53. package/dist/lib/file-operations/compute-checksums.js +121 -0
  54. package/dist/lib/file-operations/compute-checksums.js.map +1 -0
  55. package/dist/lib/file-operations/directory-helpers.d.ts.map +1 -1
  56. package/dist/lib/file-operations/directory-helpers.js +18 -10
  57. package/dist/lib/file-operations/directory-helpers.js.map +1 -1
  58. package/dist/lib/file-operations/directory-tree-helpers.d.ts.map +1 -1
  59. package/dist/lib/file-operations/directory-tree-helpers.js +8 -1
  60. package/dist/lib/file-operations/directory-tree-helpers.js.map +1 -1
  61. package/dist/lib/file-operations/directory-tree.d.ts +1 -0
  62. package/dist/lib/file-operations/directory-tree.d.ts.map +1 -1
  63. package/dist/lib/file-operations/directory-tree.js +3 -9
  64. package/dist/lib/file-operations/directory-tree.js.map +1 -1
  65. package/dist/lib/file-operations/get-multiple-file-info.d.ts +7 -0
  66. package/dist/lib/file-operations/get-multiple-file-info.d.ts.map +1 -0
  67. package/dist/lib/file-operations/get-multiple-file-info.js +59 -0
  68. package/dist/lib/file-operations/get-multiple-file-info.js.map +1 -0
  69. package/dist/lib/file-operations/list-directory-entry.d.ts +18 -0
  70. package/dist/lib/file-operations/list-directory-entry.d.ts.map +1 -0
  71. package/dist/lib/file-operations/list-directory-entry.js +90 -0
  72. package/dist/lib/file-operations/list-directory-entry.js.map +1 -0
  73. package/dist/lib/file-operations/list-directory-helpers.d.ts +1 -0
  74. package/dist/lib/file-operations/list-directory-helpers.d.ts.map +1 -1
  75. package/dist/lib/file-operations/list-directory-helpers.js +75 -97
  76. package/dist/lib/file-operations/list-directory-helpers.js.map +1 -1
  77. package/dist/lib/file-operations/list-directory.d.ts +1 -0
  78. package/dist/lib/file-operations/list-directory.d.ts.map +1 -1
  79. package/dist/lib/file-operations/list-directory.js +3 -8
  80. package/dist/lib/file-operations/list-directory.js.map +1 -1
  81. package/dist/lib/file-operations/search/engine-options.d.ts.map +1 -1
  82. package/dist/lib/file-operations/search/engine-options.js +1 -8
  83. package/dist/lib/file-operations/search/engine-options.js.map +1 -1
  84. package/dist/lib/file-operations/search/engine.d.ts +1 -1
  85. package/dist/lib/file-operations/search/engine.d.ts.map +1 -1
  86. package/dist/lib/file-operations/search/engine.js +4 -1
  87. package/dist/lib/file-operations/search/engine.js.map +1 -1
  88. package/dist/lib/file-operations/search-content.d.ts +1 -0
  89. package/dist/lib/file-operations/search-content.d.ts.map +1 -1
  90. package/dist/lib/file-operations/search-content.js +1 -1
  91. package/dist/lib/file-operations/search-content.js.map +1 -1
  92. package/dist/lib/file-operations/search-definitions.d.ts.map +1 -1
  93. package/dist/lib/file-operations/search-definitions.js +148 -117
  94. package/dist/lib/file-operations/search-definitions.js.map +1 -1
  95. package/dist/lib/file-operations/search-files-helpers.d.ts +1 -25
  96. package/dist/lib/file-operations/search-files-helpers.d.ts.map +1 -1
  97. package/dist/lib/file-operations/search-files-helpers.js +1 -39
  98. package/dist/lib/file-operations/search-files-helpers.js.map +1 -1
  99. package/dist/lib/file-operations/search-files-options.d.ts +31 -0
  100. package/dist/lib/file-operations/search-files-options.d.ts.map +1 -0
  101. package/dist/lib/file-operations/search-files-options.js +33 -0
  102. package/dist/lib/file-operations/search-files-options.js.map +1 -0
  103. package/dist/lib/file-operations/search-files.d.ts +1 -1
  104. package/dist/lib/file-operations/search-files.d.ts.map +1 -1
  105. package/dist/lib/file-operations/search-files.js +2 -1
  106. package/dist/lib/file-operations/search-files.js.map +1 -1
  107. package/dist/lib/file-operations.d.ts +2 -0
  108. package/dist/lib/file-operations.d.ts.map +1 -1
  109. package/dist/lib/file-operations.js +2 -0
  110. package/dist/lib/file-operations.js.map +1 -1
  111. package/dist/lib/fs-helpers/binary-detect.d.ts.map +1 -1
  112. package/dist/lib/fs-helpers/binary-detect.js +13 -16
  113. package/dist/lib/fs-helpers/binary-detect.js.map +1 -1
  114. package/dist/lib/fs-helpers/readers/read-file-content.d.ts +29 -0
  115. package/dist/lib/fs-helpers/readers/read-file-content.d.ts.map +1 -0
  116. package/dist/lib/fs-helpers/readers/read-file-content.js +25 -0
  117. package/dist/lib/fs-helpers/readers/read-file-content.js.map +1 -0
  118. package/dist/lib/fs-helpers/readers/read-file.d.ts +1 -0
  119. package/dist/lib/fs-helpers/readers/read-file.d.ts.map +1 -1
  120. package/dist/lib/fs-helpers/readers/read-file.js +29 -29
  121. package/dist/lib/fs-helpers/readers/read-file.js.map +1 -1
  122. package/dist/lib/merge-defined.d.ts +2 -0
  123. package/dist/lib/merge-defined.d.ts.map +1 -0
  124. package/dist/lib/merge-defined.js +8 -0
  125. package/dist/lib/merge-defined.js.map +1 -0
  126. package/dist/lib/path-validation/validators.d.ts.map +1 -1
  127. package/dist/lib/path-validation/validators.js +8 -0
  128. package/dist/lib/path-validation/validators.js.map +1 -1
  129. package/dist/schemas/index.d.ts +2 -2
  130. package/dist/schemas/index.d.ts.map +1 -1
  131. package/dist/schemas/index.js +2 -2
  132. package/dist/schemas/index.js.map +1 -1
  133. package/dist/schemas/inputs/checksums.d.ts +10 -0
  134. package/dist/schemas/inputs/checksums.d.ts.map +1 -0
  135. package/dist/schemas/inputs/checksums.js +30 -0
  136. package/dist/schemas/inputs/checksums.js.map +1 -0
  137. package/dist/schemas/inputs/directory.d.ts +29 -0
  138. package/dist/schemas/inputs/directory.d.ts.map +1 -0
  139. package/dist/schemas/inputs/directory.js +75 -0
  140. package/dist/schemas/inputs/directory.js.map +1 -0
  141. package/dist/schemas/inputs/file-info.d.ts +9 -0
  142. package/dist/schemas/inputs/file-info.d.ts.map +1 -0
  143. package/dist/schemas/inputs/file-info.js +20 -0
  144. package/dist/schemas/inputs/file-info.js.map +1 -0
  145. package/dist/schemas/inputs/read.d.ts +26 -0
  146. package/dist/schemas/inputs/read.d.ts.map +1 -0
  147. package/dist/schemas/inputs/read.js +54 -0
  148. package/dist/schemas/inputs/read.js.map +1 -0
  149. package/dist/schemas/inputs/search.d.ts +44 -0
  150. package/dist/schemas/inputs/search.d.ts.map +1 -0
  151. package/dist/schemas/inputs/search.js +115 -0
  152. package/dist/schemas/inputs/search.js.map +1 -0
  153. package/dist/schemas/inputs.d.ts +5 -94
  154. package/dist/schemas/inputs.d.ts.map +1 -1
  155. package/dist/schemas/inputs.js +5 -227
  156. package/dist/schemas/inputs.js.map +1 -1
  157. package/dist/schemas/outputs/checksums.d.ts +93 -0
  158. package/dist/schemas/outputs/checksums.d.ts.map +1 -0
  159. package/dist/schemas/outputs/checksums.js +23 -0
  160. package/dist/schemas/outputs/checksums.js.map +1 -0
  161. package/dist/schemas/outputs/directory.d.ts +419 -0
  162. package/dist/schemas/outputs/directory.d.ts.map +1 -0
  163. package/dist/schemas/outputs/directory.js +81 -0
  164. package/dist/schemas/outputs/directory.js.map +1 -0
  165. package/dist/schemas/outputs/file-info.d.ts +270 -0
  166. package/dist/schemas/outputs/file-info.d.ts.map +1 -0
  167. package/dist/schemas/outputs/file-info.js +57 -0
  168. package/dist/schemas/outputs/file-info.js.map +1 -0
  169. package/dist/schemas/outputs/read.d.ts +187 -0
  170. package/dist/schemas/outputs/read.d.ts.map +1 -0
  171. package/dist/schemas/outputs/read.js +39 -0
  172. package/dist/schemas/outputs/read.js.map +1 -0
  173. package/dist/schemas/outputs/search.d.ts +360 -0
  174. package/dist/schemas/outputs/search.d.ts.map +1 -0
  175. package/dist/schemas/outputs/search.js +98 -0
  176. package/dist/schemas/outputs/search.js.map +1 -0
  177. package/dist/schemas/outputs.d.ts +5 -1059
  178. package/dist/schemas/outputs.d.ts.map +1 -1
  179. package/dist/schemas/outputs.js +5 -229
  180. package/dist/schemas/outputs.js.map +1 -1
  181. package/dist/server.d.ts.map +1 -1
  182. package/dist/server.js +24 -14
  183. package/dist/server.js.map +1 -1
  184. package/dist/tools/analyze-directory.d.ts.map +1 -1
  185. package/dist/tools/analyze-directory.js +2 -2
  186. package/dist/tools/analyze-directory.js.map +1 -1
  187. package/dist/tools/compute-checksums.d.ts +3 -0
  188. package/dist/tools/compute-checksums.d.ts.map +1 -0
  189. package/dist/tools/compute-checksums.js +77 -0
  190. package/dist/tools/compute-checksums.js.map +1 -0
  191. package/dist/tools/directory-tree.d.ts.map +1 -1
  192. package/dist/tools/directory-tree.js +6 -2
  193. package/dist/tools/directory-tree.js.map +1 -1
  194. package/dist/tools/get-multiple-file-info.d.ts +3 -0
  195. package/dist/tools/get-multiple-file-info.d.ts.map +1 -0
  196. package/dist/tools/get-multiple-file-info.js +95 -0
  197. package/dist/tools/get-multiple-file-info.js.map +1 -0
  198. package/dist/tools/index.d.ts.map +1 -1
  199. package/dist/tools/index.js +4 -0
  200. package/dist/tools/index.js.map +1 -1
  201. package/dist/tools/list-allowed-dirs.d.ts.map +1 -1
  202. package/dist/tools/list-allowed-dirs.js +14 -3
  203. package/dist/tools/list-allowed-dirs.js.map +1 -1
  204. package/dist/tools/list-directory.d.ts.map +1 -1
  205. package/dist/tools/list-directory.js +7 -1
  206. package/dist/tools/list-directory.js.map +1 -1
  207. package/dist/tools/read-file.d.ts.map +1 -1
  208. package/dist/tools/read-file.js +8 -0
  209. package/dist/tools/read-file.js.map +1 -1
  210. package/dist/tools/read-multiple-files.d.ts.map +1 -1
  211. package/dist/tools/read-multiple-files.js +7 -1
  212. package/dist/tools/read-multiple-files.js.map +1 -1
  213. package/dist/tools/search-definitions.d.ts.map +1 -1
  214. package/dist/tools/search-definitions.js +48 -34
  215. package/dist/tools/search-definitions.js.map +1 -1
  216. package/dist/tools/search-files.d.ts.map +1 -1
  217. package/dist/tools/search-files.js +6 -2
  218. package/dist/tools/search-files.js.map +1 -1
  219. package/dist/tools/shared/search-formatting.d.ts.map +1 -1
  220. package/dist/tools/shared/search-formatting.js +4 -1
  221. package/dist/tools/shared/search-formatting.js.map +1 -1
  222. package/package.json +1 -1
package/README.md CHANGED
@@ -43,6 +43,8 @@ A secure, read-only MCP server for filesystem scanning, searching, and analysis
43
43
  | Read source code | `read_file` |
44
44
  | Batch read multiple files | `read_multiple_files` |
45
45
  | Get file metadata (size, dates) | `get_file_info` |
46
+ | Batch get file metadata | `get_multiple_file_info` |
47
+ | Compute file checksums/hashes | `compute_checksums` |
46
48
  | Read images or binary files | `read_media_file` |
47
49
  | Check available directories | `list_allowed_directories` |
48
50
 
@@ -194,15 +196,17 @@ List all directories that this server is allowed to access.
194
196
 
195
197
  List contents of a directory with optional recursive listing.
196
198
 
197
- | Parameter | Type | Required | Default | Description |
198
- | ----------------------- | ------- | -------- | ------- | ------------------------------------------- |
199
- | `path` | string | | - | Directory path to list |
200
- | `recursive` | boolean | | `false` | List recursively |
201
- | `includeHidden` | boolean | | `false` | Include hidden files |
202
- | `maxDepth` | number | | `10` | Maximum depth for recursive listing (0-100) |
203
- | `maxEntries` | number | | `10000` | Maximum entries to return (1-100,000) |
204
- | `sortBy` | string | | `name` | Sort by: `name`, `size`, `modified`, `type` |
205
- | `includeSymlinkTargets` | boolean | | `false` | Include symlink target paths |
199
+ | Parameter | Type | Required | Default | Description |
200
+ | ----------------------- | -------- | -------- | ------- | ------------------------------------------- |
201
+ | `path` | string | ? | - | Directory path to list |
202
+ | `recursive` | boolean | ? | `false` | List recursively |
203
+ | `includeHidden` | boolean | ? | `false` | Include hidden files |
204
+ | `excludePatterns` | string[] | ? | `[]` | Patterns to exclude |
205
+ | `pattern` | string | ? | - | Glob pattern to include |
206
+ | `maxDepth` | number | ? | `10` | Maximum depth for recursive listing (0-100) |
207
+ | `maxEntries` | number | ? | `10000` | Maximum entries to return (1-100,000) |
208
+ | `sortBy` | string | ? | `name` | Sort by: `name`, `size`, `modified`, `type` |
209
+ | `includeSymlinkTargets` | boolean | ? | `false` | Include symlink target paths |
206
210
 
207
211
  **Returns:** List of entries with name, type, size, and modified date.
208
212
 
@@ -210,7 +214,7 @@ List contents of a directory with optional recursive listing.
210
214
 
211
215
  ### `search_files`
212
216
 
213
- Search for files using glob patterns.
217
+ Search for files (not directories) using glob patterns.
214
218
 
215
219
  | Parameter | Type | Required | Default | Description |
216
220
  | ----------------- | -------- | -------- | ------- | --------------------------------------------- |
@@ -241,15 +245,16 @@ Search for files using glob patterns.
241
245
 
242
246
  Read the contents of a text file.
243
247
 
244
- | Parameter | Type | Required | Default | Description |
245
- | ----------- | ------ | -------- | ------- | ---------------------------------------------------------- |
246
- | `path` | string | | - | File path to read |
247
- | `encoding` | string | | `utf-8` | File encoding (`utf-8`, `ascii`, `base64`, etc.) |
248
- | `maxSize` | number | | 10MB | Maximum file size in bytes |
249
- | `lineStart` | number | | - | Start line (1-indexed, min 1) for reading a range |
250
- | `lineEnd` | number | | - | End line (1-indexed, inclusive, min 1) for reading a range |
251
- | `head` | number | | - | Read only first N lines |
252
- | `tail` | number | | - | Read only last N lines |
248
+ | Parameter | Type | Required | Default | Description |
249
+ | ------------ | ------- | -------- | ------- | ---------------------------------------------------------- |
250
+ | `path` | string | ? | - | File path to read |
251
+ | `encoding` | string | ? | `utf-8` | File encoding (`utf-8`, `ascii`, `base64`, etc.) |
252
+ | `maxSize` | number | ? | 10MB | Maximum file size in bytes |
253
+ | `skipBinary` | boolean | ? | `false` | Reject binary files (use `read_media_file` instead) |
254
+ | `lineStart` | number | ? | - | Start line (1-indexed, min 1) for reading a range |
255
+ | `lineEnd` | number | ? | - | End line (1-indexed, inclusive, min 1) for reading a range |
256
+ | `head` | number | ? | - | Read only first N lines |
257
+ | `tail` | number | ? | - | Read only last N lines |
253
258
 
254
259
  > **Note:** Cannot specify both `head` and `tail` simultaneously. Use `lineStart`/`lineEnd` for range reading.
255
260
 
@@ -261,6 +266,55 @@ Read the contents of a text file.
261
266
 
262
267
  Read multiple files in parallel for efficient batch operations.
263
268
 
269
+ | Parameter | Type | Required | Default | Description |
270
+ | -------------- | -------- | -------- | ------- | ------------------------------------------ |
271
+ | `paths` | string[] | ✅ | - | Array of file paths to read (max 100) |
272
+ | `encoding` | string | ❌ | `utf-8` | File encoding |
273
+ | `maxSize` | number | ❌ | 10MB | Maximum size per file in bytes |
274
+ | `maxTotalSize` | number | ❌ | 100MB | Maximum total size for all files combined |
275
+ | `head` | number | ❌ | - | Read only first N lines of each file |
276
+ | `tail` | number | ❌ | - | Read only last N lines of each file |
277
+ | `lineStart` | number | ❌ | - | Start line (1-indexed) for reading a range |
278
+ | `lineEnd` | number | ❌ | - | End line (inclusive) for reading a range |
279
+
280
+ **Returns:** Array of file contents with individual success/error status.
281
+
282
+ ---
283
+
284
+ ### `get_multiple_file_info`
285
+
286
+ Get metadata for multiple files/directories in parallel.
287
+
288
+ | Parameter | Type | Required | Default | Description |
289
+ | ----------------- | -------- | -------- | ------- | --------------------------------- |
290
+ | `paths` | string[] | ✅ | - | Array of paths to query (max 100) |
291
+ | `includeMimeType` | boolean | ❌ | `true` | Include MIME type detection |
292
+
293
+ **Returns:** Array of file info (name, path, type, size, timestamps, permissions, mimeType) with individual success/error status, plus summary.
294
+
295
+ ---
296
+
297
+ ### `compute_checksums`
298
+
299
+ Compute cryptographic checksums for files using memory-efficient streaming.
300
+
301
+ | Parameter | Type | Required | Default | Description |
302
+ | ------------- | -------- | -------- | -------- | ------------------------------------------------- |
303
+ | `paths` | string[] | ✅ | - | Array of file paths (max 50) |
304
+ | `algorithm` | string | ❌ | `sha256` | Hash algorithm: `md5`, `sha1`, `sha256`, `sha512` |
305
+ | `encoding` | string | ❌ | `hex` | Output encoding: `hex` or `base64` |
306
+ | `maxFileSize` | number | ❌ | 100MB | Skip files larger than this |
307
+
308
+ **Returns:** Array of checksums with file sizes, plus summary (total, succeeded, failed).
309
+
310
+ **Use cases:**
311
+
312
+ - Verify file integrity after transfers
313
+ - Detect duplicate files by comparing hashes
314
+ - Generate checksums for release artifacts
315
+
316
+ ---
317
+
264
318
  | Parameter | Type | Required | Default | Description |
265
319
  | -------------- | -------- | -------- | ------- | ----------------------------------------- |
266
320
  | `paths` | string[] | ✅ | - | Array of file paths (max 100) |
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=compute-checksums.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compute-checksums.test.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/lib/file-operations/compute-checksums.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,59 @@
1
+ import * as fs from 'node:fs/promises';
2
+ import * as os from 'node:os';
3
+ import * as path from 'node:path';
4
+ import { afterAll, beforeAll, expect, it } from 'vitest';
5
+ import { computeChecksums } from '../../../lib/file-operations.js';
6
+ import { setAllowedDirectoriesResolved } from '../../../lib/path-validation.js';
7
+ let tempDir;
8
+ let testFile1;
9
+ let testFile2;
10
+ beforeAll(async () => {
11
+ tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'checksum-test-'));
12
+ testFile1 = path.join(tempDir, 'file1.txt');
13
+ testFile2 = path.join(tempDir, 'file2.txt');
14
+ await fs.writeFile(testFile1, 'Hello World');
15
+ await fs.writeFile(testFile2, 'Hello World'); // Same content
16
+ await setAllowedDirectoriesResolved([tempDir]);
17
+ });
18
+ afterAll(async () => {
19
+ await fs.rm(tempDir, { recursive: true, force: true });
20
+ });
21
+ it('should compute SHA-256 checksums by default', async () => {
22
+ const result = await computeChecksums([testFile1]);
23
+ expect(result.summary.total).toBe(1);
24
+ expect(result.summary.succeeded).toBe(1);
25
+ expect(result.results[0]?.checksum).toBeDefined();
26
+ expect(result.results[0]?.algorithm).toBe('sha256');
27
+ expect(result.results[0]?.checksum).toHaveLength(64); // SHA-256 hex is 64 chars
28
+ });
29
+ it('should detect identical content with same checksum', async () => {
30
+ const result = await computeChecksums([testFile1, testFile2]);
31
+ expect(result.summary.succeeded).toBe(2);
32
+ expect(result.results[0]?.checksum).toBe(result.results[1]?.checksum);
33
+ });
34
+ it('should support different algorithms', async () => {
35
+ const md5Result = await computeChecksums([testFile1], { algorithm: 'md5' });
36
+ const sha512Result = await computeChecksums([testFile1], {
37
+ algorithm: 'sha512',
38
+ });
39
+ expect(md5Result.results[0]?.checksum).toHaveLength(32); // MD5 hex
40
+ expect(sha512Result.results[0]?.checksum).toHaveLength(128); // SHA-512 hex
41
+ });
42
+ it('should support base64 encoding', async () => {
43
+ const result = await computeChecksums([testFile1], { encoding: 'base64' });
44
+ expect(result.results[0]?.checksum).toMatch(/^[A-Za-z0-9+/=]+$/);
45
+ });
46
+ it('should handle non-existent files gracefully', async () => {
47
+ const nonExistent = path.join(tempDir, 'nonexistent.txt');
48
+ const result = await computeChecksums([testFile1, nonExistent]);
49
+ expect(result.summary.succeeded).toBe(1);
50
+ expect(result.summary.failed).toBe(1);
51
+ const errorResult = result.results.find((r) => r.path === nonExistent);
52
+ expect(errorResult?.error).toBeDefined();
53
+ });
54
+ it('should return empty result for empty array', async () => {
55
+ const result = await computeChecksums([]);
56
+ expect(result.summary.total).toBe(0);
57
+ expect(result.results).toHaveLength(0);
58
+ });
59
+ //# sourceMappingURL=compute-checksums.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compute-checksums.test.js","sourceRoot":"","sources":["../../../../src/__tests__/lib/file-operations/compute-checksums.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=get-multiple-file-info.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-multiple-file-info.test.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/lib/file-operations/get-multiple-file-info.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,46 @@
1
+ import * as fs from 'node:fs/promises';
2
+ import * as os from 'node:os';
3
+ import * as path from 'node:path';
4
+ import { afterAll, beforeAll, expect, it } from 'vitest';
5
+ import { getMultipleFileInfo } from '../../../lib/file-operations.js';
6
+ import { setAllowedDirectoriesResolved } from '../../../lib/path-validation.js';
7
+ let tempDir;
8
+ let testFile1;
9
+ let testFile2;
10
+ beforeAll(async () => {
11
+ tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'mfi-test-'));
12
+ testFile1 = path.join(tempDir, 'file1.txt');
13
+ testFile2 = path.join(tempDir, 'file2.json');
14
+ await fs.writeFile(testFile1, 'Hello World');
15
+ await fs.writeFile(testFile2, '{"key": "value"}');
16
+ await setAllowedDirectoriesResolved([tempDir]);
17
+ });
18
+ afterAll(async () => {
19
+ await fs.rm(tempDir, { recursive: true, force: true });
20
+ });
21
+ it('should return info for multiple files', async () => {
22
+ const result = await getMultipleFileInfo([testFile1, testFile2]);
23
+ expect(result.summary.total).toBe(2);
24
+ expect(result.summary.succeeded).toBe(2);
25
+ expect(result.summary.failed).toBe(0);
26
+ expect(result.results).toHaveLength(2);
27
+ const info1 = result.results.find((r) => r.path === testFile1)?.info;
28
+ expect(info1).toBeDefined();
29
+ expect(info1?.name).toBe('file1.txt');
30
+ expect(info1?.type).toBe('file');
31
+ });
32
+ it('should handle non-existent files gracefully', async () => {
33
+ const nonExistent = path.join(tempDir, 'nonexistent.txt');
34
+ const result = await getMultipleFileInfo([testFile1, nonExistent]);
35
+ expect(result.summary.total).toBe(2);
36
+ expect(result.summary.succeeded).toBe(1);
37
+ expect(result.summary.failed).toBe(1);
38
+ const errorResult = result.results.find((r) => r.path === nonExistent);
39
+ expect(errorResult?.error).toBeDefined();
40
+ });
41
+ it('should return empty result for empty array', async () => {
42
+ const result = await getMultipleFileInfo([]);
43
+ expect(result.summary.total).toBe(0);
44
+ expect(result.results).toHaveLength(0);
45
+ });
46
+ //# sourceMappingURL=get-multiple-file-info.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-multiple-file-info.test.js","sourceRoot":"","sources":["../../../../src/__tests__/lib/file-operations/get-multiple-file-info.test.ts"],"names":[],"mappings":"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"}