@antelopejs/dms-media 0.0.1

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 (360) hide show
  1. package/LICENSE +190 -0
  2. package/README.md +114 -0
  3. package/dist/acl/defaults.d.ts +2 -0
  4. package/dist/acl/defaults.js +19 -0
  5. package/dist/acl/defaults.js.map +1 -0
  6. package/dist/acl/entries.d.ts +4 -0
  7. package/dist/acl/entries.js +21 -0
  8. package/dist/acl/entries.js.map +1 -0
  9. package/dist/acl/grantable.d.ts +1 -0
  10. package/dist/acl/grantable.js +11 -0
  11. package/dist/acl/grantable.js.map +1 -0
  12. package/dist/acl/index.d.ts +4 -0
  13. package/dist/acl/index.js +21 -0
  14. package/dist/acl/index.js.map +1 -0
  15. package/dist/acl/resolver.d.ts +15 -0
  16. package/dist/acl/resolver.js +115 -0
  17. package/dist/acl/resolver.js.map +1 -0
  18. package/dist/asset-lifecycle.d.ts +6 -0
  19. package/dist/asset-lifecycle.js +78 -0
  20. package/dist/asset-lifecycle.js.map +1 -0
  21. package/dist/asset-type/asset-type.d.ts +24 -0
  22. package/dist/asset-type/asset-type.js +54 -0
  23. package/dist/asset-type/asset-type.js.map +1 -0
  24. package/dist/asset-type/bindings.d.ts +19 -0
  25. package/dist/asset-type/bindings.js +116 -0
  26. package/dist/asset-type/bindings.js.map +1 -0
  27. package/dist/asset-type/index.d.ts +2 -0
  28. package/dist/asset-type/index.js +19 -0
  29. package/dist/asset-type/index.js.map +1 -0
  30. package/dist/config.d.ts +15 -0
  31. package/dist/config.js +24 -0
  32. package/dist/config.js.map +1 -0
  33. package/dist/constants.d.ts +6 -0
  34. package/dist/constants.js +10 -0
  35. package/dist/constants.js.map +1 -0
  36. package/dist/crons/index.d.ts +3 -0
  37. package/dist/crons/index.js +23 -0
  38. package/dist/crons/index.js.map +1 -0
  39. package/dist/crons/sweep-derivatives.d.ts +6 -0
  40. package/dist/crons/sweep-derivatives.js +63 -0
  41. package/dist/crons/sweep-derivatives.js.map +1 -0
  42. package/dist/db/index.d.ts +2 -0
  43. package/dist/db/index.js +19 -0
  44. package/dist/db/index.js.map +1 -0
  45. package/dist/db/models/index.d.ts +2 -0
  46. package/dist/db/models/index.js +19 -0
  47. package/dist/db/models/index.js.map +1 -0
  48. package/dist/db/models/mediaAssets.model.d.ts +26 -0
  49. package/dist/db/models/mediaAssets.model.js +58 -0
  50. package/dist/db/models/mediaAssets.model.js.map +1 -0
  51. package/dist/db/models/mediaFolders.model.d.ts +25 -0
  52. package/dist/db/models/mediaFolders.model.js +27 -0
  53. package/dist/db/models/mediaFolders.model.js.map +1 -0
  54. package/dist/db/tables/index.d.ts +2 -0
  55. package/dist/db/tables/index.js +19 -0
  56. package/dist/db/tables/index.js.map +1 -0
  57. package/dist/db/tables/mediaAssets.table.d.ts +24 -0
  58. package/dist/db/tables/mediaAssets.table.js +105 -0
  59. package/dist/db/tables/mediaAssets.table.js.map +1 -0
  60. package/dist/db/tables/mediaFolders.table.d.ts +14 -0
  61. package/dist/db/tables/mediaFolders.table.js +65 -0
  62. package/dist/db/tables/mediaFolders.table.js.map +1 -0
  63. package/dist/derivatives.d.ts +12 -0
  64. package/dist/derivatives.js +166 -0
  65. package/dist/derivatives.js.map +1 -0
  66. package/dist/index.d.ts +18 -0
  67. package/dist/index.js +66 -0
  68. package/dist/index.js.map +1 -0
  69. package/dist/pages/index.d.ts +1 -0
  70. package/dist/pages/index.js +18 -0
  71. package/dist/pages/index.js.map +1 -0
  72. package/dist/pages/media.d.ts +10 -0
  73. package/dist/pages/media.js +35 -0
  74. package/dist/pages/media.js.map +1 -0
  75. package/dist/permissions.d.ts +1 -0
  76. package/dist/permissions.js +37 -0
  77. package/dist/permissions.js.map +1 -0
  78. package/dist/presets.d.ts +15 -0
  79. package/dist/presets.js +48 -0
  80. package/dist/presets.js.map +1 -0
  81. package/dist/routes/index.d.ts +1 -0
  82. package/dist/routes/index.js +18 -0
  83. package/dist/routes/index.js.map +1 -0
  84. package/dist/routes/media/assets.d.ts +48 -0
  85. package/dist/routes/media/assets.js +263 -0
  86. package/dist/routes/media/assets.js.map +1 -0
  87. package/dist/routes/media/constants.d.ts +5 -0
  88. package/dist/routes/media/constants.js +12 -0
  89. package/dist/routes/media/constants.js.map +1 -0
  90. package/dist/routes/media/context.d.ts +49 -0
  91. package/dist/routes/media/context.js +95 -0
  92. package/dist/routes/media/context.js.map +1 -0
  93. package/dist/routes/media/delivery.d.ts +14 -0
  94. package/dist/routes/media/delivery.js +123 -0
  95. package/dist/routes/media/delivery.js.map +1 -0
  96. package/dist/routes/media/dto.d.ts +43 -0
  97. package/dist/routes/media/dto.js +66 -0
  98. package/dist/routes/media/dto.js.map +1 -0
  99. package/dist/routes/media/folders.d.ts +46 -0
  100. package/dist/routes/media/folders.js +259 -0
  101. package/dist/routes/media/folders.js.map +1 -0
  102. package/dist/routes/media/index.d.ts +9 -0
  103. package/dist/routes/media/index.js +26 -0
  104. package/dist/routes/media/index.js.map +1 -0
  105. package/dist/routes/media/storage-keys.d.ts +3 -0
  106. package/dist/routes/media/storage-keys.js +19 -0
  107. package/dist/routes/media/storage-keys.js.map +1 -0
  108. package/dist/routes/media/transform.d.ts +21 -0
  109. package/dist/routes/media/transform.js +99 -0
  110. package/dist/routes/media/transform.js.map +1 -0
  111. package/dist/routes/media/upload.d.ts +24 -0
  112. package/dist/routes/media/upload.js +145 -0
  113. package/dist/routes/media/upload.js.map +1 -0
  114. package/dist/test/antelope.test.d.ts +2 -0
  115. package/dist/test/antelope.test.js +202 -0
  116. package/dist/test/antelope.test.js.map +1 -0
  117. package/dist/test/helpers/assets.d.ts +21 -0
  118. package/dist/test/helpers/assets.js +61 -0
  119. package/dist/test/helpers/assets.js.map +1 -0
  120. package/dist/test/helpers/http.d.ts +4 -0
  121. package/dist/test/helpers/http.js +28 -0
  122. package/dist/test/helpers/http.js.map +1 -0
  123. package/dist/test/helpers/members.d.ts +10 -0
  124. package/dist/test/helpers/members.js +57 -0
  125. package/dist/test/helpers/members.js.map +1 -0
  126. package/dist/test/helpers/owner.d.ts +5 -0
  127. package/dist/test/helpers/owner.js +30 -0
  128. package/dist/test/helpers/owner.js.map +1 -0
  129. package/dist/test/integration/derivative-sweep-query.test.d.ts +1 -0
  130. package/dist/test/integration/derivative-sweep-query.test.js +61 -0
  131. package/dist/test/integration/derivative-sweep-query.test.js.map +1 -0
  132. package/dist/test/integration/folder-query.test.d.ts +1 -0
  133. package/dist/test/integration/folder-query.test.js +88 -0
  134. package/dist/test/integration/folder-query.test.js.map +1 -0
  135. package/dist/test/integration/media-api.test.d.ts +1 -0
  136. package/dist/test/integration/media-api.test.js +178 -0
  137. package/dist/test/integration/media-api.test.js.map +1 -0
  138. package/dist/test/integration/media-bindings.test.d.ts +1 -0
  139. package/dist/test/integration/media-bindings.test.js +141 -0
  140. package/dist/test/integration/media-bindings.test.js.map +1 -0
  141. package/dist/test/integration/media-cleanup.test.d.ts +1 -0
  142. package/dist/test/integration/media-cleanup.test.js +282 -0
  143. package/dist/test/integration/media-cleanup.test.js.map +1 -0
  144. package/dist/test/integration/media-delivery.test.d.ts +1 -0
  145. package/dist/test/integration/media-delivery.test.js +108 -0
  146. package/dist/test/integration/media-delivery.test.js.map +1 -0
  147. package/dist/test/integration/media-guards.test.d.ts +1 -0
  148. package/dist/test/integration/media-guards.test.js +128 -0
  149. package/dist/test/integration/media-guards.test.js.map +1 -0
  150. package/dist/test/integration/media-list-query.test.d.ts +1 -0
  151. package/dist/test/integration/media-list-query.test.js +86 -0
  152. package/dist/test/integration/media-list-query.test.js.map +1 -0
  153. package/dist/test/integration/media-permissions.test.d.ts +1 -0
  154. package/dist/test/integration/media-permissions.test.js +549 -0
  155. package/dist/test/integration/media-permissions.test.js.map +1 -0
  156. package/dist/test/integration/media-search-query.test.d.ts +1 -0
  157. package/dist/test/integration/media-search-query.test.js +100 -0
  158. package/dist/test/integration/media-search-query.test.js.map +1 -0
  159. package/dist/test/integration/media-transform.test.d.ts +1 -0
  160. package/dist/test/integration/media-transform.test.js +125 -0
  161. package/dist/test/integration/media-transform.test.js.map +1 -0
  162. package/dist/test/integration/setup.test.d.ts +1 -0
  163. package/dist/test/integration/setup.test.js +32 -0
  164. package/dist/test/integration/setup.test.js.map +1 -0
  165. package/dist/test/unit/acl/entries.test.d.ts +1 -0
  166. package/dist/test/unit/acl/entries.test.js +46 -0
  167. package/dist/test/unit/acl/entries.test.js.map +1 -0
  168. package/dist/test/unit/acl/grantable.test.d.ts +1 -0
  169. package/dist/test/unit/acl/grantable.test.js +41 -0
  170. package/dist/test/unit/acl/grantable.test.js.map +1 -0
  171. package/dist/test/unit/acl/resolver.test.d.ts +1 -0
  172. package/dist/test/unit/acl/resolver.test.js +183 -0
  173. package/dist/test/unit/acl/resolver.test.js.map +1 -0
  174. package/dist/test/unit/asset-type/bindings.test.d.ts +1 -0
  175. package/dist/test/unit/asset-type/bindings.test.js +127 -0
  176. package/dist/test/unit/asset-type/bindings.test.js.map +1 -0
  177. package/dist/test/unit/config.test.d.ts +1 -0
  178. package/dist/test/unit/config.test.js +38 -0
  179. package/dist/test/unit/config.test.js.map +1 -0
  180. package/dist/test/unit/derivatives.test.d.ts +1 -0
  181. package/dist/test/unit/derivatives.test.js +41 -0
  182. package/dist/test/unit/derivatives.test.js.map +1 -0
  183. package/dist/test/unit/routes/dto.test.d.ts +1 -0
  184. package/dist/test/unit/routes/dto.test.js +34 -0
  185. package/dist/test/unit/routes/dto.test.js.map +1 -0
  186. package/dist/test/unit/transform.test.d.ts +1 -0
  187. package/dist/test/unit/transform.test.js +37 -0
  188. package/dist/test/unit/transform.test.js.map +1 -0
  189. package/dist/transform.d.ts +22 -0
  190. package/dist/transform.js +117 -0
  191. package/dist/transform.js.map +1 -0
  192. package/dist/types.d.ts +12 -0
  193. package/dist/types.js +3 -0
  194. package/dist/types.js.map +1 -0
  195. package/dist/validation/media.schema.d.ts +221 -0
  196. package/dist/validation/media.schema.js +94 -0
  197. package/dist/validation/media.schema.js.map +1 -0
  198. package/frontend-vue/.editorconfig +12 -0
  199. package/frontend-vue/.prettierrc +11 -0
  200. package/frontend-vue/app/components/AssetPicker.vue +272 -0
  201. package/frontend-vue/app/components/Library.vue +21 -0
  202. package/frontend-vue/app/components/PickerModal.vue +47 -0
  203. package/frontend-vue/app/components/StorageOverview.vue +105 -0
  204. package/frontend-vue/app/components/finder/Modal.vue +41 -0
  205. package/frontend-vue/app/components/finder/Root.vue +72 -0
  206. package/frontend-vue/app/components/finder/components/DeleteFolderConfirm.vue +55 -0
  207. package/frontend-vue/app/components/finder/components/EditImage.vue +157 -0
  208. package/frontend-vue/app/components/finder/components/Empty.vue +13 -0
  209. package/frontend-vue/app/components/finder/components/FilterMenu.vue +115 -0
  210. package/frontend-vue/app/components/finder/components/Preview.vue +35 -0
  211. package/frontend-vue/app/components/finder/components/search-file.vue +24 -0
  212. package/frontend-vue/app/components/finder/core/panel.vue +132 -0
  213. package/frontend-vue/app/components/finder/core/toolbar.vue +55 -0
  214. package/frontend-vue/app/components/finder/index.vue +87 -0
  215. package/frontend-vue/app/components/finder/layout/Footer.vue +97 -0
  216. package/frontend-vue/app/components/finder/layout/Header.vue +16 -0
  217. package/frontend-vue/app/components/finder/layout/navigation/Breadcrumbs.vue +114 -0
  218. package/frontend-vue/app/components/finder/layout/navigation/index.vue +40 -0
  219. package/frontend-vue/app/components/finder/layout/panel/Details.vue +192 -0
  220. package/frontend-vue/app/components/finder/layout/panel/Shortcuts.vue +265 -0
  221. package/frontend-vue/app/components/finder/layout/panel/Toogle.vue +27 -0
  222. package/frontend-vue/app/components/finder/layout/view/Column.vue +180 -0
  223. package/frontend-vue/app/components/finder/layout/view/Grid.vue +37 -0
  224. package/frontend-vue/app/components/finder/layout/view/List.vue +289 -0
  225. package/frontend-vue/app/components/finder/layout/view/Toggle.vue +27 -0
  226. package/frontend-vue/app/components/finder/layout/view/card/Column.vue +182 -0
  227. package/frontend-vue/app/components/finder/layout/view/card/Ghost.vue +46 -0
  228. package/frontend-vue/app/components/finder/layout/view/card/Grid.vue +219 -0
  229. package/frontend-vue/app/components/finder/layout/view/card/Input.vue +63 -0
  230. package/frontend-vue/app/components/finder/layout/view/card/List.vue +29 -0
  231. package/frontend-vue/app/components/finder/layout/view/index.vue +80 -0
  232. package/frontend-vue/app/components/picker/PickerColumnsView.vue +170 -0
  233. package/frontend-vue/app/components/picker/PickerDeleteConfirm.vue +62 -0
  234. package/frontend-vue/app/components/picker/PickerExplorer.vue +436 -0
  235. package/frontend-vue/app/components/picker/PickerGridView.vue +136 -0
  236. package/frontend-vue/app/components/picker/PickerItemThumb.vue +49 -0
  237. package/frontend-vue/app/components/picker/PickerLightbox.vue +158 -0
  238. package/frontend-vue/app/components/picker/PickerListView.vue +188 -0
  239. package/frontend-vue/app/components/picker/PickerMoveDialog.vue +115 -0
  240. package/frontend-vue/app/components/picker/PickerNameEdit.vue +50 -0
  241. package/frontend-vue/app/components/picker/PickerPreviewBody.vue +109 -0
  242. package/frontend-vue/app/components/picker/PickerPreviewPane.vue +21 -0
  243. package/frontend-vue/app/components/picker/PickerSidebar.vue +87 -0
  244. package/frontend-vue/app/components/picker/PickerToolbar.vue +142 -0
  245. package/frontend-vue/app/composables/finder/actions/useDeselectOnOutsideClick.ts +40 -0
  246. package/frontend-vue/app/composables/finder/actions/useDraggableItem.ts +102 -0
  247. package/frontend-vue/app/composables/finder/actions/useDropTarget.ts +81 -0
  248. package/frontend-vue/app/composables/finder/actions/useFileUpload.ts +45 -0
  249. package/frontend-vue/app/composables/finder/actions/useRowDragState.ts +47 -0
  250. package/frontend-vue/app/composables/finder/actions/useSelectionClick.ts +53 -0
  251. package/frontend-vue/app/composables/finder/api/useMediaApi.ts +135 -0
  252. package/frontend-vue/app/composables/finder/context/useFinderContext.ts +55 -0
  253. package/frontend-vue/app/composables/finder/context/useFinderDragAndDrop.ts +66 -0
  254. package/frontend-vue/app/composables/finder/context/useFinderHooks.ts +93 -0
  255. package/frontend-vue/app/composables/finder/context/useFinderLayout.ts +191 -0
  256. package/frontend-vue/app/composables/finder/context/useFinderNavigation.ts +36 -0
  257. package/frontend-vue/app/composables/finder/context/useFinderPicker.ts +22 -0
  258. package/frontend-vue/app/composables/finder/context/useFinderSelect.ts +72 -0
  259. package/frontend-vue/app/composables/finder/hooks/file.ts +86 -0
  260. package/frontend-vue/app/composables/finder/hooks/finder.ts +25 -0
  261. package/frontend-vue/app/composables/finder/hooks/folder.ts +66 -0
  262. package/frontend-vue/app/composables/finder/hooks/navigation.ts +64 -0
  263. package/frontend-vue/app/composables/finder/hooks/selection.ts +31 -0
  264. package/frontend-vue/app/composables/finder/menu/useContextMenu.ts +180 -0
  265. package/frontend-vue/app/composables/finder/menu/useFinderMenu.ts +41 -0
  266. package/frontend-vue/app/composables/finder/menu/useItemMenu.ts +114 -0
  267. package/frontend-vue/app/composables/finder/shortcuts/finderEscape.ts +9 -0
  268. package/frontend-vue/app/composables/finder/shortcuts/finderShiftA.ts +9 -0
  269. package/frontend-vue/app/composables/finder/sidebar/useFavoritesFolder.ts +110 -0
  270. package/frontend-vue/app/composables/finder/sidebar/useFolderSize.ts +49 -0
  271. package/frontend-vue/app/composables/finder/sidebar/useRecentFile.ts +20 -0
  272. package/frontend-vue/app/composables/finder/store/useFinderStore.ts +354 -0
  273. package/frontend-vue/app/composables/picker/usePickerExplorer.ts +788 -0
  274. package/frontend-vue/app/config/shortcuts-registry.ts +8 -0
  275. package/frontend-vue/app/types/finder.ts +47 -0
  276. package/frontend-vue/app/utils/finder/context.ts +25 -0
  277. package/frontend-vue/app/utils/finder/filegroup.ts +79 -0
  278. package/frontend-vue/app/utils/finder/filesize.ts +15 -0
  279. package/frontend-vue/app/utils/finder/formatter.ts +66 -0
  280. package/frontend-vue/app/utils/finder/helpers.ts +105 -0
  281. package/frontend-vue/app/utils/finder/mime.ts +108 -0
  282. package/frontend-vue/app/utils/finder/models.ts +153 -0
  283. package/frontend-vue/app/utils/finder/shortcuts.ts +29 -0
  284. package/frontend-vue/dms.frontend.ts +45 -0
  285. package/frontend-vue/eslint.config.mjs +16 -0
  286. package/frontend-vue/i18n/locales/media-en-GB.json +191 -0
  287. package/frontend-vue/i18n/locales/media-fr-FR.json +191 -0
  288. package/frontend-vue/package.json +35 -0
  289. package/frontend-vue/pnpm-lock.yaml +6074 -0
  290. package/frontend-vue/pnpm-workspace.yaml +2 -0
  291. package/frontend-vue/tests/registration.test.ts +36 -0
  292. package/frontend-vue/tsconfig.json +13 -0
  293. package/frontend-vue/vitest.config.ts +5 -0
  294. package/package.json +83 -0
  295. package/src/acl/defaults.ts +21 -0
  296. package/src/acl/entries.ts +19 -0
  297. package/src/acl/grantable.ts +11 -0
  298. package/src/acl/index.ts +4 -0
  299. package/src/acl/resolver.ts +159 -0
  300. package/src/asset-lifecycle.ts +100 -0
  301. package/src/asset-type/asset-type.ts +61 -0
  302. package/src/asset-type/bindings.ts +182 -0
  303. package/src/asset-type/index.ts +2 -0
  304. package/src/config.ts +38 -0
  305. package/src/constants.ts +8 -0
  306. package/src/crons/index.ts +8 -0
  307. package/src/crons/sweep-derivatives.ts +68 -0
  308. package/src/db/index.ts +2 -0
  309. package/src/db/models/index.ts +2 -0
  310. package/src/db/models/mediaAssets.model.ts +72 -0
  311. package/src/db/models/mediaFolders.model.ts +28 -0
  312. package/src/db/tables/index.ts +2 -0
  313. package/src/db/tables/mediaAssets.table.ts +83 -0
  314. package/src/db/tables/mediaFolders.table.ts +52 -0
  315. package/src/derivatives.ts +227 -0
  316. package/src/index.ts +52 -0
  317. package/src/pages/index.ts +1 -0
  318. package/src/pages/media.ts +39 -0
  319. package/src/permissions.ts +44 -0
  320. package/src/presets.ts +61 -0
  321. package/src/routes/index.ts +1 -0
  322. package/src/routes/media/assets.ts +278 -0
  323. package/src/routes/media/constants.ts +18 -0
  324. package/src/routes/media/context.ts +181 -0
  325. package/src/routes/media/delivery.ts +174 -0
  326. package/src/routes/media/dto.ts +116 -0
  327. package/src/routes/media/folders.ts +279 -0
  328. package/src/routes/media/index.ts +9 -0
  329. package/src/routes/media/storage-keys.ts +15 -0
  330. package/src/routes/media/transform.ts +96 -0
  331. package/src/routes/media/upload.ts +161 -0
  332. package/src/test/antelope.test.ts +211 -0
  333. package/src/test/helpers/assets.ts +95 -0
  334. package/src/test/helpers/http.ts +23 -0
  335. package/src/test/helpers/members.ts +78 -0
  336. package/src/test/helpers/owner.ts +37 -0
  337. package/src/test/integration/derivative-sweep-query.test.ts +65 -0
  338. package/src/test/integration/folder-query.test.ts +95 -0
  339. package/src/test/integration/media-api.test.ts +232 -0
  340. package/src/test/integration/media-bindings.test.ts +175 -0
  341. package/src/test/integration/media-cleanup.test.ts +320 -0
  342. package/src/test/integration/media-delivery.test.ts +136 -0
  343. package/src/test/integration/media-guards.test.ts +132 -0
  344. package/src/test/integration/media-list-query.test.ts +98 -0
  345. package/src/test/integration/media-permissions.test.ts +914 -0
  346. package/src/test/integration/media-search-query.test.ts +124 -0
  347. package/src/test/integration/media-transform.test.ts +181 -0
  348. package/src/test/integration/setup.test.ts +35 -0
  349. package/src/test/unit/acl/entries.test.ts +58 -0
  350. package/src/test/unit/acl/grantable.test.ts +54 -0
  351. package/src/test/unit/acl/resolver.test.ts +283 -0
  352. package/src/test/unit/asset-type/bindings.test.ts +141 -0
  353. package/src/test/unit/config.test.ts +44 -0
  354. package/src/test/unit/derivatives.test.ts +54 -0
  355. package/src/test/unit/routes/dto.test.ts +65 -0
  356. package/src/test/unit/transform.test.ts +51 -0
  357. package/src/transform.ts +183 -0
  358. package/src/types.ts +17 -0
  359. package/src/validation/media.schema.ts +117 -0
  360. package/tsconfig.json +29 -0
@@ -0,0 +1,283 @@
1
+ import { expect } from "chai";
2
+ import { DEFAULT_ROOT_ACL } from "../../../acl/defaults";
3
+ import { serializeAcl } from "../../../acl/entries";
4
+ import {
5
+ type AclActor,
6
+ resolveFolderAccess,
7
+ resolveRootRights,
8
+ } from "../../../acl/resolver";
9
+ import {
10
+ MEDIA_ACCESS_PERMISSION,
11
+ MEDIA_FOLDERS_MANAGE_PERMISSION,
12
+ MEDIA_UPLOAD_PERMISSION,
13
+ } from "../../../constants";
14
+ import type { MediaFolder } from "../../../db/tables";
15
+ import type { AclEntry } from "../../../types";
16
+
17
+ interface FolderSeed {
18
+ id: string;
19
+ parentId?: string;
20
+ acl?: AclEntry[];
21
+ rawAcl?: string;
22
+ }
23
+
24
+ function buildFolder(seed: FolderSeed): MediaFolder {
25
+ return {
26
+ _id: seed.id,
27
+ name: seed.id,
28
+ parentId: seed.parentId,
29
+ path: [],
30
+ json_acl: seed.rawAcl ?? serializeAcl(seed.acl),
31
+ visibility: "private",
32
+ createdAt: new Date(),
33
+ updatedAt: new Date(),
34
+ } as MediaFolder;
35
+ }
36
+
37
+ function buildActor(permissions: string[], roleIds: string[] = []): AclActor {
38
+ return { permissions: new Set(permissions), roleIds };
39
+ }
40
+
41
+ const EDIT_ARTICLES_PERMISSION = "articles.table.edit";
42
+
43
+ const editorsRoleAcl: AclEntry[] = [
44
+ { subject: { kind: "role", id: "editors" }, rights: ["write"] },
45
+ ];
46
+
47
+ const articlesPermissionAcl: AclEntry[] = [
48
+ {
49
+ subject: { kind: "permission", id: EDIT_ARTICLES_PERMISSION },
50
+ rights: ["write"],
51
+ },
52
+ ];
53
+
54
+ describe("[unit] acl/resolver — resolveFolderAccess", () => {
55
+ it("grants everything everywhere to the owner wildcard", () => {
56
+ const folders = [
57
+ buildFolder({ id: "a" }),
58
+ buildFolder({ id: "b", parentId: "a", acl: [] }),
59
+ ];
60
+ const access = resolveFolderAccess(folders, buildActor(["*"]), []);
61
+ expect([...access.manageable].sort()).to.deep.equal(["a", "b"]);
62
+ expect([...access.readable].sort()).to.deep.equal(["a", "b"]);
63
+ expect(access.shells.size).to.equal(0);
64
+ });
65
+
66
+ it("applies the root ACL to folders without their own ACL", () => {
67
+ const folders = [buildFolder({ id: "root" })];
68
+ const reader = resolveFolderAccess(
69
+ folders,
70
+ buildActor([MEDIA_ACCESS_PERMISSION]),
71
+ DEFAULT_ROOT_ACL,
72
+ );
73
+ expect(reader.readable.has("root")).to.equal(true);
74
+ expect(reader.writable.has("root")).to.equal(false);
75
+ expect(reader.manageable.has("root")).to.equal(false);
76
+ });
77
+
78
+ it("expands right implications (write ⇒ read, manage ⇒ write+read)", () => {
79
+ const folders = [buildFolder({ id: "root" })];
80
+ const uploader = resolveFolderAccess(
81
+ folders,
82
+ buildActor([MEDIA_UPLOAD_PERMISSION]),
83
+ DEFAULT_ROOT_ACL,
84
+ );
85
+ expect(uploader.readable.has("root")).to.equal(true);
86
+ expect(uploader.writable.has("root")).to.equal(true);
87
+ expect(uploader.manageable.has("root")).to.equal(false);
88
+
89
+ const manager = resolveFolderAccess(
90
+ folders,
91
+ buildActor([MEDIA_FOLDERS_MANAGE_PERMISSION]),
92
+ DEFAULT_ROOT_ACL,
93
+ );
94
+ expect(manager.readable.has("root")).to.equal(true);
95
+ expect(manager.writable.has("root")).to.equal(true);
96
+ expect(manager.manageable.has("root")).to.equal(true);
97
+ });
98
+
99
+ it("propagates the parent's effective rights when a child has no ACL", () => {
100
+ const folders = [
101
+ buildFolder({ id: "parent", acl: editorsRoleAcl }),
102
+ buildFolder({ id: "child", parentId: "parent" }),
103
+ buildFolder({ id: "grandchild", parentId: "child" }),
104
+ ];
105
+ const editor = resolveFolderAccess(
106
+ folders,
107
+ buildActor([], ["editors"]),
108
+ [],
109
+ );
110
+ expect(editor.writable.has("child")).to.equal(true);
111
+ expect(editor.writable.has("grandchild")).to.equal(true);
112
+ });
113
+
114
+ it("lets a folder ACL fully override the inherited one", () => {
115
+ const restrictedAcl: AclEntry[] = [
116
+ { subject: { kind: "role", id: "admins" }, rights: ["manage"] },
117
+ ];
118
+ const folders = [
119
+ buildFolder({ id: "parent", acl: editorsRoleAcl }),
120
+ buildFolder({ id: "child", parentId: "parent", acl: restrictedAcl }),
121
+ ];
122
+ const editor = resolveFolderAccess(
123
+ folders,
124
+ buildActor([], ["editors"]),
125
+ [],
126
+ );
127
+ expect(editor.writable.has("parent")).to.equal(true);
128
+ expect(editor.readable.has("child")).to.equal(false);
129
+
130
+ const admin = resolveFolderAccess(folders, buildActor([], ["admins"]), []);
131
+ expect(admin.readable.has("parent")).to.equal(false);
132
+ expect(admin.manageable.has("child")).to.equal(true);
133
+ });
134
+
135
+ it("matches permission subjects against the actor's effective permission set", () => {
136
+ const folders = [
137
+ buildFolder({ id: "articles-assets", acl: articlesPermissionAcl }),
138
+ ];
139
+ const magasinier = resolveFolderAccess(
140
+ folders,
141
+ buildActor([EDIT_ARTICLES_PERMISSION]),
142
+ [],
143
+ );
144
+ expect(magasinier.writable.has("articles-assets")).to.equal(true);
145
+
146
+ const outsider = resolveFolderAccess(
147
+ folders,
148
+ buildActor([MEDIA_ACCESS_PERMISSION]),
149
+ [],
150
+ );
151
+ expect(outsider.readable.has("articles-assets")).to.equal(false);
152
+ });
153
+
154
+ it("returns non-readable ancestors of readable folders as shells", () => {
155
+ const folders = [
156
+ buildFolder({ id: "top", acl: [] }),
157
+ buildFolder({ id: "middle", parentId: "top" }),
158
+ buildFolder({ id: "leaf", parentId: "middle", acl: editorsRoleAcl }),
159
+ ];
160
+ const editor = resolveFolderAccess(
161
+ folders,
162
+ buildActor([], ["editors"]),
163
+ [],
164
+ );
165
+ expect(editor.readable.has("leaf")).to.equal(true);
166
+ expect(editor.readable.has("top")).to.equal(false);
167
+ expect(editor.readable.has("middle")).to.equal(false);
168
+ expect([...editor.shells].sort()).to.deep.equal(["middle", "top"]);
169
+ });
170
+
171
+ it("keeps unreadable folders out of every set", () => {
172
+ const folders = [
173
+ buildFolder({ id: "hidden", acl: [] }),
174
+ buildFolder({ id: "hidden-child", parentId: "hidden" }),
175
+ ];
176
+ const actor = resolveFolderAccess(
177
+ folders,
178
+ buildActor([MEDIA_ACCESS_PERMISSION]),
179
+ [],
180
+ );
181
+ expect(actor.readable.size).to.equal(0);
182
+ expect(actor.writable.size).to.equal(0);
183
+ expect(actor.manageable.size).to.equal(0);
184
+ expect(actor.shells.size).to.equal(0);
185
+ });
186
+
187
+ it("treats folders with a missing parent as roots", () => {
188
+ const folders = [buildFolder({ id: "orphan", parentId: "gone" })];
189
+ const reader = resolveFolderAccess(
190
+ folders,
191
+ buildActor([MEDIA_ACCESS_PERMISSION]),
192
+ DEFAULT_ROOT_ACL,
193
+ );
194
+ expect(reader.readable.has("orphan")).to.equal(true);
195
+ });
196
+
197
+ it("grants every root right to the owner wildcard", () => {
198
+ const rights = resolveRootRights(buildActor(["*"]), []);
199
+ expect(rights.has("read")).to.equal(true);
200
+ expect(rights.has("write")).to.equal(true);
201
+ expect(rights.has("manage")).to.equal(true);
202
+ });
203
+
204
+ it("matches any permission subject for the owner wildcard", () => {
205
+ const folders = [
206
+ buildFolder({ id: "articles-assets", acl: articlesPermissionAcl }),
207
+ ];
208
+ const owner = resolveFolderAccess(folders, buildActor(["*"]), []);
209
+ expect(owner.manageable.has("articles-assets")).to.equal(true);
210
+ });
211
+
212
+ it("resolves root rights from the root ACL for regular actors", () => {
213
+ const rights = resolveRootRights(
214
+ buildActor([MEDIA_UPLOAD_PERMISSION]),
215
+ DEFAULT_ROOT_ACL,
216
+ );
217
+ expect(rights.has("write")).to.equal(true);
218
+ expect(rights.has("manage")).to.equal(false);
219
+ });
220
+
221
+ it("falls back to inheritance when a stored ACL is malformed", () => {
222
+ const folders = [
223
+ buildFolder({ id: "root", acl: editorsRoleAcl }),
224
+ buildFolder({ id: "broken", parentId: "root", rawAcl: "{not json" }),
225
+ ];
226
+ const editor = resolveFolderAccess(
227
+ folders,
228
+ buildActor([], ["editors"]),
229
+ [],
230
+ );
231
+ expect(editor.writable.has("broken")).to.equal(true);
232
+ });
233
+
234
+ it("locks down a child with an explicit empty ACL under a permissive parent", () => {
235
+ const folders = [
236
+ buildFolder({ id: "open", acl: editorsRoleAcl }),
237
+ buildFolder({ id: "locked", parentId: "open", acl: [] }),
238
+ ];
239
+ const editor = resolveFolderAccess(
240
+ folders,
241
+ buildActor([], ["editors"]),
242
+ [],
243
+ );
244
+ expect(editor.writable.has("open")).to.equal(true);
245
+ expect(editor.readable.has("locked")).to.equal(false);
246
+ expect(editor.shells.has("locked")).to.equal(false);
247
+ });
248
+
249
+ it("ignores unknown rights and unknown subject kinds", () => {
250
+ // The fixture is deliberately not an AclEntry -- an unknown right
251
+ // and an unknown subject kind are what this test feeds the resolver.
252
+ // oxlint-disable-next-line anti-slop/no-chained-type-assertions
253
+ const exoticAcl = [
254
+ { subject: { kind: "role", id: "editors" }, rights: ["teleport"] },
255
+ { subject: { kind: "group", id: "editors" }, rights: ["manage"] },
256
+ ] as unknown as AclEntry[];
257
+ const folders = [buildFolder({ id: "root", acl: exoticAcl })];
258
+ const editor = resolveFolderAccess(
259
+ folders,
260
+ buildActor([], ["editors"]),
261
+ [],
262
+ );
263
+ expect(editor.readable.size).to.equal(0);
264
+ expect(editor.writable.size).to.equal(0);
265
+ expect(editor.manageable.size).to.equal(0);
266
+ });
267
+
268
+ it("stays finite and grants nothing on a parentId cycle", () => {
269
+ const folders = [
270
+ buildFolder({ id: "a", parentId: "b" }),
271
+ buildFolder({ id: "b", parentId: "a" }),
272
+ buildFolder({ id: "sane" }),
273
+ ];
274
+ const reader = resolveFolderAccess(
275
+ folders,
276
+ buildActor([MEDIA_ACCESS_PERMISSION]),
277
+ DEFAULT_ROOT_ACL,
278
+ );
279
+ expect(reader.readable.has("sane")).to.equal(true);
280
+ expect(reader.readable.has("a")).to.equal(false);
281
+ expect(reader.readable.has("b")).to.equal(false);
282
+ });
283
+ });
@@ -0,0 +1,141 @@
1
+ import {
2
+ GetPermissionId,
3
+ PageController,
4
+ pagesCategory,
5
+ RegisterPage,
6
+ } from "@antelopejs/interface-dms/page";
7
+ import { CustomComponent } from "@antelopejs/interface-dms/base/custom";
8
+ import { expect } from "chai";
9
+ import { buildBindingAcl } from "../../../asset-type/bindings";
10
+ import {
11
+ MEDIA_FOLDERS_MANAGE_PERMISSION,
12
+ MEDIA_PERMISSIONS_MANAGE_PERMISSION,
13
+ } from "../../../constants";
14
+ import type { AclEntry } from "../../../types";
15
+
16
+ @RegisterPage()
17
+ class BindingProbePage extends PageController("binding-probe", {
18
+ displayName: "Binding probe",
19
+ description: "Probe page for binding permission inheritance",
20
+ icon: "i-ph-images",
21
+ category: pagesCategory,
22
+ }) {
23
+ static content = CustomComponent("dms-media-binding-probe");
24
+ }
25
+
26
+ class DetachedProbePage extends PageController("binding-probe-detached", {
27
+ displayName: "Detached probe",
28
+ category: pagesCategory,
29
+ }) {
30
+ static content = CustomComponent("dms-media-binding-probe");
31
+ }
32
+
33
+ describe("[unit] asset-type/bindings — buildBindingAcl", () => {
34
+ it("derives read and write entries from the permission mapping", () => {
35
+ const entries = buildBindingAcl({
36
+ id: "articles.cover",
37
+ permissionMapping: {
38
+ read: ["articles.page"],
39
+ write: ["articles.page.table.edit"],
40
+ },
41
+ });
42
+ expect(entries).to.deep.include({
43
+ subject: { kind: "permission", id: "articles.page" },
44
+ rights: ["read"],
45
+ });
46
+ expect(entries).to.deep.include({
47
+ subject: { kind: "permission", id: "articles.page.table.edit" },
48
+ rights: ["write"],
49
+ });
50
+ });
51
+
52
+ it("always keeps media managers in control of linked folders", () => {
53
+ const entries = buildBindingAcl({ id: "bare" });
54
+ const managed = entries.filter((entry) => entry.rights.includes("manage"));
55
+ expect(managed.map((entry) => entry.subject.id).sort()).to.deep.equal(
56
+ [
57
+ MEDIA_FOLDERS_MANAGE_PERMISSION,
58
+ MEDIA_PERMISSIONS_MANAGE_PERMISSION,
59
+ ].sort(),
60
+ );
61
+ });
62
+
63
+ it("derives read and write entries from the owning page permission", () => {
64
+ const pagePermission = GetPermissionId(BindingProbePage);
65
+ expect(pagePermission, "probe page permission").to.be.a("string");
66
+ const entries = buildBindingAcl({
67
+ id: "probe.page-derived",
68
+ permissionsFromPage: BindingProbePage,
69
+ });
70
+ expect(entries).to.deep.include({
71
+ subject: { kind: "permission", id: pagePermission },
72
+ rights: ["read"],
73
+ });
74
+ expect(entries).to.deep.include({
75
+ subject: { kind: "permission", id: pagePermission },
76
+ rights: ["write"],
77
+ });
78
+ });
79
+
80
+ it("lets explicit mapping entries override page-derived defaults per right", () => {
81
+ const pagePermission = GetPermissionId(BindingProbePage);
82
+ const entries = buildBindingAcl({
83
+ id: "probe.override",
84
+ permissionsFromPage: BindingProbePage,
85
+ permissionMapping: { write: ["probe.custom.write"] },
86
+ });
87
+ expect(entries).to.deep.include({
88
+ subject: { kind: "permission", id: pagePermission },
89
+ rights: ["read"],
90
+ });
91
+ expect(entries).to.deep.include({
92
+ subject: { kind: "permission", id: "probe.custom.write" },
93
+ rights: ["write"],
94
+ });
95
+ expect(entries).to.not.deep.include({
96
+ subject: { kind: "permission", id: pagePermission },
97
+ rights: ["write"],
98
+ });
99
+ });
100
+
101
+ it("treats an explicit empty mapping array as a per-right opt-out", () => {
102
+ const pagePermission = GetPermissionId(BindingProbePage);
103
+ const entries = buildBindingAcl({
104
+ id: "probe.opt-out",
105
+ permissionsFromPage: BindingProbePage,
106
+ permissionMapping: { read: [] },
107
+ });
108
+ const readEntries = entries.filter((entry) =>
109
+ entry.rights.includes("read"),
110
+ );
111
+ expect(readEntries).to.deep.equal([]);
112
+ expect(entries).to.deep.include({
113
+ subject: { kind: "permission", id: pagePermission },
114
+ rights: ["write"],
115
+ });
116
+ });
117
+
118
+ it("derives nothing from a page that is not registered", () => {
119
+ const entries = buildBindingAcl({
120
+ id: "probe.detached",
121
+ permissionsFromPage: DetachedProbePage,
122
+ });
123
+ const derived = entries.filter(
124
+ (entry) =>
125
+ entry.rights.includes("read") || entry.rights.includes("write"),
126
+ );
127
+ expect(derived).to.deep.equal([]);
128
+ });
129
+
130
+ it("lets an explicit ACL fully replace the derived entries", () => {
131
+ const explicit: AclEntry[] = [
132
+ { subject: { kind: "role", id: "librarians" }, rights: ["manage"] },
133
+ ];
134
+ const entries = buildBindingAcl({
135
+ id: "custom",
136
+ acl: explicit,
137
+ permissionMapping: { read: ["ignored.permission"] },
138
+ });
139
+ expect(entries).to.deep.equal(explicit);
140
+ });
141
+ });
@@ -0,0 +1,44 @@
1
+ import { expect } from "chai";
2
+ import { DEFAULT_ROOT_ACL } from "../../acl/defaults";
3
+ import { configureMediaModule, getMediaConfig } from "../../config";
4
+ import { DEFAULT_PRESETS } from "../../presets";
5
+ import type { AclEntry } from "../../types";
6
+
7
+ const CUSTOM_ROOT_ACL: AclEntry[] = [
8
+ { subject: { kind: "role", id: "curators" }, rights: ["read"] },
9
+ ];
10
+
11
+ describe("[unit] config — configureMediaModule", () => {
12
+ after(() => {
13
+ configureMediaModule({});
14
+ });
15
+
16
+ it("falls back to the default root ACL and presets", () => {
17
+ configureMediaModule({});
18
+ const config = getMediaConfig();
19
+ expect(config.rootAcl).to.equal(DEFAULT_ROOT_ACL);
20
+ expect([...config.presets.keys()]).to.deep.equal(
21
+ DEFAULT_PRESETS.map((preset) => preset.id),
22
+ );
23
+ expect(config.storage).to.equal(undefined);
24
+ });
25
+
26
+ it("replaces the default root ACL with the configured one", () => {
27
+ configureMediaModule({ rootAcl: CUSTOM_ROOT_ACL });
28
+ expect(getMediaConfig().rootAcl).to.equal(CUSTOM_ROOT_ACL);
29
+ });
30
+
31
+ it("indexes configured presets by id and drops the defaults", () => {
32
+ configureMediaModule({
33
+ presets: [{ id: "hero", width: 1200, fit: "cover", format: "webp" }],
34
+ });
35
+ const presets = getMediaConfig().presets;
36
+ expect(presets.get("hero")?.width).to.equal(1200);
37
+ expect(presets.has("thumb")).to.equal(false);
38
+ });
39
+
40
+ it("keeps the configured storage name", () => {
41
+ configureMediaModule({ storage: "r2-main" });
42
+ expect(getMediaConfig().storage).to.equal("r2-main");
43
+ });
44
+ });
@@ -0,0 +1,54 @@
1
+ import { expect } from "chai";
2
+ import { partitionDerivatives } from "../../derivatives";
3
+ import { presetCacheKey } from "../../presets";
4
+
5
+ const THUMB_PRESET = {
6
+ id: "thumb",
7
+ width: 300,
8
+ height: 300,
9
+ fit: "cover" as const,
10
+ format: "webp" as const,
11
+ quality: 80,
12
+ };
13
+
14
+ describe("[unit] derivatives — partitionDerivatives", () => {
15
+ it("keeps derivatives whose cache key matches a configured preset", () => {
16
+ const cacheKey = presetCacheKey(THUMB_PRESET);
17
+ const { fresh, stale } = partitionDerivatives(
18
+ { [cacheKey]: "media-derivatives/a/thumb.webp" },
19
+ [THUMB_PRESET],
20
+ );
21
+ expect(fresh).to.deep.equal({
22
+ [cacheKey]: "media-derivatives/a/thumb.webp",
23
+ });
24
+ expect(stale).to.deep.equal({});
25
+ });
26
+
27
+ it("marks derivatives stale when the preset config changed", () => {
28
+ const oldKey = presetCacheKey({ ...THUMB_PRESET, quality: 60 });
29
+ const { fresh, stale } = partitionDerivatives(
30
+ { [oldKey]: "media-derivatives/a/old.webp" },
31
+ [THUMB_PRESET],
32
+ );
33
+ expect(fresh).to.deep.equal({});
34
+ expect(stale).to.deep.equal({ [oldKey]: "media-derivatives/a/old.webp" });
35
+ });
36
+
37
+ it("marks derivatives stale when their preset was removed", () => {
38
+ const removedKey = presetCacheKey({ ...THUMB_PRESET, id: "gone" });
39
+ const { stale } = partitionDerivatives(
40
+ { [removedKey]: "media-derivatives/a/gone.webp" },
41
+ [THUMB_PRESET],
42
+ );
43
+ expect(Object.keys(stale)).to.have.length(1);
44
+ });
45
+
46
+ it("changes the cache key whenever any preset parameter changes", () => {
47
+ const base = presetCacheKey(THUMB_PRESET);
48
+ expect(presetCacheKey({ ...THUMB_PRESET, width: 301 })).to.not.equal(base);
49
+ expect(presetCacheKey({ ...THUMB_PRESET, format: "jpeg" })).to.not.equal(
50
+ base,
51
+ );
52
+ expect(presetCacheKey({ ...THUMB_PRESET })).to.equal(base);
53
+ });
54
+ });
@@ -0,0 +1,65 @@
1
+ import { expect } from "chai";
2
+ import type { MediaAsset, MediaFolder } from "../../../db";
3
+ import {
4
+ buildDeliveryPath,
5
+ resolveEffectiveVisibility,
6
+ } from "../../../routes/media/dto";
7
+ import type { AssetVisibility, FolderVisibility } from "../../../types";
8
+
9
+ function assetWithVisibility(visibility: AssetVisibility): MediaAsset {
10
+ return { visibility } as MediaAsset;
11
+ }
12
+
13
+ function folderWithVisibility(visibility: FolderVisibility): MediaFolder {
14
+ return { visibility } as MediaFolder;
15
+ }
16
+
17
+ describe("[unit] routes/dto — resolveEffectiveVisibility", () => {
18
+ it("lets an explicit asset visibility override the folder", () => {
19
+ expect(
20
+ resolveEffectiveVisibility(
21
+ assetWithVisibility("public"),
22
+ folderWithVisibility("private"),
23
+ ),
24
+ ).to.equal("public");
25
+ expect(
26
+ resolveEffectiveVisibility(
27
+ assetWithVisibility("private"),
28
+ folderWithVisibility("public"),
29
+ ),
30
+ ).to.equal("private");
31
+ });
32
+
33
+ it("inherits the folder visibility by default", () => {
34
+ expect(
35
+ resolveEffectiveVisibility(
36
+ assetWithVisibility("inherit"),
37
+ folderWithVisibility("public"),
38
+ ),
39
+ ).to.equal("public");
40
+ expect(
41
+ resolveEffectiveVisibility(
42
+ assetWithVisibility("inherit"),
43
+ folderWithVisibility("private"),
44
+ ),
45
+ ).to.equal("private");
46
+ });
47
+
48
+ it("falls back to private when the folder is missing", () => {
49
+ expect(
50
+ resolveEffectiveVisibility(assetWithVisibility("inherit"), undefined),
51
+ ).to.equal("private");
52
+ });
53
+ });
54
+
55
+ describe("[unit] routes/dto — buildDeliveryPath", () => {
56
+ it("builds the stable delivery URL from id and name", () => {
57
+ const asset = { _id: "a1", name: "photo.png" } as MediaAsset;
58
+ expect(buildDeliveryPath(asset)).to.equal("/media/a1/photo.png");
59
+ });
60
+
61
+ it("escapes unsafe characters in the filename", () => {
62
+ const asset = { _id: "a1", name: "my file#1.png" } as MediaAsset;
63
+ expect(buildDeliveryPath(asset)).to.equal("/media/a1/my%20file%231.png");
64
+ });
65
+ });
@@ -0,0 +1,51 @@
1
+ import { expect } from "chai";
2
+ import { cropToPixels } from "../../transform";
3
+
4
+ const DIMENSIONS = { width: 100, height: 100 };
5
+
6
+ describe("[unit] transform — cropToPixels", () => {
7
+ it("keeps a full-frame crop at the image bounds", () => {
8
+ const region = cropToPixels(
9
+ { x: 0, y: 0, width: 1, height: 1 },
10
+ DIMENSIONS,
11
+ );
12
+ expect(region).to.deep.equal({
13
+ left: 0,
14
+ top: 0,
15
+ width: 100,
16
+ height: 100,
17
+ });
18
+ });
19
+
20
+ it("never yields a zero-size region for a tiny crop at the right edge", () => {
21
+ const region = cropToPixels(
22
+ { x: 0.999, y: 0, width: 0.001, height: 1 },
23
+ DIMENSIONS,
24
+ );
25
+ expect(region.width).to.be.greaterThan(0);
26
+ expect(region.height).to.be.greaterThan(0);
27
+ expect(region.left + region.width).to.be.at.most(DIMENSIONS.width);
28
+ });
29
+
30
+ it("never yields a zero-size region for a tiny crop at the bottom edge", () => {
31
+ const region = cropToPixels(
32
+ { x: 0, y: 0.999, width: 1, height: 0.001 },
33
+ DIMENSIONS,
34
+ );
35
+ expect(region.height).to.be.greaterThan(0);
36
+ expect(region.top + region.height).to.be.at.most(DIMENSIONS.height);
37
+ });
38
+
39
+ it("keeps the region inside the frame for a mid crop", () => {
40
+ const region = cropToPixels(
41
+ { x: 0.25, y: 0.25, width: 0.5, height: 0.5 },
42
+ DIMENSIONS,
43
+ );
44
+ expect(region).to.deep.equal({
45
+ left: 25,
46
+ top: 25,
47
+ width: 50,
48
+ height: 50,
49
+ });
50
+ });
51
+ });