arocapi 1.1.0 → 1.2.2

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 (128) hide show
  1. package/LICENSE.md +5 -0
  2. package/README.md +459 -36
  3. package/dist/app.d.ts +19 -1
  4. package/dist/app.js +37 -29
  5. package/dist/app.js.map +1 -1
  6. package/dist/app.test.js +124 -0
  7. package/dist/app.test.js.map +1 -0
  8. package/dist/index.dev.js +146 -0
  9. package/dist/index.dev.js.map +1 -0
  10. package/dist/routes/crate.d.ts +7 -0
  11. package/dist/routes/crate.js +101 -0
  12. package/dist/routes/crate.js.map +1 -0
  13. package/dist/routes/crate.test.d.ts +1 -0
  14. package/dist/routes/crate.test.js +360 -0
  15. package/dist/routes/crate.test.js.map +1 -0
  16. package/dist/routes/entities.d.ts +6 -1
  17. package/dist/routes/entities.js +52 -39
  18. package/dist/routes/entities.js.map +1 -1
  19. package/dist/routes/entities.test.d.ts +1 -0
  20. package/dist/routes/entities.test.js +245 -0
  21. package/dist/routes/entities.test.js.map +1 -0
  22. package/dist/routes/entity.d.ts +6 -1
  23. package/dist/routes/entity.js +30 -8
  24. package/dist/routes/entity.js.map +1 -1
  25. package/dist/routes/entity.test.d.ts +1 -0
  26. package/dist/routes/entity.test.js +109 -0
  27. package/dist/routes/entity.test.js.map +1 -0
  28. package/dist/routes/file.d.ts +7 -0
  29. package/dist/routes/file.js +113 -0
  30. package/dist/routes/file.js.map +1 -0
  31. package/dist/routes/file.test.d.ts +1 -0
  32. package/dist/routes/file.test.js +319 -0
  33. package/dist/routes/file.test.js.map +1 -0
  34. package/dist/routes/files.d.ts +8 -0
  35. package/dist/routes/files.js +62 -0
  36. package/dist/routes/files.js.map +1 -0
  37. package/dist/routes/files.test.d.ts +1 -0
  38. package/dist/routes/files.test.js +244 -0
  39. package/dist/routes/files.test.js.map +1 -0
  40. package/dist/routes/search.d.ts +6 -1
  41. package/dist/routes/search.js +44 -19
  42. package/dist/routes/search.js.map +1 -1
  43. package/dist/routes/search.test.d.ts +1 -0
  44. package/dist/routes/search.test.js +698 -0
  45. package/dist/routes/search.test.js.map +1 -0
  46. package/dist/test/helpers/fastify.d.ts +9 -0
  47. package/dist/test/helpers/fastify.js +24 -0
  48. package/dist/test/helpers/fastify.js.map +1 -0
  49. package/dist/test/integration.setup.d.ts +58 -0
  50. package/dist/test/integration.setup.js +181 -0
  51. package/dist/test/integration.setup.js.map +1 -0
  52. package/dist/test/integration.test.d.ts +1 -0
  53. package/dist/test/integration.test.js +337 -0
  54. package/dist/test/integration.test.js.map +1 -0
  55. package/dist/transformers/default.d.ts +45 -0
  56. package/dist/transformers/default.js +46 -0
  57. package/dist/transformers/default.js.map +1 -0
  58. package/dist/transformers/default.test.d.ts +1 -0
  59. package/dist/transformers/default.test.js +177 -0
  60. package/dist/transformers/default.test.js.map +1 -0
  61. package/dist/transformers/transformer.test.d.ts +1 -0
  62. package/dist/transformers/transformer.test.js +176 -0
  63. package/dist/transformers/transformer.test.js.map +1 -0
  64. package/dist/types/fileHandlers.d.ts +41 -0
  65. package/dist/types/fileHandlers.js +2 -0
  66. package/dist/types/fileHandlers.js.map +1 -0
  67. package/dist/types/transformers.d.ts +10 -0
  68. package/dist/types/transformers.js +2 -0
  69. package/dist/types/transformers.js.map +1 -0
  70. package/dist/utils/errors.d.ts +23 -0
  71. package/dist/utils/errors.js +21 -0
  72. package/dist/utils/errors.js.map +1 -0
  73. package/dist/utils/errors.test.d.ts +1 -0
  74. package/dist/utils/errors.test.js +66 -0
  75. package/dist/utils/errors.test.js.map +1 -0
  76. package/package.json +35 -28
  77. package/prisma/migrations/20250827033956_record_type_scalar/migration.sql +10 -0
  78. package/prisma/migrations/20250923032753_api_refactor/migration.sql +39 -0
  79. package/prisma/migrations/20250923223119_entity_type_to_string/migration.sql +8 -0
  80. package/prisma/migrations/20251020140329_add_meta_column/migration.sql +2 -0
  81. package/prisma/migrations/20251027010713_add_file_table/migration.sql +17 -0
  82. package/prisma/migrations/20251027221138_add_file_id_to_entity/migration.sql +2 -0
  83. package/prisma/models/entity.prisma +16 -12
  84. package/prisma/models/file.prisma +20 -0
  85. package/prisma.config.ts +6 -1
  86. package/src/__snapshots__/app.test.ts.snap +8 -0
  87. package/src/app.test.ts +158 -0
  88. package/src/app.ts +99 -36
  89. package/src/index.dev.ts +196 -0
  90. package/src/reset.d.ts +1 -0
  91. package/src/routes/__snapshots__/entities.test.ts.snap +68 -0
  92. package/src/routes/__snapshots__/entity.test.ts.snap +57 -0
  93. package/src/routes/__snapshots__/search.test.ts.snap +139 -0
  94. package/src/routes/crate.test.ts +441 -0
  95. package/src/routes/crate.ts +145 -0
  96. package/src/routes/entities.test.ts +284 -0
  97. package/src/routes/entities.ts +69 -48
  98. package/src/routes/entity.test.ts +132 -0
  99. package/src/routes/entity.ts +59 -22
  100. package/src/routes/file.test.ts +399 -0
  101. package/src/routes/file.ts +157 -0
  102. package/src/routes/files.test.ts +303 -0
  103. package/src/routes/files.ts +89 -0
  104. package/src/routes/search.test.ts +807 -0
  105. package/src/routes/search.ts +67 -25
  106. package/src/test/__snapshots__/integration.test.ts.snap +18 -0
  107. package/src/test/helpers/fastify.ts +39 -0
  108. package/src/test/integration.setup.ts +200 -0
  109. package/src/test/integration.test.ts +411 -0
  110. package/src/transformers/default.test.ts +199 -0
  111. package/src/transformers/default.ts +165 -0
  112. package/src/transformers/transformer.test.ts +233 -0
  113. package/src/types/fileHandlers.ts +65 -0
  114. package/src/types/transformers.ts +52 -0
  115. package/src/utils/errors.test.ts +75 -0
  116. package/src/utils/errors.ts +45 -0
  117. package/dist/index.js +0 -25
  118. package/dist/index.js.map +0 -1
  119. package/dist/scripts/loadEntities.js +0 -170
  120. package/dist/scripts/loadEntities.js.map +0 -1
  121. package/dist/type.d.ts +0 -6
  122. package/dist/type.js +0 -2
  123. package/dist/type.js.map +0 -1
  124. package/src/index.ts +0 -35
  125. package/src/scripts/loadEntities.ts +0 -223
  126. package/src/type.ts +0 -7
  127. /package/dist/{scripts/loadEntities.d.ts → app.test.d.ts} +0 -0
  128. /package/dist/{index.d.ts → index.dev.d.ts} +0 -0
@@ -0,0 +1,245 @@
1
+ import { afterEach, beforeEach, describe, expect, it } from 'vitest';
2
+ import { fastify, fastifyAfter, fastifyBefore, prisma } from '../test/helpers/fastify.js';
3
+ import { AllPublicAccessTransformer } from '../transformers/default.js';
4
+ import entitiesRoute from './entities.js';
5
+ describe('Entities Route', () => {
6
+ beforeEach(async () => {
7
+ await fastifyBefore();
8
+ await fastify.register(entitiesRoute, { accessTransformer: AllPublicAccessTransformer });
9
+ });
10
+ afterEach(async () => {
11
+ await fastifyAfter();
12
+ });
13
+ describe('GET /entities', () => {
14
+ it('should return entities with default pagination', async () => {
15
+ const mockEntities = [
16
+ {
17
+ id: 1,
18
+ rocrateId: 'http://example.com/entity/1',
19
+ name: 'Test Entity 1',
20
+ description: 'First test entity',
21
+ entityType: 'http://pcdm.org/models#Collection',
22
+ fileId: null,
23
+ memberOf: null,
24
+ rootCollection: null,
25
+ metadataLicenseId: 'https://creativecommons.org/licenses/by/4.0/',
26
+ contentLicenseId: 'https://creativecommons.org/licenses/by/4.0/',
27
+ createdAt: new Date(),
28
+ updatedAt: new Date(),
29
+ rocrate: {},
30
+ meta: {},
31
+ },
32
+ {
33
+ id: 2,
34
+ rocrateId: 'http://example.com/entity/2',
35
+ name: 'Test Entity 2',
36
+ description: 'Second test entity',
37
+ entityType: 'http://pcdm.org/models#Object',
38
+ fileId: null,
39
+ memberOf: 'http://example.com/entity/1',
40
+ rootCollection: 'http://example.com/entity/1',
41
+ metadataLicenseId: 'https://creativecommons.org/licenses/by/4.0/',
42
+ contentLicenseId: 'https://creativecommons.org/licenses/by/4.0/',
43
+ createdAt: new Date(),
44
+ updatedAt: new Date(),
45
+ rocrate: {},
46
+ meta: {},
47
+ },
48
+ ];
49
+ prisma.entity.findMany.mockResolvedValue(mockEntities);
50
+ prisma.entity.count.mockResolvedValue(2);
51
+ const response = await fastify.inject({
52
+ method: 'GET',
53
+ url: '/entities',
54
+ });
55
+ const body = JSON.parse(response.body);
56
+ expect(response.statusCode).toBe(200);
57
+ expect(body).toMatchSnapshot();
58
+ expect(prisma.entity.findMany).toHaveBeenCalledWith({
59
+ where: {},
60
+ orderBy: { rocrateId: 'asc' },
61
+ skip: 0,
62
+ take: 100,
63
+ });
64
+ });
65
+ it('should filter by memberOf', async () => {
66
+ prisma.entity.findMany.mockResolvedValue([]);
67
+ prisma.entity.count.mockResolvedValue(0);
68
+ const response = await fastify.inject({
69
+ method: 'GET',
70
+ url: '/entities',
71
+ query: {
72
+ memberOf: 'http://example.com/collection/1',
73
+ },
74
+ });
75
+ expect(response.statusCode).toBe(200);
76
+ expect(prisma.entity.findMany).toHaveBeenCalledWith({
77
+ where: { memberOf: 'http://example.com/collection/1' },
78
+ orderBy: { rocrateId: 'asc' },
79
+ skip: 0,
80
+ take: 100,
81
+ });
82
+ });
83
+ it('should filter by single entity type', async () => {
84
+ prisma.entity.findMany.mockResolvedValue([]);
85
+ prisma.entity.count.mockResolvedValue(0);
86
+ const response = await fastify.inject({
87
+ method: 'GET',
88
+ url: '/entities',
89
+ query: {
90
+ entityType: 'http://pcdm.org/models#Collection',
91
+ },
92
+ });
93
+ expect(response.statusCode).toBe(200);
94
+ expect(prisma.entity.findMany).toHaveBeenCalledWith({
95
+ where: { entityType: { in: ['http://pcdm.org/models#Collection'] } },
96
+ orderBy: { rocrateId: 'asc' },
97
+ skip: 0,
98
+ take: 100,
99
+ });
100
+ });
101
+ it('should filter by multiple entity types', async () => {
102
+ prisma.entity.findMany.mockResolvedValue([]);
103
+ prisma.entity.count.mockResolvedValue(0);
104
+ const response = await fastify.inject({
105
+ method: 'GET',
106
+ url: '/entities',
107
+ query: {
108
+ entityType: 'http://pcdm.org/models#Collection,http://pcdm.org/models#Object',
109
+ },
110
+ });
111
+ expect(response.statusCode).toBe(200);
112
+ expect(prisma.entity.findMany).toHaveBeenCalledWith({
113
+ where: {
114
+ entityType: {
115
+ in: ['http://pcdm.org/models#Collection', 'http://pcdm.org/models#Object'],
116
+ },
117
+ },
118
+ orderBy: { rocrateId: 'asc' },
119
+ skip: 0,
120
+ take: 100,
121
+ });
122
+ });
123
+ it('should handle pagination parameters', async () => {
124
+ prisma.entity.findMany.mockResolvedValue([]);
125
+ prisma.entity.count.mockResolvedValue(0);
126
+ const response = await fastify.inject({
127
+ method: 'GET',
128
+ url: '/entities',
129
+ query: {
130
+ limit: '50',
131
+ offset: '10',
132
+ },
133
+ });
134
+ expect(response.statusCode).toBe(200);
135
+ expect(prisma.entity.findMany).toHaveBeenCalledWith({
136
+ where: {},
137
+ orderBy: { rocrateId: 'asc' },
138
+ skip: 10,
139
+ take: 50,
140
+ });
141
+ });
142
+ it('should handle sorting by name descending', async () => {
143
+ prisma.entity.findMany.mockResolvedValue([]);
144
+ prisma.entity.count.mockResolvedValue(0);
145
+ const response = await fastify.inject({
146
+ method: 'GET',
147
+ url: '/entities',
148
+ query: {
149
+ sort: 'name',
150
+ order: 'desc',
151
+ },
152
+ });
153
+ expect(response.statusCode).toBe(200);
154
+ expect(prisma.entity.findMany).toHaveBeenCalledWith({
155
+ where: {},
156
+ orderBy: { name: 'desc' },
157
+ skip: 0,
158
+ take: 100,
159
+ });
160
+ });
161
+ it('should map id sort to rocrateId field', async () => {
162
+ prisma.entity.findMany.mockResolvedValue([]);
163
+ prisma.entity.count.mockResolvedValue(0);
164
+ const response = await fastify.inject({
165
+ method: 'GET',
166
+ url: '/entities',
167
+ query: {
168
+ sort: 'id',
169
+ },
170
+ });
171
+ expect(response.statusCode).toBe(200);
172
+ expect(prisma.entity.findMany).toHaveBeenCalledWith({
173
+ where: {},
174
+ orderBy: { rocrateId: 'asc' },
175
+ skip: 0,
176
+ take: 100,
177
+ });
178
+ });
179
+ it('should return 500 when database error occurs', async () => {
180
+ prisma.entity.findMany.mockRejectedValue(new Error('Database connection failed'));
181
+ const response = await fastify.inject({
182
+ method: 'GET',
183
+ url: '/entities',
184
+ });
185
+ expect(response.statusCode).toBe(500);
186
+ const body = JSON.parse(response.body);
187
+ expect(body).toMatchSnapshot();
188
+ });
189
+ it('should validate limit parameter bounds', async () => {
190
+ const response = await fastify.inject({
191
+ method: 'GET',
192
+ url: '/entities',
193
+ query: {
194
+ limit: '0',
195
+ },
196
+ });
197
+ expect(response.statusCode).toBe(400);
198
+ });
199
+ it('should validate negative offset', async () => {
200
+ const response = await fastify.inject({
201
+ method: 'GET',
202
+ url: '/entities',
203
+ query: {
204
+ offset: '-1',
205
+ },
206
+ });
207
+ expect(response.statusCode).toBe(400);
208
+ });
209
+ it('should apply custom entity transformers', async () => {
210
+ const customTransformer = async (entity) => ({
211
+ ...entity,
212
+ tested: true,
213
+ });
214
+ await fastifyBefore();
215
+ await fastify.register(entitiesRoute, {
216
+ accessTransformer: AllPublicAccessTransformer,
217
+ entityTransformers: [customTransformer],
218
+ });
219
+ const mockEntities = [
220
+ {
221
+ id: 1,
222
+ rocrateId: 'http://example.com/entity/1',
223
+ name: 'Test Entity 1',
224
+ description: 'First test entity',
225
+ entityType: 'http://pcdm.org/models#Collection',
226
+ memberOf: null,
227
+ rootCollection: null,
228
+ metadataLicenseId: 'https://creativecommons.org/licenses/by/4.0/',
229
+ contentLicenseId: 'https://creativecommons.org/licenses/by/4.0/',
230
+ createdAt: new Date(),
231
+ updatedAt: new Date(),
232
+ },
233
+ ];
234
+ prisma.entity.findMany.mockResolvedValue(mockEntities);
235
+ const response = await fastify.inject({
236
+ method: 'GET',
237
+ url: '/entities',
238
+ });
239
+ const body = JSON.parse(response.body);
240
+ expect(response.statusCode).toBe(200);
241
+ expect(body).toMatchSnapshot();
242
+ });
243
+ });
244
+ });
245
+ //# sourceMappingURL=entities.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entities.test.js","sourceRoot":"","sources":["../../src/routes/entities.test.ts"],"names":[],"mappings":"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"}
@@ -1,3 +1,8 @@
1
1
  import type { FastifyPluginAsync } from 'fastify';
2
- declare const entity: FastifyPluginAsync;
2
+ import type { AccessTransformer, EntityTransformer } from '../types/transformers.js';
3
+ type EntityRouteOptions = {
4
+ accessTransformer: AccessTransformer;
5
+ entityTransformers?: EntityTransformer[];
6
+ };
7
+ declare const entity: FastifyPluginAsync<EntityRouteOptions>;
3
8
  export default entity;
@@ -1,22 +1,44 @@
1
- const entity = async (fastify, _opts) => {
2
- fastify.get('/entity/:id', async (request, reply) => {
1
+ import { z } from 'zod/v4';
2
+ import { baseEntityTransformer } from '../transformers/default.js';
3
+ import { createInternalError, createNotFoundError } from '../utils/errors.js';
4
+ const paramsSchema = z.object({
5
+ id: z.string().regex(/^https?:\/\/.+/, 'Invalid URI format'),
6
+ });
7
+ const entity = async (fastify, opts) => {
8
+ const { accessTransformer, entityTransformers = [] } = opts;
9
+ fastify.withTypeProvider().get('/entity/:id', {
10
+ schema: {
11
+ params: paramsSchema,
12
+ },
13
+ }, async (request, reply) => {
3
14
  const { id } = request.params;
4
- console.log('🪚 request:', request);
5
15
  try {
6
16
  const entity = await fastify.prisma.entity.findFirst({
7
17
  where: {
8
18
  rocrateId: id,
9
19
  },
10
20
  });
11
- console.log('🪚 id:', JSON.stringify(id, null, 2));
12
21
  if (!entity) {
13
- return reply.code(404).send({ message: 'Entity not found' });
22
+ return reply.code(404).send(createNotFoundError('The requested entity was not found', id));
14
23
  }
15
- return entity.rocrate;
24
+ const standardEntity = baseEntityTransformer(entity);
25
+ const authorisedEntity = await accessTransformer(standardEntity, {
26
+ request,
27
+ fastify,
28
+ });
29
+ let result = authorisedEntity;
30
+ for (const transformer of entityTransformers) {
31
+ result = await transformer(result, {
32
+ request,
33
+ fastify,
34
+ });
35
+ }
36
+ return result;
16
37
  }
17
38
  catch (error) {
18
- fastify.log.error('Database error:', error);
19
- return reply.code(500).send({ message: 'Internal server error' });
39
+ const err = error;
40
+ fastify.log.error(`Database error: ${err.message}`);
41
+ return reply.code(500).send(createInternalError());
20
42
  }
21
43
  });
22
44
  };
@@ -1 +1 @@
1
- {"version":3,"file":"entity.js","sourceRoot":"","sources":["../../src/routes/entity.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAuB,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;IAC1D,OAAO,CAAC,GAAG,CAA6B,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAC9E,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAEpC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;gBACnD,KAAK,EAAE;oBACL,SAAS,EAAE,EAAE;iBACd;aACF,CAAC,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAEnD,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAC/D,CAAC;YAED,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;YAC5C,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,eAAe,MAAM,CAAC"}
1
+ {"version":3,"file":"entity.js","sourceRoot":"","sources":["../../src/routes/entity.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9E,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,gBAAgB,EAAE,oBAAoB,CAAC;CAC7D,CAAC,CAAC;AAOH,MAAM,MAAM,GAA2C,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;IAC7E,MAAM,EAAE,iBAAiB,EAAE,kBAAkB,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC;IAC5D,OAAO,CAAC,gBAAgB,EAAmB,CAAC,GAAG,CAC7C,aAAa,EACb;QACE,MAAM,EAAE;YACN,MAAM,EAAE,YAAY;SACrB;KACF,EACD,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAE9B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;gBACnD,KAAK,EAAE;oBACL,SAAS,EAAE,EAAE;iBACd;aACF,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,oCAAoC,EAAE,EAAE,CAAC,CAAC,CAAC;YAC7F,CAAC;YAED,MAAM,cAAc,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;YACrD,MAAM,gBAAgB,GAAG,MAAM,iBAAiB,CAAC,cAAc,EAAE;gBAC/D,OAAO;gBACP,OAAO;aACR,CAAC,CAAC;YAEH,IAAI,MAAM,GAAG,gBAAgB,CAAC;YAC9B,KAAK,MAAM,WAAW,IAAI,kBAAkB,EAAE,CAAC;gBAC7C,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE;oBACjC,OAAO;oBACP,OAAO;iBACR,CAAC,CAAC;YACL,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAc,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,mBAAmB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAEpD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,MAAM,CAAC"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,109 @@
1
+ import { afterEach, beforeEach, describe, expect, it } from 'vitest';
2
+ import { fastify, fastifyAfter, fastifyBefore, prisma } from '../test/helpers/fastify.js';
3
+ import { AllPublicAccessTransformer } from '../transformers/default.js';
4
+ import entityRoute from './entity.js';
5
+ describe('Entity Route', () => {
6
+ beforeEach(async () => {
7
+ await fastifyBefore();
8
+ await fastify.register(entityRoute, { accessTransformer: AllPublicAccessTransformer });
9
+ });
10
+ afterEach(async () => {
11
+ await fastifyAfter();
12
+ });
13
+ describe('GET /entity/:id', () => {
14
+ it('should return entity when found', async () => {
15
+ const mockEntity = {
16
+ id: 1,
17
+ rocrateId: 'http://example.com/entity/123',
18
+ name: 'Test Entity',
19
+ description: 'A test entity',
20
+ entityType: 'http://schema.org/Person',
21
+ fileId: null,
22
+ memberOf: null,
23
+ rootCollection: null,
24
+ metadataLicenseId: 'https://creativecommons.org/licenses/by/4.0/',
25
+ contentLicenseId: 'https://creativecommons.org/licenses/by/4.0/',
26
+ createdAt: new Date(),
27
+ updatedAt: new Date(),
28
+ rocrate: {},
29
+ meta: {},
30
+ };
31
+ prisma.entity.findFirst.mockResolvedValue(mockEntity);
32
+ const response = await fastify.inject({
33
+ method: 'GET',
34
+ url: `/entity/${encodeURIComponent('http://example.com/entity/123')}`,
35
+ });
36
+ const body = JSON.parse(response.body);
37
+ expect(response.statusCode).toBe(200);
38
+ expect(body).toMatchSnapshot();
39
+ expect(prisma.entity.findFirst).toHaveBeenCalledWith({
40
+ where: {
41
+ rocrateId: 'http://example.com/entity/123',
42
+ },
43
+ });
44
+ });
45
+ it('should return 404 when entity not found', async () => {
46
+ console.log('🪚 ♊');
47
+ prisma.entity.findFirst.mockResolvedValue(null);
48
+ const response = await fastify.inject({
49
+ method: 'GET',
50
+ url: `/entity/${encodeURIComponent('http://example.com/entity/nonexistent')}`,
51
+ });
52
+ const body = JSON.parse(response.body);
53
+ expect(response.statusCode).toBe(404);
54
+ expect(body).toMatchSnapshot();
55
+ });
56
+ it('should return 500 when database error occurs', async () => {
57
+ prisma.entity.findFirst.mockRejectedValue(new Error('Database connection failed'));
58
+ const response = await fastify.inject({
59
+ method: 'GET',
60
+ url: `/entity/${encodeURIComponent('http://example.com/entity/123')}`,
61
+ });
62
+ const body = JSON.parse(response.body);
63
+ expect(response.statusCode).toBe(500);
64
+ expect(body).toMatchSnapshot();
65
+ });
66
+ it('should validate ID parameter format', async () => {
67
+ const response = await fastify.inject({
68
+ method: 'GET',
69
+ url: '/entity/invalid-id',
70
+ });
71
+ const body = JSON.parse(response.body);
72
+ expect(response.statusCode).toBe(400);
73
+ expect(body.error).toBe('Bad Request');
74
+ });
75
+ it('should apply custom entity transformers', async () => {
76
+ const customTransformer = async (entity) => ({
77
+ ...entity,
78
+ tested: true,
79
+ });
80
+ await fastifyBefore();
81
+ await fastify.register(entityRoute, {
82
+ accessTransformer: AllPublicAccessTransformer,
83
+ entityTransformers: [customTransformer],
84
+ });
85
+ const mockEntity = {
86
+ id: 1,
87
+ rocrateId: 'http://example.com/entity/123',
88
+ name: 'Test Entity',
89
+ description: 'A test entity',
90
+ entityType: 'http://pcdm.org/models#Collection',
91
+ memberOf: null,
92
+ rootCollection: null,
93
+ metadataLicenseId: 'https://creativecommons.org/licenses/by/4.0/',
94
+ contentLicenseId: 'https://creativecommons.org/licenses/by/4.0/',
95
+ createdAt: new Date(),
96
+ updatedAt: new Date(),
97
+ };
98
+ prisma.entity.findFirst.mockResolvedValue(mockEntity);
99
+ const response = await fastify.inject({
100
+ method: 'GET',
101
+ url: `/entity/${encodeURIComponent('http://example.com/entity/123')}`,
102
+ });
103
+ const body = JSON.parse(response.body);
104
+ expect(response.statusCode).toBe(200);
105
+ expect(body).toMatchSnapshot();
106
+ });
107
+ });
108
+ });
109
+ //# sourceMappingURL=entity.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entity.test.js","sourceRoot":"","sources":["../../src/routes/entity.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAErE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAC1F,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAExE,OAAO,WAAW,MAAM,aAAa,CAAC;AAEtC,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,MAAM,aAAa,EAAE,CAAC;QACtB,MAAM,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,CAAC,CAAC;IACzF,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,YAAY,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;QAC/B,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;YAC/C,MAAM,UAAU,GAAG;gBACjB,EAAE,EAAE,CAAC;gBACL,SAAS,EAAE,+BAA+B;gBAC1C,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE,eAAe;gBAC5B,UAAU,EAAE,0BAA0B;gBACtC,MAAM,EAAE,IAAI;gBACZ,QAAQ,EAAE,IAAI;gBACd,cAAc,EAAE,IAAI;gBACpB,iBAAiB,EAAE,8CAA8C;gBACjE,gBAAgB,EAAE,8CAA8C;gBAChE,SAAS,EAAE,IAAI,IAAI,EAAE;gBACrB,SAAS,EAAE,IAAI,IAAI,EAAE;gBACrB,OAAO,EAAE,EAAE;gBACX,IAAI,EAAE,EAAE;aACT,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;YAEtD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC;gBACpC,MAAM,EAAE,KAAK;gBACb,GAAG,EAAE,WAAW,kBAAkB,CAAC,+BAA+B,CAAC,EAAE;aACtE,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAEvC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC;YAC/B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC;gBACnD,KAAK,EAAE;oBACL,SAAS,EAAE,+BAA+B;iBAC3C;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;YACvD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACpB,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAEhD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC;gBACpC,MAAM,EAAE,KAAK;gBACb,GAAG,EAAE,WAAW,kBAAkB,CAAC,uCAAuC,CAAC,EAAE;aAC9E,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAEvC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC;QACjC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;YAC5D,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;YAEnF,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC;gBACpC,MAAM,EAAE,KAAK;gBACb,GAAG,EAAE,WAAW,kBAAkB,CAAC,+BAA+B,CAAC,EAAE;aACtE,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAEvC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC;QACjC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;YACnD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC;gBACpC,MAAM,EAAE,KAAK;gBACb,GAAG,EAAE,oBAAoB;aAC1B,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAA0B,CAAC;YAEhE,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;YAEvD,MAAM,iBAAiB,GAAG,KAAK,EAAE,MAAW,EAAE,EAAE,CAAC,CAAC;gBAChD,GAAG,MAAM;gBACT,MAAM,EAAE,IAAI;aACb,CAAC,CAAC;YAEH,MAAM,aAAa,EAAE,CAAC;YACtB,MAAM,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE;gBAClC,iBAAiB,EAAE,0BAA0B;gBAC7C,kBAAkB,EAAE,CAAC,iBAAiB,CAAC;aACxC,CAAC,CAAC;YAEH,MAAM,UAAU,GAAG;gBACjB,EAAE,EAAE,CAAC;gBACL,SAAS,EAAE,+BAA+B;gBAC1C,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE,eAAe;gBAC5B,UAAU,EAAE,mCAAmC;gBAC/C,QAAQ,EAAE,IAAI;gBACd,cAAc,EAAE,IAAI;gBACpB,iBAAiB,EAAE,8CAA8C;gBACjE,gBAAgB,EAAE,8CAA8C;gBAChE,SAAS,EAAE,IAAI,IAAI,EAAE;gBACrB,SAAS,EAAE,IAAI,IAAI,EAAE;aACtB,CAAC;YAGF,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;YAEtD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC;gBACpC,MAAM,EAAE,KAAK;gBACb,GAAG,EAAE,WAAW,kBAAkB,CAAC,+BAA+B,CAAC,EAAE;aACtE,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAEvC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -0,0 +1,7 @@
1
+ import type { FastifyPluginAsync } from 'fastify';
2
+ import type { FileHandler } from '../types/fileHandlers.js';
3
+ type FileRouteOptions = {
4
+ fileHandler: FileHandler;
5
+ };
6
+ declare const file: FastifyPluginAsync<FileRouteOptions>;
7
+ export default file;
@@ -0,0 +1,113 @@
1
+ import { createReadStream } from 'node:fs';
2
+ import { z } from 'zod/v4';
3
+ import { createInternalError, createNotFoundError } from '../utils/errors.js';
4
+ const paramsSchema = z.object({
5
+ id: z.string().regex(/^https?:\/\/.+/, 'Invalid URI format'),
6
+ });
7
+ const querySchema = z.object({
8
+ disposition: z.enum(['inline', 'attachment']).optional().default('inline'),
9
+ filename: z.string().optional(),
10
+ noRedirect: z.coerce.boolean().optional().default(false),
11
+ });
12
+ const setFileHeaders = (reply, metadata) => {
13
+ reply.header('Content-Type', metadata.contentType);
14
+ reply.header('Content-Length', metadata.contentLength.toString());
15
+ if (metadata.etag) {
16
+ reply.header('ETag', metadata.etag);
17
+ }
18
+ if (metadata.lastModified) {
19
+ reply.header('Last-Modified', metadata.lastModified.toUTCString());
20
+ }
21
+ };
22
+ const file = async (fastify, opts) => {
23
+ const { fileHandler } = opts;
24
+ fastify.withTypeProvider().head('/file/:id', {
25
+ schema: {
26
+ params: paramsSchema,
27
+ },
28
+ }, async (request, reply) => {
29
+ const { id } = request.params;
30
+ try {
31
+ const file = await fastify.prisma.file.findFirst({
32
+ where: {
33
+ fileId: id,
34
+ },
35
+ });
36
+ if (!file) {
37
+ return reply.code(404).send(createNotFoundError('The requested file was not found', id));
38
+ }
39
+ const metadata = await fileHandler.head(file, {
40
+ request,
41
+ fastify,
42
+ });
43
+ if (!metadata) {
44
+ return reply.code(404).send(createNotFoundError('The requested file metadata was not found', id));
45
+ }
46
+ setFileHeaders(reply, metadata);
47
+ return reply.code(200).send();
48
+ }
49
+ catch (error) {
50
+ const err = error;
51
+ fastify.log.error(`File metadata retrieval error: ${err.message}`);
52
+ return reply.code(500).send(createInternalError());
53
+ }
54
+ });
55
+ fastify.withTypeProvider().get('/file/:id', {
56
+ schema: {
57
+ params: paramsSchema,
58
+ querystring: querySchema,
59
+ },
60
+ }, async (request, reply) => {
61
+ const { id } = request.params;
62
+ try {
63
+ const file = await fastify.prisma.file.findFirst({
64
+ where: {
65
+ fileId: id,
66
+ },
67
+ });
68
+ if (!file) {
69
+ return reply.code(404).send(createNotFoundError('The requested file was not found', id));
70
+ }
71
+ const result = await fileHandler.get(file, {
72
+ request,
73
+ fastify,
74
+ });
75
+ if (!result) {
76
+ return reply.code(404).send(createNotFoundError('The requested file could not be retrieved', id));
77
+ }
78
+ if (result.type === 'redirect') {
79
+ if (request.query.noRedirect) {
80
+ return reply.code(200).send({ location: result.url });
81
+ }
82
+ return reply.code(302).redirect(result.url);
83
+ }
84
+ const { disposition, filename: customFilename } = request.query;
85
+ const filename = customFilename || file.filename;
86
+ setFileHeaders(reply, result.metadata);
87
+ reply.header('Content-Disposition', `${disposition}; filename="${filename}"`);
88
+ if (result.type === 'stream') {
89
+ return reply.code(200).send(result.stream);
90
+ }
91
+ if (result.type === 'file') {
92
+ if (result.accelPath) {
93
+ reply.header('X-Accel-Redirect', result.accelPath);
94
+ return reply.code(200).send();
95
+ }
96
+ const stream = createReadStream(result.path);
97
+ return reply.code(200).send(stream);
98
+ }
99
+ console.error(`Unexpected file result type: ${result.type}`);
100
+ reply.removeHeader('Content-Disposition');
101
+ reply.removeHeader('Content-Type');
102
+ reply.removeHeader('Content-Length');
103
+ return reply.code(500).send(createInternalError());
104
+ }
105
+ catch (error) {
106
+ const err = error;
107
+ fastify.log.error(`File retrieval error: ${err}`);
108
+ return reply.code(500).send(createInternalError());
109
+ }
110
+ });
111
+ };
112
+ export default file;
113
+ //# sourceMappingURL=file.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"file.js","sourceRoot":"","sources":["../../src/routes/file.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export {};