@antelopejs/dms-media 0.6.1 → 0.7.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 (207) hide show
  1. package/README.md +18 -3
  2. package/dist/acl/entries.js +1 -2
  3. package/dist/acl/entries.js.map +1 -1
  4. package/dist/bindings.js +1 -3
  5. package/dist/bindings.js.map +1 -1
  6. package/dist/declared/folders.js +3 -2
  7. package/dist/declared/folders.js.map +1 -1
  8. package/dist/declared/records.d.ts +2 -2
  9. package/dist/declared/records.js +3 -2
  10. package/dist/declared/records.js.map +1 -1
  11. package/dist/derivatives.js +9 -6
  12. package/dist/derivatives.js.map +1 -1
  13. package/dist/guards.d.ts +4 -0
  14. package/dist/guards.js +19 -0
  15. package/dist/guards.js.map +1 -0
  16. package/dist/library/activity.js +7 -5
  17. package/dist/library/activity.js.map +1 -1
  18. package/dist/library/batches.js +6 -3
  19. package/dist/library/batches.js.map +1 -1
  20. package/dist/library/events.js +4 -4
  21. package/dist/library/events.js.map +1 -1
  22. package/dist/library/module-readout.js +5 -2
  23. package/dist/library/module-readout.js.map +1 -1
  24. package/dist/library/realtime.js.map +1 -1
  25. package/dist/pages/activity.js +1 -1
  26. package/dist/pages/activity.js.map +1 -1
  27. package/dist/routes/media/assets.d.ts +1 -1
  28. package/dist/routes/media/assets.js +5 -5
  29. package/dist/routes/media/assets.js.map +1 -1
  30. package/dist/routes/media/bulk.js +17 -13
  31. package/dist/routes/media/bulk.js.map +1 -1
  32. package/dist/routes/media/delivery-headers.js +9 -9
  33. package/dist/routes/media/delivery-headers.js.map +1 -1
  34. package/dist/routes/media/delivery-stream.js.map +1 -1
  35. package/dist/routes/media/delivery.js.map +1 -1
  36. package/dist/routes/media/manage.js.map +1 -1
  37. package/dist/routes/media/transform.js +13 -8
  38. package/dist/routes/media/transform.js.map +1 -1
  39. package/dist/test/antelope.test.js +13 -12
  40. package/dist/test/antelope.test.js.map +1 -1
  41. package/dist/test/helpers/folders.d.ts +27 -0
  42. package/dist/test/helpers/folders.js +15 -0
  43. package/dist/test/helpers/folders.js.map +1 -1
  44. package/dist/test/helpers/pages.js +10 -6
  45. package/dist/test/helpers/pages.js.map +1 -1
  46. package/dist/test/helpers/permissions-world.d.ts +98 -0
  47. package/dist/test/helpers/permissions-world.js +205 -0
  48. package/dist/test/helpers/permissions-world.js.map +1 -0
  49. package/dist/test/helpers/prototype.d.ts +1 -0
  50. package/dist/test/helpers/prototype.js +11 -0
  51. package/dist/test/helpers/prototype.js.map +1 -0
  52. package/dist/test/integration/derivative-sweep-query.test.js +13 -16
  53. package/dist/test/integration/derivative-sweep-query.test.js.map +1 -1
  54. package/dist/test/integration/folder-query.test.js +5 -9
  55. package/dist/test/integration/folder-query.test.js.map +1 -1
  56. package/dist/test/integration/media-bindings.test.js +2 -2
  57. package/dist/test/integration/media-bindings.test.js.map +1 -1
  58. package/dist/test/integration/media-cleanup.test.js +14 -17
  59. package/dist/test/integration/media-cleanup.test.js.map +1 -1
  60. package/dist/test/integration/media-declared-content.test.js +2 -1
  61. package/dist/test/integration/media-declared-content.test.js.map +1 -1
  62. package/dist/test/integration/media-delivery-editing.test.js +7 -5
  63. package/dist/test/integration/media-delivery-editing.test.js.map +1 -1
  64. package/dist/test/integration/media-delivery.test.js +19 -5
  65. package/dist/test/integration/media-delivery.test.js.map +1 -1
  66. package/dist/test/integration/media-explorer-writes.test.js +2 -2
  67. package/dist/test/integration/media-explorer-writes.test.js.map +1 -1
  68. package/dist/test/integration/media-guards.test.js +18 -7
  69. package/dist/test/integration/media-guards.test.js.map +1 -1
  70. package/dist/test/integration/media-library.test.js +1 -1
  71. package/dist/test/integration/media-library.test.js.map +1 -1
  72. package/dist/test/integration/media-linked-subfolders.test.js +5 -5
  73. package/dist/test/integration/media-linked-subfolders.test.js.map +1 -1
  74. package/dist/test/integration/media-member-access.test.js +2 -5
  75. package/dist/test/integration/media-member-access.test.js.map +1 -1
  76. package/dist/test/integration/media-permissions.test.js +142 -473
  77. package/dist/test/integration/media-permissions.test.js.map +1 -1
  78. package/dist/test/integration/media-project-field.test.js +3 -5
  79. package/dist/test/integration/media-project-field.test.js.map +1 -1
  80. package/dist/test/integration/media-search-query.test.js +11 -16
  81. package/dist/test/integration/media-search-query.test.js.map +1 -1
  82. package/dist/test/integration/media-storage-origin-unreachable.test.js +1 -0
  83. package/dist/test/integration/media-storage-origin-unreachable.test.js.map +1 -1
  84. package/dist/test/integration/media-upload-policy.test.js +2 -2
  85. package/dist/test/integration/media-upload-policy.test.js.map +1 -1
  86. package/dist/test/integration/permissions-management.d.ts +2 -0
  87. package/dist/test/integration/permissions-management.js +189 -0
  88. package/dist/test/integration/permissions-management.js.map +1 -0
  89. package/dist/test/unit/acl/entries.test.js +2 -1
  90. package/dist/test/unit/acl/entries.test.js.map +1 -1
  91. package/dist/test/unit/acl/resolver.test.js +10 -3
  92. package/dist/test/unit/acl/resolver.test.js.map +1 -1
  93. package/dist/test/unit/library/fixtures.d.ts +1 -1
  94. package/dist/test/unit/library/fixtures.js +6 -1
  95. package/dist/test/unit/library/fixtures.js.map +1 -1
  96. package/dist/test/unit/library/library.test.js +0 -1
  97. package/dist/test/unit/library/library.test.js.map +1 -1
  98. package/dist/test/unit/library/realtime.test.js.map +1 -1
  99. package/dist/test/unit/library/search-facets.test.js +2 -2
  100. package/dist/test/unit/library/search-facets.test.js.map +1 -1
  101. package/dist/test/unit/pages/toolbar.test.js +24 -7
  102. package/dist/test/unit/pages/toolbar.test.js.map +1 -1
  103. package/dist/test/unit/routes/dto.test.js +7 -6
  104. package/dist/test/unit/routes/dto.test.js.map +1 -1
  105. package/dist/test/unit/routes/file-page.test.js +5 -7
  106. package/dist/test/unit/routes/file-page.test.js.map +1 -1
  107. package/dist/test/unit/routes/preset-row.test.js +2 -1
  108. package/dist/test/unit/routes/preset-row.test.js.map +1 -1
  109. package/dist/transform.js +6 -6
  110. package/dist/transform.js.map +1 -1
  111. package/dist/upload-checks.d.ts +8 -2
  112. package/dist/upload-checks.js.map +1 -1
  113. package/dist/upload-policy.js +8 -8
  114. package/dist/upload-policy.js.map +1 -1
  115. package/dist/validation/declared.schema.js +14 -8
  116. package/dist/validation/declared.schema.js.map +1 -1
  117. package/dist/validation/media.schema.d.ts +1 -1
  118. package/dist/validation/media.schema.js +2 -2
  119. package/dist/validation/media.schema.js.map +1 -1
  120. package/frontend-vue/app/build/imageEditor/editorShapes.ts +118 -0
  121. package/frontend-vue/app/build/imageEditor/useEditorSaving.ts +87 -0
  122. package/frontend-vue/app/build/library/libraryActions.ts +444 -0
  123. package/frontend-vue/app/build/library/libraryCore.ts +137 -0
  124. package/frontend-vue/app/components/FirstRun.vue +2 -1
  125. package/frontend-vue/app/components/ImageEditor.vue +22 -179
  126. package/frontend-vue/app/components/dialogs/DestinationDialog.vue +3 -3
  127. package/frontend-vue/app/components/field/FieldAltPopover.vue +2 -1
  128. package/frontend-vue/app/composables/library/useMediaLibrary.ts +3 -575
  129. package/frontend-vue/app/composables/useAssetFieldUploads.ts +9 -1
  130. package/frontend-vue/app/composables/useAssetLink.ts +33 -13
  131. package/frontend-vue/app/composables/useFileDetails.ts +6 -5
  132. package/frontend-vue/app/composables/useMediaApi.ts +21 -5
  133. package/frontend-vue/app/composables/useUploadFailureText.ts +24 -5
  134. package/frontend-vue/app/composables/useUploadQueue.ts +178 -44
  135. package/frontend-vue/app/composables/useUploadToasts.ts +81 -19
  136. package/frontend-vue/build/backend-boundary.ts +122 -0
  137. package/frontend-vue/dms.frontend.build.ts +3 -0
  138. package/frontend-vue/eslint.config.mjs +13 -0
  139. package/frontend-vue/package.json +4 -2
  140. package/frontend-vue/pnpm-lock.yaml +217 -61
  141. package/frontend-vue/tests/api-error-presentation.test.ts +183 -0
  142. package/frontend-vue/tests/backend-boundary.test.ts +203 -0
  143. package/frontend-vue/tests/fixtures/serverRender.ts +1 -1
  144. package/frontend-vue/tests/mediaPreviews.test.ts +39 -0
  145. package/package.json +5 -11
  146. package/skills/dms-media/SKILL.md +3 -2
  147. package/skills/dms-media/cases.json +38 -0
  148. package/src/acl/entries.ts +6 -4
  149. package/src/bindings.ts +3 -3
  150. package/src/declared/folders.ts +3 -3
  151. package/src/declared/records.ts +9 -8
  152. package/src/derivatives.ts +10 -6
  153. package/src/guards.ts +19 -0
  154. package/src/library/activity.ts +17 -9
  155. package/src/library/batches.ts +12 -9
  156. package/src/library/events.ts +7 -4
  157. package/src/library/module-readout.ts +6 -2
  158. package/src/library/realtime.ts +5 -1
  159. package/src/library/zip.ts +1 -1
  160. package/src/pages/activity.ts +6 -2
  161. package/src/routes/media/assets.ts +4 -3
  162. package/src/routes/media/bulk.ts +16 -14
  163. package/src/routes/media/delivery-headers.ts +9 -12
  164. package/src/routes/media/delivery-stream.ts +3 -2
  165. package/src/routes/media/delivery.ts +4 -2
  166. package/src/routes/media/manage.ts +4 -6
  167. package/src/routes/media/transform.ts +27 -23
  168. package/src/test/antelope.test.ts +21 -17
  169. package/src/test/helpers/folders.ts +22 -0
  170. package/src/test/helpers/pages.ts +12 -5
  171. package/src/test/helpers/permissions-world.ts +326 -0
  172. package/src/test/helpers/prototype.ts +12 -0
  173. package/src/test/integration/derivative-sweep-query.test.ts +19 -21
  174. package/src/test/integration/folder-query.test.ts +11 -11
  175. package/src/test/integration/media-bindings.test.ts +7 -7
  176. package/src/test/integration/media-cleanup.test.ts +25 -37
  177. package/src/test/integration/media-declared-content.test.ts +18 -19
  178. package/src/test/integration/media-delivery-editing.test.ts +11 -7
  179. package/src/test/integration/media-delivery.test.ts +29 -8
  180. package/src/test/integration/media-explorer-writes.test.ts +2 -7
  181. package/src/test/integration/media-guards.test.ts +21 -7
  182. package/src/test/integration/media-library.test.ts +1 -1
  183. package/src/test/integration/media-linked-subfolders.test.ts +11 -20
  184. package/src/test/integration/media-member-access.test.ts +5 -9
  185. package/src/test/integration/media-permissions.test.ts +56 -570
  186. package/src/test/integration/media-project-field.test.ts +5 -7
  187. package/src/test/integration/media-search-query.test.ts +16 -20
  188. package/src/test/integration/media-storage-origin-unreachable.test.ts +3 -2
  189. package/src/test/integration/media-upload-policy.test.ts +2 -8
  190. package/src/test/integration/permissions-management.ts +292 -0
  191. package/src/test/unit/acl/entries.test.ts +2 -1
  192. package/src/test/unit/acl/resolver.test.ts +19 -7
  193. package/src/test/unit/library/fixtures.ts +9 -3
  194. package/src/test/unit/library/library.test.ts +1 -7
  195. package/src/test/unit/library/realtime.test.ts +1 -1
  196. package/src/test/unit/library/search-facets.test.ts +2 -2
  197. package/src/test/unit/pages/toolbar.test.ts +42 -17
  198. package/src/test/unit/routes/dto.test.ts +7 -6
  199. package/src/test/unit/routes/file-page.test.ts +10 -9
  200. package/src/test/unit/routes/preset-row.test.ts +2 -2
  201. package/src/transform.ts +6 -6
  202. package/src/upload-checks.ts +12 -3
  203. package/src/upload-policy.ts +8 -8
  204. package/src/validation/declared.schema.ts +17 -12
  205. package/src/validation/media.schema.ts +6 -6
  206. package/frontend-vue/tests/engines.test.ts +0 -20
  207. package/frontend-vue/tests/locales.test.ts +0 -61
@@ -0,0 +1,444 @@
1
+ import type {
2
+ AssetVisibility,
3
+ BulkOutcome,
4
+ BulkRefusal,
5
+ FolderVisibility,
6
+ MediaAsset,
7
+ MediaFolder,
8
+ } from '../../types/media'
9
+ import type { NameOutcome } from '../../composables/library/useMediaLibrary'
10
+ import type { LibraryCore } from './libraryCore'
11
+
12
+ interface ToastAction {
13
+ label: string
14
+ onClick: () => void | Promise<void>
15
+ }
16
+
17
+ interface GoneSplit {
18
+ outcome: BulkOutcome
19
+ gone: string[]
20
+ }
21
+
22
+ interface OutcomeReport {
23
+ doneKey: string
24
+ params?: Record<string, unknown>
25
+ actions?: ToastAction[]
26
+ duration?: number
27
+ }
28
+
29
+ const UNDO_TOAST_MS = 10_000
30
+ const ZIP_URL_TTL_MS = 10_000
31
+ const ZIP_FALLBACK_NAME = 'media'
32
+ const UNSAFE_FILENAME_CHARS = /[<>:"/\\|?*\u0000-\u001f]+/g
33
+ const NAME_FIELD = 'name'
34
+ const NAME_ERROR_CODES: Record<string, typeof NAME_FIELD> = Object.fromEntries(
35
+ ['name_required', 'name_too_long', 'name_forbidden', 'name_taken', 'folder_name_taken'].map((code) => [
36
+ `$dms_media.errors.${code}`,
37
+ NAME_FIELD,
38
+ ]),
39
+ )
40
+
41
+ type Translate = LibraryCore['t']
42
+
43
+ /** A refusal about the typed name, shown under the name field instead of a toast. */
44
+ function nameFieldError(t: Translate, error: unknown): string | undefined {
45
+ const [refusal] = resolveFieldErrors(error, { fields: [NAME_FIELD], codes: NAME_ERROR_CODES }).fields
46
+ return refusal && resolveApiMessage(t, refusal.message, refusal.params)
47
+ }
48
+
49
+ function isGoneRefusal(refusal: BulkRefusal): boolean {
50
+ return refusal.status === HTTP_NOT_FOUND
51
+ }
52
+
53
+ function refusedMessage(t: Translate, outcome: BulkOutcome): string | undefined {
54
+ const message = outcome.refused[0]?.message
55
+ return message ? resolveApiMessage(t, message) : undefined
56
+ }
57
+
58
+ function reportOutcome(library: LibraryCore, outcome: BulkOutcome, report: OutcomeReport): void {
59
+ const { t } = library
60
+ const count = outcome.done.length
61
+ const isComplete = outcome.refused.length === 0
62
+ library.toast.add({
63
+ title: isComplete
64
+ ? t(report.doneKey, { count, ...report.params }, count)
65
+ : t('dms_media.toasts.partial', { done: count, refused: outcome.refused.length }),
66
+ description: refusedMessage(t, outcome),
67
+ color: isComplete ? 'success' : 'warning',
68
+ icon: isComplete ? 'i-ph-check-circle' : 'i-ph-warning',
69
+ actions: count > 0 ? report.actions : undefined,
70
+ duration: report.actions && count > 0 ? report.duration : undefined,
71
+ })
72
+ }
73
+
74
+ /** A refused bulk outcome where files deleted meanwhile count as gone, not refused. */
75
+ function splitGone(outcome: BulkOutcome): GoneSplit {
76
+ const gone = outcome.refused.filter(isGoneRefusal).map((refusal) => refusal.id)
77
+ return {
78
+ outcome: { done: outcome.done, refused: outcome.refused.filter((refusal) => !isGoneRefusal(refusal)) },
79
+ gone,
80
+ }
81
+ }
82
+
83
+ function zipFileName(label: string | undefined): string {
84
+ const base = (label ?? '').replace(UNSAFE_FILENAME_CHARS, ' ').trim() || ZIP_FALLBACK_NAME
85
+ const day = new Date().toISOString().slice(0, 10)
86
+ return `${base}-${day}.zip`
87
+ }
88
+
89
+ function saveBlob(blob: Blob, name: string): void {
90
+ const url = URL.createObjectURL(blob)
91
+ downloadFile(url, name)
92
+ setTimeout(() => URL.revokeObjectURL(url), ZIP_URL_TTL_MS)
93
+ }
94
+
95
+ /** Drops files someone else deleted meanwhile, and says so. */
96
+ function createGoneHandler(library: LibraryCore) {
97
+ return function forgetGone(ids: string[]): void {
98
+ if (ids.length === 0) return
99
+ library.listing.removeAssets(ids)
100
+ library.selection.forget(ids)
101
+ ids.forEach((id) => library.previews.forget(id))
102
+ void library.tree.refresh()
103
+ library.toast.add({
104
+ title: library.t('dms_media.toasts.already_deleted', { count: ids.length }, ids.length),
105
+ color: 'warning',
106
+ icon: 'i-ph-warning',
107
+ })
108
+ }
109
+ }
110
+
111
+ /** Writes to a file's own details: name and alt text. */
112
+ function createDetailActions(library: LibraryCore) {
113
+ const { api, listing, tree, t } = library
114
+ const forgetGone = createGoneHandler(library)
115
+
116
+ function touch(assetId: string, changes: Partial<MediaAsset>): void {
117
+ listing.patchAsset(assetId, { ...changes, updatedAt: new Date().toISOString() })
118
+ }
119
+
120
+ function sortByName(): void {
121
+ const { sort, direction } = listing.filters.value
122
+ if (sort !== 'name') return
123
+ const factor = direction === 'desc' ? -1 : 1
124
+ listing.reorderAssets(
125
+ [...listing.assets.value].sort((left, right) => NAME_COLLATOR.compare(left.name, right.name) * factor),
126
+ )
127
+ }
128
+
129
+ function failWrite(error: unknown, asset: MediaAsset, titleKey: string): NameOutcome {
130
+ const fieldError = nameFieldError(t, error)
131
+ if (fieldError) return { isDone: false, fieldError }
132
+ if (isNotFoundError(error)) forgetGone([asset.id])
133
+ else library.notifyFailure(error, titleKey)
134
+ return { isDone: false }
135
+ }
136
+
137
+ /** Renames a file; a name already taken comes back as a field error. */
138
+ async function renameAsset(asset: MediaAsset, name: string): Promise<NameOutcome> {
139
+ if (!name || name === asset.name) return { isDone: true }
140
+ try {
141
+ await api.updateAsset(asset.id, { name })
142
+ touch(asset.id, { name })
143
+ sortByName()
144
+ return { isDone: true }
145
+ } catch (error) {
146
+ return failWrite(error, asset, 'dms_media.toasts.rename_failed')
147
+ }
148
+ }
149
+
150
+ async function setAlt(asset: MediaAsset, alt: string): Promise<boolean> {
151
+ if (alt === (asset.alt ?? '')) return true
152
+ touch(asset.id, { alt })
153
+ try {
154
+ await api.updateAsset(asset.id, { alt })
155
+ const wasMissing = needsAltText(asset)
156
+ const isMissing = needsAltText({ ...asset, alt })
157
+ if (wasMissing !== isMissing) tree.adjustView('missingAlt', isMissing ? 1 : -1)
158
+ return true
159
+ } catch (error) {
160
+ listing.patchAsset(asset.id, { alt: asset.alt, updatedAt: asset.updatedAt })
161
+ failWrite(error, asset, 'dms_media.toasts.alt_failed')
162
+ return false
163
+ }
164
+ }
165
+
166
+ return { renameAsset, setAlt, forgetGone }
167
+ }
168
+
169
+ /** Moving files, with an undo that sends each one back to its own folder. */
170
+ function createMoveActions(library: LibraryCore, forgetGone: (ids: string[]) => void) {
171
+ const { api, listing, tree, selection, t } = library
172
+
173
+ function applyMove(ids: string[], folderId: string): void {
174
+ if (listing.location.value.kind === 'folder') {
175
+ listing.removeAssets(ids)
176
+ selection.forget(ids)
177
+ return
178
+ }
179
+ ids.forEach((id) => listing.patchAsset(id, { folderId }))
180
+ }
181
+
182
+ function groupByOrigin(ids: string[], origins: Map<string, string>): Map<string, string[]> {
183
+ const groups = new Map<string, string[]>()
184
+ for (const id of ids) {
185
+ const origin = origins.get(id)
186
+ if (origin) groups.set(origin, [...(groups.get(origin) ?? []), id])
187
+ }
188
+ return groups
189
+ }
190
+
191
+ async function undoMove(ids: string[], origins: Map<string, string>): Promise<void> {
192
+ try {
193
+ const groups = [...groupByOrigin(ids, origins)]
194
+ await Promise.all(groups.map(([folderId, group]) => api.moveAssets(group, folderId)))
195
+ await Promise.all([tree.refresh(), listing.load()])
196
+ library.toast.add({ title: t('dms_media.toasts.move_undone'), color: 'success', icon: 'i-ph-arrow-counter-clockwise' })
197
+ } catch (error) {
198
+ library.notifyFailure(error, 'dms_media.toasts.undo_failed')
199
+ }
200
+ }
201
+
202
+ async function moveAssets(assets: MediaAsset[], folderId: string): Promise<void> {
203
+ const origins = new Map(assets.map((asset) => [asset.id, asset.folderId]))
204
+ try {
205
+ const result = splitGone(await api.moveAssets([...origins.keys()], folderId))
206
+ applyMove(result.outcome.done, folderId)
207
+ forgetGone(result.gone)
208
+ await tree.refresh()
209
+ reportOutcome(library, result.outcome, {
210
+ doneKey: 'dms_media.toasts.moved_to',
211
+ params: { name: tree.foldersById.value.get(folderId)?.name ?? '' },
212
+ actions: [{ label: t('dms_media.actions.undo'), onClick: () => undoMove(result.outcome.done, origins) }],
213
+ duration: UNDO_TOAST_MS,
214
+ })
215
+ } catch (error) {
216
+ library.notifyFailure(error, 'dms_media.toasts.move_failed')
217
+ }
218
+ }
219
+
220
+ return { moveAssets }
221
+ }
222
+
223
+ /** Stars, which also leave the Starred view when removed there. */
224
+ function createStarActions(library: LibraryCore) {
225
+ const { api, listing, tree, t } = library
226
+
227
+ function patchStar(target: MediaAsset | MediaFolder, kind: 'asset' | 'folder', starred: boolean): void {
228
+ if (kind === 'asset') listing.patchAsset(target.id, { starred })
229
+ else tree.patchFolder(target.id, { starred })
230
+ tree.adjustView('starred', starred ? 1 : -1)
231
+ }
232
+
233
+ function isStarredView(): boolean {
234
+ const current = listing.location.value
235
+ return current.kind === 'view' && current.view === 'starred'
236
+ }
237
+
238
+ function leaveStarredView(target: MediaAsset | MediaFolder, kind: 'asset' | 'folder'): void {
239
+ if (kind === 'asset') listing.removeAssets([target.id])
240
+ else listing.removeExtraFolder(target.id)
241
+ library.toast.add({
242
+ title: t('dms_media.toasts.unstarred', { name: target.name }),
243
+ color: 'neutral',
244
+ icon: 'i-ph-star',
245
+ actions: [{ label: t('dms_media.actions.undo'), onClick: () => restar(target, kind) }],
246
+ })
247
+ }
248
+
249
+ async function restar(target: MediaAsset | MediaFolder, kind: 'asset' | 'folder'): Promise<void> {
250
+ try {
251
+ await api.star(kind, target.id, true)
252
+ tree.adjustView('starred', 1)
253
+ await listing.load()
254
+ } catch (error) {
255
+ library.notifyFailure(error, 'dms_media.toasts.star_failed')
256
+ }
257
+ }
258
+
259
+ async function toggleStar(target: MediaAsset | MediaFolder, kind: 'asset' | 'folder'): Promise<void> {
260
+ const starred = !target.starred
261
+ patchStar(target, kind, starred)
262
+ try {
263
+ await api.star(kind, target.id, starred)
264
+ if (!starred && isStarredView()) leaveStarredView(target, kind)
265
+ } catch (error) {
266
+ patchStar(target, kind, !starred)
267
+ library.notifyFailure(error, 'dms_media.toasts.star_failed')
268
+ }
269
+ }
270
+
271
+ /** Stars every file, or removes their stars when they all have one. */
272
+ async function starAssets(assets: MediaAsset[]): Promise<void> {
273
+ const isEveryStarred = assets.every((asset) => asset.starred)
274
+ const targets = assets.filter((asset) => asset.starred === isEveryStarred)
275
+ await Promise.all(targets.map((asset) => toggleStar(asset, 'asset')))
276
+ }
277
+
278
+ return { toggleStar, starAssets }
279
+ }
280
+
281
+ /** Writes to the library, applied locally first and rolled back on failure. */
282
+ export function createLibraryActions(library: LibraryCore) {
283
+ const { api, listing, tree, selection } = library
284
+ const details = createDetailActions(library)
285
+ const assetLink = useAssetLink()
286
+ const isZipping = ref(false)
287
+
288
+ async function setAssetsVisibility(
289
+ assets: MediaAsset[],
290
+ visibility: AssetVisibility,
291
+ doneKey = 'dms_media.toasts.visibility_done',
292
+ ): Promise<void> {
293
+ try {
294
+ const result = splitGone(await api.setAssetsVisibility(assets.map((asset) => asset.id), visibility))
295
+ details.forgetGone(result.gone)
296
+ await listing.load()
297
+ reportOutcome(library, result.outcome, { doneKey })
298
+ } catch (error) {
299
+ library.notifyFailure(error, 'dms_media.toasts.visibility_failed')
300
+ }
301
+ }
302
+
303
+ async function deleteAssets(assets: MediaAsset[]): Promise<void> {
304
+ try {
305
+ const outcome = await api.deleteAssets(assets.map((asset) => asset.id))
306
+ const result = splitGone(outcome)
307
+ const removed = [...result.outcome.done, ...result.gone]
308
+ listing.removeAssets(removed)
309
+ selection.forget(removed)
310
+ removed.forEach((id) => library.previews.forget(id))
311
+ await tree.refresh()
312
+ reportOutcome(library, { done: removed, refused: result.outcome.refused }, { doneKey: 'dms_media.toasts.deleted' })
313
+ } catch (error) {
314
+ library.notifyFailure(error, 'dms_media.toasts.delete_failed')
315
+ }
316
+ }
317
+
318
+ async function zipInto(load: () => Promise<Blob>, name: string): Promise<void> {
319
+ if (isZipping.value) return
320
+ isZipping.value = true
321
+ try {
322
+ saveBlob(await load(), name)
323
+ } catch (error) {
324
+ library.notifyFailure(error, 'dms_media.toasts.zip_failed')
325
+ } finally {
326
+ isZipping.value = false
327
+ }
328
+ }
329
+
330
+ function downloadZip(assets: MediaAsset[]): Promise<void> {
331
+ const ids = assets.map((asset) => asset.id)
332
+ return zipInto(() => api.zip(ids), zipFileName(library.currentFolder.value?.name))
333
+ }
334
+
335
+ function downloadFolder(folder: MediaFolder): Promise<void> {
336
+ return zipInto(() => api.zipFolder(folder.id), zipFileName(folder.name))
337
+ }
338
+
339
+ /** Saves a file under its name; the storage's own link would only show it. */
340
+ async function downloadAsset(asset: MediaAsset): Promise<void> {
341
+ await assetLink.download(asset)
342
+ }
343
+
344
+ return {
345
+ renameAsset: details.renameAsset,
346
+ setAlt: details.setAlt,
347
+ setAssetsVisibility,
348
+ deleteAssets,
349
+ downloadZip,
350
+ downloadFolder,
351
+ downloadAsset,
352
+ isZipping: readonly(isZipping),
353
+ ...createMoveActions(library, details.forgetGone),
354
+ ...createStarActions(library),
355
+ ...createFolderActions(library),
356
+ }
357
+ }
358
+
359
+ function createFolderActions(library: LibraryCore) {
360
+ const { api, tree, t } = library
361
+
362
+ function failName(error: unknown, titleKey: string): NameOutcome {
363
+ const fieldError = nameFieldError(t, error)
364
+ if (!fieldError) library.notifyFailure(error, titleKey)
365
+ return { isDone: false, fieldError }
366
+ }
367
+
368
+ /** Creates a folder; a name already taken comes back as a field error. */
369
+ async function createFolder(name: string, parentId?: string): Promise<NameOutcome> {
370
+ try {
371
+ const { id } = await api.createFolder(name, parentId)
372
+ await tree.refresh()
373
+ library.toast.add({
374
+ title: t('dms_media.toasts.folder_created', { name }),
375
+ color: 'success',
376
+ icon: 'i-ph-folder-plus',
377
+ })
378
+ return { isDone: true, id }
379
+ } catch (error) {
380
+ return failName(error, 'dms_media.toasts.folder_create_failed')
381
+ }
382
+ }
383
+
384
+ async function renameFolder(folder: MediaFolder, name: string): Promise<NameOutcome> {
385
+ if (!name || name === folder.name) return { isDone: true }
386
+ try {
387
+ await api.renameFolder(folder.id, name)
388
+ tree.patchFolder(folder.id, { name })
389
+ return { isDone: true }
390
+ } catch (error) {
391
+ return failName(error, 'dms_media.toasts.rename_failed')
392
+ }
393
+ }
394
+
395
+ async function moveFolder(folder: MediaFolder, parentId: string | null): Promise<void> {
396
+ try {
397
+ await api.moveFolder(folder.id, parentId)
398
+ await tree.refresh()
399
+ library.toast.add({
400
+ title: t('dms_media.toasts.folder_moved', { name: folder.name }),
401
+ color: 'success',
402
+ })
403
+ } catch (error) {
404
+ library.notifyFailure(error, 'dms_media.toasts.move_failed')
405
+ }
406
+ }
407
+
408
+ async function deleteFolder(folder: MediaFolder): Promise<void> {
409
+ try {
410
+ await api.deleteFolder(folder.id)
411
+ if (library.currentFolder.value?.id === folder.id)
412
+ await library.openFolder(folder.parentId)
413
+ await tree.refresh()
414
+ library.toast.add({
415
+ title: t('dms_media.toasts.folder_deleted', { name: folder.name }),
416
+ color: 'success',
417
+ icon: 'i-ph-trash',
418
+ })
419
+ } catch (error) {
420
+ library.notifyFailure(error, 'dms_media.toasts.delete_failed')
421
+ }
422
+ }
423
+
424
+ async function setFolderVisibility(
425
+ folder: MediaFolder,
426
+ visibility: FolderVisibility,
427
+ ): Promise<void> {
428
+ tree.patchFolder(folder.id, { visibility })
429
+ try {
430
+ await api.setFolderVisibility(folder.id, visibility)
431
+ await library.listing.load()
432
+ library.toast.add({
433
+ title: t(`dms_media.toasts.folder_visibility.${visibility}`, { name: folder.name }),
434
+ color: 'success',
435
+ icon: VISIBILITY_ICONS[visibility],
436
+ })
437
+ } catch (error) {
438
+ tree.patchFolder(folder.id, { visibility: folder.visibility })
439
+ library.notifyFailure(error, 'dms_media.toasts.visibility_failed')
440
+ }
441
+ }
442
+
443
+ return { createFolder, renameFolder, moveFolder, deleteFolder, setFolderVisibility }
444
+ }
@@ -0,0 +1,137 @@
1
+ import type { MediaAsset, MediaFolder } from '../../types/media'
2
+ import type { MediaLibraryOptions } from '../../composables/library/useMediaLibrary'
3
+ import { type LibraryLocation, sameLocation } from '../../composables/library/useLibraryListing'
4
+
5
+ /** The explorer state and every action on the library, shared by its parts. */
6
+ export function createMediaLibrary(options: MediaLibraryOptions) {
7
+ const api = useMediaApi()
8
+ const { t } = useI18n()
9
+ const toast = useToast()
10
+ const { presentError } = useApiErrorPresenter()
11
+ const previews = useMediaPreviews()
12
+ const uploads = useUploadQueue()
13
+ const tree = useLibraryTree({ scopeFolderId: options.scopeFolderId })
14
+ const listing = useLibraryListing({
15
+ scopeFolderId: options.scopeFolderId,
16
+ tree,
17
+ initialLocation: options.initialLocation,
18
+ initialFilters: options.initialFilters,
19
+ })
20
+ const isPick = options.mode === 'pick'
21
+ const selection = useLibrarySelection(listing.assets, isPick)
22
+ const backStack = ref<LibraryLocation[]>([])
23
+ const forwardStack = ref<LibraryLocation[]>([])
24
+ const start = listing.location.value
25
+ const lastFolderId = ref<string | null>(start.kind === 'folder' ? start.folderId : null)
26
+ const beforeSearch = ref<LibraryLocation>(start.kind === 'search' ? { kind: 'root' } : start)
27
+ const accept = options.accept ?? []
28
+ const alreadyPicked = new Set(options.alreadyPicked ?? [])
29
+
30
+ const currentFolder = computed(() => {
31
+ const current = listing.location.value
32
+ return current.kind === 'folder'
33
+ ? tree.foldersById.value.get(current.folderId)
34
+ : undefined
35
+ })
36
+
37
+ const visibleFolders = computed<MediaFolder[]>(() => {
38
+ const current = listing.location.value
39
+ if (current.kind === 'root') return tree.childrenOf(null)
40
+ if (current.kind === 'folder') return tree.childrenOf(current.folderId)
41
+ return listing.extraFolders.value
42
+ })
43
+
44
+ const acceptedTypes = computed(() => fieldTypesLabel(accept, t))
45
+
46
+ /** Why a picker cannot take a file, or nothing when it can. */
47
+ function rejectionOf(asset: MediaAsset): string | undefined {
48
+ if (alreadyPicked.has(asset.id)) return t('dms_media.picker.already_added')
49
+ if (!acceptedTypes.value) return undefined
50
+ if (matchesUploadType(asset.mimetype, accept)) return undefined
51
+ return t('dms_media.picker.not_accepted', { types: acceptedTypes.value })
52
+ }
53
+
54
+ function notifyFailure(error: unknown, titleKey: string): void {
55
+ presentError(error, { fallbackKey: titleKey })
56
+ }
57
+
58
+ async function open(next: LibraryLocation, remember = true): Promise<void> {
59
+ if (remember && !sameLocation(next, listing.location.value)) {
60
+ backStack.value = [...backStack.value, listing.location.value]
61
+ forwardStack.value = []
62
+ }
63
+ if (!isPick) selection.clear()
64
+ if (next.kind !== 'search') beforeSearch.value = next
65
+ if (next.kind === 'folder') lastFolderId.value = next.folderId
66
+ if (next.kind === 'root') lastFolderId.value = null
67
+ await listing.setLocation(next)
68
+ }
69
+
70
+ function openFolder(folderId: string | null): Promise<void> {
71
+ return open(folderId ? { kind: 'folder', folderId } : { kind: 'root' })
72
+ }
73
+
74
+ const isSearching = computed(() => listing.location.value.kind === 'search')
75
+
76
+ async function back(): Promise<void> {
77
+ const current = listing.location.value
78
+ if (current.kind === 'search') {
79
+ forwardStack.value = [current, ...forwardStack.value]
80
+ return open(beforeSearch.value, false)
81
+ }
82
+ const previous = backStack.value.at(-1)
83
+ if (!previous) return
84
+ backStack.value = backStack.value.slice(0, -1)
85
+ forwardStack.value = [current, ...forwardStack.value]
86
+ await open(previous, false)
87
+ }
88
+
89
+ async function forward(): Promise<void> {
90
+ const next = forwardStack.value[0]
91
+ if (!next) return
92
+ forwardStack.value = forwardStack.value.slice(1)
93
+ if (!isSearching.value) backStack.value = [...backStack.value, listing.location.value]
94
+ await open(next, false)
95
+ }
96
+
97
+ function search(query: string, scopeId?: string): Promise<void> {
98
+ const trimmed = query.trim()
99
+ if (!trimmed) return clearSearch()
100
+ return open({ kind: 'search', query: trimmed, scopeId }, false)
101
+ }
102
+
103
+ function clearSearch(): Promise<void> {
104
+ return open(beforeSearch.value, false)
105
+ }
106
+
107
+ return {
108
+ mode: options.mode,
109
+ remaining: options.remaining,
110
+ accept,
111
+ acceptedTypesLabel: acceptedTypes,
112
+ rejectionOf,
113
+ api,
114
+ t,
115
+ toast,
116
+ previews,
117
+ uploads,
118
+ tree,
119
+ listing,
120
+ selection,
121
+ currentFolder,
122
+ visibleFolders,
123
+ lastFolderId,
124
+ canGoBack: computed(() => isSearching.value || backStack.value.length > 0),
125
+ canGoForward: computed(() => forwardStack.value.length > 0),
126
+ notifyFailure,
127
+ open,
128
+ openFolder,
129
+ back,
130
+ forward,
131
+ search,
132
+ clearSearch,
133
+ }
134
+ }
135
+
136
+ /** The explorer state a media library shares with its parts, before its actions. */
137
+ export type LibraryCore = ReturnType<typeof createMediaLibrary>
@@ -17,6 +17,7 @@ const STARTERS: StarterFolder[] = [
17
17
  const api = useMediaApi()
18
18
  const { t } = useI18n()
19
19
  const toast = useToast()
20
+ const { presentError } = useApiErrorPresenter()
20
21
  const { tree, ready } = useLibraryTree()
21
22
  const isCreating = ref(false)
22
23
  // Read with the page: a client navigation waits for the folders, so the welcome shows with it rather than after.
@@ -36,7 +37,7 @@ async function createStarters(): Promise<void> {
36
37
  toast.add({ title: t('dms_media.first_run.created'), color: 'success', icon: 'i-ph-folders' })
37
38
  await navigateDms(MEDIA_ROUTES.files)
38
39
  } catch (error) {
39
- useApiError(error, { title: t('dms_media.toasts.folder_create_failed') })
40
+ presentError(error, { fallbackKey: 'dms_media.toasts.folder_create_failed' })
40
41
  } finally {
41
42
  isCreating.value = false
42
43
  }