@antelopejs/dms-media 0.7.3 → 0.8.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 (141) hide show
  1. package/README.md +10 -10
  2. package/dist/acl/entries.js +20 -2
  3. package/dist/acl/entries.js.map +1 -1
  4. package/dist/asset-lifecycle.js +5 -1
  5. package/dist/asset-lifecycle.js.map +1 -1
  6. package/dist/bindings.d.ts +1 -0
  7. package/dist/bindings.js +36 -25
  8. package/dist/bindings.js.map +1 -1
  9. package/dist/db/models/mediaAssets.model.d.ts +3 -3
  10. package/dist/db/models/mediaDeclarations.model.d.ts +3 -3
  11. package/dist/db/models/mediaEvents.model.d.ts +3 -3
  12. package/dist/db/models/mediaFavorites.model.d.ts +3 -3
  13. package/dist/db/models/mediaFolders.model.d.ts +3 -3
  14. package/dist/db/models/mediaUploads.model.d.ts +3 -3
  15. package/dist/declared/assets.js +39 -25
  16. package/dist/declared/assets.js.map +1 -1
  17. package/dist/declared/folders.js +27 -14
  18. package/dist/declared/folders.js.map +1 -1
  19. package/dist/declared/records.d.ts +1 -0
  20. package/dist/declared/records.js +18 -1
  21. package/dist/declared/records.js.map +1 -1
  22. package/dist/fixed-id.d.ts +1 -0
  23. package/dist/fixed-id.js +16 -0
  24. package/dist/fixed-id.js.map +1 -0
  25. package/dist/routes/media/assets.d.ts +3 -2
  26. package/dist/routes/media/assets.js +11 -6
  27. package/dist/routes/media/assets.js.map +1 -1
  28. package/dist/routes/media/storage-keys.js +10 -1
  29. package/dist/routes/media/storage-keys.js.map +1 -1
  30. package/dist/test/helpers/assets.d.ts +2 -2
  31. package/dist/test/helpers/folders.d.ts +6 -6
  32. package/dist/test/helpers/permissions-world.d.ts +6 -6
  33. package/dist/test/integration/binding-folder-race.test.d.ts +1 -0
  34. package/dist/test/integration/binding-folder-race.test.js +66 -0
  35. package/dist/test/integration/binding-folder-race.test.js.map +1 -0
  36. package/dist/test/integration/declared-asset-race.test.d.ts +1 -0
  37. package/dist/test/integration/declared-asset-race.test.js +78 -0
  38. package/dist/test/integration/declared-asset-race.test.js.map +1 -0
  39. package/dist/test/integration/declared-folder-race.test.d.ts +1 -0
  40. package/dist/test/integration/declared-folder-race.test.js +43 -0
  41. package/dist/test/integration/declared-folder-race.test.js.map +1 -0
  42. package/dist/test/integration/media-activity-overview.test.js +27 -22
  43. package/dist/test/integration/media-activity-overview.test.js.map +1 -1
  44. package/dist/test/integration/media-api.test.js +9 -5
  45. package/dist/test/integration/media-api.test.js.map +1 -1
  46. package/dist/test/integration/media-bindings.test.js +16 -13
  47. package/dist/test/integration/media-bindings.test.js.map +1 -1
  48. package/dist/test/integration/media-cleanup.test.js +14 -5
  49. package/dist/test/integration/media-cleanup.test.js.map +1 -1
  50. package/dist/test/integration/media-declared-content.test.js +107 -91
  51. package/dist/test/integration/media-declared-content.test.js.map +1 -1
  52. package/dist/test/integration/media-delivery-editing.test.js +238 -215
  53. package/dist/test/integration/media-delivery-editing.test.js.map +1 -1
  54. package/dist/test/integration/media-explorer-writes.test.js +131 -112
  55. package/dist/test/integration/media-explorer-writes.test.js.map +1 -1
  56. package/dist/test/integration/media-guards.test.js +38 -37
  57. package/dist/test/integration/media-guards.test.js.map +1 -1
  58. package/dist/test/integration/media-library.test.js +244 -224
  59. package/dist/test/integration/media-library.test.js.map +1 -1
  60. package/dist/test/integration/media-linked-subfolders.test.js +173 -158
  61. package/dist/test/integration/media-linked-subfolders.test.js.map +1 -1
  62. package/dist/test/integration/media-permissions.test.js +31 -11
  63. package/dist/test/integration/media-permissions.test.js.map +1 -1
  64. package/dist/test/integration/media-search-query.test.js +8 -6
  65. package/dist/test/integration/media-search-query.test.js.map +1 -1
  66. package/dist/test/integration/media-search-views.test.js +12 -8
  67. package/dist/test/integration/media-search-views.test.js.map +1 -1
  68. package/dist/test/integration/media-upload-policy.test.js +228 -200
  69. package/dist/test/integration/media-upload-policy.test.js.map +1 -1
  70. package/dist/test/stack-modules.json +5 -5
  71. package/dist/test/unit/acl/entries.test.js +19 -0
  72. package/dist/test/unit/acl/entries.test.js.map +1 -1
  73. package/dist/test/unit/acl/resolver.test.js +9 -1
  74. package/dist/test/unit/acl/resolver.test.js.map +1 -1
  75. package/dist/test/unit/asset-lifecycle.test.d.ts +1 -0
  76. package/dist/test/unit/asset-lifecycle.test.js +18 -0
  77. package/dist/test/unit/asset-lifecycle.test.js.map +1 -0
  78. package/dist/test/unit/routes/storage-keys.test.d.ts +1 -0
  79. package/dist/test/unit/routes/storage-keys.test.js +18 -0
  80. package/dist/test/unit/routes/storage-keys.test.js.map +1 -0
  81. package/dist/test/unit/transform-ops.test.js +19 -0
  82. package/dist/test/unit/transform-ops.test.js.map +1 -1
  83. package/dist/transform-ops.js +25 -1
  84. package/dist/transform-ops.js.map +1 -1
  85. package/dist/validation/declared.schema.d.ts +6 -6
  86. package/dist/validation/library.schema.d.ts +4 -4
  87. package/dist/validation/media.schema.d.ts +4 -4
  88. package/frontend-vue/app/components/Explorer.vue +2 -0
  89. package/frontend-vue/app/components/FileProperties.vue +1 -1
  90. package/frontend-vue/app/components/ImageEditor.vue +5 -5
  91. package/frontend-vue/app/components/RecentFiles.vue +2 -2
  92. package/frontend-vue/app/components/UploadQueue.vue +4 -4
  93. package/frontend-vue/app/components/dialogs/DeleteFilesDialog.vue +1 -1
  94. package/frontend-vue/app/components/dialogs/ShortcutsDialog.vue +1 -1
  95. package/frontend-vue/app/components/dialogs/VisibilityDialog.vue +1 -1
  96. package/frontend-vue/app/components/explorer/ExplorerInspector.vue +1 -1
  97. package/frontend-vue/app/components/explorer/ExplorerSidebar.vue +2 -2
  98. package/frontend-vue/app/components/explorer/FolderStrip.vue +1 -1
  99. package/frontend-vue/app/components/explorer/GridView.vue +1 -1
  100. package/frontend-vue/app/components/shared/AltTextField.vue +2 -2
  101. package/frontend-vue/build/backend-boundary.ts +8 -3
  102. package/frontend-vue/eslint.config.mjs +0 -1
  103. package/frontend-vue/package.json +2 -2
  104. package/frontend-vue/pnpm-lock.yaml +45 -14
  105. package/frontend-vue/tests/backend-boundary.test.ts +6 -4
  106. package/frontend-vue/tests/fixtures/serverRender.ts +3 -3
  107. package/frontend-vue/tests/registration.test.ts +5 -0
  108. package/package.json +15 -15
  109. package/src/acl/entries.ts +30 -7
  110. package/src/asset-lifecycle.ts +6 -2
  111. package/src/bindings.ts +41 -38
  112. package/src/declared/assets.ts +45 -28
  113. package/src/declared/folders.ts +30 -21
  114. package/src/declared/records.ts +31 -2
  115. package/src/fixed-id.ts +18 -0
  116. package/src/routes/media/assets.ts +14 -6
  117. package/src/routes/media/storage-keys.ts +14 -2
  118. package/src/test/integration/binding-folder-race.test.ts +82 -0
  119. package/src/test/integration/declared-asset-race.test.ts +115 -0
  120. package/src/test/integration/declared-folder-race.test.ts +50 -0
  121. package/src/test/integration/media-activity-overview.test.ts +40 -27
  122. package/src/test/integration/media-api.test.ts +9 -5
  123. package/src/test/integration/media-bindings.test.ts +17 -13
  124. package/src/test/integration/media-cleanup.test.ts +17 -5
  125. package/src/test/integration/media-declared-content.test.ts +129 -112
  126. package/src/test/integration/media-delivery-editing.test.ts +323 -299
  127. package/src/test/integration/media-explorer-writes.test.ts +161 -135
  128. package/src/test/integration/media-guards.test.ts +40 -38
  129. package/src/test/integration/media-library.test.ts +325 -296
  130. package/src/test/integration/media-linked-subfolders.test.ts +207 -186
  131. package/src/test/integration/media-permissions.test.ts +33 -14
  132. package/src/test/integration/media-search-query.test.ts +24 -8
  133. package/src/test/integration/media-search-views.test.ts +39 -32
  134. package/src/test/integration/media-upload-policy.test.ts +283 -254
  135. package/src/test/stack-modules.json +5 -5
  136. package/src/test/unit/acl/entries.test.ts +23 -0
  137. package/src/test/unit/acl/resolver.test.ts +9 -1
  138. package/src/test/unit/asset-lifecycle.test.ts +21 -0
  139. package/src/test/unit/routes/storage-keys.test.ts +23 -0
  140. package/src/test/unit/transform-ops.test.ts +29 -1
  141. package/src/transform-ops.ts +32 -2
@@ -84,209 +84,230 @@ async function removeLinkedFolders(): Promise<void> {
84
84
  if (children.length === 0) await folderModel.delete(contentRoot._id);
85
85
  }
86
86
 
87
- describe("[integration] media linked subfolders — bindings that allow them", () => {
88
- let client: AxiosInstance;
87
+ let client: AxiosInstance;
89
88
 
90
- async function treeFolder(binding: string): Promise<FolderNode> {
91
- const folder = (await fetchFolderNodes(client)).find(
92
- (entry) => entry.binding === binding,
93
- );
94
- if (!folder) throw new Error(`No folder linked to ${binding}`);
95
- return folder;
96
- }
89
+ async function treeFolder(binding: string): Promise<FolderNode> {
90
+ const folder = (await fetchFolderNodes(client)).find(
91
+ (entry) => entry.binding === binding,
92
+ );
93
+ if (!folder) throw new Error(`No folder linked to ${binding}`);
94
+ return folder;
95
+ }
97
96
 
98
- before(async () => {
99
- RegisterAssetBinding({
100
- id: OPEN_BINDING_ID,
101
- folderName: "Project photos",
102
- subfolders: true,
103
- field: { mimetypes: ["image/*"] },
97
+ function describeSubfolderCreation(): void {
98
+ describe("subfolders of a linked folder", () => {
99
+ it("tells the explorer which linked folders take subfolders", async () => {
100
+ expect((await treeFolder(OPEN_BINDING_ID)).acceptsSubfolders).to.equal(
101
+ true,
102
+ );
103
+ expect((await treeFolder(LOCKED_BINDING_ID)).acceptsSubfolders).to.equal(
104
+ false,
105
+ );
106
+ expect(
107
+ (await treeFolder(CONTENT_ROOT_BINDING)).acceptsSubfolders,
108
+ ).to.equal(false);
104
109
  });
105
- RegisterAssetBinding({ id: LOCKED_BINDING_ID, folderName: "Locked" });
106
- client = authorizedClient((await ensureOwnerSession()).accessToken);
107
- });
108
-
109
- after(async () => {
110
- UnregisterAssetBinding(OPEN_BINDING_ID);
111
- UnregisterAssetBinding(LOCKED_BINDING_ID);
112
- await removeLinkedFolders();
113
- });
114
-
115
- it("tells the explorer which linked folders take subfolders", async () => {
116
- expect((await treeFolder(OPEN_BINDING_ID)).acceptsSubfolders).to.equal(
117
- true,
118
- );
119
- expect((await treeFolder(LOCKED_BINDING_ID)).acceptsSubfolders).to.equal(
120
- false,
121
- );
122
- expect((await treeFolder(CONTENT_ROOT_BINDING)).acceptsSubfolders).to.equal(
123
- false,
124
- );
125
- });
126
110
 
127
- it("lets an owner create a subfolder where the binding allows it, and keeps the linked folder locked", async () => {
128
- const linked = await treeFolder(OPEN_BINDING_ID);
129
- const created = await client.post("/api/media/folders", {
130
- name: "Project A",
131
- parentId: linked.id,
132
- });
133
- expect(created.status).to.equal(HTTP_OK);
134
- const locked = await treeFolder(LOCKED_BINDING_ID);
135
- const refused = await client.post("/api/media/folders", {
136
- name: "Project A",
137
- parentId: locked.id,
111
+ it("lets an owner create a subfolder where the binding allows it, and keeps the linked folder locked", async () => {
112
+ const linked = await treeFolder(OPEN_BINDING_ID);
113
+ const created = await client.post("/api/media/folders", {
114
+ name: "Project A",
115
+ parentId: linked.id,
116
+ });
117
+ expect(created.status).to.equal(HTTP_OK);
118
+ const locked = await treeFolder(LOCKED_BINDING_ID);
119
+ const refused = await client.post("/api/media/folders", {
120
+ name: "Project A",
121
+ parentId: locked.id,
122
+ });
123
+ expect(refused.status).to.equal(HTTP_FORBIDDEN);
124
+ expect(refused.data).to.equal(`${ERRORS}.bound_parent`);
125
+ const rename = await client.post(
126
+ `/api/media/folders/${linked.id}/rename`,
127
+ {
128
+ name: "Renamed",
129
+ },
130
+ );
131
+ expect(rename.status).to.equal(HTTP_FORBIDDEN);
132
+ const subfolder = (await fetchFolderNodes(client)).find(
133
+ (folder) => folder.id === created.data.id,
134
+ );
135
+ expect(subfolder?.acceptsSubfolders).to.equal(true);
136
+ expect(subfolder?.accepts).to.deep.equal(["image/*"]);
138
137
  });
139
- expect(refused.status).to.equal(HTTP_FORBIDDEN);
140
- expect(refused.data).to.equal(`${ERRORS}.bound_parent`);
141
- const rename = await client.post(`/api/media/folders/${linked.id}/rename`, {
142
- name: "Renamed",
138
+
139
+ it("applies the field's types to uploads into a subfolder", async () => {
140
+ const linked = await treeFolder(OPEN_BINDING_ID);
141
+ const created = await client.post("/api/media/folders", {
142
+ name: "Project B",
143
+ parentId: linked.id,
144
+ });
145
+ const nested = await client.post("/api/media/folders", {
146
+ name: "Roof",
147
+ parentId: readBody(created, createdBody).id,
148
+ });
149
+ const presign = (filename: string, mimetype: string) =>
150
+ client.post("/api/media/upload/presign", {
151
+ folderId: readBody(nested, createdBody).id,
152
+ filename,
153
+ size: 4,
154
+ mimetype,
155
+ });
156
+ const text = await presign("notes.txt", "text/plain");
157
+ expect(text.status).to.equal(HTTP_UNSUPPORTED_MEDIA_TYPE);
158
+ expect(text.data.reason).to.equal("field_type");
159
+ expect((await presign("photo.png", "image/png")).status).to.equal(
160
+ HTTP_OK,
161
+ );
143
162
  });
144
- expect(rename.status).to.equal(HTTP_FORBIDDEN);
145
- const subfolder = (await fetchFolderNodes(client)).find(
146
- (folder) => folder.id === created.data.id,
147
- );
148
- expect(subfolder?.acceptsSubfolders).to.equal(true);
149
- expect(subfolder?.accepts).to.deep.equal(["image/*"]);
150
163
  });
164
+ }
151
165
 
152
- it("applies the field's types to uploads into a subfolder", async () => {
153
- const linked = await treeFolder(OPEN_BINDING_ID);
154
- const created = await client.post("/api/media/folders", {
155
- name: "Project B",
156
- parentId: linked.id,
157
- });
158
- const nested = await client.post("/api/media/folders", {
159
- name: "Roof",
160
- parentId: readBody(created, createdBody).id,
161
- });
162
- const presign = (filename: string, mimetype: string) =>
163
- client.post("/api/media/upload/presign", {
164
- folderId: readBody(nested, createdBody).id,
165
- filename,
166
- size: 4,
167
- mimetype,
166
+ function describeAssetMoves(): void {
167
+ describe("moving files into a linked folder", () => {
168
+ it("refuses to move a file into a linked folder whose field does not take its type", async () => {
169
+ const linked = await treeFolder(OPEN_BINDING_ID);
170
+ const library = await client.post("/api/media/folders", {
171
+ name: "Loose files",
172
+ });
173
+ const libraryId = readBody(library, createdBody).id;
174
+ const notes = await uploadTextAsset(client, libraryId, "notes.txt");
175
+ const photo = await uploadPixelPng(client, libraryId);
176
+ const single = await client.post(`/api/media/assets/${notes.id}/move`, {
177
+ folderId: linked.id,
178
+ });
179
+ expect(single.status).to.equal(HTTP_UNSUPPORTED_MEDIA_TYPE);
180
+ expect(single.data).to.equal(`${ERRORS}.field_type`);
181
+ const subfolder = await client.post("/api/media/folders", {
182
+ name: "Project D",
183
+ parentId: linked.id,
168
184
  });
169
- const text = await presign("notes.txt", "text/plain");
170
- expect(text.status).to.equal(HTTP_UNSUPPORTED_MEDIA_TYPE);
171
- expect(text.data.reason).to.equal("field_type");
172
- expect((await presign("photo.png", "image/png")).status).to.equal(HTTP_OK);
185
+ const intoSubfolder = await client.post(
186
+ `/api/media/assets/${notes.id}/move`,
187
+ { folderId: readBody(subfolder, createdBody).id },
188
+ );
189
+ expect(intoSubfolder.status).to.equal(HTTP_UNSUPPORTED_MEDIA_TYPE);
190
+ const bulk = await client.post("/api/media/assets/bulk/move", {
191
+ ids: [notes.id, photo.id],
192
+ folderId: linked.id,
193
+ });
194
+ expect(bulk.data.done).to.deep.equal([photo.id]);
195
+ expect(bulk.data.refused).to.deep.equal([
196
+ {
197
+ id: notes.id,
198
+ status: HTTP_UNSUPPORTED_MEDIA_TYPE,
199
+ message: `${ERRORS}.field_type`,
200
+ },
201
+ ]);
202
+ const assetModel = GetModel(MediaAssetModel, DEFAULT_TENANT_ID);
203
+ expect((await assetModel.get(notes.id))?.folderId).to.equal(libraryId);
204
+ await client.delete(`/api/media/folders/${libraryId}`);
205
+ });
173
206
  });
207
+ }
174
208
 
175
- it("refuses to move a file into a linked folder whose field does not take its type", async () => {
176
- const linked = await treeFolder(OPEN_BINDING_ID);
177
- const library = await client.post("/api/media/folders", {
178
- name: "Loose files",
179
- });
180
- const libraryId = readBody(library, createdBody).id;
181
- const notes = await uploadTextAsset(client, libraryId, "notes.txt");
182
- const photo = await uploadPixelPng(client, libraryId);
183
- const single = await client.post(`/api/media/assets/${notes.id}/move`, {
184
- folderId: linked.id,
185
- });
186
- expect(single.status).to.equal(HTTP_UNSUPPORTED_MEDIA_TYPE);
187
- expect(single.data).to.equal(`${ERRORS}.field_type`);
188
- const subfolder = await client.post("/api/media/folders", {
189
- name: "Project D",
190
- parentId: linked.id,
209
+ function describeDeclaredFolders(): void {
210
+ describe("declared subfolders", () => {
211
+ it("declares per-record folders under a linked folder that allows them", async () => {
212
+ const linked = await treeFolder(OPEN_BINDING_ID);
213
+ const project = await EnsureMediaFolder({
214
+ tenantId: DEFAULT_TENANT_ID,
215
+ key: "subfolders.project-c",
216
+ name: "Project C",
217
+ parent: { binding: OPEN_BINDING_ID },
218
+ });
219
+ expect(project.status).to.equal("created");
220
+ expect((await folders().get(project.id))?.parentId).to.equal(linked.id);
221
+ const again = await EnsureMediaFolder({
222
+ tenantId: DEFAULT_TENANT_ID,
223
+ key: "subfolders.project-c",
224
+ name: "Project C",
225
+ parent: { binding: OPEN_BINDING_ID },
226
+ });
227
+ expect(again).to.deep.equal({ status: "kept", id: project.id });
228
+ const nested = await EnsureMediaFolder({
229
+ tenantId: DEFAULT_TENANT_ID,
230
+ key: "subfolders.project-c.roof",
231
+ name: "Roof",
232
+ parent: { key: "subfolders.project-c" },
233
+ });
234
+ expect(nested.status).to.equal("created");
235
+ const sameParent = await EnsureMediaFolder({
236
+ tenantId: DEFAULT_TENANT_ID,
237
+ key: "subfolders.project-c.roof",
238
+ name: "Roof",
239
+ parent: "subfolders.project-c",
240
+ });
241
+ expect(
242
+ sameParent,
243
+ "a declared parent named by its key alone is the same declaration",
244
+ ).to.deep.equal({ status: "kept", id: nested.id });
245
+ const photo = await ImportMediaAsset({
246
+ tenantId: DEFAULT_TENANT_ID,
247
+ key: "subfolders.project-c.roof.photo",
248
+ folder: { key: "subfolders.project-c.roof" },
249
+ name: "roof.png",
250
+ mimetype: PNG_MIMETYPE,
251
+ source: { bytes: ONE_PIXEL_PNG },
252
+ });
253
+ expect(photo.status).to.equal("created");
254
+ const notes = await rejectionOf(
255
+ ImportMediaAsset({
256
+ tenantId: DEFAULT_TENANT_ID,
257
+ key: "subfolders.project-c.roof.notes",
258
+ folder: { key: "subfolders.project-c.roof" },
259
+ name: "notes.txt",
260
+ mimetype: "text/plain",
261
+ source: { bytes: Buffer.from("notes") },
262
+ }),
263
+ );
264
+ expect(notes.message).to.contain("only accepts image/*");
191
265
  });
192
- const intoSubfolder = await client.post(
193
- `/api/media/assets/${notes.id}/move`,
194
- { folderId: readBody(subfolder, createdBody).id },
195
- );
196
- expect(intoSubfolder.status).to.equal(HTTP_UNSUPPORTED_MEDIA_TYPE);
197
- const bulk = await client.post("/api/media/assets/bulk/move", {
198
- ids: [notes.id, photo.id],
199
- folderId: linked.id,
266
+
267
+ it("refuses a declared subfolder under a linked folder that does not allow them", async () => {
268
+ const locked = await rejectionOf(
269
+ EnsureMediaFolder({
270
+ tenantId: DEFAULT_TENANT_ID,
271
+ key: "subfolders.locked-child",
272
+ name: "Child",
273
+ parent: { binding: LOCKED_BINDING_ID },
274
+ }),
275
+ );
276
+ expect(locked.message)
277
+ .to.contain("subfolders.locked-child")
278
+ .and.contain("cannot hold subfolders");
279
+ const unknown = await rejectionOf(
280
+ EnsureMediaFolder({
281
+ tenantId: DEFAULT_TENANT_ID,
282
+ key: "subfolders.unknown-child",
283
+ name: "Child",
284
+ parent: { binding: "subfolders.never-registered" },
285
+ }),
286
+ );
287
+ expect(unknown.message).to.contain("no folder is bound");
200
288
  });
201
- expect(bulk.data.done).to.deep.equal([photo.id]);
202
- expect(bulk.data.refused).to.deep.equal([
203
- {
204
- id: notes.id,
205
- status: HTTP_UNSUPPORTED_MEDIA_TYPE,
206
- message: `${ERRORS}.field_type`,
207
- },
208
- ]);
209
- const assetModel = GetModel(MediaAssetModel, DEFAULT_TENANT_ID);
210
- expect((await assetModel.get(notes.id))?.folderId).to.equal(libraryId);
211
- await client.delete(`/api/media/folders/${libraryId}`);
212
289
  });
290
+ }
213
291
 
214
- it("declares per-record folders under a linked folder that allows them", async () => {
215
- const linked = await treeFolder(OPEN_BINDING_ID);
216
- const project = await EnsureMediaFolder({
217
- tenantId: DEFAULT_TENANT_ID,
218
- key: "subfolders.project-c",
219
- name: "Project C",
220
- parent: { binding: OPEN_BINDING_ID },
221
- });
222
- expect(project.status).to.equal("created");
223
- expect((await folders().get(project.id))?.parentId).to.equal(linked.id);
224
- const again = await EnsureMediaFolder({
225
- tenantId: DEFAULT_TENANT_ID,
226
- key: "subfolders.project-c",
227
- name: "Project C",
228
- parent: { binding: OPEN_BINDING_ID },
229
- });
230
- expect(again).to.deep.equal({ status: "kept", id: project.id });
231
- const nested = await EnsureMediaFolder({
232
- tenantId: DEFAULT_TENANT_ID,
233
- key: "subfolders.project-c.roof",
234
- name: "Roof",
235
- parent: { key: "subfolders.project-c" },
236
- });
237
- expect(nested.status).to.equal("created");
238
- const sameParent = await EnsureMediaFolder({
239
- tenantId: DEFAULT_TENANT_ID,
240
- key: "subfolders.project-c.roof",
241
- name: "Roof",
242
- parent: "subfolders.project-c",
243
- });
244
- expect(
245
- sameParent,
246
- "a declared parent named by its key alone is the same declaration",
247
- ).to.deep.equal({ status: "kept", id: nested.id });
248
- const photo = await ImportMediaAsset({
249
- tenantId: DEFAULT_TENANT_ID,
250
- key: "subfolders.project-c.roof.photo",
251
- folder: { key: "subfolders.project-c.roof" },
252
- name: "roof.png",
253
- mimetype: PNG_MIMETYPE,
254
- source: { bytes: ONE_PIXEL_PNG },
292
+ describe("[integration] media linked subfolders — bindings that allow them", () => {
293
+ before(async () => {
294
+ RegisterAssetBinding({
295
+ id: OPEN_BINDING_ID,
296
+ folderName: "Project photos",
297
+ subfolders: true,
298
+ field: { mimetypes: ["image/*"] },
255
299
  });
256
- expect(photo.status).to.equal("created");
257
- const notes = await rejectionOf(
258
- ImportMediaAsset({
259
- tenantId: DEFAULT_TENANT_ID,
260
- key: "subfolders.project-c.roof.notes",
261
- folder: { key: "subfolders.project-c.roof" },
262
- name: "notes.txt",
263
- mimetype: "text/plain",
264
- source: { bytes: Buffer.from("notes") },
265
- }),
266
- );
267
- expect(notes.message).to.contain("only accepts image/*");
300
+ RegisterAssetBinding({ id: LOCKED_BINDING_ID, folderName: "Locked" });
301
+ client = authorizedClient((await ensureOwnerSession()).accessToken);
268
302
  });
269
303
 
270
- it("refuses a declared subfolder under a linked folder that does not allow them", async () => {
271
- const locked = await rejectionOf(
272
- EnsureMediaFolder({
273
- tenantId: DEFAULT_TENANT_ID,
274
- key: "subfolders.locked-child",
275
- name: "Child",
276
- parent: { binding: LOCKED_BINDING_ID },
277
- }),
278
- );
279
- expect(locked.message)
280
- .to.contain("subfolders.locked-child")
281
- .and.contain("cannot hold subfolders");
282
- const unknown = await rejectionOf(
283
- EnsureMediaFolder({
284
- tenantId: DEFAULT_TENANT_ID,
285
- key: "subfolders.unknown-child",
286
- name: "Child",
287
- parent: { binding: "subfolders.never-registered" },
288
- }),
289
- );
290
- expect(unknown.message).to.contain("no folder is bound");
304
+ after(async () => {
305
+ UnregisterAssetBinding(OPEN_BINDING_ID);
306
+ UnregisterAssetBinding(LOCKED_BINDING_ID);
307
+ await removeLinkedFolders();
291
308
  });
309
+
310
+ describeSubfolderCreation();
311
+ describeAssetMoves();
312
+ describeDeclaredFolders();
292
313
  });
@@ -30,18 +30,9 @@ const namedAssetsBody = z.object({
30
30
  assets: z.array(z.object({ name: z.string() })),
31
31
  });
32
32
 
33
- describe("[integration] media permissions — multi-actor ACL enforcement", () => {
34
- let stockAssetId: string;
35
-
36
- before(async function () {
37
- this.timeout(SETUP_TIMEOUT_MS);
38
- await setUpPermissionsWorld();
39
- });
40
-
41
- after(async () => {
42
- await tearDownPermissionsWorld();
43
- });
33
+ let stockAssetId: string;
44
34
 
35
+ function describeTreeVisibility(): void {
45
36
  describe("tree visibility", () => {
46
37
  it("shows nothing to a member with no roles", async () => {
47
38
  const tree = await fetchTree(sessions.outsider.client);
@@ -146,7 +137,9 @@ describe("[integration] media permissions — multi-actor ACL enforcement", () =
146
137
  ).to.equal(undefined);
147
138
  });
148
139
  });
140
+ }
149
141
 
142
+ function describeReadPaths(): void {
150
143
  describe("listing, search and read paths", () => {
151
144
  it("hides unreadable folder listings behind 404", async () => {
152
145
  const listing = await sessions.viewer.client.get(
@@ -232,8 +225,10 @@ describe("[integration] media permissions — multi-actor ACL enforcement", () =
232
225
  expect(previews.data.previews[assets.secretPng.id]).to.equal(undefined);
233
226
  });
234
227
  });
228
+ }
235
229
 
236
- describe("write rights", () => {
230
+ function describeUploadRights(): void {
231
+ describe("upload rights", () => {
237
232
  it("refuses presign without the write right", async () => {
238
233
  const denied = await sessions.viewer.client.post(
239
234
  "/api/media/upload/presign",
@@ -295,7 +290,11 @@ describe("[integration] media permissions — multi-actor ACL enforcement", () =
295
290
  );
296
291
  stockAssetId = stockAsset.id;
297
292
  });
293
+ });
294
+ }
298
295
 
296
+ function describeAssetWriteRights(): void {
297
+ describe("asset write rights", () => {
299
298
  it("requires write to update or delete an asset", async () => {
300
299
  const denied = await sessions.viewer.client.post(
301
300
  `/api/media/assets/${assets.notes.id}/update`,
@@ -372,7 +371,9 @@ describe("[integration] media permissions — multi-actor ACL enforcement", () =
372
371
  expect(move.status).to.equal(HTTP_OK);
373
372
  });
374
373
  });
374
+ }
375
375
 
376
+ function describeTransformRights(): void {
376
377
  describe("transform rights", () => {
377
378
  it("requires the write right to transform an image", async () => {
378
379
  const denied = await sessions.viewer.client.post(
@@ -407,9 +408,9 @@ describe("[integration] media permissions — multi-actor ACL enforcement", () =
407
408
  expect(denied.status).to.equal(HTTP_NOT_FOUND);
408
409
  });
409
410
  });
411
+ }
410
412
 
411
- folderManagementSuites();
412
-
413
+ function describeDelivery(): void {
413
414
  describe("delivery", () => {
414
415
  it("enforces folder read rights on the private delivery route", async () => {
415
416
  const path = `/media/${assets.secretPng.id}/pixel.png`;
@@ -437,6 +438,24 @@ describe("[integration] media permissions — multi-actor ACL enforcement", () =
437
438
  expect(allowed.cacheControl).to.equal("no-store");
438
439
  });
439
440
  });
441
+ }
442
+
443
+ describe("[integration] media permissions — multi-actor ACL enforcement", () => {
444
+ before(async function () {
445
+ this.timeout(SETUP_TIMEOUT_MS);
446
+ await setUpPermissionsWorld();
447
+ });
448
+
449
+ after(async () => {
450
+ await tearDownPermissionsWorld();
451
+ });
440
452
 
453
+ describeTreeVisibility();
454
+ describeReadPaths();
455
+ describeUploadRights();
456
+ describeAssetWriteRights();
457
+ describeTransformRights();
458
+ folderManagementSuites();
459
+ describeDelivery();
441
460
  laterPermissionSuites();
442
461
  });
@@ -94,7 +94,11 @@ describe("[integration] streaming asset search", () => {
94
94
  },
95
95
  );
96
96
  try {
97
- const result = await controller(model).search(" İ ", " IMAGE/ ");
97
+ const result = await controller(model).search(
98
+ " İ ",
99
+ " IMAGE/ ",
100
+ undefined,
101
+ );
98
102
  expect(result.assets.map((row) => row.id)).to.deep.equal(
99
103
  expected.map((row) => row._id),
100
104
  );
@@ -107,14 +111,26 @@ describe("[integration] streaming asset search", () => {
107
111
  });
108
112
 
109
113
  it("retains empty and non-matching searches", async () => {
110
- expect((await controller(model).search()).assets).to.have.length(LIMIT);
111
- expect((await controller(model).search("absent")).assets).to.deep.equal([]);
112
- expect((await controller(model).search("", "text/")).assets).to.deep.equal(
113
- [],
114
- );
115
- expect((await controller(model, []).search()).assets).to.deep.equal([]);
116
114
  expect(
117
- (await controller(other).search("İ")).assets.map((row) => row.id),
115
+ (await controller(model).search(undefined, undefined, undefined)).assets,
116
+ ).to.have.length(LIMIT);
117
+ expect(
118
+ (await controller(model).search(true, true, true)).assets,
119
+ ).to.have.length(LIMIT);
120
+ expect(
121
+ (await controller(model).search("absent", undefined, undefined)).assets,
122
+ ).to.deep.equal([]);
123
+ expect(
124
+ (await controller(model).search("", "text/", undefined)).assets,
125
+ ).to.deep.equal([]);
126
+ expect(
127
+ (await controller(model, []).search(undefined, undefined, undefined))
128
+ .assets,
129
+ ).to.deep.equal([]);
130
+ expect(
131
+ (await controller(other).search("İ", undefined, undefined)).assets.map(
132
+ (row) => row.id,
133
+ ),
118
134
  ).to.deep.equal(["other"]);
119
135
  });
120
136
  });
@@ -26,6 +26,44 @@ const assetsBody = z.object({
26
26
  ),
27
27
  });
28
28
 
29
+ async function seedFacetFolders(
30
+ client: AxiosInstance,
31
+ ): Promise<{ rootId: string; childId: string }> {
32
+ const rootId = readBody(
33
+ await client.post("/api/media/folders", { name: "Facets Été 2026" }),
34
+ createdBody,
35
+ ).id;
36
+ const childId = readBody(
37
+ await client.post("/api/media/folders", {
38
+ name: "Facets Produits",
39
+ parentId: rootId,
40
+ }),
41
+ createdBody,
42
+ ).id;
43
+ await uploadAsset(
44
+ client,
45
+ rootId,
46
+ "Été à Liège – vacances (1).txt",
47
+ TEXT_MIMETYPE,
48
+ MEDIUM_BODY,
49
+ );
50
+ await uploadAsset(
51
+ client,
52
+ childId,
53
+ "facets-photo-14.txt",
54
+ TEXT_MIMETYPE,
55
+ SMALL_BODY,
56
+ );
57
+ await uploadAsset(
58
+ client,
59
+ childId,
60
+ "facets-photo-01.txt",
61
+ TEXT_MIMETYPE,
62
+ LARGE_BODY,
63
+ );
64
+ return { rootId, childId };
65
+ }
66
+
29
67
  describe("[integration] media search views — search, smart views and folder counts", () => {
30
68
  let client: AxiosInstance;
31
69
  let rootId: string;
@@ -35,38 +73,7 @@ describe("[integration] media search views — search, smart views and folder co
35
73
  this.timeout(30_000);
36
74
  const session = await ensureOwnerSession();
37
75
  client = authorizedClient(session.accessToken);
38
- rootId = readBody(
39
- await client.post("/api/media/folders", { name: "Facets Été 2026" }),
40
- createdBody,
41
- ).id;
42
- childId = readBody(
43
- await client.post("/api/media/folders", {
44
- name: "Facets Produits",
45
- parentId: rootId,
46
- }),
47
- createdBody,
48
- ).id;
49
- await uploadAsset(
50
- client,
51
- rootId,
52
- "Été à Liège – vacances (1).txt",
53
- TEXT_MIMETYPE,
54
- MEDIUM_BODY,
55
- );
56
- await uploadAsset(
57
- client,
58
- childId,
59
- "facets-photo-14.txt",
60
- TEXT_MIMETYPE,
61
- SMALL_BODY,
62
- );
63
- await uploadAsset(
64
- client,
65
- childId,
66
- "facets-photo-01.txt",
67
- TEXT_MIMETYPE,
68
- LARGE_BODY,
69
- );
76
+ ({ rootId, childId } = await seedFacetFolders(client));
70
77
  });
71
78
 
72
79
  after(async () => {