@antelopejs/dms-media 0.6.1 → 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 (196) hide show
  1. package/README.md +16 -1
  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 +86 -0
  122. package/frontend-vue/app/build/library/libraryActions.ts +444 -0
  123. package/frontend-vue/app/build/library/libraryCore.ts +136 -0
  124. package/frontend-vue/app/components/ImageEditor.vue +22 -179
  125. package/frontend-vue/app/composables/library/useMediaLibrary.ts +3 -575
  126. package/frontend-vue/app/composables/useMediaApi.ts +21 -5
  127. package/frontend-vue/build/backend-boundary.ts +122 -0
  128. package/frontend-vue/dms.frontend.build.ts +3 -0
  129. package/frontend-vue/eslint.config.mjs +13 -0
  130. package/frontend-vue/package.json +3 -1
  131. package/frontend-vue/pnpm-lock.yaml +217 -61
  132. package/frontend-vue/tests/backend-boundary.test.ts +203 -0
  133. package/frontend-vue/tests/mediaPreviews.test.ts +39 -0
  134. package/package.json +4 -10
  135. package/skills/dms-media/SKILL.md +1 -0
  136. package/skills/dms-media/cases.json +38 -0
  137. package/src/acl/entries.ts +6 -4
  138. package/src/bindings.ts +3 -3
  139. package/src/declared/folders.ts +3 -3
  140. package/src/declared/records.ts +9 -8
  141. package/src/derivatives.ts +10 -6
  142. package/src/guards.ts +19 -0
  143. package/src/library/activity.ts +17 -9
  144. package/src/library/batches.ts +12 -9
  145. package/src/library/events.ts +7 -4
  146. package/src/library/module-readout.ts +6 -2
  147. package/src/library/realtime.ts +5 -1
  148. package/src/library/zip.ts +1 -1
  149. package/src/pages/activity.ts +6 -2
  150. package/src/routes/media/assets.ts +4 -3
  151. package/src/routes/media/bulk.ts +16 -14
  152. package/src/routes/media/delivery-headers.ts +9 -12
  153. package/src/routes/media/delivery-stream.ts +3 -2
  154. package/src/routes/media/delivery.ts +4 -2
  155. package/src/routes/media/manage.ts +4 -6
  156. package/src/routes/media/transform.ts +27 -23
  157. package/src/test/antelope.test.ts +21 -17
  158. package/src/test/helpers/folders.ts +22 -0
  159. package/src/test/helpers/pages.ts +12 -5
  160. package/src/test/helpers/permissions-world.ts +326 -0
  161. package/src/test/helpers/prototype.ts +12 -0
  162. package/src/test/integration/derivative-sweep-query.test.ts +19 -21
  163. package/src/test/integration/folder-query.test.ts +11 -11
  164. package/src/test/integration/media-bindings.test.ts +7 -7
  165. package/src/test/integration/media-cleanup.test.ts +25 -37
  166. package/src/test/integration/media-declared-content.test.ts +18 -19
  167. package/src/test/integration/media-delivery-editing.test.ts +11 -7
  168. package/src/test/integration/media-delivery.test.ts +29 -8
  169. package/src/test/integration/media-explorer-writes.test.ts +2 -7
  170. package/src/test/integration/media-guards.test.ts +21 -7
  171. package/src/test/integration/media-library.test.ts +1 -1
  172. package/src/test/integration/media-linked-subfolders.test.ts +11 -20
  173. package/src/test/integration/media-member-access.test.ts +5 -9
  174. package/src/test/integration/media-permissions.test.ts +56 -570
  175. package/src/test/integration/media-project-field.test.ts +5 -7
  176. package/src/test/integration/media-search-query.test.ts +16 -20
  177. package/src/test/integration/media-storage-origin-unreachable.test.ts +3 -2
  178. package/src/test/integration/media-upload-policy.test.ts +2 -8
  179. package/src/test/integration/permissions-management.ts +292 -0
  180. package/src/test/unit/acl/entries.test.ts +2 -1
  181. package/src/test/unit/acl/resolver.test.ts +19 -7
  182. package/src/test/unit/library/fixtures.ts +9 -3
  183. package/src/test/unit/library/library.test.ts +1 -7
  184. package/src/test/unit/library/realtime.test.ts +1 -1
  185. package/src/test/unit/library/search-facets.test.ts +2 -2
  186. package/src/test/unit/pages/toolbar.test.ts +42 -17
  187. package/src/test/unit/routes/dto.test.ts +7 -6
  188. package/src/test/unit/routes/file-page.test.ts +10 -9
  189. package/src/test/unit/routes/preset-row.test.ts +2 -2
  190. package/src/transform.ts +6 -6
  191. package/src/upload-checks.ts +12 -3
  192. package/src/upload-policy.ts +8 -8
  193. package/src/validation/declared.schema.ts +17 -12
  194. package/src/validation/media.schema.ts +6 -6
  195. package/frontend-vue/tests/engines.test.ts +0 -20
  196. package/frontend-vue/tests/locales.test.ts +0 -61
@@ -1,317 +1,39 @@
1
- import type { AxiosInstance } from "axios";
2
- import { expect } from "chai";
3
- import { RegisterAssetBinding } from "@antelopejs/interface-dms-media";
4
- import {
5
- configureMediaModule,
6
- type DmsMediaConfig,
7
- getMediaConfig,
8
- } from "../../config";
9
- import { GetPermissionId } from "@antelopejs/interface-dms/page";
10
- import { UserModel } from "@antelopejs/interface-dms/auth/db";
11
- import { DEFAULT_TENANT_ID } from "@antelopejs/interface-dms/constants";
12
- import { GetModel } from "@antelopejs/interface-database-decorators";
13
- import { MEDIA_PAGE_PERMISSION } from "../../pages/files";
14
- import { MediaUploadsPage } from "../../pages/uploads";
15
- import { uploadAvailability } from "../../pages/upload-availability";
16
- import { MEDIA_ROUTES } from "../../library/links";
17
- import type { AclEntry } from "../../types";
1
+ import { assert, expect } from "chai";
2
+ import { rawGet, type UploadedAsset, uploadTextAsset } from "../helpers/assets";
3
+
18
4
  import {
19
- rawGet,
20
- type UploadedAsset,
21
- uploadPixelPng,
22
- uploadTextAsset,
23
- } from "../helpers/assets";
24
- import { readFolderAcl, writeFolderAcl } from "../helpers/folders";
25
- import { authorizedClient } from "../helpers/http";
26
- import { readPageAccess } from "../helpers/pages";
5
+ assets,
6
+ fetchTree,
7
+ findById,
8
+ folders,
9
+ HTTP_FORBIDDEN,
10
+ HTTP_FOUND,
11
+ HTTP_NOT_FOUND,
12
+ HTTP_OK,
13
+ owner,
14
+ requireById,
15
+ ROTATE_QUARTER_TURN,
16
+ sessions,
17
+ setUpPermissionsWorld,
18
+ tearDownPermissionsWorld,
19
+ } from "../helpers/permissions-world";
27
20
  import {
28
- createRole,
29
- type MemberSession,
30
- registerMember,
31
- setRolePermissions,
32
- } from "../helpers/members";
33
- import { ensureOwnerSession } from "../helpers/owner";
34
-
35
- const HTTP_OK = 200;
36
- const HTTP_FOUND = 302;
37
- const HTTP_FORBIDDEN = 403;
38
- const HTTP_NOT_FOUND = 404;
39
- const SETUP_TIMEOUT_MS = 120_000;
21
+ folderManagementSuites,
22
+ laterPermissionSuites,
23
+ } from "./permissions-management";
40
24
 
41
- const LIBRARY_VIEW_PERMISSION = "warehouse.library.view";
42
- const LIBRARY_UPLOAD_PERMISSION = "warehouse.library.upload";
43
- const LIBRARY_MANAGE_PERMISSION = "warehouse.library.manage";
44
- const WAREHOUSE_EDIT_PERMISSION = "warehouse.table.edit";
45
- const WAREHOUSE_VIEW_PERMISSION = "warehouse.page";
46
- const STOCK_BINDING_ID = "warehouse.stock";
47
- const STOCK_FOLDER_NAME = "Warehouse stock";
48
- const CONTENT_ROOT_NAME = "Content";
49
- const ROTATE_QUARTER_TURN = 90;
50
-
51
- interface TreeFolderNode {
52
- id: string;
53
- name: string;
54
- parentId: string | null;
55
- shell: boolean;
56
- bound: boolean;
57
- visibility: string;
58
- rights: { read: boolean; write: boolean; manage: boolean };
59
- }
60
-
61
- interface TreeRootRights {
62
- write: boolean;
63
- manage: boolean;
64
- }
65
-
66
- interface TreeResponse {
67
- folders: TreeFolderNode[];
68
- root: TreeRootRights;
69
- }
70
-
71
- interface WorldRoles {
72
- pageHolder: string;
73
- viewer: string;
74
- uploader: string;
75
- folderManager: string;
76
- clerk: string;
77
- secretTeam: string;
78
- latecomer: string;
79
- }
80
-
81
- interface WorldSessions {
82
- pageHolder: MemberSession;
83
- viewer: MemberSession;
84
- uploader: MemberSession;
85
- folderManager: MemberSession;
86
- clerk: MemberSession;
87
- secretMember: MemberSession;
88
- hybrid: MemberSession;
89
- latecomer: MemberSession;
90
- outsider: MemberSession;
91
- }
92
-
93
- interface WorldFolders {
94
- library: string;
95
- restricted: string;
96
- deep: string;
97
- vault: string;
98
- pocket: string;
99
- publicZone: string;
100
- readOnlyCorner: string;
101
- depot: string;
102
- curtain: string;
103
- stock: string;
104
- contentRoot: string;
105
- }
106
-
107
- interface WorldAssets {
108
- notes: UploadedAsset;
109
- secretText: UploadedAsset;
110
- secretPng: UploadedAsset;
111
- libraryPng: UploadedAsset;
112
- }
113
-
114
- async function fetchTree(client: AxiosInstance): Promise<TreeResponse> {
115
- const response = await client.get("/api/media/tree");
116
- expect(response.status, "tree").to.equal(HTTP_OK);
117
- return response.data;
118
- }
119
-
120
- function findByName(
121
- tree: TreeResponse,
122
- name: string,
123
- ): TreeFolderNode | undefined {
124
- return tree.folders.find((folder) => folder.name === name);
125
- }
126
-
127
- function findById(tree: TreeResponse, id: string): TreeFolderNode | undefined {
128
- return tree.folders.find((folder) => folder.id === id);
129
- }
130
-
131
- async function createFolder(
132
- owner: AxiosInstance,
133
- name: string,
134
- parentId?: string,
135
- ): Promise<string> {
136
- const response = await owner.post("/api/media/folders", { name, parentId });
137
- expect(response.status, `create folder ${name}`).to.equal(HTTP_OK);
138
- return response.data.id;
139
- }
140
-
141
- function roleEntry(roleId: string, rights: AclEntry["rights"]): AclEntry {
142
- return { subject: { kind: "role", id: roleId }, rights };
143
- }
144
-
145
- function permissionEntry(id: string, rights: AclEntry["rights"]): AclEntry {
146
- return { subject: { kind: "permission", id }, rights };
147
- }
148
-
149
- function snapshotMediaConfig(): DmsMediaConfig {
150
- const config = getMediaConfig();
151
- return {
152
- rootAcl: config.rootAcl,
153
- storage: config.storage,
154
- presets: [...config.presets.values()],
155
- storageQuotaBytes: config.storageQuotaBytes,
156
- };
157
- }
158
-
159
- function grantLibraryAtRoot(config: DmsMediaConfig): void {
160
- configureMediaModule({
161
- ...config,
162
- rootAcl: [
163
- ...(config.rootAcl ?? []),
164
- permissionEntry(LIBRARY_VIEW_PERMISSION, ["read"]),
165
- permissionEntry(LIBRARY_UPLOAD_PERMISSION, ["write"]),
166
- permissionEntry(LIBRARY_MANAGE_PERMISSION, ["manage"]),
167
- ],
168
- });
169
- }
170
-
171
- async function createWorldRoles(): Promise<WorldRoles> {
172
- const [
173
- pageHolder,
174
- viewer,
175
- uploader,
176
- folderManager,
177
- clerk,
178
- secretTeam,
179
- latecomer,
180
- ] = await Promise.all([
181
- createRole("media-page-holder", [MEDIA_PAGE_PERMISSION]),
182
- createRole("media-viewer", [LIBRARY_VIEW_PERMISSION]),
183
- createRole("media-uploader", [
184
- LIBRARY_VIEW_PERMISSION,
185
- LIBRARY_UPLOAD_PERMISSION,
186
- ]),
187
- createRole("media-folder-manager", [
188
- LIBRARY_VIEW_PERMISSION,
189
- LIBRARY_MANAGE_PERMISSION,
190
- ]),
191
- createRole("warehouse-clerk", [WAREHOUSE_EDIT_PERMISSION]),
192
- createRole("secret-team", []),
193
- createRole("latecomer", []),
194
- ]);
195
- return {
196
- pageHolder,
197
- viewer,
198
- uploader,
199
- folderManager,
200
- clerk,
201
- secretTeam,
202
- latecomer,
203
- };
204
- }
205
-
206
- async function registerWorldMembers(roles: WorldRoles): Promise<WorldSessions> {
207
- return {
208
- pageHolder: await registerMember("PageHolder", [roles.pageHolder]),
209
- viewer: await registerMember("Viewer", [roles.viewer]),
210
- uploader: await registerMember("Uploader", [roles.uploader]),
211
- folderManager: await registerMember("FolderManager", [roles.folderManager]),
212
- clerk: await registerMember("Clerk", [roles.clerk]),
213
- secretMember: await registerMember("SecretMember", [roles.secretTeam]),
214
- hybrid: await registerMember("Hybrid", [roles.viewer, roles.secretTeam]),
215
- latecomer: await registerMember("Latecomer", [roles.latecomer]),
216
- outsider: await registerMember("Outsider", []),
217
- };
218
- }
219
-
220
- async function buildWorldFolders(
221
- owner: AxiosInstance,
222
- secretTeamRoleId: string,
223
- ): Promise<WorldFolders> {
224
- const library = await createFolder(owner, "Library");
225
- const restricted = await createFolder(owner, "Restricted");
226
- const deep = await createFolder(owner, "Deep", restricted);
227
- const vault = await createFolder(owner, "Vault");
228
- const pocket = await createFolder(owner, "Pocket", vault);
229
- const publicZone = await createFolder(owner, "PublicZone");
230
- const readOnlyCorner = await createFolder(owner, "ReadOnlyCorner");
231
- const depot = await createFolder(owner, "Depot");
232
- const curtain = await createFolder(owner, "Curtain");
233
- await writeFolderAcl(restricted, [roleEntry(secretTeamRoleId, ["write"])]);
234
- await writeFolderAcl(vault, []);
235
- await writeFolderAcl(pocket, [roleEntry(secretTeamRoleId, ["read"])]);
236
- await writeFolderAcl(readOnlyCorner, [
237
- permissionEntry(LIBRARY_VIEW_PERMISSION, ["read"]),
238
- ]);
239
- const flip = await owner.post(`/api/media/folders/${publicZone}/visibility`, {
240
- visibility: "public",
241
- });
242
- expect(flip.status, "flip PublicZone public").to.equal(HTTP_OK);
243
- const tree = await fetchTree(owner);
244
- const stock = findByName(tree, STOCK_FOLDER_NAME);
245
- const contentRoot = findByName(tree, CONTENT_ROOT_NAME);
246
- expect(stock, "provisioned stock folder").to.not.equal(undefined);
247
- expect(contentRoot, "provisioned content root").to.not.equal(undefined);
248
- return {
249
- library,
250
- restricted,
251
- deep,
252
- vault,
253
- pocket,
254
- publicZone,
255
- readOnlyCorner,
256
- depot,
257
- curtain,
258
- stock: (stock as TreeFolderNode).id,
259
- contentRoot: (contentRoot as TreeFolderNode).id,
260
- };
261
- }
262
-
263
- async function seedWorldAssets(
264
- owner: AxiosInstance,
265
- folders: WorldFolders,
266
- ): Promise<WorldAssets> {
267
- return {
268
- notes: await uploadTextAsset(owner, folders.library, "notes.txt"),
269
- secretText: await uploadTextAsset(owner, folders.restricted, "secret.txt"),
270
- secretPng: await uploadPixelPng(owner, folders.restricted),
271
- libraryPng: await uploadPixelPng(owner, folders.library),
272
- };
273
- }
25
+ const SETUP_TIMEOUT_MS = 120_000;
274
26
 
275
27
  describe("[integration] media permissions — multi-actor ACL enforcement", () => {
276
- let owner: AxiosInstance;
277
- let roles: WorldRoles;
278
- let sessions: WorldSessions;
279
- let folders: WorldFolders;
280
- let assets: WorldAssets;
281
28
  let stockAssetId: string;
282
- let previousConfig: DmsMediaConfig;
283
29
 
284
30
  before(async function () {
285
31
  this.timeout(SETUP_TIMEOUT_MS);
286
- previousConfig = snapshotMediaConfig();
287
- grantLibraryAtRoot(previousConfig);
288
- RegisterAssetBinding({
289
- id: STOCK_BINDING_ID,
290
- folderName: STOCK_FOLDER_NAME,
291
- permissionMapping: { write: [WAREHOUSE_EDIT_PERMISSION] },
292
- });
293
- const session = await ensureOwnerSession();
294
- owner = authorizedClient(session.accessToken);
295
- roles = await createWorldRoles();
296
- sessions = await registerWorldMembers(roles);
297
- folders = await buildWorldFolders(owner, roles.secretTeam);
298
- assets = await seedWorldAssets(owner, folders);
32
+ await setUpPermissionsWorld();
299
33
  });
300
34
 
301
35
  after(async () => {
302
- const roots = [
303
- folders.library,
304
- folders.restricted,
305
- folders.vault,
306
- folders.publicZone,
307
- folders.readOnlyCorner,
308
- folders.depot,
309
- folders.curtain,
310
- ];
311
- for (const folderId of roots) {
312
- await owner.delete(`/api/media/folders/${folderId}`);
313
- }
314
- configureMediaModule(previousConfig);
36
+ await tearDownPermissionsWorld();
315
37
  });
316
38
 
317
39
  describe("tree visibility", () => {
@@ -330,13 +52,13 @@ describe("[integration] media permissions — multi-actor ACL enforcement", () =
330
52
  it("shows only root-inherited folders to a holder of a root read grant", async () => {
331
53
  const tree = await fetchTree(sessions.viewer.client);
332
54
  const library = findById(tree, folders.library);
333
- expect(library, "library").to.not.equal(undefined);
334
- expect((library as TreeFolderNode).rights).to.deep.equal({
55
+ assert.isDefined(library, "library");
56
+ expect(library.rights).to.deep.equal({
335
57
  read: true,
336
58
  write: false,
337
59
  manage: false,
338
60
  });
339
- expect((library as TreeFolderNode).shell).to.equal(false);
61
+ expect(library.shell).to.equal(false);
340
62
  for (const hiddenId of [
341
63
  folders.restricted,
342
64
  folders.deep,
@@ -353,19 +75,19 @@ describe("[integration] media permissions — multi-actor ACL enforcement", () =
353
75
 
354
76
  it("grants folder access through a role subject alone", async () => {
355
77
  const tree = await fetchTree(sessions.secretMember.client);
356
- expect(
357
- (findById(tree, folders.restricted) as TreeFolderNode).rights,
358
- ).to.deep.equal({ read: true, write: true, manage: false });
359
- expect(
360
- (findById(tree, folders.deep) as TreeFolderNode).rights.write,
361
- ).to.equal(true);
362
- const pocket = findById(tree, folders.pocket) as TreeFolderNode;
78
+ expect(requireById(tree, folders.restricted).rights).to.deep.equal({
79
+ read: true,
80
+ write: true,
81
+ manage: false,
82
+ });
83
+ expect(requireById(tree, folders.deep).rights.write).to.equal(true);
84
+ const pocket = requireById(tree, folders.pocket);
363
85
  expect(pocket.rights).to.deep.equal({
364
86
  read: true,
365
87
  write: false,
366
88
  manage: false,
367
89
  });
368
- const vault = findById(tree, folders.vault) as TreeFolderNode;
90
+ const vault = requireById(tree, folders.vault);
369
91
  expect(vault.shell, "vault is a traverse-only shell").to.equal(true);
370
92
  expect(vault.rights.read).to.equal(false);
371
93
  expect(findById(tree, folders.library)).to.equal(undefined);
@@ -374,14 +96,14 @@ describe("[integration] media permissions — multi-actor ACL enforcement", () =
374
96
 
375
97
  it("auto-grants the linked folder to consumer permission holders", async () => {
376
98
  const tree = await fetchTree(sessions.clerk.client);
377
- const stock = findById(tree, folders.stock) as TreeFolderNode;
378
- expect(stock, "linked stock folder").to.not.equal(undefined);
99
+ const stock = findById(tree, folders.stock);
100
+ assert.isDefined(stock, "linked stock folder");
379
101
  expect(stock.rights).to.deep.equal({
380
102
  read: true,
381
103
  write: true,
382
104
  manage: false,
383
105
  });
384
- const contentRoot = findById(tree, folders.contentRoot) as TreeFolderNode;
106
+ const contentRoot = requireById(tree, folders.contentRoot);
385
107
  expect(contentRoot.shell, "content root is a shell").to.equal(true);
386
108
  expect(findById(tree, folders.library)).to.equal(undefined);
387
109
  });
@@ -389,27 +111,29 @@ describe("[integration] media permissions — multi-actor ACL enforcement", () =
389
111
  it("unions permission and role subjects across multiple roles", async () => {
390
112
  const tree = await fetchTree(sessions.hybrid.client);
391
113
  const library = findById(tree, folders.library);
392
- expect(library, "library via the root read grant").to.not.equal(
393
- undefined,
394
- );
395
- expect((library as TreeFolderNode).rights.read).to.equal(true);
114
+ assert.isDefined(library, "library via the root read grant");
115
+ expect(library.rights.read).to.equal(true);
396
116
  const restricted = findById(tree, folders.restricted);
397
- expect(restricted, "restricted via secret-team").to.not.equal(undefined);
398
- expect((restricted as TreeFolderNode).rights.write).to.equal(true);
117
+ assert.isDefined(restricted, "restricted via secret-team");
118
+ expect(restricted.rights.write).to.equal(true);
399
119
  });
400
120
 
401
121
  it("expands implied rights for uploader and folder manager", async () => {
402
122
  const uploaderTree = await fetchTree(sessions.uploader.client);
403
123
  expect(uploaderTree.root).to.include({ write: true, manage: false });
404
- expect(
405
- (findById(uploaderTree, folders.library) as TreeFolderNode).rights,
406
- ).to.deep.equal({ read: true, write: true, manage: false });
124
+ expect(requireById(uploaderTree, folders.library).rights).to.deep.equal({
125
+ read: true,
126
+ write: true,
127
+ manage: false,
128
+ });
407
129
 
408
130
  const managerTree = await fetchTree(sessions.folderManager.client);
409
131
  expect(managerTree.root).to.include({ write: true, manage: true });
410
- expect(
411
- (findById(managerTree, folders.library) as TreeFolderNode).rights,
412
- ).to.deep.equal({ read: true, write: true, manage: true });
132
+ expect(requireById(managerTree, folders.library).rights).to.deep.equal({
133
+ read: true,
134
+ write: true,
135
+ manage: true,
136
+ });
413
137
  expect(
414
138
  findById(managerTree, folders.stock),
415
139
  "linked folders stay with the owner and their consumers",
@@ -494,9 +218,8 @@ describe("[integration] media permissions — multi-actor ACL enforcement", () =
494
218
  });
495
219
 
496
220
  it("filters unreadable assets out of preview batches", async () => {
497
- const previews = await sessions.viewer.client.post(
498
- "/api/media/previews",
499
- { ids: [assets.libraryPng.id, assets.secretPng.id] },
221
+ const previews = await sessions.viewer.client.get(
222
+ `/api/media/previews?ids=${assets.libraryPng.id}&ids=${assets.secretPng.id}`,
500
223
  );
501
224
  expect(previews.status).to.equal(HTTP_OK);
502
225
  expect(previews.data.previews[assets.libraryPng.id]).to.be.a("string");
@@ -679,145 +402,7 @@ describe("[integration] media permissions — multi-actor ACL enforcement", () =
679
402
  });
680
403
  });
681
404
 
682
- describe("folder management and ACL edition", () => {
683
- it("requires manage at the root to create top-level folders", async () => {
684
- const denied = await sessions.uploader.client.post("/api/media/folders", {
685
- name: "Nope",
686
- });
687
- expect(denied.status).to.equal(HTTP_FORBIDDEN);
688
- });
689
-
690
- it("lets a folder manager create, rename, move and delete folders", async () => {
691
- const created = await sessions.folderManager.client.post(
692
- "/api/media/folders",
693
- { name: "Managed" },
694
- );
695
- expect(created.status).to.equal(HTTP_OK);
696
- const managedId = created.data.id;
697
- const renamed = await sessions.folderManager.client.post(
698
- `/api/media/folders/${managedId}/rename`,
699
- { name: "Managed renamed" },
700
- );
701
- expect(renamed.status).to.equal(HTTP_OK);
702
- const moved = await sessions.folderManager.client.post(
703
- `/api/media/folders/${managedId}/move`,
704
- { parentId: folders.depot },
705
- );
706
- expect(moved.status).to.equal(HTTP_OK);
707
- const deleted = await sessions.folderManager.client.delete(
708
- `/api/media/folders/${managedId}`,
709
- );
710
- expect(deleted.status).to.equal(HTTP_OK);
711
- });
712
-
713
- it("refuses cascade deletion when a subfolder lacks the manage right", async () => {
714
- const estate = await createFolder(owner, "Estate");
715
- const cellar = await createFolder(owner, "EstateCellar", estate);
716
- await writeFolderAcl(cellar, [roleEntry(roles.secretTeam, ["manage"])]);
717
- const denied = await sessions.folderManager.client.delete(
718
- `/api/media/folders/${estate}`,
719
- );
720
- expect(denied.status).to.equal(HTTP_FORBIDDEN);
721
- const cleanup = await owner.delete(`/api/media/folders/${estate}`);
722
- expect(cleanup.status).to.equal(HTTP_OK);
723
- });
724
-
725
- it("checks the target parent's manage right on folder moves", async () => {
726
- const created = await sessions.folderManager.client.post(
727
- "/api/media/folders",
728
- { name: "Nomad" },
729
- );
730
- expect(created.status).to.equal(HTTP_OK);
731
- const nomadId = created.data.id;
732
- const invisibleTarget = await sessions.folderManager.client.post(
733
- `/api/media/folders/${nomadId}/move`,
734
- { parentId: folders.restricted },
735
- );
736
- expect(invisibleTarget.status).to.equal(HTTP_NOT_FOUND);
737
- const unmanagedTarget = await sessions.folderManager.client.post(
738
- `/api/media/folders/${nomadId}/move`,
739
- { parentId: folders.readOnlyCorner },
740
- );
741
- expect(unmanagedTarget.status).to.equal(HTTP_FORBIDDEN);
742
- const cleanup = await sessions.folderManager.client.delete(
743
- `/api/media/folders/${nomadId}`,
744
- );
745
- expect(cleanup.status).to.equal(HTTP_OK);
746
- });
747
-
748
- it("keeps visibility changes owner-only, even for a folder manager", async () => {
749
- const folderFlip = await sessions.folderManager.client.post(
750
- `/api/media/folders/${folders.depot}/visibility`,
751
- { visibility: "public" },
752
- );
753
- expect(folderFlip.status).to.equal(HTTP_FORBIDDEN);
754
- const assetFlip = await sessions.folderManager.client.post(
755
- `/api/media/assets/${assets.notes.id}/visibility`,
756
- { visibility: "public" },
757
- );
758
- expect(assetFlip.status).to.equal(HTTP_FORBIDDEN);
759
- });
760
-
761
- it("applies a stored folder ACL on the next request", async () => {
762
- const before = await fetchTree(sessions.viewer.client);
763
- expect(findById(before, folders.curtain), "curtain visible").to.not.equal(
764
- undefined,
765
- );
766
- expect(await readFolderAcl(folders.curtain)).to.equal(undefined);
767
- await writeFolderAcl(folders.curtain, [
768
- roleEntry(roles.secretTeam, ["manage"]),
769
- ]);
770
- const hidden = await fetchTree(sessions.viewer.client);
771
- expect(findById(hidden, folders.curtain), "curtain hidden").to.equal(
772
- undefined,
773
- );
774
- });
775
-
776
- it("never locks the owner out of a folder", async () => {
777
- await writeFolderAcl(folders.curtain, []);
778
- const tree = await fetchTree(owner);
779
- expect(findById(tree, folders.curtain)?.rights.manage).to.equal(true);
780
- });
781
-
782
- it("restores inheritance when the ACL is cleared", async () => {
783
- await writeFolderAcl(folders.curtain, null);
784
- const tree = await fetchTree(sessions.viewer.client);
785
- expect(findById(tree, folders.curtain), "curtain back").to.not.equal(
786
- undefined,
787
- );
788
- });
789
-
790
- it("lets the owner flip folder and asset visibility", async () => {
791
- const folderFlip = await owner.post(
792
- `/api/media/folders/${folders.curtain}/visibility`,
793
- { visibility: "public" },
794
- );
795
- expect(folderFlip.status).to.equal(HTTP_OK);
796
- const folderBack = await owner.post(
797
- `/api/media/folders/${folders.curtain}/visibility`,
798
- { visibility: "private" },
799
- );
800
- expect(folderBack.status).to.equal(HTTP_OK);
801
- const assetFlip = await owner.post(
802
- `/api/media/assets/${assets.notes.id}/visibility`,
803
- { visibility: "private" },
804
- );
805
- expect(assetFlip.status).to.equal(HTTP_OK);
806
- const assetBack = await owner.post(
807
- `/api/media/assets/${assets.notes.id}/visibility`,
808
- { visibility: "inherit" },
809
- );
810
- expect(assetBack.status).to.equal(HTTP_OK);
811
- });
812
-
813
- it("keeps linked folders locked even for the owner", async () => {
814
- const rename = await owner.post(
815
- `/api/media/folders/${folders.stock}/rename`,
816
- { name: "Hijacked stock" },
817
- );
818
- expect(rename.status).to.equal(HTTP_FORBIDDEN);
819
- });
820
- });
405
+ folderManagementSuites();
821
406
 
822
407
  describe("delivery", () => {
823
408
  it("enforces folder read rights on the private delivery route", async () => {
@@ -847,104 +432,5 @@ describe("[integration] media permissions — multi-actor ACL enforcement", () =
847
432
  });
848
433
  });
849
434
 
850
- describe("dynamic role updates", () => {
851
- it("grants access on the next request when the role gains a permission", async () => {
852
- const before = await fetchTree(sessions.latecomer.client);
853
- expect(before.folders).to.deep.equal([]);
854
- await setRolePermissions(roles.latecomer, [LIBRARY_VIEW_PERMISSION]);
855
- const after = await fetchTree(sessions.latecomer.client);
856
- expect(
857
- findById(after, folders.library),
858
- "library visible after grant",
859
- ).to.not.equal(undefined);
860
- });
861
-
862
- it("revokes access on the next request when the permission is removed", async () => {
863
- await setRolePermissions(roles.latecomer, []);
864
- const tree = await fetchTree(sessions.latecomer.client);
865
- expect(tree.folders).to.deep.equal([]);
866
- });
867
- });
868
-
869
- describe("upload header button", () => {
870
- const uploadsPagePermission = GetPermissionId(MediaUploadsPage) ?? "";
871
-
872
- async function uploadButton(client: AxiosInstance) {
873
- const layout = await client.get("/dms/pagelayout", {
874
- params: { slug: MEDIA_ROUTES.uploads },
875
- });
876
- expect(layout.status).to.equal(HTTP_OK);
877
- return layout.data.layout.options.headerActions[0];
878
- }
879
-
880
- async function latecomerAvailability() {
881
- const user = await GetModel(UserModel).get(sessions.latecomer.userId);
882
- return uploadAvailability({ tenantId: DEFAULT_TENANT_ID, user });
883
- }
884
-
885
- after(async () => {
886
- await setRolePermissions(roles.latecomer, []);
887
- });
888
-
889
- it("serves the uploads page to the owner with the button enabled", async () => {
890
- const button = await uploadButton(owner);
891
- expect(button.disabled).to.not.equal(true);
892
- });
893
-
894
- it("keeps the uploads page from members: module pages are owner-only", async () => {
895
- await setRolePermissions(roles.latecomer, [
896
- LIBRARY_VIEW_PERMISSION,
897
- uploadsPagePermission,
898
- LIBRARY_UPLOAD_PERMISSION,
899
- ]);
900
- const [memberAccess, ownerAccess] = await Promise.all([
901
- readPageAccess(sessions.latecomer.client, MEDIA_ROUTES.uploads),
902
- readPageAccess(owner, MEDIA_ROUTES.uploads),
903
- ]);
904
- expect(ownerAccess).to.include({
905
- ownRouteStatus: HTTP_OK,
906
- hasAccess: true,
907
- });
908
- expect(ownerAccess.servedBlocks).to.be.greaterThan(0);
909
- expect(memberAccess).to.include({ hasAccess: false, servedBlocks: 0 });
910
- expect(memberAccess.ownRouteStatus).to.not.equal(HTTP_OK);
911
- });
912
-
913
- it("is disabled for a member who can upload to no folder", async () => {
914
- await setRolePermissions(roles.latecomer, [LIBRARY_VIEW_PERMISSION]);
915
- expect(await latecomerAvailability()).to.deep.equal({
916
- reason: "$dms_media.uploads.no_writable_folder",
917
- });
918
- });
919
-
920
- it("is enabled once the member may upload somewhere", async () => {
921
- await setRolePermissions(roles.latecomer, [
922
- LIBRARY_VIEW_PERMISSION,
923
- LIBRARY_UPLOAD_PERMISSION,
924
- ]);
925
- expect(await latecomerAvailability()).to.equal(undefined);
926
- });
927
- });
928
-
929
- describe("binding lifecycle", () => {
930
- it("resyncs the linked folder ACL when the mapping changes", async () => {
931
- RegisterAssetBinding({
932
- id: STOCK_BINDING_ID,
933
- folderName: STOCK_FOLDER_NAME,
934
- permissionMapping: {
935
- read: [WAREHOUSE_VIEW_PERMISSION],
936
- write: [WAREHOUSE_EDIT_PERMISSION],
937
- },
938
- });
939
- await fetchTree(owner);
940
- expect(await readFolderAcl(folders.stock)).to.deep.include(
941
- permissionEntry(WAREHOUSE_VIEW_PERMISSION, ["read"]),
942
- );
943
- const tree = await fetchTree(sessions.clerk.client);
944
- expect(
945
- (findById(tree, folders.stock) as TreeFolderNode).rights.write,
946
- "clerk keeps write after resync",
947
- ).to.equal(true);
948
- });
949
- });
435
+ laterPermissionSuites();
950
436
  });