@antelopejs/dms-media 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (632) hide show
  1. package/README.md +110 -28
  2. package/dist/acl/defaults.js +1 -16
  3. package/dist/acl/defaults.js.map +1 -1
  4. package/dist/acl/grantable.d.ts +1 -1
  5. package/dist/acl/grantable.js +4 -2
  6. package/dist/acl/grantable.js.map +1 -1
  7. package/dist/asset-lifecycle.d.ts +3 -2
  8. package/dist/asset-lifecycle.js +5 -5
  9. package/dist/asset-lifecycle.js.map +1 -1
  10. package/dist/bindings.js +0 -2
  11. package/dist/bindings.js.map +1 -1
  12. package/dist/config.d.ts +7 -0
  13. package/dist/config.js +20 -0
  14. package/dist/config.js.map +1 -1
  15. package/dist/constants.d.ts +1 -3
  16. package/dist/constants.js +2 -4
  17. package/dist/constants.js.map +1 -1
  18. package/dist/crons/index.d.ts +1 -0
  19. package/dist/crons/index.js +3 -1
  20. package/dist/crons/index.js.map +1 -1
  21. package/dist/crons/purge-staging.d.ts +6 -0
  22. package/dist/crons/purge-staging.js +46 -0
  23. package/dist/crons/purge-staging.js.map +1 -0
  24. package/dist/crons/sweep-derivatives.d.ts +6 -0
  25. package/dist/crons/sweep-derivatives.js +14 -4
  26. package/dist/crons/sweep-derivatives.js.map +1 -1
  27. package/dist/db/models/index.d.ts +3 -0
  28. package/dist/db/models/index.js +3 -0
  29. package/dist/db/models/index.js.map +1 -1
  30. package/dist/db/models/mediaAssets.model.d.ts +4 -1
  31. package/dist/db/models/mediaAssets.model.js +3 -2
  32. package/dist/db/models/mediaAssets.model.js.map +1 -1
  33. package/dist/db/models/mediaEvents.model.d.ts +25 -0
  34. package/dist/db/models/mediaEvents.model.js +32 -0
  35. package/dist/db/models/mediaEvents.model.js.map +1 -0
  36. package/dist/db/models/mediaFavorites.model.d.ts +25 -0
  37. package/dist/db/models/mediaFavorites.model.js +22 -0
  38. package/dist/db/models/mediaFavorites.model.js.map +1 -0
  39. package/dist/db/models/mediaUploads.model.d.ts +24 -0
  40. package/dist/db/models/mediaUploads.model.js +21 -0
  41. package/dist/db/models/mediaUploads.model.js.map +1 -0
  42. package/dist/db/tables/index.d.ts +3 -0
  43. package/dist/db/tables/index.js +3 -0
  44. package/dist/db/tables/index.js.map +1 -1
  45. package/dist/db/tables/mediaAssets.table.d.ts +2 -0
  46. package/dist/db/tables/mediaAssets.table.js +8 -0
  47. package/dist/db/tables/mediaAssets.table.js.map +1 -1
  48. package/dist/db/tables/mediaEvents.table.d.ts +15 -0
  49. package/dist/db/tables/mediaEvents.table.js +70 -0
  50. package/dist/db/tables/mediaEvents.table.js.map +1 -0
  51. package/dist/db/tables/mediaFavorites.table.d.ts +10 -0
  52. package/dist/db/tables/mediaFavorites.table.js +45 -0
  53. package/dist/db/tables/mediaFavorites.table.js.map +1 -0
  54. package/dist/db/tables/mediaUploads.table.d.ts +8 -0
  55. package/dist/db/tables/mediaUploads.table.js +41 -0
  56. package/dist/db/tables/mediaUploads.table.js.map +1 -0
  57. package/dist/derivatives.d.ts +3 -0
  58. package/dist/derivatives.js +62 -13
  59. package/dist/derivatives.js.map +1 -1
  60. package/dist/image-limits.d.ts +2 -0
  61. package/dist/image-limits.js +6 -0
  62. package/dist/image-limits.js.map +1 -0
  63. package/dist/index.d.ts +0 -1
  64. package/dist/index.js +2 -1
  65. package/dist/index.js.map +1 -1
  66. package/dist/library/activity.d.ts +20 -0
  67. package/dist/library/activity.js +254 -0
  68. package/dist/library/activity.js.map +1 -0
  69. package/dist/library/asset-filters.d.ts +9 -0
  70. package/dist/library/asset-filters.js +32 -0
  71. package/dist/library/asset-filters.js.map +1 -0
  72. package/dist/library/batches.d.ts +23 -0
  73. package/dist/library/batches.js +121 -0
  74. package/dist/library/batches.js.map +1 -0
  75. package/dist/library/binding-labels.d.ts +7 -0
  76. package/dist/library/binding-labels.js +32 -0
  77. package/dist/library/binding-labels.js.map +1 -0
  78. package/dist/library/composed-text.d.ts +13 -0
  79. package/dist/library/composed-text.js +43 -0
  80. package/dist/library/composed-text.js.map +1 -0
  81. package/dist/library/events.d.ts +26 -0
  82. package/dist/library/events.js +90 -0
  83. package/dist/library/events.js.map +1 -0
  84. package/dist/library/favorites.d.ts +13 -0
  85. package/dist/library/favorites.js +35 -0
  86. package/dist/library/favorites.js.map +1 -0
  87. package/dist/library/folder-stats.d.ts +7 -0
  88. package/dist/library/folder-stats.js +27 -0
  89. package/dist/library/folder-stats.js.map +1 -0
  90. package/dist/library/links.d.ts +12 -0
  91. package/dist/library/links.js +26 -0
  92. package/dist/library/links.js.map +1 -0
  93. package/dist/library/listing.d.ts +16 -0
  94. package/dist/library/listing.js +77 -0
  95. package/dist/library/listing.js.map +1 -0
  96. package/dist/library/module-readout.d.ts +4 -0
  97. package/dist/library/module-readout.js +86 -0
  98. package/dist/library/module-readout.js.map +1 -0
  99. package/dist/library/overview.d.ts +27 -0
  100. package/dist/library/overview.js +216 -0
  101. package/dist/library/overview.js.map +1 -0
  102. package/dist/library/presets-page.d.ts +15 -0
  103. package/dist/library/presets-page.js +97 -0
  104. package/dist/library/presets-page.js.map +1 -0
  105. package/dist/library/realtime.d.ts +4 -0
  106. package/dist/library/realtime.js +42 -0
  107. package/dist/library/realtime.js.map +1 -0
  108. package/dist/library/search.d.ts +19 -0
  109. package/dist/library/search.js +55 -0
  110. package/dist/library/search.js.map +1 -0
  111. package/dist/library/snippets.d.ts +2 -0
  112. package/dist/library/snippets.js +32 -0
  113. package/dist/library/snippets.js.map +1 -0
  114. package/dist/library/type-groups.d.ts +4 -0
  115. package/dist/library/type-groups.js +66 -0
  116. package/dist/library/type-groups.js.map +1 -0
  117. package/dist/library/upload-history.d.ts +2 -0
  118. package/dist/library/upload-history.js +19 -0
  119. package/dist/library/upload-history.js.map +1 -0
  120. package/dist/library/zip.d.ts +11 -0
  121. package/dist/library/zip.js +155 -0
  122. package/dist/library/zip.js.map +1 -0
  123. package/dist/pages/activity.d.ts +9 -0
  124. package/dist/pages/activity.js +66 -0
  125. package/dist/pages/activity.js.map +1 -0
  126. package/dist/pages/file.d.ts +18 -0
  127. package/dist/pages/file.js +127 -0
  128. package/dist/pages/file.js.map +1 -0
  129. package/dist/pages/files.d.ts +10 -0
  130. package/dist/pages/files.js +45 -0
  131. package/dist/pages/files.js.map +1 -0
  132. package/dist/pages/index.d.ts +8 -1
  133. package/dist/pages/index.js +8 -1
  134. package/dist/pages/index.js.map +1 -1
  135. package/dist/pages/manage.d.ts +10 -0
  136. package/dist/pages/manage.js +54 -0
  137. package/dist/pages/manage.js.map +1 -0
  138. package/dist/pages/module.d.ts +4 -0
  139. package/dist/pages/module.js +37 -0
  140. package/dist/pages/module.js.map +1 -0
  141. package/dist/pages/overview.d.ts +13 -0
  142. package/dist/pages/overview.js +121 -0
  143. package/dist/pages/overview.js.map +1 -0
  144. package/dist/pages/texts.d.ts +7 -0
  145. package/dist/pages/texts.js +13 -0
  146. package/dist/pages/texts.js.map +1 -0
  147. package/dist/pages/upload-availability.d.ts +2 -0
  148. package/dist/pages/upload-availability.js +22 -0
  149. package/dist/pages/upload-availability.js.map +1 -0
  150. package/dist/pages/uploads.d.ts +10 -0
  151. package/dist/pages/uploads.js +142 -0
  152. package/dist/pages/uploads.js.map +1 -0
  153. package/dist/presets.js +2 -0
  154. package/dist/presets.js.map +1 -1
  155. package/dist/read-urls.d.ts +1 -0
  156. package/dist/read-urls.js +31 -0
  157. package/dist/read-urls.js.map +1 -0
  158. package/dist/routes/media/asset-actions.d.ts +11 -0
  159. package/dist/routes/media/asset-actions.js +93 -0
  160. package/dist/routes/media/asset-actions.js.map +1 -0
  161. package/dist/routes/media/assets.d.ts +3 -14
  162. package/dist/routes/media/assets.js +14 -56
  163. package/dist/routes/media/assets.js.map +1 -1
  164. package/dist/routes/media/bulk.d.ts +18 -0
  165. package/dist/routes/media/bulk.js +182 -0
  166. package/dist/routes/media/bulk.js.map +1 -0
  167. package/dist/routes/media/constants.d.ts +5 -2
  168. package/dist/routes/media/constants.js +6 -3
  169. package/dist/routes/media/constants.js.map +1 -1
  170. package/dist/routes/media/context.d.ts +2 -1
  171. package/dist/routes/media/context.js +8 -5
  172. package/dist/routes/media/context.js.map +1 -1
  173. package/dist/routes/media/controller.d.ts +21 -0
  174. package/dist/routes/media/controller.js +66 -0
  175. package/dist/routes/media/controller.js.map +1 -0
  176. package/dist/routes/media/delivery-headers.d.ts +4 -0
  177. package/dist/routes/media/delivery-headers.js +46 -0
  178. package/dist/routes/media/delivery-headers.js.map +1 -0
  179. package/dist/routes/media/delivery-stream.d.ts +10 -0
  180. package/dist/routes/media/delivery-stream.js +90 -0
  181. package/dist/routes/media/delivery-stream.js.map +1 -0
  182. package/dist/routes/media/delivery.d.ts +1 -1
  183. package/dist/routes/media/delivery.js +119 -15
  184. package/dist/routes/media/delivery.js.map +1 -1
  185. package/dist/routes/media/dto.d.ts +19 -5
  186. package/dist/routes/media/dto.js +22 -10
  187. package/dist/routes/media/dto.js.map +1 -1
  188. package/dist/routes/media/file.d.ts +23 -0
  189. package/dist/routes/media/file.js +220 -0
  190. package/dist/routes/media/file.js.map +1 -0
  191. package/dist/routes/media/folders.d.ts +2 -29
  192. package/dist/routes/media/folders.js +54 -103
  193. package/dist/routes/media/folders.js.map +1 -1
  194. package/dist/routes/media/index.d.ts +7 -0
  195. package/dist/routes/media/index.js +7 -0
  196. package/dist/routes/media/index.js.map +1 -1
  197. package/dist/routes/media/library.d.ts +125 -0
  198. package/dist/routes/media/library.js +346 -0
  199. package/dist/routes/media/library.js.map +1 -0
  200. package/dist/routes/media/manage.d.ts +46 -0
  201. package/dist/routes/media/manage.js +193 -0
  202. package/dist/routes/media/manage.js.map +1 -0
  203. package/dist/routes/media/overview.d.ts +22 -0
  204. package/dist/routes/media/overview.js +182 -0
  205. package/dist/routes/media/overview.js.map +1 -0
  206. package/dist/routes/media/transform.d.ts +5 -14
  207. package/dist/routes/media/transform.js +88 -40
  208. package/dist/routes/media/transform.js.map +1 -1
  209. package/dist/routes/media/upload.d.ts +15 -19
  210. package/dist/routes/media/upload.js +149 -51
  211. package/dist/routes/media/upload.js.map +1 -1
  212. package/dist/test/antelope.test.js +4 -4
  213. package/dist/test/antelope.test.js.map +1 -1
  214. package/dist/test/helpers/assets.d.ts +7 -0
  215. package/dist/test/helpers/assets.js +7 -1
  216. package/dist/test/helpers/assets.js.map +1 -1
  217. package/dist/test/helpers/folders.d.ts +3 -0
  218. package/dist/test/helpers/folders.js +18 -0
  219. package/dist/test/helpers/folders.js.map +1 -0
  220. package/dist/test/helpers/members.js +8 -3
  221. package/dist/test/helpers/members.js.map +1 -1
  222. package/dist/test/helpers/owner.js +7 -3
  223. package/dist/test/helpers/owner.js.map +1 -1
  224. package/dist/test/helpers/pages.d.ts +7 -0
  225. package/dist/test/helpers/pages.js +29 -0
  226. package/dist/test/helpers/pages.js.map +1 -0
  227. package/dist/test/helpers/permission-ancestors.d.ts +1 -0
  228. package/dist/test/helpers/permission-ancestors.js +14 -0
  229. package/dist/test/helpers/permission-ancestors.js.map +1 -0
  230. package/dist/test/integration/media-activity-overview.test.js +123 -0
  231. package/dist/test/integration/media-activity-overview.test.js.map +1 -0
  232. package/dist/test/integration/media-api.test.js +1 -17
  233. package/dist/test/integration/media-api.test.js.map +1 -1
  234. package/dist/test/integration/media-bindings.test.js +8 -13
  235. package/dist/test/integration/media-bindings.test.js.map +1 -1
  236. package/dist/test/integration/media-delivery-editing.test.d.ts +1 -0
  237. package/dist/test/integration/media-delivery-editing.test.js +305 -0
  238. package/dist/test/integration/media-delivery-editing.test.js.map +1 -0
  239. package/dist/test/integration/media-delivery.test.js +2 -2
  240. package/dist/test/integration/media-delivery.test.js.map +1 -1
  241. package/dist/test/integration/media-explorer-writes.test.d.ts +1 -0
  242. package/dist/test/integration/media-explorer-writes.test.js +163 -0
  243. package/dist/test/integration/media-explorer-writes.test.js.map +1 -0
  244. package/dist/test/integration/media-guards.test.js +0 -2
  245. package/dist/test/integration/media-guards.test.js.map +1 -1
  246. package/dist/test/integration/media-library.test.d.ts +1 -0
  247. package/dist/test/integration/media-library.test.js +265 -0
  248. package/dist/test/integration/media-library.test.js.map +1 -0
  249. package/dist/test/integration/media-member-access.test.d.ts +1 -0
  250. package/dist/test/integration/media-member-access.test.js +169 -0
  251. package/dist/test/integration/media-member-access.test.js.map +1 -0
  252. package/dist/test/integration/media-permissions.test.js +137 -81
  253. package/dist/test/integration/media-permissions.test.js.map +1 -1
  254. package/dist/test/integration/media-project-field.test.d.ts +1 -0
  255. package/dist/test/integration/media-project-field.test.js +119 -0
  256. package/dist/test/integration/media-project-field.test.js.map +1 -0
  257. package/dist/test/integration/media-search-views.test.d.ts +1 -0
  258. package/dist/test/integration/media-search-views.test.js +104 -0
  259. package/dist/test/integration/media-search-views.test.js.map +1 -0
  260. package/dist/test/integration/media-upload-policy.test.d.ts +1 -0
  261. package/dist/test/integration/media-upload-policy.test.js +238 -0
  262. package/dist/test/integration/media-upload-policy.test.js.map +1 -0
  263. package/dist/test/unit/acl/grantable.test.js +33 -11
  264. package/dist/test/unit/acl/grantable.test.js.map +1 -1
  265. package/dist/test/unit/acl/resolver.test.js +35 -10
  266. package/dist/test/unit/acl/resolver.test.js.map +1 -1
  267. package/dist/test/unit/bindings.test.js +10 -7
  268. package/dist/test/unit/bindings.test.js.map +1 -1
  269. package/dist/test/unit/derivatives.test.js +7 -0
  270. package/dist/test/unit/derivatives.test.js.map +1 -1
  271. package/dist/test/unit/library/activity-overview.test.d.ts +1 -0
  272. package/dist/test/unit/library/activity-overview.test.js +209 -0
  273. package/dist/test/unit/library/activity-overview.test.js.map +1 -0
  274. package/dist/test/unit/library/fixtures.d.ts +4 -0
  275. package/dist/test/unit/library/fixtures.js +43 -0
  276. package/dist/test/unit/library/fixtures.js.map +1 -0
  277. package/dist/test/unit/library/library.test.d.ts +1 -0
  278. package/dist/test/unit/library/library.test.js +219 -0
  279. package/dist/test/unit/library/library.test.js.map +1 -0
  280. package/dist/test/unit/library/search-facets.test.d.ts +1 -0
  281. package/dist/test/unit/library/search-facets.test.js +126 -0
  282. package/dist/test/unit/library/search-facets.test.js.map +1 -0
  283. package/dist/test/unit/library/zip-names.test.d.ts +1 -0
  284. package/dist/test/unit/library/zip-names.test.js +41 -0
  285. package/dist/test/unit/library/zip-names.test.js.map +1 -0
  286. package/dist/test/unit/routes/delivery-headers.test.d.ts +1 -0
  287. package/dist/test/unit/routes/delivery-headers.test.js +19 -0
  288. package/dist/test/unit/routes/delivery-headers.test.js.map +1 -0
  289. package/dist/test/unit/routes/file-page.test.d.ts +1 -0
  290. package/dist/test/unit/routes/file-page.test.js +115 -0
  291. package/dist/test/unit/routes/file-page.test.js.map +1 -0
  292. package/dist/test/unit/routes/public-origin.test.d.ts +1 -0
  293. package/dist/test/unit/routes/public-origin.test.js +30 -0
  294. package/dist/test/unit/routes/public-origin.test.js.map +1 -0
  295. package/dist/test/unit/transform-ops.test.d.ts +1 -0
  296. package/dist/test/unit/transform-ops.test.js +29 -0
  297. package/dist/test/unit/transform-ops.test.js.map +1 -0
  298. package/dist/test/unit/upload-rules.test.d.ts +1 -0
  299. package/dist/test/unit/upload-rules.test.js +47 -0
  300. package/dist/test/unit/upload-rules.test.js.map +1 -0
  301. package/dist/transform-ops.d.ts +13 -0
  302. package/dist/transform-ops.js +52 -0
  303. package/dist/transform-ops.js.map +1 -0
  304. package/dist/transform.d.ts +13 -10
  305. package/dist/transform.js +77 -24
  306. package/dist/transform.js.map +1 -1
  307. package/dist/upload-names.d.ts +1 -0
  308. package/dist/upload-names.js +42 -0
  309. package/dist/upload-names.js.map +1 -0
  310. package/dist/upload-policy.d.ts +4 -0
  311. package/dist/upload-policy.js +85 -0
  312. package/dist/upload-policy.js.map +1 -0
  313. package/dist/validation/library.schema.d.ts +190 -0
  314. package/dist/validation/library.schema.js +95 -0
  315. package/dist/validation/library.schema.js.map +1 -0
  316. package/dist/validation/media.schema.d.ts +18 -68
  317. package/dist/validation/media.schema.js +58 -28
  318. package/dist/validation/media.schema.js.map +1 -1
  319. package/dist/validation/upload.schema.d.ts +21 -0
  320. package/dist/validation/upload.schema.js +18 -0
  321. package/dist/validation/upload.schema.js.map +1 -0
  322. package/frontend-vue/app/components/AssetPicker.vue +458 -235
  323. package/frontend-vue/app/components/Explorer.vue +124 -0
  324. package/frontend-vue/app/components/FileHeader.vue +78 -0
  325. package/frontend-vue/app/components/FilePreview.vue +10 -0
  326. package/frontend-vue/app/components/FileProperties.vue +136 -0
  327. package/frontend-vue/app/components/FirstRun.vue +65 -0
  328. package/frontend-vue/app/components/ImageEditor.vue +596 -0
  329. package/frontend-vue/app/components/PresetCards.vue +208 -0
  330. package/frontend-vue/app/components/RecentFiles.vue +55 -0
  331. package/frontend-vue/app/components/UploadQueue.vue +247 -0
  332. package/frontend-vue/app/components/UploadStrip.vue +166 -0
  333. package/frontend-vue/app/components/dialogs/DeleteFilesDialog.vue +67 -0
  334. package/frontend-vue/app/components/dialogs/DestinationDialog.vue +132 -0
  335. package/frontend-vue/app/components/dialogs/LockedDialog.vue +29 -0
  336. package/frontend-vue/app/components/dialogs/MoveDialog.vue +144 -0
  337. package/frontend-vue/app/components/dialogs/NameDialog.vue +120 -0
  338. package/frontend-vue/app/components/dialogs/ShortcutsDialog.vue +44 -0
  339. package/frontend-vue/app/components/dialogs/VisibilityDialog.vue +97 -0
  340. package/frontend-vue/app/components/explorer/AssetTile.vue +108 -0
  341. package/frontend-vue/app/components/explorer/BulkBar.vue +67 -0
  342. package/frontend-vue/app/components/explorer/ColumnsView.vue +136 -0
  343. package/frontend-vue/app/components/explorer/ExplorerAnnouncer.vue +63 -0
  344. package/frontend-vue/app/components/explorer/ExplorerContent.vue +175 -0
  345. package/frontend-vue/app/components/explorer/ExplorerHeader.vue +271 -0
  346. package/frontend-vue/app/components/explorer/ExplorerInspector.vue +190 -0
  347. package/frontend-vue/app/components/explorer/ExplorerShell.vue +273 -0
  348. package/frontend-vue/app/components/explorer/ExplorerSidebar.vue +242 -0
  349. package/frontend-vue/app/components/explorer/ExplorerStatusBar.vue +80 -0
  350. package/frontend-vue/app/components/explorer/ExplorerToolbar.vue +254 -0
  351. package/frontend-vue/app/components/explorer/FolderStrip.vue +100 -0
  352. package/frontend-vue/app/components/explorer/FolderTreeNode.vue +89 -0
  353. package/frontend-vue/app/components/explorer/GridView.vue +31 -0
  354. package/frontend-vue/app/components/explorer/ListView.vue +224 -0
  355. package/frontend-vue/app/components/field/AssetValue.vue +56 -0
  356. package/frontend-vue/app/components/field/FieldAltPopover.vue +67 -0
  357. package/frontend-vue/app/components/field/FieldEntries.vue +253 -0
  358. package/frontend-vue/app/components/field/FieldEntryMenu.vue +79 -0
  359. package/frontend-vue/app/components/field/FieldSingleCard.vue +125 -0
  360. package/frontend-vue/app/components/field/FieldUploadList.vue +96 -0
  361. package/frontend-vue/app/components/file/FileViewer.vue +94 -0
  362. package/frontend-vue/app/components/file/FileVisibility.vue +52 -0
  363. package/frontend-vue/app/components/picker/PickerModal.vue +249 -0
  364. package/frontend-vue/app/components/shared/AltTextField.vue +83 -0
  365. package/frontend-vue/app/components/shared/AssetThumb.vue +67 -0
  366. package/frontend-vue/app/components/shared/FolderGlyph.vue +21 -0
  367. package/frontend-vue/app/components/shared/FolderMarkers.vue +26 -0
  368. package/frontend-vue/app/components/shared/FolderPickerTree.vue +242 -0
  369. package/frontend-vue/app/components/shared/MediaDialog.vue +89 -0
  370. package/frontend-vue/app/components/shared/MediaLightbox.vue +175 -0
  371. package/frontend-vue/app/components/shared/VisibilityBadge.vue +19 -0
  372. package/frontend-vue/app/components/uploads/UploadQueueRow.vue +149 -0
  373. package/frontend-vue/app/composables/definePageShortcuts.ts +25 -0
  374. package/frontend-vue/app/composables/library/explorerMenus.ts +170 -0
  375. package/frontend-vue/app/composables/library/useAssetInteractions.ts +100 -0
  376. package/frontend-vue/app/composables/library/useAssetNavigation.ts +74 -0
  377. package/frontend-vue/app/composables/library/useExplorerCommands.ts +302 -0
  378. package/frontend-vue/app/composables/library/useExplorerDrop.ts +178 -0
  379. package/frontend-vue/app/composables/library/useExplorerHistory.ts +120 -0
  380. package/frontend-vue/app/composables/library/useExplorerLayout.ts +82 -0
  381. package/frontend-vue/app/composables/library/useExplorerUploads.ts +74 -0
  382. package/frontend-vue/app/composables/library/useLibraryChanges.ts +16 -0
  383. package/frontend-vue/app/composables/library/useLibraryListing.ts +249 -0
  384. package/frontend-vue/app/composables/library/useLibrarySelection.ts +110 -0
  385. package/frontend-vue/app/composables/library/useLibraryTree.ts +152 -0
  386. package/frontend-vue/app/composables/library/useListingFilterItems.ts +114 -0
  387. package/frontend-vue/app/composables/library/useMediaLibrary.ts +609 -0
  388. package/frontend-vue/app/composables/useAssetContent.ts +61 -0
  389. package/frontend-vue/app/composables/useAssetFieldEntries.ts +76 -0
  390. package/frontend-vue/app/composables/useAssetFieldUploads.ts +129 -0
  391. package/frontend-vue/app/composables/useAssetLink.ts +145 -0
  392. package/frontend-vue/app/composables/useCurrentFile.ts +54 -0
  393. package/frontend-vue/app/composables/useFieldFolders.ts +57 -0
  394. package/frontend-vue/app/composables/useFileDetails.ts +227 -0
  395. package/frontend-vue/app/composables/useMediaApi.ts +139 -0
  396. package/frontend-vue/app/composables/useMediaFormat.ts +30 -0
  397. package/frontend-vue/app/composables/useMediaPrefs.ts +65 -0
  398. package/frontend-vue/app/composables/useMediaPreviews.ts +66 -0
  399. package/frontend-vue/app/composables/useSharedTree.ts +73 -0
  400. package/frontend-vue/app/composables/useUploadApi.ts +51 -0
  401. package/frontend-vue/app/composables/useUploadFailureText.ts +28 -0
  402. package/frontend-vue/app/composables/useUploadQueue.ts +575 -0
  403. package/frontend-vue/app/composables/useUploadToasts.ts +137 -0
  404. package/frontend-vue/app/config/shortcuts-registry.ts +24 -4
  405. package/frontend-vue/app/types/media.ts +200 -0
  406. package/frontend-vue/app/utils/acceptedTypes.ts +33 -0
  407. package/frontend-vue/app/utils/assetDataType.ts +24 -0
  408. package/frontend-vue/app/utils/editorAspects.ts +61 -0
  409. package/frontend-vue/app/utils/explorerShortcuts.ts +79 -0
  410. package/frontend-vue/app/utils/explorerUploads.ts +30 -0
  411. package/frontend-vue/app/utils/fieldTypes.ts +25 -0
  412. package/frontend-vue/app/utils/httpStatus.ts +11 -0
  413. package/frontend-vue/app/utils/mediaFiles.ts +180 -0
  414. package/frontend-vue/app/utils/rovingFocus.ts +40 -0
  415. package/frontend-vue/app/utils/storageFailure.ts +57 -0
  416. package/frontend-vue/app/utils/uploadTypes.ts +71 -0
  417. package/frontend-vue/dms.frontend.build.ts +5 -0
  418. package/frontend-vue/dms.frontend.ts +12 -23
  419. package/frontend-vue/i18n/locales/media-en-GB.json +1098 -190
  420. package/frontend-vue/i18n/locales/media-fr-FR.json +1098 -190
  421. package/frontend-vue/package.json +1 -1
  422. package/frontend-vue/tests/editor-aspects.test.ts +22 -0
  423. package/frontend-vue/tests/locales.test.ts +44 -0
  424. package/frontend-vue/tests/registration.test.ts +7 -16
  425. package/frontend-vue/tests/storage-failure.test.ts +68 -0
  426. package/package.json +7 -12
  427. package/src/acl/defaults.ts +5 -19
  428. package/src/acl/grantable.ts +12 -5
  429. package/src/asset-lifecycle.ts +22 -8
  430. package/src/bindings.ts +0 -8
  431. package/src/config.ts +40 -0
  432. package/src/constants.ts +3 -4
  433. package/src/crons/index.ts +3 -1
  434. package/src/crons/purge-staging.ts +47 -0
  435. package/src/crons/sweep-derivatives.ts +34 -8
  436. package/src/db/models/index.ts +3 -0
  437. package/src/db/models/mediaAssets.model.ts +7 -1
  438. package/src/db/models/mediaEvents.model.ts +36 -0
  439. package/src/db/models/mediaFavorites.model.ts +32 -0
  440. package/src/db/models/mediaUploads.model.ts +21 -0
  441. package/src/db/tables/index.ts +3 -0
  442. package/src/db/tables/mediaAssets.table.ts +8 -0
  443. package/src/db/tables/mediaEvents.table.ts +54 -0
  444. package/src/db/tables/mediaFavorites.table.ts +34 -0
  445. package/src/db/tables/mediaUploads.table.ts +29 -0
  446. package/src/derivatives.ts +98 -22
  447. package/src/image-limits.ts +5 -0
  448. package/src/index.ts +2 -1
  449. package/src/library/activity.ts +330 -0
  450. package/src/library/asset-filters.ts +61 -0
  451. package/src/library/batches.ts +199 -0
  452. package/src/library/binding-labels.ts +45 -0
  453. package/src/library/composed-text.ts +62 -0
  454. package/src/library/events.ts +122 -0
  455. package/src/library/favorites.ts +58 -0
  456. package/src/library/folder-stats.ts +36 -0
  457. package/src/library/links.ts +24 -0
  458. package/src/library/listing.ts +108 -0
  459. package/src/library/module-readout.ts +133 -0
  460. package/src/library/overview.ts +282 -0
  461. package/src/library/presets-page.ts +127 -0
  462. package/src/library/realtime.ts +48 -0
  463. package/src/library/search.ts +88 -0
  464. package/src/library/snippets.ts +39 -0
  465. package/src/library/type-groups.ts +76 -0
  466. package/src/library/upload-history.ts +31 -0
  467. package/src/library/zip.ts +187 -0
  468. package/src/pages/activity.ts +66 -0
  469. package/src/pages/file.ts +173 -0
  470. package/src/pages/files.ts +49 -0
  471. package/src/pages/index.ts +8 -1
  472. package/src/pages/manage.ts +58 -0
  473. package/src/pages/module.ts +48 -0
  474. package/src/pages/overview.ts +141 -0
  475. package/src/pages/texts.ts +17 -0
  476. package/src/pages/upload-availability.ts +23 -0
  477. package/src/pages/uploads.ts +139 -0
  478. package/src/presets.ts +7 -0
  479. package/src/read-urls.ts +44 -0
  480. package/src/routes/media/asset-actions.ts +131 -0
  481. package/src/routes/media/assets.ts +23 -78
  482. package/src/routes/media/bulk.ts +233 -0
  483. package/src/routes/media/constants.ts +13 -5
  484. package/src/routes/media/context.ts +10 -14
  485. package/src/routes/media/controller.ts +80 -0
  486. package/src/routes/media/delivery-headers.ts +61 -0
  487. package/src/routes/media/delivery-stream.ts +132 -0
  488. package/src/routes/media/delivery.ts +186 -28
  489. package/src/routes/media/dto.ts +53 -11
  490. package/src/routes/media/file.ts +253 -0
  491. package/src/routes/media/folders.ts +61 -103
  492. package/src/routes/media/index.ts +7 -0
  493. package/src/routes/media/library.ts +455 -0
  494. package/src/routes/media/manage.ts +214 -0
  495. package/src/routes/media/overview.ts +217 -0
  496. package/src/routes/media/transform.ts +125 -49
  497. package/src/routes/media/upload.ts +234 -59
  498. package/src/test/antelope.test.ts +4 -4
  499. package/src/test/helpers/assets.ts +18 -1
  500. package/src/test/helpers/folders.ts +25 -0
  501. package/src/test/helpers/members.ts +8 -3
  502. package/src/test/helpers/owner.ts +8 -3
  503. package/src/test/helpers/pages.ts +44 -0
  504. package/src/test/helpers/permission-ancestors.ts +15 -0
  505. package/src/test/integration/media-activity-overview.test.ts +169 -0
  506. package/src/test/integration/media-api.test.ts +1 -25
  507. package/src/test/integration/media-bindings.test.ts +8 -14
  508. package/src/test/integration/media-delivery-editing.test.ts +420 -0
  509. package/src/test/integration/media-delivery.test.ts +2 -2
  510. package/src/test/integration/media-explorer-writes.test.ts +205 -0
  511. package/src/test/integration/media-guards.test.ts +0 -2
  512. package/src/test/integration/media-library.test.ts +363 -0
  513. package/src/test/integration/media-member-access.test.ts +242 -0
  514. package/src/test/integration/media-permissions.test.ts +155 -121
  515. package/src/test/integration/media-project-field.test.ts +154 -0
  516. package/src/test/integration/media-search-views.test.ts +164 -0
  517. package/src/test/integration/media-upload-policy.test.ts +322 -0
  518. package/src/test/unit/acl/grantable.test.ts +41 -13
  519. package/src/test/unit/acl/resolver.test.ts +45 -17
  520. package/src/test/unit/bindings.test.ts +10 -12
  521. package/src/test/unit/derivatives.test.ts +17 -1
  522. package/src/test/unit/library/activity-overview.test.ts +277 -0
  523. package/src/test/unit/library/fixtures.ts +52 -0
  524. package/src/test/unit/library/library.test.ts +249 -0
  525. package/src/test/unit/library/search-facets.test.ts +155 -0
  526. package/src/test/unit/library/zip-names.test.ts +55 -0
  527. package/src/test/unit/routes/delivery-headers.test.ts +28 -0
  528. package/src/test/unit/routes/file-page.test.ts +140 -0
  529. package/src/test/unit/routes/public-origin.test.ts +39 -0
  530. package/src/test/unit/transform-ops.test.ts +35 -0
  531. package/src/test/unit/upload-rules.test.ts +72 -0
  532. package/src/transform-ops.ts +79 -0
  533. package/src/transform.ts +100 -36
  534. package/src/upload-names.ts +55 -0
  535. package/src/upload-policy.ts +100 -0
  536. package/src/validation/library.schema.ts +134 -0
  537. package/src/validation/media.schema.ts +74 -29
  538. package/src/validation/upload.schema.ts +17 -0
  539. package/dist/pages/media.d.ts +0 -11
  540. package/dist/pages/media.js +0 -40
  541. package/dist/pages/media.js.map +0 -1
  542. package/dist/permissions.js +0 -32
  543. package/dist/permissions.js.map +0 -1
  544. package/dist/public.d.ts +0 -2
  545. package/dist/public.js +0 -10
  546. package/dist/public.js.map +0 -1
  547. package/frontend-vue/app/components/Library.vue +0 -25
  548. package/frontend-vue/app/components/PickerModal.vue +0 -47
  549. package/frontend-vue/app/components/StorageOverview.vue +0 -105
  550. package/frontend-vue/app/components/finder/Modal.vue +0 -41
  551. package/frontend-vue/app/components/finder/Root.vue +0 -72
  552. package/frontend-vue/app/components/finder/components/DeleteFolderConfirm.vue +0 -55
  553. package/frontend-vue/app/components/finder/components/EditImage.vue +0 -157
  554. package/frontend-vue/app/components/finder/components/Empty.vue +0 -13
  555. package/frontend-vue/app/components/finder/components/FilterMenu.vue +0 -115
  556. package/frontend-vue/app/components/finder/components/Preview.vue +0 -35
  557. package/frontend-vue/app/components/finder/components/search-file.vue +0 -24
  558. package/frontend-vue/app/components/finder/core/panel.vue +0 -132
  559. package/frontend-vue/app/components/finder/core/toolbar.vue +0 -55
  560. package/frontend-vue/app/components/finder/index.vue +0 -87
  561. package/frontend-vue/app/components/finder/layout/Footer.vue +0 -97
  562. package/frontend-vue/app/components/finder/layout/Header.vue +0 -16
  563. package/frontend-vue/app/components/finder/layout/navigation/Breadcrumbs.vue +0 -115
  564. package/frontend-vue/app/components/finder/layout/navigation/index.vue +0 -40
  565. package/frontend-vue/app/components/finder/layout/panel/Details.vue +0 -192
  566. package/frontend-vue/app/components/finder/layout/panel/Shortcuts.vue +0 -265
  567. package/frontend-vue/app/components/finder/layout/panel/Toogle.vue +0 -27
  568. package/frontend-vue/app/components/finder/layout/view/Column.vue +0 -180
  569. package/frontend-vue/app/components/finder/layout/view/Grid.vue +0 -37
  570. package/frontend-vue/app/components/finder/layout/view/List.vue +0 -289
  571. package/frontend-vue/app/components/finder/layout/view/Toggle.vue +0 -27
  572. package/frontend-vue/app/components/finder/layout/view/card/Column.vue +0 -182
  573. package/frontend-vue/app/components/finder/layout/view/card/Ghost.vue +0 -46
  574. package/frontend-vue/app/components/finder/layout/view/card/Grid.vue +0 -219
  575. package/frontend-vue/app/components/finder/layout/view/card/Input.vue +0 -63
  576. package/frontend-vue/app/components/finder/layout/view/card/List.vue +0 -29
  577. package/frontend-vue/app/components/finder/layout/view/index.vue +0 -80
  578. package/frontend-vue/app/components/picker/PickerColumnsView.vue +0 -170
  579. package/frontend-vue/app/components/picker/PickerDeleteConfirm.vue +0 -62
  580. package/frontend-vue/app/components/picker/PickerExplorer.vue +0 -436
  581. package/frontend-vue/app/components/picker/PickerGridView.vue +0 -136
  582. package/frontend-vue/app/components/picker/PickerItemThumb.vue +0 -49
  583. package/frontend-vue/app/components/picker/PickerLightbox.vue +0 -158
  584. package/frontend-vue/app/components/picker/PickerListView.vue +0 -188
  585. package/frontend-vue/app/components/picker/PickerMoveDialog.vue +0 -115
  586. package/frontend-vue/app/components/picker/PickerNameEdit.vue +0 -50
  587. package/frontend-vue/app/components/picker/PickerPreviewBody.vue +0 -109
  588. package/frontend-vue/app/components/picker/PickerPreviewPane.vue +0 -21
  589. package/frontend-vue/app/components/picker/PickerSidebar.vue +0 -87
  590. package/frontend-vue/app/components/picker/PickerToolbar.vue +0 -142
  591. package/frontend-vue/app/composables/finder/actions/useDeselectOnOutsideClick.ts +0 -40
  592. package/frontend-vue/app/composables/finder/actions/useDraggableItem.ts +0 -102
  593. package/frontend-vue/app/composables/finder/actions/useDropTarget.ts +0 -81
  594. package/frontend-vue/app/composables/finder/actions/useFileUpload.ts +0 -45
  595. package/frontend-vue/app/composables/finder/actions/useRowDragState.ts +0 -47
  596. package/frontend-vue/app/composables/finder/actions/useSelectionClick.ts +0 -53
  597. package/frontend-vue/app/composables/finder/api/useMediaApi.ts +0 -135
  598. package/frontend-vue/app/composables/finder/context/useFinderContext.ts +0 -55
  599. package/frontend-vue/app/composables/finder/context/useFinderDragAndDrop.ts +0 -66
  600. package/frontend-vue/app/composables/finder/context/useFinderHooks.ts +0 -93
  601. package/frontend-vue/app/composables/finder/context/useFinderLayout.ts +0 -191
  602. package/frontend-vue/app/composables/finder/context/useFinderNavigation.ts +0 -36
  603. package/frontend-vue/app/composables/finder/context/useFinderPicker.ts +0 -22
  604. package/frontend-vue/app/composables/finder/context/useFinderSelect.ts +0 -72
  605. package/frontend-vue/app/composables/finder/hooks/file.ts +0 -86
  606. package/frontend-vue/app/composables/finder/hooks/finder.ts +0 -25
  607. package/frontend-vue/app/composables/finder/hooks/folder.ts +0 -66
  608. package/frontend-vue/app/composables/finder/hooks/navigation.ts +0 -64
  609. package/frontend-vue/app/composables/finder/hooks/selection.ts +0 -31
  610. package/frontend-vue/app/composables/finder/menu/useContextMenu.ts +0 -180
  611. package/frontend-vue/app/composables/finder/menu/useFinderMenu.ts +0 -41
  612. package/frontend-vue/app/composables/finder/menu/useItemMenu.ts +0 -114
  613. package/frontend-vue/app/composables/finder/shortcuts/finderEscape.ts +0 -9
  614. package/frontend-vue/app/composables/finder/shortcuts/finderShiftA.ts +0 -9
  615. package/frontend-vue/app/composables/finder/sidebar/useFavoritesFolder.ts +0 -110
  616. package/frontend-vue/app/composables/finder/sidebar/useFolderSize.ts +0 -49
  617. package/frontend-vue/app/composables/finder/sidebar/useRecentFile.ts +0 -20
  618. package/frontend-vue/app/composables/finder/store/useFinderStore.ts +0 -354
  619. package/frontend-vue/app/composables/picker/usePickerExplorer.ts +0 -788
  620. package/frontend-vue/app/types/finder.ts +0 -47
  621. package/frontend-vue/app/utils/finder/context.ts +0 -25
  622. package/frontend-vue/app/utils/finder/filegroup.ts +0 -79
  623. package/frontend-vue/app/utils/finder/filesize.ts +0 -15
  624. package/frontend-vue/app/utils/finder/formatter.ts +0 -66
  625. package/frontend-vue/app/utils/finder/helpers.ts +0 -105
  626. package/frontend-vue/app/utils/finder/mime.ts +0 -108
  627. package/frontend-vue/app/utils/finder/models.ts +0 -153
  628. package/frontend-vue/app/utils/finder/shortcuts.ts +0 -29
  629. package/src/pages/media.ts +0 -47
  630. package/src/permissions.ts +0 -38
  631. package/src/public.ts +0 -43
  632. /package/dist/{permissions.d.ts → test/integration/media-activity-overview.test.d.ts} +0 -0
@@ -0,0 +1,609 @@
1
+ import type { InjectionKey } from 'vue'
2
+ import type {
3
+ AssetVisibility,
4
+ BulkOutcome,
5
+ BulkRefusal,
6
+ FolderVisibility,
7
+ MediaAsset,
8
+ MediaFolder,
9
+ } from '../../types/media'
10
+ import { type LibraryLocation, sameLocation } from './useLibraryListing'
11
+
12
+ const LIBRARY_KEY: InjectionKey<MediaLibrary> = Symbol('dms-media-library')
13
+
14
+ export interface MediaLibraryOptions {
15
+ /** Picker mode never navigates the dashboard and hides management actions. */
16
+ mode: 'browse' | 'pick'
17
+ /** Mimetype patterns a picker accepts (`image/*`); every file when empty. */
18
+ accept?: string[]
19
+ /** Most files a picker may still add. */
20
+ remaining?: number
21
+ /** The folder a picker is kept inside, when its field is bound to one. */
22
+ scopeFolderId?: string
23
+ /** Files the picker's field already holds: shown, but not picked twice. */
24
+ alreadyPicked?: string[]
25
+ }
26
+
27
+ /** What a name dialog learns from a write: whether it is done, or the refusal to show under the field. */
28
+ export interface NameOutcome {
29
+ isDone: boolean
30
+ id?: string
31
+ fieldError?: string
32
+ }
33
+
34
+ /** The explorer state and every action on the library, shared by its parts. */
35
+ function createMediaLibrary(options: MediaLibraryOptions) {
36
+ const api = useMediaApi()
37
+ const { t } = useI18n()
38
+ const toast = useToast()
39
+ const previews = useMediaPreviews()
40
+ const uploads = useUploadQueue()
41
+ const tree = useLibraryTree({ scopeFolderId: options.scopeFolderId })
42
+ const listing = useLibraryListing({ scopeFolderId: options.scopeFolderId, tree })
43
+ const isPick = options.mode === 'pick'
44
+ const selection = useLibrarySelection(listing.assets, isPick)
45
+ const backStack = ref<LibraryLocation[]>([])
46
+ const forwardStack = ref<LibraryLocation[]>([])
47
+ const lastFolderId = ref<string | null>(null)
48
+ const beforeSearch = ref<LibraryLocation>({ kind: 'root' })
49
+ const accept = options.accept ?? []
50
+ const alreadyPicked = new Set(options.alreadyPicked ?? [])
51
+
52
+ const currentFolder = computed(() => {
53
+ const current = listing.location.value
54
+ return current.kind === 'folder'
55
+ ? tree.foldersById.value.get(current.folderId)
56
+ : undefined
57
+ })
58
+
59
+ const visibleFolders = computed<MediaFolder[]>(() => {
60
+ const current = listing.location.value
61
+ if (current.kind === 'root') return tree.childrenOf(null)
62
+ if (current.kind === 'folder') return tree.childrenOf(current.folderId)
63
+ return listing.extraFolders.value
64
+ })
65
+
66
+ const acceptedTypes = computed(() => fieldTypesLabel(accept, t))
67
+
68
+ /** Why a picker cannot take a file, or nothing when it can. */
69
+ function rejectionOf(asset: MediaAsset): string | undefined {
70
+ if (alreadyPicked.has(asset.id)) return t('dms_media.picker.already_added')
71
+ if (!acceptedTypes.value) return undefined
72
+ if (matchesUploadType(asset.mimetype, accept)) return undefined
73
+ return t('dms_media.picker.not_accepted', { types: acceptedTypes.value })
74
+ }
75
+
76
+ function notifyFailure(error: unknown, titleKey: string): void {
77
+ useApiError(error, { title: t(titleKey) })
78
+ }
79
+
80
+ async function open(next: LibraryLocation, remember = true): Promise<void> {
81
+ if (remember && !sameLocation(next, listing.location.value)) {
82
+ backStack.value = [...backStack.value, listing.location.value]
83
+ forwardStack.value = []
84
+ }
85
+ if (!isPick) selection.clear()
86
+ if (next.kind !== 'search') beforeSearch.value = next
87
+ if (next.kind === 'folder') lastFolderId.value = next.folderId
88
+ if (next.kind === 'root') lastFolderId.value = null
89
+ await listing.setLocation(next)
90
+ }
91
+
92
+ function openFolder(folderId: string | null): Promise<void> {
93
+ return open(folderId ? { kind: 'folder', folderId } : { kind: 'root' })
94
+ }
95
+
96
+ const isSearching = computed(() => listing.location.value.kind === 'search')
97
+
98
+ async function back(): Promise<void> {
99
+ const current = listing.location.value
100
+ if (current.kind === 'search') {
101
+ forwardStack.value = [current, ...forwardStack.value]
102
+ return open(beforeSearch.value, false)
103
+ }
104
+ const previous = backStack.value.at(-1)
105
+ if (!previous) return
106
+ backStack.value = backStack.value.slice(0, -1)
107
+ forwardStack.value = [current, ...forwardStack.value]
108
+ await open(previous, false)
109
+ }
110
+
111
+ async function forward(): Promise<void> {
112
+ const next = forwardStack.value[0]
113
+ if (!next) return
114
+ forwardStack.value = forwardStack.value.slice(1)
115
+ if (!isSearching.value) backStack.value = [...backStack.value, listing.location.value]
116
+ await open(next, false)
117
+ }
118
+
119
+ function search(query: string, scopeId?: string): Promise<void> {
120
+ const trimmed = query.trim()
121
+ if (!trimmed) return clearSearch()
122
+ return open({ kind: 'search', query: trimmed, scopeId }, false)
123
+ }
124
+
125
+ function clearSearch(): Promise<void> {
126
+ return open(beforeSearch.value, false)
127
+ }
128
+
129
+ return {
130
+ mode: options.mode,
131
+ remaining: options.remaining,
132
+ accept,
133
+ acceptedTypesLabel: acceptedTypes,
134
+ rejectionOf,
135
+ api,
136
+ t,
137
+ toast,
138
+ previews,
139
+ uploads,
140
+ tree,
141
+ listing,
142
+ selection,
143
+ currentFolder,
144
+ visibleFolders,
145
+ lastFolderId,
146
+ canGoBack: computed(() => isSearching.value || backStack.value.length > 0),
147
+ canGoForward: computed(() => forwardStack.value.length > 0),
148
+ notifyFailure,
149
+ open,
150
+ openFolder,
151
+ back,
152
+ forward,
153
+ search,
154
+ clearSearch,
155
+ }
156
+ }
157
+
158
+ type LibraryCore = ReturnType<typeof createMediaLibrary>
159
+
160
+ interface ToastAction {
161
+ label: string
162
+ onClick: () => void | Promise<void>
163
+ }
164
+
165
+ interface GoneSplit {
166
+ outcome: BulkOutcome
167
+ gone: string[]
168
+ }
169
+
170
+ interface OutcomeReport {
171
+ doneKey: string
172
+ params?: Record<string, unknown>
173
+ actions?: ToastAction[]
174
+ duration?: number
175
+ }
176
+
177
+ const UNDO_TOAST_MS = 10_000
178
+ const ZIP_URL_TTL_MS = 10_000
179
+ const ZIP_FALLBACK_NAME = 'media'
180
+ const UNSAFE_FILENAME_CHARS = /[<>:"/\\|?*\u0000-\u001f]+/g
181
+ const NAME_FIELD = 'name'
182
+ const NAME_ERROR_CODES: Record<string, typeof NAME_FIELD> = Object.fromEntries(
183
+ ['name_required', 'name_too_long', 'name_forbidden', 'name_taken', 'folder_name_taken'].map((code) => [
184
+ `$dms_media.errors.${code}`,
185
+ NAME_FIELD,
186
+ ]),
187
+ )
188
+
189
+ type Translate = LibraryCore['t']
190
+
191
+ /** A refusal about the typed name, shown under the name field instead of a toast. */
192
+ function nameFieldError(t: Translate, error: unknown): string | undefined {
193
+ const [refusal] = resolveFieldErrors(error, { fields: [NAME_FIELD], codes: NAME_ERROR_CODES }).fields
194
+ return refusal && resolveApiMessage(t, refusal.message, refusal.params)
195
+ }
196
+
197
+ function isGoneRefusal(refusal: BulkRefusal): boolean {
198
+ return refusal.status === HTTP_NOT_FOUND
199
+ }
200
+
201
+ function refusedMessage(t: Translate, outcome: BulkOutcome): string | undefined {
202
+ const message = outcome.refused[0]?.message
203
+ return message ? resolveApiMessage(t, message) : undefined
204
+ }
205
+
206
+ function reportOutcome(library: LibraryCore, outcome: BulkOutcome, report: OutcomeReport): void {
207
+ const { t } = library
208
+ const count = outcome.done.length
209
+ const isComplete = outcome.refused.length === 0
210
+ library.toast.add({
211
+ title: isComplete
212
+ ? t(report.doneKey, { count, ...report.params }, count)
213
+ : t('dms_media.toasts.partial', { done: count, refused: outcome.refused.length }),
214
+ description: refusedMessage(t, outcome),
215
+ color: isComplete ? 'success' : 'warning',
216
+ icon: isComplete ? 'i-ph-check-circle' : 'i-ph-warning',
217
+ actions: count > 0 ? report.actions : undefined,
218
+ duration: report.actions && count > 0 ? report.duration : undefined,
219
+ })
220
+ }
221
+
222
+ /** A refused bulk outcome where files deleted meanwhile count as gone, not refused. */
223
+ function splitGone(outcome: BulkOutcome): GoneSplit {
224
+ const gone = outcome.refused.filter(isGoneRefusal).map((refusal) => refusal.id)
225
+ return {
226
+ outcome: { done: outcome.done, refused: outcome.refused.filter((refusal) => !isGoneRefusal(refusal)) },
227
+ gone,
228
+ }
229
+ }
230
+
231
+ function zipFileName(label: string | undefined): string {
232
+ const base = (label ?? '').replace(UNSAFE_FILENAME_CHARS, ' ').trim() || ZIP_FALLBACK_NAME
233
+ const day = new Date().toISOString().slice(0, 10)
234
+ return `${base}-${day}.zip`
235
+ }
236
+
237
+ function saveBlob(blob: Blob, name: string): void {
238
+ const url = URL.createObjectURL(blob)
239
+ downloadFile(url, name)
240
+ setTimeout(() => URL.revokeObjectURL(url), ZIP_URL_TTL_MS)
241
+ }
242
+
243
+ /** Drops files someone else deleted meanwhile, and says so. */
244
+ function createGoneHandler(library: LibraryCore) {
245
+ return function forgetGone(ids: string[]): void {
246
+ if (ids.length === 0) return
247
+ library.listing.removeAssets(ids)
248
+ library.selection.forget(ids)
249
+ ids.forEach((id) => library.previews.forget(id))
250
+ void library.tree.refresh()
251
+ library.toast.add({
252
+ title: library.t('dms_media.toasts.already_deleted', { count: ids.length }, ids.length),
253
+ color: 'warning',
254
+ icon: 'i-ph-warning',
255
+ })
256
+ }
257
+ }
258
+
259
+ /** Writes to a file's own details: name and alt text. */
260
+ function createDetailActions(library: LibraryCore) {
261
+ const { api, listing, tree, t } = library
262
+ const forgetGone = createGoneHandler(library)
263
+
264
+ function touch(assetId: string, changes: Partial<MediaAsset>): void {
265
+ listing.patchAsset(assetId, { ...changes, updatedAt: new Date().toISOString() })
266
+ }
267
+
268
+ function sortByName(): void {
269
+ const { sort, direction } = listing.filters.value
270
+ if (sort !== 'name') return
271
+ const factor = direction === 'desc' ? -1 : 1
272
+ listing.assets.value = [...listing.assets.value].sort(
273
+ (left, right) => NAME_COLLATOR.compare(left.name, right.name) * factor,
274
+ )
275
+ }
276
+
277
+ function failWrite(error: unknown, asset: MediaAsset, titleKey: string): NameOutcome {
278
+ const fieldError = nameFieldError(t, error)
279
+ if (fieldError) return { isDone: false, fieldError }
280
+ if (isNotFoundError(error)) forgetGone([asset.id])
281
+ else library.notifyFailure(error, titleKey)
282
+ return { isDone: false }
283
+ }
284
+
285
+ /** Renames a file; a name already taken comes back as a field error. */
286
+ async function renameAsset(asset: MediaAsset, name: string): Promise<NameOutcome> {
287
+ if (!name || name === asset.name) return { isDone: true }
288
+ try {
289
+ await api.updateAsset(asset.id, { name })
290
+ touch(asset.id, { name })
291
+ sortByName()
292
+ return { isDone: true }
293
+ } catch (error) {
294
+ return failWrite(error, asset, 'dms_media.toasts.rename_failed')
295
+ }
296
+ }
297
+
298
+ async function setAlt(asset: MediaAsset, alt: string): Promise<boolean> {
299
+ if (alt === (asset.alt ?? '')) return true
300
+ touch(asset.id, { alt })
301
+ try {
302
+ await api.updateAsset(asset.id, { alt })
303
+ const wasMissing = needsAltText(asset)
304
+ const isMissing = needsAltText({ ...asset, alt })
305
+ if (wasMissing !== isMissing) tree.adjustView('missingAlt', isMissing ? 1 : -1)
306
+ return true
307
+ } catch (error) {
308
+ listing.patchAsset(asset.id, { alt: asset.alt, updatedAt: asset.updatedAt })
309
+ failWrite(error, asset, 'dms_media.toasts.alt_failed')
310
+ return false
311
+ }
312
+ }
313
+
314
+ return { renameAsset, setAlt, forgetGone }
315
+ }
316
+
317
+ /** Moving files, with an undo that sends each one back to its own folder. */
318
+ function createMoveActions(library: LibraryCore, forgetGone: (ids: string[]) => void) {
319
+ const { api, listing, tree, selection, t } = library
320
+
321
+ function applyMove(ids: string[], folderId: string): void {
322
+ if (listing.location.value.kind === 'folder') {
323
+ listing.removeAssets(ids)
324
+ selection.forget(ids)
325
+ return
326
+ }
327
+ ids.forEach((id) => listing.patchAsset(id, { folderId }))
328
+ }
329
+
330
+ function groupByOrigin(ids: string[], origins: Map<string, string>): Map<string, string[]> {
331
+ const groups = new Map<string, string[]>()
332
+ for (const id of ids) {
333
+ const origin = origins.get(id)
334
+ if (origin) groups.set(origin, [...(groups.get(origin) ?? []), id])
335
+ }
336
+ return groups
337
+ }
338
+
339
+ async function undoMove(ids: string[], origins: Map<string, string>): Promise<void> {
340
+ try {
341
+ const groups = [...groupByOrigin(ids, origins)]
342
+ await Promise.all(groups.map(([folderId, group]) => api.moveAssets(group, folderId)))
343
+ await Promise.all([tree.refresh(), listing.load()])
344
+ library.toast.add({ title: t('dms_media.toasts.move_undone'), color: 'success', icon: 'i-ph-arrow-counter-clockwise' })
345
+ } catch (error) {
346
+ library.notifyFailure(error, 'dms_media.toasts.undo_failed')
347
+ }
348
+ }
349
+
350
+ async function moveAssets(assets: MediaAsset[], folderId: string): Promise<void> {
351
+ const origins = new Map(assets.map((asset) => [asset.id, asset.folderId]))
352
+ try {
353
+ const result = splitGone(await api.moveAssets([...origins.keys()], folderId))
354
+ applyMove(result.outcome.done, folderId)
355
+ forgetGone(result.gone)
356
+ await tree.refresh()
357
+ reportOutcome(library, result.outcome, {
358
+ doneKey: 'dms_media.toasts.moved_to',
359
+ params: { name: tree.foldersById.value.get(folderId)?.name ?? '' },
360
+ actions: [{ label: t('dms_media.actions.undo'), onClick: () => undoMove(result.outcome.done, origins) }],
361
+ duration: UNDO_TOAST_MS,
362
+ })
363
+ } catch (error) {
364
+ library.notifyFailure(error, 'dms_media.toasts.move_failed')
365
+ }
366
+ }
367
+
368
+ return { moveAssets }
369
+ }
370
+
371
+ /** Stars, which also leave the Starred view when removed there. */
372
+ function createStarActions(library: LibraryCore) {
373
+ const { api, listing, tree, t } = library
374
+
375
+ function patchStar(target: MediaAsset | MediaFolder, kind: 'asset' | 'folder', starred: boolean): void {
376
+ if (kind === 'asset') listing.patchAsset(target.id, { starred })
377
+ else tree.patchFolder(target.id, { starred })
378
+ tree.adjustView('starred', starred ? 1 : -1)
379
+ }
380
+
381
+ function isStarredView(): boolean {
382
+ const current = listing.location.value
383
+ return current.kind === 'view' && current.view === 'starred'
384
+ }
385
+
386
+ function leaveStarredView(target: MediaAsset | MediaFolder, kind: 'asset' | 'folder'): void {
387
+ if (kind === 'asset') listing.removeAssets([target.id])
388
+ else listing.extraFolders.value = listing.extraFolders.value.filter((folder) => folder.id !== target.id)
389
+ library.toast.add({
390
+ title: t('dms_media.toasts.unstarred', { name: target.name }),
391
+ color: 'neutral',
392
+ icon: 'i-ph-star',
393
+ actions: [{ label: t('dms_media.actions.undo'), onClick: () => restar(target, kind) }],
394
+ })
395
+ }
396
+
397
+ async function restar(target: MediaAsset | MediaFolder, kind: 'asset' | 'folder'): Promise<void> {
398
+ try {
399
+ await api.star(kind, target.id, true)
400
+ tree.adjustView('starred', 1)
401
+ await listing.load()
402
+ } catch (error) {
403
+ library.notifyFailure(error, 'dms_media.toasts.star_failed')
404
+ }
405
+ }
406
+
407
+ async function toggleStar(target: MediaAsset | MediaFolder, kind: 'asset' | 'folder'): Promise<void> {
408
+ const starred = !target.starred
409
+ patchStar(target, kind, starred)
410
+ try {
411
+ await api.star(kind, target.id, starred)
412
+ if (!starred && isStarredView()) leaveStarredView(target, kind)
413
+ } catch (error) {
414
+ patchStar(target, kind, !starred)
415
+ library.notifyFailure(error, 'dms_media.toasts.star_failed')
416
+ }
417
+ }
418
+
419
+ /** Stars every file, or removes their stars when they all have one. */
420
+ async function starAssets(assets: MediaAsset[]): Promise<void> {
421
+ const isEveryStarred = assets.every((asset) => asset.starred)
422
+ const targets = assets.filter((asset) => asset.starred === isEveryStarred)
423
+ await Promise.all(targets.map((asset) => toggleStar(asset, 'asset')))
424
+ }
425
+
426
+ return { toggleStar, starAssets }
427
+ }
428
+
429
+ /** Writes to the library, applied locally first and rolled back on failure. */
430
+ function createLibraryActions(library: LibraryCore) {
431
+ const { api, listing, tree, selection } = library
432
+ const details = createDetailActions(library)
433
+ const assetLink = useAssetLink()
434
+ const isZipping = ref(false)
435
+
436
+ async function setAssetsVisibility(
437
+ assets: MediaAsset[],
438
+ visibility: AssetVisibility,
439
+ doneKey = 'dms_media.toasts.visibility_done',
440
+ ): Promise<void> {
441
+ try {
442
+ const result = splitGone(await api.setAssetsVisibility(assets.map((asset) => asset.id), visibility))
443
+ details.forgetGone(result.gone)
444
+ await listing.load()
445
+ reportOutcome(library, result.outcome, { doneKey })
446
+ } catch (error) {
447
+ library.notifyFailure(error, 'dms_media.toasts.visibility_failed')
448
+ }
449
+ }
450
+
451
+ async function deleteAssets(assets: MediaAsset[]): Promise<void> {
452
+ try {
453
+ const outcome = await api.deleteAssets(assets.map((asset) => asset.id))
454
+ const result = splitGone(outcome)
455
+ const removed = [...result.outcome.done, ...result.gone]
456
+ listing.removeAssets(removed)
457
+ selection.forget(removed)
458
+ removed.forEach((id) => library.previews.forget(id))
459
+ await tree.refresh()
460
+ reportOutcome(library, { done: removed, refused: result.outcome.refused }, { doneKey: 'dms_media.toasts.deleted' })
461
+ } catch (error) {
462
+ library.notifyFailure(error, 'dms_media.toasts.delete_failed')
463
+ }
464
+ }
465
+
466
+ async function zipInto(load: () => Promise<Blob>, name: string): Promise<void> {
467
+ if (isZipping.value) return
468
+ isZipping.value = true
469
+ try {
470
+ saveBlob(await load(), name)
471
+ } catch (error) {
472
+ library.notifyFailure(error, 'dms_media.toasts.zip_failed')
473
+ } finally {
474
+ isZipping.value = false
475
+ }
476
+ }
477
+
478
+ function downloadZip(assets: MediaAsset[]): Promise<void> {
479
+ const ids = assets.map((asset) => asset.id)
480
+ return zipInto(() => api.zip(ids), zipFileName(library.currentFolder.value?.name))
481
+ }
482
+
483
+ function downloadFolder(folder: MediaFolder): Promise<void> {
484
+ return zipInto(() => api.zipFolder(folder.id), zipFileName(folder.name))
485
+ }
486
+
487
+ /** Saves a file under its name; the storage's own link would only show it. */
488
+ async function downloadAsset(asset: MediaAsset): Promise<void> {
489
+ await assetLink.download(asset)
490
+ }
491
+
492
+ return {
493
+ renameAsset: details.renameAsset,
494
+ setAlt: details.setAlt,
495
+ setAssetsVisibility,
496
+ deleteAssets,
497
+ downloadZip,
498
+ downloadFolder,
499
+ downloadAsset,
500
+ isZipping: readonly(isZipping),
501
+ ...createMoveActions(library, details.forgetGone),
502
+ ...createStarActions(library),
503
+ ...createFolderActions(library),
504
+ }
505
+ }
506
+
507
+ function createFolderActions(library: LibraryCore) {
508
+ const { api, tree, t } = library
509
+
510
+ function failName(error: unknown, titleKey: string): NameOutcome {
511
+ const fieldError = nameFieldError(t, error)
512
+ if (!fieldError) library.notifyFailure(error, titleKey)
513
+ return { isDone: false, fieldError }
514
+ }
515
+
516
+ /** Creates a folder; a name already taken comes back as a field error. */
517
+ async function createFolder(name: string, parentId?: string): Promise<NameOutcome> {
518
+ try {
519
+ const { id } = await api.createFolder(name, parentId)
520
+ await tree.refresh()
521
+ library.toast.add({
522
+ title: t('dms_media.toasts.folder_created', { name }),
523
+ color: 'success',
524
+ icon: 'i-ph-folder-plus',
525
+ })
526
+ return { isDone: true, id }
527
+ } catch (error) {
528
+ return failName(error, 'dms_media.toasts.folder_create_failed')
529
+ }
530
+ }
531
+
532
+ async function renameFolder(folder: MediaFolder, name: string): Promise<NameOutcome> {
533
+ if (!name || name === folder.name) return { isDone: true }
534
+ try {
535
+ await api.renameFolder(folder.id, name)
536
+ tree.patchFolder(folder.id, { name })
537
+ return { isDone: true }
538
+ } catch (error) {
539
+ return failName(error, 'dms_media.toasts.rename_failed')
540
+ }
541
+ }
542
+
543
+ async function moveFolder(folder: MediaFolder, parentId: string | null): Promise<void> {
544
+ try {
545
+ await api.moveFolder(folder.id, parentId)
546
+ await tree.refresh()
547
+ library.toast.add({
548
+ title: t('dms_media.toasts.folder_moved', { name: folder.name }),
549
+ color: 'success',
550
+ })
551
+ } catch (error) {
552
+ library.notifyFailure(error, 'dms_media.toasts.move_failed')
553
+ }
554
+ }
555
+
556
+ async function deleteFolder(folder: MediaFolder): Promise<void> {
557
+ try {
558
+ await api.deleteFolder(folder.id)
559
+ if (library.currentFolder.value?.id === folder.id)
560
+ await library.openFolder(folder.parentId)
561
+ await tree.refresh()
562
+ library.toast.add({
563
+ title: t('dms_media.toasts.folder_deleted', { name: folder.name }),
564
+ color: 'success',
565
+ icon: 'i-ph-trash',
566
+ })
567
+ } catch (error) {
568
+ library.notifyFailure(error, 'dms_media.toasts.delete_failed')
569
+ }
570
+ }
571
+
572
+ async function setFolderVisibility(
573
+ folder: MediaFolder,
574
+ visibility: FolderVisibility,
575
+ ): Promise<void> {
576
+ tree.patchFolder(folder.id, { visibility })
577
+ try {
578
+ await api.setFolderVisibility(folder.id, visibility)
579
+ await library.listing.load()
580
+ library.toast.add({
581
+ title: t(`dms_media.toasts.folder_visibility.${visibility}`, { name: folder.name }),
582
+ color: 'success',
583
+ icon: VISIBILITY_ICONS[visibility],
584
+ })
585
+ } catch (error) {
586
+ tree.patchFolder(folder.id, { visibility: folder.visibility })
587
+ library.notifyFailure(error, 'dms_media.toasts.visibility_failed')
588
+ }
589
+ }
590
+
591
+ return { createFolder, renameFolder, moveFolder, deleteFolder, setFolderVisibility }
592
+ }
593
+
594
+ export type MediaLibrary = LibraryCore & {
595
+ actions: ReturnType<typeof createLibraryActions>
596
+ }
597
+
598
+ export function provideMediaLibrary(options: MediaLibraryOptions): MediaLibrary {
599
+ const core = createMediaLibrary(options)
600
+ const library: MediaLibrary = { ...core, actions: createLibraryActions(core) }
601
+ provide(LIBRARY_KEY, library)
602
+ return library
603
+ }
604
+
605
+ export function useMediaLibrary(): MediaLibrary {
606
+ const library = inject(LIBRARY_KEY)
607
+ if (!library) throw new Error('useMediaLibrary() needs a media explorer above it')
608
+ return library
609
+ }
@@ -0,0 +1,61 @@
1
+ import type { MediaAsset } from '../types/media'
2
+
3
+ export type AssetContentKind = 'image' | 'video' | 'frame' | 'text' | 'none'
4
+
5
+ export interface AssetContent {
6
+ kind: AssetContentKind
7
+ /** Read URL the image, video or frame loads. */
8
+ url?: string
9
+ /** First lines of a text file. */
10
+ text?: string
11
+ /** The text was cut to its first lines. */
12
+ isTruncated?: boolean
13
+ }
14
+
15
+ const TEXT_PREVIEW_BYTES = 64_000
16
+ const IMAGE_PRESET = 'preview'
17
+ /**
18
+ * The browser's PDF viewer titles its toolbar with the read URL's storage
19
+ * key: the preview hides it; « Open in a new tab » gives the full viewer.
20
+ */
21
+ const FRAME_FRAGMENT = '#toolbar=0&navpanes=0'
22
+
23
+ type ShownAsset = Pick<MediaAsset, 'id' | 'mimetype' | 'typeGroup'>
24
+
25
+ function contentKindOf(asset: ShownAsset): AssetContentKind {
26
+ if (isImageAsset(asset)) return 'image'
27
+ if (asset.typeGroup === 'video') return 'video'
28
+ if (isFramedAsset(asset)) return 'frame'
29
+ return isTextAsset(asset) ? 'text' : 'none'
30
+ }
31
+
32
+ async function readText(url: string): Promise<Pick<AssetContent, 'text' | 'isTruncated'>> {
33
+ const response = await fetch(url)
34
+ if (!response.ok) throw new Error(response.statusText)
35
+ const bytes = new Uint8Array(await response.arrayBuffer())
36
+ const isTruncated = bytes.length > TEXT_PREVIEW_BYTES
37
+ return { text: new TextDecoder().decode(bytes.subarray(0, TEXT_PREVIEW_BYTES)), isTruncated }
38
+ }
39
+
40
+ /**
41
+ * What the file viewers show of a file: an image at its preview size, a video,
42
+ * a PDF in a frame, the first lines of a text or CSV file, or nothing.
43
+ */
44
+ export function useAssetContent() {
45
+ const api = useMediaApi()
46
+
47
+ async function load(asset: ShownAsset): Promise<AssetContent> {
48
+ const kind = contentKindOf(asset)
49
+ if (kind === 'none') return { kind }
50
+ try {
51
+ const preset = asset.typeGroup === 'image' ? IMAGE_PRESET : undefined
52
+ const { url } = await api.readUrl(asset.id, preset)
53
+ if (kind === 'text') return { kind, ...(await readText(url)) }
54
+ return { kind, url: kind === 'frame' ? `${url}${FRAME_FRAGMENT}` : url }
55
+ } catch {
56
+ return { kind: 'none' }
57
+ }
58
+ }
59
+
60
+ return { load }
61
+ }