arocapi 5.0.0-beta.5 → 5.0.0-beta.7

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 (205) hide show
  1. package/LICENSE.md +1 -1
  2. package/README.md +2 -2
  3. package/dist/app.d.ts +22 -17
  4. package/dist/app.js +22 -16
  5. package/dist/app.js.map +1 -1
  6. package/dist/routes/capabilities.d.ts +2 -2
  7. package/dist/routes/capabilities.js +2 -2
  8. package/dist/routes/capabilities.js.map +1 -1
  9. package/dist/routes/entities.js +8 -9
  10. package/dist/routes/entities.js.map +1 -1
  11. package/dist/routes/file.d.ts +2 -2
  12. package/dist/routes/file.js +25 -72
  13. package/dist/routes/file.js.map +1 -1
  14. package/dist/routes/metadata.d.ts +5 -5
  15. package/dist/routes/metadata.js +22 -61
  16. package/dist/routes/metadata.js.map +1 -1
  17. package/dist/routes/search.d.ts +2 -4
  18. package/dist/routes/search.js +75 -97
  19. package/dist/routes/search.js.map +1 -1
  20. package/dist/search/advanced.d.ts +8 -0
  21. package/dist/search/advanced.js +198 -0
  22. package/dist/search/advanced.js.map +1 -0
  23. package/dist/search/backend.d.ts +95 -0
  24. package/dist/search/backend.js +5 -0
  25. package/dist/search/backend.js.map +1 -0
  26. package/dist/search/fields.d.ts +63 -0
  27. package/dist/search/fields.js +203 -0
  28. package/dist/search/fields.js.map +1 -0
  29. package/dist/search/opensearch/advanced.d.ts +4 -0
  30. package/dist/search/opensearch/advanced.js +28 -0
  31. package/dist/search/opensearch/advanced.js.map +1 -0
  32. package/dist/search/opensearch/opensearch.d.ts +16 -0
  33. package/dist/search/opensearch/opensearch.js +187 -0
  34. package/dist/search/opensearch/opensearch.js.map +1 -0
  35. package/dist/search/opensearch/visibility.d.ts +3 -0
  36. package/dist/search/opensearch/visibility.js +27 -0
  37. package/dist/search/opensearch/visibility.js.map +1 -0
  38. package/dist/search/postgres/advanced.d.ts +7 -0
  39. package/dist/search/postgres/advanced.js +54 -0
  40. package/dist/search/postgres/advanced.js.map +1 -0
  41. package/dist/search/postgres/facets.d.ts +2 -0
  42. package/dist/search/postgres/facets.js +27 -0
  43. package/dist/search/postgres/facets.js.map +1 -0
  44. package/dist/search/postgres/geo.d.ts +6 -0
  45. package/dist/search/postgres/geo.js +42 -0
  46. package/dist/search/postgres/geo.js.map +1 -0
  47. package/dist/search/postgres/postgres.d.ts +19 -0
  48. package/dist/search/postgres/postgres.js +157 -0
  49. package/dist/search/postgres/postgres.js.map +1 -0
  50. package/dist/search/postgres/values.d.ts +8 -0
  51. package/dist/search/postgres/values.js +20 -0
  52. package/dist/search/postgres/values.js.map +1 -0
  53. package/dist/search/postgres/visibility.d.ts +4 -0
  54. package/dist/search/postgres/visibility.js +38 -0
  55. package/dist/search/postgres/visibility.js.map +1 -0
  56. package/dist/search/requestFilters.d.ts +39 -0
  57. package/dist/search/requestFilters.js +125 -0
  58. package/dist/search/requestFilters.js.map +1 -0
  59. package/dist/search/visibility.d.ts +51 -0
  60. package/dist/search/visibility.js +100 -0
  61. package/dist/search/visibility.js.map +1 -0
  62. package/dist/storage/backend.d.ts +58 -0
  63. package/dist/storage/backend.js +2 -0
  64. package/dist/storage/backend.js.map +1 -0
  65. package/dist/storage/deliver.d.ts +12 -0
  66. package/dist/storage/deliver.js +34 -0
  67. package/dist/storage/deliver.js.map +1 -0
  68. package/dist/storage/directory/directory.d.ts +6 -0
  69. package/dist/storage/directory/directory.js +24 -0
  70. package/dist/storage/directory/directory.js.map +1 -0
  71. package/dist/storage/entity-meta/entity-meta.d.ts +5 -0
  72. package/dist/storage/entity-meta/entity-meta.js +14 -0
  73. package/dist/storage/entity-meta/entity-meta.js.map +1 -0
  74. package/dist/storage/location.d.ts +20 -0
  75. package/dist/storage/location.js +40 -0
  76. package/dist/storage/location.js.map +1 -0
  77. package/dist/storage/ocfl/ocfl.d.ts +7 -0
  78. package/dist/storage/ocfl/ocfl.js +79 -0
  79. package/dist/storage/ocfl/ocfl.js.map +1 -0
  80. package/dist/storage/ocfl/ocflFs.d.ts +7 -0
  81. package/dist/storage/ocfl/ocflFs.js +33 -0
  82. package/dist/storage/ocfl/ocflFs.js.map +1 -0
  83. package/dist/storage/results.d.ts +7 -0
  84. package/dist/storage/results.js +22 -0
  85. package/dist/storage/results.js.map +1 -0
  86. package/dist/storage/s3/s3.d.ts +10 -0
  87. package/dist/storage/s3/s3.js +47 -0
  88. package/dist/storage/s3/s3.js.map +1 -0
  89. package/dist/types/visibility.d.ts +3 -2
  90. package/dist/utils/visibility.js +1 -1
  91. package/dist/utils/visibility.js.map +1 -1
  92. package/package.json +66 -26
  93. package/prisma/models/entity.prisma +9 -8
  94. package/prisma/models/entitySearch.prisma +21 -0
  95. package/prisma/models/file.prisma +3 -3
  96. package/src/app.ts +85 -48
  97. package/src/routes/capabilities.ts +4 -4
  98. package/src/routes/entities.ts +10 -9
  99. package/src/routes/file.ts +23 -99
  100. package/src/routes/metadata.ts +24 -86
  101. package/src/routes/search.ts +104 -118
  102. package/src/search/advanced.ts +258 -0
  103. package/src/search/backend.ts +91 -0
  104. package/src/search/fields.ts +320 -0
  105. package/src/search/opensearch/advanced.ts +36 -0
  106. package/src/search/opensearch/opensearch.ts +290 -0
  107. package/src/search/opensearch/visibility.ts +38 -0
  108. package/src/search/postgres/advanced.ts +76 -0
  109. package/src/search/postgres/facets.ts +34 -0
  110. package/src/search/postgres/geo.ts +58 -0
  111. package/src/search/postgres/postgres.ts +232 -0
  112. package/src/search/postgres/values.ts +33 -0
  113. package/src/search/postgres/visibility.ts +54 -0
  114. package/src/search/requestFilters.ts +178 -0
  115. package/src/search/visibility.ts +193 -0
  116. package/src/storage/backend.ts +75 -0
  117. package/src/storage/deliver.ts +65 -0
  118. package/src/storage/directory/directory.ts +39 -0
  119. package/src/storage/entity-meta/entity-meta.ts +25 -0
  120. package/src/storage/location.ts +85 -0
  121. package/src/storage/ocfl/ocfl.ts +129 -0
  122. package/src/storage/ocfl/ocflFs.ts +67 -0
  123. package/src/storage/results.ts +32 -0
  124. package/src/storage/s3/s3.ts +79 -0
  125. package/src/types/visibility.ts +6 -3
  126. package/src/utils/visibility.ts +1 -1
  127. package/dist/app.test.d.ts +0 -1
  128. package/dist/app.test.js +0 -67
  129. package/dist/app.test.js.map +0 -1
  130. package/dist/errorHandling.test.d.ts +0 -1
  131. package/dist/errorHandling.test.js +0 -222
  132. package/dist/errorHandling.test.js.map +0 -1
  133. package/dist/index.dev.d.ts +0 -1
  134. package/dist/index.dev.js +0 -157
  135. package/dist/index.dev.js.map +0 -1
  136. package/dist/routes/capabilities.test.d.ts +0 -1
  137. package/dist/routes/capabilities.test.js +0 -81
  138. package/dist/routes/capabilities.test.js.map +0 -1
  139. package/dist/routes/crate.test.d.ts +0 -1
  140. package/dist/routes/crate.test.js +0 -390
  141. package/dist/routes/crate.test.js.map +0 -1
  142. package/dist/routes/entities.test.d.ts +0 -1
  143. package/dist/routes/entities.test.js +0 -277
  144. package/dist/routes/entities.test.js.map +0 -1
  145. package/dist/routes/entity.test.d.ts +0 -1
  146. package/dist/routes/entity.test.js +0 -136
  147. package/dist/routes/entity.test.js.map +0 -1
  148. package/dist/routes/file.test.d.ts +0 -1
  149. package/dist/routes/file.test.js +0 -435
  150. package/dist/routes/file.test.js.map +0 -1
  151. package/dist/routes/files.test.d.ts +0 -1
  152. package/dist/routes/files.test.js +0 -245
  153. package/dist/routes/files.test.js.map +0 -1
  154. package/dist/routes/search.test.d.ts +0 -1
  155. package/dist/routes/search.test.js +0 -833
  156. package/dist/routes/search.test.js.map +0 -1
  157. package/dist/test/helpers/fastify.d.ts +0 -9
  158. package/dist/test/helpers/fastify.js +0 -17
  159. package/dist/test/helpers/fastify.js.map +0 -1
  160. package/dist/test/integration.setup.d.ts +0 -47
  161. package/dist/test/integration.setup.js +0 -195
  162. package/dist/test/integration.setup.js.map +0 -1
  163. package/dist/test/integration.test.d.ts +0 -1
  164. package/dist/test/integration.test.js +0 -762
  165. package/dist/test/integration.test.js.map +0 -1
  166. package/dist/transformers/default.test.d.ts +0 -1
  167. package/dist/transformers/default.test.js +0 -225
  168. package/dist/transformers/default.test.js.map +0 -1
  169. package/dist/transformers/transformer.test.d.ts +0 -1
  170. package/dist/transformers/transformer.test.js +0 -165
  171. package/dist/transformers/transformer.test.js.map +0 -1
  172. package/dist/types/fileHandlers.d.ts +0 -37
  173. package/dist/types/fileHandlers.js +0 -2
  174. package/dist/types/fileHandlers.js.map +0 -1
  175. package/dist/utils/errors.test.d.ts +0 -1
  176. package/dist/utils/errors.test.js +0 -79
  177. package/dist/utils/errors.test.js.map +0 -1
  178. package/dist/utils/queryBuilder.d.ts +0 -47
  179. package/dist/utils/queryBuilder.js +0 -107
  180. package/dist/utils/queryBuilder.js.map +0 -1
  181. package/prisma.config.ts +0 -9
  182. package/src/app.test.ts +0 -91
  183. package/src/errorHandling.test.ts +0 -288
  184. package/src/index.dev.ts +0 -202
  185. package/src/reset.d.ts +0 -1
  186. package/src/routes/__snapshots__/capabilities.test.ts.snap +0 -34
  187. package/src/routes/__snapshots__/entities.test.ts.snap +0 -96
  188. package/src/routes/__snapshots__/entity.test.ts.snap +0 -74
  189. package/src/routes/__snapshots__/search.test.ts.snap +0 -165
  190. package/src/routes/capabilities.test.ts +0 -102
  191. package/src/routes/crate.test.ts +0 -484
  192. package/src/routes/entities.test.ts +0 -324
  193. package/src/routes/entity.test.ts +0 -166
  194. package/src/routes/file.test.ts +0 -538
  195. package/src/routes/files.test.ts +0 -304
  196. package/src/routes/search.test.ts +0 -959
  197. package/src/test/__snapshots__/integration.test.ts.snap +0 -18
  198. package/src/test/helpers/fastify.ts +0 -26
  199. package/src/test/integration.setup.ts +0 -220
  200. package/src/test/integration.test.ts +0 -953
  201. package/src/transformers/default.test.ts +0 -276
  202. package/src/transformers/transformer.test.ts +0 -226
  203. package/src/types/fileHandlers.ts +0 -57
  204. package/src/utils/errors.test.ts +0 -90
  205. package/src/utils/queryBuilder.ts +0 -157
@@ -1,484 +0,0 @@
1
- import { createReadStream } from 'node:fs';
2
- import { Readable } from 'node:stream';
3
- import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
4
- import { fastify, fastifyAfter, fastifyBefore, prisma } from '../test/helpers/fastify.js';
5
- import type { AccessFunction } from '../types/access.js';
6
- import type { FileResult, RoCrateHandler } from '../types/fileHandlers.js';
7
- import { AllPublicAccess } from '../utils/access.js';
8
- import type { StandardErrorResponse } from '../utils/errors.js';
9
- import { AllVisibleEntityFilter } from '../utils/visibility.js';
10
- import metadataRoute from './metadata.js';
11
-
12
- vi.mock('node:fs', () => ({
13
- createReadStream: vi.fn(),
14
- }));
15
-
16
- describe('Crate Route', () => {
17
- const mockRoCrateHandler: RoCrateHandler = {
18
- get: vi.fn(),
19
- head: vi.fn(),
20
- };
21
- const mockAccess = vi.fn<AccessFunction>();
22
-
23
- beforeEach(async () => {
24
- await fastifyBefore();
25
- await fastify.register(metadataRoute, {
26
- access: mockAccess,
27
- entityVisibilityFilter: AllVisibleEntityFilter,
28
- refusal: { promptLoginForHidden: false },
29
- prisma,
30
- roCrateHandler: mockRoCrateHandler,
31
- });
32
- vi.clearAllMocks();
33
- mockAccess.mockImplementation(AllPublicAccess);
34
- prisma.entity.findMany.mockResolvedValue([]);
35
- });
36
-
37
- afterEach(async () => {
38
- await fastifyAfter();
39
- });
40
-
41
- const mockFileEntity = {
42
- id: 'http://example.com/entity/file.wav',
43
- name: 'test.wav',
44
- description: 'A test file',
45
- entityType: 'http://schema.org/MediaObject',
46
- memberOf: 'http://example.com/collection',
47
- rootCollection: 'http://example.com/collection',
48
- metadataLicenseId: 'https://creativecommons.org/licenses/by/4.0/',
49
- contentLicenseId: 'https://creativecommons.org/licenses/by/4.0/',
50
- createdAt: new Date(),
51
- updatedAt: new Date(),
52
- meta: {},
53
- };
54
-
55
- const mockCollectionEntity = {
56
- ...mockFileEntity,
57
- id: 'http://example.com/collection',
58
- name: 'Test Collection',
59
- entityType: 'http://pcdm.org/models#Collection',
60
- memberOf: null,
61
- rootCollection: null,
62
- };
63
-
64
- const mockObjectEntity = {
65
- ...mockFileEntity,
66
- id: 'http://example.com/object',
67
- name: 'Test Object',
68
- entityType: 'http://pcdm.org/models#Object',
69
- memberOf: 'http://example.com/collection',
70
- rootCollection: 'http://example.com/collection',
71
- };
72
-
73
- describe('GET /entity/:id/metadata', () => {
74
- it('should stream RO-Crate metadata for File entity', async () => {
75
- prisma.entity.findFirst.mockResolvedValue(mockFileEntity);
76
-
77
- const mockStream = Readable.from(['{"@context": "https://w3id.org/ro/crate/1.1/context"}']);
78
- const mockResult: FileResult = {
79
- type: 'stream',
80
- stream: mockStream,
81
- metadata: {
82
- contentType: 'text/plain',
83
- contentLength: 52,
84
- etag: '"rocrate123"',
85
- lastModified: new Date('2025-01-01'),
86
- },
87
- };
88
- vi.mocked(mockRoCrateHandler.get).mockResolvedValue(mockResult);
89
-
90
- const response = await fastify.inject({
91
- method: 'GET',
92
- url: `/entity/${encodeURIComponent('http://example.com/entity/file.wav')}/metadata`,
93
- });
94
-
95
- expect(response.statusCode).toBe(200);
96
- expect(response.headers['content-type']).toBe('application/ld+json');
97
- expect(response.headers['content-length']).toBe('52');
98
- expect(response.headers.etag).toBe('"rocrate123"');
99
- expect(response.body).toBe('{"@context": "https://w3id.org/ro/crate/1.1/context"}');
100
-
101
- expect(mockRoCrateHandler.get).toHaveBeenCalledWith(
102
- mockFileEntity,
103
- expect.objectContaining({
104
- request: expect.any(Object),
105
- fastify: expect.any(Object),
106
- }),
107
- );
108
- });
109
-
110
- it('should stream RO-Crate metadata for Collection entity', async () => {
111
- prisma.entity.findFirst.mockResolvedValue(mockCollectionEntity);
112
-
113
- const mockStream = Readable.from(['{"@context": "https://w3id.org/ro/crate/1.1/context"}']);
114
- const mockResult: FileResult = {
115
- type: 'stream',
116
- stream: mockStream,
117
- metadata: {
118
- contentType: 'application/json',
119
- contentLength: 52,
120
- },
121
- };
122
- vi.mocked(mockRoCrateHandler.get).mockResolvedValue(mockResult);
123
-
124
- const response = await fastify.inject({
125
- method: 'GET',
126
- url: `/entity/${encodeURIComponent('http://example.com/collection')}/metadata`,
127
- });
128
-
129
- expect(response.statusCode).toBe(200);
130
- expect(response.headers['content-type']).toBe('application/ld+json');
131
- expect(mockRoCrateHandler.get).toHaveBeenCalledWith(mockCollectionEntity, expect.any(Object));
132
- });
133
-
134
- it('should stream RO-Crate metadata for Object entity', async () => {
135
- prisma.entity.findFirst.mockResolvedValue(mockObjectEntity);
136
-
137
- const mockStream = Readable.from(['{"@context": "https://w3id.org/ro/crate/1.1/context"}']);
138
- const mockResult: FileResult = {
139
- type: 'stream',
140
- stream: mockStream,
141
- metadata: {
142
- contentType: 'application/ld+json',
143
- contentLength: 52,
144
- },
145
- };
146
- vi.mocked(mockRoCrateHandler.get).mockResolvedValue(mockResult);
147
-
148
- const response = await fastify.inject({
149
- method: 'GET',
150
- url: `/entity/${encodeURIComponent('http://example.com/object')}/metadata`,
151
- });
152
-
153
- expect(response.statusCode).toBe(200);
154
- expect(response.headers['content-type']).toBe('application/ld+json');
155
- expect(mockRoCrateHandler.get).toHaveBeenCalledWith(mockObjectEntity, expect.any(Object));
156
- });
157
-
158
- it('should handle redirect response', async () => {
159
- prisma.entity.findFirst.mockResolvedValue(mockFileEntity);
160
-
161
- const mockResult: FileResult = {
162
- type: 'redirect',
163
- url: 'https://storage.example.com/ro-crate-metadata.json',
164
- };
165
- vi.mocked(mockRoCrateHandler.get).mockResolvedValue(mockResult);
166
-
167
- const response = await fastify.inject({
168
- method: 'GET',
169
- url: `/entity/${encodeURIComponent('http://example.com/entity/file.wav')}/metadata`,
170
- });
171
-
172
- expect(response.statusCode).toBe(302);
173
- expect(response.headers.location).toBe('https://storage.example.com/ro-crate-metadata.json');
174
- });
175
-
176
- it('should handle file path response without nginx X-Accel-Redirect', async () => {
177
- prisma.entity.findFirst.mockResolvedValue(mockCollectionEntity);
178
-
179
- const mockStream = Readable.from(['rocrate content']);
180
- vi.mocked(createReadStream).mockReturnValue(mockStream as never);
181
-
182
- const mockResult: FileResult = {
183
- type: 'file',
184
- path: '/data/rocrate/ro-crate-metadata.json',
185
- metadata: {
186
- contentType: 'application/ld+json',
187
- contentLength: 1024,
188
- },
189
- };
190
- vi.mocked(mockRoCrateHandler.get).mockResolvedValue(mockResult);
191
-
192
- const response = await fastify.inject({
193
- method: 'GET',
194
- url: `/entity/${encodeURIComponent('http://example.com/collection')}/metadata`,
195
- });
196
-
197
- expect(response.statusCode).toBe(200);
198
- expect(response.headers['content-type']).toBe('application/ld+json');
199
- expect(response.headers['content-length']).toBe('1024');
200
- expect(response.headers['x-accel-redirect']).toBeUndefined();
201
- expect(createReadStream).toHaveBeenCalledWith('/data/rocrate/ro-crate-metadata.json');
202
- });
203
-
204
- it('should handle file path response with nginx X-Accel-Redirect', async () => {
205
- prisma.entity.findFirst.mockResolvedValue(mockFileEntity);
206
-
207
- const mockResult: FileResult = {
208
- type: 'file',
209
- path: '/data/rocrate/ro-crate-metadata.json',
210
- accelPath: '/internal/rocrate/ro-crate-metadata.json',
211
- metadata: {
212
- contentType: 'application/ld+json',
213
- contentLength: 2048,
214
- },
215
- };
216
- vi.mocked(mockRoCrateHandler.get).mockResolvedValue(mockResult);
217
-
218
- const response = await fastify.inject({
219
- method: 'GET',
220
- url: `/entity/${encodeURIComponent('http://example.com/entity/file.wav')}/metadata`,
221
- });
222
-
223
- expect(response.statusCode).toBe(200);
224
- expect(response.headers['content-type']).toBe('application/ld+json');
225
- expect(response.headers['x-accel-redirect']).toBe('/internal/rocrate/ro-crate-metadata.json');
226
- expect(response.body).toBe('');
227
- });
228
-
229
- it('should return 404 when entity not found', async () => {
230
- prisma.entity.findFirst.mockResolvedValue(null);
231
-
232
- const response = await fastify.inject({
233
- method: 'GET',
234
- url: `/entity/${encodeURIComponent('http://example.com/nonexistent')}/metadata`,
235
- });
236
- const body = JSON.parse(response.body) as { error: { code: string; message: string } };
237
-
238
- expect(response.statusCode).toBe(404);
239
- expect(body.error.code).toBe('NOT_FOUND');
240
- expect(body.error.message).toBe('The requested entity was not found');
241
- expect(mockRoCrateHandler.get).not.toHaveBeenCalled();
242
- });
243
-
244
- it('should decide access on the entity without looking up its parents', async () => {
245
- prisma.entity.findFirst.mockResolvedValue(mockObjectEntity);
246
- vi.mocked(mockRoCrateHandler.get).mockResolvedValue({ type: 'redirect', url: 'https://example.com/ro-crate' });
247
-
248
- await fastify.inject({
249
- method: 'GET',
250
- url: `/entity/${encodeURIComponent('http://example.com/object')}/metadata`,
251
- });
252
-
253
- expect(mockAccess).toHaveBeenCalledWith(
254
- expect.objectContaining({
255
- id: 'http://example.com/object',
256
- memberOf: 'http://example.com/collection',
257
- rootCollection: 'http://example.com/collection',
258
- }),
259
- expect.objectContaining({ request: expect.any(Object), fastify: expect.any(Object) }),
260
- );
261
- expect(prisma.entity.findMany).not.toHaveBeenCalled();
262
- });
263
-
264
- it('should return 403 when the metadata is not accessible', async () => {
265
- prisma.entity.findFirst.mockResolvedValue(mockFileEntity);
266
- mockAccess.mockReturnValue({ metadata: false, content: true });
267
-
268
- const response = await fastify.inject({
269
- method: 'GET',
270
- url: `/entity/${encodeURIComponent('http://example.com/entity/file.wav')}/metadata`,
271
- });
272
- const body = JSON.parse(response.body) as { error: { code: string; message: string } };
273
-
274
- expect(response.statusCode).toBe(403);
275
- expect(body.error.code).toBe('FORBIDDEN');
276
- expect(body.error.message).toBe('You do not have permission to access this resource');
277
- expect(mockRoCrateHandler.get).not.toHaveBeenCalled();
278
- });
279
-
280
- it('should return 404 when handler returns false', async () => {
281
- prisma.entity.findFirst.mockResolvedValue(mockFileEntity);
282
- vi.mocked(mockRoCrateHandler.get).mockResolvedValue(false);
283
-
284
- const response = await fastify.inject({
285
- method: 'GET',
286
- url: `/entity/${encodeURIComponent('http://example.com/entity/file.wav')}/metadata`,
287
- });
288
- const body = JSON.parse(response.body) as { error: { code: string; message: string } };
289
-
290
- expect(response.statusCode).toBe(404);
291
- expect(body.error.code).toBe('NOT_FOUND');
292
- expect(body.error.message).toBe('The requested RO-Crate could not be retrieved');
293
- });
294
-
295
- it('should return 500 when database error occurs', async () => {
296
- prisma.entity.findFirst.mockRejectedValue(new Error('Database connection failed'));
297
-
298
- const response = await fastify.inject({
299
- method: 'GET',
300
- url: `/entity/${encodeURIComponent('http://example.com/entity/file.wav')}/metadata`,
301
- });
302
- const body = JSON.parse(response.body) as { error: { code: string } };
303
-
304
- expect(response.statusCode).toBe(500);
305
- expect(body.error.code).toBe('INTERNAL_ERROR');
306
- });
307
-
308
- it('should return 500 when roCrateHandler throws error', async () => {
309
- prisma.entity.findFirst.mockResolvedValue(mockFileEntity);
310
- vi.mocked(mockRoCrateHandler.get).mockRejectedValue(new Error('RO-Crate error'));
311
-
312
- const response = await fastify.inject({
313
- method: 'GET',
314
- url: `/entity/${encodeURIComponent('http://example.com/entity/file.wav')}/metadata`,
315
- });
316
- const body = JSON.parse(response.body) as { error: { code: string } };
317
-
318
- expect(response.statusCode).toBe(500);
319
- expect(body.error.code).toBe('INTERNAL_ERROR');
320
- });
321
-
322
- it('should validate ID parameter format', async () => {
323
- const response = await fastify.inject({
324
- method: 'GET',
325
- url: '/entity/invalid-id/metadata',
326
- });
327
- const body = JSON.parse(response.body) as StandardErrorResponse;
328
-
329
- expect(response.statusCode).toBe(400);
330
- expect(body.error.code).toBe('VALIDATION_ERROR');
331
- });
332
- });
333
-
334
- describe('HEAD /entity/:id/metadata', () => {
335
- it('should return RO-Crate metadata headers for File entity', async () => {
336
- prisma.entity.findFirst.mockResolvedValue(mockFileEntity);
337
-
338
- const mockMetadata = {
339
- contentType: 'application/ld+json',
340
- contentLength: 1024,
341
- etag: '"rocrate-etag"',
342
- lastModified: new Date('2025-01-15'),
343
- };
344
- vi.mocked(mockRoCrateHandler.head).mockResolvedValue(mockMetadata);
345
-
346
- const response = await fastify.inject({
347
- method: 'HEAD',
348
- url: `/entity/${encodeURIComponent('http://example.com/entity/file.wav')}/metadata`,
349
- });
350
-
351
- expect(response.statusCode).toBe(200);
352
- expect(response.headers['content-type']).toBe('application/ld+json');
353
- expect(response.headers['content-length']).toBe('1024');
354
- expect(response.headers.etag).toBe('"rocrate-etag"');
355
- expect(response.body).toBe('');
356
-
357
- expect(mockRoCrateHandler.head).toHaveBeenCalledWith(
358
- mockFileEntity,
359
- expect.objectContaining({
360
- request: expect.any(Object),
361
- fastify: expect.any(Object),
362
- }),
363
- );
364
- });
365
-
366
- it('should return RO-Crate metadata headers for Collection entity', async () => {
367
- prisma.entity.findFirst.mockResolvedValue(mockCollectionEntity);
368
-
369
- const mockMetadata = {
370
- contentType: 'text/plain',
371
- contentLength: 512,
372
- };
373
- vi.mocked(mockRoCrateHandler.head).mockResolvedValue(mockMetadata);
374
-
375
- const response = await fastify.inject({
376
- method: 'HEAD',
377
- url: `/entity/${encodeURIComponent('http://example.com/collection')}/metadata`,
378
- });
379
-
380
- expect(response.statusCode).toBe(200);
381
- expect(response.headers['content-type']).toBe('text/plain');
382
- expect(response.headers['content-length']).toBe('512');
383
- expect(response.body).toBe('');
384
- });
385
-
386
- it('should return RO-Crate metadata headers for Object entity', async () => {
387
- prisma.entity.findFirst.mockResolvedValue(mockObjectEntity);
388
-
389
- const mockMetadata = {
390
- contentType: 'application/json',
391
- contentLength: 2048,
392
- };
393
- vi.mocked(mockRoCrateHandler.head).mockResolvedValue(mockMetadata);
394
-
395
- const response = await fastify.inject({
396
- method: 'HEAD',
397
- url: `/entity/${encodeURIComponent('http://example.com/object')}/metadata`,
398
- });
399
-
400
- expect(response.statusCode).toBe(200);
401
- expect(response.headers['content-type']).toBe('application/json');
402
- expect(response.headers['content-length']).toBe('2048');
403
- expect(response.body).toBe('');
404
- });
405
-
406
- it('should return 404 when entity not found', async () => {
407
- prisma.entity.findFirst.mockResolvedValue(null);
408
-
409
- const response = await fastify.inject({
410
- method: 'HEAD',
411
- url: `/entity/${encodeURIComponent('http://example.com/nonexistent')}/metadata`,
412
- });
413
- const body = JSON.parse(response.body) as { error: { code: string } };
414
-
415
- expect(response.statusCode).toBe(404);
416
- expect(body.error.code).toBe('NOT_FOUND');
417
- expect(mockRoCrateHandler.head).not.toHaveBeenCalled();
418
- });
419
-
420
- it('should return 403 when the metadata is not accessible', async () => {
421
- prisma.entity.findFirst.mockResolvedValue(mockFileEntity);
422
- mockAccess.mockReturnValue({ metadata: false, content: true });
423
-
424
- const response = await fastify.inject({
425
- method: 'HEAD',
426
- url: `/entity/${encodeURIComponent('http://example.com/entity/file.wav')}/metadata`,
427
- });
428
-
429
- expect(response.statusCode).toBe(403);
430
- expect(mockRoCrateHandler.head).not.toHaveBeenCalled();
431
- });
432
-
433
- it('should return 404 when head handler returns false', async () => {
434
- prisma.entity.findFirst.mockResolvedValue(mockFileEntity);
435
- vi.mocked(mockRoCrateHandler.head).mockResolvedValue(false);
436
-
437
- const response = await fastify.inject({
438
- method: 'HEAD',
439
- url: `/entity/${encodeURIComponent('http://example.com/entity/file.wav')}/metadata`,
440
- });
441
- const body = JSON.parse(response.body) as { error: { code: string; message: string } };
442
-
443
- expect(response.statusCode).toBe(404);
444
- expect(body.error.code).toBe('NOT_FOUND');
445
- expect(body.error.message).toBe('The requested RO-Crate metadata was not found');
446
- });
447
-
448
- it('should return 500 when head handler throws error', async () => {
449
- prisma.entity.findFirst.mockResolvedValue(mockFileEntity);
450
- vi.mocked(mockRoCrateHandler.head).mockRejectedValue(new Error('Metadata error'));
451
-
452
- const response = await fastify.inject({
453
- method: 'HEAD',
454
- url: `/entity/${encodeURIComponent('http://example.com/entity/file.wav')}/metadata`,
455
- });
456
- const body = JSON.parse(response.body) as { error: { code: string } };
457
-
458
- expect(response.statusCode).toBe(500);
459
- expect(body.error.code).toBe('INTERNAL_ERROR');
460
- });
461
- });
462
-
463
- describe('GET /entity/:id/metadata - exhaustiveness check', () => {
464
- it('should handle unexpected RO-Crate result type', async () => {
465
- prisma.entity.findFirst.mockResolvedValue(mockFileEntity);
466
-
467
- // Mock an invalid result type to test exhaustiveness check
468
- const invalidResult = {
469
- type: 'invalid',
470
- metadata: { contentType: 'application/ld+json', contentLength: 1024 },
471
- };
472
- vi.mocked(mockRoCrateHandler.get).mockResolvedValue(invalidResult as never);
473
-
474
- const response = await fastify.inject({
475
- method: 'GET',
476
- url: `/entity/${encodeURIComponent('http://example.com/entity/file.wav')}/metadata`,
477
- });
478
- const body = JSON.parse(response.body) as { error: { code: string } };
479
-
480
- expect(response.statusCode).toBe(500);
481
- expect(body.error.code).toBe('INTERNAL_ERROR');
482
- });
483
- });
484
- });