@antelopejs/dms-media 0.6.0 → 0.6.2

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 (238) 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/db/models/mediaFolders.model.d.ts +0 -3
  7. package/dist/db/models/mediaFolders.model.js +0 -29
  8. package/dist/db/models/mediaFolders.model.js.map +1 -1
  9. package/dist/db/tables/mediaDeclarations.table.d.ts +0 -4
  10. package/dist/db/tables/mediaDeclarations.table.js +0 -16
  11. package/dist/db/tables/mediaDeclarations.table.js.map +1 -1
  12. package/dist/declared/assets.d.ts +0 -2
  13. package/dist/declared/assets.js +12 -140
  14. package/dist/declared/assets.js.map +1 -1
  15. package/dist/declared/folders.d.ts +1 -5
  16. package/dist/declared/folders.js +17 -82
  17. package/dist/declared/folders.js.map +1 -1
  18. package/dist/declared/index.d.ts +0 -2
  19. package/dist/declared/index.js +0 -2
  20. package/dist/declared/index.js.map +1 -1
  21. package/dist/declared/records.d.ts +4 -32
  22. package/dist/declared/records.js +6 -35
  23. package/dist/declared/records.js.map +1 -1
  24. package/dist/derivatives.js +14 -23
  25. package/dist/derivatives.js.map +1 -1
  26. package/dist/guards.d.ts +4 -0
  27. package/dist/guards.js +19 -0
  28. package/dist/guards.js.map +1 -0
  29. package/dist/implementations/interface-dms-media/index.d.ts +1 -3
  30. package/dist/implementations/interface-dms-media/index.js +0 -2
  31. package/dist/implementations/interface-dms-media/index.js.map +1 -1
  32. package/dist/library/activity.js +7 -5
  33. package/dist/library/activity.js.map +1 -1
  34. package/dist/library/batches.js +6 -3
  35. package/dist/library/batches.js.map +1 -1
  36. package/dist/library/events.js +4 -4
  37. package/dist/library/events.js.map +1 -1
  38. package/dist/library/module-readout.js +5 -2
  39. package/dist/library/module-readout.js.map +1 -1
  40. package/dist/library/realtime.js.map +1 -1
  41. package/dist/pages/activity.js +1 -1
  42. package/dist/pages/activity.js.map +1 -1
  43. package/dist/routes/media/assets.d.ts +1 -1
  44. package/dist/routes/media/assets.js +5 -5
  45. package/dist/routes/media/assets.js.map +1 -1
  46. package/dist/routes/media/bulk.js +17 -13
  47. package/dist/routes/media/bulk.js.map +1 -1
  48. package/dist/routes/media/delivery-headers.js +9 -9
  49. package/dist/routes/media/delivery-headers.js.map +1 -1
  50. package/dist/routes/media/delivery-stream.js +7 -21
  51. package/dist/routes/media/delivery-stream.js.map +1 -1
  52. package/dist/routes/media/delivery.js.map +1 -1
  53. package/dist/routes/media/manage.js.map +1 -1
  54. package/dist/routes/media/transform.js +13 -8
  55. package/dist/routes/media/transform.js.map +1 -1
  56. package/dist/routes/media/upload.js +2 -5
  57. package/dist/routes/media/upload.js.map +1 -1
  58. package/dist/test/antelope.test.js +17 -16
  59. package/dist/test/antelope.test.js.map +1 -1
  60. package/dist/test/helpers/folders.d.ts +27 -0
  61. package/dist/test/helpers/folders.js +15 -0
  62. package/dist/test/helpers/folders.js.map +1 -1
  63. package/dist/test/helpers/pages.js +10 -6
  64. package/dist/test/helpers/pages.js.map +1 -1
  65. package/dist/test/helpers/permissions-world.d.ts +98 -0
  66. package/dist/test/helpers/permissions-world.js +205 -0
  67. package/dist/test/helpers/permissions-world.js.map +1 -0
  68. package/dist/test/helpers/prototype.d.ts +1 -0
  69. package/dist/test/helpers/prototype.js +11 -0
  70. package/dist/test/helpers/prototype.js.map +1 -0
  71. package/dist/test/integration/derivative-sweep-query.test.js +13 -16
  72. package/dist/test/integration/derivative-sweep-query.test.js.map +1 -1
  73. package/dist/test/integration/folder-query.test.js +5 -9
  74. package/dist/test/integration/folder-query.test.js.map +1 -1
  75. package/dist/test/integration/media-bindings.test.js +2 -2
  76. package/dist/test/integration/media-bindings.test.js.map +1 -1
  77. package/dist/test/integration/media-cleanup.test.js +14 -17
  78. package/dist/test/integration/media-cleanup.test.js.map +1 -1
  79. package/dist/test/integration/media-declared-content.test.js +19 -318
  80. package/dist/test/integration/media-declared-content.test.js.map +1 -1
  81. package/dist/test/integration/media-delivery-editing.test.js +7 -5
  82. package/dist/test/integration/media-delivery-editing.test.js.map +1 -1
  83. package/dist/test/integration/media-delivery.test.js +19 -5
  84. package/dist/test/integration/media-delivery.test.js.map +1 -1
  85. package/dist/test/integration/media-explorer-writes.test.js +2 -2
  86. package/dist/test/integration/media-explorer-writes.test.js.map +1 -1
  87. package/dist/test/integration/media-guards.test.js +18 -7
  88. package/dist/test/integration/media-guards.test.js.map +1 -1
  89. package/dist/test/integration/media-library.test.js +1 -1
  90. package/dist/test/integration/media-library.test.js.map +1 -1
  91. package/dist/test/integration/media-linked-subfolders.test.js +6 -6
  92. package/dist/test/integration/media-linked-subfolders.test.js.map +1 -1
  93. package/dist/test/integration/media-member-access.test.js +2 -5
  94. package/dist/test/integration/media-member-access.test.js.map +1 -1
  95. package/dist/test/integration/media-permissions.test.js +142 -473
  96. package/dist/test/integration/media-permissions.test.js.map +1 -1
  97. package/dist/test/integration/media-project-field.test.js +3 -5
  98. package/dist/test/integration/media-project-field.test.js.map +1 -1
  99. package/dist/test/integration/media-search-query.test.js +11 -16
  100. package/dist/test/integration/media-search-query.test.js.map +1 -1
  101. package/dist/test/integration/media-storage-origin-unreachable.test.js +80 -0
  102. package/dist/test/integration/media-storage-origin-unreachable.test.js.map +1 -0
  103. package/dist/test/integration/media-upload-policy.test.js +2 -2
  104. package/dist/test/integration/media-upload-policy.test.js.map +1 -1
  105. package/dist/test/integration/permissions-management.d.ts +2 -0
  106. package/dist/test/integration/permissions-management.js +189 -0
  107. package/dist/test/integration/permissions-management.js.map +1 -0
  108. package/dist/test/unit/acl/entries.test.js +2 -1
  109. package/dist/test/unit/acl/entries.test.js.map +1 -1
  110. package/dist/test/unit/acl/resolver.test.js +10 -3
  111. package/dist/test/unit/acl/resolver.test.js.map +1 -1
  112. package/dist/test/unit/declared.test.js +0 -66
  113. package/dist/test/unit/declared.test.js.map +1 -1
  114. package/dist/test/unit/library/fixtures.d.ts +1 -1
  115. package/dist/test/unit/library/fixtures.js +6 -1
  116. package/dist/test/unit/library/fixtures.js.map +1 -1
  117. package/dist/test/unit/library/library.test.js +0 -1
  118. package/dist/test/unit/library/library.test.js.map +1 -1
  119. package/dist/test/unit/library/realtime.test.js +1 -0
  120. package/dist/test/unit/library/realtime.test.js.map +1 -1
  121. package/dist/test/unit/library/search-facets.test.js +2 -2
  122. package/dist/test/unit/library/search-facets.test.js.map +1 -1
  123. package/dist/test/unit/pages/toolbar.test.js +24 -7
  124. package/dist/test/unit/pages/toolbar.test.js.map +1 -1
  125. package/dist/test/unit/routes/dto.test.js +7 -6
  126. package/dist/test/unit/routes/dto.test.js.map +1 -1
  127. package/dist/test/unit/routes/file-page.test.js +5 -7
  128. package/dist/test/unit/routes/file-page.test.js.map +1 -1
  129. package/dist/test/unit/routes/preset-row.test.js +2 -1
  130. package/dist/test/unit/routes/preset-row.test.js.map +1 -1
  131. package/dist/transform.js +6 -6
  132. package/dist/transform.js.map +1 -1
  133. package/dist/upload-checks.d.ts +8 -2
  134. package/dist/upload-checks.js.map +1 -1
  135. package/dist/upload-policy.js +8 -8
  136. package/dist/upload-policy.js.map +1 -1
  137. package/dist/validation/declared.schema.d.ts +7 -36
  138. package/dist/validation/declared.schema.js +15 -20
  139. package/dist/validation/declared.schema.js.map +1 -1
  140. package/dist/validation/media.schema.d.ts +1 -1
  141. package/dist/validation/media.schema.js +2 -2
  142. package/dist/validation/media.schema.js.map +1 -1
  143. package/frontend-vue/app/build/imageEditor/editorShapes.ts +118 -0
  144. package/frontend-vue/app/build/imageEditor/useEditorSaving.ts +86 -0
  145. package/frontend-vue/app/build/library/libraryActions.ts +444 -0
  146. package/frontend-vue/app/build/library/libraryCore.ts +136 -0
  147. package/frontend-vue/app/components/ImageEditor.vue +22 -179
  148. package/frontend-vue/app/composables/library/useMediaLibrary.ts +3 -575
  149. package/frontend-vue/app/composables/useMediaApi.ts +21 -5
  150. package/frontend-vue/build/backend-boundary.ts +122 -0
  151. package/frontend-vue/dms.frontend.build.ts +3 -0
  152. package/frontend-vue/eslint.config.mjs +13 -0
  153. package/frontend-vue/package.json +3 -1
  154. package/frontend-vue/pnpm-lock.yaml +217 -61
  155. package/frontend-vue/tests/backend-boundary.test.ts +203 -0
  156. package/frontend-vue/tests/mediaPreviews.test.ts +39 -0
  157. package/package.json +10 -16
  158. package/skills/dms-media/SKILL.md +12 -24
  159. package/skills/dms-media/cases.json +38 -0
  160. package/src/acl/entries.ts +6 -4
  161. package/src/bindings.ts +3 -3
  162. package/src/db/models/mediaFolders.model.ts +0 -44
  163. package/src/db/tables/mediaDeclarations.table.ts +3 -19
  164. package/src/declared/assets.ts +19 -210
  165. package/src/declared/folders.ts +25 -138
  166. package/src/declared/index.ts +0 -2
  167. package/src/declared/records.ts +17 -90
  168. package/src/derivatives.ts +17 -23
  169. package/src/guards.ts +19 -0
  170. package/src/implementations/interface-dms-media/index.ts +1 -8
  171. package/src/library/activity.ts +17 -9
  172. package/src/library/batches.ts +12 -9
  173. package/src/library/events.ts +7 -4
  174. package/src/library/module-readout.ts +6 -2
  175. package/src/library/realtime.ts +5 -1
  176. package/src/library/zip.ts +1 -1
  177. package/src/pages/activity.ts +6 -2
  178. package/src/routes/media/assets.ts +4 -3
  179. package/src/routes/media/bulk.ts +16 -14
  180. package/src/routes/media/delivery-headers.ts +9 -12
  181. package/src/routes/media/delivery-stream.ts +13 -28
  182. package/src/routes/media/delivery.ts +4 -2
  183. package/src/routes/media/manage.ts +4 -6
  184. package/src/routes/media/transform.ts +27 -23
  185. package/src/routes/media/upload.ts +4 -6
  186. package/src/test/antelope.test.ts +25 -21
  187. package/src/test/helpers/folders.ts +22 -0
  188. package/src/test/helpers/pages.ts +12 -5
  189. package/src/test/helpers/permissions-world.ts +326 -0
  190. package/src/test/helpers/prototype.ts +12 -0
  191. package/src/test/integration/derivative-sweep-query.test.ts +19 -21
  192. package/src/test/integration/folder-query.test.ts +11 -11
  193. package/src/test/integration/media-bindings.test.ts +7 -7
  194. package/src/test/integration/media-cleanup.test.ts +25 -37
  195. package/src/test/integration/media-declared-content.test.ts +35 -379
  196. package/src/test/integration/media-delivery-editing.test.ts +11 -7
  197. package/src/test/integration/media-delivery.test.ts +29 -8
  198. package/src/test/integration/media-explorer-writes.test.ts +2 -7
  199. package/src/test/integration/media-guards.test.ts +21 -7
  200. package/src/test/integration/media-library.test.ts +1 -1
  201. package/src/test/integration/media-linked-subfolders.test.ts +12 -21
  202. package/src/test/integration/media-member-access.test.ts +5 -9
  203. package/src/test/integration/media-permissions.test.ts +56 -570
  204. package/src/test/integration/media-project-field.test.ts +5 -7
  205. package/src/test/integration/media-search-query.test.ts +16 -20
  206. package/src/test/integration/media-storage-origin-unreachable.test.ts +111 -0
  207. package/src/test/integration/media-upload-policy.test.ts +2 -8
  208. package/src/test/integration/permissions-management.ts +292 -0
  209. package/src/test/unit/acl/entries.test.ts +2 -1
  210. package/src/test/unit/acl/resolver.test.ts +19 -7
  211. package/src/test/unit/declared.test.ts +0 -87
  212. package/src/test/unit/library/fixtures.ts +9 -3
  213. package/src/test/unit/library/library.test.ts +1 -7
  214. package/src/test/unit/library/realtime.test.ts +2 -0
  215. package/src/test/unit/library/search-facets.test.ts +2 -2
  216. package/src/test/unit/pages/toolbar.test.ts +42 -17
  217. package/src/test/unit/routes/dto.test.ts +7 -6
  218. package/src/test/unit/routes/file-page.test.ts +10 -9
  219. package/src/test/unit/routes/preset-row.test.ts +2 -2
  220. package/src/transform.ts +6 -6
  221. package/src/upload-checks.ts +12 -3
  222. package/src/upload-policy.ts +8 -8
  223. package/src/validation/declared.schema.ts +17 -25
  224. package/src/validation/media.schema.ts +6 -6
  225. package/dist/declared/readiness.d.ts +0 -2
  226. package/dist/declared/readiness.js +0 -52
  227. package/dist/declared/readiness.js.map +0 -1
  228. package/dist/declared/retire.d.ts +0 -3
  229. package/dist/declared/retire.js +0 -118
  230. package/dist/declared/retire.js.map +0 -1
  231. package/dist/test/integration/media-declared-retire.test.js +0 -186
  232. package/dist/test/integration/media-declared-retire.test.js.map +0 -1
  233. package/frontend-vue/tests/engines.test.ts +0 -20
  234. package/frontend-vue/tests/locales.test.ts +0 -61
  235. package/src/declared/readiness.ts +0 -64
  236. package/src/declared/retire.ts +0 -206
  237. package/src/test/integration/media-declared-retire.test.ts +0 -257
  238. /package/dist/test/integration/{media-declared-retire.test.d.ts → media-storage-origin-unreachable.test.d.ts} +0 -0
@@ -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,136 @@
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 previews = useMediaPreviews()
11
+ const uploads = useUploadQueue()
12
+ const tree = useLibraryTree({ scopeFolderId: options.scopeFolderId })
13
+ const listing = useLibraryListing({
14
+ scopeFolderId: options.scopeFolderId,
15
+ tree,
16
+ initialLocation: options.initialLocation,
17
+ initialFilters: options.initialFilters,
18
+ })
19
+ const isPick = options.mode === 'pick'
20
+ const selection = useLibrarySelection(listing.assets, isPick)
21
+ const backStack = ref<LibraryLocation[]>([])
22
+ const forwardStack = ref<LibraryLocation[]>([])
23
+ const start = listing.location.value
24
+ const lastFolderId = ref<string | null>(start.kind === 'folder' ? start.folderId : null)
25
+ const beforeSearch = ref<LibraryLocation>(start.kind === 'search' ? { kind: 'root' } : start)
26
+ const accept = options.accept ?? []
27
+ const alreadyPicked = new Set(options.alreadyPicked ?? [])
28
+
29
+ const currentFolder = computed(() => {
30
+ const current = listing.location.value
31
+ return current.kind === 'folder'
32
+ ? tree.foldersById.value.get(current.folderId)
33
+ : undefined
34
+ })
35
+
36
+ const visibleFolders = computed<MediaFolder[]>(() => {
37
+ const current = listing.location.value
38
+ if (current.kind === 'root') return tree.childrenOf(null)
39
+ if (current.kind === 'folder') return tree.childrenOf(current.folderId)
40
+ return listing.extraFolders.value
41
+ })
42
+
43
+ const acceptedTypes = computed(() => fieldTypesLabel(accept, t))
44
+
45
+ /** Why a picker cannot take a file, or nothing when it can. */
46
+ function rejectionOf(asset: MediaAsset): string | undefined {
47
+ if (alreadyPicked.has(asset.id)) return t('dms_media.picker.already_added')
48
+ if (!acceptedTypes.value) return undefined
49
+ if (matchesUploadType(asset.mimetype, accept)) return undefined
50
+ return t('dms_media.picker.not_accepted', { types: acceptedTypes.value })
51
+ }
52
+
53
+ function notifyFailure(error: unknown, titleKey: string): void {
54
+ useApiError(error, { title: t(titleKey) })
55
+ }
56
+
57
+ async function open(next: LibraryLocation, remember = true): Promise<void> {
58
+ if (remember && !sameLocation(next, listing.location.value)) {
59
+ backStack.value = [...backStack.value, listing.location.value]
60
+ forwardStack.value = []
61
+ }
62
+ if (!isPick) selection.clear()
63
+ if (next.kind !== 'search') beforeSearch.value = next
64
+ if (next.kind === 'folder') lastFolderId.value = next.folderId
65
+ if (next.kind === 'root') lastFolderId.value = null
66
+ await listing.setLocation(next)
67
+ }
68
+
69
+ function openFolder(folderId: string | null): Promise<void> {
70
+ return open(folderId ? { kind: 'folder', folderId } : { kind: 'root' })
71
+ }
72
+
73
+ const isSearching = computed(() => listing.location.value.kind === 'search')
74
+
75
+ async function back(): Promise<void> {
76
+ const current = listing.location.value
77
+ if (current.kind === 'search') {
78
+ forwardStack.value = [current, ...forwardStack.value]
79
+ return open(beforeSearch.value, false)
80
+ }
81
+ const previous = backStack.value.at(-1)
82
+ if (!previous) return
83
+ backStack.value = backStack.value.slice(0, -1)
84
+ forwardStack.value = [current, ...forwardStack.value]
85
+ await open(previous, false)
86
+ }
87
+
88
+ async function forward(): Promise<void> {
89
+ const next = forwardStack.value[0]
90
+ if (!next) return
91
+ forwardStack.value = forwardStack.value.slice(1)
92
+ if (!isSearching.value) backStack.value = [...backStack.value, listing.location.value]
93
+ await open(next, false)
94
+ }
95
+
96
+ function search(query: string, scopeId?: string): Promise<void> {
97
+ const trimmed = query.trim()
98
+ if (!trimmed) return clearSearch()
99
+ return open({ kind: 'search', query: trimmed, scopeId }, false)
100
+ }
101
+
102
+ function clearSearch(): Promise<void> {
103
+ return open(beforeSearch.value, false)
104
+ }
105
+
106
+ return {
107
+ mode: options.mode,
108
+ remaining: options.remaining,
109
+ accept,
110
+ acceptedTypesLabel: acceptedTypes,
111
+ rejectionOf,
112
+ api,
113
+ t,
114
+ toast,
115
+ previews,
116
+ uploads,
117
+ tree,
118
+ listing,
119
+ selection,
120
+ currentFolder,
121
+ visibleFolders,
122
+ lastFolderId,
123
+ canGoBack: computed(() => isSearching.value || backStack.value.length > 0),
124
+ canGoForward: computed(() => forwardStack.value.length > 0),
125
+ notifyFailure,
126
+ open,
127
+ openFolder,
128
+ back,
129
+ forward,
130
+ search,
131
+ clearSearch,
132
+ }
133
+ }
134
+
135
+ /** The explorer state a media library shares with its parts, before its actions. */
136
+ export type LibraryCore = ReturnType<typeof createMediaLibrary>