@antelopejs/dms-media 0.4.1 → 0.5.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 (122) hide show
  1. package/README.md +4 -3
  2. package/dist/bindings.d.ts +4 -1
  3. package/dist/bindings.js +21 -0
  4. package/dist/bindings.js.map +1 -1
  5. package/dist/db/models/index.d.ts +1 -0
  6. package/dist/db/models/index.js +1 -0
  7. package/dist/db/models/index.js.map +1 -1
  8. package/dist/db/models/mediaAssets.model.d.ts +1 -0
  9. package/dist/db/models/mediaAssets.model.js +19 -0
  10. package/dist/db/models/mediaAssets.model.js.map +1 -1
  11. package/dist/db/models/mediaDeclarations.model.d.ts +24 -0
  12. package/dist/db/models/mediaDeclarations.model.js +13 -0
  13. package/dist/db/models/mediaDeclarations.model.js.map +1 -0
  14. package/dist/db/models/mediaFolders.model.d.ts +3 -0
  15. package/dist/db/models/mediaFolders.model.js +29 -0
  16. package/dist/db/models/mediaFolders.model.js.map +1 -1
  17. package/dist/db/tables/index.d.ts +1 -0
  18. package/dist/db/tables/index.js +1 -0
  19. package/dist/db/tables/index.js.map +1 -1
  20. package/dist/db/tables/mediaDeclarations.table.d.ts +15 -0
  21. package/dist/db/tables/mediaDeclarations.table.js +65 -0
  22. package/dist/db/tables/mediaDeclarations.table.js.map +1 -0
  23. package/dist/declared/assets.d.ts +4 -0
  24. package/dist/declared/assets.js +269 -0
  25. package/dist/declared/assets.js.map +1 -0
  26. package/dist/declared/folders.d.ts +10 -0
  27. package/dist/declared/folders.js +154 -0
  28. package/dist/declared/folders.js.map +1 -0
  29. package/dist/declared/index.d.ts +5 -0
  30. package/dist/declared/index.js +22 -0
  31. package/dist/declared/index.js.map +1 -0
  32. package/dist/declared/readiness.d.ts +2 -0
  33. package/dist/declared/readiness.js +52 -0
  34. package/dist/declared/readiness.js.map +1 -0
  35. package/dist/declared/records.d.ts +46 -0
  36. package/dist/declared/records.js +94 -0
  37. package/dist/declared/records.js.map +1 -0
  38. package/dist/declared/retire.d.ts +3 -0
  39. package/dist/declared/retire.js +118 -0
  40. package/dist/declared/retire.js.map +1 -0
  41. package/dist/implementations/interface-dms-media/index.d.ts +5 -0
  42. package/dist/implementations/interface-dms-media/index.js +5 -0
  43. package/dist/implementations/interface-dms-media/index.js.map +1 -1
  44. package/dist/library/events.d.ts +2 -1
  45. package/dist/library/events.js.map +1 -1
  46. package/dist/routes/media/assets.js +19 -4
  47. package/dist/routes/media/assets.js.map +1 -1
  48. package/dist/routes/media/context.d.ts +1 -1
  49. package/dist/routes/media/context.js.map +1 -1
  50. package/dist/routes/media/dto.d.ts +1 -0
  51. package/dist/routes/media/dto.js +3 -1
  52. package/dist/routes/media/dto.js.map +1 -1
  53. package/dist/routes/media/folders.d.ts +6 -0
  54. package/dist/routes/media/folders.js +25 -13
  55. package/dist/routes/media/folders.js.map +1 -1
  56. package/dist/routes/media/upload.d.ts +1 -1
  57. package/dist/routes/media/upload.js +26 -58
  58. package/dist/routes/media/upload.js.map +1 -1
  59. package/dist/test/integration/media-declared-content.test.d.ts +1 -0
  60. package/dist/test/integration/media-declared-content.test.js +705 -0
  61. package/dist/test/integration/media-declared-content.test.js.map +1 -0
  62. package/dist/test/integration/media-declared-retire.test.d.ts +1 -0
  63. package/dist/test/integration/media-declared-retire.test.js +186 -0
  64. package/dist/test/integration/media-declared-retire.test.js.map +1 -0
  65. package/dist/test/integration/media-delivery-editing.test.js +26 -0
  66. package/dist/test/integration/media-delivery-editing.test.js.map +1 -1
  67. package/dist/test/integration/media-linked-subfolders.test.d.ts +1 -0
  68. package/dist/test/integration/media-linked-subfolders.test.js +192 -0
  69. package/dist/test/integration/media-linked-subfolders.test.js.map +1 -0
  70. package/dist/test/unit/declared.test.d.ts +1 -0
  71. package/dist/test/unit/declared.test.js +118 -0
  72. package/dist/test/unit/declared.test.js.map +1 -0
  73. package/dist/upload-checks.d.ts +18 -0
  74. package/dist/upload-checks.js +75 -0
  75. package/dist/upload-checks.js.map +1 -0
  76. package/dist/validation/declared.schema.d.ts +187 -0
  77. package/dist/validation/declared.schema.js +78 -0
  78. package/dist/validation/declared.schema.js.map +1 -0
  79. package/dist/validation/media.schema.d.ts +3 -0
  80. package/dist/validation/media.schema.js +12 -12
  81. package/dist/validation/media.schema.js.map +1 -1
  82. package/frontend-vue/app/components/dialogs/DestinationDialog.vue +1 -1
  83. package/frontend-vue/app/components/dialogs/MoveDialog.vue +2 -2
  84. package/frontend-vue/app/components/explorer/ExplorerContent.vue +1 -1
  85. package/frontend-vue/app/components/explorer/ExplorerToolbar.vue +1 -1
  86. package/frontend-vue/app/components/shared/AssetThumb.vue +3 -1
  87. package/frontend-vue/app/composables/library/explorerMenus.ts +1 -1
  88. package/frontend-vue/app/composables/library/useExplorerCommands.ts +1 -1
  89. package/frontend-vue/app/composables/library/useExplorerDrop.ts +1 -1
  90. package/frontend-vue/app/types/media.ts +3 -1
  91. package/frontend-vue/tests/serverRender.test.ts +2 -1
  92. package/package.json +2 -2
  93. package/skills/dms-media/SKILL.md +50 -4
  94. package/src/bindings.ts +28 -0
  95. package/src/db/models/index.ts +1 -0
  96. package/src/db/models/mediaAssets.model.ts +25 -0
  97. package/src/db/models/mediaDeclarations.model.ts +19 -0
  98. package/src/db/models/mediaFolders.model.ts +44 -0
  99. package/src/db/tables/index.ts +1 -0
  100. package/src/db/tables/mediaDeclarations.table.ts +59 -0
  101. package/src/declared/assets.ts +446 -0
  102. package/src/declared/folders.ts +273 -0
  103. package/src/declared/index.ts +5 -0
  104. package/src/declared/readiness.ts +64 -0
  105. package/src/declared/records.ts +185 -0
  106. package/src/declared/retire.ts +206 -0
  107. package/src/implementations/interface-dms-media/index.ts +10 -0
  108. package/src/library/events.ts +4 -1
  109. package/src/routes/media/assets.ts +34 -5
  110. package/src/routes/media/context.ts +1 -1
  111. package/src/routes/media/dto.ts +6 -2
  112. package/src/routes/media/folders.ts +47 -21
  113. package/src/routes/media/upload.ts +50 -121
  114. package/src/test/integration/media-declared-content.test.ts +844 -0
  115. package/src/test/integration/media-declared-retire.test.ts +257 -0
  116. package/src/test/integration/media-delivery-editing.test.ts +45 -0
  117. package/src/test/integration/media-linked-subfolders.test.ts +256 -0
  118. package/src/test/unit/declared.test.ts +158 -0
  119. package/src/upload-checks.ts +126 -0
  120. package/src/validation/declared.schema.ts +104 -0
  121. package/src/validation/media.schema.ts +7 -6
  122. package/frontend-vue/pnpm-workspace.yaml +0 -2
@@ -0,0 +1,257 @@
1
+ import { GetModel } from "@antelopejs/interface-database-decorators";
2
+ import { DEFAULT_TENANT_ID } from "@antelopejs/interface-dms/constants";
3
+ import {
4
+ EnsureMediaFolder,
5
+ ImportMediaAsset,
6
+ PruneMediaDeclarations,
7
+ RetireMediaDeclaration,
8
+ } from "@antelopejs/interface-dms-media";
9
+ import type { AxiosInstance } from "axios";
10
+ import { expect } from "chai";
11
+ import {
12
+ MediaAssetModel,
13
+ MediaDeclarationModel,
14
+ MediaEventModel,
15
+ MediaFolderModel,
16
+ } from "../../db";
17
+ import { authorizedClient } from "../helpers/http";
18
+ import { ensureOwnerSession } from "../helpers/owner";
19
+
20
+ const HTTP_OK = 200;
21
+ const PREFIX = "retire.";
22
+ const ROOT_KEY = "retire.root";
23
+ const tenantId = DEFAULT_TENANT_ID;
24
+
25
+ function folders() {
26
+ return GetModel(MediaFolderModel, tenantId);
27
+ }
28
+
29
+ function assets() {
30
+ return GetModel(MediaAssetModel, tenantId);
31
+ }
32
+
33
+ function declarations() {
34
+ return GetModel(MediaDeclarationModel, tenantId);
35
+ }
36
+
37
+ async function rejectionOf(promise: Promise<unknown>): Promise<Error> {
38
+ try {
39
+ await promise;
40
+ } catch (error) {
41
+ return error as Error;
42
+ }
43
+ throw new Error("Expected the call to be refused");
44
+ }
45
+
46
+ function textFile(key: string, folderKey: string, text: string) {
47
+ return ImportMediaAsset({
48
+ tenantId,
49
+ key,
50
+ folder: { key: folderKey },
51
+ name: `${key.slice(PREFIX.length)}.txt`,
52
+ mimetype: "text/plain",
53
+ source: { bytes: Buffer.from(text) },
54
+ });
55
+ }
56
+
57
+ /** The library rows still standing, deleting tombstones aside. */
58
+ async function liveAsset(id: string | undefined) {
59
+ const asset = await assets().get(id as string);
60
+ return asset && !asset.isDeleting ? asset : undefined;
61
+ }
62
+
63
+ describe("[integration] media declared content — retiring what the code no longer declares", () => {
64
+ let client: AxiosInstance;
65
+
66
+ before(async () => {
67
+ client = authorizedClient((await ensureOwnerSession()).accessToken);
68
+ await EnsureMediaFolder({ tenantId, key: ROOT_KEY, name: "Retired" });
69
+ });
70
+
71
+ after(async () => {
72
+ const all = await folders().getAll();
73
+ const root = all.find((folder) => folder.name === "Retired");
74
+ if (root) await client.delete(`/api/media/folders/${root._id}`);
75
+ const records = (await declarations().getAll()).filter((record) =>
76
+ record.key.startsWith(PREFIX),
77
+ );
78
+ await Promise.all(
79
+ records.map((record) => declarations().delete(record._id)),
80
+ );
81
+ });
82
+
83
+ it("removes a file still as declared, once, and forgets its key", async () => {
84
+ const file = await textFile("retire.untouched", ROOT_KEY, "Untouched");
85
+ const retired = await RetireMediaDeclaration({
86
+ tenantId,
87
+ kind: "asset",
88
+ key: "retire.untouched",
89
+ });
90
+ expect(retired).to.deep.equal({
91
+ kind: "asset",
92
+ key: "retire.untouched",
93
+ status: "removed",
94
+ id: file.id,
95
+ });
96
+ expect(await liveAsset(file.id)).to.equal(undefined);
97
+ expect(
98
+ await declarations().findByKey("asset", "retire.untouched"),
99
+ ).to.equal(undefined);
100
+ const events = await GetModel(MediaEventModel, tenantId).getBy(
101
+ "kind",
102
+ "asset.delete",
103
+ );
104
+ expect(events.some((event) => event.assetId === file.id)).to.equal(true);
105
+ expect(
106
+ (
107
+ await RetireMediaDeclaration({
108
+ tenantId,
109
+ kind: "asset",
110
+ key: "retire.untouched",
111
+ })
112
+ ).status,
113
+ ).to.equal("unknown");
114
+ // Declared again, the key creates new content.
115
+ const again = await textFile("retire.untouched", ROOT_KEY, "Untouched");
116
+ expect(again.status).to.equal("created");
117
+ expect(again.id).to.not.equal(file.id);
118
+ });
119
+
120
+ it("leaves a file a member changed, and hands it over to them", async () => {
121
+ const file = await textFile("retire.edited", ROOT_KEY, "Edited");
122
+ const rename = await client.post(`/api/media/assets/${file.id}/update`, {
123
+ name: "kept-by-member.txt",
124
+ });
125
+ expect(rename.status).to.equal(HTTP_OK);
126
+ const retired = await RetireMediaDeclaration({
127
+ tenantId,
128
+ kind: "asset",
129
+ key: "retire.edited",
130
+ });
131
+ expect(retired.status).to.equal("preserved");
132
+ expect((await liveAsset(file.id))?.name).to.equal("kept-by-member.txt");
133
+ expect(await declarations().findByKey("asset", "retire.edited")).to.equal(
134
+ undefined,
135
+ );
136
+ });
137
+
138
+ it("reports a file a member already deleted", async () => {
139
+ const file = await textFile("retire.gone", ROOT_KEY, "Gone");
140
+ await client.delete(`/api/media/assets/${file.id}`);
141
+ expect(
142
+ (
143
+ await RetireMediaDeclaration({
144
+ tenantId,
145
+ kind: "asset",
146
+ key: "retire.gone",
147
+ })
148
+ ).status,
149
+ ).to.equal("deleted");
150
+ });
151
+
152
+ it("keeps a declared folder holding a member's file", async () => {
153
+ const folder = await EnsureMediaFolder({
154
+ tenantId,
155
+ key: "retire.shared",
156
+ name: "Shared",
157
+ parent: ROOT_KEY,
158
+ });
159
+ await textFile("retire.shared-file", "retire.shared", "Shared");
160
+ const memberFolder = await client.post("/api/media/folders", {
161
+ name: "Member's",
162
+ parentId: folder.id,
163
+ });
164
+ expect(memberFolder.status).to.equal(HTTP_OK);
165
+ const results = await PruneMediaDeclarations({
166
+ tenantId,
167
+ prefix: "retire.shared",
168
+ keep: [],
169
+ });
170
+ expect(
171
+ results.map(({ kind, key, status }) => ({ kind, key, status })),
172
+ ).to.deep.equal([
173
+ { kind: "asset", key: "retire.shared-file", status: "removed" },
174
+ { kind: "folder", key: "retire.shared", status: "preserved" },
175
+ ]);
176
+ expect(await folders().get(folder.id as string)).to.not.equal(undefined);
177
+ });
178
+
179
+ it("prunes the stale declarations of a prefix, files first and deepest folders first", async () => {
180
+ await EnsureMediaFolder({
181
+ tenantId,
182
+ key: "retire.v1",
183
+ name: "Version 1",
184
+ parent: ROOT_KEY,
185
+ });
186
+ const nested = await EnsureMediaFolder({
187
+ tenantId,
188
+ key: "retire.v1.nested",
189
+ name: "Nested",
190
+ parent: "retire.v1",
191
+ });
192
+ const kept = await textFile("retire.v1.kept", "retire.v1", "Kept");
193
+ const stale = await textFile("retire.v1.stale", "retire.v1", "Stale");
194
+ const deep = await textFile("retire.v1.deep", "retire.v1.nested", "Deep");
195
+ const results = await PruneMediaDeclarations({
196
+ tenantId,
197
+ prefix: "retire.v1",
198
+ keep: ["retire.v1", "retire.v1.kept"],
199
+ });
200
+ expect(
201
+ results.map(({ kind, key, status }) => ({ kind, key, status })),
202
+ ).to.have.deep.members([
203
+ { kind: "asset", key: "retire.v1.stale", status: "removed" },
204
+ { kind: "asset", key: "retire.v1.deep", status: "removed" },
205
+ { kind: "folder", key: "retire.v1.nested", status: "removed" },
206
+ ]);
207
+ expect(results.at(-1)?.kind).to.equal("folder");
208
+ expect(await liveAsset(stale.id)).to.equal(undefined);
209
+ expect(await liveAsset(deep.id)).to.equal(undefined);
210
+ expect(await folders().get(nested.id as string)).to.equal(undefined);
211
+ expect(await liveAsset(kept.id)).to.not.equal(undefined);
212
+ // Pruning again finds nothing left to retire.
213
+ expect(
214
+ await PruneMediaDeclarations({
215
+ tenantId,
216
+ prefix: "retire.v1",
217
+ keep: ["retire.v1", "retire.v1.kept"],
218
+ }),
219
+ ).to.deep.equal([]);
220
+ expect(
221
+ (await textFile("retire.v1.kept", "retire.v1", "Kept")).status,
222
+ ).to.equal("unchanged");
223
+ });
224
+
225
+ it("refuses a blank prefix, an unknown kind and a missing tenant", async () => {
226
+ expect(
227
+ (
228
+ await rejectionOf(
229
+ PruneMediaDeclarations({ tenantId, prefix: " ", keep: [] }),
230
+ )
231
+ ).message,
232
+ ).to.contain("prefix");
233
+ expect(
234
+ (
235
+ await rejectionOf(
236
+ RetireMediaDeclaration({
237
+ tenantId,
238
+ // @ts-expect-error A JavaScript caller can pass any kind.
239
+ kind: "page",
240
+ key: "retire.page",
241
+ }),
242
+ )
243
+ ).message,
244
+ ).to.contain("kind");
245
+ expect(
246
+ (
247
+ await rejectionOf(
248
+ RetireMediaDeclaration({
249
+ tenantId: "",
250
+ kind: "asset",
251
+ key: "retire.no-tenant",
252
+ }),
253
+ )
254
+ ).message,
255
+ ).to.contain("tenantId");
256
+ });
257
+ });
@@ -27,6 +27,9 @@ const FOREIGN_ORIGIN = "https://shop.example.com";
27
27
  const EXIF_ROTATED_RIGHT = 6;
28
28
  const PHOTO_WIDTH = 40;
29
29
  const PHOTO_HEIGHT = 20;
30
+ const WIDE_SVG_WIDTH = 880;
31
+ const WIDE_SVG_HEIGHT = 240;
32
+ const WIDE_SVG_SOURCE = `<svg xmlns="http://www.w3.org/2000/svg" width="${WIDE_SVG_WIDTH}" height="${WIDE_SVG_HEIGHT}"><rect width="${WIDE_SVG_WIDTH}" height="${WIDE_SVG_HEIGHT}" fill="#f0a000"/></svg>`;
30
33
  const SVG_SOURCE =
31
34
  '<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20"><script>alert(1)</script><circle cx="10" cy="10" r="9"/></svg>';
32
35
 
@@ -305,6 +308,48 @@ describe("[integration] media delivery and editing — cache, orientation, activ
305
308
  expect(revalidated.status).to.equal(HTTP_NOT_MODIFIED);
306
309
  });
307
310
 
311
+ it("fits a wide vector inside its library thumbnail instead of cropping it", async () => {
312
+ const logo = await uploadAsset(
313
+ client,
314
+ folderId,
315
+ "wide-logo.svg",
316
+ "image/svg+xml",
317
+ Buffer.from(WIDE_SVG_SOURCE),
318
+ );
319
+ const banner = await uploadAsset(
320
+ client,
321
+ folderId,
322
+ "wide-banner.png",
323
+ "image/png",
324
+ await sharp({
325
+ create: {
326
+ // Larger than the thumb both ways, so its square crop shows.
327
+ width: WIDE_SVG_WIDTH * 2,
328
+ height: WIDE_SVG_HEIGHT * 2,
329
+ channels: 3,
330
+ background: { r: 240, g: 160, b: 0 },
331
+ },
332
+ })
333
+ .png()
334
+ .toBuffer(),
335
+ );
336
+ const answer = await client.post("/api/media/previews", {
337
+ ids: [logo.id, banner.id],
338
+ });
339
+ expect(answer.status).to.equal(HTTP_OK);
340
+ const [vector, raster] = await Promise.all(
341
+ [logo.id, banner.id].map(async (id) => {
342
+ const response = await fetch(answer.data.previews[id]);
343
+ return sharp(Buffer.from(await response.arrayBuffer())).metadata();
344
+ }),
345
+ );
346
+ expect((vector.width ?? 0) / (vector.height ?? 1)).to.be.closeTo(
347
+ WIDE_SVG_WIDTH / WIDE_SVG_HEIGHT,
348
+ 0.05,
349
+ );
350
+ expect(raster.width).to.equal(raster.height);
351
+ });
352
+
308
353
  it("never serves an HTML file inline", async () => {
309
354
  const id = await insertStoredAsset(
310
355
  folderId,
@@ -0,0 +1,256 @@
1
+ import type { AxiosInstance } from "axios";
2
+ import { expect } from "chai";
3
+ import { GetModel } from "@antelopejs/interface-database-decorators";
4
+ import { DEFAULT_TENANT_ID } from "@antelopejs/interface-dms/constants";
5
+ import {
6
+ EnsureMediaFolder,
7
+ ImportMediaAsset,
8
+ RegisterAssetBinding,
9
+ UnregisterAssetBinding,
10
+ } from "@antelopejs/interface-dms-media";
11
+ import { CONTENT_ROOT_BINDING } from "../../bindings";
12
+ import {
13
+ MediaAssetModel,
14
+ MediaDeclarationModel,
15
+ MediaFolderModel,
16
+ } from "../../db";
17
+ import { ONE_PIXEL_PNG, PNG_MIMETYPE } from "../helpers/assets";
18
+ import { authorizedClient } from "../helpers/http";
19
+ import { ensureOwnerSession } from "../helpers/owner";
20
+
21
+ const HTTP_OK = 200;
22
+ const HTTP_FORBIDDEN = 403;
23
+ const HTTP_UNSUPPORTED_MEDIA_TYPE = 415;
24
+ const OPEN_BINDING_ID = "subfolders.photos";
25
+ const LOCKED_BINDING_ID = "subfolders.locked";
26
+ const KEY_PREFIX = "subfolders.";
27
+ const ERRORS = "$dms_media.errors";
28
+
29
+ interface FolderNode {
30
+ id: string;
31
+ name: string;
32
+ parentId: string | null;
33
+ binding: string | null;
34
+ acceptsSubfolders: boolean;
35
+ accepts: string[] | null;
36
+ }
37
+
38
+ function folders() {
39
+ return GetModel(MediaFolderModel, DEFAULT_TENANT_ID);
40
+ }
41
+
42
+ async function rejectionOf(promise: Promise<unknown>): Promise<Error> {
43
+ try {
44
+ await promise;
45
+ } catch (error) {
46
+ return error as Error;
47
+ }
48
+ throw new Error("Expected the declaration to be refused");
49
+ }
50
+
51
+ /** Linked folders are locked through the API: later suites expect an empty library. */
52
+ async function removeLinkedFolders(): Promise<void> {
53
+ const folderModel = folders();
54
+ const assetModel = GetModel(MediaAssetModel, DEFAULT_TENANT_ID);
55
+ const linked = await folderModel.getBy(
56
+ "binding",
57
+ OPEN_BINDING_ID,
58
+ LOCKED_BINDING_ID,
59
+ );
60
+ const all = await folderModel.getAll();
61
+ const doomed = all.filter((folder) =>
62
+ linked.some(
63
+ (entry) => entry._id === folder._id || folder.path.includes(entry._id),
64
+ ),
65
+ );
66
+ const assets = await assetModel.getBy(
67
+ "folderId",
68
+ ...doomed.map((folder) => folder._id),
69
+ );
70
+ await Promise.all(assets.map((asset) => assetModel.delete(asset._id)));
71
+ await Promise.all(doomed.map((folder) => folderModel.delete(folder._id)));
72
+ const declarationModel = GetModel(MediaDeclarationModel, DEFAULT_TENANT_ID);
73
+ const declarations = (await declarationModel.getAll()).filter((entry) =>
74
+ entry.key.startsWith(KEY_PREFIX),
75
+ );
76
+ await Promise.all(
77
+ declarations.map((entry) => declarationModel.delete(entry._id)),
78
+ );
79
+ const [contentRoot] = await folderModel.getBy(
80
+ "binding",
81
+ CONTENT_ROOT_BINDING,
82
+ );
83
+ if (!contentRoot) return;
84
+ const children = await folderModel.getBy("parentId", contentRoot._id);
85
+ if (children.length === 0) await folderModel.delete(contentRoot._id);
86
+ }
87
+
88
+ describe("[integration] media linked subfolders — bindings that allow them", () => {
89
+ let client: AxiosInstance;
90
+
91
+ async function treeFolder(binding: string): Promise<FolderNode> {
92
+ const tree = await client.get("/api/media/tree");
93
+ const folder = (tree.data.folders as FolderNode[]).find(
94
+ (entry) => entry.binding === binding,
95
+ );
96
+ if (!folder) throw new Error(`No folder linked to ${binding}`);
97
+ return folder;
98
+ }
99
+
100
+ before(async () => {
101
+ RegisterAssetBinding({
102
+ id: OPEN_BINDING_ID,
103
+ folderName: "Project photos",
104
+ subfolders: true,
105
+ field: { mimetypes: ["image/*"] },
106
+ });
107
+ RegisterAssetBinding({ id: LOCKED_BINDING_ID, folderName: "Locked" });
108
+ client = authorizedClient((await ensureOwnerSession()).accessToken);
109
+ });
110
+
111
+ after(async () => {
112
+ UnregisterAssetBinding(OPEN_BINDING_ID);
113
+ UnregisterAssetBinding(LOCKED_BINDING_ID);
114
+ await removeLinkedFolders();
115
+ });
116
+
117
+ it("tells the explorer which linked folders take subfolders", async () => {
118
+ expect((await treeFolder(OPEN_BINDING_ID)).acceptsSubfolders).to.equal(
119
+ true,
120
+ );
121
+ expect((await treeFolder(LOCKED_BINDING_ID)).acceptsSubfolders).to.equal(
122
+ false,
123
+ );
124
+ expect((await treeFolder(CONTENT_ROOT_BINDING)).acceptsSubfolders).to.equal(
125
+ false,
126
+ );
127
+ });
128
+
129
+ it("lets an owner create a subfolder where the binding allows it, and keeps the linked folder locked", async () => {
130
+ const linked = await treeFolder(OPEN_BINDING_ID);
131
+ const created = await client.post("/api/media/folders", {
132
+ name: "Project A",
133
+ parentId: linked.id,
134
+ });
135
+ expect(created.status).to.equal(HTTP_OK);
136
+ const locked = await treeFolder(LOCKED_BINDING_ID);
137
+ const refused = await client.post("/api/media/folders", {
138
+ name: "Project A",
139
+ parentId: locked.id,
140
+ });
141
+ expect(refused.status).to.equal(HTTP_FORBIDDEN);
142
+ expect(refused.data).to.equal(`${ERRORS}.bound_parent`);
143
+ const rename = await client.post(`/api/media/folders/${linked.id}/rename`, {
144
+ name: "Renamed",
145
+ });
146
+ expect(rename.status).to.equal(HTTP_FORBIDDEN);
147
+ const tree = await client.get("/api/media/tree");
148
+ const subfolder = (tree.data.folders as FolderNode[]).find(
149
+ (folder) => folder.id === created.data.id,
150
+ );
151
+ expect(subfolder?.acceptsSubfolders).to.equal(true);
152
+ expect(subfolder?.accepts).to.deep.equal(["image/*"]);
153
+ });
154
+
155
+ it("applies the field's types to uploads into a subfolder", async () => {
156
+ const linked = await treeFolder(OPEN_BINDING_ID);
157
+ const created = await client.post("/api/media/folders", {
158
+ name: "Project B",
159
+ parentId: linked.id,
160
+ });
161
+ const nested = await client.post("/api/media/folders", {
162
+ name: "Roof",
163
+ parentId: created.data.id,
164
+ });
165
+ const presign = (filename: string, mimetype: string) =>
166
+ client.post("/api/media/upload/presign", {
167
+ folderId: nested.data.id,
168
+ filename,
169
+ size: 4,
170
+ mimetype,
171
+ });
172
+ const text = await presign("notes.txt", "text/plain");
173
+ expect(text.status).to.equal(HTTP_UNSUPPORTED_MEDIA_TYPE);
174
+ expect(text.data.reason).to.equal("field_type");
175
+ expect((await presign("photo.png", "image/png")).status).to.equal(HTTP_OK);
176
+ });
177
+
178
+ it("declares per-record folders under a linked folder that allows them", async () => {
179
+ const linked = await treeFolder(OPEN_BINDING_ID);
180
+ const project = await EnsureMediaFolder({
181
+ tenantId: DEFAULT_TENANT_ID,
182
+ key: "subfolders.project-c",
183
+ name: "Project C",
184
+ parent: { binding: OPEN_BINDING_ID },
185
+ });
186
+ expect(project.status).to.equal("created");
187
+ expect((await folders().get(project.id as string))?.parentId).to.equal(
188
+ linked.id,
189
+ );
190
+ const again = await EnsureMediaFolder({
191
+ tenantId: DEFAULT_TENANT_ID,
192
+ key: "subfolders.project-c",
193
+ name: "Project C",
194
+ parent: { binding: OPEN_BINDING_ID },
195
+ });
196
+ expect(again).to.deep.equal({ status: "unchanged", id: project.id });
197
+ const nested = await EnsureMediaFolder({
198
+ tenantId: DEFAULT_TENANT_ID,
199
+ key: "subfolders.project-c.roof",
200
+ name: "Roof",
201
+ parent: { key: "subfolders.project-c" },
202
+ });
203
+ expect(nested.status).to.equal("created");
204
+ // A declared parent named by its key alone is the same declaration.
205
+ const sameParent = await EnsureMediaFolder({
206
+ tenantId: DEFAULT_TENANT_ID,
207
+ key: "subfolders.project-c.roof",
208
+ name: "Roof",
209
+ parent: "subfolders.project-c",
210
+ });
211
+ expect(sameParent).to.deep.equal({ status: "unchanged", id: nested.id });
212
+ const photo = await ImportMediaAsset({
213
+ tenantId: DEFAULT_TENANT_ID,
214
+ key: "subfolders.project-c.roof.photo",
215
+ folder: { key: "subfolders.project-c.roof" },
216
+ name: "roof.png",
217
+ mimetype: PNG_MIMETYPE,
218
+ source: { bytes: ONE_PIXEL_PNG },
219
+ });
220
+ expect(photo.status).to.equal("created");
221
+ const notes = await rejectionOf(
222
+ ImportMediaAsset({
223
+ tenantId: DEFAULT_TENANT_ID,
224
+ key: "subfolders.project-c.roof.notes",
225
+ folder: { key: "subfolders.project-c.roof" },
226
+ name: "notes.txt",
227
+ mimetype: "text/plain",
228
+ source: { bytes: Buffer.from("notes") },
229
+ }),
230
+ );
231
+ expect(notes.message).to.contain("only accepts image/*");
232
+ });
233
+
234
+ it("refuses a declared subfolder under a linked folder that does not allow them", async () => {
235
+ const locked = await rejectionOf(
236
+ EnsureMediaFolder({
237
+ tenantId: DEFAULT_TENANT_ID,
238
+ key: "subfolders.locked-child",
239
+ name: "Child",
240
+ parent: { binding: LOCKED_BINDING_ID },
241
+ }),
242
+ );
243
+ expect(locked.message)
244
+ .to.contain("subfolders.locked-child")
245
+ .and.contain("cannot hold subfolders");
246
+ const unknown = await rejectionOf(
247
+ EnsureMediaFolder({
248
+ tenantId: DEFAULT_TENANT_ID,
249
+ key: "subfolders.unknown-child",
250
+ name: "Child",
251
+ parent: { binding: "subfolders.never-registered" },
252
+ }),
253
+ );
254
+ expect(unknown.message).to.contain("no folder is bound");
255
+ });
256
+ });