arocapi 5.0.0-beta.4 → 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 (160) hide show
  1. package/LICENSE.md +1 -1
  2. package/README.md +3 -3
  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/file.js +5 -1
  12. package/dist/routes/file.js.map +1 -1
  13. package/dist/routes/search.d.ts +2 -4
  14. package/dist/routes/search.js +75 -97
  15. package/dist/routes/search.js.map +1 -1
  16. package/dist/search/advanced.d.ts +8 -0
  17. package/dist/search/advanced.js +198 -0
  18. package/dist/search/advanced.js.map +1 -0
  19. package/dist/search/backend.d.ts +95 -0
  20. package/dist/search/backend.js +5 -0
  21. package/dist/search/backend.js.map +1 -0
  22. package/dist/search/fields.d.ts +63 -0
  23. package/dist/search/fields.js +203 -0
  24. package/dist/search/fields.js.map +1 -0
  25. package/dist/search/opensearch/advanced.d.ts +4 -0
  26. package/dist/search/opensearch/advanced.js +28 -0
  27. package/dist/search/opensearch/advanced.js.map +1 -0
  28. package/dist/search/opensearch/opensearch.d.ts +16 -0
  29. package/dist/search/opensearch/opensearch.js +187 -0
  30. package/dist/search/opensearch/opensearch.js.map +1 -0
  31. package/dist/search/opensearch/visibility.d.ts +3 -0
  32. package/dist/search/opensearch/visibility.js +27 -0
  33. package/dist/search/opensearch/visibility.js.map +1 -0
  34. package/dist/search/postgres/advanced.d.ts +7 -0
  35. package/dist/search/postgres/advanced.js +54 -0
  36. package/dist/search/postgres/advanced.js.map +1 -0
  37. package/dist/search/postgres/facets.d.ts +2 -0
  38. package/dist/search/postgres/facets.js +27 -0
  39. package/dist/search/postgres/facets.js.map +1 -0
  40. package/dist/search/postgres/geo.d.ts +6 -0
  41. package/dist/search/postgres/geo.js +42 -0
  42. package/dist/search/postgres/geo.js.map +1 -0
  43. package/dist/search/postgres/postgres.d.ts +19 -0
  44. package/dist/search/postgres/postgres.js +157 -0
  45. package/dist/search/postgres/postgres.js.map +1 -0
  46. package/dist/search/postgres/values.d.ts +8 -0
  47. package/dist/search/postgres/values.js +20 -0
  48. package/dist/search/postgres/values.js.map +1 -0
  49. package/dist/search/postgres/visibility.d.ts +4 -0
  50. package/dist/search/postgres/visibility.js +38 -0
  51. package/dist/search/postgres/visibility.js.map +1 -0
  52. package/dist/search/requestFilters.d.ts +39 -0
  53. package/dist/search/requestFilters.js +125 -0
  54. package/dist/search/requestFilters.js.map +1 -0
  55. package/dist/search/visibility.d.ts +51 -0
  56. package/dist/search/visibility.js +100 -0
  57. package/dist/search/visibility.js.map +1 -0
  58. package/dist/types/visibility.d.ts +3 -2
  59. package/dist/utils/visibility.js +1 -1
  60. package/dist/utils/visibility.js.map +1 -1
  61. package/package.json +46 -26
  62. package/prisma/models/entity.prisma +9 -8
  63. package/prisma/models/entitySearch.prisma +21 -0
  64. package/prisma/models/file.prisma +3 -3
  65. package/src/app.ts +53 -24
  66. package/src/routes/capabilities.ts +4 -4
  67. package/src/routes/entities.ts +10 -9
  68. package/src/routes/file.ts +5 -1
  69. package/src/routes/search.ts +104 -118
  70. package/src/search/advanced.ts +258 -0
  71. package/src/search/backend.ts +91 -0
  72. package/src/search/fields.ts +320 -0
  73. package/src/search/opensearch/advanced.ts +36 -0
  74. package/src/search/opensearch/opensearch.ts +290 -0
  75. package/src/search/opensearch/visibility.ts +38 -0
  76. package/src/search/postgres/advanced.ts +76 -0
  77. package/src/search/postgres/facets.ts +34 -0
  78. package/src/search/postgres/geo.ts +58 -0
  79. package/src/search/postgres/postgres.ts +232 -0
  80. package/src/search/postgres/values.ts +33 -0
  81. package/src/search/postgres/visibility.ts +54 -0
  82. package/src/search/requestFilters.ts +178 -0
  83. package/src/search/visibility.ts +193 -0
  84. package/src/types/visibility.ts +6 -3
  85. package/src/utils/visibility.ts +1 -1
  86. package/dist/app.test.d.ts +0 -1
  87. package/dist/app.test.js +0 -67
  88. package/dist/app.test.js.map +0 -1
  89. package/dist/errorHandling.test.d.ts +0 -1
  90. package/dist/errorHandling.test.js +0 -222
  91. package/dist/errorHandling.test.js.map +0 -1
  92. package/dist/index.dev.d.ts +0 -1
  93. package/dist/index.dev.js +0 -157
  94. package/dist/index.dev.js.map +0 -1
  95. package/dist/routes/capabilities.test.d.ts +0 -1
  96. package/dist/routes/capabilities.test.js +0 -81
  97. package/dist/routes/capabilities.test.js.map +0 -1
  98. package/dist/routes/crate.test.d.ts +0 -1
  99. package/dist/routes/crate.test.js +0 -390
  100. package/dist/routes/crate.test.js.map +0 -1
  101. package/dist/routes/entities.test.d.ts +0 -1
  102. package/dist/routes/entities.test.js +0 -277
  103. package/dist/routes/entities.test.js.map +0 -1
  104. package/dist/routes/entity.test.d.ts +0 -1
  105. package/dist/routes/entity.test.js +0 -136
  106. package/dist/routes/entity.test.js.map +0 -1
  107. package/dist/routes/file.test.d.ts +0 -1
  108. package/dist/routes/file.test.js +0 -425
  109. package/dist/routes/file.test.js.map +0 -1
  110. package/dist/routes/files.test.d.ts +0 -1
  111. package/dist/routes/files.test.js +0 -245
  112. package/dist/routes/files.test.js.map +0 -1
  113. package/dist/routes/search.test.d.ts +0 -1
  114. package/dist/routes/search.test.js +0 -833
  115. package/dist/routes/search.test.js.map +0 -1
  116. package/dist/test/helpers/fastify.d.ts +0 -9
  117. package/dist/test/helpers/fastify.js +0 -17
  118. package/dist/test/helpers/fastify.js.map +0 -1
  119. package/dist/test/integration.setup.d.ts +0 -47
  120. package/dist/test/integration.setup.js +0 -195
  121. package/dist/test/integration.setup.js.map +0 -1
  122. package/dist/test/integration.test.d.ts +0 -1
  123. package/dist/test/integration.test.js +0 -762
  124. package/dist/test/integration.test.js.map +0 -1
  125. package/dist/transformers/default.test.d.ts +0 -1
  126. package/dist/transformers/default.test.js +0 -225
  127. package/dist/transformers/default.test.js.map +0 -1
  128. package/dist/transformers/transformer.test.d.ts +0 -1
  129. package/dist/transformers/transformer.test.js +0 -165
  130. package/dist/transformers/transformer.test.js.map +0 -1
  131. package/dist/utils/errors.test.d.ts +0 -1
  132. package/dist/utils/errors.test.js +0 -79
  133. package/dist/utils/errors.test.js.map +0 -1
  134. package/dist/utils/queryBuilder.d.ts +0 -47
  135. package/dist/utils/queryBuilder.js +0 -107
  136. package/dist/utils/queryBuilder.js.map +0 -1
  137. package/prisma.config.ts +0 -9
  138. package/src/app.test.ts +0 -91
  139. package/src/errorHandling.test.ts +0 -288
  140. package/src/index.dev.ts +0 -202
  141. package/src/reset.d.ts +0 -1
  142. package/src/routes/__snapshots__/capabilities.test.ts.snap +0 -34
  143. package/src/routes/__snapshots__/entities.test.ts.snap +0 -96
  144. package/src/routes/__snapshots__/entity.test.ts.snap +0 -74
  145. package/src/routes/__snapshots__/search.test.ts.snap +0 -165
  146. package/src/routes/capabilities.test.ts +0 -102
  147. package/src/routes/crate.test.ts +0 -484
  148. package/src/routes/entities.test.ts +0 -324
  149. package/src/routes/entity.test.ts +0 -166
  150. package/src/routes/file.test.ts +0 -526
  151. package/src/routes/files.test.ts +0 -304
  152. package/src/routes/search.test.ts +0 -959
  153. package/src/test/__snapshots__/integration.test.ts.snap +0 -18
  154. package/src/test/helpers/fastify.ts +0 -26
  155. package/src/test/integration.setup.ts +0 -220
  156. package/src/test/integration.test.ts +0 -953
  157. package/src/transformers/default.test.ts +0 -276
  158. package/src/transformers/transformer.test.ts +0 -226
  159. package/src/utils/errors.test.ts +0 -90
  160. package/src/utils/queryBuilder.ts +0 -157
@@ -1,526 +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('should handle redirect response with noRedirect=false (default)', async () => {
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')}`,
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('should handle file path response without nginx X-Accel-Redirect', async () => {
223
- prisma.file.findFirst.mockResolvedValue(mockFile);
224
-
225
- const mockStream = Readable.from(['file content']);
226
- vi.mocked(createReadStream).mockReturnValue(mockStream as never);
227
-
228
- const mockResult: FileResult = {
229
- type: 'file',
230
- path: '/data/files/test.wav',
231
- metadata: {
232
- contentType: 'audio/wav',
233
- contentLength: 1024,
234
- },
235
- };
236
- vi.mocked(mockFileHandler.get).mockResolvedValue(mockResult);
237
-
238
- const response = await fastify.inject({
239
- method: 'GET',
240
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
241
- });
242
-
243
- expect(response.statusCode).toBe(200);
244
- expect(response.headers['content-type']).toBe('audio/wav');
245
- expect(response.headers['content-length']).toBe('1024');
246
- expect(response.headers['x-accel-redirect']).toBeUndefined();
247
- expect(createReadStream).toHaveBeenCalledWith('/data/files/test.wav');
248
- });
249
-
250
- it('should handle file path response with nginx X-Accel-Redirect', async () => {
251
- prisma.file.findFirst.mockResolvedValue(mockFile);
252
-
253
- const mockResult: FileResult = {
254
- type: 'file',
255
- path: '/data/files/test.wav',
256
- accelPath: '/internal/files/test.wav',
257
- metadata: {
258
- contentType: 'audio/wav',
259
- contentLength: 1024,
260
- },
261
- };
262
- vi.mocked(mockFileHandler.get).mockResolvedValue(mockResult);
263
-
264
- const response = await fastify.inject({
265
- method: 'GET',
266
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
267
- });
268
-
269
- expect(response.statusCode).toBe(200);
270
- expect(response.headers['content-type']).toBe('audio/wav');
271
- // Note: Content-Length is '0' because Fastify sends an empty response.
272
- // In production, nginx will replace this with the actual file size when serving via X-Accel-Redirect
273
- expect(response.headers['content-length']).toBe('0');
274
- expect(response.headers['x-accel-redirect']).toBe('/internal/files/test.wav');
275
- expect(response.body).toBe(''); // Empty body when using X-Accel-Redirect
276
- });
277
-
278
- it('should return 404 when entity not found', async () => {
279
- prisma.file.findFirst.mockResolvedValue(null);
280
-
281
- const response = await fastify.inject({
282
- method: 'GET',
283
- url: `/file/${encodeURIComponent('http://example.com/file/nonexistent')}`,
284
- });
285
- const body = JSON.parse(response.body) as { error: { code: string; message: string } };
286
-
287
- expect(response.statusCode).toBe(404);
288
- expect(body.error.code).toBe('NOT_FOUND');
289
- expect(body.error.message).toBe('The requested file was not found');
290
- expect(mockFileHandler.get).not.toHaveBeenCalled();
291
- });
292
-
293
- it('should return 500 when database error occurs', async () => {
294
- prisma.file.findFirst.mockRejectedValue(new Error('Database connection failed'));
295
-
296
- const response = await fastify.inject({
297
- method: 'GET',
298
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
299
- });
300
- const body = JSON.parse(response.body) as { error: { code: string } };
301
-
302
- expect(response.statusCode).toBe(500);
303
- expect(body.error.code).toBe('INTERNAL_ERROR');
304
- });
305
-
306
- it('should decide access on the file entity without looking up its parents', async () => {
307
- prisma.file.findFirst.mockResolvedValue(mockFile);
308
- vi.mocked(mockFileHandler.get).mockResolvedValue({ type: 'redirect', url: 'https://example.com/test.wav' });
309
-
310
- await fastify.inject({
311
- method: 'GET',
312
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
313
- });
314
-
315
- expect(prisma.file.findFirst).toHaveBeenCalledWith(
316
- expect.objectContaining({ include: { entity: { omit: { meta: true } } } }),
317
- );
318
- expect(mockAccess).toHaveBeenCalledWith(
319
- expect.objectContaining({
320
- id: 'http://example.com/file/test.wav',
321
- contentLicenseId: 'https://example.com/licence/restricted',
322
- memberOf: 'http://example.com/object',
323
- rootCollection: 'http://example.com/collection',
324
- }),
325
- expect.objectContaining({ request: expect.any(Object), fastify: expect.any(Object) }),
326
- );
327
- expect(prisma.entity.findMany).not.toHaveBeenCalled();
328
- });
329
-
330
- it('should return 403 when the content is not accessible', async () => {
331
- prisma.file.findFirst.mockResolvedValue(mockFile);
332
- mockAccess.mockReturnValue({ metadata: true, content: false });
333
-
334
- const response = await fastify.inject({
335
- method: 'GET',
336
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
337
- });
338
- const body = JSON.parse(response.body) as { error: { code: string; message: string } };
339
-
340
- expect(response.statusCode).toBe(403);
341
- expect(body.error.code).toBe('FORBIDDEN');
342
- expect(body.error.message).toBe('You do not have permission to access this resource');
343
- expect(mockFileHandler.get).not.toHaveBeenCalled();
344
- });
345
-
346
- it('should serve the content when only the metadata is not accessible', async () => {
347
- prisma.file.findFirst.mockResolvedValue(mockFile);
348
- mockAccess.mockReturnValue({ metadata: false, content: true });
349
- vi.mocked(mockFileHandler.get).mockResolvedValue({ type: 'redirect', url: 'https://example.com/test.wav' });
350
-
351
- const response = await fastify.inject({
352
- method: 'GET',
353
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
354
- });
355
-
356
- expect(response.statusCode).toBe(302);
357
- expect(mockFileHandler.get).toHaveBeenCalled();
358
- });
359
-
360
- it('should return 500 when fileHandler throws error', async () => {
361
- prisma.file.findFirst.mockResolvedValue(mockFile);
362
- vi.mocked(mockFileHandler.get).mockRejectedValue(new Error('File not found in storage'));
363
-
364
- const response = await fastify.inject({
365
- method: 'GET',
366
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
367
- });
368
- const body = JSON.parse(response.body) as { error: { code: string } };
369
-
370
- expect(response.statusCode).toBe(500);
371
- expect(body.error.code).toBe('INTERNAL_ERROR');
372
- });
373
-
374
- it('should validate ID parameter format', async () => {
375
- const response = await fastify.inject({
376
- method: 'GET',
377
- url: '/file/invalid-id',
378
- });
379
- const body = JSON.parse(response.body) as StandardErrorResponse;
380
-
381
- expect(response.statusCode).toBe(400);
382
- expect(body.error.code).toBe('VALIDATION_ERROR');
383
- });
384
-
385
- it('should validate disposition parameter', async () => {
386
- prisma.file.findFirst.mockResolvedValue(mockFile);
387
-
388
- const response = await fastify.inject({
389
- method: 'GET',
390
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}?disposition=invalid`,
391
- });
392
- const body = JSON.parse(response.body) as StandardErrorResponse;
393
-
394
- expect(response.statusCode).toBe(400);
395
- expect(body.error.code).toBe('VALIDATION_ERROR');
396
- });
397
-
398
- it('should return 404 when get handler returns false', async () => {
399
- prisma.file.findFirst.mockResolvedValue(mockFile);
400
- vi.mocked(mockFileHandler.get).mockResolvedValue(false);
401
-
402
- const response = await fastify.inject({
403
- method: 'GET',
404
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
405
- });
406
- const body = JSON.parse(response.body) as { error: { code: string; message: string } };
407
-
408
- expect(response.statusCode).toBe(404);
409
- expect(body.error.code).toBe('NOT_FOUND');
410
- expect(body.error.message).toBe('The requested file could not be retrieved');
411
- });
412
- });
413
-
414
- describe('HEAD /file/:id', () => {
415
- it('should return headers without body using head handler', async () => {
416
- prisma.file.findFirst.mockResolvedValue(mockFile);
417
-
418
- const mockMetadata = {
419
- contentType: 'audio/wav',
420
- contentLength: 17,
421
- etag: '"abc123"',
422
- lastModified: new Date('2025-01-01'),
423
- };
424
- vi.mocked(mockFileHandler.head).mockResolvedValue(mockMetadata);
425
-
426
- const response = await fastify.inject({
427
- method: 'HEAD',
428
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
429
- });
430
-
431
- expect(response.statusCode).toBe(200);
432
- expect(response.headers['content-type']).toBe('audio/wav');
433
- expect(response.headers['content-length']).toBe('17');
434
- expect(response.headers.etag).toBe('"abc123"');
435
- expect(response.body).toBe(''); // No body for HEAD
436
-
437
- expect(mockFileHandler.head).toHaveBeenCalledWith(
438
- handlerFile,
439
- expect.objectContaining({
440
- request: expect.any(Object),
441
- fastify: expect.any(Object),
442
- }),
443
- );
444
- });
445
-
446
- it('should return 404 when file not found', async () => {
447
- prisma.file.findFirst.mockResolvedValue(null);
448
-
449
- const response = await fastify.inject({
450
- method: 'HEAD',
451
- url: `/file/${encodeURIComponent('http://example.com/file/nonexistent')}`,
452
- });
453
- const body = JSON.parse(response.body) as { error: { code: string } };
454
-
455
- expect(response.statusCode).toBe(404);
456
- expect(body.error.code).toBe('NOT_FOUND');
457
- expect(mockFileHandler.get).not.toHaveBeenCalled();
458
- });
459
-
460
- it('should return 403 when the content is not accessible', async () => {
461
- prisma.file.findFirst.mockResolvedValue(mockFile);
462
- mockAccess.mockReturnValue({ metadata: true, content: false });
463
-
464
- const response = await fastify.inject({
465
- method: 'HEAD',
466
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
467
- });
468
-
469
- expect(response.statusCode).toBe(403);
470
- expect(mockFileHandler.head).not.toHaveBeenCalled();
471
- });
472
-
473
- it('should return 500 when head handler throws error', async () => {
474
- prisma.file.findFirst.mockResolvedValue(mockFile);
475
- vi.mocked(mockFileHandler.head).mockRejectedValue(new Error('Failed to get metadata'));
476
-
477
- const response = await fastify.inject({
478
- method: 'HEAD',
479
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
480
- });
481
- const body = JSON.parse(response.body) as { error: { code: string } };
482
-
483
- expect(response.statusCode).toBe(500);
484
- expect(body.error.code).toBe('INTERNAL_ERROR');
485
- });
486
-
487
- it('should return 404 when head handler returns false', async () => {
488
- prisma.file.findFirst.mockResolvedValue(mockFile);
489
- vi.mocked(mockFileHandler.head).mockResolvedValue(false);
490
-
491
- const response = await fastify.inject({
492
- method: 'HEAD',
493
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
494
- });
495
- const body = JSON.parse(response.body) as { error: { code: string; message: string } };
496
-
497
- expect(response.statusCode).toBe(404);
498
- expect(body.error.code).toBe('NOT_FOUND');
499
- expect(body.error.message).toBe('The requested file metadata was not found');
500
- });
501
- });
502
-
503
- describe('GET /file/:id - exhaustiveness check', () => {
504
- it('should handle unexpected file result type', async () => {
505
- prisma.file.findFirst.mockResolvedValue(mockFile);
506
-
507
- // Mock an invalid result type to test exhaustiveness check
508
- const invalidResult = {
509
- type: 'invalid',
510
- metadata: { contentType: 'audio/wav', contentLength: 1024 },
511
- };
512
- vi.mocked(mockFileHandler.get).mockResolvedValue(invalidResult as never);
513
-
514
- const response = await fastify.inject({
515
- method: 'GET',
516
- url: `/file/${encodeURIComponent('http://example.com/file/test.wav')}`,
517
- });
518
- const body = JSON.parse(response.body) as { error: { code: string; message: string } };
519
-
520
- expect(response.statusCode).toBe(500);
521
- expect(body.error.code).toBe('INTERNAL_ERROR');
522
- expect(response.headers['content-disposition']).toBeUndefined();
523
- expect(response.headers['content-type']).toContain('application/json');
524
- });
525
- });
526
- });