@antelopejs/dms-media 0.5.1 → 0.6.1

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 (135) hide show
  1. package/README.md +3 -3
  2. package/dist/db/models/mediaFolders.model.d.ts +0 -3
  3. package/dist/db/models/mediaFolders.model.js +0 -29
  4. package/dist/db/models/mediaFolders.model.js.map +1 -1
  5. package/dist/db/tables/mediaDeclarations.table.d.ts +0 -4
  6. package/dist/db/tables/mediaDeclarations.table.js +0 -16
  7. package/dist/db/tables/mediaDeclarations.table.js.map +1 -1
  8. package/dist/declared/assets.d.ts +0 -2
  9. package/dist/declared/assets.js +12 -140
  10. package/dist/declared/assets.js.map +1 -1
  11. package/dist/declared/folders.d.ts +1 -5
  12. package/dist/declared/folders.js +14 -80
  13. package/dist/declared/folders.js.map +1 -1
  14. package/dist/declared/index.d.ts +0 -2
  15. package/dist/declared/index.js +0 -2
  16. package/dist/declared/index.js.map +1 -1
  17. package/dist/declared/records.d.ts +2 -30
  18. package/dist/declared/records.js +3 -33
  19. package/dist/declared/records.js.map +1 -1
  20. package/dist/derivatives.js +5 -17
  21. package/dist/derivatives.js.map +1 -1
  22. package/dist/frontend-module.d.ts +4 -0
  23. package/dist/frontend-module.js +24 -0
  24. package/dist/frontend-module.js.map +1 -0
  25. package/dist/implementations/interface-dms-media/index.d.ts +1 -3
  26. package/dist/implementations/interface-dms-media/index.js +0 -2
  27. package/dist/implementations/interface-dms-media/index.js.map +1 -1
  28. package/dist/index.d.ts +1 -3
  29. package/dist/index.js +3 -19
  30. package/dist/index.js.map +1 -1
  31. package/dist/library/realtime.js +8 -1
  32. package/dist/library/realtime.js.map +1 -1
  33. package/dist/pages/activity.d.ts +1 -0
  34. package/dist/pages/activity.js +3 -0
  35. package/dist/pages/activity.js.map +1 -1
  36. package/dist/pages/overview.d.ts +1 -0
  37. package/dist/pages/overview.js +3 -2
  38. package/dist/pages/overview.js.map +1 -1
  39. package/dist/pages/toolbar.d.ts +3 -0
  40. package/dist/pages/toolbar.js +19 -0
  41. package/dist/pages/toolbar.js.map +1 -0
  42. package/dist/pages/uploads.d.ts +1 -0
  43. package/dist/pages/uploads.js +4 -0
  44. package/dist/pages/uploads.js.map +1 -1
  45. package/dist/routes/media/delivery-stream.js +7 -21
  46. package/dist/routes/media/delivery-stream.js.map +1 -1
  47. package/dist/routes/media/manage.d.ts +23 -0
  48. package/dist/routes/media/manage.js +7 -4
  49. package/dist/routes/media/manage.js.map +1 -1
  50. package/dist/routes/media/upload.js +2 -5
  51. package/dist/routes/media/upload.js.map +1 -1
  52. package/dist/test/antelope.test.js +9 -4
  53. package/dist/test/antelope.test.js.map +1 -1
  54. package/dist/test/integration/media-activity-overview.test.js +6 -0
  55. package/dist/test/integration/media-activity-overview.test.js.map +1 -1
  56. package/dist/test/integration/media-declared-content.test.js +17 -317
  57. package/dist/test/integration/media-declared-content.test.js.map +1 -1
  58. package/dist/test/integration/media-linked-subfolders.test.js +2 -2
  59. package/dist/test/integration/media-linked-subfolders.test.js.map +1 -1
  60. package/dist/test/integration/media-storage-origin-unreachable.test.js +79 -0
  61. package/dist/test/integration/media-storage-origin-unreachable.test.js.map +1 -0
  62. package/dist/test/unit/declared.test.js +0 -66
  63. package/dist/test/unit/declared.test.js.map +1 -1
  64. package/dist/test/unit/library/realtime.test.d.ts +1 -0
  65. package/dist/test/unit/library/realtime.test.js +44 -0
  66. package/dist/test/unit/library/realtime.test.js.map +1 -0
  67. package/dist/test/unit/pages/toolbar.test.d.ts +1 -0
  68. package/dist/test/unit/pages/toolbar.test.js +64 -0
  69. package/dist/test/unit/pages/toolbar.test.js.map +1 -0
  70. package/dist/test/unit/routes/preset-row.test.d.ts +1 -0
  71. package/dist/test/unit/routes/preset-row.test.js +36 -0
  72. package/dist/test/unit/routes/preset-row.test.js.map +1 -0
  73. package/dist/validation/declared.schema.d.ts +7 -36
  74. package/dist/validation/declared.schema.js +1 -12
  75. package/dist/validation/declared.schema.js.map +1 -1
  76. package/frontend-vue/app/components/Explorer.vue +2 -0
  77. package/frontend-vue/app/components/FirstRun.vue +3 -1
  78. package/frontend-vue/app/components/PresetCards.vue +28 -5
  79. package/frontend-vue/app/components/RecentFiles.vue +11 -5
  80. package/frontend-vue/app/components/UploadQueue.vue +3 -1
  81. package/frontend-vue/app/components/UploadStrip.vue +3 -1
  82. package/frontend-vue/app/components/explorer/ExplorerDetailsDrawer.vue +10 -0
  83. package/frontend-vue/app/components/explorer/ExplorerInspector.vue +19 -14
  84. package/frontend-vue/app/components/explorer/ExplorerShell.vue +1 -11
  85. package/frontend-vue/app/composables/library/useExplorerCommands.ts +7 -1
  86. package/frontend-vue/app/composables/library/useExplorerDetailsDrawer.ts +75 -0
  87. package/frontend-vue/i18n/locales/media-en-GB.json +9 -2
  88. package/frontend-vue/i18n/locales/media-fr-FR.json +9 -2
  89. package/frontend-vue/package.json +1 -1
  90. package/frontend-vue/tests/detailsDrawer.test.ts +150 -0
  91. package/frontend-vue/tests/fixtures/serverRender.ts +70 -0
  92. package/frontend-vue/tests/locales.test.ts +17 -0
  93. package/frontend-vue/tests/serverRender.test.ts +47 -2
  94. package/package.json +10 -9
  95. package/skills/dms-media/SKILL.md +17 -24
  96. package/src/db/models/mediaFolders.model.ts +0 -44
  97. package/src/db/tables/mediaDeclarations.table.ts +3 -19
  98. package/src/declared/assets.ts +19 -210
  99. package/src/declared/folders.ts +22 -135
  100. package/src/declared/index.ts +0 -2
  101. package/src/declared/records.ts +8 -82
  102. package/src/derivatives.ts +7 -17
  103. package/src/frontend-module.ts +35 -0
  104. package/src/implementations/interface-dms-media/index.ts +1 -8
  105. package/src/index.ts +4 -28
  106. package/src/library/realtime.ts +12 -3
  107. package/src/pages/activity.ts +4 -0
  108. package/src/pages/overview.ts +4 -3
  109. package/src/pages/toolbar.ts +28 -0
  110. package/src/pages/uploads.ts +5 -0
  111. package/src/routes/media/delivery-stream.ts +12 -28
  112. package/src/routes/media/manage.ts +17 -4
  113. package/src/routes/media/upload.ts +4 -6
  114. package/src/test/antelope.test.ts +13 -4
  115. package/src/test/integration/media-activity-overview.test.ts +5 -0
  116. package/src/test/integration/media-declared-content.test.ts +17 -360
  117. package/src/test/integration/media-linked-subfolders.test.ts +2 -2
  118. package/src/test/integration/media-storage-origin-unreachable.test.ts +110 -0
  119. package/src/test/unit/declared.test.ts +0 -87
  120. package/src/test/unit/library/realtime.test.ts +55 -0
  121. package/src/test/unit/pages/toolbar.test.ts +92 -0
  122. package/src/test/unit/routes/preset-row.test.ts +39 -0
  123. package/src/validation/declared.schema.ts +0 -13
  124. package/dist/declared/readiness.d.ts +0 -2
  125. package/dist/declared/readiness.js +0 -52
  126. package/dist/declared/readiness.js.map +0 -1
  127. package/dist/declared/retire.d.ts +0 -3
  128. package/dist/declared/retire.js +0 -118
  129. package/dist/declared/retire.js.map +0 -1
  130. package/dist/test/integration/media-declared-retire.test.js +0 -186
  131. package/dist/test/integration/media-declared-retire.test.js.map +0 -1
  132. package/src/declared/readiness.ts +0 -64
  133. package/src/declared/retire.ts +0 -206
  134. package/src/test/integration/media-declared-retire.test.ts +0 -257
  135. /package/dist/test/integration/{media-declared-retire.test.d.ts → media-storage-origin-unreachable.test.d.ts} +0 -0
@@ -1,186 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- const interface_database_decorators_1 = require("@antelopejs/interface-database-decorators");
4
- const constants_1 = require("@antelopejs/interface-dms/constants");
5
- const interface_dms_media_1 = require("@antelopejs/interface-dms-media");
6
- const chai_1 = require("chai");
7
- const db_1 = require("../../db");
8
- const http_1 = require("../helpers/http");
9
- const owner_1 = require("../helpers/owner");
10
- const HTTP_OK = 200;
11
- const PREFIX = "retire.";
12
- const ROOT_KEY = "retire.root";
13
- const tenantId = constants_1.DEFAULT_TENANT_ID;
14
- function folders() {
15
- return (0, interface_database_decorators_1.GetModel)(db_1.MediaFolderModel, tenantId);
16
- }
17
- function assets() {
18
- return (0, interface_database_decorators_1.GetModel)(db_1.MediaAssetModel, tenantId);
19
- }
20
- function declarations() {
21
- return (0, interface_database_decorators_1.GetModel)(db_1.MediaDeclarationModel, tenantId);
22
- }
23
- async function rejectionOf(promise) {
24
- try {
25
- await promise;
26
- }
27
- catch (error) {
28
- return error;
29
- }
30
- throw new Error("Expected the call to be refused");
31
- }
32
- function textFile(key, folderKey, text) {
33
- return (0, interface_dms_media_1.ImportMediaAsset)({
34
- tenantId,
35
- key,
36
- folder: { key: folderKey },
37
- name: `${key.slice(PREFIX.length)}.txt`,
38
- mimetype: "text/plain",
39
- source: { bytes: Buffer.from(text) },
40
- });
41
- }
42
- async function liveAsset(id) {
43
- const asset = await assets().get(id);
44
- return asset && !asset.isDeleting ? asset : undefined;
45
- }
46
- describe("[integration] media declared content — retiring what the code no longer declares", () => {
47
- let client;
48
- before(async () => {
49
- client = (0, http_1.authorizedClient)((await (0, owner_1.ensureOwnerSession)()).accessToken);
50
- await (0, interface_dms_media_1.EnsureMediaFolder)({ tenantId, key: ROOT_KEY, name: "Retired" });
51
- });
52
- after(async () => {
53
- const all = await folders().getAll();
54
- const root = all.find((folder) => folder.name === "Retired");
55
- if (root)
56
- await client.delete(`/api/media/folders/${root._id}`);
57
- const records = (await declarations().getAll()).filter((record) => record.key.startsWith(PREFIX));
58
- await Promise.all(records.map((record) => declarations().delete(record._id)));
59
- });
60
- it("removes a file still as declared, once, and forgets its key", async () => {
61
- const file = await textFile("retire.untouched", ROOT_KEY, "Untouched");
62
- const retired = await (0, interface_dms_media_1.RetireMediaDeclaration)({
63
- tenantId,
64
- kind: "asset",
65
- key: "retire.untouched",
66
- });
67
- (0, chai_1.expect)(retired).to.deep.equal({
68
- kind: "asset",
69
- key: "retire.untouched",
70
- status: "removed",
71
- id: file.id,
72
- });
73
- (0, chai_1.expect)(await liveAsset(file.id)).to.equal(undefined);
74
- (0, chai_1.expect)(await declarations().findByKey("asset", "retire.untouched")).to.equal(undefined);
75
- const events = await (0, interface_database_decorators_1.GetModel)(db_1.MediaEventModel, tenantId).getBy("kind", "asset.delete");
76
- (0, chai_1.expect)(events.some((event) => event.assetId === file.id)).to.equal(true);
77
- (0, chai_1.expect)((await (0, interface_dms_media_1.RetireMediaDeclaration)({
78
- tenantId,
79
- kind: "asset",
80
- key: "retire.untouched",
81
- })).status).to.equal("unknown");
82
- const again = await textFile("retire.untouched", ROOT_KEY, "Untouched");
83
- (0, chai_1.expect)(again.status).to.equal("created");
84
- (0, chai_1.expect)(again.id).to.not.equal(file.id);
85
- });
86
- it("leaves a file a member changed, and hands it over to them", async () => {
87
- const file = await textFile("retire.edited", ROOT_KEY, "Edited");
88
- const rename = await client.post(`/api/media/assets/${file.id}/update`, {
89
- name: "kept-by-member.txt",
90
- });
91
- (0, chai_1.expect)(rename.status).to.equal(HTTP_OK);
92
- const retired = await (0, interface_dms_media_1.RetireMediaDeclaration)({
93
- tenantId,
94
- kind: "asset",
95
- key: "retire.edited",
96
- });
97
- (0, chai_1.expect)(retired.status).to.equal("preserved");
98
- (0, chai_1.expect)((await liveAsset(file.id))?.name).to.equal("kept-by-member.txt");
99
- (0, chai_1.expect)(await declarations().findByKey("asset", "retire.edited")).to.equal(undefined);
100
- });
101
- it("reports a file a member already deleted", async () => {
102
- const file = await textFile("retire.gone", ROOT_KEY, "Gone");
103
- await client.delete(`/api/media/assets/${file.id}`);
104
- (0, chai_1.expect)((await (0, interface_dms_media_1.RetireMediaDeclaration)({
105
- tenantId,
106
- kind: "asset",
107
- key: "retire.gone",
108
- })).status).to.equal("deleted");
109
- });
110
- it("keeps a declared folder holding a member's file", async () => {
111
- const folder = await (0, interface_dms_media_1.EnsureMediaFolder)({
112
- tenantId,
113
- key: "retire.shared",
114
- name: "Shared",
115
- parent: ROOT_KEY,
116
- });
117
- await textFile("retire.shared-file", "retire.shared", "Shared");
118
- const memberFolder = await client.post("/api/media/folders", {
119
- name: "Member's",
120
- parentId: folder.id,
121
- });
122
- (0, chai_1.expect)(memberFolder.status).to.equal(HTTP_OK);
123
- const results = await (0, interface_dms_media_1.PruneMediaDeclarations)({
124
- tenantId,
125
- prefix: "retire.shared",
126
- keep: [],
127
- });
128
- (0, chai_1.expect)(results.map(({ kind, key, status }) => ({ kind, key, status }))).to.deep.equal([
129
- { kind: "asset", key: "retire.shared-file", status: "removed" },
130
- { kind: "folder", key: "retire.shared", status: "preserved" },
131
- ]);
132
- (0, chai_1.expect)(await folders().get(folder.id)).to.not.equal(undefined);
133
- });
134
- it("prunes the stale declarations of a prefix, files first and deepest folders first", async () => {
135
- await (0, interface_dms_media_1.EnsureMediaFolder)({
136
- tenantId,
137
- key: "retire.v1",
138
- name: "Version 1",
139
- parent: ROOT_KEY,
140
- });
141
- const nested = await (0, interface_dms_media_1.EnsureMediaFolder)({
142
- tenantId,
143
- key: "retire.v1.nested",
144
- name: "Nested",
145
- parent: "retire.v1",
146
- });
147
- const kept = await textFile("retire.v1.kept", "retire.v1", "Kept");
148
- const stale = await textFile("retire.v1.stale", "retire.v1", "Stale");
149
- const deep = await textFile("retire.v1.deep", "retire.v1.nested", "Deep");
150
- const results = await (0, interface_dms_media_1.PruneMediaDeclarations)({
151
- tenantId,
152
- prefix: "retire.v1",
153
- keep: ["retire.v1", "retire.v1.kept"],
154
- });
155
- (0, chai_1.expect)(results.map(({ kind, key, status }) => ({ kind, key, status }))).to.have.deep.members([
156
- { kind: "asset", key: "retire.v1.stale", status: "removed" },
157
- { kind: "asset", key: "retire.v1.deep", status: "removed" },
158
- { kind: "folder", key: "retire.v1.nested", status: "removed" },
159
- ]);
160
- (0, chai_1.expect)(results.at(-1)?.kind).to.equal("folder");
161
- (0, chai_1.expect)(await liveAsset(stale.id)).to.equal(undefined);
162
- (0, chai_1.expect)(await liveAsset(deep.id)).to.equal(undefined);
163
- (0, chai_1.expect)(await folders().get(nested.id)).to.equal(undefined);
164
- (0, chai_1.expect)(await liveAsset(kept.id)).to.not.equal(undefined);
165
- (0, chai_1.expect)(await (0, interface_dms_media_1.PruneMediaDeclarations)({
166
- tenantId,
167
- prefix: "retire.v1",
168
- keep: ["retire.v1", "retire.v1.kept"],
169
- })).to.deep.equal([]);
170
- (0, chai_1.expect)((await textFile("retire.v1.kept", "retire.v1", "Kept")).status).to.equal("unchanged");
171
- });
172
- it("refuses a blank prefix, an unknown kind and a missing tenant", async () => {
173
- (0, chai_1.expect)((await rejectionOf((0, interface_dms_media_1.PruneMediaDeclarations)({ tenantId, prefix: " ", keep: [] }))).message).to.contain("prefix");
174
- (0, chai_1.expect)((await rejectionOf((0, interface_dms_media_1.RetireMediaDeclaration)({
175
- tenantId,
176
- kind: "page",
177
- key: "retire.page",
178
- }))).message).to.contain("kind");
179
- (0, chai_1.expect)((await rejectionOf((0, interface_dms_media_1.RetireMediaDeclaration)({
180
- tenantId: "",
181
- kind: "asset",
182
- key: "retire.no-tenant",
183
- }))).message).to.contain("tenantId");
184
- });
185
- });
186
- //# sourceMappingURL=media-declared-retire.test.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"media-declared-retire.test.js","sourceRoot":"","sources":["../../../src/test/integration/media-declared-retire.test.ts"],"names":[],"mappings":"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"}
@@ -1,64 +0,0 @@
1
- import { setTimeout as delay } from "node:timers/promises";
2
- import { Schema } from "@antelopejs/interface-database";
3
- import { TENANT_SCHEMA_NAME } from "@antelopejs/interface-dms/constants";
4
-
5
- const POLL_INTERVAL_MS = 500;
6
- const MAX_RETRY_DELAY_MS = 5_000;
7
- /** How long a declaration waits for its tenant before giving up. */
8
- const TENANT_WAIT_MS = 5 * 60_000;
9
- /** How long a file write waits for the storage endpoint to answer. */
10
- const STORAGE_WAIT_MS = 2 * 60_000;
11
-
12
- const readyTenants = new Set<string>();
13
-
14
- async function hasTenantInstance(tenantId: string): Promise<boolean> {
15
- try {
16
- const schema = Schema.get(TENANT_SCHEMA_NAME);
17
- if (!schema) return false;
18
- const instances = await schema.listInstances();
19
- return instances.includes(tenantId);
20
- } catch {
21
- return false;
22
- }
23
- }
24
-
25
- /**
26
- * Waits until the tenant's tables can be queried. Polling the schema, rather
27
- * than awaiting `Hook.DATABASE_INITIALIZED`, cannot deadlock a caller that
28
- * declares content from its own handler of that hook: handlers run in series.
29
- */
30
- export async function waitForTenant(tenantId: string): Promise<void> {
31
- if (readyTenants.has(tenantId)) return;
32
- const deadline = Date.now() + TENANT_WAIT_MS;
33
- while (!(await hasTenantInstance(tenantId))) {
34
- if (Date.now() > deadline)
35
- throw new Error(
36
- `Media tenant '${tenantId}' was not ready after ${TENANT_WAIT_MS / 1000}s: declare content from start() or a Hook.DATABASE_INITIALIZED handler, never awaited in construct()`,
37
- );
38
- await delay(POLL_INTERVAL_MS);
39
- }
40
- readyTenants.add(tenantId);
41
- }
42
-
43
- /**
44
- * Runs a storage write, retried while its endpoint does not answer: a local
45
- * storage receives uploads on the API server, which may not listen yet when
46
- * a module declares content at startup. Refusals are not retried.
47
- */
48
- export async function writeWhenReachable<T>(
49
- write: () => Promise<T>,
50
- ): Promise<T> {
51
- const deadline = Date.now() + STORAGE_WAIT_MS;
52
- let retryDelay = POLL_INTERVAL_MS;
53
- for (;;) {
54
- try {
55
- return await write();
56
- } catch (error) {
57
- // fetch rejects with a TypeError when nothing answers.
58
- const isUnreachable = error instanceof TypeError;
59
- if (!isUnreachable || Date.now() > deadline) throw error;
60
- }
61
- await delay(retryDelay);
62
- retryDelay = Math.min(retryDelay * 2, MAX_RETRY_DELAY_MS);
63
- }
64
- }
@@ -1,206 +0,0 @@
1
- import type {
2
- MediaContentKind,
3
- MediaDeclarationPrune,
4
- MediaDeclarationRetirement,
5
- MediaRetirementResult,
6
- } from "@antelopejs/interface-dms-media";
7
- import { cleanupAssetFiles, updateAssetMedia } from "../asset-lifecycle";
8
- import type { MediaDeclaration, MediaFolder } from "../db";
9
- import { recordMediaEvent } from "../library/events";
10
- import { forgetFavorites } from "../library/favorites";
11
- import {
12
- declarationPruneSchema,
13
- declarationRetirementSchema,
14
- describeDeclarationIssues,
15
- } from "../validation/declared.schema";
16
- import { assetStateHash } from "./assets";
17
- import { folderStateHash } from "./folders";
18
- import { waitForTenant } from "./readiness";
19
- import {
20
- DECLARED_CONTENT_AUTHOR,
21
- type DeclaredModels,
22
- declaredModels,
23
- judgeMemberChange,
24
- parseDeclaration,
25
- withDeclarationLock,
26
- } from "./records";
27
-
28
- /** A retirement's outcome before it is labelled with the kind and key. */
29
- type RetirementOutcome = Omit<MediaRetirementResult, "kind" | "key">;
30
-
31
- /** Deletes a declared file still as declared, the way a member's delete does. */
32
- async function retireAsset(
33
- models: DeclaredModels,
34
- record: MediaDeclaration,
35
- ): Promise<RetirementOutcome> {
36
- const { assetModel } = models;
37
- const stored = await assetModel.get(record.targetId);
38
- const asset = stored && !stored.isDeleting ? stored : undefined;
39
- const change = judgeMemberChange(
40
- record,
41
- asset,
42
- asset && assetStateHash(asset),
43
- );
44
- if (change || !asset) return change ?? { status: "deleted" };
45
- // Tombstoned only while untouched, so a member edit racing it wins.
46
- const isTombstoned = await updateAssetMedia(
47
- assetModel,
48
- asset,
49
- { isDeleting: true },
50
- { preserveDetails: true },
51
- );
52
- if (!isTombstoned) {
53
- const current = await assetModel.get(asset._id);
54
- return current && !current.isDeleting
55
- ? { status: "preserved", id: asset._id }
56
- : { status: "deleted" };
57
- }
58
- await cleanupAssetFiles(assetModel, asset._id);
59
- await forgetFavorites(models.tenantId, [asset._id]);
60
- await recordMediaEvent(
61
- { tenantId: models.tenantId, user: DECLARED_CONTENT_AUTHOR },
62
- {
63
- kind: "asset.delete",
64
- targetName: asset.name,
65
- folderId: asset.folderId,
66
- assetId: asset._id,
67
- size: asset.size,
68
- },
69
- );
70
- return { status: "removed", id: asset._id };
71
- }
72
-
73
- async function holdsContent(
74
- models: DeclaredModels,
75
- folder: MediaFolder,
76
- ): Promise<boolean> {
77
- const [children, assets] = await Promise.all([
78
- models.folderModel.getChildren(folder._id),
79
- models.assetModel.getByFolder(folder._id),
80
- ]);
81
- return children.length > 0 || assets.length > 0;
82
- }
83
-
84
- /**
85
- * Deletes a declared folder still as declared and empty. A folder holding
86
- * anything else, members' files or folders still declared, is never deleted
87
- * with its content: it stays, and is no longer the code's.
88
- */
89
- async function retireFolder(
90
- models: DeclaredModels,
91
- record: MediaDeclaration,
92
- ): Promise<RetirementOutcome> {
93
- const { folderModel } = models;
94
- const folder = await folderModel.get(record.targetId);
95
- const change = judgeMemberChange(
96
- record,
97
- folder,
98
- folder && folderStateHash(folder),
99
- );
100
- if (change || !folder) return change ?? { status: "deleted" };
101
- if (await holdsContent(models, folder))
102
- return { status: "preserved", id: folder._id };
103
- if (!(await folderModel.deleteDeclared(folder))) {
104
- const current = await folderModel.get(folder._id);
105
- return current
106
- ? { status: "preserved", id: folder._id }
107
- : { status: "deleted" };
108
- }
109
- await forgetFavorites(models.tenantId, [folder._id]);
110
- await recordMediaEvent(
111
- { tenantId: models.tenantId, user: DECLARED_CONTENT_AUTHOR },
112
- {
113
- kind: "folder.delete",
114
- targetName: folder.name,
115
- folderId: folder.parentId,
116
- count: 0,
117
- size: 0,
118
- details: { files: 0, folders: 1 },
119
- },
120
- );
121
- return { status: "removed", id: folder._id };
122
- }
123
-
124
- const RETIRERS: Record<
125
- MediaContentKind,
126
- (
127
- models: DeclaredModels,
128
- record: MediaDeclaration,
129
- ) => Promise<RetirementOutcome>
130
- > = {
131
- asset: retireAsset,
132
- folder: retireFolder,
133
- };
134
-
135
- /** Retires one declaration under its key's lock; whatever stays is the members' from now on. */
136
- function retireKey(
137
- models: DeclaredModels,
138
- kind: MediaContentKind,
139
- key: string,
140
- ): Promise<MediaRetirementResult> {
141
- return withDeclarationLock(models.tenantId, kind, key, async () => {
142
- const record = await models.declarationModel.findByKey(kind, key);
143
- if (!record) return { kind, key, status: "unknown" };
144
- const outcome = await RETIRERS[kind](models, record);
145
- await models.declarationModel.delete(record._id);
146
- return { kind, key, ...outcome };
147
- });
148
- }
149
-
150
- /** Implements `RetireMediaDeclaration`. */
151
- export async function retireDeclaration(
152
- input: MediaDeclarationRetirement,
153
- ): Promise<MediaRetirementResult> {
154
- const kind = (input as { kind?: unknown } | undefined)?.kind;
155
- const retirement = parseDeclaration(
156
- kind === "folder" ? "folder" : "asset",
157
- input,
158
- declarationRetirementSchema,
159
- );
160
- await waitForTenant(retirement.tenantId);
161
- return retireKey(
162
- declaredModels(retirement.tenantId),
163
- retirement.kind,
164
- retirement.key,
165
- );
166
- }
167
-
168
- /** Files first, then folders from the deepest, so a folder is empty of its declared content when its turn comes. */
169
- async function retirementOrder(
170
- models: DeclaredModels,
171
- records: MediaDeclaration[],
172
- ): Promise<MediaDeclaration[]> {
173
- const depths = new Map<string, number>();
174
- for (const record of records) {
175
- if (record.kind !== "folder") continue;
176
- const folder = await models.folderModel.get(record.targetId);
177
- depths.set(record._id, folder?.path.length ?? 0);
178
- }
179
- const assets = records.filter((record) => record.kind === "asset");
180
- const folders = records
181
- .filter((record) => record.kind === "folder")
182
- .sort((a, b) => (depths.get(b._id) ?? 0) - (depths.get(a._id) ?? 0));
183
- return [...assets, ...folders];
184
- }
185
-
186
- /** Implements `PruneMediaDeclarations`. */
187
- export async function pruneDeclarations(
188
- input: MediaDeclarationPrune,
189
- ): Promise<MediaRetirementResult[]> {
190
- const parsed = declarationPruneSchema.safeParse(input);
191
- if (!parsed.success)
192
- throw new Error(
193
- `Media declarations prune: ${describeDeclarationIssues(parsed.error)}`,
194
- );
195
- const { prefix, tenantId } = parsed.data;
196
- const keep = new Set(parsed.data.keep);
197
- await waitForTenant(tenantId);
198
- const models = declaredModels(tenantId);
199
- const stale = (await models.declarationModel.getAll()).filter(
200
- (record) => record.key.startsWith(prefix) && !keep.has(record.key),
201
- );
202
- const results: MediaRetirementResult[] = [];
203
- for (const record of await retirementOrder(models, stale))
204
- results.push(await retireKey(models, record.kind, record.key));
205
- return results;
206
- }