@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,282 @@
1
+ import type {
2
+ MeterSegment,
3
+ MeterTone,
4
+ } from "@antelopejs/interface-dms/base/meter";
5
+ import type { KeyValueListItem } from "@antelopejs/interface-dms/base/key-value-list";
6
+ import type { StatGroupItem } from "@antelopejs/interface-dms/base/stat-group";
7
+ import type { MediaAsset } from "../db";
8
+ import type { BlockText } from "@antelopejs/interface-dms/base/types";
9
+ import { composedBytes, composedText, countParam } from "./composed-text";
10
+ import { MEDIA_ROUTES, viewLink } from "./links";
11
+ import {
12
+ ASSET_TYPE_GROUPS,
13
+ type AssetTypeGroup,
14
+ isDescribableImage,
15
+ resolveTypeGroup,
16
+ } from "./type-groups";
17
+ import type { FolderVisibility } from "../types";
18
+
19
+ const MS_PER_DAY = 24 * 60 * 60 * 1000;
20
+ const RECENT_WINDOW_DAYS = 30;
21
+ const PERCENT = 100;
22
+ const QUOTA_WARNING_PERCENT = 80;
23
+ const BYTES_PER_MEGABYTE = 1000 * 1000;
24
+ const LARGE_FILE_MEGABYTES = 20;
25
+ const LARGE_FILE_BYTES = LARGE_FILE_MEGABYTES * BYTES_PER_MEGABYTE;
26
+ const TEXTS = "$dms_media.overview";
27
+
28
+ /**
29
+ * One hue per kind of file, never an alarm colour: images cyan, vectors and
30
+ * videos violet, spreadsheets and audio green, PDFs and documents amber. The
31
+ * meter offers four such hues; kinds that share one are close relatives.
32
+ */
33
+ const TYPE_TONES: Record<AssetTypeGroup, MeterTone> = {
34
+ image: "primary",
35
+ vector: "secondary",
36
+ video: "secondary",
37
+ spreadsheet: "success",
38
+ audio: "success",
39
+ pdf: "warning",
40
+ document: "warning",
41
+ archive: "neutral",
42
+ other: "neutral",
43
+ };
44
+
45
+ export interface OverviewInput {
46
+ assets: MediaAsset[];
47
+ visibilityOf: (asset: MediaAsset) => FolderVisibility;
48
+ quotaBytes?: number;
49
+ now: Date;
50
+ }
51
+
52
+ function percentOf(part: number, total: number): number {
53
+ return total === 0 ? 0 : Math.round((part / total) * PERCENT);
54
+ }
55
+
56
+ /** Bytes an asset keeps in storage: its current file and, once edited, its original. */
57
+ export function storedSize(asset: MediaAsset): number {
58
+ return asset.size + (asset.originalSize ?? 0);
59
+ }
60
+
61
+ function totalSize(assets: MediaAsset[]): number {
62
+ return assets.reduce((total, asset) => total + storedSize(asset), 0);
63
+ }
64
+
65
+ function missingAlt(assets: MediaAsset[]): MediaAsset[] {
66
+ return assets.filter(
67
+ (asset) => isDescribableImage(asset.mimetype) && !asset.alt?.trim(),
68
+ );
69
+ }
70
+
71
+ function countPublic(input: OverviewInput, assets: MediaAsset[]): number {
72
+ return assets.filter((asset) => input.visibilityOf(asset) === "public")
73
+ .length;
74
+ }
75
+
76
+ function storageItem(input: OverviewInput): StatGroupItem {
77
+ const { quotaBytes } = input;
78
+ const size = totalSize(input.assets);
79
+ const usedPercent = quotaBytes ? percentOf(size, quotaBytes) : undefined;
80
+ return {
81
+ id: "storage",
82
+ icon: "i-ph-hard-drives",
83
+ eyebrow: `${TEXTS}.kpis.storage`,
84
+ value: composedBytes(size),
85
+ detail:
86
+ usedPercent === undefined
87
+ ? composedText(`${TEXTS}.kpis.storage_detail`, {
88
+ files: countParam(input.assets.length),
89
+ })
90
+ : composedText(`${TEXTS}.kpis.storage_quota_detail`, {
91
+ percent: usedPercent,
92
+ quota: composedBytes(quotaBytes ?? 0),
93
+ }),
94
+ detailTone:
95
+ (usedPercent ?? 0) >= QUOTA_WARNING_PERCENT ? "warning" : "neutral",
96
+ to: viewLink("largest"),
97
+ };
98
+ }
99
+
100
+ function missingAltItem(input: OverviewInput): StatGroupItem {
101
+ const undescribed = missingAlt(input.assets);
102
+ const publicUndescribed = countPublic(input, undescribed);
103
+ return {
104
+ id: "missing-alt",
105
+ icon: "i-ph-text-aa",
106
+ tone: undescribed.length > 0 ? "warning" : "success",
107
+ eyebrow: `${TEXTS}.kpis.missing_alt`,
108
+ value: undescribed.length,
109
+ detail:
110
+ undescribed.length === 0
111
+ ? `${TEXTS}.kpis.missing_alt_none`
112
+ : composedText(`${TEXTS}.kpis.missing_alt_public`, {
113
+ files: countParam(publicUndescribed),
114
+ }),
115
+ detailTone: publicUndescribed > 0 ? "warning" : "neutral",
116
+ to: viewLink("missing-alt"),
117
+ };
118
+ }
119
+
120
+ export function buildKpiItems(input: OverviewInput): StatGroupItem[] {
121
+ const { assets } = input;
122
+ const since = input.now.getTime() - RECENT_WINDOW_DAYS * MS_PER_DAY;
123
+ const uploaded = assets.filter((asset) => asset.createdAt.getTime() >= since);
124
+ const publicCount = countPublic(input, assets);
125
+ return [
126
+ {
127
+ id: "files",
128
+ icon: "i-ph-files",
129
+ eyebrow: `${TEXTS}.kpis.files`,
130
+ value: assets.length,
131
+ detail: composedText(`${TEXTS}.kpis.files_detail`, {
132
+ files: countParam(uploaded.length),
133
+ }),
134
+ detailTone: uploaded.length > 0 ? "success" : "neutral",
135
+ to: MEDIA_ROUTES.files,
136
+ },
137
+ storageItem(input),
138
+ {
139
+ id: "public",
140
+ icon: "i-ph-globe",
141
+ eyebrow: `${TEXTS}.kpis.public`,
142
+ value: publicCount,
143
+ detail: composedText(`${TEXTS}.kpis.public_share`, {
144
+ percent: percentOf(publicCount, assets.length),
145
+ }),
146
+ to: viewLink("public"),
147
+ },
148
+ missingAltItem(input),
149
+ ];
150
+ }
151
+
152
+ export interface StorageMeterResponse {
153
+ value: number;
154
+ max: number;
155
+ valueLabel: BlockText;
156
+ hint: BlockText;
157
+ segments: MeterSegment[];
158
+ }
159
+
160
+ interface TypeGroupTotal {
161
+ files: number;
162
+ size: number;
163
+ }
164
+
165
+ function totalsByTypeGroup(
166
+ assets: MediaAsset[],
167
+ ): Map<AssetTypeGroup, TypeGroupTotal> {
168
+ const totals = new Map<AssetTypeGroup, TypeGroupTotal>();
169
+ for (const asset of assets) {
170
+ const group = resolveTypeGroup(asset.mimetype);
171
+ const total = totals.get(group) ?? { files: 0, size: 0 };
172
+ totals.set(group, {
173
+ files: total.files + 1,
174
+ size: total.size + storedSize(asset),
175
+ });
176
+ }
177
+ return totals;
178
+ }
179
+
180
+ export function buildStorageMeter(input: OverviewInput): StorageMeterResponse {
181
+ const { assets } = input;
182
+ const totals = totalsByTypeGroup(assets);
183
+ const size = totalSize(assets);
184
+ const segments = ASSET_TYPE_GROUPS.flatMap((group) => {
185
+ const total = totals.get(group);
186
+ if (!total) return [];
187
+ return [
188
+ {
189
+ value: total.size,
190
+ tone: TYPE_TONES[group],
191
+ label: composedText(`${TEXTS}.storage.type_segment`, {
192
+ type: composedText(`$dms_media.types.${group}`),
193
+ files: countParam(total.files),
194
+ size: composedBytes(total.size),
195
+ }),
196
+ },
197
+ ];
198
+ });
199
+ return {
200
+ value: size,
201
+ max: Math.max(input.quotaBytes ?? size, 1),
202
+ valueLabel: composedBytes(size),
203
+ hint: composedText(`${TEXTS}.storage.hint`, {
204
+ files: countParam(assets.length),
205
+ }),
206
+ segments,
207
+ };
208
+ }
209
+
210
+ export interface AttentionInput extends OverviewInput {
211
+ failedUploads: number;
212
+ }
213
+
214
+ function failedUploadsItem(failedUploads: number): KeyValueListItem {
215
+ return {
216
+ id: "failed-uploads",
217
+ label: composedText(`${TEXTS}.attention.failed_uploads_action`, {
218
+ files: countParam(failedUploads),
219
+ }),
220
+ value: failedUploads,
221
+ type: "status",
222
+ tone: "error",
223
+ detail: `${TEXTS}.attention.failed_uploads_hint`,
224
+ to: `${MEDIA_ROUTES.uploads}?tab=failed`,
225
+ };
226
+ }
227
+
228
+ function missingAltAttention(
229
+ input: OverviewInput,
230
+ undescribed: MediaAsset[],
231
+ ): KeyValueListItem {
232
+ return {
233
+ id: "missing-alt",
234
+ label: composedText(`${TEXTS}.attention.missing_alt_action`, {
235
+ files: countParam(undescribed.length),
236
+ }),
237
+ value: undescribed.length,
238
+ type: "status",
239
+ tone: "warning",
240
+ detail: composedText(`${TEXTS}.attention.missing_alt_detail`, {
241
+ files: countParam(countPublic(input, undescribed)),
242
+ }),
243
+ to: viewLink("missing-alt"),
244
+ };
245
+ }
246
+
247
+ function largeFilesItem(large: MediaAsset[]): KeyValueListItem {
248
+ return {
249
+ id: "large-files",
250
+ label: composedText(`${TEXTS}.attention.large_files_action`, {
251
+ files: countParam(large.length),
252
+ threshold: composedBytes(LARGE_FILE_BYTES),
253
+ }),
254
+ value: large.length,
255
+ type: "status",
256
+ tone: "neutral",
257
+ detail: composedText(`${TEXTS}.attention.large_files_detail`, {
258
+ size: composedBytes(totalSize(large)),
259
+ }),
260
+ to: viewLink("largest"),
261
+ };
262
+ }
263
+
264
+ /** What the owner should act on first: failed uploads, missing alt texts, heavy files. */
265
+ export function buildAttentionItems(input: AttentionInput): KeyValueListItem[] {
266
+ const undescribed = missingAlt(input.assets);
267
+ const large = input.assets.filter((asset) => asset.size > LARGE_FILE_BYTES);
268
+ return [
269
+ input.failedUploads > 0 ? failedUploadsItem(input.failedUploads) : null,
270
+ undescribed.length > 0 ? missingAltAttention(input, undescribed) : null,
271
+ large.length > 0 ? largeFilesItem(large) : null,
272
+ ].filter((item): item is KeyValueListItem => item !== null);
273
+ }
274
+
275
+ export function recentAssets(
276
+ assets: MediaAsset[],
277
+ limit: number,
278
+ ): MediaAsset[] {
279
+ return [...assets]
280
+ .sort((left, right) => right.createdAt.getTime() - left.createdAt.getTime())
281
+ .slice(0, limit);
282
+ }
@@ -0,0 +1,127 @@
1
+ import type { KeyValueListItem } from "@antelopejs/interface-dms/base/key-value-list";
2
+ import type { ComposedTextDateFormat } from "@antelopejs/interface-dms/base/types";
3
+ import type { SweepReport } from "../crons";
4
+ import type { MediaAsset } from "../db";
5
+ import { DEFAULT_PRESETS, type MediaPresetConfig } from "../presets";
6
+ import { composedText, countParam } from "./composed-text";
7
+
8
+ const TEXTS = "$dms_media.presets.cache";
9
+ const SECONDS_PER_MINUTE = 60;
10
+ const SECONDS_PER_HOUR = 60 * SECONDS_PER_MINUTE;
11
+ const CRON_MINUTE_INDEX = 0;
12
+ const CRON_HOUR_INDEX = 1;
13
+ const DATE_FORMAT: ComposedTextDateFormat = "day";
14
+
15
+ export interface PresetCacheFacts {
16
+ publicLinkSeconds: number;
17
+ privateLinkSeconds: number;
18
+ sweepSchedule: string;
19
+ lastSweep?: SweepReport;
20
+ now: Date;
21
+ }
22
+
23
+ /** A lifetime in whole hours when it is one ("1 h"), else in minutes ("5 min"). */
24
+ function duration(seconds: number) {
25
+ if (seconds >= SECONDS_PER_HOUR && seconds % SECONDS_PER_HOUR === 0)
26
+ return composedText(`${TEXTS}.hours`, {
27
+ count: countParam(seconds / SECONDS_PER_HOUR),
28
+ });
29
+ return composedText(`${TEXTS}.minutes`, {
30
+ count: countParam(Math.max(Math.round(seconds / SECONDS_PER_MINUTE), 1)),
31
+ });
32
+ }
33
+
34
+ /** Next time a daily `m h * * *` schedule runs, in the server's clock. */
35
+ export function nextDailyRun(schedule: string, now: Date): Date {
36
+ const parts = schedule.split(" ");
37
+ const next = new Date(now);
38
+ next.setHours(
39
+ Number(parts[CRON_HOUR_INDEX] ?? 0),
40
+ Number(parts[CRON_MINUTE_INDEX] ?? 0),
41
+ 0,
42
+ 0,
43
+ );
44
+ if (next <= now) next.setDate(next.getDate() + 1);
45
+ return next;
46
+ }
47
+
48
+ function sweepItem(facts: PresetCacheFacts): KeyValueListItem {
49
+ const next = {
50
+ type: "datetime" as const,
51
+ value: nextDailyRun(facts.sweepSchedule, facts.now).toISOString(),
52
+ format: DATE_FORMAT,
53
+ };
54
+ const { lastSweep } = facts;
55
+ return {
56
+ id: "sweep",
57
+ label: `${TEXTS}.sweep_label`,
58
+ value: lastSweep
59
+ ? composedText(`${TEXTS}.sweep_removed`, {
60
+ count: countParam(lastSweep.removedFiles),
61
+ })
62
+ : `${TEXTS}.sweep_never`,
63
+ detail: lastSweep
64
+ ? composedText(`${TEXTS}.sweep_last`, {
65
+ last: {
66
+ type: "datetime",
67
+ value: lastSweep.finishedAt.toISOString(),
68
+ format: DATE_FORMAT,
69
+ },
70
+ next,
71
+ })
72
+ : composedText(`${TEXTS}.sweep_next`, { next }),
73
+ };
74
+ }
75
+
76
+ /** The cache card of the image sizes page, worded as what the owner sees happen. */
77
+ export function buildPresetCacheItems(
78
+ facts: PresetCacheFacts,
79
+ ): KeyValueListItem[] {
80
+ return [
81
+ {
82
+ id: "edits",
83
+ label: `${TEXTS}.edits_label`,
84
+ value: `${TEXTS}.edits_value`,
85
+ detail: `${TEXTS}.edits_hint`,
86
+ },
87
+ {
88
+ id: "public",
89
+ label: `${TEXTS}.public_label`,
90
+ value: duration(facts.publicLinkSeconds),
91
+ detail: `${TEXTS}.public_hint`,
92
+ },
93
+ {
94
+ id: "private",
95
+ label: `${TEXTS}.private_label`,
96
+ value: duration(facts.privateLinkSeconds),
97
+ detail: `${TEXTS}.private_hint`,
98
+ },
99
+ sweepItem(facts),
100
+ ];
101
+ }
102
+
103
+ /** Whether the module runs on the sizes it ships with, nothing configured. */
104
+ export function usesDefaultPresets(presets: MediaPresetConfig[]): boolean {
105
+ return JSON.stringify(presets) === JSON.stringify(DEFAULT_PRESETS);
106
+ }
107
+
108
+ /** Photos and pictures a size is shown on; never a vector, which may be anything. */
109
+ const EXAMPLE_MIMETYPES: ReadonlySet<string> = new Set([
110
+ "image/jpeg",
111
+ "image/png",
112
+ "image/webp",
113
+ "image/avif",
114
+ ]);
115
+
116
+ /** The image shown rendered by each size: the newest public photo, else the newest photo. */
117
+ export function pickExampleImage(
118
+ assets: MediaAsset[],
119
+ isPublic: (asset: MediaAsset) => boolean,
120
+ ): MediaAsset | undefined {
121
+ const images = assets
122
+ .filter((asset) => EXAMPLE_MIMETYPES.has(asset.mimetype.toLowerCase()))
123
+ .sort(
124
+ (left, right) => right.createdAt.getTime() - left.createdAt.getTime(),
125
+ );
126
+ return images.find(isPublic) ?? images[0];
127
+ }
@@ -0,0 +1,48 @@
1
+ import { Logging } from "@antelopejs/interface-core/logging";
2
+ import { PublishMessage } from "@antelopejs/interface-dms";
3
+ import { MEDIA_LIBRARY_TOPIC } from "../constants";
4
+
5
+ /** Writes landing this close together (a bulk move, a batch) are announced once. */
6
+ const COALESCE_WINDOW_MS = 250;
7
+ /** Each uploaded file is announced, at most once per window during a batch. */
8
+ export const UPLOAD_ANNOUNCE_WINDOW_MS = 2000;
9
+ const LIBRARY_CHANGED = "changed";
10
+
11
+ let pending: ReturnType<typeof setTimeout> | undefined;
12
+ let pendingDueAt = 0;
13
+ let version = 0;
14
+
15
+ async function publishNow(): Promise<void> {
16
+ pending = undefined;
17
+ try {
18
+ await PublishMessage(MEDIA_LIBRARY_TOPIC, LIBRARY_CHANGED);
19
+ } catch (error) {
20
+ Logging.Error("Failed to publish a media library change", error);
21
+ }
22
+ }
23
+
24
+ /**
25
+ * Tells the pages showing the library that it changed, so their blocks read
26
+ * their routes again. The message carries nothing: each block re-reads what
27
+ * its reader may see. An announcement already due sooner absorbs this one.
28
+ */
29
+ export function announceLibraryChange(delayMs = COALESCE_WINDOW_MS): void {
30
+ version += 1;
31
+ const dueAt = Date.now() + delayMs;
32
+ if (pending && pendingDueAt <= dueAt) return;
33
+ clearTimeout(pending);
34
+ pendingDueAt = dueAt;
35
+ pending = setTimeout(() => void publishNow(), delayMs);
36
+ pending.unref?.();
37
+ }
38
+
39
+ /** Grows on each change, so a value computed from the library can tell it is stale. */
40
+ export function libraryVersion(): number {
41
+ return version;
42
+ }
43
+
44
+ /** Drops an announcement still waiting, when the module stops. */
45
+ export function cancelLibraryChange(): void {
46
+ clearTimeout(pending);
47
+ pending = undefined;
48
+ }
@@ -0,0 +1,88 @@
1
+ import type { MediaAsset, MediaFolder } from "../db";
2
+ import type {
3
+ AssetFilterQuery,
4
+ SearchQuery,
5
+ } from "../validation/library.schema";
6
+ import { type AssetFilterContext, filterAssets } from "./asset-filters";
7
+
8
+ export type SearchMatch = "name" | "alt";
9
+
10
+ export interface AssetSearchHit {
11
+ asset: MediaAsset;
12
+ matchedOn: SearchMatch;
13
+ }
14
+
15
+ const COMBINING_MARKS = /\p{M}+/gu;
16
+ const WORD_SEPARATORS = /[^\p{L}\p{N}]+/gu;
17
+
18
+ /** Lowercase, accent-free text with every punctuation run turned into one space. */
19
+ export function normalizeSearchText(text: string): string {
20
+ return text
21
+ .normalize("NFD")
22
+ .replace(COMBINING_MARKS, "")
23
+ .toLowerCase()
24
+ .replace(WORD_SEPARATORS, " ")
25
+ .trim();
26
+ }
27
+
28
+ /** The words of a search term, each to be found somewhere in what is searched. */
29
+ export function searchWords(term: string): string[] {
30
+ const normalized = normalizeSearchText(term);
31
+ return normalized ? normalized.split(" ") : [];
32
+ }
33
+
34
+ function containsEvery(haystack: string, words: string[]): boolean {
35
+ return words.every((word) => haystack.includes(word));
36
+ }
37
+
38
+ /**
39
+ * Where an asset matches: every word must appear in its name, its folder path
40
+ * or its alt text, and at least one in the name or the alt text, so a folder
41
+ * name narrows a search without listing the whole folder. Accents, case and
42
+ * punctuation are ignored.
43
+ */
44
+ export function matchAsset(
45
+ asset: MediaAsset,
46
+ words: string[],
47
+ folderPath = "",
48
+ ): SearchMatch | undefined {
49
+ if (words.length === 0) return "name";
50
+ const name = normalizeSearchText(asset.name);
51
+ const path = normalizeSearchText(folderPath);
52
+ const alt = normalizeSearchText(asset.alt ?? "");
53
+ const own = `${name} ${alt}`;
54
+ if (!containsEvery(`${own} ${path}`, words)) return undefined;
55
+ if (!words.some((word) => own.includes(word))) return undefined;
56
+ return containsEvery(`${name} ${path}`, words) ? "name" : "alt";
57
+ }
58
+
59
+ export interface SearchFilterContext extends AssetFilterContext {
60
+ query: AssetFilterQuery & Partial<SearchQuery> & { q: string };
61
+ /** Names of the asset's folder and its ancestors, searched with its name. */
62
+ folderPathOf?: (asset: MediaAsset) => string;
63
+ }
64
+
65
+ /** Applies the facet filters then the term; the type facet stays open. */
66
+ export function searchAssets(
67
+ assets: MediaAsset[],
68
+ filter: SearchFilterContext,
69
+ ): AssetSearchHit[] {
70
+ const words = searchWords(filter.query.q);
71
+ const hits: AssetSearchHit[] = [];
72
+ for (const asset of filterAssets(assets, filter)) {
73
+ const matchedOn = matchAsset(asset, words, filter.folderPathOf?.(asset));
74
+ if (matchedOn) hits.push({ asset, matchedOn });
75
+ }
76
+ return hits;
77
+ }
78
+
79
+ export function searchFolders(
80
+ folders: MediaFolder[],
81
+ term: string,
82
+ ): MediaFolder[] {
83
+ const words = searchWords(term);
84
+ if (words.length === 0) return [];
85
+ return folders.filter((folder) =>
86
+ containsEvery(normalizeSearchText(folder.name), words),
87
+ );
88
+ }
@@ -0,0 +1,39 @@
1
+ import type { MediaPresetConfig } from "../presets";
2
+
3
+ const INDENT = " ";
4
+ const PRESET_KEYS = [
5
+ "id",
6
+ "width",
7
+ "height",
8
+ "fit",
9
+ "format",
10
+ "quality",
11
+ ] as const;
12
+
13
+ function indent(lines: string[], depth: number): string[] {
14
+ return lines.map((line) => `${INDENT.repeat(depth)}${line}`);
15
+ }
16
+
17
+ function presetLine(preset: MediaPresetConfig): string {
18
+ const entries = PRESET_KEYS.filter((key) => preset[key] !== undefined).map(
19
+ (key) => [key, preset[key]],
20
+ );
21
+ return JSON.stringify(Object.fromEntries(entries));
22
+ }
23
+
24
+ /** The `presets` block of `antelope.config.ts` that declares these presets. */
25
+ export function presetsConfigSnippet(presets: MediaPresetConfig[]): string {
26
+ const lines = presets.map(
27
+ (preset, index) =>
28
+ `${presetLine(preset)}${index < presets.length - 1 ? "," : ""}`,
29
+ );
30
+ return [
31
+ '"dms-media": {',
32
+ ...indent(['"config": {'], 1),
33
+ ...indent(['"presets": ['], 2),
34
+ ...indent(lines, 3),
35
+ ...indent(["]"], 2),
36
+ ...indent(["}"], 1),
37
+ "}",
38
+ ].join("\n");
39
+ }
@@ -0,0 +1,76 @@
1
+ export const ASSET_TYPE_GROUPS = [
2
+ "image",
3
+ "video",
4
+ "audio",
5
+ "pdf",
6
+ "document",
7
+ "spreadsheet",
8
+ "vector",
9
+ "archive",
10
+ "other",
11
+ ] as const;
12
+
13
+ export type AssetTypeGroup = (typeof ASSET_TYPE_GROUPS)[number];
14
+
15
+ interface TypeGroupRule {
16
+ group: AssetTypeGroup;
17
+ matches: (mimetype: string) => boolean;
18
+ }
19
+
20
+ const SPREADSHEET_MIMETYPES = new Set([
21
+ "text/csv",
22
+ "application/vnd.ms-excel",
23
+ "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
24
+ "application/vnd.oasis.opendocument.spreadsheet",
25
+ ]);
26
+
27
+ const DOCUMENT_MIMETYPES = new Set([
28
+ "application/msword",
29
+ "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
30
+ "application/vnd.ms-powerpoint",
31
+ "application/vnd.openxmlformats-officedocument.presentationml.presentation",
32
+ "application/vnd.oasis.opendocument.text",
33
+ "application/vnd.oasis.opendocument.presentation",
34
+ "application/rtf",
35
+ "text/plain",
36
+ "text/markdown",
37
+ ]);
38
+
39
+ const ARCHIVE_MIMETYPES = new Set([
40
+ "application/zip",
41
+ "application/x-zip-compressed",
42
+ "application/x-tar",
43
+ "application/gzip",
44
+ "application/x-7z-compressed",
45
+ "application/vnd.rar",
46
+ ]);
47
+
48
+ const TYPE_GROUP_RULES: TypeGroupRule[] = [
49
+ { group: "vector", matches: (mimetype) => mimetype === "image/svg+xml" },
50
+ { group: "image", matches: (mimetype) => mimetype.startsWith("image/") },
51
+ { group: "video", matches: (mimetype) => mimetype.startsWith("video/") },
52
+ { group: "audio", matches: (mimetype) => mimetype.startsWith("audio/") },
53
+ { group: "pdf", matches: (mimetype) => mimetype === "application/pdf" },
54
+ {
55
+ group: "spreadsheet",
56
+ matches: (mimetype) => SPREADSHEET_MIMETYPES.has(mimetype),
57
+ },
58
+ {
59
+ group: "document",
60
+ matches: (mimetype) => DOCUMENT_MIMETYPES.has(mimetype),
61
+ },
62
+ { group: "archive", matches: (mimetype) => ARCHIVE_MIMETYPES.has(mimetype) },
63
+ ];
64
+
65
+ export function resolveTypeGroup(mimetype: string): AssetTypeGroup {
66
+ const normalized = mimetype.toLowerCase();
67
+ return (
68
+ TYPE_GROUP_RULES.find((rule) => rule.matches(normalized))?.group ?? "other"
69
+ );
70
+ }
71
+
72
+ /** Whether an asset is an image that alt text describes (vectors included). */
73
+ export function isDescribableImage(mimetype: string): boolean {
74
+ const group = resolveTypeGroup(mimetype);
75
+ return group === "image" || group === "vector";
76
+ }
@@ -0,0 +1,31 @@
1
+ import { GetModel } from "@antelopejs/interface-database-decorators";
2
+ import { type MediaEvent, MediaEventModel } from "../db";
3
+ import { FAILURE_WINDOW_MS } from "./batches";
4
+ import { listEventsSince } from "./events";
5
+
6
+ /** The newest events the upload history reads, besides every one of the last 24 h. */
7
+ const HISTORY_EVENTS_SCANNED = 1000;
8
+
9
+ /**
10
+ * The events the upload history and the failed-uploads counter both read: the
11
+ * newest ones and all of the last 24 h, in folders that still exist and the
12
+ * reader can open. A deleted folder takes its failures out of the counter.
13
+ */
14
+ export async function loadUploadHistoryEvents(
15
+ tenantId: string,
16
+ readableFolderIds: ReadonlySet<string>,
17
+ now: Date,
18
+ ): Promise<MediaEvent[]> {
19
+ const [recent, today] = await Promise.all([
20
+ GetModel(MediaEventModel, tenantId).listRecent(HISTORY_EVENTS_SCANNED),
21
+ listEventsSince(tenantId, new Date(now.getTime() - FAILURE_WINDOW_MS)),
22
+ ]);
23
+ const byId = new Map(
24
+ [...recent, ...today].map((event) => [event._id, event]),
25
+ );
26
+ return [...byId.values()]
27
+ .filter((event) => event.folderId && readableFolderIds.has(event.folderId))
28
+ .sort(
29
+ (left, right) => right.createdAt.getTime() - left.createdAt.getTime(),
30
+ );
31
+ }