@fgv/ts-web-extras 5.1.0-4 → 5.1.0-40

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 (424) hide show
  1. package/dist/packlets/crypto-utils/browserCryptoProvider.js +330 -18
  2. package/dist/packlets/crypto-utils/browserCryptoProvider.js.map +1 -1
  3. package/dist/packlets/crypto-utils/idbPrivateKeyStorage.js +238 -0
  4. package/dist/packlets/crypto-utils/idbPrivateKeyStorage.js.map +1 -0
  5. package/dist/packlets/crypto-utils/index.js +13 -0
  6. package/dist/packlets/crypto-utils/index.js.map +1 -1
  7. package/dist/packlets/file-tree/directoryHandleStore.js.map +1 -1
  8. package/dist/packlets/file-tree/fileApiTreeAccessors.js +1 -1
  9. package/dist/packlets/file-tree/fileApiTreeAccessors.js.map +1 -1
  10. package/dist/packlets/file-tree/fileSystemAccessTreeAccessors.js +2 -2
  11. package/dist/packlets/file-tree/fileSystemAccessTreeAccessors.js.map +1 -1
  12. package/dist/packlets/file-tree/httpTreeAccessors.js +74 -44
  13. package/dist/packlets/file-tree/httpTreeAccessors.js.map +1 -1
  14. package/dist/packlets/file-tree/localStorageTreeAccessors.js.map +1 -1
  15. package/dist/packlets/helpers/fileTreeHelpers.js +1 -1
  16. package/dist/packlets/helpers/fileTreeHelpers.js.map +1 -1
  17. package/dist/ts-web-extras.d.ts +229 -10
  18. package/dist/tsdoc-metadata.json +1 -1
  19. package/eslint.config.js +32 -0
  20. package/lib/packlets/crypto-utils/browserCryptoProvider.d.ts +115 -6
  21. package/lib/packlets/crypto-utils/browserCryptoProvider.d.ts.map +1 -1
  22. package/lib/packlets/crypto-utils/browserCryptoProvider.js +329 -17
  23. package/lib/packlets/crypto-utils/browserCryptoProvider.js.map +1 -1
  24. package/lib/packlets/crypto-utils/idbPrivateKeyStorage.d.ts +87 -0
  25. package/lib/packlets/crypto-utils/idbPrivateKeyStorage.d.ts.map +1 -0
  26. package/lib/packlets/crypto-utils/idbPrivateKeyStorage.js +242 -0
  27. package/lib/packlets/crypto-utils/idbPrivateKeyStorage.js.map +1 -0
  28. package/lib/packlets/crypto-utils/index.d.ts +14 -0
  29. package/lib/packlets/crypto-utils/index.d.ts.map +1 -1
  30. package/lib/packlets/crypto-utils/index.js +14 -0
  31. package/lib/packlets/crypto-utils/index.js.map +1 -1
  32. package/lib/packlets/file-tree/directoryHandleStore.d.ts +2 -2
  33. package/lib/packlets/file-tree/directoryHandleStore.d.ts.map +1 -1
  34. package/lib/packlets/file-tree/directoryHandleStore.js.map +1 -1
  35. package/lib/packlets/file-tree/fileApiTreeAccessors.d.ts +2 -2
  36. package/lib/packlets/file-tree/fileApiTreeAccessors.d.ts.map +1 -1
  37. package/lib/packlets/file-tree/fileApiTreeAccessors.js +1 -1
  38. package/lib/packlets/file-tree/fileApiTreeAccessors.js.map +1 -1
  39. package/lib/packlets/file-tree/fileSystemAccessTreeAccessors.d.ts.map +1 -1
  40. package/lib/packlets/file-tree/fileSystemAccessTreeAccessors.js +2 -2
  41. package/lib/packlets/file-tree/fileSystemAccessTreeAccessors.js.map +1 -1
  42. package/lib/packlets/file-tree/httpTreeAccessors.d.ts +6 -0
  43. package/lib/packlets/file-tree/httpTreeAccessors.d.ts.map +1 -1
  44. package/lib/packlets/file-tree/httpTreeAccessors.js +74 -44
  45. package/lib/packlets/file-tree/httpTreeAccessors.js.map +1 -1
  46. package/lib/packlets/file-tree/localStorageTreeAccessors.js.map +1 -1
  47. package/lib/packlets/helpers/fileTreeHelpers.d.ts +1 -1
  48. package/lib/packlets/helpers/fileTreeHelpers.d.ts.map +1 -1
  49. package/lib/packlets/helpers/fileTreeHelpers.js +6 -6
  50. package/lib/packlets/helpers/fileTreeHelpers.js.map +1 -1
  51. package/package.json +15 -14
  52. package/.rush/temp/44b0369e8112f3c6f4248af466a3f35ad626d9d7.tar.log +0 -237
  53. package/.rush/temp/chunked-rush-logs/ts-web-extras.build.chunks.jsonl +0 -55
  54. package/.rush/temp/operation/build/all.log +0 -55
  55. package/.rush/temp/operation/build/log-chunks.jsonl +0 -55
  56. package/.rush/temp/operation/build/state.json +0 -3
  57. package/.rush/temp/shrinkwrap-deps.json +0 -692
  58. package/CHANGELOG.md +0 -23
  59. package/config/api-extractor.json +0 -343
  60. package/config/jest.config.json +0 -19
  61. package/config/rig.json +0 -16
  62. package/config/typedoc.json +0 -7
  63. package/dist/test/mocks/idb-keyval.js +0 -6
  64. package/dist/test/mocks/idb-keyval.js.map +0 -1
  65. package/dist/test/setupTests.js +0 -74
  66. package/dist/test/setupTests.js.map +0 -1
  67. package/dist/test/unit/browserHashProvider.test.js +0 -140
  68. package/dist/test/unit/browserHashProvider.test.js.map +0 -1
  69. package/dist/test/unit/directoryHandleStore.test.js +0 -190
  70. package/dist/test/unit/directoryHandleStore.test.js.map +0 -1
  71. package/dist/test/unit/fileApiTreeAccessors.test.js +0 -1188
  72. package/dist/test/unit/fileApiTreeAccessors.test.js.map +0 -1
  73. package/dist/test/unit/fileApiTypes.test.js +0 -472
  74. package/dist/test/unit/fileApiTypes.test.js.map +0 -1
  75. package/dist/test/unit/fileSystemAccessTreeAccessors.test.js +0 -622
  76. package/dist/test/unit/fileSystemAccessTreeAccessors.test.js.map +0 -1
  77. package/dist/test/unit/fileTreeHelpers.test.js +0 -590
  78. package/dist/test/unit/fileTreeHelpers.test.js.map +0 -1
  79. package/dist/test/unit/httpTreeAccessors.test.js +0 -1229
  80. package/dist/test/unit/httpTreeAccessors.test.js.map +0 -1
  81. package/dist/test/unit/localStorageTreeAccessors.test.js +0 -812
  82. package/dist/test/unit/localStorageTreeAccessors.test.js.map +0 -1
  83. package/dist/test/unit/urlParams.test.js +0 -393
  84. package/dist/test/unit/urlParams.test.js.map +0 -1
  85. package/dist/test/utils/fileSystemAccessMocks.js +0 -271
  86. package/dist/test/utils/fileSystemAccessMocks.js.map +0 -1
  87. package/dist/test/utils/testHelpers.js +0 -124
  88. package/dist/test/utils/testHelpers.js.map +0 -1
  89. package/docs/CryptoUtils/README.md +0 -60
  90. package/docs/CryptoUtils/classes/BrowserCryptoProvider.decrypt.md +0 -27
  91. package/docs/CryptoUtils/classes/BrowserCryptoProvider.deriveKey.md +0 -26
  92. package/docs/CryptoUtils/classes/BrowserCryptoProvider.encrypt.md +0 -25
  93. package/docs/CryptoUtils/classes/BrowserCryptoProvider.fromBase64.md +0 -24
  94. package/docs/CryptoUtils/classes/BrowserCryptoProvider.generateKey.md +0 -17
  95. package/docs/CryptoUtils/classes/BrowserCryptoProvider.generateRandomBytes.md +0 -24
  96. package/docs/CryptoUtils/classes/BrowserCryptoProvider.md +0 -151
  97. package/docs/CryptoUtils/classes/BrowserCryptoProvider.toBase64.md +0 -24
  98. package/docs/CryptoUtils/classes/BrowserHashProvider.hashParts.md +0 -26
  99. package/docs/CryptoUtils/classes/BrowserHashProvider.hashString.md +0 -25
  100. package/docs/CryptoUtils/classes/BrowserHashProvider.md +0 -81
  101. package/docs/CryptoUtils/functions/createBrowserCryptoProvider.md +0 -12
  102. package/docs/FileTreeHelpers/README.md +0 -85
  103. package/docs/FileTreeHelpers/functions/extractFileListMetadata.md +0 -11
  104. package/docs/FileTreeHelpers/functions/extractFileMetadata.md +0 -11
  105. package/docs/FileTreeHelpers/functions/fromDirectoryUpload.md +0 -12
  106. package/docs/FileTreeHelpers/functions/fromFileList.md +0 -12
  107. package/docs/FileTreeHelpers/functions/getOriginalFile.md +0 -11
  108. package/docs/FileTreeHelpers/variables/defaultFileApiTreeInitParams.md +0 -9
  109. package/docs/README.md +0 -524
  110. package/docs/classes/BrowserCryptoProvider.decrypt.md +0 -27
  111. package/docs/classes/BrowserCryptoProvider.deriveKey.md +0 -26
  112. package/docs/classes/BrowserCryptoProvider.encrypt.md +0 -25
  113. package/docs/classes/BrowserCryptoProvider.fromBase64.md +0 -24
  114. package/docs/classes/BrowserCryptoProvider.generateKey.md +0 -17
  115. package/docs/classes/BrowserCryptoProvider.generateRandomBytes.md +0 -24
  116. package/docs/classes/BrowserCryptoProvider.md +0 -151
  117. package/docs/classes/BrowserCryptoProvider.toBase64.md +0 -24
  118. package/docs/classes/BrowserHashProvider.hashParts.md +0 -26
  119. package/docs/classes/BrowserHashProvider.hashString.md +0 -25
  120. package/docs/classes/BrowserHashProvider.md +0 -81
  121. package/docs/classes/DirectoryHandleStore.getAll.md +0 -17
  122. package/docs/classes/DirectoryHandleStore.getAllLabels.md +0 -17
  123. package/docs/classes/DirectoryHandleStore.load.md +0 -24
  124. package/docs/classes/DirectoryHandleStore.md +0 -120
  125. package/docs/classes/DirectoryHandleStore.remove.md +0 -24
  126. package/docs/classes/DirectoryHandleStore.save.md +0 -25
  127. package/docs/classes/FileApiTreeAccessors.create.md +0 -25
  128. package/docs/classes/FileApiTreeAccessors.createFromHttp.md +0 -24
  129. package/docs/classes/FileApiTreeAccessors.createFromLocalStorage.md +0 -25
  130. package/docs/classes/FileApiTreeAccessors.createPersistent.md +0 -26
  131. package/docs/classes/FileApiTreeAccessors.createPersistentFromFile.md +0 -27
  132. package/docs/classes/FileApiTreeAccessors.extractFileMetadata.md +0 -24
  133. package/docs/classes/FileApiTreeAccessors.fromDirectoryUpload.md +0 -25
  134. package/docs/classes/FileApiTreeAccessors.fromFileList.md +0 -25
  135. package/docs/classes/FileApiTreeAccessors.getOriginalFile.md +0 -27
  136. package/docs/classes/FileApiTreeAccessors.md +0 -172
  137. package/docs/classes/FileSystemAccessTreeAccessors.deleteFile.md +0 -22
  138. package/docs/classes/FileSystemAccessTreeAccessors.fileIsMutable.md +0 -22
  139. package/docs/classes/FileSystemAccessTreeAccessors.fromDirectoryHandle.md +0 -25
  140. package/docs/classes/FileSystemAccessTreeAccessors.fromFileHandle.md +0 -29
  141. package/docs/classes/FileSystemAccessTreeAccessors.getDirtyPaths.md +0 -15
  142. package/docs/classes/FileSystemAccessTreeAccessors.isDirty.md +0 -15
  143. package/docs/classes/FileSystemAccessTreeAccessors.md +0 -275
  144. package/docs/classes/FileSystemAccessTreeAccessors.saveFileContents.md +0 -23
  145. package/docs/classes/FileSystemAccessTreeAccessors.syncToDisk.md +0 -15
  146. package/docs/classes/HttpTreeAccessors.deleteFile.md +0 -22
  147. package/docs/classes/HttpTreeAccessors.fileIsMutable.md +0 -24
  148. package/docs/classes/HttpTreeAccessors.fromHttp.md +0 -24
  149. package/docs/classes/HttpTreeAccessors.getDirtyPaths.md +0 -17
  150. package/docs/classes/HttpTreeAccessors.isDirty.md +0 -17
  151. package/docs/classes/HttpTreeAccessors.md +0 -261
  152. package/docs/classes/HttpTreeAccessors.saveFileContents.md +0 -25
  153. package/docs/classes/HttpTreeAccessors.syncToDisk.md +0 -22
  154. package/docs/classes/LocalStorageTreeAccessors.deleteFile.md +0 -24
  155. package/docs/classes/LocalStorageTreeAccessors.fileIsMutable.md +0 -24
  156. package/docs/classes/LocalStorageTreeAccessors.fromStorage.md +0 -25
  157. package/docs/classes/LocalStorageTreeAccessors.getDirtyPaths.md +0 -17
  158. package/docs/classes/LocalStorageTreeAccessors.isDirty.md +0 -17
  159. package/docs/classes/LocalStorageTreeAccessors.md +0 -270
  160. package/docs/classes/LocalStorageTreeAccessors.saveFileContents.md +0 -25
  161. package/docs/classes/LocalStorageTreeAccessors.syncToDisk.md +0 -17
  162. package/docs/functions/createBrowserCryptoProvider.md +0 -12
  163. package/docs/functions/exportAsJson.md +0 -12
  164. package/docs/functions/exportUsingFileSystemAPI.md +0 -11
  165. package/docs/functions/extractDirectoryPath.md +0 -13
  166. package/docs/functions/extractFileListMetadata.md +0 -11
  167. package/docs/functions/extractFileMetadata.md +0 -11
  168. package/docs/functions/fromDirectoryUpload.md +0 -12
  169. package/docs/functions/fromFileList.md +0 -12
  170. package/docs/functions/getOriginalFile.md +0 -11
  171. package/docs/functions/isDirectoryHandle.md +0 -11
  172. package/docs/functions/isFileHandle.md +0 -11
  173. package/docs/functions/isFilePath.md +0 -11
  174. package/docs/functions/parseContextFilter.md +0 -12
  175. package/docs/functions/parseQualifierDefaults.md +0 -12
  176. package/docs/functions/parseResourceTypes.md +0 -12
  177. package/docs/functions/parseUrlParameters.md +0 -11
  178. package/docs/functions/safeShowDirectoryPicker.md +0 -11
  179. package/docs/functions/safeShowOpenFilePicker.md +0 -11
  180. package/docs/functions/safeShowSaveFilePicker.md +0 -11
  181. package/docs/functions/supportsFileSystemAccess.md +0 -11
  182. package/docs/interfaces/FilePickerAcceptType.accept.md +0 -9
  183. package/docs/interfaces/FilePickerAcceptType.description.md +0 -9
  184. package/docs/interfaces/FilePickerAcceptType.md +0 -61
  185. package/docs/interfaces/FileSystemCreateWritableOptions.keepExistingData.md +0 -9
  186. package/docs/interfaces/FileSystemCreateWritableOptions.md +0 -44
  187. package/docs/interfaces/FileSystemDirectoryHandle._asyncIterator_.md +0 -13
  188. package/docs/interfaces/FileSystemDirectoryHandle.entries.md +0 -13
  189. package/docs/interfaces/FileSystemDirectoryHandle.getDirectoryHandle.md +0 -21
  190. package/docs/interfaces/FileSystemDirectoryHandle.getFileHandle.md +0 -21
  191. package/docs/interfaces/FileSystemDirectoryHandle.keys.md +0 -13
  192. package/docs/interfaces/FileSystemDirectoryHandle.kind.md +0 -9
  193. package/docs/interfaces/FileSystemDirectoryHandle.md +0 -224
  194. package/docs/interfaces/FileSystemDirectoryHandle.removeEntry.md +0 -21
  195. package/docs/interfaces/FileSystemDirectoryHandle.resolve.md +0 -20
  196. package/docs/interfaces/FileSystemDirectoryHandle.values.md +0 -13
  197. package/docs/interfaces/FileSystemFileHandle.createWritable.md +0 -20
  198. package/docs/interfaces/FileSystemFileHandle.getFile.md +0 -13
  199. package/docs/interfaces/FileSystemFileHandle.kind.md +0 -9
  200. package/docs/interfaces/FileSystemFileHandle.md +0 -146
  201. package/docs/interfaces/FileSystemGetDirectoryOptions.create.md +0 -9
  202. package/docs/interfaces/FileSystemGetDirectoryOptions.md +0 -44
  203. package/docs/interfaces/FileSystemGetFileOptions.create.md +0 -9
  204. package/docs/interfaces/FileSystemGetFileOptions.md +0 -44
  205. package/docs/interfaces/FileSystemHandle.isSameEntry.md +0 -20
  206. package/docs/interfaces/FileSystemHandle.kind.md +0 -9
  207. package/docs/interfaces/FileSystemHandle.md +0 -118
  208. package/docs/interfaces/FileSystemHandle.name.md +0 -9
  209. package/docs/interfaces/FileSystemHandle.queryPermission.md +0 -20
  210. package/docs/interfaces/FileSystemHandle.requestPermission.md +0 -20
  211. package/docs/interfaces/FileSystemHandlePermissionDescriptor.md +0 -44
  212. package/docs/interfaces/FileSystemHandlePermissionDescriptor.mode.md +0 -9
  213. package/docs/interfaces/FileSystemRemoveOptions.md +0 -44
  214. package/docs/interfaces/FileSystemRemoveOptions.recursive.md +0 -9
  215. package/docs/interfaces/FileSystemWritableFileStream.md +0 -142
  216. package/docs/interfaces/FileSystemWritableFileStream.seek.md +0 -20
  217. package/docs/interfaces/FileSystemWritableFileStream.truncate.md +0 -20
  218. package/docs/interfaces/FileSystemWritableFileStream.write.md +0 -20
  219. package/docs/interfaces/IDirectoryHandleTreeInitializer.dirHandles.md +0 -9
  220. package/docs/interfaces/IDirectoryHandleTreeInitializer.md +0 -78
  221. package/docs/interfaces/IDirectoryHandleTreeInitializer.nonRecursive.md +0 -9
  222. package/docs/interfaces/IDirectoryHandleTreeInitializer.prefix.md +0 -9
  223. package/docs/interfaces/IFileHandleTreeInitializer.fileHandles.md +0 -9
  224. package/docs/interfaces/IFileHandleTreeInitializer.md +0 -61
  225. package/docs/interfaces/IFileHandleTreeInitializer.prefix.md +0 -9
  226. package/docs/interfaces/IFileListTreeInitializer.fileList.md +0 -9
  227. package/docs/interfaces/IFileListTreeInitializer.md +0 -44
  228. package/docs/interfaces/IFileMetadata.lastModified.md +0 -9
  229. package/docs/interfaces/IFileMetadata.md +0 -112
  230. package/docs/interfaces/IFileMetadata.name.md +0 -9
  231. package/docs/interfaces/IFileMetadata.path.md +0 -9
  232. package/docs/interfaces/IFileMetadata.size.md +0 -9
  233. package/docs/interfaces/IFileMetadata.type.md +0 -9
  234. package/docs/interfaces/IFileSystemAccessTreeParams.autoSync.md +0 -12
  235. package/docs/interfaces/IFileSystemAccessTreeParams.filePath.md +0 -13
  236. package/docs/interfaces/IFileSystemAccessTreeParams.logger.md +0 -11
  237. package/docs/interfaces/IFileSystemAccessTreeParams.md +0 -148
  238. package/docs/interfaces/IFileSystemAccessTreeParams.requireWritePermission.md +0 -13
  239. package/docs/interfaces/IFsAccessApis.md +0 -62
  240. package/docs/interfaces/IFsAccessApis.showDirectoryPicker.md +0 -20
  241. package/docs/interfaces/IFsAccessApis.showOpenFilePicker.md +0 -20
  242. package/docs/interfaces/IFsAccessApis.showSaveFilePicker.md +0 -20
  243. package/docs/interfaces/IHttpTreeParams.autoSync.md +0 -9
  244. package/docs/interfaces/IHttpTreeParams.baseUrl.md +0 -9
  245. package/docs/interfaces/IHttpTreeParams.fetchImpl.md +0 -9
  246. package/docs/interfaces/IHttpTreeParams.logger.md +0 -9
  247. package/docs/interfaces/IHttpTreeParams.md +0 -182
  248. package/docs/interfaces/IHttpTreeParams.namespace.md +0 -9
  249. package/docs/interfaces/IHttpTreeParams.userId.md +0 -9
  250. package/docs/interfaces/ILocalStorageTreeParams.autoSync.md +0 -12
  251. package/docs/interfaces/ILocalStorageTreeParams.md +0 -131
  252. package/docs/interfaces/ILocalStorageTreeParams.pathToKeyMap.md +0 -13
  253. package/docs/interfaces/ILocalStorageTreeParams.storage.md +0 -12
  254. package/docs/interfaces/IUrlConfigOptions.config.md +0 -11
  255. package/docs/interfaces/IUrlConfigOptions.configStartDir.md +0 -11
  256. package/docs/interfaces/IUrlConfigOptions.contextFilter.md +0 -11
  257. package/docs/interfaces/IUrlConfigOptions.input.md +0 -11
  258. package/docs/interfaces/IUrlConfigOptions.inputStartDir.md +0 -11
  259. package/docs/interfaces/IUrlConfigOptions.interactive.md +0 -11
  260. package/docs/interfaces/IUrlConfigOptions.loadZip.md +0 -11
  261. package/docs/interfaces/IUrlConfigOptions.maxDistance.md +0 -11
  262. package/docs/interfaces/IUrlConfigOptions.md +0 -248
  263. package/docs/interfaces/IUrlConfigOptions.qualifierDefaults.md +0 -11
  264. package/docs/interfaces/IUrlConfigOptions.reduceQualifiers.md +0 -11
  265. package/docs/interfaces/IUrlConfigOptions.resourceTypes.md +0 -11
  266. package/docs/interfaces/IUrlConfigOptions.zipFile.md +0 -11
  267. package/docs/interfaces/IUrlConfigOptions.zipPath.md +0 -11
  268. package/docs/interfaces/ShowDirectoryPickerOptions.id.md +0 -9
  269. package/docs/interfaces/ShowDirectoryPickerOptions.md +0 -78
  270. package/docs/interfaces/ShowDirectoryPickerOptions.mode.md +0 -9
  271. package/docs/interfaces/ShowDirectoryPickerOptions.startIn.md +0 -9
  272. package/docs/interfaces/ShowOpenFilePickerOptions.excludeAcceptAllOption.md +0 -9
  273. package/docs/interfaces/ShowOpenFilePickerOptions.id.md +0 -9
  274. package/docs/interfaces/ShowOpenFilePickerOptions.md +0 -112
  275. package/docs/interfaces/ShowOpenFilePickerOptions.multiple.md +0 -9
  276. package/docs/interfaces/ShowOpenFilePickerOptions.startIn.md +0 -9
  277. package/docs/interfaces/ShowOpenFilePickerOptions.types.md +0 -9
  278. package/docs/interfaces/ShowSaveFilePickerOptions.excludeAcceptAllOption.md +0 -9
  279. package/docs/interfaces/ShowSaveFilePickerOptions.id.md +0 -9
  280. package/docs/interfaces/ShowSaveFilePickerOptions.md +0 -112
  281. package/docs/interfaces/ShowSaveFilePickerOptions.startIn.md +0 -9
  282. package/docs/interfaces/ShowSaveFilePickerOptions.suggestedName.md +0 -9
  283. package/docs/interfaces/ShowSaveFilePickerOptions.types.md +0 -9
  284. package/docs/type-aliases/TreeInitializer.md +0 -11
  285. package/docs/type-aliases/WellKnownDirectory.md +0 -11
  286. package/docs/type-aliases/WindowWithFsAccess.md +0 -11
  287. package/docs/variables/DEFAULT_DIRECTORY_HANDLE_DB.md +0 -9
  288. package/docs/variables/DEFAULT_DIRECTORY_HANDLE_STORE.md +0 -9
  289. package/docs/variables/defaultFileApiTreeInitParams.md +0 -9
  290. package/etc/ts-web-extras.api.md +0 -433
  291. package/lib/test/mocks/idb-keyval.d.ts +0 -6
  292. package/lib/test/mocks/idb-keyval.d.ts.map +0 -1
  293. package/lib/test/mocks/idb-keyval.js +0 -9
  294. package/lib/test/mocks/idb-keyval.js.map +0 -1
  295. package/lib/test/setupTests.d.ts +0 -2
  296. package/lib/test/setupTests.d.ts.map +0 -1
  297. package/lib/test/setupTests.js +0 -76
  298. package/lib/test/setupTests.js.map +0 -1
  299. package/lib/test/unit/browserHashProvider.test.d.ts +0 -2
  300. package/lib/test/unit/browserHashProvider.test.d.ts.map +0 -1
  301. package/lib/test/unit/browserHashProvider.test.js +0 -142
  302. package/lib/test/unit/browserHashProvider.test.js.map +0 -1
  303. package/lib/test/unit/directoryHandleStore.test.d.ts +0 -2
  304. package/lib/test/unit/directoryHandleStore.test.d.ts.map +0 -1
  305. package/lib/test/unit/directoryHandleStore.test.js +0 -192
  306. package/lib/test/unit/directoryHandleStore.test.js.map +0 -1
  307. package/lib/test/unit/fileApiTreeAccessors.test.d.ts +0 -2
  308. package/lib/test/unit/fileApiTreeAccessors.test.d.ts.map +0 -1
  309. package/lib/test/unit/fileApiTreeAccessors.test.js +0 -1190
  310. package/lib/test/unit/fileApiTreeAccessors.test.js.map +0 -1
  311. package/lib/test/unit/fileApiTypes.test.d.ts +0 -2
  312. package/lib/test/unit/fileApiTypes.test.d.ts.map +0 -1
  313. package/lib/test/unit/fileApiTypes.test.js +0 -474
  314. package/lib/test/unit/fileApiTypes.test.js.map +0 -1
  315. package/lib/test/unit/fileSystemAccessTreeAccessors.test.d.ts +0 -2
  316. package/lib/test/unit/fileSystemAccessTreeAccessors.test.d.ts.map +0 -1
  317. package/lib/test/unit/fileSystemAccessTreeAccessors.test.js +0 -624
  318. package/lib/test/unit/fileSystemAccessTreeAccessors.test.js.map +0 -1
  319. package/lib/test/unit/fileTreeHelpers.test.d.ts +0 -2
  320. package/lib/test/unit/fileTreeHelpers.test.d.ts.map +0 -1
  321. package/lib/test/unit/fileTreeHelpers.test.js +0 -592
  322. package/lib/test/unit/fileTreeHelpers.test.js.map +0 -1
  323. package/lib/test/unit/httpTreeAccessors.test.d.ts +0 -2
  324. package/lib/test/unit/httpTreeAccessors.test.d.ts.map +0 -1
  325. package/lib/test/unit/httpTreeAccessors.test.js +0 -1231
  326. package/lib/test/unit/httpTreeAccessors.test.js.map +0 -1
  327. package/lib/test/unit/localStorageTreeAccessors.test.d.ts +0 -2
  328. package/lib/test/unit/localStorageTreeAccessors.test.d.ts.map +0 -1
  329. package/lib/test/unit/localStorageTreeAccessors.test.js +0 -814
  330. package/lib/test/unit/localStorageTreeAccessors.test.js.map +0 -1
  331. package/lib/test/unit/urlParams.test.d.ts +0 -2
  332. package/lib/test/unit/urlParams.test.d.ts.map +0 -1
  333. package/lib/test/unit/urlParams.test.js +0 -395
  334. package/lib/test/unit/urlParams.test.js.map +0 -1
  335. package/lib/test/utils/fileSystemAccessMocks.d.ts +0 -53
  336. package/lib/test/utils/fileSystemAccessMocks.d.ts.map +0 -1
  337. package/lib/test/utils/fileSystemAccessMocks.js +0 -277
  338. package/lib/test/utils/fileSystemAccessMocks.js.map +0 -1
  339. package/lib/test/utils/testHelpers.d.ts +0 -51
  340. package/lib/test/utils/testHelpers.d.ts.map +0 -1
  341. package/lib/test/utils/testHelpers.js +0 -133
  342. package/lib/test/utils/testHelpers.js.map +0 -1
  343. package/rush-logs/ts-web-extras.build.cache.log +0 -3
  344. package/rush-logs/ts-web-extras.build.log +0 -55
  345. package/src/index.browser.ts +0 -24
  346. package/src/index.ts +0 -47
  347. package/src/packlets/crypto-utils/browserCryptoProvider.ts +0 -311
  348. package/src/packlets/crypto-utils/browserHashProvider.ts +0 -73
  349. package/src/packlets/crypto-utils/index.ts +0 -29
  350. package/src/packlets/file-api-types/index.ts +0 -366
  351. package/src/packlets/file-tree/directoryHandleStore.ts +0 -136
  352. package/src/packlets/file-tree/fileApiTreeAccessors.ts +0 -528
  353. package/src/packlets/file-tree/fileSystemAccessTreeAccessors.ts +0 -519
  354. package/src/packlets/file-tree/httpTreeAccessors.ts +0 -448
  355. package/src/packlets/file-tree/index.ts +0 -32
  356. package/src/packlets/file-tree/localStorageTreeAccessors.ts +0 -430
  357. package/src/packlets/helpers/fileTreeHelpers.ts +0 -107
  358. package/src/packlets/helpers/index.ts +0 -28
  359. package/src/packlets/url-utils/index.ts +0 -28
  360. package/src/packlets/url-utils/urlParams.ts +0 -245
  361. package/src/test/mocks/idb-keyval.ts +0 -5
  362. package/src/test/setupTests.ts +0 -87
  363. package/src/test/unit/browserHashProvider.test.ts +0 -155
  364. package/src/test/unit/browserHashProvider.test.ts.bak +0 -376
  365. package/src/test/unit/directoryHandleStore.test.ts +0 -251
  366. package/src/test/unit/fileApiTreeAccessors.test.ts +0 -1387
  367. package/src/test/unit/fileApiTypes.test.ts +0 -587
  368. package/src/test/unit/fileSystemAccessTreeAccessors.test.ts +0 -885
  369. package/src/test/unit/fileTreeHelpers.test.ts +0 -694
  370. package/src/test/unit/httpTreeAccessors.test.ts +0 -1571
  371. package/src/test/unit/localStorageTreeAccessors.test.ts +0 -1014
  372. package/src/test/unit/urlParams.test.ts +0 -464
  373. package/src/test/utils/fileSystemAccessMocks.ts +0 -353
  374. package/src/test/utils/testHelpers.ts +0 -155
  375. package/temp/build/typescript/ts_8nwakTlr.json +0 -1
  376. package/temp/coverage/base.css +0 -224
  377. package/temp/coverage/block-navigation.js +0 -87
  378. package/temp/coverage/crypto-utils/browserCryptoProvider.ts.html +0 -1018
  379. package/temp/coverage/crypto-utils/browserHashProvider.ts.html +0 -304
  380. package/temp/coverage/crypto-utils/index.html +0 -131
  381. package/temp/coverage/favicon.png +0 -0
  382. package/temp/coverage/file-tree/directoryHandleStore.ts.html +0 -493
  383. package/temp/coverage/file-tree/fileApiTreeAccessors.ts.html +0 -1669
  384. package/temp/coverage/file-tree/fileSystemAccessTreeAccessors.ts.html +0 -1642
  385. package/temp/coverage/file-tree/httpTreeAccessors.ts.html +0 -1429
  386. package/temp/coverage/file-tree/index.html +0 -176
  387. package/temp/coverage/file-tree/localStorageTreeAccessors.ts.html +0 -1375
  388. package/temp/coverage/helpers/fileTreeHelpers.ts.html +0 -406
  389. package/temp/coverage/helpers/index.html +0 -116
  390. package/temp/coverage/index.html +0 -161
  391. package/temp/coverage/lcov-report/base.css +0 -224
  392. package/temp/coverage/lcov-report/block-navigation.js +0 -87
  393. package/temp/coverage/lcov-report/crypto-utils/browserCryptoProvider.ts.html +0 -1018
  394. package/temp/coverage/lcov-report/crypto-utils/browserHashProvider.ts.html +0 -304
  395. package/temp/coverage/lcov-report/crypto-utils/index.html +0 -131
  396. package/temp/coverage/lcov-report/favicon.png +0 -0
  397. package/temp/coverage/lcov-report/file-tree/directoryHandleStore.ts.html +0 -493
  398. package/temp/coverage/lcov-report/file-tree/fileApiTreeAccessors.ts.html +0 -1669
  399. package/temp/coverage/lcov-report/file-tree/fileSystemAccessTreeAccessors.ts.html +0 -1642
  400. package/temp/coverage/lcov-report/file-tree/httpTreeAccessors.ts.html +0 -1429
  401. package/temp/coverage/lcov-report/file-tree/index.html +0 -176
  402. package/temp/coverage/lcov-report/file-tree/localStorageTreeAccessors.ts.html +0 -1375
  403. package/temp/coverage/lcov-report/helpers/fileTreeHelpers.ts.html +0 -406
  404. package/temp/coverage/lcov-report/helpers/index.html +0 -116
  405. package/temp/coverage/lcov-report/index.html +0 -161
  406. package/temp/coverage/lcov-report/prettify.css +0 -1
  407. package/temp/coverage/lcov-report/prettify.js +0 -2
  408. package/temp/coverage/lcov-report/sort-arrow-sprite.png +0 -0
  409. package/temp/coverage/lcov-report/sorter.js +0 -210
  410. package/temp/coverage/lcov-report/url-utils/index.html +0 -116
  411. package/temp/coverage/lcov-report/url-utils/urlParams.ts.html +0 -820
  412. package/temp/coverage/lcov.info +0 -3597
  413. package/temp/coverage/prettify.css +0 -1
  414. package/temp/coverage/prettify.js +0 -2
  415. package/temp/coverage/sort-arrow-sprite.png +0 -0
  416. package/temp/coverage/sorter.js +0 -210
  417. package/temp/coverage/url-utils/index.html +0 -116
  418. package/temp/coverage/url-utils/urlParams.ts.html +0 -820
  419. package/temp/test/jest/haste-map-7492f1b44480e0cdd1f220078fb3afd8-c8dd6c3430605adeb2f1cadf4f75e791-8c9336785555d572065b28c111982ba4 +0 -0
  420. package/temp/test/jest/jest-transform-cache-7492f1b44480e0cdd1f220078fb3afd8-79ef2876fae7ca75eedb2aa53dc48338/7c/package_7c16afc8299e635d80273763175c7a50 +0 -53
  421. package/temp/test/jest/perf-cache-7492f1b44480e0cdd1f220078fb3afd8-da39a3ee5e6b4b0d3255bfef95601890 +0 -1
  422. package/temp/ts-web-extras.api.json +0 -8850
  423. package/temp/ts-web-extras.api.md +0 -433
  424. package/tsconfig.json +0 -7
@@ -1,590 +0,0 @@
1
- /*
2
- * Copyright (c) 2025 Erik Fortune
3
- *
4
- * Permission is hereby granted, free of charge, to any person obtaining a copy
5
- * of this software and associated documentation files (the "Software"), to deal
6
- * in the Software without restriction, including without limitation the rights
7
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
8
- * copies of the Software, and to permit persons to whom the Software is
9
- * furnished to do so, subject to the following conditions:
10
- *
11
- * The above copyright notice and this permission notice shall be included in all
12
- * copies or substantial portions of the Software.
13
- *
14
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
17
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
19
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
20
- * SOFTWARE.
21
- */
22
- import '@fgv/ts-utils-jest';
23
- import { FileTreeHelpers } from '../../packlets/helpers';
24
- import { createMockFile, createMockFileList, createMockDirectoryFileList } from '../utils/testHelpers';
25
- describe('FileTreeHelpers', () => {
26
- describe('fromFileList', () => {
27
- test('creates FileTree from simple FileList', async () => {
28
- const fileList = createMockFileList([
29
- { name: 'file1.txt', content: 'content1' },
30
- { name: 'file2.txt', content: 'content2' }
31
- ]);
32
- const result = await FileTreeHelpers.fromFileList(fileList);
33
- expect(result).toSucceedAndSatisfy((fileTree) => {
34
- // Verify files are accessible with proper paths
35
- expect(fileTree.getFile('/file1.txt')).toSucceed();
36
- expect(fileTree.getFile('/file2.txt')).toSucceed();
37
- // Verify content can be retrieved
38
- const content1 = fileTree.hal.getFileContents('/file1.txt');
39
- expect(content1).toSucceedWith('content1');
40
- const content2 = fileTree.hal.getFileContents('/file2.txt');
41
- expect(content2).toSucceedWith('content2');
42
- });
43
- });
44
- test('creates FileTree from FileList with prefix', async () => {
45
- const fileList = createMockFileList([{ name: 'test.txt', content: 'test content' }]);
46
- const result = await FileTreeHelpers.fromFileList(fileList, { prefix: '/upload' });
47
- expect(result).toSucceed();
48
- });
49
- test('handles empty FileList', async () => {
50
- const fileList = createMockFileList([]);
51
- const result = await FileTreeHelpers.fromFileList(fileList);
52
- expect(result).toSucceed();
53
- });
54
- test('handles various file types', async () => {
55
- const fileList = createMockFileList([
56
- { name: 'data.json', content: '{"key": "value"}', type: 'application/json' },
57
- { name: 'script.js', content: 'console.log("hello");', type: 'application/javascript' },
58
- { name: 'style.css', content: 'body { margin: 0; }', type: 'text/css' },
59
- { name: 'readme.txt', content: 'This is a readme', type: 'text/plain' }
60
- ]);
61
- const result = await FileTreeHelpers.fromFileList(fileList);
62
- expect(result).toSucceedAndSatisfy((fileTree) => {
63
- expect(fileTree.getFile('/data.json')).toSucceed();
64
- expect(fileTree.getFile('/script.js')).toSucceed();
65
- expect(fileTree.getFile('/style.css')).toSucceed();
66
- expect(fileTree.getFile('/readme.txt')).toSucceed();
67
- });
68
- });
69
- test('automatically applies MIME types as contentType', async () => {
70
- const fileList = createMockFileList([
71
- { name: 'data.json', content: '{"key": "value"}', type: 'application/json' },
72
- { name: 'script.js', content: 'console.log("hello");', type: 'application/javascript' },
73
- { name: 'style.css', content: 'body { margin: 0; }', type: 'text/css' },
74
- { name: 'readme.txt', content: 'This is a readme', type: 'text/plain' },
75
- { name: 'image.png', content: 'PNG data', type: 'image/png' },
76
- { name: 'document.pdf', content: 'PDF content', type: 'application/pdf' },
77
- { name: 'archive.zip', content: 'ZIP data', type: 'application/zip' }
78
- ]);
79
- const result = await FileTreeHelpers.fromFileList(fileList);
80
- expect(result).toSucceedAndSatisfy((fileTree) => {
81
- // Verify MIME types are automatically applied as contentType
82
- expect(fileTree.getFile('/data.json')).toSucceedAndSatisfy((file) => {
83
- expect(file.contentType).toBe('application/json');
84
- });
85
- expect(fileTree.getFile('/script.js')).toSucceedAndSatisfy((file) => {
86
- expect(file.contentType).toBe('application/javascript');
87
- });
88
- expect(fileTree.getFile('/style.css')).toSucceedAndSatisfy((file) => {
89
- expect(file.contentType).toBe('text/css');
90
- });
91
- expect(fileTree.getFile('/readme.txt')).toSucceedAndSatisfy((file) => {
92
- expect(file.contentType).toBe('text/plain');
93
- });
94
- expect(fileTree.getFile('/image.png')).toSucceedAndSatisfy((file) => {
95
- expect(file.contentType).toBe('image/png');
96
- });
97
- expect(fileTree.getFile('/document.pdf')).toSucceedAndSatisfy((file) => {
98
- expect(file.contentType).toBe('application/pdf');
99
- });
100
- expect(fileTree.getFile('/archive.zip')).toSucceedAndSatisfy((file) => {
101
- expect(file.contentType).toBe('application/zip');
102
- });
103
- });
104
- });
105
- test('handles files without MIME types', async () => {
106
- const fileList = createMockFileList([
107
- { name: 'no-type.txt', content: 'content without type' },
108
- { name: 'empty-type.dat', content: 'empty type', type: '' },
109
- { name: 'unknown.ext', content: 'unknown extension' }
110
- ]);
111
- const result = await FileTreeHelpers.fromFileList(fileList);
112
- expect(result).toSucceedAndSatisfy((fileTree) => {
113
- // Files without MIME types should have undefined contentType
114
- expect(fileTree.getFile('/no-type.txt')).toSucceedAndSatisfy((file) => {
115
- expect(file.contentType).toBe('text/plain'); // Default from createMockFile
116
- });
117
- expect(fileTree.getFile('/empty-type.dat')).toSucceedAndSatisfy((file) => {
118
- expect(file.contentType).toBe('text/plain'); // Browser defaults empty type to text/plain
119
- });
120
- expect(fileTree.getFile('/unknown.ext')).toSucceedAndSatisfy((file) => {
121
- expect(file.contentType).toBe('text/plain'); // Default from createMockFile
122
- });
123
- });
124
- });
125
- test('forces content type to string (not templated)', async () => {
126
- const fileList = createMockFileList([
127
- { name: 'test.json', content: '{"test": true}', type: 'application/json' }
128
- ]);
129
- const result = await FileTreeHelpers.fromFileList(fileList);
130
- expect(result).toSucceedAndSatisfy((fileTree) => {
131
- // Verify the return type is FileTree<string> not FileTree<T>
132
- expect(fileTree.getFile('/test.json')).toSucceedAndSatisfy((file) => {
133
- expect(typeof file.contentType).toBe('string');
134
- expect(file.contentType).toBe('application/json');
135
- });
136
- });
137
- });
138
- test('propagates file reading errors', async () => {
139
- const badFile = {
140
- name: 'bad.txt',
141
- size: 10,
142
- type: 'text/plain',
143
- lastModified: Date.now(),
144
- text: () => Promise.reject(new Error('Read failed'))
145
- };
146
- const fileList = createMockFileList([{ name: 'good.txt', content: 'good content' }]);
147
- // Create a FileList with just the bad file
148
- const dt = new DataTransfer();
149
- dt.items.add(badFile);
150
- const badFileList = dt.files;
151
- const result = await FileTreeHelpers.fromFileList(badFileList);
152
- expect(result).toFailWith(/Failed to read file/);
153
- });
154
- test('maintains file accessibility through FileTree API', async () => {
155
- const fileList = createMockFileList([{ name: 'test.json', content: '{"name": "test", "value": 42}' }]);
156
- const result = await FileTreeHelpers.fromFileList(fileList);
157
- expect(result).toSucceedAndSatisfy((fileTree) => {
158
- const file = fileTree.getFile('/test.json');
159
- expect(file).toSucceedAndSatisfy((fileItem) => {
160
- // Test JSON parsing through FileTree
161
- const jsonResult = fileItem.getContents();
162
- expect(jsonResult).toSucceedAndSatisfy((parsed) => {
163
- expect(parsed).toEqual({ name: 'test', value: 42 });
164
- });
165
- // Test raw content access
166
- const rawResult = fileItem.getRawContents();
167
- expect(rawResult).toSucceedWith('{"name": "test", "value": 42}');
168
- // Test file properties
169
- expect(fileItem.name).toBe('test.json');
170
- expect(fileItem.extension).toBe('.json');
171
- expect(fileItem.baseName).toBe('test');
172
- });
173
- });
174
- });
175
- });
176
- describe('fromDirectoryUpload', () => {
177
- test('creates FileTree from directory structure', async () => {
178
- const fileList = createMockDirectoryFileList([
179
- { path: 'project/src/index.js', content: 'console.log("main");' },
180
- { path: 'project/src/utils.js', content: 'export const helper = () => {};' },
181
- { path: 'project/package.json', content: '{"name": "test-project"}' },
182
- { path: 'project/README.md', content: '# Test Project' }
183
- ]);
184
- const result = await FileTreeHelpers.fromDirectoryUpload(fileList);
185
- expect(result).toSucceedAndSatisfy((fileTree) => {
186
- // Verify all files are accessible
187
- expect(fileTree.getFile('/project/src/index.js')).toSucceed();
188
- expect(fileTree.getFile('/project/src/utils.js')).toSucceed();
189
- expect(fileTree.getFile('/project/package.json')).toSucceed();
190
- expect(fileTree.getFile('/project/README.md')).toSucceed();
191
- // Verify directory structure
192
- expect(fileTree.getDirectory('/project')).toSucceed();
193
- expect(fileTree.getDirectory('/project/src')).toSucceed();
194
- // Verify content retrieval
195
- const packageContent = fileTree.hal.getFileContents('/project/package.json');
196
- expect(packageContent).toSucceedWith('{"name": "test-project"}');
197
- });
198
- });
199
- test('creates FileTree from directory with prefix', async () => {
200
- const fileList = createMockDirectoryFileList([
201
- { path: 'app/config.json', content: '{"setting": "value"}' },
202
- { path: 'app/main.js', content: 'console.log("app");' }
203
- ]);
204
- const result = await FileTreeHelpers.fromDirectoryUpload(fileList, { prefix: '/upload' });
205
- expect(result).toSucceed();
206
- });
207
- test('preserves directory hierarchy', async () => {
208
- const fileList = createMockDirectoryFileList([
209
- { path: 'deep/nested/structure/file1.txt', content: 'content1' },
210
- { path: 'deep/nested/structure/file2.txt', content: 'content2' },
211
- { path: 'deep/other/branch/file3.txt', content: 'content3' },
212
- { path: 'deep/file4.txt', content: 'content4' }
213
- ]);
214
- const result = await FileTreeHelpers.fromDirectoryUpload(fileList);
215
- expect(result).toSucceedAndSatisfy((fileTree) => {
216
- // Test all directory levels
217
- expect(fileTree.getDirectory('/deep')).toSucceed();
218
- expect(fileTree.getDirectory('/deep/nested')).toSucceed();
219
- expect(fileTree.getDirectory('/deep/nested/structure')).toSucceed();
220
- expect(fileTree.getDirectory('/deep/other')).toSucceed();
221
- expect(fileTree.getDirectory('/deep/other/branch')).toSucceed();
222
- // Test directory traversal
223
- const deepDir = fileTree.getDirectory('/deep');
224
- expect(deepDir).toSucceedAndSatisfy((dir) => {
225
- const children = dir.getChildren();
226
- expect(children).toSucceedAndSatisfy((items) => {
227
- const names = items.map((item) => item.name).sort();
228
- expect(names).toContain('nested');
229
- expect(names).toContain('other');
230
- expect(names).toContain('file4.txt');
231
- });
232
- });
233
- });
234
- });
235
- test('handles webkitRelativePath correctly', async () => {
236
- // Create files with explicit webkitRelativePath
237
- const files = [
238
- createMockFile({
239
- name: 'index.html',
240
- content: '<html></html>',
241
- webkitRelativePath: 'website/index.html'
242
- }),
243
- createMockFile({
244
- name: 'style.css',
245
- content: 'body {}',
246
- webkitRelativePath: 'website/css/style.css'
247
- })
248
- ];
249
- // Create FileList manually to preserve webkitRelativePath
250
- const dt = new DataTransfer();
251
- files.forEach((file) => dt.items.add(file));
252
- const fileList = dt.files;
253
- const result = await FileTreeHelpers.fromDirectoryUpload(fileList);
254
- expect(result).toSucceedAndSatisfy((fileTree) => {
255
- expect(fileTree.getFile('/website/index.html')).toSucceed();
256
- expect(fileTree.getFile('/website/css/style.css')).toSucceed();
257
- expect(fileTree.getDirectory('/website')).toSucceed();
258
- expect(fileTree.getDirectory('/website/css')).toSucceed();
259
- });
260
- });
261
- test('handles single file in directory', async () => {
262
- const fileList = createMockDirectoryFileList([{ path: 'single/file.txt', content: 'lone file' }]);
263
- const result = await FileTreeHelpers.fromDirectoryUpload(fileList);
264
- expect(result).toSucceedAndSatisfy((fileTree) => {
265
- expect(fileTree.getFile('/single/file.txt')).toSucceed();
266
- expect(fileTree.getDirectory('/single')).toSucceed();
267
- });
268
- });
269
- test('handles empty directory upload', async () => {
270
- const fileList = createMockDirectoryFileList([]);
271
- const result = await FileTreeHelpers.fromDirectoryUpload(fileList);
272
- expect(result).toSucceed();
273
- });
274
- test('automatically applies MIME types as contentType in directory upload', async () => {
275
- const fileList = createMockDirectoryFileList([
276
- { path: 'project/package.json', content: '{"name": "test"}', type: 'application/json' },
277
- { path: 'project/src/index.js', content: 'console.log("main");', type: 'application/javascript' },
278
- { path: 'project/src/styles.css', content: 'body { color: red; }', type: 'text/css' },
279
- { path: 'project/README.md', content: '# Project', type: 'text/markdown' },
280
- { path: 'project/data.xml', content: '<root></root>', type: 'application/xml' },
281
- { path: 'project/assets/logo.svg', content: '<svg></svg>', type: 'image/svg+xml' },
282
- { path: 'project/docs/manual.pdf', content: 'PDF content', type: 'application/pdf' }
283
- ]);
284
- const result = await FileTreeHelpers.fromDirectoryUpload(fileList);
285
- expect(result).toSucceedAndSatisfy((fileTree) => {
286
- // Verify MIME types are automatically applied as contentType
287
- expect(fileTree.getFile('/project/package.json')).toSucceedAndSatisfy((file) => {
288
- expect(file.contentType).toBe('application/json');
289
- });
290
- expect(fileTree.getFile('/project/src/index.js')).toSucceedAndSatisfy((file) => {
291
- expect(file.contentType).toBe('application/javascript');
292
- });
293
- expect(fileTree.getFile('/project/src/styles.css')).toSucceedAndSatisfy((file) => {
294
- expect(file.contentType).toBe('text/css');
295
- });
296
- expect(fileTree.getFile('/project/README.md')).toSucceedAndSatisfy((file) => {
297
- expect(file.contentType).toBe('text/markdown');
298
- });
299
- expect(fileTree.getFile('/project/data.xml')).toSucceedAndSatisfy((file) => {
300
- expect(file.contentType).toBe('application/xml');
301
- });
302
- expect(fileTree.getFile('/project/assets/logo.svg')).toSucceedAndSatisfy((file) => {
303
- expect(file.contentType).toBe('image/svg+xml');
304
- });
305
- expect(fileTree.getFile('/project/docs/manual.pdf')).toSucceedAndSatisfy((file) => {
306
- expect(file.contentType).toBe('application/pdf');
307
- });
308
- });
309
- });
310
- test('handles mixed MIME types and missing types in directory upload', async () => {
311
- const fileList = createMockDirectoryFileList([
312
- { path: 'mixed/typed.json', content: '{}', type: 'application/json' },
313
- { path: 'mixed/untyped.txt', content: 'plain text' }, // No type specified
314
- { path: 'mixed/empty-type.dat', content: 'data', type: '' }, // Empty type
315
- { path: 'mixed/binary.bin', content: 'binary data', type: 'application/octet-stream' }
316
- ]);
317
- const result = await FileTreeHelpers.fromDirectoryUpload(fileList);
318
- expect(result).toSucceedAndSatisfy((fileTree) => {
319
- expect(fileTree.getFile('/mixed/typed.json')).toSucceedAndSatisfy((file) => {
320
- expect(file.contentType).toBe('application/json');
321
- });
322
- expect(fileTree.getFile('/mixed/untyped.txt')).toSucceedAndSatisfy((file) => {
323
- expect(file.contentType).toBe('text/plain'); // Default from createMockFile
324
- });
325
- expect(fileTree.getFile('/mixed/empty-type.dat')).toSucceedAndSatisfy((file) => {
326
- expect(file.contentType).toBe('text/plain'); // Browser defaults empty type to text/plain
327
- });
328
- expect(fileTree.getFile('/mixed/binary.bin')).toSucceedAndSatisfy((file) => {
329
- expect(file.contentType).toBe('application/octet-stream');
330
- });
331
- });
332
- });
333
- test('forces content type to string for directory upload (not templated)', async () => {
334
- const fileList = createMockDirectoryFileList([
335
- { path: 'app/config.json', content: '{"app": "test"}', type: 'application/json' }
336
- ]);
337
- const result = await FileTreeHelpers.fromDirectoryUpload(fileList);
338
- expect(result).toSucceedAndSatisfy((fileTree) => {
339
- // Verify the return type is FileTree<string> not FileTree<T>
340
- expect(fileTree.getFile('/app/config.json')).toSucceedAndSatisfy((file) => {
341
- expect(typeof file.contentType).toBe('string');
342
- expect(file.contentType).toBe('application/json');
343
- });
344
- });
345
- });
346
- });
347
- // Note: fromFileApiFiles method was deprecated and removed.
348
- // The functionality has been replaced by the create() method in FileApiTreeAccessors
349
- // which uses TreeInitializer[] instead of IFileApiFile[].
350
- describe('getOriginalFile', () => {
351
- test('retrieves original File object by path', () => {
352
- const fileList = createMockFileList([
353
- { name: 'target.txt', content: 'target content', type: 'text/plain' },
354
- { name: 'other.txt', content: 'other content', type: 'text/plain' }
355
- ]);
356
- const result = FileTreeHelpers.getOriginalFile(fileList, 'target.txt');
357
- expect(result).toSucceedAndSatisfy((file) => {
358
- expect(file.name).toBe('target.txt');
359
- expect(file.type).toBe('text/plain');
360
- expect(file.size).toBeGreaterThan(0);
361
- });
362
- });
363
- test('handles webkitRelativePath matching', () => {
364
- const fileList = createMockDirectoryFileList([
365
- { path: 'folder/subfolder/file.txt', content: 'content', type: 'text/plain' }
366
- ]);
367
- const result = FileTreeHelpers.getOriginalFile(fileList, 'folder/subfolder/file.txt');
368
- expect(result).toSucceedAndSatisfy((file) => {
369
- expect(file.name).toBe('file.txt');
370
- expect(file.webkitRelativePath).toBe('folder/subfolder/file.txt');
371
- });
372
- });
373
- test('fails gracefully for non-existent files', () => {
374
- const fileList = createMockFileList([{ name: 'exists.txt', content: 'content' }]);
375
- const result = FileTreeHelpers.getOriginalFile(fileList, 'missing.txt');
376
- expect(result).toFailWith(/File not found: missing\.txt/);
377
- });
378
- test('handles empty FileList', () => {
379
- const fileList = createMockFileList([]);
380
- const result = FileTreeHelpers.getOriginalFile(fileList, 'any.txt');
381
- expect(result).toFailWith(/File not found/);
382
- });
383
- test('prioritizes exact name match over webkitRelativePath', () => {
384
- // Create files with both regular names and webkitRelativePath
385
- const files = [
386
- createMockFile({ name: 'file.txt', content: 'regular file' }),
387
- createMockFile({
388
- name: 'other.txt',
389
- content: 'directory file',
390
- webkitRelativePath: 'file.txt' // Same as first file's name
391
- })
392
- ];
393
- const dt = new DataTransfer();
394
- files.forEach((file) => dt.items.add(file));
395
- const fileList = dt.files;
396
- const result = FileTreeHelpers.getOriginalFile(fileList, 'file.txt');
397
- expect(result).toSucceedAndSatisfy((file) => {
398
- expect(file.name).toBe('file.txt');
399
- expect(file.size).toBeGreaterThan(0);
400
- });
401
- });
402
- });
403
- describe('extractFileListMetadata', () => {
404
- test('extracts complete metadata from FileList', () => {
405
- const testTime = Date.now();
406
- const fileList = createMockFileList([
407
- {
408
- name: 'document.pdf',
409
- content: 'PDF content here',
410
- type: 'application/pdf',
411
- lastModified: testTime
412
- },
413
- {
414
- name: 'image.png',
415
- content: 'PNG data',
416
- type: 'image/png',
417
- lastModified: testTime + 1000
418
- }
419
- ]);
420
- const metadata = FileTreeHelpers.extractFileListMetadata(fileList);
421
- expect(metadata).toHaveLength(2);
422
- const pdfMeta = metadata.find((m) => m.name === 'document.pdf');
423
- expect(pdfMeta).toEqual({
424
- path: 'document.pdf',
425
- name: 'document.pdf',
426
- size: expect.any(Number),
427
- type: 'application/pdf',
428
- lastModified: testTime
429
- });
430
- const pngMeta = metadata.find((m) => m.name === 'image.png');
431
- expect(pngMeta).toEqual({
432
- path: 'image.png',
433
- name: 'image.png',
434
- size: expect.any(Number),
435
- type: 'image/png',
436
- lastModified: testTime + 1000
437
- });
438
- });
439
- test('includes webkitRelativePath in path field', () => {
440
- var _a, _b;
441
- const fileList = createMockDirectoryFileList([
442
- { path: 'project/src/main.js', content: 'main code', type: 'application/javascript' },
443
- { path: 'project/assets/logo.png', content: 'logo data', type: 'image/png' }
444
- ]);
445
- const metadata = FileTreeHelpers.extractFileListMetadata(fileList);
446
- expect(metadata).toHaveLength(2);
447
- expect((_a = metadata.find((m) => m.name === 'main.js')) === null || _a === void 0 ? void 0 : _a.path).toBe('project/src/main.js');
448
- expect((_b = metadata.find((m) => m.name === 'logo.png')) === null || _b === void 0 ? void 0 : _b.path).toBe('project/assets/logo.png');
449
- });
450
- test('handles various file sizes correctly', () => {
451
- const fileList = createMockFileList([
452
- { name: 'tiny.txt', content: '' },
453
- { name: 'small.txt', content: 'small' },
454
- { name: 'large.txt', content: 'x'.repeat(10000) }
455
- ]);
456
- const metadata = FileTreeHelpers.extractFileListMetadata(fileList);
457
- const sizes = metadata.map((m) => m.size);
458
- expect(sizes[0]).toBe(0); // empty file
459
- expect(sizes[1]).toBeGreaterThan(0); // small file
460
- expect(sizes[2]).toBeGreaterThan(sizes[1]); // large file
461
- });
462
- test('returns empty array for empty FileList', () => {
463
- const fileList = createMockFileList([]);
464
- const metadata = FileTreeHelpers.extractFileListMetadata(fileList);
465
- expect(metadata).toEqual([]);
466
- });
467
- test('preserves file order', () => {
468
- const expectedOrder = ['first.txt', 'second.txt', 'third.txt'];
469
- const fileList = createMockFileList(expectedOrder.map((name) => ({ name, content: 'content' })));
470
- const metadata = FileTreeHelpers.extractFileListMetadata(fileList);
471
- const actualOrder = metadata.map((m) => m.name);
472
- expect(actualOrder).toEqual(expectedOrder);
473
- });
474
- });
475
- describe('extractFileMetadata', () => {
476
- test('extracts metadata from single file', () => {
477
- const testTime = Date.now();
478
- const file = createMockFile({
479
- name: 'single.txt',
480
- content: 'single file content',
481
- type: 'text/plain',
482
- lastModified: testTime
483
- });
484
- const metadata = FileTreeHelpers.extractFileMetadata(file);
485
- expect(metadata).toEqual({
486
- path: 'single.txt',
487
- name: 'single.txt',
488
- size: expect.any(Number),
489
- type: 'text/plain',
490
- lastModified: testTime
491
- });
492
- });
493
- test('handles webkitRelativePath for single file', () => {
494
- const file = createMockFile({
495
- name: 'nested.txt',
496
- content: 'nested content',
497
- type: 'text/plain',
498
- webkitRelativePath: 'folder/nested.txt'
499
- });
500
- const metadata = FileTreeHelpers.extractFileMetadata(file);
501
- expect(metadata.path).toBe('folder/nested.txt');
502
- expect(metadata.name).toBe('nested.txt');
503
- });
504
- });
505
- describe('Error propagation', () => {
506
- test('propagates errors from FileApiTreeAccessors.fromFileList', async () => {
507
- const badFile = {
508
- name: 'bad.txt',
509
- size: 10,
510
- type: 'text/plain',
511
- lastModified: Date.now(),
512
- text: () => Promise.reject(new Error('File system error'))
513
- };
514
- // Create a FileList with just the bad file
515
- const dt = new DataTransfer();
516
- dt.items.add(badFile);
517
- const badFileList = dt.files;
518
- const result = await FileTreeHelpers.fromFileList(badFileList);
519
- expect(result).toFailWith(/Failed to read file/);
520
- });
521
- test('propagates errors from FileApiTreeAccessors.fromDirectoryUpload', async () => {
522
- const badFile = {
523
- name: 'bad.txt',
524
- size: 10,
525
- type: 'text/plain',
526
- lastModified: Date.now(),
527
- webkitRelativePath: 'folder/bad.txt',
528
- text: () => Promise.reject(new Error('Directory read error'))
529
- };
530
- const dt = new DataTransfer();
531
- dt.items.add(badFile);
532
- const fileList = dt.files;
533
- const result = await FileTreeHelpers.fromDirectoryUpload(fileList);
534
- expect(result).toFailWith(/Failed to read file/);
535
- });
536
- test('propagates errors from FileApiTreeAccessors.create via fromFileList', async () => {
537
- const badFile = {
538
- name: 'bad.txt',
539
- size: 10,
540
- type: 'text/plain',
541
- lastModified: Date.now(),
542
- text: () => Promise.reject(new Error('API error'))
543
- };
544
- // Create FileList with the bad file
545
- const dt = new DataTransfer();
546
- dt.items.add(badFile);
547
- const fileList = dt.files;
548
- const result = await FileTreeHelpers.fromFileList(fileList);
549
- expect(result).toFailWith(/Failed to read file/);
550
- });
551
- });
552
- describe('Integration scenarios', () => {
553
- test('handles realistic file upload scenario', async () => {
554
- const fileList = createMockFileList([
555
- { name: 'photo1.jpg', content: 'JPEG data 1', type: 'image/jpeg' },
556
- { name: 'photo2.jpg', content: 'JPEG data 2', type: 'image/jpeg' },
557
- { name: 'metadata.txt', content: 'Photo metadata', type: 'text/plain' }
558
- ]);
559
- const result = await FileTreeHelpers.fromFileList(fileList, { prefix: '/uploads' });
560
- expect(result).toSucceed();
561
- });
562
- test('handles realistic project upload scenario', async () => {
563
- const fileList = createMockDirectoryFileList([
564
- { path: 'my-app/package.json', content: '{"name": "my-app"}' },
565
- { path: 'my-app/src/index.js', content: 'console.log("Hello");' },
566
- { path: 'my-app/src/components/App.jsx', content: 'export default App;' },
567
- { path: 'my-app/public/index.html', content: '<html></html>' },
568
- { path: 'my-app/README.md', content: '# My App' }
569
- ]);
570
- const result = await FileTreeHelpers.fromDirectoryUpload(fileList);
571
- expect(result).toSucceedAndSatisfy((fileTree) => {
572
- // Verify complete project structure
573
- expect(fileTree.getDirectory('/my-app')).toSucceed();
574
- expect(fileTree.getDirectory('/my-app/src')).toSucceed();
575
- expect(fileTree.getDirectory('/my-app/src/components')).toSucceed();
576
- expect(fileTree.getDirectory('/my-app/public')).toSucceed();
577
- // Verify all files
578
- expect(fileTree.getFile('/my-app/package.json')).toSucceed();
579
- expect(fileTree.getFile('/my-app/src/index.js')).toSucceed();
580
- expect(fileTree.getFile('/my-app/src/components/App.jsx')).toSucceed();
581
- expect(fileTree.getFile('/my-app/public/index.html')).toSucceed();
582
- expect(fileTree.getFile('/my-app/README.md')).toSucceed();
583
- // Verify content access
584
- const packageContent = fileTree.hal.getFileContents('/my-app/package.json');
585
- expect(packageContent).toSucceedWith('{"name": "my-app"}');
586
- });
587
- });
588
- });
589
- });
590
- //# sourceMappingURL=fileTreeHelpers.test.js.map