@fgv/ts-web-extras 5.1.0-19 → 5.1.0-20

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 (393) hide show
  1. package/package.json +10 -10
  2. package/.rush/temp/42a7a953924ae898114e7b6231a2408228d92433.tar.log +0 -243
  3. package/.rush/temp/chunked-rush-logs/ts-web-extras.build.chunks.jsonl +0 -57
  4. package/.rush/temp/operation/build/all.log +0 -57
  5. package/.rush/temp/operation/build/log-chunks.jsonl +0 -57
  6. package/.rush/temp/operation/build/state.json +0 -3
  7. package/.rush/temp/shrinkwrap-deps.json +0 -692
  8. package/CHANGELOG.md +0 -23
  9. package/config/api-extractor.json +0 -343
  10. package/config/jest.config.json +0 -19
  11. package/config/rig.json +0 -16
  12. package/config/typedoc.json +0 -7
  13. package/dist/test/mocks/idb-keyval.js +0 -6
  14. package/dist/test/mocks/idb-keyval.js.map +0 -1
  15. package/dist/test/setupTests.js +0 -74
  16. package/dist/test/setupTests.js.map +0 -1
  17. package/dist/test/unit/browserCryptoProvider.wrapBytes.test.js +0 -221
  18. package/dist/test/unit/browserCryptoProvider.wrapBytes.test.js.map +0 -1
  19. package/dist/test/unit/browserHashProvider.test.js +0 -140
  20. package/dist/test/unit/browserHashProvider.test.js.map +0 -1
  21. package/dist/test/unit/directoryHandleStore.test.js +0 -190
  22. package/dist/test/unit/directoryHandleStore.test.js.map +0 -1
  23. package/dist/test/unit/fileApiTreeAccessors.test.js +0 -1188
  24. package/dist/test/unit/fileApiTreeAccessors.test.js.map +0 -1
  25. package/dist/test/unit/fileApiTypes.test.js +0 -472
  26. package/dist/test/unit/fileApiTypes.test.js.map +0 -1
  27. package/dist/test/unit/fileSystemAccessTreeAccessors.test.js +0 -622
  28. package/dist/test/unit/fileSystemAccessTreeAccessors.test.js.map +0 -1
  29. package/dist/test/unit/fileTreeHelpers.test.js +0 -590
  30. package/dist/test/unit/fileTreeHelpers.test.js.map +0 -1
  31. package/dist/test/unit/httpTreeAccessors.test.js +0 -1364
  32. package/dist/test/unit/httpTreeAccessors.test.js.map +0 -1
  33. package/dist/test/unit/localStorageTreeAccessors.test.js +0 -812
  34. package/dist/test/unit/localStorageTreeAccessors.test.js.map +0 -1
  35. package/dist/test/unit/urlParams.test.js +0 -393
  36. package/dist/test/unit/urlParams.test.js.map +0 -1
  37. package/dist/test/utils/fileSystemAccessMocks.js +0 -271
  38. package/dist/test/utils/fileSystemAccessMocks.js.map +0 -1
  39. package/dist/test/utils/testHelpers.js +0 -124
  40. package/dist/test/utils/testHelpers.js.map +0 -1
  41. package/docs/CryptoUtils/README.md +0 -60
  42. package/docs/CryptoUtils/classes/BrowserCryptoProvider.decrypt.md +0 -27
  43. package/docs/CryptoUtils/classes/BrowserCryptoProvider.deriveKey.md +0 -26
  44. package/docs/CryptoUtils/classes/BrowserCryptoProvider.encrypt.md +0 -25
  45. package/docs/CryptoUtils/classes/BrowserCryptoProvider.exportPublicKeyJwk.md +0 -24
  46. package/docs/CryptoUtils/classes/BrowserCryptoProvider.fromBase64.md +0 -24
  47. package/docs/CryptoUtils/classes/BrowserCryptoProvider.generateKey.md +0 -17
  48. package/docs/CryptoUtils/classes/BrowserCryptoProvider.generateKeyPair.md +0 -25
  49. package/docs/CryptoUtils/classes/BrowserCryptoProvider.generateRandomBytes.md +0 -24
  50. package/docs/CryptoUtils/classes/BrowserCryptoProvider.importPublicKeyJwk.md +0 -25
  51. package/docs/CryptoUtils/classes/BrowserCryptoProvider.md +0 -231
  52. package/docs/CryptoUtils/classes/BrowserCryptoProvider.sha256.md +0 -24
  53. package/docs/CryptoUtils/classes/BrowserCryptoProvider.toBase64.md +0 -24
  54. package/docs/CryptoUtils/classes/BrowserCryptoProvider.unwrapBytes.md +0 -27
  55. package/docs/CryptoUtils/classes/BrowserCryptoProvider.wrapBytes.md +0 -28
  56. package/docs/CryptoUtils/classes/BrowserHashProvider.hashParts.md +0 -26
  57. package/docs/CryptoUtils/classes/BrowserHashProvider.hashString.md +0 -25
  58. package/docs/CryptoUtils/classes/BrowserHashProvider.md +0 -81
  59. package/docs/CryptoUtils/functions/createBrowserCryptoProvider.md +0 -12
  60. package/docs/FileTreeHelpers/README.md +0 -85
  61. package/docs/FileTreeHelpers/functions/extractFileListMetadata.md +0 -11
  62. package/docs/FileTreeHelpers/functions/extractFileMetadata.md +0 -11
  63. package/docs/FileTreeHelpers/functions/fromDirectoryUpload.md +0 -12
  64. package/docs/FileTreeHelpers/functions/fromFileList.md +0 -12
  65. package/docs/FileTreeHelpers/functions/getOriginalFile.md +0 -11
  66. package/docs/FileTreeHelpers/variables/defaultFileApiTreeInitParams.md +0 -9
  67. package/docs/README.md +0 -524
  68. package/docs/classes/BrowserCryptoProvider.decrypt.md +0 -27
  69. package/docs/classes/BrowserCryptoProvider.deriveKey.md +0 -26
  70. package/docs/classes/BrowserCryptoProvider.encrypt.md +0 -25
  71. package/docs/classes/BrowserCryptoProvider.exportPublicKeyJwk.md +0 -24
  72. package/docs/classes/BrowserCryptoProvider.fromBase64.md +0 -24
  73. package/docs/classes/BrowserCryptoProvider.generateKey.md +0 -17
  74. package/docs/classes/BrowserCryptoProvider.generateKeyPair.md +0 -25
  75. package/docs/classes/BrowserCryptoProvider.generateRandomBytes.md +0 -24
  76. package/docs/classes/BrowserCryptoProvider.importPublicKeyJwk.md +0 -25
  77. package/docs/classes/BrowserCryptoProvider.md +0 -231
  78. package/docs/classes/BrowserCryptoProvider.sha256.md +0 -24
  79. package/docs/classes/BrowserCryptoProvider.toBase64.md +0 -24
  80. package/docs/classes/BrowserCryptoProvider.unwrapBytes.md +0 -27
  81. package/docs/classes/BrowserCryptoProvider.wrapBytes.md +0 -28
  82. package/docs/classes/BrowserHashProvider.hashParts.md +0 -26
  83. package/docs/classes/BrowserHashProvider.hashString.md +0 -25
  84. package/docs/classes/BrowserHashProvider.md +0 -81
  85. package/docs/classes/DirectoryHandleStore.getAll.md +0 -17
  86. package/docs/classes/DirectoryHandleStore.getAllLabels.md +0 -17
  87. package/docs/classes/DirectoryHandleStore.load.md +0 -24
  88. package/docs/classes/DirectoryHandleStore.md +0 -120
  89. package/docs/classes/DirectoryHandleStore.remove.md +0 -24
  90. package/docs/classes/DirectoryHandleStore.save.md +0 -25
  91. package/docs/classes/FileApiTreeAccessors.create.md +0 -25
  92. package/docs/classes/FileApiTreeAccessors.createFromHttp.md +0 -24
  93. package/docs/classes/FileApiTreeAccessors.createFromLocalStorage.md +0 -25
  94. package/docs/classes/FileApiTreeAccessors.createPersistent.md +0 -26
  95. package/docs/classes/FileApiTreeAccessors.createPersistentFromFile.md +0 -27
  96. package/docs/classes/FileApiTreeAccessors.extractFileMetadata.md +0 -24
  97. package/docs/classes/FileApiTreeAccessors.fromDirectoryUpload.md +0 -25
  98. package/docs/classes/FileApiTreeAccessors.fromFileList.md +0 -25
  99. package/docs/classes/FileApiTreeAccessors.getOriginalFile.md +0 -27
  100. package/docs/classes/FileApiTreeAccessors.md +0 -172
  101. package/docs/classes/FileSystemAccessTreeAccessors.deleteFile.md +0 -22
  102. package/docs/classes/FileSystemAccessTreeAccessors.fileIsMutable.md +0 -22
  103. package/docs/classes/FileSystemAccessTreeAccessors.fromDirectoryHandle.md +0 -25
  104. package/docs/classes/FileSystemAccessTreeAccessors.fromFileHandle.md +0 -29
  105. package/docs/classes/FileSystemAccessTreeAccessors.getDirtyPaths.md +0 -15
  106. package/docs/classes/FileSystemAccessTreeAccessors.isDirty.md +0 -15
  107. package/docs/classes/FileSystemAccessTreeAccessors.md +0 -275
  108. package/docs/classes/FileSystemAccessTreeAccessors.saveFileContents.md +0 -23
  109. package/docs/classes/FileSystemAccessTreeAccessors.syncToDisk.md +0 -15
  110. package/docs/classes/HttpTreeAccessors.deleteFile.md +0 -24
  111. package/docs/classes/HttpTreeAccessors.fileIsMutable.md +0 -24
  112. package/docs/classes/HttpTreeAccessors.fromHttp.md +0 -24
  113. package/docs/classes/HttpTreeAccessors.getDirtyPaths.md +0 -17
  114. package/docs/classes/HttpTreeAccessors.isDirty.md +0 -17
  115. package/docs/classes/HttpTreeAccessors.md +0 -261
  116. package/docs/classes/HttpTreeAccessors.saveFileContents.md +0 -25
  117. package/docs/classes/HttpTreeAccessors.syncToDisk.md +0 -22
  118. package/docs/classes/LocalStorageTreeAccessors.deleteFile.md +0 -24
  119. package/docs/classes/LocalStorageTreeAccessors.fileIsMutable.md +0 -24
  120. package/docs/classes/LocalStorageTreeAccessors.fromStorage.md +0 -25
  121. package/docs/classes/LocalStorageTreeAccessors.getDirtyPaths.md +0 -17
  122. package/docs/classes/LocalStorageTreeAccessors.isDirty.md +0 -17
  123. package/docs/classes/LocalStorageTreeAccessors.md +0 -270
  124. package/docs/classes/LocalStorageTreeAccessors.saveFileContents.md +0 -25
  125. package/docs/classes/LocalStorageTreeAccessors.syncToDisk.md +0 -17
  126. package/docs/functions/createBrowserCryptoProvider.md +0 -12
  127. package/docs/functions/exportAsJson.md +0 -12
  128. package/docs/functions/exportUsingFileSystemAPI.md +0 -11
  129. package/docs/functions/extractDirectoryPath.md +0 -13
  130. package/docs/functions/extractFileListMetadata.md +0 -11
  131. package/docs/functions/extractFileMetadata.md +0 -11
  132. package/docs/functions/fromDirectoryUpload.md +0 -12
  133. package/docs/functions/fromFileList.md +0 -12
  134. package/docs/functions/getOriginalFile.md +0 -11
  135. package/docs/functions/isDirectoryHandle.md +0 -11
  136. package/docs/functions/isFileHandle.md +0 -11
  137. package/docs/functions/isFilePath.md +0 -11
  138. package/docs/functions/parseContextFilter.md +0 -12
  139. package/docs/functions/parseQualifierDefaults.md +0 -12
  140. package/docs/functions/parseResourceTypes.md +0 -12
  141. package/docs/functions/parseUrlParameters.md +0 -11
  142. package/docs/functions/safeShowDirectoryPicker.md +0 -11
  143. package/docs/functions/safeShowOpenFilePicker.md +0 -11
  144. package/docs/functions/safeShowSaveFilePicker.md +0 -11
  145. package/docs/functions/supportsFileSystemAccess.md +0 -11
  146. package/docs/interfaces/FilePickerAcceptType.accept.md +0 -9
  147. package/docs/interfaces/FilePickerAcceptType.description.md +0 -9
  148. package/docs/interfaces/FilePickerAcceptType.md +0 -61
  149. package/docs/interfaces/FileSystemCreateWritableOptions.keepExistingData.md +0 -9
  150. package/docs/interfaces/FileSystemCreateWritableOptions.md +0 -44
  151. package/docs/interfaces/FileSystemDirectoryHandle._asyncIterator_.md +0 -13
  152. package/docs/interfaces/FileSystemDirectoryHandle.entries.md +0 -13
  153. package/docs/interfaces/FileSystemDirectoryHandle.getDirectoryHandle.md +0 -21
  154. package/docs/interfaces/FileSystemDirectoryHandle.getFileHandle.md +0 -21
  155. package/docs/interfaces/FileSystemDirectoryHandle.keys.md +0 -13
  156. package/docs/interfaces/FileSystemDirectoryHandle.kind.md +0 -9
  157. package/docs/interfaces/FileSystemDirectoryHandle.md +0 -224
  158. package/docs/interfaces/FileSystemDirectoryHandle.removeEntry.md +0 -21
  159. package/docs/interfaces/FileSystemDirectoryHandle.resolve.md +0 -20
  160. package/docs/interfaces/FileSystemDirectoryHandle.values.md +0 -13
  161. package/docs/interfaces/FileSystemFileHandle.createWritable.md +0 -20
  162. package/docs/interfaces/FileSystemFileHandle.getFile.md +0 -13
  163. package/docs/interfaces/FileSystemFileHandle.kind.md +0 -9
  164. package/docs/interfaces/FileSystemFileHandle.md +0 -146
  165. package/docs/interfaces/FileSystemGetDirectoryOptions.create.md +0 -9
  166. package/docs/interfaces/FileSystemGetDirectoryOptions.md +0 -44
  167. package/docs/interfaces/FileSystemGetFileOptions.create.md +0 -9
  168. package/docs/interfaces/FileSystemGetFileOptions.md +0 -44
  169. package/docs/interfaces/FileSystemHandle.isSameEntry.md +0 -20
  170. package/docs/interfaces/FileSystemHandle.kind.md +0 -9
  171. package/docs/interfaces/FileSystemHandle.md +0 -118
  172. package/docs/interfaces/FileSystemHandle.name.md +0 -9
  173. package/docs/interfaces/FileSystemHandle.queryPermission.md +0 -20
  174. package/docs/interfaces/FileSystemHandle.requestPermission.md +0 -20
  175. package/docs/interfaces/FileSystemHandlePermissionDescriptor.md +0 -44
  176. package/docs/interfaces/FileSystemHandlePermissionDescriptor.mode.md +0 -9
  177. package/docs/interfaces/FileSystemRemoveOptions.md +0 -44
  178. package/docs/interfaces/FileSystemRemoveOptions.recursive.md +0 -9
  179. package/docs/interfaces/FileSystemWritableFileStream.md +0 -142
  180. package/docs/interfaces/FileSystemWritableFileStream.seek.md +0 -20
  181. package/docs/interfaces/FileSystemWritableFileStream.truncate.md +0 -20
  182. package/docs/interfaces/FileSystemWritableFileStream.write.md +0 -20
  183. package/docs/interfaces/IDirectoryHandleTreeInitializer.dirHandles.md +0 -9
  184. package/docs/interfaces/IDirectoryHandleTreeInitializer.md +0 -78
  185. package/docs/interfaces/IDirectoryHandleTreeInitializer.nonRecursive.md +0 -9
  186. package/docs/interfaces/IDirectoryHandleTreeInitializer.prefix.md +0 -9
  187. package/docs/interfaces/IFileHandleTreeInitializer.fileHandles.md +0 -9
  188. package/docs/interfaces/IFileHandleTreeInitializer.md +0 -61
  189. package/docs/interfaces/IFileHandleTreeInitializer.prefix.md +0 -9
  190. package/docs/interfaces/IFileListTreeInitializer.fileList.md +0 -9
  191. package/docs/interfaces/IFileListTreeInitializer.md +0 -44
  192. package/docs/interfaces/IFileMetadata.lastModified.md +0 -9
  193. package/docs/interfaces/IFileMetadata.md +0 -112
  194. package/docs/interfaces/IFileMetadata.name.md +0 -9
  195. package/docs/interfaces/IFileMetadata.path.md +0 -9
  196. package/docs/interfaces/IFileMetadata.size.md +0 -9
  197. package/docs/interfaces/IFileMetadata.type.md +0 -9
  198. package/docs/interfaces/IFileSystemAccessTreeParams.autoSync.md +0 -12
  199. package/docs/interfaces/IFileSystemAccessTreeParams.filePath.md +0 -13
  200. package/docs/interfaces/IFileSystemAccessTreeParams.logger.md +0 -11
  201. package/docs/interfaces/IFileSystemAccessTreeParams.md +0 -148
  202. package/docs/interfaces/IFileSystemAccessTreeParams.requireWritePermission.md +0 -13
  203. package/docs/interfaces/IFsAccessApis.md +0 -62
  204. package/docs/interfaces/IFsAccessApis.showDirectoryPicker.md +0 -20
  205. package/docs/interfaces/IFsAccessApis.showOpenFilePicker.md +0 -20
  206. package/docs/interfaces/IFsAccessApis.showSaveFilePicker.md +0 -20
  207. package/docs/interfaces/IHttpTreeParams.autoSync.md +0 -9
  208. package/docs/interfaces/IHttpTreeParams.baseUrl.md +0 -9
  209. package/docs/interfaces/IHttpTreeParams.fetchImpl.md +0 -9
  210. package/docs/interfaces/IHttpTreeParams.logger.md +0 -9
  211. package/docs/interfaces/IHttpTreeParams.md +0 -182
  212. package/docs/interfaces/IHttpTreeParams.namespace.md +0 -9
  213. package/docs/interfaces/IHttpTreeParams.userId.md +0 -9
  214. package/docs/interfaces/ILocalStorageTreeParams.autoSync.md +0 -12
  215. package/docs/interfaces/ILocalStorageTreeParams.md +0 -131
  216. package/docs/interfaces/ILocalStorageTreeParams.pathToKeyMap.md +0 -13
  217. package/docs/interfaces/ILocalStorageTreeParams.storage.md +0 -12
  218. package/docs/interfaces/IUrlConfigOptions.config.md +0 -11
  219. package/docs/interfaces/IUrlConfigOptions.configStartDir.md +0 -11
  220. package/docs/interfaces/IUrlConfigOptions.contextFilter.md +0 -11
  221. package/docs/interfaces/IUrlConfigOptions.input.md +0 -11
  222. package/docs/interfaces/IUrlConfigOptions.inputStartDir.md +0 -11
  223. package/docs/interfaces/IUrlConfigOptions.interactive.md +0 -11
  224. package/docs/interfaces/IUrlConfigOptions.loadZip.md +0 -11
  225. package/docs/interfaces/IUrlConfigOptions.maxDistance.md +0 -11
  226. package/docs/interfaces/IUrlConfigOptions.md +0 -248
  227. package/docs/interfaces/IUrlConfigOptions.qualifierDefaults.md +0 -11
  228. package/docs/interfaces/IUrlConfigOptions.reduceQualifiers.md +0 -11
  229. package/docs/interfaces/IUrlConfigOptions.resourceTypes.md +0 -11
  230. package/docs/interfaces/IUrlConfigOptions.zipFile.md +0 -11
  231. package/docs/interfaces/IUrlConfigOptions.zipPath.md +0 -11
  232. package/docs/interfaces/ShowDirectoryPickerOptions.id.md +0 -9
  233. package/docs/interfaces/ShowDirectoryPickerOptions.md +0 -78
  234. package/docs/interfaces/ShowDirectoryPickerOptions.mode.md +0 -9
  235. package/docs/interfaces/ShowDirectoryPickerOptions.startIn.md +0 -9
  236. package/docs/interfaces/ShowOpenFilePickerOptions.excludeAcceptAllOption.md +0 -9
  237. package/docs/interfaces/ShowOpenFilePickerOptions.id.md +0 -9
  238. package/docs/interfaces/ShowOpenFilePickerOptions.md +0 -112
  239. package/docs/interfaces/ShowOpenFilePickerOptions.multiple.md +0 -9
  240. package/docs/interfaces/ShowOpenFilePickerOptions.startIn.md +0 -9
  241. package/docs/interfaces/ShowOpenFilePickerOptions.types.md +0 -9
  242. package/docs/interfaces/ShowSaveFilePickerOptions.excludeAcceptAllOption.md +0 -9
  243. package/docs/interfaces/ShowSaveFilePickerOptions.id.md +0 -9
  244. package/docs/interfaces/ShowSaveFilePickerOptions.md +0 -112
  245. package/docs/interfaces/ShowSaveFilePickerOptions.startIn.md +0 -9
  246. package/docs/interfaces/ShowSaveFilePickerOptions.suggestedName.md +0 -9
  247. package/docs/interfaces/ShowSaveFilePickerOptions.types.md +0 -9
  248. package/docs/type-aliases/TreeInitializer.md +0 -11
  249. package/docs/type-aliases/WellKnownDirectory.md +0 -11
  250. package/docs/type-aliases/WindowWithFsAccess.md +0 -11
  251. package/docs/variables/DEFAULT_DIRECTORY_HANDLE_DB.md +0 -9
  252. package/docs/variables/DEFAULT_DIRECTORY_HANDLE_STORE.md +0 -9
  253. package/docs/variables/defaultFileApiTreeInitParams.md +0 -9
  254. package/etc/ts-web-extras.api.md +0 -439
  255. package/lib/test/mocks/idb-keyval.d.ts +0 -6
  256. package/lib/test/mocks/idb-keyval.d.ts.map +0 -1
  257. package/lib/test/mocks/idb-keyval.js +0 -9
  258. package/lib/test/mocks/idb-keyval.js.map +0 -1
  259. package/lib/test/setupTests.d.ts +0 -2
  260. package/lib/test/setupTests.d.ts.map +0 -1
  261. package/lib/test/setupTests.js +0 -76
  262. package/lib/test/setupTests.js.map +0 -1
  263. package/lib/test/unit/browserCryptoProvider.wrapBytes.test.d.ts +0 -2
  264. package/lib/test/unit/browserCryptoProvider.wrapBytes.test.d.ts.map +0 -1
  265. package/lib/test/unit/browserCryptoProvider.wrapBytes.test.js +0 -223
  266. package/lib/test/unit/browserCryptoProvider.wrapBytes.test.js.map +0 -1
  267. package/lib/test/unit/browserHashProvider.test.d.ts +0 -2
  268. package/lib/test/unit/browserHashProvider.test.d.ts.map +0 -1
  269. package/lib/test/unit/browserHashProvider.test.js +0 -142
  270. package/lib/test/unit/browserHashProvider.test.js.map +0 -1
  271. package/lib/test/unit/directoryHandleStore.test.d.ts +0 -2
  272. package/lib/test/unit/directoryHandleStore.test.d.ts.map +0 -1
  273. package/lib/test/unit/directoryHandleStore.test.js +0 -192
  274. package/lib/test/unit/directoryHandleStore.test.js.map +0 -1
  275. package/lib/test/unit/fileApiTreeAccessors.test.d.ts +0 -2
  276. package/lib/test/unit/fileApiTreeAccessors.test.d.ts.map +0 -1
  277. package/lib/test/unit/fileApiTreeAccessors.test.js +0 -1190
  278. package/lib/test/unit/fileApiTreeAccessors.test.js.map +0 -1
  279. package/lib/test/unit/fileApiTypes.test.d.ts +0 -2
  280. package/lib/test/unit/fileApiTypes.test.d.ts.map +0 -1
  281. package/lib/test/unit/fileApiTypes.test.js +0 -474
  282. package/lib/test/unit/fileApiTypes.test.js.map +0 -1
  283. package/lib/test/unit/fileSystemAccessTreeAccessors.test.d.ts +0 -2
  284. package/lib/test/unit/fileSystemAccessTreeAccessors.test.d.ts.map +0 -1
  285. package/lib/test/unit/fileSystemAccessTreeAccessors.test.js +0 -624
  286. package/lib/test/unit/fileSystemAccessTreeAccessors.test.js.map +0 -1
  287. package/lib/test/unit/fileTreeHelpers.test.d.ts +0 -2
  288. package/lib/test/unit/fileTreeHelpers.test.d.ts.map +0 -1
  289. package/lib/test/unit/fileTreeHelpers.test.js +0 -592
  290. package/lib/test/unit/fileTreeHelpers.test.js.map +0 -1
  291. package/lib/test/unit/httpTreeAccessors.test.d.ts +0 -2
  292. package/lib/test/unit/httpTreeAccessors.test.d.ts.map +0 -1
  293. package/lib/test/unit/httpTreeAccessors.test.js +0 -1366
  294. package/lib/test/unit/httpTreeAccessors.test.js.map +0 -1
  295. package/lib/test/unit/localStorageTreeAccessors.test.d.ts +0 -2
  296. package/lib/test/unit/localStorageTreeAccessors.test.d.ts.map +0 -1
  297. package/lib/test/unit/localStorageTreeAccessors.test.js +0 -814
  298. package/lib/test/unit/localStorageTreeAccessors.test.js.map +0 -1
  299. package/lib/test/unit/urlParams.test.d.ts +0 -2
  300. package/lib/test/unit/urlParams.test.d.ts.map +0 -1
  301. package/lib/test/unit/urlParams.test.js +0 -395
  302. package/lib/test/unit/urlParams.test.js.map +0 -1
  303. package/lib/test/utils/fileSystemAccessMocks.d.ts +0 -53
  304. package/lib/test/utils/fileSystemAccessMocks.d.ts.map +0 -1
  305. package/lib/test/utils/fileSystemAccessMocks.js +0 -277
  306. package/lib/test/utils/fileSystemAccessMocks.js.map +0 -1
  307. package/lib/test/utils/testHelpers.d.ts +0 -51
  308. package/lib/test/utils/testHelpers.d.ts.map +0 -1
  309. package/lib/test/utils/testHelpers.js +0 -133
  310. package/lib/test/utils/testHelpers.js.map +0 -1
  311. package/rush-logs/ts-web-extras.build.cache.log +0 -3
  312. package/rush-logs/ts-web-extras.build.log +0 -57
  313. package/src/index.browser.ts +0 -24
  314. package/src/index.ts +0 -47
  315. package/src/packlets/crypto-utils/browserCryptoProvider.ts +0 -553
  316. package/src/packlets/crypto-utils/browserHashProvider.ts +0 -73
  317. package/src/packlets/crypto-utils/index.ts +0 -29
  318. package/src/packlets/file-api-types/index.ts +0 -366
  319. package/src/packlets/file-tree/directoryHandleStore.ts +0 -136
  320. package/src/packlets/file-tree/fileApiTreeAccessors.ts +0 -528
  321. package/src/packlets/file-tree/fileSystemAccessTreeAccessors.ts +0 -519
  322. package/src/packlets/file-tree/httpTreeAccessors.ts +0 -478
  323. package/src/packlets/file-tree/index.ts +0 -32
  324. package/src/packlets/file-tree/localStorageTreeAccessors.ts +0 -430
  325. package/src/packlets/helpers/fileTreeHelpers.ts +0 -107
  326. package/src/packlets/helpers/index.ts +0 -28
  327. package/src/packlets/url-utils/index.ts +0 -28
  328. package/src/packlets/url-utils/urlParams.ts +0 -245
  329. package/src/test/mocks/idb-keyval.ts +0 -5
  330. package/src/test/setupTests.ts +0 -87
  331. package/src/test/unit/browserCryptoProvider.wrapBytes.test.ts +0 -325
  332. package/src/test/unit/browserHashProvider.test.ts +0 -155
  333. package/src/test/unit/browserHashProvider.test.ts.bak +0 -376
  334. package/src/test/unit/directoryHandleStore.test.ts +0 -251
  335. package/src/test/unit/fileApiTreeAccessors.test.ts +0 -1387
  336. package/src/test/unit/fileApiTypes.test.ts +0 -587
  337. package/src/test/unit/fileSystemAccessTreeAccessors.test.ts +0 -885
  338. package/src/test/unit/fileTreeHelpers.test.ts +0 -694
  339. package/src/test/unit/httpTreeAccessors.test.ts +0 -1750
  340. package/src/test/unit/localStorageTreeAccessors.test.ts +0 -1014
  341. package/src/test/unit/urlParams.test.ts +0 -464
  342. package/src/test/utils/fileSystemAccessMocks.ts +0 -353
  343. package/src/test/utils/testHelpers.ts +0 -155
  344. package/temp/build/typescript/ts_8nwakTlr.json +0 -1
  345. package/temp/coverage/base.css +0 -224
  346. package/temp/coverage/block-navigation.js +0 -87
  347. package/temp/coverage/crypto-utils/browserCryptoProvider.ts.html +0 -1744
  348. package/temp/coverage/crypto-utils/browserHashProvider.ts.html +0 -304
  349. package/temp/coverage/crypto-utils/index.html +0 -131
  350. package/temp/coverage/favicon.png +0 -0
  351. package/temp/coverage/file-tree/directoryHandleStore.ts.html +0 -493
  352. package/temp/coverage/file-tree/fileApiTreeAccessors.ts.html +0 -1669
  353. package/temp/coverage/file-tree/fileSystemAccessTreeAccessors.ts.html +0 -1642
  354. package/temp/coverage/file-tree/httpTreeAccessors.ts.html +0 -1519
  355. package/temp/coverage/file-tree/index.html +0 -176
  356. package/temp/coverage/file-tree/localStorageTreeAccessors.ts.html +0 -1375
  357. package/temp/coverage/helpers/fileTreeHelpers.ts.html +0 -406
  358. package/temp/coverage/helpers/index.html +0 -116
  359. package/temp/coverage/index.html +0 -161
  360. package/temp/coverage/lcov-report/base.css +0 -224
  361. package/temp/coverage/lcov-report/block-navigation.js +0 -87
  362. package/temp/coverage/lcov-report/crypto-utils/browserCryptoProvider.ts.html +0 -1744
  363. package/temp/coverage/lcov-report/crypto-utils/browserHashProvider.ts.html +0 -304
  364. package/temp/coverage/lcov-report/crypto-utils/index.html +0 -131
  365. package/temp/coverage/lcov-report/favicon.png +0 -0
  366. package/temp/coverage/lcov-report/file-tree/directoryHandleStore.ts.html +0 -493
  367. package/temp/coverage/lcov-report/file-tree/fileApiTreeAccessors.ts.html +0 -1669
  368. package/temp/coverage/lcov-report/file-tree/fileSystemAccessTreeAccessors.ts.html +0 -1642
  369. package/temp/coverage/lcov-report/file-tree/httpTreeAccessors.ts.html +0 -1519
  370. package/temp/coverage/lcov-report/file-tree/index.html +0 -176
  371. package/temp/coverage/lcov-report/file-tree/localStorageTreeAccessors.ts.html +0 -1375
  372. package/temp/coverage/lcov-report/helpers/fileTreeHelpers.ts.html +0 -406
  373. package/temp/coverage/lcov-report/helpers/index.html +0 -116
  374. package/temp/coverage/lcov-report/index.html +0 -161
  375. package/temp/coverage/lcov-report/prettify.css +0 -1
  376. package/temp/coverage/lcov-report/prettify.js +0 -2
  377. package/temp/coverage/lcov-report/sort-arrow-sprite.png +0 -0
  378. package/temp/coverage/lcov-report/sorter.js +0 -210
  379. package/temp/coverage/lcov-report/url-utils/index.html +0 -116
  380. package/temp/coverage/lcov-report/url-utils/urlParams.ts.html +0 -820
  381. package/temp/coverage/lcov.info +0 -3924
  382. package/temp/coverage/prettify.css +0 -1
  383. package/temp/coverage/prettify.js +0 -2
  384. package/temp/coverage/sort-arrow-sprite.png +0 -0
  385. package/temp/coverage/sorter.js +0 -210
  386. package/temp/coverage/url-utils/index.html +0 -116
  387. package/temp/coverage/url-utils/urlParams.ts.html +0 -820
  388. package/temp/test/jest/haste-map-7492f1b44480e0cdd1f220078fb3afd8-c8dd6c3430605adeb2f1cadf4f75e791-8c9336785555d572065b28c111982ba4 +0 -0
  389. package/temp/test/jest/jest-transform-cache-7492f1b44480e0cdd1f220078fb3afd8-79ef2876fae7ca75eedb2aa53dc48338/8a/package_8a7abbb163935a14e582220d11872de3 +0 -53
  390. package/temp/test/jest/perf-cache-7492f1b44480e0cdd1f220078fb3afd8-da39a3ee5e6b4b0d3255bfef95601890 +0 -1
  391. package/temp/ts-web-extras.api.json +0 -9373
  392. package/temp/ts-web-extras.api.md +0 -439
  393. package/tsconfig.json +0 -7
@@ -1,814 +0,0 @@
1
- "use strict";
2
- /*
3
- * Copyright (c) 2026 Erik Fortune
4
- *
5
- * Permission is hereby granted, free of charge, to any person obtaining a copy
6
- * of this software and associated documentation files (the "Software"), to deal
7
- * in the Software without restriction, including without limitation the rights
8
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- * copies of the Software, and to permit persons to whom the Software is
10
- * furnished to do so, subject to the following conditions:
11
- *
12
- * The above copyright notice and this permission notice shall be included in all
13
- * copies or substantial portions of the Software.
14
- *
15
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- * SOFTWARE.
22
- */
23
- Object.defineProperty(exports, "__esModule", { value: true });
24
- require("@fgv/ts-utils-jest");
25
- const ts_json_base_1 = require("@fgv/ts-json-base");
26
- const file_tree_1 = require("../../packlets/file-tree");
27
- /**
28
- * Mock Storage implementation for testing
29
- */
30
- class MockStorage {
31
- constructor() {
32
- this._data = new Map();
33
- }
34
- get length() {
35
- return this._data.size;
36
- }
37
- clear() {
38
- this._data.clear();
39
- }
40
- getItem(key) {
41
- var _a;
42
- return (_a = this._data.get(key)) !== null && _a !== void 0 ? _a : null;
43
- }
44
- key(index) {
45
- var _a;
46
- const keys = Array.from(this._data.keys());
47
- return (_a = keys[index]) !== null && _a !== void 0 ? _a : null;
48
- }
49
- removeItem(key) {
50
- this._data.delete(key);
51
- }
52
- setItem(key, value) {
53
- this._data.set(key, value);
54
- }
55
- }
56
- describe('LocalStorageTreeAccessors', () => {
57
- let mockStorage;
58
- beforeEach(() => {
59
- mockStorage = new MockStorage();
60
- });
61
- describe('fromStorage', () => {
62
- test('creates accessors from empty storage', () => {
63
- const result = file_tree_1.LocalStorageTreeAccessors.fromStorage({
64
- pathToKeyMap: {
65
- '/data/ingredients': 'test:ingredients:v1'
66
- },
67
- storage: mockStorage
68
- });
69
- expect(result).toSucceedAndSatisfy((accessors) => {
70
- expect(accessors).toBeInstanceOf(file_tree_1.LocalStorageTreeAccessors);
71
- expect(accessors.isDirty()).toBe(false);
72
- });
73
- });
74
- test('loads collections from storage', () => {
75
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({
76
- collection1: { items: { item1: {} } },
77
- collection2: { items: { item2: {} } }
78
- }));
79
- const result = file_tree_1.LocalStorageTreeAccessors.fromStorage({
80
- pathToKeyMap: {
81
- '/data/ingredients': 'test:ingredients:v1'
82
- },
83
- storage: mockStorage
84
- });
85
- expect(result).toSucceedAndSatisfy((accessors) => {
86
- expect(accessors.getFileContents('/data/ingredients/collection1.json')).toSucceed();
87
- expect(accessors.getFileContents('/data/ingredients/collection2.json')).toSucceed();
88
- });
89
- });
90
- test('loads from multiple storage keys', () => {
91
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({ ing1: { items: {} } }));
92
- mockStorage.setItem('test:fillings:v1', JSON.stringify({ fill1: { items: {} } }));
93
- const result = file_tree_1.LocalStorageTreeAccessors.fromStorage({
94
- pathToKeyMap: {
95
- '/data/ingredients': 'test:ingredients:v1',
96
- '/data/fillings': 'test:fillings:v1'
97
- },
98
- storage: mockStorage
99
- });
100
- expect(result).toSucceedAndSatisfy((accessors) => {
101
- expect(accessors.getFileContents('/data/ingredients/ing1.json')).toSucceed();
102
- expect(accessors.getFileContents('/data/fillings/fill1.json')).toSucceed();
103
- });
104
- });
105
- test('skips corrupted JSON data', () => {
106
- mockStorage.setItem('test:ingredients:v1', 'not valid json');
107
- const result = file_tree_1.LocalStorageTreeAccessors.fromStorage({
108
- pathToKeyMap: {
109
- '/data/ingredients': 'test:ingredients:v1'
110
- },
111
- storage: mockStorage
112
- });
113
- expect(result).toSucceedAndSatisfy((accessors) => {
114
- expect(accessors).toBeInstanceOf(file_tree_1.LocalStorageTreeAccessors);
115
- });
116
- });
117
- test('skips non-object JSON', () => {
118
- mockStorage.setItem('test:ingredients:v1', '"string value"');
119
- const result = file_tree_1.LocalStorageTreeAccessors.fromStorage({
120
- pathToKeyMap: {
121
- '/data/ingredients': 'test:ingredients:v1'
122
- },
123
- storage: mockStorage
124
- });
125
- expect(result).toSucceedAndSatisfy((accessors) => {
126
- expect(accessors).toBeInstanceOf(file_tree_1.LocalStorageTreeAccessors);
127
- });
128
- });
129
- test('loads string values (new format) with inferred extension', () => {
130
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({
131
- jsonCollection: '{"items":{}}',
132
- yamlCollection: 'metadata:\n name: test\nitems: {}'
133
- }));
134
- const result = file_tree_1.LocalStorageTreeAccessors.fromStorage({
135
- pathToKeyMap: {
136
- '/data/ingredients': 'test:ingredients:v1'
137
- },
138
- storage: mockStorage
139
- });
140
- expect(result).toSucceedAndSatisfy((accessors) => {
141
- expect(accessors.getFileContents('/data/ingredients/jsonCollection.json')).toSucceedWith('{"items":{}}');
142
- expect(accessors.getFileContents('/data/ingredients/yamlCollection.yaml')).toSucceedWith('metadata:\n name: test\nitems: {}');
143
- });
144
- });
145
- test('skips non-object non-string collection values', () => {
146
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({
147
- good: { items: {} },
148
- bad: 42
149
- }));
150
- const result = file_tree_1.LocalStorageTreeAccessors.fromStorage({
151
- pathToKeyMap: {
152
- '/data/ingredients': 'test:ingredients:v1'
153
- },
154
- storage: mockStorage
155
- });
156
- expect(result).toSucceedAndSatisfy((accessors) => {
157
- expect(accessors.getFileContents('/data/ingredients/good.json')).toSucceed();
158
- });
159
- });
160
- test('applies prefix parameter', () => {
161
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({ collection1: { items: {} } }));
162
- const result = file_tree_1.LocalStorageTreeAccessors.fromStorage({
163
- pathToKeyMap: {
164
- '/data/ingredients': 'test:ingredients:v1'
165
- },
166
- storage: mockStorage,
167
- prefix: '/myapp'
168
- });
169
- expect(result).toSucceedAndSatisfy((accessors) => {
170
- expect(accessors.getFileContents('/myapp/data/ingredients/collection1.json')).toSucceed();
171
- });
172
- });
173
- test('succeeds with empty storage when no data present', () => {
174
- const result = file_tree_1.LocalStorageTreeAccessors.fromStorage({
175
- pathToKeyMap: {
176
- '/data/ingredients': 'test:ingredients:v1'
177
- },
178
- storage: mockStorage
179
- });
180
- expect(result).toSucceedAndSatisfy((accessors) => {
181
- expect(accessors).toBeInstanceOf(file_tree_1.LocalStorageTreeAccessors);
182
- });
183
- });
184
- });
185
- describe('dirty tracking', () => {
186
- test('starts with no dirty files', () => {
187
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({ collection1: { items: {} } }));
188
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
189
- pathToKeyMap: {
190
- '/data/ingredients': 'test:ingredients:v1'
191
- },
192
- storage: mockStorage,
193
- mutable: true
194
- }).orThrow();
195
- expect(accessors.isDirty()).toBe(false);
196
- expect(accessors.getDirtyPaths()).toEqual([]);
197
- });
198
- test('marks files as dirty after modification', () => {
199
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({ collection1: { items: {} } }));
200
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
201
- pathToKeyMap: {
202
- '/data/ingredients': 'test:ingredients:v1'
203
- },
204
- storage: mockStorage,
205
- mutable: true
206
- }).orThrow();
207
- const newContent = JSON.stringify({ items: { modified: true } });
208
- accessors.saveFileContents('/data/ingredients/collection1.json', newContent).orThrow();
209
- expect(accessors.isDirty()).toBe(true);
210
- expect(accessors.getDirtyPaths()).toContain('/data/ingredients/collection1.json');
211
- });
212
- test('tracks multiple dirty files', () => {
213
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({
214
- collection1: { items: {} },
215
- collection2: { items: {} }
216
- }));
217
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
218
- pathToKeyMap: {
219
- '/data/ingredients': 'test:ingredients:v1'
220
- },
221
- storage: mockStorage,
222
- mutable: true
223
- }).orThrow();
224
- accessors
225
- .saveFileContents('/data/ingredients/collection1.json', JSON.stringify({ items: { a: 1 } }))
226
- .orThrow();
227
- accessors
228
- .saveFileContents('/data/ingredients/collection2.json', JSON.stringify({ items: { b: 2 } }))
229
- .orThrow();
230
- expect(accessors.isDirty()).toBe(true);
231
- expect(accessors.getDirtyPaths()).toHaveLength(2);
232
- });
233
- });
234
- describe('syncToDisk', () => {
235
- test('syncs modified files to storage', async () => {
236
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({ collection1: { items: { original: true } } }));
237
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
238
- pathToKeyMap: {
239
- '/data/ingredients': 'test:ingredients:v1'
240
- },
241
- storage: mockStorage,
242
- mutable: true
243
- }).orThrow();
244
- const newContent = JSON.stringify({ items: { modified: true } });
245
- accessors.saveFileContents('/data/ingredients/collection1.json', newContent).orThrow();
246
- const syncResult = await accessors.syncToDisk();
247
- expect(syncResult).toSucceed();
248
- const stored = mockStorage.getItem('test:ingredients:v1');
249
- expect(stored).toBeTruthy();
250
- const parsed = JSON.parse(stored);
251
- // New format: values are raw content strings
252
- expect(parsed.collection1).toBe(newContent);
253
- });
254
- test('clears dirty state after successful sync', async () => {
255
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({ collection1: { items: {} } }));
256
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
257
- pathToKeyMap: {
258
- '/data/ingredients': 'test:ingredients:v1'
259
- },
260
- storage: mockStorage,
261
- mutable: true
262
- }).orThrow();
263
- accessors
264
- .saveFileContents('/data/ingredients/collection1.json', JSON.stringify({ items: { a: 1 } }))
265
- .orThrow();
266
- expect(accessors.isDirty()).toBe(true);
267
- await accessors.syncToDisk();
268
- expect(accessors.isDirty()).toBe(false);
269
- expect(accessors.getDirtyPaths()).toEqual([]);
270
- });
271
- test('syncs multiple files to same storage key', async () => {
272
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({
273
- collection1: { items: {} },
274
- collection2: { items: {} }
275
- }));
276
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
277
- pathToKeyMap: {
278
- '/data/ingredients': 'test:ingredients:v1'
279
- },
280
- storage: mockStorage,
281
- mutable: true
282
- }).orThrow();
283
- const content1 = JSON.stringify({ items: { a: 1 } });
284
- const content2 = JSON.stringify({ items: { b: 2 } });
285
- accessors.saveFileContents('/data/ingredients/collection1.json', content1).orThrow();
286
- accessors.saveFileContents('/data/ingredients/collection2.json', content2).orThrow();
287
- await accessors.syncToDisk();
288
- const stored = mockStorage.getItem('test:ingredients:v1');
289
- const parsed = JSON.parse(stored);
290
- // New format: values are raw content strings
291
- expect(parsed.collection1).toBe(content1);
292
- expect(parsed.collection2).toBe(content2);
293
- });
294
- test('syncs files to different storage keys', async () => {
295
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({ ing1: { items: {} } }));
296
- mockStorage.setItem('test:fillings:v1', JSON.stringify({ fill1: { items: {} } }));
297
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
298
- pathToKeyMap: {
299
- '/data/ingredients': 'test:ingredients:v1',
300
- '/data/fillings': 'test:fillings:v1'
301
- },
302
- storage: mockStorage,
303
- mutable: true
304
- }).orThrow();
305
- accessors
306
- .saveFileContents('/data/ingredients/ing1.json', JSON.stringify({ items: { a: 1 } }))
307
- .orThrow();
308
- accessors.saveFileContents('/data/fillings/fill1.json', JSON.stringify({ items: { b: 2 } })).orThrow();
309
- await accessors.syncToDisk();
310
- const ingContent = JSON.stringify({ items: { a: 1 } });
311
- const fillContent = JSON.stringify({ items: { b: 2 } });
312
- const ingStored = JSON.parse(mockStorage.getItem('test:ingredients:v1'));
313
- const fillStored = JSON.parse(mockStorage.getItem('test:fillings:v1'));
314
- // New format: values are raw content strings
315
- expect(ingStored.ing1).toBe(ingContent);
316
- expect(fillStored.fill1).toBe(fillContent);
317
- });
318
- test('succeeds with no dirty files', async () => {
319
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
320
- pathToKeyMap: {
321
- '/data/ingredients': 'test:ingredients:v1'
322
- },
323
- storage: mockStorage
324
- }).orThrow();
325
- const result = await accessors.syncToDisk();
326
- expect(result).toSucceed();
327
- });
328
- test('preserves existing collections when syncing', async () => {
329
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({
330
- existing: { items: { keep: true } },
331
- toModify: { items: { original: true } }
332
- }));
333
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
334
- pathToKeyMap: {
335
- '/data/ingredients': 'test:ingredients:v1'
336
- },
337
- storage: mockStorage,
338
- mutable: true
339
- }).orThrow();
340
- const modifiedContent = JSON.stringify({ items: { modified: true } });
341
- accessors.saveFileContents('/data/ingredients/toModify.json', modifiedContent).orThrow();
342
- await accessors.syncToDisk();
343
- const stored = JSON.parse(mockStorage.getItem('test:ingredients:v1'));
344
- // existing was loaded from legacy format and not modified, so it stays as legacy object
345
- // toModify was saved with new content, so it's now a raw string
346
- expect(stored.toModify).toBe(modifiedContent);
347
- });
348
- });
349
- describe('autoSync mode', () => {
350
- test('automatically syncs on save when enabled', () => {
351
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({ collection1: { items: {} } }));
352
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
353
- pathToKeyMap: {
354
- '/data/ingredients': 'test:ingredients:v1'
355
- },
356
- storage: mockStorage,
357
- mutable: true,
358
- autoSync: true
359
- }).orThrow();
360
- accessors
361
- .saveFileContents('/data/ingredients/collection1.json', JSON.stringify({ items: { auto: true } }))
362
- .orThrow();
363
- expect(accessors.isDirty()).toBe(false);
364
- const autoContent = JSON.stringify({ items: { auto: true } });
365
- const stored = JSON.parse(mockStorage.getItem('test:ingredients:v1'));
366
- // New format: values are raw content strings
367
- expect(stored.collection1).toBe(autoContent);
368
- });
369
- test('does not auto-sync when disabled', () => {
370
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({ collection1: { items: {} } }));
371
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
372
- pathToKeyMap: {
373
- '/data/ingredients': 'test:ingredients:v1'
374
- },
375
- storage: mockStorage,
376
- mutable: true,
377
- autoSync: false
378
- }).orThrow();
379
- accessors
380
- .saveFileContents('/data/ingredients/collection1.json', JSON.stringify({ items: { manual: true } }))
381
- .orThrow();
382
- expect(accessors.isDirty()).toBe(true);
383
- // Storage should still have the original legacy format (not yet synced)
384
- const stored = JSON.parse(mockStorage.getItem('test:ingredients:v1'));
385
- expect(stored.collection1).toEqual({ items: {} });
386
- });
387
- });
388
- describe('fileIsMutable', () => {
389
- test('returns persistent detail when mutable', () => {
390
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({ collection1: { items: {} } }));
391
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
392
- pathToKeyMap: {
393
- '/data/ingredients': 'test:ingredients:v1'
394
- },
395
- storage: mockStorage,
396
- mutable: true
397
- }).orThrow();
398
- expect(accessors.fileIsMutable('/data/ingredients/collection1.json')).toSucceedWithDetail(true, 'persistent');
399
- });
400
- test('returns not-mutable when not mutable', () => {
401
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({ collection1: { items: {} } }));
402
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
403
- pathToKeyMap: {
404
- '/data/ingredients': 'test:ingredients:v1'
405
- },
406
- storage: mockStorage,
407
- mutable: false
408
- }).orThrow();
409
- const result = accessors.fileIsMutable('/data/ingredients/collection1.json');
410
- expect(result.isFailure()).toBe(true);
411
- if (result.isFailure()) {
412
- expect(result.detail).toBe('not-mutable');
413
- }
414
- });
415
- });
416
- describe('integration with FileApiTreeAccessors', () => {
417
- test('createFromLocalStorage creates FileTree with persistent accessors', () => {
418
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({ collection1: { items: {} } }));
419
- const result = file_tree_1.FileApiTreeAccessors.createFromLocalStorage({
420
- pathToKeyMap: {
421
- '/data/ingredients': 'test:ingredients:v1'
422
- },
423
- storage: mockStorage,
424
- mutable: true
425
- });
426
- expect(result).toSucceed();
427
- const tree = result.orThrow();
428
- expect(tree).toBeInstanceOf(ts_json_base_1.FileTree.FileTree);
429
- expect(ts_json_base_1.FileTree.isPersistentAccessors(tree.hal)).toBe(true);
430
- const file = tree.getFile('/data/ingredients/collection1.json').orThrow();
431
- expect(ts_json_base_1.FileTree.isMutableFileItem(file)).toBe(true);
432
- if (ts_json_base_1.FileTree.isMutableFileItem(file)) {
433
- expect(file.getIsMutable()).toSucceedWithDetail(true, 'persistent');
434
- }
435
- });
436
- test('createFromLocalStorage with multiple paths', () => {
437
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({ ing1: { items: {} } }));
438
- mockStorage.setItem('test:fillings:v1', JSON.stringify({ fill1: { items: {} } }));
439
- const result = file_tree_1.FileApiTreeAccessors.createFromLocalStorage({
440
- pathToKeyMap: {
441
- '/data/ingredients': 'test:ingredients:v1',
442
- '/data/fillings': 'test:fillings:v1'
443
- },
444
- storage: mockStorage,
445
- mutable: true
446
- });
447
- expect(result).toSucceedAndSatisfy((tree) => {
448
- expect(tree.getFile('/data/ingredients/ing1.json')).toSucceed();
449
- expect(tree.getFile('/data/fillings/fill1.json')).toSucceed();
450
- });
451
- });
452
- test('createFromLocalStorage with empty storage', () => {
453
- const result = file_tree_1.FileApiTreeAccessors.createFromLocalStorage({
454
- pathToKeyMap: {
455
- '/data/ingredients': 'test:ingredients:v1'
456
- },
457
- storage: mockStorage
458
- });
459
- expect(result).toSucceedAndSatisfy((tree) => {
460
- expect(tree).toBeInstanceOf(ts_json_base_1.FileTree.FileTree);
461
- });
462
- });
463
- test('createFromLocalStorage fails when localStorage is not available', () => {
464
- // Remove the global window object to ensure no fallback
465
- const originalWindow = global.window;
466
- delete global.window;
467
- const result = file_tree_1.FileApiTreeAccessors.createFromLocalStorage({
468
- pathToKeyMap: {
469
- '/data/ingredients': 'test:ingredients:v1'
470
- },
471
- storage: undefined
472
- });
473
- // Restore window
474
- global.window = originalWindow;
475
- expect(result).toFailWith(/localStorage is not available/i);
476
- });
477
- });
478
- describe('path matching and error handling', () => {
479
- test('handles files outside configured paths', async () => {
480
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({ collection1: { items: {} } }));
481
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
482
- pathToKeyMap: {
483
- '/data/ingredients': 'test:ingredients:v1'
484
- },
485
- storage: mockStorage,
486
- mutable: true
487
- }).orThrow();
488
- // Try to save a file outside the configured path
489
- const saveResult = accessors.saveFileContents('/other/path/file.json', JSON.stringify({ test: 1 }));
490
- expect(saveResult).toSucceed();
491
- // But syncing should fail because no storage key is configured
492
- const syncResult = await accessors.syncToDisk();
493
- expect(syncResult).toFailWith(/No storage key configured for path/i);
494
- });
495
- test('handles files inside configured paths', async () => {
496
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({ collection1: { items: {} } }));
497
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
498
- pathToKeyMap: {
499
- '/data/ingredients': 'test:ingredients:v1'
500
- },
501
- storage: mockStorage,
502
- mutable: true
503
- }).orThrow();
504
- // Save a file inside the configured path
505
- accessors.saveFileContents('/data/ingredients/newfile.json', JSON.stringify({ test: 1 })).orThrow();
506
- // Syncing should succeed
507
- const syncResult = await accessors.syncToDisk();
508
- expect(syncResult).toSucceed();
509
- });
510
- test('handles failed content retrieval during sync', async () => {
511
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({ collection1: { items: {} } }));
512
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
513
- pathToKeyMap: {
514
- '/data/ingredients': 'test:ingredients:v1'
515
- },
516
- storage: mockStorage,
517
- mutable: true
518
- }).orThrow();
519
- // Modify a file
520
- accessors.saveFileContents('/data/ingredients/collection1.json', JSON.stringify({ test: 1 })).orThrow();
521
- // Override getFileContents to fail
522
- const originalGetFileContents = accessors.getFileContents.bind(accessors);
523
- accessors.getFileContents = jest.fn((path) => {
524
- if (path === '/data/ingredients/collection1.json') {
525
- return { isSuccess: () => false, isFailure: () => true, message: 'File not found' };
526
- }
527
- return originalGetFileContents(path);
528
- });
529
- const syncResult = await accessors.syncToDisk();
530
- expect(syncResult).toFailWith(/Failed to get file contents.*File not found/i);
531
- });
532
- test('handles corrupted JSON in localStorage during sync', async () => {
533
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({ collection1: { items: {} } }));
534
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
535
- pathToKeyMap: {
536
- '/data/ingredients': 'test:ingredients:v1'
537
- },
538
- storage: mockStorage,
539
- mutable: true
540
- }).orThrow();
541
- // Modify a file
542
- accessors.saveFileContents('/data/ingredients/collection1.json', JSON.stringify({ test: 1 })).orThrow();
543
- // Corrupt the existing storage data
544
- mockStorage.setItem('test:ingredients:v1', 'not valid json');
545
- // Sync should still succeed by starting fresh
546
- const syncResult = await accessors.syncToDisk();
547
- expect(syncResult).toSucceed();
548
- // Verify the data was written correctly despite corrupted previous data
549
- const stored = mockStorage.getItem('test:ingredients:v1');
550
- const parsed = JSON.parse(stored);
551
- // New format: values are raw content strings
552
- expect(parsed.collection1).toBe(JSON.stringify({ test: 1 }));
553
- });
554
- test('syncs non-JSON content (YAML) without error', async () => {
555
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
556
- pathToKeyMap: {
557
- '/data/ingredients': 'test:ingredients:v1'
558
- },
559
- storage: mockStorage,
560
- mutable: true
561
- }).orThrow();
562
- // Create and save a YAML file
563
- const yamlContent = 'metadata:\n name: test\nitems: {}';
564
- accessors.saveFileContents('/data/ingredients/my-collection.yaml', yamlContent).orThrow();
565
- const syncResult = await accessors.syncToDisk();
566
- expect(syncResult).toSucceed();
567
- const stored = JSON.parse(mockStorage.getItem('test:ingredients:v1'));
568
- expect(stored['my-collection']).toBe(yamlContent);
569
- });
570
- test('handles multiple sync failures with aggregated errors', async () => {
571
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
572
- pathToKeyMap: {
573
- '/data/ingredients': 'test:ingredients:v1'
574
- },
575
- storage: mockStorage,
576
- mutable: true
577
- }).orThrow();
578
- // Add files outside configured paths
579
- accessors.saveFileContents('/other1/file1.json', JSON.stringify({ test: 1 })).orThrow();
580
- accessors.saveFileContents('/other2/file2.json', JSON.stringify({ test: 2 })).orThrow();
581
- const syncResult = await accessors.syncToDisk();
582
- expect(syncResult).toFailWith(/Failed to sync 2 file\(s\)/i);
583
- });
584
- test('handles auto-sync failure', () => {
585
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({ collection1: { items: {} } }));
586
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
587
- pathToKeyMap: {
588
- '/data/ingredients': 'test:ingredients:v1'
589
- },
590
- storage: mockStorage,
591
- mutable: true,
592
- autoSync: true
593
- }).orThrow();
594
- // Try to save a file outside configured path with autoSync enabled
595
- const saveResult = accessors.saveFileContents('/other/path/file.json', JSON.stringify({ test: 1 }));
596
- expect(saveResult).toFailWith(/No storage key configured for path/i);
597
- });
598
- });
599
- describe('deleteFile', () => {
600
- test('deletes a file from in-memory storage and from localStorage', () => {
601
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({
602
- collection1: '{"items":{}}',
603
- collection2: '{"items":{}}'
604
- }));
605
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
606
- pathToKeyMap: {
607
- '/data/ingredients': 'test:ingredients:v1'
608
- },
609
- storage: mockStorage,
610
- mutable: true
611
- }).orThrow();
612
- const result = accessors.deleteFile('/data/ingredients/collection1.json');
613
- expect(result).toSucceedWith(true);
614
- // File should no longer be accessible in-memory
615
- expect(accessors.getFileContents('/data/ingredients/collection1.json')).toFail();
616
- // The deleted collection should be removed from localStorage; collection2 remains
617
- const stored = mockStorage.getItem('test:ingredients:v1');
618
- expect(stored).toBeTruthy();
619
- const parsed = JSON.parse(stored);
620
- expect(parsed).not.toHaveProperty('collection1');
621
- expect(parsed).toHaveProperty('collection2');
622
- });
623
- test('removes the storage key entirely when last entry is deleted', () => {
624
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({ onlyCollection: '{"items":{}}' }));
625
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
626
- pathToKeyMap: {
627
- '/data/ingredients': 'test:ingredients:v1'
628
- },
629
- storage: mockStorage,
630
- mutable: true
631
- }).orThrow();
632
- const result = accessors.deleteFile('/data/ingredients/onlyCollection.json');
633
- expect(result).toSucceedWith(true);
634
- // Storage key should be removed entirely since no more entries remain
635
- expect(mockStorage.getItem('test:ingredients:v1')).toBeNull();
636
- });
637
- test('removes path from dirty set when deleting a dirty file', () => {
638
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({ collection1: '{"items":{}}' }));
639
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
640
- pathToKeyMap: {
641
- '/data/ingredients': 'test:ingredients:v1'
642
- },
643
- storage: mockStorage,
644
- mutable: true
645
- }).orThrow();
646
- // Mark file as dirty first
647
- accessors
648
- .saveFileContents('/data/ingredients/collection1.json', JSON.stringify({ items: { modified: true } }))
649
- .orThrow();
650
- expect(accessors.isDirty()).toBe(true);
651
- // Deleting the file should clean it from the dirty set
652
- const result = accessors.deleteFile('/data/ingredients/collection1.json');
653
- expect(result).toSucceedWith(true);
654
- expect(accessors.isDirty()).toBe(false);
655
- expect(accessors.getDirtyPaths()).not.toContain('/data/ingredients/collection1.json');
656
- });
657
- test('fails when deleting a non-existent file', () => {
658
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
659
- pathToKeyMap: {
660
- '/data/ingredients': 'test:ingredients:v1'
661
- },
662
- storage: mockStorage,
663
- mutable: true
664
- }).orThrow();
665
- const result = accessors.deleteFile('/data/ingredients/nonexistent.json');
666
- expect(result).toFail();
667
- });
668
- test('does not modify storage when file has no matching storage key', () => {
669
- // Create accessors with one path, but a file that will be stored outside that path
670
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
671
- pathToKeyMap: {
672
- '/data/ingredients': 'test:ingredients:v1'
673
- },
674
- storage: mockStorage,
675
- mutable: true
676
- }).orThrow();
677
- // Add and delete a file inside the configured path but with no existing storage entry
678
- accessors.saveFileContents('/data/ingredients/newfile.json', '{"items":{}}').orThrow();
679
- // Sync so it exists in storage
680
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({ newfile: '{"items":{}}' }));
681
- // Now re-load and delete — the file should be removed from storage
682
- const accessors2 = file_tree_1.LocalStorageTreeAccessors.fromStorage({
683
- pathToKeyMap: {
684
- '/data/ingredients': 'test:ingredients:v1'
685
- },
686
- storage: mockStorage,
687
- mutable: true
688
- }).orThrow();
689
- const result = accessors2.deleteFile('/data/ingredients/newfile.json');
690
- expect(result).toSucceedWith(true);
691
- expect(mockStorage.getItem('test:ingredients:v1')).toBeNull();
692
- });
693
- test('handles deletion when localStorage key has no entry for the file', () => {
694
- // Storage key exists but does not contain an entry for the file being deleted
695
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({ other: '{"items":{}}' }));
696
- // Manually add a file to in-memory without it being in the storage JSON
697
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
698
- pathToKeyMap: {
699
- '/data/ingredients': 'test:ingredients:v1'
700
- },
701
- storage: mockStorage,
702
- mutable: true
703
- }).orThrow();
704
- // Save a new file (marks dirty but does not update storage yet)
705
- accessors.saveFileContents('/data/ingredients/newfile.json', '{"items":{}}').orThrow();
706
- // Clear the dirty flag by directly removing from storage (simulate storage mismatch)
707
- // Then delete the file — _deleteFileFromStorage gets the existing JSON which lacks 'newfile'
708
- // This exercises the path where the collection is not in the existing JSON
709
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({ other: '{"items":{}}' }));
710
- const result = accessors.deleteFile('/data/ingredients/newfile.json');
711
- expect(result).toSucceedWith(true);
712
- // 'other' should still remain in storage since only 'newfile' was deleted (which wasn't there)
713
- const stored = mockStorage.getItem('test:ingredients:v1');
714
- expect(stored).toBeTruthy();
715
- const parsed = JSON.parse(stored);
716
- expect(parsed).toHaveProperty('other');
717
- });
718
- test('handles deletion when storage entry for key is missing entirely', () => {
719
- // No storage key at all — _deleteFileFromStorage should return early
720
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
721
- pathToKeyMap: {
722
- '/data/ingredients': 'test:ingredients:v1'
723
- },
724
- storage: mockStorage,
725
- mutable: true
726
- }).orThrow();
727
- // Manually put a file in memory by saving it
728
- accessors.saveFileContents('/data/ingredients/newfile.json', '{"items":{}}').orThrow();
729
- // Delete the storage key so getItem returns null
730
- mockStorage.removeItem('test:ingredients:v1');
731
- // deleteFile should still succeed (in-memory deletion succeeds; storage cleanup is a no-op)
732
- const result = accessors.deleteFile('/data/ingredients/newfile.json');
733
- expect(result).toSucceedWith(true);
734
- });
735
- test('handles deletion when storage contains corrupted JSON', () => {
736
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({ collection1: '{"items":{}}' }));
737
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
738
- pathToKeyMap: {
739
- '/data/ingredients': 'test:ingredients:v1'
740
- },
741
- storage: mockStorage,
742
- mutable: true
743
- }).orThrow();
744
- // Corrupt the storage so JSON.parse fails in _deleteFileFromStorage
745
- mockStorage.setItem('test:ingredients:v1', 'not valid json {{{');
746
- // deleteFile should still succeed — corrupted JSON is silently ignored
747
- const result = accessors.deleteFile('/data/ingredients/collection1.json');
748
- expect(result).toSucceedWith(true);
749
- });
750
- test('deletes a file at a path outside all configured storage keys', () => {
751
- // A file can be saved in-memory at a path that has no matching storage key.
752
- // When deleted, _deleteFileFromStorage should return early without touching storage.
753
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
754
- pathToKeyMap: {
755
- '/data/ingredients': 'test:ingredients:v1'
756
- },
757
- storage: mockStorage,
758
- mutable: true
759
- }).orThrow();
760
- // Save a file outside the configured path (succeeds in-memory, marks dirty)
761
- accessors.saveFileContents('/untracked/file.json', '{"items":{}}').orThrow();
762
- // Delete it — should succeed even though there is no storage key for this path
763
- const result = accessors.deleteFile('/untracked/file.json');
764
- expect(result).toSucceedWith(true);
765
- // Storage should be untouched
766
- expect(mockStorage.getItem('test:ingredients:v1')).toBeNull();
767
- });
768
- });
769
- describe('inferContentType callback in _loadFromStorage', () => {
770
- test('calls inferContentType when loading files from storage', () => {
771
- // Covers lines 163-164: the params.inferContentType branch in _loadFromStorage
772
- mockStorage.setItem('test:ingredients:v1', JSON.stringify({
773
- myCollection: '{"items":{}}'
774
- }));
775
- const inferContentType = jest.fn((filePath, _provided) => {
776
- const { succeed: s } = require('@fgv/ts-utils');
777
- return s('application/json');
778
- });
779
- const result = file_tree_1.LocalStorageTreeAccessors.fromStorage({
780
- pathToKeyMap: {
781
- '/data/ingredients': 'test:ingredients:v1'
782
- },
783
- storage: mockStorage,
784
- inferContentType
785
- });
786
- expect(result).toSucceed();
787
- expect(inferContentType).toHaveBeenCalledWith('/data/ingredients/myCollection.json', undefined);
788
- });
789
- });
790
- describe('extension-less file path handling', () => {
791
- test('syncs a file whose path has no extension (collection ID has no dot)', async () => {
792
- // Covers line 249: dotIndex <= 0 case in _getCollectionIdFromPath, returning cleanPath as-is
793
- // We save a file at a path with no file extension; the collection ID extracted
794
- // will be the entire basename (no dot to strip).
795
- const accessors = file_tree_1.LocalStorageTreeAccessors.fromStorage({
796
- pathToKeyMap: {
797
- '/data/ingredients': 'test:ingredients:v1'
798
- },
799
- storage: mockStorage,
800
- mutable: true
801
- }).orThrow();
802
- // Save a file at a path with no extension
803
- accessors.saveFileContents('/data/ingredients/nodot', '{"items":{}}').orThrow();
804
- const syncResult = await accessors.syncToDisk();
805
- expect(syncResult).toSucceed();
806
- // The collection ID stored in localStorage should be 'nodot' (no extension stripped)
807
- const stored = mockStorage.getItem('test:ingredients:v1');
808
- expect(stored).toBeTruthy();
809
- const parsed = JSON.parse(stored);
810
- expect(parsed.nodot).toBe('{"items":{}}');
811
- });
812
- });
813
- });
814
- //# sourceMappingURL=localStorageTreeAccessors.test.js.map