arocapi 5.0.0-beta.5 → 5.0.0-beta.6

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 (157) hide show
  1. package/LICENSE.md +1 -1
  2. package/README.md +2 -2
  3. package/dist/app.d.ts +19 -13
  4. package/dist/app.js +13 -10
  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/search.d.ts +2 -4
  12. package/dist/routes/search.js +75 -97
  13. package/dist/routes/search.js.map +1 -1
  14. package/dist/search/advanced.d.ts +8 -0
  15. package/dist/search/advanced.js +198 -0
  16. package/dist/search/advanced.js.map +1 -0
  17. package/dist/search/backend.d.ts +95 -0
  18. package/dist/search/backend.js +5 -0
  19. package/dist/search/backend.js.map +1 -0
  20. package/dist/search/fields.d.ts +63 -0
  21. package/dist/search/fields.js +203 -0
  22. package/dist/search/fields.js.map +1 -0
  23. package/dist/search/opensearch/advanced.d.ts +4 -0
  24. package/dist/search/opensearch/advanced.js +28 -0
  25. package/dist/search/opensearch/advanced.js.map +1 -0
  26. package/dist/search/opensearch/opensearch.d.ts +16 -0
  27. package/dist/search/opensearch/opensearch.js +187 -0
  28. package/dist/search/opensearch/opensearch.js.map +1 -0
  29. package/dist/search/opensearch/visibility.d.ts +3 -0
  30. package/dist/search/opensearch/visibility.js +27 -0
  31. package/dist/search/opensearch/visibility.js.map +1 -0
  32. package/dist/search/postgres/advanced.d.ts +7 -0
  33. package/dist/search/postgres/advanced.js +54 -0
  34. package/dist/search/postgres/advanced.js.map +1 -0
  35. package/dist/search/postgres/facets.d.ts +2 -0
  36. package/dist/search/postgres/facets.js +27 -0
  37. package/dist/search/postgres/facets.js.map +1 -0
  38. package/dist/search/postgres/geo.d.ts +6 -0
  39. package/dist/search/postgres/geo.js +42 -0
  40. package/dist/search/postgres/geo.js.map +1 -0
  41. package/dist/search/postgres/postgres.d.ts +19 -0
  42. package/dist/search/postgres/postgres.js +157 -0
  43. package/dist/search/postgres/postgres.js.map +1 -0
  44. package/dist/search/postgres/values.d.ts +8 -0
  45. package/dist/search/postgres/values.js +20 -0
  46. package/dist/search/postgres/values.js.map +1 -0
  47. package/dist/search/postgres/visibility.d.ts +4 -0
  48. package/dist/search/postgres/visibility.js +38 -0
  49. package/dist/search/postgres/visibility.js.map +1 -0
  50. package/dist/search/requestFilters.d.ts +39 -0
  51. package/dist/search/requestFilters.js +125 -0
  52. package/dist/search/requestFilters.js.map +1 -0
  53. package/dist/search/visibility.d.ts +51 -0
  54. package/dist/search/visibility.js +100 -0
  55. package/dist/search/visibility.js.map +1 -0
  56. package/dist/types/visibility.d.ts +3 -2
  57. package/dist/utils/visibility.js +1 -1
  58. package/dist/utils/visibility.js.map +1 -1
  59. package/package.json +46 -26
  60. package/prisma/models/entity.prisma +9 -8
  61. package/prisma/models/entitySearch.prisma +21 -0
  62. package/prisma/models/file.prisma +3 -3
  63. package/src/app.ts +53 -24
  64. package/src/routes/capabilities.ts +4 -4
  65. package/src/routes/entities.ts +10 -9
  66. package/src/routes/search.ts +104 -118
  67. package/src/search/advanced.ts +258 -0
  68. package/src/search/backend.ts +91 -0
  69. package/src/search/fields.ts +320 -0
  70. package/src/search/opensearch/advanced.ts +36 -0
  71. package/src/search/opensearch/opensearch.ts +290 -0
  72. package/src/search/opensearch/visibility.ts +38 -0
  73. package/src/search/postgres/advanced.ts +76 -0
  74. package/src/search/postgres/facets.ts +34 -0
  75. package/src/search/postgres/geo.ts +58 -0
  76. package/src/search/postgres/postgres.ts +232 -0
  77. package/src/search/postgres/values.ts +33 -0
  78. package/src/search/postgres/visibility.ts +54 -0
  79. package/src/search/requestFilters.ts +178 -0
  80. package/src/search/visibility.ts +193 -0
  81. package/src/types/visibility.ts +6 -3
  82. package/src/utils/visibility.ts +1 -1
  83. package/dist/app.test.d.ts +0 -1
  84. package/dist/app.test.js +0 -67
  85. package/dist/app.test.js.map +0 -1
  86. package/dist/errorHandling.test.d.ts +0 -1
  87. package/dist/errorHandling.test.js +0 -222
  88. package/dist/errorHandling.test.js.map +0 -1
  89. package/dist/index.dev.d.ts +0 -1
  90. package/dist/index.dev.js +0 -157
  91. package/dist/index.dev.js.map +0 -1
  92. package/dist/routes/capabilities.test.d.ts +0 -1
  93. package/dist/routes/capabilities.test.js +0 -81
  94. package/dist/routes/capabilities.test.js.map +0 -1
  95. package/dist/routes/crate.test.d.ts +0 -1
  96. package/dist/routes/crate.test.js +0 -390
  97. package/dist/routes/crate.test.js.map +0 -1
  98. package/dist/routes/entities.test.d.ts +0 -1
  99. package/dist/routes/entities.test.js +0 -277
  100. package/dist/routes/entities.test.js.map +0 -1
  101. package/dist/routes/entity.test.d.ts +0 -1
  102. package/dist/routes/entity.test.js +0 -136
  103. package/dist/routes/entity.test.js.map +0 -1
  104. package/dist/routes/file.test.d.ts +0 -1
  105. package/dist/routes/file.test.js +0 -435
  106. package/dist/routes/file.test.js.map +0 -1
  107. package/dist/routes/files.test.d.ts +0 -1
  108. package/dist/routes/files.test.js +0 -245
  109. package/dist/routes/files.test.js.map +0 -1
  110. package/dist/routes/search.test.d.ts +0 -1
  111. package/dist/routes/search.test.js +0 -833
  112. package/dist/routes/search.test.js.map +0 -1
  113. package/dist/test/helpers/fastify.d.ts +0 -9
  114. package/dist/test/helpers/fastify.js +0 -17
  115. package/dist/test/helpers/fastify.js.map +0 -1
  116. package/dist/test/integration.setup.d.ts +0 -47
  117. package/dist/test/integration.setup.js +0 -195
  118. package/dist/test/integration.setup.js.map +0 -1
  119. package/dist/test/integration.test.d.ts +0 -1
  120. package/dist/test/integration.test.js +0 -762
  121. package/dist/test/integration.test.js.map +0 -1
  122. package/dist/transformers/default.test.d.ts +0 -1
  123. package/dist/transformers/default.test.js +0 -225
  124. package/dist/transformers/default.test.js.map +0 -1
  125. package/dist/transformers/transformer.test.d.ts +0 -1
  126. package/dist/transformers/transformer.test.js +0 -165
  127. package/dist/transformers/transformer.test.js.map +0 -1
  128. package/dist/utils/errors.test.d.ts +0 -1
  129. package/dist/utils/errors.test.js +0 -79
  130. package/dist/utils/errors.test.js.map +0 -1
  131. package/dist/utils/queryBuilder.d.ts +0 -47
  132. package/dist/utils/queryBuilder.js +0 -107
  133. package/dist/utils/queryBuilder.js.map +0 -1
  134. package/prisma.config.ts +0 -9
  135. package/src/app.test.ts +0 -91
  136. package/src/errorHandling.test.ts +0 -288
  137. package/src/index.dev.ts +0 -202
  138. package/src/reset.d.ts +0 -1
  139. package/src/routes/__snapshots__/capabilities.test.ts.snap +0 -34
  140. package/src/routes/__snapshots__/entities.test.ts.snap +0 -96
  141. package/src/routes/__snapshots__/entity.test.ts.snap +0 -74
  142. package/src/routes/__snapshots__/search.test.ts.snap +0 -165
  143. package/src/routes/capabilities.test.ts +0 -102
  144. package/src/routes/crate.test.ts +0 -484
  145. package/src/routes/entities.test.ts +0 -324
  146. package/src/routes/entity.test.ts +0 -166
  147. package/src/routes/file.test.ts +0 -538
  148. package/src/routes/files.test.ts +0 -304
  149. package/src/routes/search.test.ts +0 -959
  150. package/src/test/__snapshots__/integration.test.ts.snap +0 -18
  151. package/src/test/helpers/fastify.ts +0 -26
  152. package/src/test/integration.setup.ts +0 -220
  153. package/src/test/integration.test.ts +0 -953
  154. package/src/transformers/default.test.ts +0 -276
  155. package/src/transformers/transformer.test.ts +0 -226
  156. package/src/utils/errors.test.ts +0 -90
  157. 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
- });