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,538 +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 { FileHandler, FileResult } 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 fileRoute from './file.js';
11
-
12
- vi.mock('node:fs', () => ({
13
- createReadStream: vi.fn(),
14
- }));
15
-
16
- describe('File Route', () => {
17
- const mockFileHandler: FileHandler = {
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(fileRoute, {
26
- access: mockAccess,
27
- entityVisibilityFilter: AllVisibleEntityFilter,
28
- refusal: { promptLoginForHidden: false },
29
- prisma,
30
- fileHandler: mockFileHandler,
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 mockFile = {
42
- id: 'http://example.com/file/test.wav',
43
- filename: 'test.wav',
44
- mediaType: 'audio/wav',
45
- size: BigInt(1024),
46
- meta: { storagePath: '/data/files/test.wav' },
47
- createdAt: new Date(),
48
- updatedAt: new Date(),
49
- entity: {
50
- id: 'http://example.com/file/test.wav',
51
- name: 'test.wav',
52
- description: 'A test file',
53
- entityType: 'http://schema.org/MediaObject',
54
- memberOf: 'http://example.com/object',
55
- rootCollection: 'http://example.com/collection',
56
- metadataLicenseId: 'https://creativecommons.org/licenses/by/4.0/',
57
- contentLicenseId: 'https://example.com/licence/restricted',
58
- meta: {},
59
- createdAt: new Date(),
60
- updatedAt: new Date(),
61
- },
62
- };
63
- const { entity: _entity, ...handlerFile } = mockFile;
64
-
65
- describe('GET /file/:id', () => {
66
- it('should stream file content successfully', async () => {
67
- prisma.file.findFirst.mockResolvedValue(mockFile);
68
-
69
- const mockStream = Readable.from(['test file content']);
70
- const mockResult: FileResult = {
71
- type: 'stream',
72
- stream: mockStream,
73
- metadata: {
74
- contentType: 'audio/wav',
75
- contentLength: 17,
76
- etag: '"abc123"',
77
- lastModified: new Date('2025-01-01'),
78
- },
79
- };
80
- vi.mocked(mockFileHandler.get).mockResolvedValue(mockResult);
81
-
82
- const response = await fastify.inject({
83
- method: 'GET',
84
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
85
- });
86
-
87
- expect(response.statusCode).toBe(200);
88
- expect(response.headers['content-type']).toBe('audio/wav');
89
- expect(response.headers['content-length']).toBe('17');
90
- expect(response.headers.etag).toBe('"abc123"');
91
- expect(response.headers['content-disposition']).toBe('inline; filename=test.wav');
92
- expect(response.body).toBe('test file content');
93
-
94
- expect(mockFileHandler.get).toHaveBeenCalledWith(
95
- handlerFile,
96
- expect.objectContaining({
97
- request: expect.any(Object),
98
- fastify: expect.any(Object),
99
- }),
100
- );
101
- });
102
-
103
- it('should handle attachment disposition', async () => {
104
- prisma.file.findFirst.mockResolvedValue(mockFile);
105
-
106
- const mockStream = Readable.from(['test']);
107
- const mockResult: FileResult = {
108
- type: 'stream',
109
- stream: mockStream,
110
- metadata: {
111
- contentType: 'audio/wav',
112
- contentLength: 4,
113
- },
114
- };
115
- vi.mocked(mockFileHandler.get).mockResolvedValue(mockResult);
116
-
117
- const response = await fastify.inject({
118
- method: 'GET',
119
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}?disposition=attachment`,
120
- });
121
-
122
- expect(response.statusCode).toBe(200);
123
- expect(response.headers['content-disposition']).toBe('attachment; filename=test.wav');
124
- });
125
-
126
- it('should use custom filename when provided', async () => {
127
- prisma.file.findFirst.mockResolvedValue(mockFile);
128
-
129
- const mockStream = Readable.from(['test']);
130
- const mockResult: FileResult = {
131
- type: 'stream',
132
- stream: mockStream,
133
- metadata: {
134
- contentType: 'audio/wav',
135
- contentLength: 4,
136
- },
137
- };
138
- vi.mocked(mockFileHandler.get).mockResolvedValue(mockResult);
139
-
140
- const response = await fastify.inject({
141
- method: 'GET',
142
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}?filename=custom-name.wav`,
143
- });
144
-
145
- expect(response.statusCode).toBe(200);
146
- expect(response.headers['content-disposition']).toBe('inline; filename=custom-name.wav');
147
- });
148
-
149
- it.each([
150
- {
151
- name: 'a non-Latin stored filename',
152
- stored: 'ŋaŋa.wav',
153
- query: '',
154
- expected: `inline; filename="?a?a.wav"; filename*=UTF-8''%C5%8Ba%C5%8Ba.wav`,
155
- },
156
- {
157
- name: 'quotes in a custom filename',
158
- stored: 'test.wav',
159
- query: `?filename=${encodeURIComponent(`a"; filename*=UTF-8''evil.html`)}`,
160
- expected: `inline; filename="a\\"; filename*=UTF-8''evil.html"`,
161
- },
162
- {
163
- name: 'backslashes in a stored filename',
164
- stored: 'back\\slash.wav',
165
- query: '',
166
- expected: 'inline; filename="back\\\\slash.wav"',
167
- },
168
- ])('should encode $name', async ({ stored, query, expected }) => {
169
- prisma.file.findFirst.mockResolvedValue({ ...mockFile, filename: stored });
170
- vi.mocked(mockFileHandler.get).mockResolvedValue({
171
- type: 'stream',
172
- stream: Readable.from(['test']),
173
- metadata: { contentType: 'audio/wav', contentLength: 4 },
174
- });
175
-
176
- const response = await fastify.inject({
177
- method: 'GET',
178
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}${query}`,
179
- });
180
-
181
- expect(response.statusCode).toBe(200);
182
- expect(response.headers['content-disposition']).toBe(expected);
183
- });
184
-
185
- it.each(['', '?noRedirect=false'])('should redirect when the query is %j', async (query) => {
186
- prisma.file.findFirst.mockResolvedValue(mockFile);
187
-
188
- const mockResult: FileResult = {
189
- type: 'redirect',
190
- url: 'https://storage.example.com/files/test.wav',
191
- };
192
- vi.mocked(mockFileHandler.get).mockResolvedValue(mockResult);
193
-
194
- const response = await fastify.inject({
195
- method: 'GET',
196
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}${query}`,
197
- });
198
-
199
- expect(response.statusCode).toBe(302);
200
- expect(response.headers.location).toBe('https://storage.example.com/files/test.wav');
201
- });
202
-
203
- it('should handle redirect response with noRedirect=true', async () => {
204
- prisma.file.findFirst.mockResolvedValue(mockFile);
205
-
206
- const mockResult: FileResult = {
207
- type: 'redirect',
208
- url: 'https://storage.example.com/files/test.wav',
209
- };
210
- vi.mocked(mockFileHandler.get).mockResolvedValue(mockResult);
211
-
212
- const response = await fastify.inject({
213
- method: 'GET',
214
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}?noRedirect=true`,
215
- });
216
-
217
- expect(response.statusCode).toBe(200);
218
- const body = JSON.parse(response.body);
219
- expect(body).toEqual({ location: 'https://storage.example.com/files/test.wav' });
220
- });
221
-
222
- it.each(['', '1', 'TRUE', 'yes'])('should return 400 for noRedirect=%j', async (value) => {
223
- const response = await fastify.inject({
224
- method: 'GET',
225
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}?noRedirect=${value}`,
226
- });
227
- const body = JSON.parse(response.body) as StandardErrorResponse;
228
-
229
- expect(response.statusCode).toBe(400);
230
- expect(body.error.code).toBe('VALIDATION_ERROR');
231
- expect(mockFileHandler.get).not.toHaveBeenCalled();
232
- });
233
-
234
- it('should handle file path response without nginx X-Accel-Redirect', async () => {
235
- prisma.file.findFirst.mockResolvedValue(mockFile);
236
-
237
- const mockStream = Readable.from(['file content']);
238
- vi.mocked(createReadStream).mockReturnValue(mockStream as never);
239
-
240
- const mockResult: FileResult = {
241
- type: 'file',
242
- path: '/data/files/test.wav',
243
- metadata: {
244
- contentType: 'audio/wav',
245
- contentLength: 1024,
246
- },
247
- };
248
- vi.mocked(mockFileHandler.get).mockResolvedValue(mockResult);
249
-
250
- const response = await fastify.inject({
251
- method: 'GET',
252
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
253
- });
254
-
255
- expect(response.statusCode).toBe(200);
256
- expect(response.headers['content-type']).toBe('audio/wav');
257
- expect(response.headers['content-length']).toBe('1024');
258
- expect(response.headers['x-accel-redirect']).toBeUndefined();
259
- expect(createReadStream).toHaveBeenCalledWith('/data/files/test.wav');
260
- });
261
-
262
- it('should handle file path response with nginx X-Accel-Redirect', async () => {
263
- prisma.file.findFirst.mockResolvedValue(mockFile);
264
-
265
- const mockResult: FileResult = {
266
- type: 'file',
267
- path: '/data/files/test.wav',
268
- accelPath: '/internal/files/test.wav',
269
- metadata: {
270
- contentType: 'audio/wav',
271
- contentLength: 1024,
272
- },
273
- };
274
- vi.mocked(mockFileHandler.get).mockResolvedValue(mockResult);
275
-
276
- const response = await fastify.inject({
277
- method: 'GET',
278
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
279
- });
280
-
281
- expect(response.statusCode).toBe(200);
282
- expect(response.headers['content-type']).toBe('audio/wav');
283
- // Note: Content-Length is '0' because Fastify sends an empty response.
284
- // In production, nginx will replace this with the actual file size when serving via X-Accel-Redirect
285
- expect(response.headers['content-length']).toBe('0');
286
- expect(response.headers['x-accel-redirect']).toBe('/internal/files/test.wav');
287
- expect(response.body).toBe(''); // Empty body when using X-Accel-Redirect
288
- });
289
-
290
- it('should return 404 when entity not found', async () => {
291
- prisma.file.findFirst.mockResolvedValue(null);
292
-
293
- const response = await fastify.inject({
294
- method: 'GET',
295
- url: `/file/${encodeURIComponent('http://example.com/file/nonexistent')}`,
296
- });
297
- const body = JSON.parse(response.body) as { error: { code: string; message: string } };
298
-
299
- expect(response.statusCode).toBe(404);
300
- expect(body.error.code).toBe('NOT_FOUND');
301
- expect(body.error.message).toBe('The requested file was not found');
302
- expect(mockFileHandler.get).not.toHaveBeenCalled();
303
- });
304
-
305
- it('should return 500 when database error occurs', async () => {
306
- prisma.file.findFirst.mockRejectedValue(new Error('Database connection failed'));
307
-
308
- const response = await fastify.inject({
309
- method: 'GET',
310
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
311
- });
312
- const body = JSON.parse(response.body) as { error: { code: string } };
313
-
314
- expect(response.statusCode).toBe(500);
315
- expect(body.error.code).toBe('INTERNAL_ERROR');
316
- });
317
-
318
- it('should decide access on the file entity without looking up its parents', async () => {
319
- prisma.file.findFirst.mockResolvedValue(mockFile);
320
- vi.mocked(mockFileHandler.get).mockResolvedValue({ type: 'redirect', url: 'https://example.com/test.wav' });
321
-
322
- await fastify.inject({
323
- method: 'GET',
324
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
325
- });
326
-
327
- expect(prisma.file.findFirst).toHaveBeenCalledWith(
328
- expect.objectContaining({ include: { entity: { omit: { meta: true } } } }),
329
- );
330
- expect(mockAccess).toHaveBeenCalledWith(
331
- expect.objectContaining({
332
- id: 'http://example.com/file/test.wav',
333
- contentLicenseId: 'https://example.com/licence/restricted',
334
- memberOf: 'http://example.com/object',
335
- rootCollection: 'http://example.com/collection',
336
- }),
337
- expect.objectContaining({ request: expect.any(Object), fastify: expect.any(Object) }),
338
- );
339
- expect(prisma.entity.findMany).not.toHaveBeenCalled();
340
- });
341
-
342
- it('should return 403 when the content is not accessible', async () => {
343
- prisma.file.findFirst.mockResolvedValue(mockFile);
344
- mockAccess.mockReturnValue({ metadata: true, content: false });
345
-
346
- const response = await fastify.inject({
347
- method: 'GET',
348
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
349
- });
350
- const body = JSON.parse(response.body) as { error: { code: string; message: string } };
351
-
352
- expect(response.statusCode).toBe(403);
353
- expect(body.error.code).toBe('FORBIDDEN');
354
- expect(body.error.message).toBe('You do not have permission to access this resource');
355
- expect(mockFileHandler.get).not.toHaveBeenCalled();
356
- });
357
-
358
- it('should serve the content when only the metadata is not accessible', async () => {
359
- prisma.file.findFirst.mockResolvedValue(mockFile);
360
- mockAccess.mockReturnValue({ metadata: false, content: true });
361
- vi.mocked(mockFileHandler.get).mockResolvedValue({ type: 'redirect', url: 'https://example.com/test.wav' });
362
-
363
- const response = await fastify.inject({
364
- method: 'GET',
365
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
366
- });
367
-
368
- expect(response.statusCode).toBe(302);
369
- expect(mockFileHandler.get).toHaveBeenCalled();
370
- });
371
-
372
- it('should return 500 when fileHandler throws error', async () => {
373
- prisma.file.findFirst.mockResolvedValue(mockFile);
374
- vi.mocked(mockFileHandler.get).mockRejectedValue(new Error('File not found in storage'));
375
-
376
- const response = await fastify.inject({
377
- method: 'GET',
378
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
379
- });
380
- const body = JSON.parse(response.body) as { error: { code: string } };
381
-
382
- expect(response.statusCode).toBe(500);
383
- expect(body.error.code).toBe('INTERNAL_ERROR');
384
- });
385
-
386
- it('should validate ID parameter format', async () => {
387
- const response = await fastify.inject({
388
- method: 'GET',
389
- url: '/file/invalid-id',
390
- });
391
- const body = JSON.parse(response.body) as StandardErrorResponse;
392
-
393
- expect(response.statusCode).toBe(400);
394
- expect(body.error.code).toBe('VALIDATION_ERROR');
395
- });
396
-
397
- it('should validate disposition parameter', async () => {
398
- prisma.file.findFirst.mockResolvedValue(mockFile);
399
-
400
- const response = await fastify.inject({
401
- method: 'GET',
402
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}?disposition=invalid`,
403
- });
404
- const body = JSON.parse(response.body) as StandardErrorResponse;
405
-
406
- expect(response.statusCode).toBe(400);
407
- expect(body.error.code).toBe('VALIDATION_ERROR');
408
- });
409
-
410
- it('should return 404 when get handler returns false', async () => {
411
- prisma.file.findFirst.mockResolvedValue(mockFile);
412
- vi.mocked(mockFileHandler.get).mockResolvedValue(false);
413
-
414
- const response = await fastify.inject({
415
- method: 'GET',
416
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
417
- });
418
- const body = JSON.parse(response.body) as { error: { code: string; message: string } };
419
-
420
- expect(response.statusCode).toBe(404);
421
- expect(body.error.code).toBe('NOT_FOUND');
422
- expect(body.error.message).toBe('The requested file could not be retrieved');
423
- });
424
- });
425
-
426
- describe('HEAD /file/:id', () => {
427
- it('should return headers without body using head handler', async () => {
428
- prisma.file.findFirst.mockResolvedValue(mockFile);
429
-
430
- const mockMetadata = {
431
- contentType: 'audio/wav',
432
- contentLength: 17,
433
- etag: '"abc123"',
434
- lastModified: new Date('2025-01-01'),
435
- };
436
- vi.mocked(mockFileHandler.head).mockResolvedValue(mockMetadata);
437
-
438
- const response = await fastify.inject({
439
- method: 'HEAD',
440
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
441
- });
442
-
443
- expect(response.statusCode).toBe(200);
444
- expect(response.headers['content-type']).toBe('audio/wav');
445
- expect(response.headers['content-length']).toBe('17');
446
- expect(response.headers.etag).toBe('"abc123"');
447
- expect(response.body).toBe(''); // No body for HEAD
448
-
449
- expect(mockFileHandler.head).toHaveBeenCalledWith(
450
- handlerFile,
451
- expect.objectContaining({
452
- request: expect.any(Object),
453
- fastify: expect.any(Object),
454
- }),
455
- );
456
- });
457
-
458
- it('should return 404 when file not found', async () => {
459
- prisma.file.findFirst.mockResolvedValue(null);
460
-
461
- const response = await fastify.inject({
462
- method: 'HEAD',
463
- url: `/file/${encodeURIComponent('http://example.com/file/nonexistent')}`,
464
- });
465
- const body = JSON.parse(response.body) as { error: { code: string } };
466
-
467
- expect(response.statusCode).toBe(404);
468
- expect(body.error.code).toBe('NOT_FOUND');
469
- expect(mockFileHandler.get).not.toHaveBeenCalled();
470
- });
471
-
472
- it('should return 403 when the content is not accessible', async () => {
473
- prisma.file.findFirst.mockResolvedValue(mockFile);
474
- mockAccess.mockReturnValue({ metadata: true, content: false });
475
-
476
- const response = await fastify.inject({
477
- method: 'HEAD',
478
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
479
- });
480
-
481
- expect(response.statusCode).toBe(403);
482
- expect(mockFileHandler.head).not.toHaveBeenCalled();
483
- });
484
-
485
- it('should return 500 when head handler throws error', async () => {
486
- prisma.file.findFirst.mockResolvedValue(mockFile);
487
- vi.mocked(mockFileHandler.head).mockRejectedValue(new Error('Failed to get metadata'));
488
-
489
- const response = await fastify.inject({
490
- method: 'HEAD',
491
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
492
- });
493
- const body = JSON.parse(response.body) as { error: { code: string } };
494
-
495
- expect(response.statusCode).toBe(500);
496
- expect(body.error.code).toBe('INTERNAL_ERROR');
497
- });
498
-
499
- it('should return 404 when head handler returns false', async () => {
500
- prisma.file.findFirst.mockResolvedValue(mockFile);
501
- vi.mocked(mockFileHandler.head).mockResolvedValue(false);
502
-
503
- const response = await fastify.inject({
504
- method: 'HEAD',
505
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
506
- });
507
- const body = JSON.parse(response.body) as { error: { code: string; message: string } };
508
-
509
- expect(response.statusCode).toBe(404);
510
- expect(body.error.code).toBe('NOT_FOUND');
511
- expect(body.error.message).toBe('The requested file metadata was not found');
512
- });
513
- });
514
-
515
- describe('GET /file/:id - exhaustiveness check', () => {
516
- it('should handle unexpected file result type', async () => {
517
- prisma.file.findFirst.mockResolvedValue(mockFile);
518
-
519
- // Mock an invalid result type to test exhaustiveness check
520
- const invalidResult = {
521
- type: 'invalid',
522
- metadata: { contentType: 'audio/wav', contentLength: 1024 },
523
- };
524
- vi.mocked(mockFileHandler.get).mockResolvedValue(invalidResult as never);
525
-
526
- const response = await fastify.inject({
527
- method: 'GET',
528
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
529
- });
530
- const body = JSON.parse(response.body) as { error: { code: string; message: string } };
531
-
532
- expect(response.statusCode).toBe(500);
533
- expect(body.error.code).toBe('INTERNAL_ERROR');
534
- expect(response.headers['content-disposition']).toBeUndefined();
535
- expect(response.headers['content-type']).toContain('application/json');
536
- });
537
- });
538
- });