@antelopejs/dms-media 0.7.2 → 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 (164) 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/library/folder-stats.d.ts +1 -1
  26. package/dist/library/folder-stats.js.map +1 -1
  27. package/dist/library/listing.d.ts +2 -0
  28. package/dist/library/listing.js +14 -4
  29. package/dist/library/listing.js.map +1 -1
  30. package/dist/routes/media/assets.d.ts +3 -2
  31. package/dist/routes/media/assets.js +15 -10
  32. package/dist/routes/media/assets.js.map +1 -1
  33. package/dist/routes/media/bulk.js +4 -4
  34. package/dist/routes/media/bulk.js.map +1 -1
  35. package/dist/routes/media/folders.js +4 -4
  36. package/dist/routes/media/folders.js.map +1 -1
  37. package/dist/routes/media/library.js +6 -12
  38. package/dist/routes/media/library.js.map +1 -1
  39. package/dist/routes/media/storage-keys.js +10 -1
  40. package/dist/routes/media/storage-keys.js.map +1 -1
  41. package/dist/test/helpers/assets.d.ts +2 -2
  42. package/dist/test/helpers/folders.d.ts +6 -6
  43. package/dist/test/helpers/permissions-world.d.ts +6 -6
  44. package/dist/test/integration/binding-folder-race.test.d.ts +1 -0
  45. package/dist/test/integration/binding-folder-race.test.js +66 -0
  46. package/dist/test/integration/binding-folder-race.test.js.map +1 -0
  47. package/dist/test/integration/declared-asset-race.test.d.ts +1 -0
  48. package/dist/test/integration/declared-asset-race.test.js +78 -0
  49. package/dist/test/integration/declared-asset-race.test.js.map +1 -0
  50. package/dist/test/integration/declared-folder-race.test.d.ts +1 -0
  51. package/dist/test/integration/declared-folder-race.test.js +43 -0
  52. package/dist/test/integration/declared-folder-race.test.js.map +1 -0
  53. package/dist/test/integration/media-activity-overview.test.js +27 -22
  54. package/dist/test/integration/media-activity-overview.test.js.map +1 -1
  55. package/dist/test/integration/media-api.test.js +9 -5
  56. package/dist/test/integration/media-api.test.js.map +1 -1
  57. package/dist/test/integration/media-bindings.test.js +16 -13
  58. package/dist/test/integration/media-bindings.test.js.map +1 -1
  59. package/dist/test/integration/media-cleanup.test.js +14 -5
  60. package/dist/test/integration/media-cleanup.test.js.map +1 -1
  61. package/dist/test/integration/media-declared-content.test.js +107 -91
  62. package/dist/test/integration/media-declared-content.test.js.map +1 -1
  63. package/dist/test/integration/media-delivery-editing.test.js +238 -215
  64. package/dist/test/integration/media-delivery-editing.test.js.map +1 -1
  65. package/dist/test/integration/media-explorer-writes.test.js +131 -112
  66. package/dist/test/integration/media-explorer-writes.test.js.map +1 -1
  67. package/dist/test/integration/media-guards.test.js +38 -37
  68. package/dist/test/integration/media-guards.test.js.map +1 -1
  69. package/dist/test/integration/media-library.test.js +244 -224
  70. package/dist/test/integration/media-library.test.js.map +1 -1
  71. package/dist/test/integration/media-linked-subfolders.test.js +173 -158
  72. package/dist/test/integration/media-linked-subfolders.test.js.map +1 -1
  73. package/dist/test/integration/media-permissions.test.js +31 -11
  74. package/dist/test/integration/media-permissions.test.js.map +1 -1
  75. package/dist/test/integration/media-search-query.test.js +8 -6
  76. package/dist/test/integration/media-search-query.test.js.map +1 -1
  77. package/dist/test/integration/media-search-views.test.js +12 -8
  78. package/dist/test/integration/media-search-views.test.js.map +1 -1
  79. package/dist/test/integration/media-upload-policy.test.js +228 -200
  80. package/dist/test/integration/media-upload-policy.test.js.map +1 -1
  81. package/dist/test/stack-modules.json +5 -5
  82. package/dist/test/unit/acl/entries.test.js +19 -0
  83. package/dist/test/unit/acl/entries.test.js.map +1 -1
  84. package/dist/test/unit/acl/resolver.test.js +9 -1
  85. package/dist/test/unit/acl/resolver.test.js.map +1 -1
  86. package/dist/test/unit/asset-lifecycle.test.d.ts +1 -0
  87. package/dist/test/unit/asset-lifecycle.test.js +18 -0
  88. package/dist/test/unit/asset-lifecycle.test.js.map +1 -0
  89. package/dist/test/unit/library/zip-names.test.js +6 -3
  90. package/dist/test/unit/library/zip-names.test.js.map +1 -1
  91. package/dist/test/unit/routes/storage-keys.test.d.ts +1 -0
  92. package/dist/test/unit/routes/storage-keys.test.js +18 -0
  93. package/dist/test/unit/routes/storage-keys.test.js.map +1 -0
  94. package/dist/test/unit/transform-ops.test.js +19 -0
  95. package/dist/test/unit/transform-ops.test.js.map +1 -1
  96. package/dist/transform-ops.js +25 -1
  97. package/dist/transform-ops.js.map +1 -1
  98. package/dist/validation/declared.schema.d.ts +6 -6
  99. package/dist/validation/library.schema.d.ts +4 -4
  100. package/dist/validation/media.schema.d.ts +5 -5
  101. package/dist/validation/media.schema.js +10 -6
  102. package/dist/validation/media.schema.js.map +1 -1
  103. package/frontend-vue/app/components/Explorer.vue +2 -0
  104. package/frontend-vue/app/components/FileProperties.vue +1 -1
  105. package/frontend-vue/app/components/ImageEditor.vue +5 -5
  106. package/frontend-vue/app/components/RecentFiles.vue +2 -2
  107. package/frontend-vue/app/components/UploadQueue.vue +4 -4
  108. package/frontend-vue/app/components/dialogs/DeleteFilesDialog.vue +1 -1
  109. package/frontend-vue/app/components/dialogs/ShortcutsDialog.vue +1 -1
  110. package/frontend-vue/app/components/dialogs/VisibilityDialog.vue +1 -1
  111. package/frontend-vue/app/components/explorer/ExplorerInspector.vue +1 -1
  112. package/frontend-vue/app/components/explorer/ExplorerSidebar.vue +2 -2
  113. package/frontend-vue/app/components/explorer/FolderStrip.vue +1 -1
  114. package/frontend-vue/app/components/explorer/GridView.vue +1 -1
  115. package/frontend-vue/app/components/shared/AltTextField.vue +2 -2
  116. package/frontend-vue/build/backend-boundary.ts +8 -3
  117. package/frontend-vue/eslint.config.mjs +0 -1
  118. package/frontend-vue/package.json +2 -2
  119. package/frontend-vue/pnpm-lock.yaml +45 -14
  120. package/frontend-vue/tests/backend-boundary.test.ts +6 -4
  121. package/frontend-vue/tests/fixtures/serverRender.ts +3 -3
  122. package/frontend-vue/tests/registration.test.ts +5 -0
  123. package/frontend-vue/tsconfig.json +1 -2
  124. package/package.json +17 -17
  125. package/src/acl/entries.ts +30 -7
  126. package/src/asset-lifecycle.ts +6 -2
  127. package/src/bindings.ts +41 -38
  128. package/src/declared/assets.ts +45 -28
  129. package/src/declared/folders.ts +30 -20
  130. package/src/declared/records.ts +31 -2
  131. package/src/fixed-id.ts +18 -0
  132. package/src/library/folder-stats.ts +1 -1
  133. package/src/library/listing.ts +24 -4
  134. package/src/routes/media/assets.ts +23 -11
  135. package/src/routes/media/bulk.ts +7 -5
  136. package/src/routes/media/folders.ts +9 -5
  137. package/src/routes/media/library.ts +10 -18
  138. package/src/routes/media/storage-keys.ts +14 -2
  139. package/src/test/integration/binding-folder-race.test.ts +82 -0
  140. package/src/test/integration/declared-asset-race.test.ts +115 -0
  141. package/src/test/integration/declared-folder-race.test.ts +50 -0
  142. package/src/test/integration/media-activity-overview.test.ts +40 -27
  143. package/src/test/integration/media-api.test.ts +9 -5
  144. package/src/test/integration/media-bindings.test.ts +17 -13
  145. package/src/test/integration/media-cleanup.test.ts +17 -5
  146. package/src/test/integration/media-declared-content.test.ts +129 -112
  147. package/src/test/integration/media-delivery-editing.test.ts +323 -299
  148. package/src/test/integration/media-explorer-writes.test.ts +161 -135
  149. package/src/test/integration/media-guards.test.ts +40 -38
  150. package/src/test/integration/media-library.test.ts +325 -296
  151. package/src/test/integration/media-linked-subfolders.test.ts +207 -186
  152. package/src/test/integration/media-permissions.test.ts +33 -14
  153. package/src/test/integration/media-search-query.test.ts +24 -8
  154. package/src/test/integration/media-search-views.test.ts +39 -32
  155. package/src/test/integration/media-upload-policy.test.ts +283 -254
  156. package/src/test/stack-modules.json +5 -5
  157. package/src/test/unit/acl/entries.test.ts +23 -0
  158. package/src/test/unit/acl/resolver.test.ts +9 -1
  159. package/src/test/unit/asset-lifecycle.test.ts +21 -0
  160. package/src/test/unit/library/zip-names.test.ts +9 -7
  161. package/src/test/unit/routes/storage-keys.test.ts +23 -0
  162. package/src/test/unit/transform-ops.test.ts +29 -1
  163. package/src/transform-ops.ts +32 -2
  164. package/src/validation/media.schema.ts +14 -15
@@ -75,7 +75,7 @@ const articlesPermissionAcl: AclEntry[] = [
75
75
  },
76
76
  ];
77
77
 
78
- describe("[unit] acl/resolver — resolveFolderAccess", () => {
78
+ describe("[unit] acl/resolver — resolveFolderAccess: owner wildcard and root ACL", () => {
79
79
  it("grants everything everywhere to the owner wildcard", () => {
80
80
  const folders = [
81
81
  buildFolder({ id: "a" }),
@@ -119,7 +119,9 @@ describe("[unit] acl/resolver — resolveFolderAccess", () => {
119
119
  expect(manager.writable.has("root")).to.equal(true);
120
120
  expect(manager.manageable.has("root")).to.equal(true);
121
121
  });
122
+ });
122
123
 
124
+ describe("[unit] acl/resolver — resolveFolderAccess: inheritance and overrides", () => {
123
125
  it("propagates the parent's effective rights when a child has no ACL", () => {
124
126
  const folders = [
125
127
  buildFolder({ id: "parent", acl: editorsRoleAcl }),
@@ -174,7 +176,9 @@ describe("[unit] acl/resolver — resolveFolderAccess", () => {
174
176
  );
175
177
  expect(outsider.readable.has("articles-assets")).to.equal(false);
176
178
  });
179
+ });
177
180
 
181
+ describe("[unit] acl/resolver — resolveFolderAccess: shells and unreachable folders", () => {
178
182
  it("returns non-readable ancestors of readable folders as shells", () => {
179
183
  const folders = [
180
184
  buildFolder({ id: "top", acl: [] }),
@@ -223,7 +227,9 @@ describe("[unit] acl/resolver — resolveFolderAccess", () => {
223
227
  expect(reader.manageable.size).to.equal(0);
224
228
  expect(reader.shells.size).to.equal(0);
225
229
  });
230
+ });
226
231
 
232
+ describe("[unit] acl/resolver — resolveRootRights and the owner wildcard", () => {
227
233
  it("grants members nothing at the root by default", () => {
228
234
  const folders = [buildFolder({ id: "root" })];
229
235
  const actor = buildActor([MEDIA_PAGE_PERMISSION]);
@@ -266,7 +272,9 @@ describe("[unit] acl/resolver — resolveFolderAccess", () => {
266
272
  expect(rights.has("write")).to.equal(true);
267
273
  expect(rights.has("manage")).to.equal(false);
268
274
  });
275
+ });
269
276
 
277
+ describe("[unit] acl/resolver — resolveFolderAccess: malformed and cyclic input", () => {
270
278
  it("fails closed instead of inheriting when a stored ACL is malformed", () => {
271
279
  const folders = [
272
280
  buildFolder({ id: "root", acl: editorsRoleAcl }),
@@ -0,0 +1,21 @@
1
+ import { expect } from "chai";
2
+ import { retiredFiles } from "../../asset-lifecycle";
3
+ import { asset } from "./library/fixtures";
4
+
5
+ describe("[unit] asset-lifecycle — retiredFiles", () => {
6
+ it("reads the queue as the module writes it", () => {
7
+ const queue = ["a/original.jpg", "a/derivative.webp"];
8
+ expect(
9
+ retiredFiles(asset("a", { json_retiredFiles: JSON.stringify(queue) })),
10
+ ).to.deep.equal(queue);
11
+ expect(retiredFiles(asset("a"))).to.deep.equal([]);
12
+ });
13
+
14
+ it("refuses a queue that is not a list of storage keys", () => {
15
+ for (const json_retiredFiles of ['["a.jpg", 7]', '{"a":"a.jpg"}', '"a"']) {
16
+ expect(() => retiredFiles(asset("a", { json_retiredFiles }))).to.throw(
17
+ "Media asset 'a' has a file deletion queue that is not a list of storage keys",
18
+ );
19
+ }
20
+ });
21
+ });
@@ -4,7 +4,7 @@ import { z } from "zod";
4
4
  import { portableName, uniqueEntryName } from "../../../library/zip";
5
5
  import {
6
6
  comparableName,
7
- parseBody,
7
+ rejectInvalid,
8
8
  updateAssetSchema,
9
9
  } from "../../../validation/media.schema";
10
10
 
@@ -56,16 +56,18 @@ describe("[unit] library/zip — entry names and name rules", () => {
56
56
  throw new Error("expected the body to be refused");
57
57
  };
58
58
  const forbidden = refused(() =>
59
- parseBody({ name: "a|b.png" }, updateAssetSchema),
59
+ rejectInvalid(() => updateAssetSchema.parse({ name: "a|b.png" })),
60
60
  );
61
61
  expect(forbidden.getStatus()).to.equal(HTTP_BAD_REQUEST);
62
62
  expect(forbidden.getBody()).to.equal("$dms_media.errors.name_forbidden");
63
63
  const crashed = refused(() =>
64
- parseBody(
65
- {},
66
- z.unknown().transform(() => {
67
- throw new Error("boom");
68
- }),
64
+ rejectInvalid(() =>
65
+ z
66
+ .unknown()
67
+ .transform(() => {
68
+ throw new Error("boom");
69
+ })
70
+ .parse({}),
69
71
  ),
70
72
  );
71
73
  expect(crashed.getStatus()).to.equal(HTTP_BAD_REQUEST);
@@ -0,0 +1,23 @@
1
+ import { expect } from "chai";
2
+ import { parseDerivatives } from "../../../routes/media/storage-keys";
3
+ import { asset } from "../library/fixtures";
4
+
5
+ describe("[unit] routes/media/storage-keys — parseDerivatives", () => {
6
+ it("reads image sizes as the module writes them", () => {
7
+ const sizes = { "w=320": "a/320.webp", "w=640": "a/640.webp" };
8
+ expect(
9
+ parseDerivatives(asset("a", { json_derivatives: JSON.stringify(sizes) })),
10
+ ).to.deep.equal(sizes);
11
+ expect(
12
+ parseDerivatives(asset("a", { json_derivatives: "" })),
13
+ ).to.deep.equal({});
14
+ });
15
+
16
+ it("refuses image sizes that are not a map of storage keys", () => {
17
+ for (const json_derivatives of ['["a/320.webp"]', '{"w=320":7}', "null"]) {
18
+ expect(() => parseDerivatives(asset("a", { json_derivatives }))).to.throw(
19
+ "Media asset 'a' has image sizes that are not a map of storage keys",
20
+ );
21
+ }
22
+ });
23
+ });
@@ -1,5 +1,33 @@
1
1
  import { expect } from "chai";
2
- import { composeTransforms } from "../../transform-ops";
2
+ import { composeTransforms, parseTransform } from "../../transform-ops";
3
+
4
+ describe("[unit] transform-ops — parseTransform", () => {
5
+ it("reads image edits as the module writes them", () => {
6
+ const edits = composeTransforms(
7
+ { crop: { x: 0, y: 0, width: 0.5, height: 0.25 } },
8
+ { rotate: 90 },
9
+ );
10
+ expect(parseTransform(JSON.stringify(edits))).to.deep.equal(
11
+ JSON.parse(JSON.stringify(edits)),
12
+ );
13
+ const undone = composeTransforms({ rotate: 90 }, { rotate: 270 });
14
+ expect(parseTransform(JSON.stringify(undone))).to.deep.equal({});
15
+ expect(parseTransform("")).to.deep.equal({});
16
+ });
17
+
18
+ it("refuses stored edits that are not crop and rotate operations", () => {
19
+ for (const json of [
20
+ '{"rotate":"90"}',
21
+ '{"crop":{"x":0,"y":0,"width":1}}',
22
+ '{"crop":null}',
23
+ "[]",
24
+ ]) {
25
+ expect(() => parseTransform(json)).to.throw(
26
+ "Stored image edits are not crop and rotate operations",
27
+ );
28
+ }
29
+ });
30
+ });
3
31
 
4
32
  describe("[unit] transform-ops — composeTransforms", () => {
5
33
  it("adds rotations and drops a full turn", () => {
@@ -1,3 +1,5 @@
1
+ import { isObject } from "./guards";
2
+
1
3
  export interface CropRegion {
2
4
  x: number;
3
5
  y: number;
@@ -73,8 +75,36 @@ export function composeTransforms(
73
75
  };
74
76
  }
75
77
 
78
+ function isNumber(value: unknown): value is number {
79
+ return typeof value === "number";
80
+ }
81
+
82
+ function isCropRegion(value: unknown): value is CropRegion {
83
+ return (
84
+ isObject(value) &&
85
+ "x" in value &&
86
+ isNumber(value.x) &&
87
+ "y" in value &&
88
+ isNumber(value.y) &&
89
+ "width" in value &&
90
+ isNumber(value.width) &&
91
+ "height" in value &&
92
+ isNumber(value.height)
93
+ );
94
+ }
95
+
96
+ function isTransformOps(value: unknown): value is ImageTransformOps {
97
+ return (
98
+ isObject(value) &&
99
+ !Array.isArray(value) &&
100
+ (!("crop" in value) || isCropRegion(value.crop)) &&
101
+ (!("rotate" in value) || isNumber(value.rotate))
102
+ );
103
+ }
104
+
76
105
  export function parseTransform(json: string | undefined): ImageTransformOps {
77
106
  if (!json) return {};
78
- // SAFETY: json_transform is written only as "" or the JSON.stringify of the cumulative ImageTransformOps (transform.ts), so a non-empty value is that object; a schema parse of a stored row on read is excluded by ruling.
79
- return JSON.parse(json) as ImageTransformOps;
107
+ const parsed: unknown = JSON.parse(json);
108
+ if (isTransformOps(parsed)) return parsed;
109
+ throw new Error("Stored image edits are not crop and rotate operations");
80
110
  }
@@ -1,6 +1,7 @@
1
- import { assertValidation } from "@antelopejs/interface-api-util";
1
+ import { HTTPResult } from "@antelopejs/interface-api";
2
2
  import { z, ZodError } from "zod";
3
3
 
4
+ const HTTP_BAD_REQUEST = 400;
4
5
  const MAX_NAME_LENGTH = 255;
5
6
  const MIN_PRINTABLE_CHAR_CODE = 32;
6
7
  const PATH_SEPARATORS = new Set(["/", "\\"]);
@@ -62,21 +63,19 @@ export function comparableName(name: string): string {
62
63
  }
63
64
 
64
65
  /**
65
- * Parses a request body, answering 400 with the first validation message when
66
- * it is an i18n key and a generic one otherwise.
66
+ * Runs a schema parse of a request body, answering 400 with the first
67
+ * validation message when it is an i18n key and a generic one otherwise.
67
68
  */
68
- export function parseBody<Output>(
69
- body: unknown,
70
- schema: z.ZodType<Output, z.ZodTypeDef, unknown>,
71
- ): Output {
72
- return assertValidation(
73
- body,
74
- (value) => schema.parse(value),
75
- (error) => {
76
- const message = error instanceof ZodError ? error.issues[0]?.message : "";
77
- return message?.startsWith("$") ? message : MEDIA_ERRORS.invalidRequest;
78
- },
79
- );
69
+ export function rejectInvalid<Output>(parse: () => Output): Output {
70
+ try {
71
+ return parse();
72
+ } catch (error) {
73
+ const message = error instanceof ZodError ? error.issues[0]?.message : "";
74
+ throw new HTTPResult(
75
+ HTTP_BAD_REQUEST,
76
+ message?.startsWith("$") ? message : MEDIA_ERRORS.invalidRequest,
77
+ );
78
+ }
80
79
  }
81
80
 
82
81
  export const createFolderSchema = z.object({