@kollors/deep-json-server 0.2.4 → 0.2.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.
- package/README.md +3 -3
- package/README.ru.md +3 -3
- package/package.json +1 -1
- package/src/openapi.js +3 -3
- package/src/query.js +1 -1
- package/src/server.js +1 -1
package/README.md
CHANGED
|
@@ -109,7 +109,7 @@ DELETE /movies/:id
|
|
|
109
109
|
## Pagination and sorting
|
|
110
110
|
|
|
111
111
|
```http
|
|
112
|
-
GET /movies?_page=1&
|
|
112
|
+
GET /movies?_page=1&_perPage=10&_sort=-id,title
|
|
113
113
|
```
|
|
114
114
|
|
|
115
115
|
Without `_page`, a GET collection returns an array. With `_page`, it returns:
|
|
@@ -224,12 +224,12 @@ deep-json-server mock/database.json --generate mock/database-schema.json mock/op
|
|
|
224
224
|
|
|
225
225
|
The generator infers resources and field types from all database records. Fields present in every record are required unless listed in `optional`; `formats` adds OpenAPI formats such as `date` and `uri`. Nested fields use dot paths, for example `actors.id`.
|
|
226
226
|
|
|
227
|
-
Use `
|
|
227
|
+
Use `name` when a resource needs an explicit schema name instead of the automatically singularized name:
|
|
228
228
|
|
|
229
229
|
```json
|
|
230
230
|
{
|
|
231
231
|
"equipment": {
|
|
232
|
-
"
|
|
232
|
+
"name": "Equipment"
|
|
233
233
|
}
|
|
234
234
|
}
|
|
235
235
|
```
|
package/README.ru.md
CHANGED
|
@@ -109,7 +109,7 @@ DELETE /movies/:id
|
|
|
109
109
|
## Пагинация и сортировка
|
|
110
110
|
|
|
111
111
|
```http
|
|
112
|
-
GET /movies?_page=1&
|
|
112
|
+
GET /movies?_page=1&_perPage=10&_sort=-id,title
|
|
113
113
|
```
|
|
114
114
|
|
|
115
115
|
Без `_page` GET-запрос к коллекции возвращает массив. С `_page` возвращается объект:
|
|
@@ -224,12 +224,12 @@ deep-json-server mock/database.json --generate mock/database-schema.json mock/op
|
|
|
224
224
|
|
|
225
225
|
Генератор определяет ресурсы и типы полей по всем записям базы. Поля, присутствующие в каждой записи, считаются обязательными, если они не перечислены в `optional`; `formats` добавляет форматы OpenAPI, например `date` и `uri`. Для вложенных полей используются пути через точку, например `actors.id`.
|
|
226
226
|
|
|
227
|
-
Используйте `
|
|
227
|
+
Используйте `name`, если ресурсу нужно явно задать имя схемы вместо автоматически полученного имени в единственном числе:
|
|
228
228
|
|
|
229
229
|
```json
|
|
230
230
|
{
|
|
231
231
|
"equipment": {
|
|
232
|
-
"
|
|
232
|
+
"name": "Equipment"
|
|
233
233
|
}
|
|
234
234
|
}
|
|
235
235
|
```
|
package/package.json
CHANGED
package/src/openapi.js
CHANGED
|
@@ -134,7 +134,7 @@ const createParameters = () => ({
|
|
|
134
134
|
Embed: { description: 'Relationship paths to embed', explode: true, in: 'query', name: '_embed', schema: { items: { type: 'string' }, type: 'array' }, style: 'form' },
|
|
135
135
|
Id: { in: 'path', name: 'id', required: true, schema: { type: 'string' } },
|
|
136
136
|
Page: { in: 'query', name: '_page', required: true, schema: { minimum: 1, type: 'integer' } },
|
|
137
|
-
PerPage: { in: 'query', name: '
|
|
137
|
+
PerPage: { in: 'query', name: '_perPage', required: true, schema: { minimum: 1, type: 'integer' } },
|
|
138
138
|
Sort: { description: 'Comma-separated fields; prefix with - for descending order', in: 'query', name: '_sort', schema: { type: 'string' } },
|
|
139
139
|
Where: { description: 'JSON-encoded deep filter', in: 'query', name: '_where', schema: { type: 'string' } },
|
|
140
140
|
});
|
|
@@ -202,7 +202,7 @@ export function createOpenApiDocument(database, schemaConfig = {}) {
|
|
|
202
202
|
const resources = getResourceNames(database);
|
|
203
203
|
const componentNames = Object.fromEntries(resources.map((resource) => {
|
|
204
204
|
const resourceConfig = isObject(schemaConfig[resource]) ? schemaConfig[resource] : {};
|
|
205
|
-
const componentName = typeof resourceConfig.
|
|
205
|
+
const componentName = typeof resourceConfig.name === 'string' && resourceConfig.name !== '' ? resourceConfig.name : toPascalCase(singularize(resource));
|
|
206
206
|
|
|
207
207
|
return [resource, componentName];
|
|
208
208
|
}));
|
|
@@ -256,7 +256,7 @@ export async function generateOpenApi({ databasePath, outputPath, schemaPath })
|
|
|
256
256
|
const resolvedOutputPath = resolve(outputPath);
|
|
257
257
|
|
|
258
258
|
await mkdir(dirname(resolvedOutputPath), { recursive: true });
|
|
259
|
-
await writeFile(resolvedOutputPath, stringify(document, { lineWidth: 0 }), 'utf8');
|
|
259
|
+
await writeFile(resolvedOutputPath, stringify(document, { aliasDuplicateObjects: false, lineWidth: 0 }), 'utf8');
|
|
260
260
|
|
|
261
261
|
return document;
|
|
262
262
|
}
|
package/src/query.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { createHttpError, isEqual, isObject, isSafeKey, toArray } from './utils.js';
|
|
2
2
|
|
|
3
3
|
const FIELD_OPERATORS = new Set(['contains', 'endsWith', 'eq', 'every', 'gt', 'gte', 'in', 'lt', 'lte', 'ne', 'none', 'not', 'some', 'startsWith']);
|
|
4
|
-
const RESERVED_QUERY_KEYS = new Set(['_embed', '_page', '
|
|
4
|
+
const RESERVED_QUERY_KEYS = new Set(['_embed', '_page', '_perPage', '_sort', '_where']);
|
|
5
5
|
|
|
6
6
|
const compareValues = (left, right) => {
|
|
7
7
|
if (Object.is(left, right)) {
|
package/src/server.js
CHANGED
|
@@ -56,7 +56,7 @@ export async function createServer({ databasePath, logger = true } = {}) {
|
|
|
56
56
|
const sortedItems = sortItems(filteredItems, request.query._sort);
|
|
57
57
|
const page = request.query._page == null ? undefined : Number(request.query._page);
|
|
58
58
|
|
|
59
|
-
return page == null ? sortedItems : paginateItems(sortedItems, page, Number(request.query.
|
|
59
|
+
return page == null ? sortedItems : paginateItems(sortedItems, page, Number(request.query._perPage));
|
|
60
60
|
});
|
|
61
61
|
|
|
62
62
|
server.get('/:resource/:id', async(request) => {
|