@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.
- package/LICENSE +190 -0
- package/README.md +114 -0
- package/dist/acl/defaults.d.ts +2 -0
- package/dist/acl/defaults.js +19 -0
- package/dist/acl/defaults.js.map +1 -0
- package/dist/acl/entries.d.ts +4 -0
- package/dist/acl/entries.js +21 -0
- package/dist/acl/entries.js.map +1 -0
- package/dist/acl/grantable.d.ts +1 -0
- package/dist/acl/grantable.js +11 -0
- package/dist/acl/grantable.js.map +1 -0
- package/dist/acl/index.d.ts +4 -0
- package/dist/acl/index.js +21 -0
- package/dist/acl/index.js.map +1 -0
- package/dist/acl/resolver.d.ts +15 -0
- package/dist/acl/resolver.js +115 -0
- package/dist/acl/resolver.js.map +1 -0
- package/dist/asset-lifecycle.d.ts +6 -0
- package/dist/asset-lifecycle.js +78 -0
- package/dist/asset-lifecycle.js.map +1 -0
- package/dist/asset-type/asset-type.d.ts +24 -0
- package/dist/asset-type/asset-type.js +54 -0
- package/dist/asset-type/asset-type.js.map +1 -0
- package/dist/asset-type/bindings.d.ts +19 -0
- package/dist/asset-type/bindings.js +116 -0
- package/dist/asset-type/bindings.js.map +1 -0
- package/dist/asset-type/index.d.ts +2 -0
- package/dist/asset-type/index.js +19 -0
- package/dist/asset-type/index.js.map +1 -0
- package/dist/config.d.ts +15 -0
- package/dist/config.js +24 -0
- package/dist/config.js.map +1 -0
- package/dist/constants.d.ts +6 -0
- package/dist/constants.js +10 -0
- package/dist/constants.js.map +1 -0
- package/dist/crons/index.d.ts +3 -0
- package/dist/crons/index.js +23 -0
- package/dist/crons/index.js.map +1 -0
- package/dist/crons/sweep-derivatives.d.ts +6 -0
- package/dist/crons/sweep-derivatives.js +63 -0
- package/dist/crons/sweep-derivatives.js.map +1 -0
- package/dist/db/index.d.ts +2 -0
- package/dist/db/index.js +19 -0
- package/dist/db/index.js.map +1 -0
- package/dist/db/models/index.d.ts +2 -0
- package/dist/db/models/index.js +19 -0
- package/dist/db/models/index.js.map +1 -0
- package/dist/db/models/mediaAssets.model.d.ts +26 -0
- package/dist/db/models/mediaAssets.model.js +58 -0
- package/dist/db/models/mediaAssets.model.js.map +1 -0
- package/dist/db/models/mediaFolders.model.d.ts +25 -0
- package/dist/db/models/mediaFolders.model.js +27 -0
- package/dist/db/models/mediaFolders.model.js.map +1 -0
- package/dist/db/tables/index.d.ts +2 -0
- package/dist/db/tables/index.js +19 -0
- package/dist/db/tables/index.js.map +1 -0
- package/dist/db/tables/mediaAssets.table.d.ts +24 -0
- package/dist/db/tables/mediaAssets.table.js +105 -0
- package/dist/db/tables/mediaAssets.table.js.map +1 -0
- package/dist/db/tables/mediaFolders.table.d.ts +14 -0
- package/dist/db/tables/mediaFolders.table.js +65 -0
- package/dist/db/tables/mediaFolders.table.js.map +1 -0
- package/dist/derivatives.d.ts +12 -0
- package/dist/derivatives.js +166 -0
- package/dist/derivatives.js.map +1 -0
- package/dist/index.d.ts +18 -0
- package/dist/index.js +66 -0
- package/dist/index.js.map +1 -0
- package/dist/pages/index.d.ts +1 -0
- package/dist/pages/index.js +18 -0
- package/dist/pages/index.js.map +1 -0
- package/dist/pages/media.d.ts +10 -0
- package/dist/pages/media.js +35 -0
- package/dist/pages/media.js.map +1 -0
- package/dist/permissions.d.ts +1 -0
- package/dist/permissions.js +37 -0
- package/dist/permissions.js.map +1 -0
- package/dist/presets.d.ts +15 -0
- package/dist/presets.js +48 -0
- package/dist/presets.js.map +1 -0
- package/dist/routes/index.d.ts +1 -0
- package/dist/routes/index.js +18 -0
- package/dist/routes/index.js.map +1 -0
- package/dist/routes/media/assets.d.ts +48 -0
- package/dist/routes/media/assets.js +263 -0
- package/dist/routes/media/assets.js.map +1 -0
- package/dist/routes/media/constants.d.ts +5 -0
- package/dist/routes/media/constants.js +12 -0
- package/dist/routes/media/constants.js.map +1 -0
- package/dist/routes/media/context.d.ts +49 -0
- package/dist/routes/media/context.js +95 -0
- package/dist/routes/media/context.js.map +1 -0
- package/dist/routes/media/delivery.d.ts +14 -0
- package/dist/routes/media/delivery.js +123 -0
- package/dist/routes/media/delivery.js.map +1 -0
- package/dist/routes/media/dto.d.ts +43 -0
- package/dist/routes/media/dto.js +66 -0
- package/dist/routes/media/dto.js.map +1 -0
- package/dist/routes/media/folders.d.ts +46 -0
- package/dist/routes/media/folders.js +259 -0
- package/dist/routes/media/folders.js.map +1 -0
- package/dist/routes/media/index.d.ts +9 -0
- package/dist/routes/media/index.js +26 -0
- package/dist/routes/media/index.js.map +1 -0
- package/dist/routes/media/storage-keys.d.ts +3 -0
- package/dist/routes/media/storage-keys.js +19 -0
- package/dist/routes/media/storage-keys.js.map +1 -0
- package/dist/routes/media/transform.d.ts +21 -0
- package/dist/routes/media/transform.js +99 -0
- package/dist/routes/media/transform.js.map +1 -0
- package/dist/routes/media/upload.d.ts +24 -0
- package/dist/routes/media/upload.js +145 -0
- package/dist/routes/media/upload.js.map +1 -0
- package/dist/test/antelope.test.d.ts +2 -0
- package/dist/test/antelope.test.js +202 -0
- package/dist/test/antelope.test.js.map +1 -0
- package/dist/test/helpers/assets.d.ts +21 -0
- package/dist/test/helpers/assets.js +61 -0
- package/dist/test/helpers/assets.js.map +1 -0
- package/dist/test/helpers/http.d.ts +4 -0
- package/dist/test/helpers/http.js +28 -0
- package/dist/test/helpers/http.js.map +1 -0
- package/dist/test/helpers/members.d.ts +10 -0
- package/dist/test/helpers/members.js +57 -0
- package/dist/test/helpers/members.js.map +1 -0
- package/dist/test/helpers/owner.d.ts +5 -0
- package/dist/test/helpers/owner.js +30 -0
- package/dist/test/helpers/owner.js.map +1 -0
- package/dist/test/integration/derivative-sweep-query.test.d.ts +1 -0
- package/dist/test/integration/derivative-sweep-query.test.js +61 -0
- package/dist/test/integration/derivative-sweep-query.test.js.map +1 -0
- package/dist/test/integration/folder-query.test.d.ts +1 -0
- package/dist/test/integration/folder-query.test.js +88 -0
- package/dist/test/integration/folder-query.test.js.map +1 -0
- package/dist/test/integration/media-api.test.d.ts +1 -0
- package/dist/test/integration/media-api.test.js +178 -0
- package/dist/test/integration/media-api.test.js.map +1 -0
- package/dist/test/integration/media-bindings.test.d.ts +1 -0
- package/dist/test/integration/media-bindings.test.js +141 -0
- package/dist/test/integration/media-bindings.test.js.map +1 -0
- package/dist/test/integration/media-cleanup.test.d.ts +1 -0
- package/dist/test/integration/media-cleanup.test.js +282 -0
- package/dist/test/integration/media-cleanup.test.js.map +1 -0
- package/dist/test/integration/media-delivery.test.d.ts +1 -0
- package/dist/test/integration/media-delivery.test.js +108 -0
- package/dist/test/integration/media-delivery.test.js.map +1 -0
- package/dist/test/integration/media-guards.test.d.ts +1 -0
- package/dist/test/integration/media-guards.test.js +128 -0
- package/dist/test/integration/media-guards.test.js.map +1 -0
- package/dist/test/integration/media-list-query.test.d.ts +1 -0
- package/dist/test/integration/media-list-query.test.js +86 -0
- package/dist/test/integration/media-list-query.test.js.map +1 -0
- package/dist/test/integration/media-permissions.test.d.ts +1 -0
- package/dist/test/integration/media-permissions.test.js +549 -0
- package/dist/test/integration/media-permissions.test.js.map +1 -0
- package/dist/test/integration/media-search-query.test.d.ts +1 -0
- package/dist/test/integration/media-search-query.test.js +100 -0
- package/dist/test/integration/media-search-query.test.js.map +1 -0
- package/dist/test/integration/media-transform.test.d.ts +1 -0
- package/dist/test/integration/media-transform.test.js +125 -0
- package/dist/test/integration/media-transform.test.js.map +1 -0
- package/dist/test/integration/setup.test.d.ts +1 -0
- package/dist/test/integration/setup.test.js +32 -0
- package/dist/test/integration/setup.test.js.map +1 -0
- package/dist/test/unit/acl/entries.test.d.ts +1 -0
- package/dist/test/unit/acl/entries.test.js +46 -0
- package/dist/test/unit/acl/entries.test.js.map +1 -0
- package/dist/test/unit/acl/grantable.test.d.ts +1 -0
- package/dist/test/unit/acl/grantable.test.js +41 -0
- package/dist/test/unit/acl/grantable.test.js.map +1 -0
- package/dist/test/unit/acl/resolver.test.d.ts +1 -0
- package/dist/test/unit/acl/resolver.test.js +183 -0
- package/dist/test/unit/acl/resolver.test.js.map +1 -0
- package/dist/test/unit/asset-type/bindings.test.d.ts +1 -0
- package/dist/test/unit/asset-type/bindings.test.js +127 -0
- package/dist/test/unit/asset-type/bindings.test.js.map +1 -0
- package/dist/test/unit/config.test.d.ts +1 -0
- package/dist/test/unit/config.test.js +38 -0
- package/dist/test/unit/config.test.js.map +1 -0
- package/dist/test/unit/derivatives.test.d.ts +1 -0
- package/dist/test/unit/derivatives.test.js +41 -0
- package/dist/test/unit/derivatives.test.js.map +1 -0
- package/dist/test/unit/routes/dto.test.d.ts +1 -0
- package/dist/test/unit/routes/dto.test.js +34 -0
- package/dist/test/unit/routes/dto.test.js.map +1 -0
- package/dist/test/unit/transform.test.d.ts +1 -0
- package/dist/test/unit/transform.test.js +37 -0
- package/dist/test/unit/transform.test.js.map +1 -0
- package/dist/transform.d.ts +22 -0
- package/dist/transform.js +117 -0
- package/dist/transform.js.map +1 -0
- package/dist/types.d.ts +12 -0
- package/dist/types.js +3 -0
- package/dist/types.js.map +1 -0
- package/dist/validation/media.schema.d.ts +221 -0
- package/dist/validation/media.schema.js +94 -0
- package/dist/validation/media.schema.js.map +1 -0
- package/frontend-vue/.editorconfig +12 -0
- package/frontend-vue/.prettierrc +11 -0
- package/frontend-vue/app/components/AssetPicker.vue +272 -0
- package/frontend-vue/app/components/Library.vue +21 -0
- package/frontend-vue/app/components/PickerModal.vue +47 -0
- package/frontend-vue/app/components/StorageOverview.vue +105 -0
- package/frontend-vue/app/components/finder/Modal.vue +41 -0
- package/frontend-vue/app/components/finder/Root.vue +72 -0
- package/frontend-vue/app/components/finder/components/DeleteFolderConfirm.vue +55 -0
- package/frontend-vue/app/components/finder/components/EditImage.vue +157 -0
- package/frontend-vue/app/components/finder/components/Empty.vue +13 -0
- package/frontend-vue/app/components/finder/components/FilterMenu.vue +115 -0
- package/frontend-vue/app/components/finder/components/Preview.vue +35 -0
- package/frontend-vue/app/components/finder/components/search-file.vue +24 -0
- package/frontend-vue/app/components/finder/core/panel.vue +132 -0
- package/frontend-vue/app/components/finder/core/toolbar.vue +55 -0
- package/frontend-vue/app/components/finder/index.vue +87 -0
- package/frontend-vue/app/components/finder/layout/Footer.vue +97 -0
- package/frontend-vue/app/components/finder/layout/Header.vue +16 -0
- package/frontend-vue/app/components/finder/layout/navigation/Breadcrumbs.vue +114 -0
- package/frontend-vue/app/components/finder/layout/navigation/index.vue +40 -0
- package/frontend-vue/app/components/finder/layout/panel/Details.vue +192 -0
- package/frontend-vue/app/components/finder/layout/panel/Shortcuts.vue +265 -0
- package/frontend-vue/app/components/finder/layout/panel/Toogle.vue +27 -0
- package/frontend-vue/app/components/finder/layout/view/Column.vue +180 -0
- package/frontend-vue/app/components/finder/layout/view/Grid.vue +37 -0
- package/frontend-vue/app/components/finder/layout/view/List.vue +289 -0
- package/frontend-vue/app/components/finder/layout/view/Toggle.vue +27 -0
- package/frontend-vue/app/components/finder/layout/view/card/Column.vue +182 -0
- package/frontend-vue/app/components/finder/layout/view/card/Ghost.vue +46 -0
- package/frontend-vue/app/components/finder/layout/view/card/Grid.vue +219 -0
- package/frontend-vue/app/components/finder/layout/view/card/Input.vue +63 -0
- package/frontend-vue/app/components/finder/layout/view/card/List.vue +29 -0
- package/frontend-vue/app/components/finder/layout/view/index.vue +80 -0
- package/frontend-vue/app/components/picker/PickerColumnsView.vue +170 -0
- package/frontend-vue/app/components/picker/PickerDeleteConfirm.vue +62 -0
- package/frontend-vue/app/components/picker/PickerExplorer.vue +436 -0
- package/frontend-vue/app/components/picker/PickerGridView.vue +136 -0
- package/frontend-vue/app/components/picker/PickerItemThumb.vue +49 -0
- package/frontend-vue/app/components/picker/PickerLightbox.vue +158 -0
- package/frontend-vue/app/components/picker/PickerListView.vue +188 -0
- package/frontend-vue/app/components/picker/PickerMoveDialog.vue +115 -0
- package/frontend-vue/app/components/picker/PickerNameEdit.vue +50 -0
- package/frontend-vue/app/components/picker/PickerPreviewBody.vue +109 -0
- package/frontend-vue/app/components/picker/PickerPreviewPane.vue +21 -0
- package/frontend-vue/app/components/picker/PickerSidebar.vue +87 -0
- package/frontend-vue/app/components/picker/PickerToolbar.vue +142 -0
- package/frontend-vue/app/composables/finder/actions/useDeselectOnOutsideClick.ts +40 -0
- package/frontend-vue/app/composables/finder/actions/useDraggableItem.ts +102 -0
- package/frontend-vue/app/composables/finder/actions/useDropTarget.ts +81 -0
- package/frontend-vue/app/composables/finder/actions/useFileUpload.ts +45 -0
- package/frontend-vue/app/composables/finder/actions/useRowDragState.ts +47 -0
- package/frontend-vue/app/composables/finder/actions/useSelectionClick.ts +53 -0
- package/frontend-vue/app/composables/finder/api/useMediaApi.ts +135 -0
- package/frontend-vue/app/composables/finder/context/useFinderContext.ts +55 -0
- package/frontend-vue/app/composables/finder/context/useFinderDragAndDrop.ts +66 -0
- package/frontend-vue/app/composables/finder/context/useFinderHooks.ts +93 -0
- package/frontend-vue/app/composables/finder/context/useFinderLayout.ts +191 -0
- package/frontend-vue/app/composables/finder/context/useFinderNavigation.ts +36 -0
- package/frontend-vue/app/composables/finder/context/useFinderPicker.ts +22 -0
- package/frontend-vue/app/composables/finder/context/useFinderSelect.ts +72 -0
- package/frontend-vue/app/composables/finder/hooks/file.ts +86 -0
- package/frontend-vue/app/composables/finder/hooks/finder.ts +25 -0
- package/frontend-vue/app/composables/finder/hooks/folder.ts +66 -0
- package/frontend-vue/app/composables/finder/hooks/navigation.ts +64 -0
- package/frontend-vue/app/composables/finder/hooks/selection.ts +31 -0
- package/frontend-vue/app/composables/finder/menu/useContextMenu.ts +180 -0
- package/frontend-vue/app/composables/finder/menu/useFinderMenu.ts +41 -0
- package/frontend-vue/app/composables/finder/menu/useItemMenu.ts +114 -0
- package/frontend-vue/app/composables/finder/shortcuts/finderEscape.ts +9 -0
- package/frontend-vue/app/composables/finder/shortcuts/finderShiftA.ts +9 -0
- package/frontend-vue/app/composables/finder/sidebar/useFavoritesFolder.ts +110 -0
- package/frontend-vue/app/composables/finder/sidebar/useFolderSize.ts +49 -0
- package/frontend-vue/app/composables/finder/sidebar/useRecentFile.ts +20 -0
- package/frontend-vue/app/composables/finder/store/useFinderStore.ts +354 -0
- package/frontend-vue/app/composables/picker/usePickerExplorer.ts +788 -0
- package/frontend-vue/app/config/shortcuts-registry.ts +8 -0
- package/frontend-vue/app/types/finder.ts +47 -0
- package/frontend-vue/app/utils/finder/context.ts +25 -0
- package/frontend-vue/app/utils/finder/filegroup.ts +79 -0
- package/frontend-vue/app/utils/finder/filesize.ts +15 -0
- package/frontend-vue/app/utils/finder/formatter.ts +66 -0
- package/frontend-vue/app/utils/finder/helpers.ts +105 -0
- package/frontend-vue/app/utils/finder/mime.ts +108 -0
- package/frontend-vue/app/utils/finder/models.ts +153 -0
- package/frontend-vue/app/utils/finder/shortcuts.ts +29 -0
- package/frontend-vue/dms.frontend.ts +45 -0
- package/frontend-vue/eslint.config.mjs +16 -0
- package/frontend-vue/i18n/locales/media-en-GB.json +191 -0
- package/frontend-vue/i18n/locales/media-fr-FR.json +191 -0
- package/frontend-vue/package.json +35 -0
- package/frontend-vue/pnpm-lock.yaml +6074 -0
- package/frontend-vue/pnpm-workspace.yaml +2 -0
- package/frontend-vue/tests/registration.test.ts +36 -0
- package/frontend-vue/tsconfig.json +13 -0
- package/frontend-vue/vitest.config.ts +5 -0
- package/package.json +83 -0
- package/src/acl/defaults.ts +21 -0
- package/src/acl/entries.ts +19 -0
- package/src/acl/grantable.ts +11 -0
- package/src/acl/index.ts +4 -0
- package/src/acl/resolver.ts +159 -0
- package/src/asset-lifecycle.ts +100 -0
- package/src/asset-type/asset-type.ts +61 -0
- package/src/asset-type/bindings.ts +182 -0
- package/src/asset-type/index.ts +2 -0
- package/src/config.ts +38 -0
- package/src/constants.ts +8 -0
- package/src/crons/index.ts +8 -0
- package/src/crons/sweep-derivatives.ts +68 -0
- package/src/db/index.ts +2 -0
- package/src/db/models/index.ts +2 -0
- package/src/db/models/mediaAssets.model.ts +72 -0
- package/src/db/models/mediaFolders.model.ts +28 -0
- package/src/db/tables/index.ts +2 -0
- package/src/db/tables/mediaAssets.table.ts +83 -0
- package/src/db/tables/mediaFolders.table.ts +52 -0
- package/src/derivatives.ts +227 -0
- package/src/index.ts +52 -0
- package/src/pages/index.ts +1 -0
- package/src/pages/media.ts +39 -0
- package/src/permissions.ts +44 -0
- package/src/presets.ts +61 -0
- package/src/routes/index.ts +1 -0
- package/src/routes/media/assets.ts +278 -0
- package/src/routes/media/constants.ts +18 -0
- package/src/routes/media/context.ts +181 -0
- package/src/routes/media/delivery.ts +174 -0
- package/src/routes/media/dto.ts +116 -0
- package/src/routes/media/folders.ts +279 -0
- package/src/routes/media/index.ts +9 -0
- package/src/routes/media/storage-keys.ts +15 -0
- package/src/routes/media/transform.ts +96 -0
- package/src/routes/media/upload.ts +161 -0
- package/src/test/antelope.test.ts +211 -0
- package/src/test/helpers/assets.ts +95 -0
- package/src/test/helpers/http.ts +23 -0
- package/src/test/helpers/members.ts +78 -0
- package/src/test/helpers/owner.ts +37 -0
- package/src/test/integration/derivative-sweep-query.test.ts +65 -0
- package/src/test/integration/folder-query.test.ts +95 -0
- package/src/test/integration/media-api.test.ts +232 -0
- package/src/test/integration/media-bindings.test.ts +175 -0
- package/src/test/integration/media-cleanup.test.ts +320 -0
- package/src/test/integration/media-delivery.test.ts +136 -0
- package/src/test/integration/media-guards.test.ts +132 -0
- package/src/test/integration/media-list-query.test.ts +98 -0
- package/src/test/integration/media-permissions.test.ts +914 -0
- package/src/test/integration/media-search-query.test.ts +124 -0
- package/src/test/integration/media-transform.test.ts +181 -0
- package/src/test/integration/setup.test.ts +35 -0
- package/src/test/unit/acl/entries.test.ts +58 -0
- package/src/test/unit/acl/grantable.test.ts +54 -0
- package/src/test/unit/acl/resolver.test.ts +283 -0
- package/src/test/unit/asset-type/bindings.test.ts +141 -0
- package/src/test/unit/config.test.ts +44 -0
- package/src/test/unit/derivatives.test.ts +54 -0
- package/src/test/unit/routes/dto.test.ts +65 -0
- package/src/test/unit/transform.test.ts +51 -0
- package/src/transform.ts +183 -0
- package/src/types.ts +17 -0
- package/src/validation/media.schema.ts +117 -0
- package/tsconfig.json +29 -0
|
@@ -0,0 +1,278 @@
|
|
|
1
|
+
import {
|
|
2
|
+
Context,
|
|
3
|
+
Controller,
|
|
4
|
+
Delete,
|
|
5
|
+
Get,
|
|
6
|
+
JSONBody,
|
|
7
|
+
Parameter,
|
|
8
|
+
Post,
|
|
9
|
+
type RequestContext,
|
|
10
|
+
} from "@antelopejs/interface-api";
|
|
11
|
+
import { assert, assertValidation } from "@antelopejs/interface-api-util";
|
|
12
|
+
import { CreateReadUrl } from "@antelopejs/interface-file-storage";
|
|
13
|
+
import { RoleModel, TenantMemberModel } from "@antelopejs/interface-dms/db";
|
|
14
|
+
import { AuthTenantMember } from "@antelopejs/interface-dms/guards";
|
|
15
|
+
import { TenantScopedModel } from "@antelopejs/interface-dms/tenant-scoped-model";
|
|
16
|
+
import type { User } from "@antelopejs/interface-dms/auth/db";
|
|
17
|
+
import { deleteMediaAsset } from "../../asset-lifecycle";
|
|
18
|
+
import { getMediaConfig } from "../../config";
|
|
19
|
+
import {
|
|
20
|
+
type MediaAsset,
|
|
21
|
+
MediaAssetModel,
|
|
22
|
+
type MediaFolder,
|
|
23
|
+
MediaFolderModel,
|
|
24
|
+
} from "../../db";
|
|
25
|
+
import { ensureDerivative } from "../../derivatives";
|
|
26
|
+
import type { MediaPresetConfig } from "../../presets";
|
|
27
|
+
import {
|
|
28
|
+
assetVisibilitySchema,
|
|
29
|
+
moveAssetSchema,
|
|
30
|
+
previewIdsSchema,
|
|
31
|
+
updateAssetSchema,
|
|
32
|
+
} from "../../validation/media.schema";
|
|
33
|
+
import {
|
|
34
|
+
PREVIEW_URL_TTL_SECONDS,
|
|
35
|
+
PRIVATE_READ_URL_TTL_SECONDS,
|
|
36
|
+
} from "./constants";
|
|
37
|
+
import {
|
|
38
|
+
assertPermissionsManager,
|
|
39
|
+
type MediaRequestContext,
|
|
40
|
+
requireFolderRight,
|
|
41
|
+
resolveMediaContext,
|
|
42
|
+
} from "./context";
|
|
43
|
+
import { assertDerivableAsset, requirePreset } from "./delivery";
|
|
44
|
+
import { buildAssetDto, resolveEffectiveVisibility } from "./dto";
|
|
45
|
+
|
|
46
|
+
function changesEffectiveVisibility(
|
|
47
|
+
asset: MediaAsset,
|
|
48
|
+
sourceFolder: MediaFolder,
|
|
49
|
+
targetFolder: MediaFolder,
|
|
50
|
+
): boolean {
|
|
51
|
+
return (
|
|
52
|
+
resolveEffectiveVisibility(asset, sourceFolder) !==
|
|
53
|
+
resolveEffectiveVisibility(asset, targetFolder)
|
|
54
|
+
);
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
const HTTP_NOT_FOUND = 404;
|
|
58
|
+
const MAX_SEARCH_RESULTS = 100;
|
|
59
|
+
const MAX_LISTING_RESULTS = 1000;
|
|
60
|
+
const THUMB_PRESET_ID = "thumb";
|
|
61
|
+
|
|
62
|
+
async function buildPreviewEntry(
|
|
63
|
+
context: MediaRequestContext,
|
|
64
|
+
assetId: string,
|
|
65
|
+
preset: MediaPresetConfig,
|
|
66
|
+
): Promise<[string, string] | null> {
|
|
67
|
+
const asset = await context.assetModel.get(assetId);
|
|
68
|
+
if (
|
|
69
|
+
!asset ||
|
|
70
|
+
asset.isDeleting ||
|
|
71
|
+
!context.access.readable.has(asset.folderId)
|
|
72
|
+
)
|
|
73
|
+
return null;
|
|
74
|
+
if (!asset.mimetype.startsWith("image/")) return null;
|
|
75
|
+
try {
|
|
76
|
+
const derivativeKey = await ensureDerivative(
|
|
77
|
+
context.assetModel,
|
|
78
|
+
asset,
|
|
79
|
+
preset,
|
|
80
|
+
);
|
|
81
|
+
const readUrl = await CreateReadUrl(
|
|
82
|
+
derivativeKey,
|
|
83
|
+
PREVIEW_URL_TTL_SECONDS,
|
|
84
|
+
asset.storage,
|
|
85
|
+
);
|
|
86
|
+
return [assetId, readUrl.url];
|
|
87
|
+
} catch {
|
|
88
|
+
return null;
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
export async function requireReadableAsset(
|
|
93
|
+
context: MediaRequestContext,
|
|
94
|
+
assetId: string,
|
|
95
|
+
): Promise<MediaAsset> {
|
|
96
|
+
const asset = await context.assetModel.get(assetId);
|
|
97
|
+
assert(
|
|
98
|
+
asset && !asset.isDeleting && context.access.readable.has(asset.folderId),
|
|
99
|
+
HTTP_NOT_FOUND,
|
|
100
|
+
"Asset not found",
|
|
101
|
+
);
|
|
102
|
+
return asset;
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
function matchesSearch(asset: MediaAsset, term: string, mime: string): boolean {
|
|
106
|
+
if (asset.isDeleting) return false;
|
|
107
|
+
const matchesTerm =
|
|
108
|
+
term.length === 0 || asset.name.toLowerCase().includes(term);
|
|
109
|
+
const matchesMime = mime.length === 0 || asset.mimetype.startsWith(mime);
|
|
110
|
+
return matchesTerm && matchesMime;
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
export class MediaAssetsController extends Controller("/api/media") {
|
|
114
|
+
@Context()
|
|
115
|
+
declare ctx: RequestContext;
|
|
116
|
+
|
|
117
|
+
@TenantScopedModel(MediaFolderModel)
|
|
118
|
+
declare folderModel: MediaFolderModel;
|
|
119
|
+
|
|
120
|
+
@TenantScopedModel(MediaAssetModel)
|
|
121
|
+
declare assetModel: MediaAssetModel;
|
|
122
|
+
|
|
123
|
+
@TenantScopedModel(RoleModel)
|
|
124
|
+
declare roleModel: RoleModel;
|
|
125
|
+
|
|
126
|
+
@TenantScopedModel(TenantMemberModel)
|
|
127
|
+
declare memberModel: TenantMemberModel;
|
|
128
|
+
|
|
129
|
+
@AuthTenantMember()
|
|
130
|
+
declare user: User;
|
|
131
|
+
|
|
132
|
+
private resolveContext(): Promise<MediaRequestContext> {
|
|
133
|
+
return resolveMediaContext(this);
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
@Get("/assets")
|
|
137
|
+
async listAll() {
|
|
138
|
+
const context = await this.resolveContext();
|
|
139
|
+
const readableFolders = [...context.access.readable];
|
|
140
|
+
if (readableFolders.length === 0) return { assets: [], truncated: false };
|
|
141
|
+
const candidates = await context.assetModel.listByFolders(
|
|
142
|
+
readableFolders,
|
|
143
|
+
MAX_LISTING_RESULTS + 1,
|
|
144
|
+
);
|
|
145
|
+
const truncated = candidates.length > MAX_LISTING_RESULTS;
|
|
146
|
+
const assets = candidates
|
|
147
|
+
.slice(0, MAX_LISTING_RESULTS)
|
|
148
|
+
.map((asset) => buildAssetDto(context, asset));
|
|
149
|
+
return { assets, truncated };
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
@Post("/previews")
|
|
153
|
+
async previews(@JSONBody() body: unknown) {
|
|
154
|
+
const { ids } = assertValidation(body, (v) => previewIdsSchema.parse(v));
|
|
155
|
+
const context = await this.resolveContext();
|
|
156
|
+
const thumbPreset = getMediaConfig().presets.get(THUMB_PRESET_ID);
|
|
157
|
+
if (!thumbPreset) return { previews: {} };
|
|
158
|
+
const entries = await Promise.all(
|
|
159
|
+
ids.map((id) => buildPreviewEntry(context, id, thumbPreset)),
|
|
160
|
+
);
|
|
161
|
+
const previews = Object.fromEntries(
|
|
162
|
+
entries.filter((entry): entry is [string, string] => entry !== null),
|
|
163
|
+
);
|
|
164
|
+
return { previews };
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
@Get("/assets/search")
|
|
168
|
+
async search(
|
|
169
|
+
@Parameter("q", "query") q?: string,
|
|
170
|
+
@Parameter("mime", "query") mime?: string,
|
|
171
|
+
@Parameter("folderId", "query") folderId?: string,
|
|
172
|
+
) {
|
|
173
|
+
const context = await this.resolveContext();
|
|
174
|
+
const searchedFolders = folderId
|
|
175
|
+
? [requireFolderRight(context, folderId, "read")._id]
|
|
176
|
+
: [...context.access.readable];
|
|
177
|
+
if (searchedFolders.length === 0) return { assets: [] };
|
|
178
|
+
const candidates = context.assetModel.table.getAll(
|
|
179
|
+
searchedFolders.length === 1 ? searchedFolders[0] : searchedFolders,
|
|
180
|
+
"folderId",
|
|
181
|
+
);
|
|
182
|
+
const term = (q ?? "").trim().toLowerCase();
|
|
183
|
+
const mimePrefix = (mime ?? "").trim().toLowerCase();
|
|
184
|
+
const assets: ReturnType<typeof buildAssetDto>[] = [];
|
|
185
|
+
for await (const row of candidates) {
|
|
186
|
+
const asset = MediaAssetModel.fromDatabase(row);
|
|
187
|
+
if (!asset || !matchesSearch(asset, term, mimePrefix)) continue;
|
|
188
|
+
assets.push(buildAssetDto(context, asset));
|
|
189
|
+
if (assets.length === MAX_SEARCH_RESULTS) break;
|
|
190
|
+
}
|
|
191
|
+
return { assets };
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
@Get("/assets/:assetId")
|
|
195
|
+
async getAsset(@Parameter("assetId", "param") assetId: string) {
|
|
196
|
+
const context = await this.resolveContext();
|
|
197
|
+
const asset = await requireReadableAsset(context, assetId);
|
|
198
|
+
return { asset: buildAssetDto(context, asset) };
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
@Get("/assets/:assetId/read-url")
|
|
202
|
+
async readUrl(
|
|
203
|
+
@Parameter("assetId", "param") assetId: string,
|
|
204
|
+
@Parameter("preset", "query") presetId?: string,
|
|
205
|
+
) {
|
|
206
|
+
const context = await this.resolveContext();
|
|
207
|
+
const asset = await requireReadableAsset(context, assetId);
|
|
208
|
+
let storageKey = asset.storageKey;
|
|
209
|
+
if (presetId) {
|
|
210
|
+
const preset = requirePreset(presetId);
|
|
211
|
+
assertDerivableAsset(asset);
|
|
212
|
+
storageKey = await ensureDerivative(context.assetModel, asset, preset);
|
|
213
|
+
}
|
|
214
|
+
const readUrl = await CreateReadUrl(
|
|
215
|
+
storageKey,
|
|
216
|
+
PRIVATE_READ_URL_TTL_SECONDS,
|
|
217
|
+
asset.storage,
|
|
218
|
+
);
|
|
219
|
+
return { url: readUrl.url, expiresAt: readUrl.expiresAt };
|
|
220
|
+
}
|
|
221
|
+
|
|
222
|
+
@Post("/assets/:assetId/update")
|
|
223
|
+
async updateAsset(
|
|
224
|
+
@Parameter("assetId", "param") assetId: string,
|
|
225
|
+
@JSONBody() body: unknown,
|
|
226
|
+
) {
|
|
227
|
+
const changes = assertValidation(body, (v) => updateAssetSchema.parse(v));
|
|
228
|
+
const context = await this.resolveContext();
|
|
229
|
+
const asset = await requireReadableAsset(context, assetId);
|
|
230
|
+
requireFolderRight(context, asset.folderId, "write");
|
|
231
|
+
await context.assetModel.update(assetId, changes);
|
|
232
|
+
return { ok: true };
|
|
233
|
+
}
|
|
234
|
+
|
|
235
|
+
@Post("/assets/:assetId/move")
|
|
236
|
+
async moveAsset(
|
|
237
|
+
@Parameter("assetId", "param") assetId: string,
|
|
238
|
+
@JSONBody() body: unknown,
|
|
239
|
+
) {
|
|
240
|
+
const { folderId } = assertValidation(body, (v) =>
|
|
241
|
+
moveAssetSchema.parse(v),
|
|
242
|
+
);
|
|
243
|
+
const context = await this.resolveContext();
|
|
244
|
+
const asset = await requireReadableAsset(context, assetId);
|
|
245
|
+
const sourceFolder = requireFolderRight(context, asset.folderId, "write");
|
|
246
|
+
const targetFolder = requireFolderRight(context, folderId, "write");
|
|
247
|
+
if (changesEffectiveVisibility(asset, sourceFolder, targetFolder)) {
|
|
248
|
+
await assertPermissionsManager(context);
|
|
249
|
+
}
|
|
250
|
+
await context.assetModel.update(assetId, { folderId });
|
|
251
|
+
return { ok: true };
|
|
252
|
+
}
|
|
253
|
+
|
|
254
|
+
@Post("/assets/:assetId/visibility")
|
|
255
|
+
async setVisibility(
|
|
256
|
+
@Parameter("assetId", "param") assetId: string,
|
|
257
|
+
@JSONBody() body: unknown,
|
|
258
|
+
) {
|
|
259
|
+
const { visibility } = assertValidation(body, (v) =>
|
|
260
|
+
assetVisibilitySchema.parse(v),
|
|
261
|
+
);
|
|
262
|
+
const context = await this.resolveContext();
|
|
263
|
+
const asset = await requireReadableAsset(context, assetId);
|
|
264
|
+
requireFolderRight(context, asset.folderId, "manage");
|
|
265
|
+
await assertPermissionsManager(context);
|
|
266
|
+
await context.assetModel.update(assetId, { visibility });
|
|
267
|
+
return { ok: true };
|
|
268
|
+
}
|
|
269
|
+
|
|
270
|
+
@Delete("/assets/:assetId")
|
|
271
|
+
async deleteAsset(@Parameter("assetId", "param") assetId: string) {
|
|
272
|
+
const context = await this.resolveContext();
|
|
273
|
+
const asset = await requireReadableAsset(context, assetId);
|
|
274
|
+
requireFolderRight(context, asset.folderId, "write");
|
|
275
|
+
await deleteMediaAsset(context.assetModel, assetId);
|
|
276
|
+
return { ok: true };
|
|
277
|
+
}
|
|
278
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
const SECONDS_PER_MINUTE = 60;
|
|
2
|
+
const MINUTES_PER_HOUR = 60;
|
|
3
|
+
const SECONDS_PER_HOUR = SECONDS_PER_MINUTE * MINUTES_PER_HOUR;
|
|
4
|
+
|
|
5
|
+
export const PRIVATE_READ_URL_TTL_SECONDS = 5 * SECONDS_PER_MINUTE;
|
|
6
|
+
/**
|
|
7
|
+
* Thumbnails/previews are re-hydrated per session and must outlive an idle
|
|
8
|
+
* Finder window, so they get a longer signed lifetime than one-shot reads.
|
|
9
|
+
*/
|
|
10
|
+
export const PREVIEW_URL_TTL_SECONDS = 12 * SECONDS_PER_HOUR;
|
|
11
|
+
/**
|
|
12
|
+
* Public delivery bounds how long a flip back to private takes to revoke
|
|
13
|
+
* access: the signed URL and the CDN cache both expire within this window,
|
|
14
|
+
* trading some CDN reuse for timely revocation.
|
|
15
|
+
*/
|
|
16
|
+
export const PUBLIC_READ_URL_TTL_SECONDS = SECONDS_PER_HOUR;
|
|
17
|
+
export const PRIVATE_CACHE_CONTROL = "no-store";
|
|
18
|
+
export const PUBLIC_CACHE_CONTROL = `public, max-age=${SECONDS_PER_HOUR}`;
|
|
@@ -0,0 +1,181 @@
|
|
|
1
|
+
import type { RequestContext } from "@antelopejs/interface-api";
|
|
2
|
+
import { assert } from "@antelopejs/interface-api-util";
|
|
3
|
+
import type {
|
|
4
|
+
RoleModel,
|
|
5
|
+
TenantMemberModel,
|
|
6
|
+
} from "@antelopejs/interface-dms/db";
|
|
7
|
+
import {
|
|
8
|
+
GetEffectiveUserPermissions,
|
|
9
|
+
HasPermission,
|
|
10
|
+
} from "@antelopejs/interface-dms/permissions";
|
|
11
|
+
import { getRequestTenantId } from "@antelopejs/interface-dms/request-tenant";
|
|
12
|
+
import type { User } from "@antelopejs/interface-dms/auth/db";
|
|
13
|
+
import {
|
|
14
|
+
type AclActor,
|
|
15
|
+
type FolderAccess,
|
|
16
|
+
filterGrantablePermissions,
|
|
17
|
+
resolveFolderAccess,
|
|
18
|
+
resolveRootRights,
|
|
19
|
+
} from "../../acl";
|
|
20
|
+
import { ensureTenantBindings } from "../../asset-type/bindings";
|
|
21
|
+
import { getMediaConfig } from "../../config";
|
|
22
|
+
import { MEDIA_PERMISSIONS_MANAGE_PERMISSION } from "../../constants";
|
|
23
|
+
import type { MediaAssetModel, MediaFolder, MediaFolderModel } from "../../db";
|
|
24
|
+
import type { AclRight } from "../../types";
|
|
25
|
+
|
|
26
|
+
export interface ActorAccessDeps {
|
|
27
|
+
tenantId: string;
|
|
28
|
+
user: User;
|
|
29
|
+
folderModel: MediaFolderModel;
|
|
30
|
+
roleModel: RoleModel;
|
|
31
|
+
memberModel: TenantMemberModel;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
export interface ActorAccess {
|
|
35
|
+
tenantId: string;
|
|
36
|
+
permissions: Set<string>;
|
|
37
|
+
actor: AclActor;
|
|
38
|
+
folders: MediaFolder[];
|
|
39
|
+
foldersById: Map<string, MediaFolder>;
|
|
40
|
+
access: FolderAccess;
|
|
41
|
+
rootRights: Set<AclRight>;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
export interface MediaContextDeps {
|
|
45
|
+
ctx: RequestContext;
|
|
46
|
+
user: User;
|
|
47
|
+
folderModel: MediaFolderModel;
|
|
48
|
+
assetModel: MediaAssetModel;
|
|
49
|
+
roleModel: RoleModel;
|
|
50
|
+
memberModel: TenantMemberModel;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
export interface MediaRequestContext {
|
|
54
|
+
user: User;
|
|
55
|
+
tenantId: string;
|
|
56
|
+
permissions: Set<string>;
|
|
57
|
+
actor: AclActor;
|
|
58
|
+
folderModel: MediaFolderModel;
|
|
59
|
+
assetModel: MediaAssetModel;
|
|
60
|
+
folders: MediaFolder[];
|
|
61
|
+
foldersById: Map<string, MediaFolder>;
|
|
62
|
+
access: FolderAccess;
|
|
63
|
+
rootRights: Set<AclRight>;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
const HTTP_NOT_FOUND = 404;
|
|
67
|
+
const HTTP_FORBIDDEN = 403;
|
|
68
|
+
|
|
69
|
+
export async function resolveActorAccess(
|
|
70
|
+
deps: ActorAccessDeps,
|
|
71
|
+
): Promise<ActorAccess> {
|
|
72
|
+
const member = await deps.memberModel.getByUser(deps.user._id);
|
|
73
|
+
const roleIds = member?.roleIds ?? [];
|
|
74
|
+
const rawPermissions = await GetEffectiveUserPermissions(
|
|
75
|
+
deps.user,
|
|
76
|
+
deps.tenantId,
|
|
77
|
+
roleIds,
|
|
78
|
+
deps.roleModel,
|
|
79
|
+
);
|
|
80
|
+
const permissions = filterGrantablePermissions(rawPermissions);
|
|
81
|
+
const actor: AclActor = { permissions, roleIds };
|
|
82
|
+
const rootAcl = getMediaConfig().rootAcl;
|
|
83
|
+
await ensureTenantBindings(deps.tenantId, deps.folderModel);
|
|
84
|
+
const folders = await deps.folderModel.getAll();
|
|
85
|
+
return {
|
|
86
|
+
tenantId: deps.tenantId,
|
|
87
|
+
permissions,
|
|
88
|
+
actor,
|
|
89
|
+
folders,
|
|
90
|
+
foldersById: new Map(folders.map((folder) => [folder._id, folder])),
|
|
91
|
+
access: resolveFolderAccess(folders, actor, rootAcl),
|
|
92
|
+
rootRights: resolveRootRights(actor, rootAcl),
|
|
93
|
+
};
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
export async function resolveMediaContext(
|
|
97
|
+
deps: MediaContextDeps,
|
|
98
|
+
): Promise<MediaRequestContext> {
|
|
99
|
+
const tenantId = getRequestTenantId(deps.ctx);
|
|
100
|
+
const actorAccess = await resolveActorAccess({
|
|
101
|
+
tenantId,
|
|
102
|
+
user: deps.user,
|
|
103
|
+
folderModel: deps.folderModel,
|
|
104
|
+
roleModel: deps.roleModel,
|
|
105
|
+
memberModel: deps.memberModel,
|
|
106
|
+
});
|
|
107
|
+
return {
|
|
108
|
+
user: deps.user,
|
|
109
|
+
folderModel: deps.folderModel,
|
|
110
|
+
assetModel: deps.assetModel,
|
|
111
|
+
...actorAccess,
|
|
112
|
+
};
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
export function requireVisibleFolder(
|
|
116
|
+
context: MediaRequestContext,
|
|
117
|
+
folderId: string,
|
|
118
|
+
): MediaFolder {
|
|
119
|
+
const folder = context.foldersById.get(folderId);
|
|
120
|
+
const isVisible =
|
|
121
|
+
context.access.readable.has(folderId) ||
|
|
122
|
+
context.access.shells.has(folderId);
|
|
123
|
+
assert(folder && isVisible, HTTP_NOT_FOUND, "Folder not found");
|
|
124
|
+
return folder;
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
export function requireFolderRight(
|
|
128
|
+
context: MediaRequestContext,
|
|
129
|
+
folderId: string,
|
|
130
|
+
right: AclRight,
|
|
131
|
+
): MediaFolder {
|
|
132
|
+
const folder = requireVisibleFolder(context, folderId);
|
|
133
|
+
const rightSets: Record<AclRight, Set<string>> = {
|
|
134
|
+
read: context.access.readable,
|
|
135
|
+
write: context.access.writable,
|
|
136
|
+
manage: context.access.manageable,
|
|
137
|
+
};
|
|
138
|
+
assert(
|
|
139
|
+
rightSets[right].has(folderId),
|
|
140
|
+
HTTP_FORBIDDEN,
|
|
141
|
+
`Missing '${right}' right on this folder`,
|
|
142
|
+
);
|
|
143
|
+
return folder;
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
export async function assertPermissionsManager(
|
|
147
|
+
context: MediaRequestContext,
|
|
148
|
+
): Promise<void> {
|
|
149
|
+
const allowed = await HasPermission(
|
|
150
|
+
context.permissions,
|
|
151
|
+
MEDIA_PERMISSIONS_MANAGE_PERMISSION,
|
|
152
|
+
);
|
|
153
|
+
assert(allowed, HTTP_FORBIDDEN, "Missing media permissions management");
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
export function assertNotBound(folder: MediaFolder): void {
|
|
157
|
+
assert(
|
|
158
|
+
!folder.binding,
|
|
159
|
+
HTTP_FORBIDDEN,
|
|
160
|
+
"Linked folders cannot be restructured",
|
|
161
|
+
);
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
export function getDescendantFolders(
|
|
165
|
+
context: MediaRequestContext,
|
|
166
|
+
folderId: string,
|
|
167
|
+
): MediaFolder[] {
|
|
168
|
+
const descendants: MediaFolder[] = [];
|
|
169
|
+
const visited = new Set<string>([folderId]);
|
|
170
|
+
const queue = [folderId];
|
|
171
|
+
for (let index = 0; index < queue.length; index++) {
|
|
172
|
+
for (const folder of context.folders) {
|
|
173
|
+
if (folder.parentId !== queue[index]) continue;
|
|
174
|
+
if (visited.has(folder._id)) continue;
|
|
175
|
+
visited.add(folder._id);
|
|
176
|
+
descendants.push(folder);
|
|
177
|
+
queue.push(folder._id);
|
|
178
|
+
}
|
|
179
|
+
}
|
|
180
|
+
return descendants;
|
|
181
|
+
}
|
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
import {
|
|
2
|
+
Context,
|
|
3
|
+
Controller,
|
|
4
|
+
Get,
|
|
5
|
+
HTTPResult,
|
|
6
|
+
Parameter,
|
|
7
|
+
type RequestContext,
|
|
8
|
+
} from "@antelopejs/interface-api";
|
|
9
|
+
import { assert } from "@antelopejs/interface-api-util";
|
|
10
|
+
import { GetModel } from "@antelopejs/interface-database-decorators";
|
|
11
|
+
import { CreateReadUrl } from "@antelopejs/interface-file-storage";
|
|
12
|
+
import { RoleModel, TenantMemberModel } from "@antelopejs/interface-dms/db";
|
|
13
|
+
import { getRequestTenantId } from "@antelopejs/interface-dms/request-tenant";
|
|
14
|
+
import { IfAuthUser } from "@antelopejs/interface-dms/auth";
|
|
15
|
+
import type { User } from "@antelopejs/interface-dms/auth/db";
|
|
16
|
+
import { getMediaConfig } from "../../config";
|
|
17
|
+
import { type MediaAsset, MediaAssetModel, MediaFolderModel } from "../../db";
|
|
18
|
+
import { ensureDerivative } from "../../derivatives";
|
|
19
|
+
import type { MediaPresetConfig } from "../../presets";
|
|
20
|
+
import {
|
|
21
|
+
PRIVATE_CACHE_CONTROL,
|
|
22
|
+
PRIVATE_READ_URL_TTL_SECONDS,
|
|
23
|
+
PUBLIC_CACHE_CONTROL,
|
|
24
|
+
PUBLIC_READ_URL_TTL_SECONDS,
|
|
25
|
+
} from "./constants";
|
|
26
|
+
import { resolveActorAccess } from "./context";
|
|
27
|
+
import { resolveEffectiveVisibility } from "./dto";
|
|
28
|
+
|
|
29
|
+
const HTTP_FOUND = 302;
|
|
30
|
+
const HTTP_UNAUTHORIZED = 401;
|
|
31
|
+
const HTTP_FORBIDDEN = 403;
|
|
32
|
+
const HTTP_NOT_FOUND = 404;
|
|
33
|
+
const HTTP_UNPROCESSABLE_ENTITY = 422;
|
|
34
|
+
|
|
35
|
+
/**
|
|
36
|
+
* Formats accepted by the transform pipeline. Sharp would silently
|
|
37
|
+
* rasterize or flatten anything else (SVG, animated sources).
|
|
38
|
+
*
|
|
39
|
+
* Mirrored in `frontend-vue/app/utils/finder/mime.ts` for the UI
|
|
40
|
+
* affordances: the frontend module is copied by ajs-dms at prepare time and
|
|
41
|
+
* cannot resolve imports into the backend `src/` tree, so keep both
|
|
42
|
+
* lists in sync when adding a format.
|
|
43
|
+
*/
|
|
44
|
+
export const EDITABLE_IMAGE_MIMETYPES = new Set([
|
|
45
|
+
"image/jpeg",
|
|
46
|
+
"image/png",
|
|
47
|
+
"image/webp",
|
|
48
|
+
"image/avif",
|
|
49
|
+
]);
|
|
50
|
+
|
|
51
|
+
interface DeliverableAsset {
|
|
52
|
+
asset: MediaAsset;
|
|
53
|
+
assetModel: MediaAssetModel;
|
|
54
|
+
isPublic: boolean;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
function redirectTo(url: string, cacheControl: string): HTTPResult {
|
|
58
|
+
return HTTPResult.withHeaders(
|
|
59
|
+
"",
|
|
60
|
+
{ Location: url, "Cache-Control": cacheControl },
|
|
61
|
+
HTTP_FOUND,
|
|
62
|
+
);
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
async function assertUserReadsFolder(
|
|
66
|
+
tenantId: string,
|
|
67
|
+
user: User,
|
|
68
|
+
folderId: string,
|
|
69
|
+
folderModel: MediaFolderModel,
|
|
70
|
+
): Promise<void> {
|
|
71
|
+
const { access } = await resolveActorAccess({
|
|
72
|
+
tenantId,
|
|
73
|
+
user,
|
|
74
|
+
folderModel,
|
|
75
|
+
roleModel: GetModel(RoleModel, tenantId),
|
|
76
|
+
memberModel: GetModel(TenantMemberModel, tenantId),
|
|
77
|
+
});
|
|
78
|
+
assert(
|
|
79
|
+
access.readable.has(folderId),
|
|
80
|
+
HTTP_FORBIDDEN,
|
|
81
|
+
"Missing read access on this asset",
|
|
82
|
+
);
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
async function resolveDeliverableAsset(
|
|
86
|
+
ctx: RequestContext,
|
|
87
|
+
assetId: string,
|
|
88
|
+
user: User | undefined,
|
|
89
|
+
): Promise<DeliverableAsset> {
|
|
90
|
+
const tenantId = getRequestTenantId(ctx);
|
|
91
|
+
const assetModel = GetModel(MediaAssetModel, tenantId);
|
|
92
|
+
const asset = await assetModel.get(assetId);
|
|
93
|
+
assert(asset && !asset.isDeleting, HTTP_NOT_FOUND, "Asset not found");
|
|
94
|
+
const folderModel = GetModel(MediaFolderModel, tenantId);
|
|
95
|
+
const folder = await folderModel.get(asset.folderId);
|
|
96
|
+
const visibility = resolveEffectiveVisibility(asset, folder ?? undefined);
|
|
97
|
+
if (visibility === "public") {
|
|
98
|
+
return { asset, assetModel, isPublic: true };
|
|
99
|
+
}
|
|
100
|
+
assert(user, HTTP_UNAUTHORIZED, "Authentication required");
|
|
101
|
+
await assertUserReadsFolder(tenantId, user, asset.folderId, folderModel);
|
|
102
|
+
return { asset, assetModel, isPublic: false };
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
async function redirectToStorageKey(
|
|
106
|
+
storageKey: string,
|
|
107
|
+
storage: string | undefined,
|
|
108
|
+
isPublic: boolean,
|
|
109
|
+
): Promise<HTTPResult> {
|
|
110
|
+
const ttl = isPublic
|
|
111
|
+
? PUBLIC_READ_URL_TTL_SECONDS
|
|
112
|
+
: PRIVATE_READ_URL_TTL_SECONDS;
|
|
113
|
+
const cacheControl = isPublic ? PUBLIC_CACHE_CONTROL : PRIVATE_CACHE_CONTROL;
|
|
114
|
+
const readUrl = await CreateReadUrl(storageKey, ttl, storage);
|
|
115
|
+
return redirectTo(readUrl.url, cacheControl);
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
export function requirePreset(presetId: string): MediaPresetConfig {
|
|
119
|
+
const preset = getMediaConfig().presets.get(presetId);
|
|
120
|
+
assert(preset, HTTP_NOT_FOUND, "Unknown preset");
|
|
121
|
+
return preset;
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
export function assertDerivableAsset(asset: MediaAsset): void {
|
|
125
|
+
assert(
|
|
126
|
+
asset.mimetype.startsWith("image/"),
|
|
127
|
+
HTTP_NOT_FOUND,
|
|
128
|
+
"Derivatives only exist for images",
|
|
129
|
+
);
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
export function assertEditableAsset(asset: MediaAsset): void {
|
|
133
|
+
assert(
|
|
134
|
+
EDITABLE_IMAGE_MIMETYPES.has(asset.mimetype),
|
|
135
|
+
HTTP_UNPROCESSABLE_ENTITY,
|
|
136
|
+
"This image format cannot be edited",
|
|
137
|
+
);
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
export class MediaDeliveryController extends Controller("/media") {
|
|
141
|
+
@Get("/:assetId/:filename")
|
|
142
|
+
async deliverOriginal(
|
|
143
|
+
@Context() ctx: RequestContext,
|
|
144
|
+
@Parameter("assetId", "param") assetId: string,
|
|
145
|
+
@IfAuthUser() user?: User,
|
|
146
|
+
) {
|
|
147
|
+
const { asset, isPublic } = await resolveDeliverableAsset(
|
|
148
|
+
ctx,
|
|
149
|
+
assetId,
|
|
150
|
+
user,
|
|
151
|
+
);
|
|
152
|
+
return redirectToStorageKey(asset.storageKey, asset.storage, isPublic);
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
@Get("/:assetId/:presetId/:filename")
|
|
156
|
+
async deliverDerivative(
|
|
157
|
+
@Context() ctx: RequestContext,
|
|
158
|
+
@Parameter("assetId", "param") assetId: string,
|
|
159
|
+
@Parameter("presetId", "param") presetId: string,
|
|
160
|
+
@IfAuthUser() user?: User,
|
|
161
|
+
) {
|
|
162
|
+
// Resolve (and authorize) the asset before touching the preset so an
|
|
163
|
+
// unauthenticated caller cannot probe which preset IDs are configured.
|
|
164
|
+
const { asset, assetModel, isPublic } = await resolveDeliverableAsset(
|
|
165
|
+
ctx,
|
|
166
|
+
assetId,
|
|
167
|
+
user,
|
|
168
|
+
);
|
|
169
|
+
const preset = requirePreset(presetId);
|
|
170
|
+
assertDerivableAsset(asset);
|
|
171
|
+
const derivativeKey = await ensureDerivative(assetModel, asset, preset);
|
|
172
|
+
return redirectToStorageKey(derivativeKey, asset.storage, isPublic);
|
|
173
|
+
}
|
|
174
|
+
}
|