@clipboard-health/json-api-nestjs
Version:
TypeScript-friendly utilities for adhering to the JSON:API specification with NestJS.
83 lines • 2.7 kB
JavaScript
;
Object.defineProperty(exports, "__esModule", { value: true });
exports.fieldsQuery = fieldsQuery;
const zod_1 = require("zod");
const splitString_1 = require("../internal/splitString");
/**
* Creates a Zod schema for JSON:API sparse fieldsets.
*
* @example
* <embedex source="packages/example-nestjs/examples/query.ts">
*
* ```ts
* import { booleanString } from "@clipboard-health/contract-core";
* import {
* cursorPaginationQuery,
* fieldsQuery,
* type FilterMap,
* filterQuery,
* includeQuery,
* sortQuery,
* } from "@clipboard-health/json-api-nestjs";
* import { z } from "zod";
*
* import {
* type ArticleAttributeFields,
* type UserAttributeFields,
* type UserIncludeFields,
* } from "../src/contract";
*
* const articleFields = ["title"] as const satisfies readonly ArticleAttributeFields[];
* const userFields = ["age", "dateOfBirth"] as const satisfies readonly UserAttributeFields[];
* const userIncludeFields = [
* "articles",
* "articles.comments",
* ] as const satisfies readonly UserIncludeFields[];
* const userFilterMap = {
* age: {
* filters: ["eq", "gt"],
* schema: z.coerce.number().int().positive().max(125),
* },
* dateOfBirth: {
* filters: ["gte"],
* schema: z.coerce.date().min(new Date("1900-01-01")).max(new Date()),
* },
* isActive: {
* filters: ["eq"],
* schema: booleanString,
* },
* } as const satisfies FilterMap<UserAttributeFields>;
*
* /**
* * Disclaimer: Just because JSON:API supports robust querying doesn’t mean your service should
* * implement them as they may require database indexes, which have a cost. **Implement only access
* * patterns required by clients.**
* *
* * The spec says that if clients provide fields the server doesn’t support, it **MUST** return 400
* * Bad Request, hence the `.strict()`.
* *\/
* export const query = z
* .object({
* ...cursorPaginationQuery(),
* ...fieldsQuery({ article: articleFields, user: userFields }),
* ...filterQuery(userFilterMap),
* ...sortQuery(userFields),
* ...includeQuery(userIncludeFields),
* })
* .strict();
* ```
*
* </embedex>
*
* @see {@link https://jsonapi.org/format/#fetching-sparse-fieldsets JSON:API sparse fieldsets}
*/
function fieldsQuery(parameters) {
const fieldSchemas = Object.fromEntries(Object.entries(parameters).map(([apiType, fields]) => [
apiType,
zod_1.z.preprocess(splitString_1.splitString, zod_1.z.enum(fields).array().min(1).max(100).optional()),
]));
return {
fields: zod_1.z.object(fieldSchemas).strict().optional(),
};
}
//# sourceMappingURL=fieldsQuery.js.map