@clipboard-health/json-api-nestjs 0.3.0 → 0.4.0

package/README.md

@@ -1,8 +1,8 @@
-# @clipboard-health/json-api-nestjs
+# @clipboard-health/json-api-nestjs <!-- omit from toc -->
 
 Utilities for adhering to the [JSON:API](https://jsonapi.org/) specification with [NestJS](https://nestjs.com/).
 
-## Table of Contents
+## Table of contents <!-- omit from toc -->
 
 - [Install](#install)
 - [Usage](#usage)
@@ -23,23 +23,44 @@ Create Zod schemas for your API's queries:
 
 <!-- prettier-ignore -->
 ```ts
-// ./examples/query.ts
+// ../example-nestjs/examples/query.ts
 
 import {
   booleanString,
-  createCursorPagination,
-  createFields,
-  createFilter,
-  createInclude,
-  createSort,
+  cursorPaginationQuery,
+  fieldsQuery,
+  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 includeFields = [
+  "articles",
+  "articles.comments",
+] as const satisfies readonly UserIncludeFields[];
+
+/**
+ * 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({
-    ...createCursorPagination(),
-    ...createFields({ user: ["age", "name"], article: ["title"] }),
-    ...createFilter({
+    ...cursorPaginationQuery(),
+    ...fieldsQuery({ user: userFields, article: articleFields }),
+    ...filterQuery({
       age: {
         filters: ["eq", "gt"],
         schema: z.coerce.number().int().positive().max(125),
@@ -50,11 +71,11 @@ export const query = z
       },
       dateOfBirth: {
         filters: ["gte"],
-        schema: z.coerce.date().min(new Date("1900-01-01")),
+        schema: z.coerce.date().min(new Date("1900-01-01")).max(new Date()),
       },
     }),
-    ...createSort(["age", "name"]),
-    ...createInclude(["articles", "articles.comments"]),
+    ...sortQuery(userFields),
+    ...includeQuery(includeFields),
   })
   .strict();
 

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@clipboard-health/json-api-nestjs",
   "description": "Utilities for adhering to the JSON:API specification with NestJS.",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "dependencies": {
     "tslib": "2.7.0",
+    "type-fest": "4.26.1",
     "zod": "3.23.8"
   },
   "keywords": [],

package/src/index.d.ts

@@ -1,7 +1,7 @@
-export * from "./lib/query/createCursorPagination";
-export * from "./lib/query/createFields";
-export * from "./lib/query/createFilter";
-export * from "./lib/query/createInclude";
-export * from "./lib/query/createSort";
+export * from "./lib/query/cursorPaginationQuery";
+export * from "./lib/query/fieldsQuery";
+export * from "./lib/query/filterQuery";
+export * from "./lib/query/includeQuery";
+export * from "./lib/query/sortQuery";
 export * from "./lib/schemas";
 export * from "./lib/types";

package/src/index.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./lib/query/createCursorPagination"), exports);
-tslib_1.__exportStar(require("./lib/query/createFields"), exports);
-tslib_1.__exportStar(require("./lib/query/createFilter"), exports);
-tslib_1.__exportStar(require("./lib/query/createInclude"), exports);
-tslib_1.__exportStar(require("./lib/query/createSort"), exports);
+tslib_1.__exportStar(require("./lib/query/cursorPaginationQuery"), exports);
+tslib_1.__exportStar(require("./lib/query/fieldsQuery"), exports);
+tslib_1.__exportStar(require("./lib/query/filterQuery"), exports);
+tslib_1.__exportStar(require("./lib/query/includeQuery"), exports);
+tslib_1.__exportStar(require("./lib/query/sortQuery"), exports);
 tslib_1.__exportStar(require("./lib/schemas"), exports);
 tslib_1.__exportStar(require("./lib/types"), exports);
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/json-api-nestjs/src/index.ts"],"names":[],"mappings":";;;AAAA,6EAAmD;AACnD,mEAAyC;AACzC,mEAAyC;AACzC,oEAA0C;AAC1C,iEAAuC;AACvC,wDAA8B;AAC9B,sDAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/json-api-nestjs/src/index.ts"],"names":[],"mappings":";;;AAAA,4EAAkD;AAClD,kEAAwC;AACxC,kEAAwC;AACxC,mEAAyC;AACzC,gEAAsC;AACtC,wDAA8B;AAC9B,sDAA4B"}

package/src/lib/internal/queryFilterPreprocessor.js

@@ -1,4 +1,6 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.queryFilterPreprocessor = queryFilterPreprocessor;
 /**
  * NestJS-specific query processing based on the output of `ctx.switchToHttp().getRequest().query`.
  *
@@ -12,8 +14,6 @@
  * 5. For `?filter[age][gt]=5&filter[age]=10&filter[age]=20`, `value` is `{'0': '10', '1': '20', gt:
  *    '5'}`, which we transform to `{eq: "10,20", gt: "5"}`.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.queryFilterPreprocessor = queryFilterPreprocessor;
 function queryFilterPreprocessor(value) {
     if (!isObject(value)) {
         // Cases 1 and 2.

package/src/lib/internal/queryFilterPreprocessor.js.map

@@ -1 +1 @@
-{"version":3,"file":"queryFilterPreprocessor.js","sourceRoot":"","sources":["../../../../../../packages/json-api-nestjs/src/lib/internal/queryFilterPreprocessor.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;AAEH,0DAwBC;AAxBD,SAAgB,uBAAuB,CAAC,KAAc;IACpD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,iBAAiB;QACjB,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC/B,CAAC;IAED,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAyB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACnF,MAAM,SAAS,GAAG,OAAO,KAAK,KAAK,SAAS,CAAC;QAC7C,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS,EAAE,CAAC;YACnC,iBAAiB;YACjB,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3C,OAAO;gBACL,GAAG,MAAM;gBACT,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE;aAChD,CAAC;QACJ,CAAC;QAED,+CAA+C;QAC/C,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3E,OAAO;YACL,GAAG,MAAM;YACT,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,WAAW;SACnE,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,uDAAuD;IACvD,OAAO,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AACpD,CAAC"}
+{"version":3,"file":"queryFilterPreprocessor.js","sourceRoot":"","sources":["../../../../../../packages/json-api-nestjs/src/lib/internal/queryFilterPreprocessor.ts"],"names":[],"mappings":";;AAaA,0DAwBC;AArCD;;;;;;;;;;;;GAYG;AACH,SAAgB,uBAAuB,CAAC,KAAc;IACpD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,iBAAiB;QACjB,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC/B,CAAC;IAED,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAyB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACnF,MAAM,SAAS,GAAG,OAAO,KAAK,KAAK,SAAS,CAAC;QAC7C,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS,EAAE,CAAC;YACnC,iBAAiB;YACjB,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3C,OAAO;gBACL,GAAG,MAAM;gBACT,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE;aAChD,CAAC;QACJ,CAAC;QAED,+CAA+C;QAC/C,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3E,OAAO;YACL,GAAG,MAAM;YACT,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,WAAW;SACnE,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,uDAAuD;IACvD,OAAO,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AACpD,CAAC"}

package/src/lib/query/{createCursorPagination.d.ts → cursorPaginationQuery.d.ts}

@@ -1,16 +1,24 @@
 import { z } from "zod";
+export declare const PAGINATION: {
+    readonly size: {
+        readonly maximum: 200;
+        readonly default: 20;
+    };
+};
 /**
  * Creates a Zod schema for JSON:API cursor pagination.
  *
- * @includeExample ./packages/json-api-nestjs/examples/query.ts
+ * @includeExample ./packages/example-nestjs/examples/query.ts
  *
- * @see [Usage example](../../../examples/query.ts)
+ * @see [Usage example](../../../../example-nestjs/examples/query.ts)
  * @see {@link https://jsonapi.org/format/#fetching-pagination JSON:API pagination}
  * @see {@link https://jsonapi.org/examples/#pagination JSON:API pagination examples}
  */
-export declare function createCursorPagination(parameters?: Readonly<{
-    maximumSize?: number;
-    defaultSize?: number;
+export declare function cursorPaginationQuery(parameters?: Readonly<{
+    size: {
+        maximum?: number;
+        default?: number;
+    };
 }>): {
     page: z.ZodDefault<z.ZodObject<{
         size: z.ZodDefault<z.ZodNumber>;

package/src/lib/query/{createCursorPagination.js → cursorPaginationQuery.js}

@@ -1,27 +1,35 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createCursorPagination = createCursorPagination;
+exports.PAGINATION = void 0;
+exports.cursorPaginationQuery = cursorPaginationQuery;
 const zod_1 = require("zod");
 const schemas_1 = require("../schemas");
+exports.PAGINATION = {
+    size: {
+        maximum: 200,
+        default: 20,
+    },
+};
 /**
  * Creates a Zod schema for JSON:API cursor pagination.
  *
- * @includeExample ./packages/json-api-nestjs/examples/query.ts
+ * @includeExample ./packages/example-nestjs/examples/query.ts
  *
- * @see [Usage example](../../../examples/query.ts)
+ * @see [Usage example](../../../../example-nestjs/examples/query.ts)
  * @see {@link https://jsonapi.org/format/#fetching-pagination JSON:API pagination}
  * @see {@link https://jsonapi.org/examples/#pagination JSON:API pagination examples}
  */
-function createCursorPagination(parameters) {
-    const { maximumSize = 200, defaultSize = 20 } = parameters ?? {};
+function cursorPaginationQuery(parameters) {
+    const { size } = exports.PAGINATION;
+    const { maximum = size.maximum, default: defaultSize = size.default } = parameters?.size ?? {};
     return {
         page: zod_1.z
             .object({
-            size: zod_1.z.coerce.number().int().positive().max(maximumSize).default(defaultSize),
+            size: zod_1.z.coerce.number().int().positive().max(maximum).default(defaultSize),
             cursor: schemas_1.nonEmptyString.optional(),
         })
             .strict()
             .default({ size: defaultSize }),
     };
 }
-//# sourceMappingURL=createCursorPagination.js.map
+//# sourceMappingURL=cursorPaginationQuery.js.map

package/src/lib/query/cursorPaginationQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursorPaginationQuery.js","sourceRoot":"","sources":["../../../../../../packages/json-api-nestjs/src/lib/query/cursorPaginationQuery.ts"],"names":[],"mappings":";;;AAoBA,sDAeC;AAnCD,6BAAwB;AAExB,wCAA4C;AAE/B,QAAA,UAAU,GAAG;IACxB,IAAI,EAAE;QACJ,OAAO,EAAE,GAAG;QACZ,OAAO,EAAE,EAAE;KACZ;CACO,CAAC;AAEX;;;;;;;;GAQG;AACH,SAAgB,qBAAqB,CACnC,UAAuE;IAEvE,MAAM,EAAE,IAAI,EAAE,GAAG,kBAAU,CAAC;IAC5B,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC;IAE/F,OAAO;QACL,IAAI,EAAE,OAAC;aACJ,MAAM,CAAC;YACN,IAAI,EAAE,OAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;YAC1E,MAAM,EAAE,wBAAc,CAAC,QAAQ,EAAE;SAClC,CAAC;aACD,MAAM,EAAE;aACR,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;KAClC,CAAC;AACJ,CAAC"}

package/src/lib/query/{createFields.d.ts → fieldsQuery.d.ts}

@@ -1,17 +1,23 @@
 import { z } from "zod";
-import { type ApiType, type Field } from "../types";
+import { type ApiType, type Data, type Field, type JsonApiDocument } from "../types";
 export type FieldsMap = Record<ApiType, readonly [Field, ...Field[]]>;
 export type FieldsSchema<MapT extends FieldsMap> = {
     [K in keyof MapT]: z.ZodEffects<z.ZodOptional<z.ZodArray<z.ZodEnum<z.Writeable<MapT[K]>>>>, Array<MapT[K][number]> | undefined, unknown>;
 };
+/**
+ * JSON:API attribute fields for use in fields queries.
+ *
+ * @template DocumentT - The JSON:API document.
+ */
+export type AttributeFields<DocumentT extends JsonApiDocument> = DocumentT["data"] extends Array<infer R extends Data> ? keyof R["attributes"] : DocumentT["data"] extends Data ? keyof DocumentT["data"]["attributes"] : never;
 /**
  * Creates a Zod schema for JSON:API sparse fieldsets.
  *
- * @includeExample ./packages/json-api-nestjs/examples/query.ts
+ * @includeExample ./packages/example-nestjs/examples/query.ts
  *
- * @see [Usage example](../../../examples/query.ts)
+ * @see [Usage example](../../../../example-nestjs/examples/query.ts)
  * @see {@link https://jsonapi.org/format/#fetching-sparse-fieldsets JSON:API sparse fieldsets}
  */
-export declare function createFields<const MapT extends FieldsMap>(parameters: Readonly<MapT>): {
+export declare function fieldsQuery<const MapT extends FieldsMap>(parameters: Readonly<MapT>): {
     fields: z.ZodOptional<z.ZodObject<FieldsSchema<MapT>, "strict", z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<FieldsSchema<MapT>>, any> extends infer T ? { [k in keyof T]: z.objectUtil.addQuestionMarks<z.baseObjectOutputType<FieldsSchema<MapT>>, any>[k]; } : never, z.baseObjectInputType<FieldsSchema<MapT>> extends infer T_1 ? { [k_1 in keyof T_1]: z.baseObjectInputType<FieldsSchema<MapT>>[k_1]; } : never>>;
 };

package/src/lib/query/{createFields.js → fieldsQuery.js}

@@ -1,23 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createFields = createFields;
+exports.fieldsQuery = fieldsQuery;
 const zod_1 = require("zod");
 const splitString_1 = require("../internal/splitString");
 /**
  * Creates a Zod schema for JSON:API sparse fieldsets.
  *
- * @includeExample ./packages/json-api-nestjs/examples/query.ts
+ * @includeExample ./packages/example-nestjs/examples/query.ts
  *
- * @see [Usage example](../../../examples/query.ts)
+ * @see [Usage example](../../../../example-nestjs/examples/query.ts)
  * @see {@link https://jsonapi.org/format/#fetching-sparse-fieldsets JSON:API sparse fieldsets}
  */
-function createFields(parameters) {
+function fieldsQuery(parameters) {
     const fieldSchemas = Object.fromEntries(Object.entries(parameters).map(([apiType, fields]) => [
         apiType,
-        zod_1.z.preprocess(splitString_1.splitString, zod_1.z.array(zod_1.z.enum(fields)).min(1).optional()),
+        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=createFields.js.map
+//# sourceMappingURL=fieldsQuery.js.map

package/src/lib/query/fieldsQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldsQuery.js","sourceRoot":"","sources":["../../../../../../packages/json-api-nestjs/src/lib/query/fieldsQuery.ts"],"names":[],"mappings":";;AAmCA,kCAYC;AA/CD,6BAAwB;AAExB,yDAAsD;AAyBtD;;;;;;;GAOG;AACH,SAAgB,WAAW,CAA+B,UAA0B;IAClF,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW,CACrC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAiC,EAAE,EAAE,CAAC;QACpF,OAAO;QACP,OAAC,CAAC,UAAU,CAAC,yBAAW,EAAE,OAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;KAC7E,CAAC,CAEmB,CAAC;IAExB,OAAO;QACL,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACnD,CAAC;AACJ,CAAC"}

package/src/lib/query/{createFilter.d.ts → filterQuery.d.ts}

@@ -7,18 +7,18 @@ export type FilterMap = Record<ApiType, {
 }>;
 export type FilterSchema<MapT extends FilterMap> = {
     [K in keyof MapT]: z.ZodOptional<z.ZodEffects<z.ZodOptional<z.ZodObject<{
-        [F in MapT[K]["filters"][number]]: z.ZodOptional<z.ZodEffects<z.ZodOptional<z.ZodArray<MapT[K]["schema"]>>>>;
+        [F in MapT[K]["filters"][number]]: z.ZodOptional<z.ZodEffects<z.ZodOptional<z.ZodReadonly<z.ZodArray<MapT[K]["schema"]>>>>>;
     }>>>>;
 };
 /**
  * Creates a Zod schema for JSON:API filters.
  *
- * @includeExample ./packages/json-api-nestjs/examples/query.ts
+ * @includeExample ./packages/example-nestjs/examples/query.ts
  *
- * @see [Usage example](../../../examples/query.ts)
+ * @see [Usage example](../../../../example-nestjs/examples/query.ts)
  * @see {@link https://jsonapi.org/recommendations/#filtering JSON:API filtering}
  * @see {@link https://discuss.jsonapi.org/t/share-propose-a-filtering-strategy/257 JSON:API filtering strategy}
  */
-export declare function createFilter<const MapT extends FilterMap>(parameters: Readonly<MapT>): {
+export declare function filterQuery<const MapT extends FilterMap>(parameters: Readonly<MapT>): {
     filter: z.ZodOptional<z.ZodObject<FilterSchema<MapT>, "strict", z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<FilterSchema<MapT>>, any> extends infer T ? { [k in keyof T]: z.objectUtil.addQuestionMarks<z.baseObjectOutputType<FilterSchema<MapT>>, any>[k]; } : never, z.baseObjectInputType<FilterSchema<MapT>> extends infer T_1 ? { [k_1 in keyof T_1]: z.baseObjectInputType<FilterSchema<MapT>>[k_1]; } : never>>;
 };

package/src/lib/query/{createFilter.js → filterQuery.js}

@@ -1,19 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createFilter = createFilter;
+exports.filterQuery = filterQuery;
 const zod_1 = require("zod");
 const queryFilterPreprocessor_1 = require("../internal/queryFilterPreprocessor");
 const splitString_1 = require("../internal/splitString");
 /**
  * Creates a Zod schema for JSON:API filters.
  *
- * @includeExample ./packages/json-api-nestjs/examples/query.ts
+ * @includeExample ./packages/example-nestjs/examples/query.ts
  *
- * @see [Usage example](../../../examples/query.ts)
+ * @see [Usage example](../../../../example-nestjs/examples/query.ts)
  * @see {@link https://jsonapi.org/recommendations/#filtering JSON:API filtering}
  * @see {@link https://discuss.jsonapi.org/t/share-propose-a-filtering-strategy/257 JSON:API filtering strategy}
  */
-function createFilter(parameters) {
+function filterQuery(parameters) {
     return {
         filter: zod_1.z
             .object(Object.fromEntries(Object.entries(parameters).map(([apiType, { filters, schema }]) => [
@@ -22,7 +22,9 @@ function createFilter(parameters) {
                 .preprocess(queryFilterPreprocessor_1.queryFilterPreprocessor, zod_1.z
                 .object(Object.fromEntries(filters.map((filter) => [
                 filter,
-                zod_1.z.preprocess(splitString_1.splitString, zod_1.z.array(schema).optional()).optional(),
+                zod_1.z
+                    .preprocess(splitString_1.splitString, schema.array().min(1).max(10_000).readonly().optional())
+                    .optional(),
             ])))
                 .strict()
                 .optional())
@@ -32,4 +34,4 @@ function createFilter(parameters) {
             .optional(),
     };
 }
-//# sourceMappingURL=createFilter.js.map
+//# sourceMappingURL=filterQuery.js.map

package/src/lib/query/filterQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterQuery.js","sourceRoot":"","sources":["../../../../../../packages/json-api-nestjs/src/lib/query/filterQuery.ts"],"names":[],"mappings":";;AAuCA,kCAqCC;AA5ED,6BAAwB;AAExB,iFAA8E;AAC9E,yDAAsD;AA2BtD;;;;;;;;GAQG;AACH,SAAgB,WAAW,CAA+B,UAA0B;IAClF,OAAO;QACL,MAAM,EAAE,OAAC;aACN,MAAM,CACL,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAC5B,CAAC,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAiC,EAAE,EAAE,CAAC;YAClE,OAAO;YACP,OAAC;iBACE,UAAU,CACT,iDAAuB,EACvB,OAAC;iBACE,MAAM,CACL,MAAM,CAAC,WAAW,CAChB,OAAO,CAAC,GAAG,CAAC,CAAC,MAAc,EAAE,EAAE,CAAC;gBAC9B,MAAM;gBACN,OAAC;qBACE,UAAU,CACT,yBAAW,EACX,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CACxD;qBACA,QAAQ,EAAE;aACd,CAAC,CACH,CACF;iBACA,MAAM,EAAE;iBACR,QAAQ,EAAE,CACd;iBACA,QAAQ,EAAE;SACd,CACF,CAEoB,CACxB;aACA,MAAM,EAAE;aACR,QAAQ,EAAE;KACd,CAAC;AACJ,CAAC"}

package/src/lib/query/includeQuery.d.ts

@@ -0,0 +1,31 @@
+import { type GreaterThan, type Subtract } from "type-fest";
+import { z } from "zod";
+import { type JsonApiDocument, type Relationship } from "../types";
+/**
+ * JSON:API relationship paths for use in include queries.
+ *
+ * @template MapT - A map of ApiType to Zod schemas.
+ * @template DocumentT - The JSON:API document.
+ * @template RecursiveDepth - The maximum depth for recursive relationship traversal.
+ * @template Prefix - The prefix for nested relationship paths.
+ */
+export type RelationshipPaths<MapT extends Record<string, z.ZodTypeAny>, DocumentT extends JsonApiDocument, RecursiveDepth extends number = 5, Prefix extends string = ""> = RecursiveDepth extends infer Depth extends number ? GreaterThan<Depth, 0> extends true ? DocumentT["data"] extends Array<infer SingleOrArray> | infer SingleOrArray ? SingleOrArray extends {
+    relationships?: infer R;
+} ? R extends Record<string, Relationship> ? {
+    [K in keyof R]: K extends string ? R[K]["data"] extends {
+        type?: infer RelationT;
+    } | Array<{
+        type?: infer RelationT;
+    }> ? RelationT extends keyof MapT ? `${Prefix}${K}` | RelationshipPaths<MapT, z.infer<MapT[RelationT]>, Subtract<Depth, 1>, `${Prefix}${K}.`> : never : never : never;
+}[keyof R] : never : never : never : never : never;
+/**
+ * Creates a Zod schema for JSON:API include parameters.
+ *
+ * @includeExample ./packages/example-nestjs/examples/query.ts
+ *
+ * @see [Usage example](../../../../example-nestjs/examples/query.ts)
+ * @see {@link https://jsonapi.org/format/#fetching-includes JSON:API includes}
+ */
+export declare function includeQuery<const FieldT extends readonly string[]>(fields: FieldT): {
+    include: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodOptional<z.ZodArray<z.ZodString, "many">>, string[] | undefined, unknown>, string[] | undefined, unknown>, FieldT[number][] | undefined, unknown>;
+};

package/src/lib/query/{createInclude.js → includeQuery.js}

@@ -1,21 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createInclude = createInclude;
+exports.includeQuery = includeQuery;
 const zod_1 = require("zod");
 const splitString_1 = require("../internal/splitString");
 /**
  * Creates a Zod schema for JSON:API include parameters.
  *
- * @param fields An array of valid include fields.
- * @returns A Zod schema for the include parameter.
+ * @includeExample ./packages/example-nestjs/examples/query.ts
  *
+ * @see [Usage example](../../../../example-nestjs/examples/query.ts)
  * @see {@link https://jsonapi.org/format/#fetching-includes JSON:API includes}
  */
-function createInclude(fields) {
+function includeQuery(fields) {
     const fieldSet = new Set(fields);
     return {
         include: zod_1.z
-            .preprocess(splitString_1.splitString, zod_1.z.array(zod_1.z.string()).optional())
+            .preprocess(splitString_1.splitString, zod_1.z.string().array().min(1).max(100).optional())
             .superRefine((value, context) => {
             if (!value) {
                 return;
@@ -33,4 +33,4 @@ function createInclude(fields) {
             .transform((value) => value),
     };
 }
-//# sourceMappingURL=createInclude.js.map
+//# sourceMappingURL=includeQuery.js.map

package/src/lib/query/includeQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"includeQuery.js","sourceRoot":"","sources":["../../../../../../packages/json-api-nestjs/src/lib/query/includeQuery.ts"],"names":[],"mappings":";;AAwDA,oCAuBC;AA9ED,6BAAwB;AAExB,yDAAsD;AA6CtD;;;;;;;GAOG;AACH,SAAgB,YAAY,CAAyC,MAAc;IACjF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IAEjC,OAAO;QACL,OAAO,EAAE,OAAC;aACP,UAAU,CAAC,yBAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;aACtE,WAAW,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAC9B,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO;YACT,CAAC;YAED,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;gBAC1B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;oBACzB,OAAO,CAAC,QAAQ,CAAC;wBACf,IAAI,EAAE,OAAC,CAAC,YAAY,CAAC,MAAM;wBAC3B,OAAO,EAAE,2BAA2B,KAAK,GAAG;wBAC5C,IAAI,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC;qBACzB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC,CAAC;aACD,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAA0C,CAAC;KACpE,CAAC;AACJ,CAAC"}

package/src/lib/query/{createSort.d.ts → sortQuery.d.ts}

@@ -3,11 +3,11 @@ import { type Field } from "../types";
 /**
  * Creates a Zod schema for JSON:API sort parameters.
  *
- * @includeExample ./packages/json-api-nestjs/examples/query.ts
+ * @includeExample ./packages/example-nestjs/examples/query.ts
  *
- * @see [Usage example](../../../examples/query.ts)
+ * @see [Usage example](../../../../example-nestjs/examples/query.ts)
  * @see {@link https://jsonapi.org/format/#fetching-sorting JSON:API sorting}
  */
-export declare function createSort<const FieldT extends readonly [Field, ...Field[]]>(fields: FieldT): {
+export declare function sortQuery<const FieldT extends readonly [Field, ...Field[]]>(fields: FieldT): {
     sort: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodOptional<z.ZodArray<z.ZodString, "many">>, string[] | undefined, unknown>, string[] | undefined, unknown>, (FieldT[number] | `-${FieldT[number]}`)[] | undefined, unknown>;
 };

package/src/lib/query/{createSort.js → sortQuery.js}

@@ -1,21 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createSort = createSort;
+exports.sortQuery = sortQuery;
 const zod_1 = require("zod");
 const splitString_1 = require("../internal/splitString");
 /**
  * Creates a Zod schema for JSON:API sort parameters.
  *
- * @includeExample ./packages/json-api-nestjs/examples/query.ts
+ * @includeExample ./packages/example-nestjs/examples/query.ts
  *
- * @see [Usage example](../../../examples/query.ts)
+ * @see [Usage example](../../../../example-nestjs/examples/query.ts)
  * @see {@link https://jsonapi.org/format/#fetching-sorting JSON:API sorting}
  */
-function createSort(fields) {
+function sortQuery(fields) {
     const fieldSet = new Set(fields);
     return {
         sort: zod_1.z
-            .preprocess(splitString_1.splitString, zod_1.z.array(zod_1.z.string()).optional())
+            .preprocess(splitString_1.splitString, zod_1.z.string().array().min(1).max(100).optional())
             .superRefine((value, context) => {
             if (!value) {
                 return;
@@ -33,4 +33,4 @@ function createSort(fields) {
             .transform((value) => value),
     };
 }
-//# sourceMappingURL=createSort.js.map
+//# sourceMappingURL=sortQuery.js.map

package/src/lib/query/sortQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortQuery.js","sourceRoot":"","sources":["../../../../../../packages/json-api-nestjs/src/lib/query/sortQuery.ts"],"names":[],"mappings":";;AAaA,8BAsBC;AAnCD,6BAAwB;AAExB,yDAAsD;AAGtD;;;;;;;GAOG;AACH,SAAgB,SAAS,CAAoD,MAAc;IACzF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO;QACL,IAAI,EAAE,OAAC;aACJ,UAAU,CAAC,yBAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;aACtE,WAAW,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAC9B,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO;YACT,CAAC;YAED,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;gBAC1B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;oBAClE,OAAO,CAAC,QAAQ,CAAC;wBACf,IAAI,EAAE,OAAC,CAAC,YAAY,CAAC,MAAM;wBAC3B,OAAO,EAAE,wBAAwB,KAAK,GAAG;wBACzC,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;qBACtB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC,CAAC;aACD,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAiE,CAAC;KAC3F,CAAC;AACJ,CAAC"}

package/src/lib/schemas.d.ts

@@ -6,5 +6,9 @@ export declare const nonEmptyString: z.ZodString;
 /**
  * A Zod schema for use with boolean query parameters since `z.coerce.boolean()` treats any truthy
  * value as `true`.
+ *
+ * `.transform((value) => value === "true")` causes inference issues in controllers.
  */
-export declare const booleanString: z.ZodEffects<z.ZodEnum<["true", "false"]>, boolean, "true" | "false">;
+export declare const booleanString: z.ZodEnum<["true", "false"]>;
+export type BooleanString = z.infer<typeof booleanString>;
+export declare function toBoolean(value: BooleanString): boolean;

package/src/lib/schemas.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.booleanString = exports.nonEmptyString = void 0;
+exports.toBoolean = toBoolean;
 const zod_1 = require("zod");
 /**
  * A non-empty string Zod schema.
@@ -9,6 +10,11 @@ exports.nonEmptyString = zod_1.z.string().min(1);
 /**
  * A Zod schema for use with boolean query parameters since `z.coerce.boolean()` treats any truthy
  * value as `true`.
+ *
+ * `.transform((value) => value === "true")` causes inference issues in controllers.
  */
-exports.booleanString = zod_1.z.enum(["true", "false"]).transform((value) => value === "true");
+exports.booleanString = zod_1.z.enum(["true", "false"]);
+function toBoolean(value) {
+    return value === "true";
+}
 //# sourceMappingURL=schemas.js.map

package/src/lib/schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../../../packages/json-api-nestjs/src/lib/schemas.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB;;GAEG;AACU,QAAA,cAAc,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAEhD;;;GAGG;AACU,QAAA,aAAa,GAAG,OAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC"}
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../../../packages/json-api-nestjs/src/lib/schemas.ts"],"names":[],"mappings":";;;AAiBA,8BAEC;AAnBD,6BAAwB;AAExB;;GAEG;AACU,QAAA,cAAc,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAEhD;;;;;GAKG;AACU,QAAA,aAAa,GAAG,OAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAIvD,SAAgB,SAAS,CAAC,KAAoB;IAC5C,OAAO,KAAK,KAAK,MAAM,CAAC;AAC1B,CAAC"}

package/src/lib/types.d.ts

@@ -1,2 +1,36 @@
+import { type Arrayable } from "type-fest";
 export type ApiType = string;
 export type Field = string;
+export type Meta = Record<string, unknown>;
+export type ApiLinks = Record<string, string | undefined>;
+export interface Relationship {
+    data?: Arrayable<{
+        id?: string;
+        type?: ApiType;
+    }>;
+    links?: ApiLinks;
+    meta?: Meta;
+}
+export interface Data {
+    attributes?: Record<string, unknown>;
+    id?: string;
+    links?: ApiLinks;
+    meta?: Meta;
+    relationships?: Record<string, Relationship>;
+    type?: ApiType;
+}
+/**
+ * The JSON:API document shape.
+ */
+export interface JsonApiDocument {
+    data?: Arrayable<Data>;
+    included?: Data[];
+    jsonapi?: {
+        ext?: Record<string, unknown>;
+        meta?: Meta;
+        profile?: string;
+        version?: string;
+    };
+    links?: ApiLinks;
+    meta?: Meta;
+}

package/src/test/index.d.ts

@@ -1,4 +1,3 @@
 import { type SafeParseError, type SafeParseReturnType, type SafeParseSuccess } from "zod";
-export declare function expectToBeDefined<T>(value: T | undefined): asserts value is T;
 export declare function expectToBeSuccess<Input, Output>(value: Readonly<SafeParseReturnType<Input, Output>>): asserts value is SafeParseSuccess<Output>;
 export declare function expectToBeError<Input, Output>(value: Readonly<SafeParseReturnType<Input, Output>>): asserts value is SafeParseError<Input>;

package/src/test/index.js

@@ -1,6 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.expectToBeDefined = expectToBeDefined;
 exports.expectToBeSuccess = expectToBeSuccess;
 exports.expectToBeError = expectToBeError;
 const node_assert_1 = require("node:assert");

package/src/test/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/json-api-nestjs/src/test/index.ts"],"names":[],"mappings":";;AAeA,8CAEC;AAED,8CAKC;AAED,0CAKC;AA/BD,6CAAiC;AAOjC,SAAS,iBAAiB,CAAI,KAA0B;IACtD,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;AAC/C,CAAC;AAED,SAAS,SAAS,CAAI,KAA0B;IAC9C,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED,SAAgB,iBAAiB,CAAI,KAAoB;IACvD,IAAA,gBAAE,EAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,SAAgB,iBAAiB,CAC/B,KAAmD;IAEnD,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACzB,IAAA,gBAAE,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AACpB,CAAC;AAED,SAAgB,eAAe,CAC7B,KAAmD;IAEnD,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACzB,IAAA,gBAAE,EAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/json-api-nestjs/src/test/index.ts"],"names":[],"mappings":";;AAmBA,8CAKC;AAED,0CAKC;AA/BD,6CAAiC;AAOjC,SAAS,iBAAiB,CAAI,KAA0B;IACtD,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;AAC/C,CAAC;AAED,SAAS,SAAS,CAAI,KAA0B;IAC9C,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,iBAAiB,CAAI,KAAoB;IAChD,IAAA,gBAAE,EAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,SAAgB,iBAAiB,CAC/B,KAAmD;IAEnD,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACzB,IAAA,gBAAE,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AACpB,CAAC;AAED,SAAgB,eAAe,CAC7B,KAAmD;IAEnD,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACzB,IAAA,gBAAE,EAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC"}

package/src/lib/query/createCursorPagination.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"createCursorPagination.js","sourceRoot":"","sources":["../../../../../../packages/json-api-nestjs/src/lib/query/createCursorPagination.ts"],"names":[],"mappings":";;AAaA,wDAcC;AA3BD,6BAAwB;AAExB,wCAA4C;AAE5C;;;;;;;;GAQG;AACH,SAAgB,sBAAsB,CACpC,UAAqE;IAErE,MAAM,EAAE,WAAW,GAAG,GAAG,EAAE,WAAW,GAAG,EAAE,EAAE,GAAG,UAAU,IAAI,EAAE,CAAC;IAEjE,OAAO;QACL,IAAI,EAAE,OAAC;aACJ,MAAM,CAAC;YACN,IAAI,EAAE,OAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;YAC9E,MAAM,EAAE,wBAAc,CAAC,QAAQ,EAAE;SAClC,CAAC;aACD,MAAM,EAAE;aACR,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;KAClC,CAAC;AACJ,CAAC"}

package/src/lib/query/createFields.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"createFields.js","sourceRoot":"","sources":["../../../../../../packages/json-api-nestjs/src/lib/query/createFields.ts"],"names":[],"mappings":";;AAuBA,oCAYC;AAnCD,6BAAwB;AAExB,yDAAsD;AAatD;;;;;;;GAOG;AACH,SAAgB,YAAY,CAA+B,UAA0B;IACnF,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW,CACrC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAiC,EAAE,EAAE,CAAC;QACpF,OAAO;QACP,OAAC,CAAC,UAAU,CAAC,yBAAW,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;KACrE,CAAC,CAEmB,CAAC;IAExB,OAAO;QACL,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACnD,CAAC;AACJ,CAAC"}

package/src/lib/query/createFilter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"createFilter.js","sourceRoot":"","sources":["../../../../../../packages/json-api-nestjs/src/lib/query/createFilter.ts"],"names":[],"mappings":";;AAuCA,oCAgCC;AAvED,6BAAwB;AAExB,iFAA8E;AAC9E,yDAAsD;AA2BtD;;;;;;;;GAQG;AACH,SAAgB,YAAY,CAA+B,UAA0B;IACnF,OAAO;QACL,MAAM,EAAE,OAAC;aACN,MAAM,CACL,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAC5B,CAAC,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAiC,EAAE,EAAE,CAAC;YAClE,OAAO;YACP,OAAC;iBACE,UAAU,CACT,iDAAuB,EACvB,OAAC;iBACE,MAAM,CACL,MAAM,CAAC,WAAW,CAChB,OAAO,CAAC,GAAG,CAAC,CAAC,MAAc,EAAE,EAAE,CAAC;gBAC9B,MAAM;gBACN,OAAC,CAAC,UAAU,CAAC,yBAAW,EAAE,OAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE;aACjE,CAAC,CACH,CACF;iBACA,MAAM,EAAE;iBACR,QAAQ,EAAE,CACd;iBACA,QAAQ,EAAE;SACd,CACF,CAEoB,CACxB;aACA,MAAM,EAAE;aACR,QAAQ,EAAE;KACd,CAAC;AACJ,CAAC"}

package/src/lib/query/createInclude.d.ts

@@ -1,12 +0,0 @@
-import { z } from "zod";
-/**
- * Creates a Zod schema for JSON:API include parameters.
- *
- * @param fields An array of valid include fields.
- * @returns A Zod schema for the include parameter.
- *
- * @see {@link https://jsonapi.org/format/#fetching-includes JSON:API includes}
- */
-export declare function createInclude<const FieldT extends readonly string[]>(fields: FieldT): {
-    include: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodOptional<z.ZodArray<z.ZodString, "many">>, string[] | undefined, unknown>, string[] | undefined, unknown>, FieldT[number][] | undefined, unknown>;
-};

package/src/lib/query/createInclude.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"createInclude.js","sourceRoot":"","sources":["../../../../../../packages/json-api-nestjs/src/lib/query/createInclude.ts"],"names":[],"mappings":";;AAYA,sCAuBC;AAnCD,6BAAwB;AAExB,yDAAsD;AAEtD;;;;;;;GAOG;AACH,SAAgB,aAAa,CAAyC,MAAc;IAClF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IAEjC,OAAO;QACL,OAAO,EAAE,OAAC;aACP,UAAU,CAAC,yBAAW,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;aACvD,WAAW,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAC9B,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO;YACT,CAAC;YAED,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;gBAC1B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;oBACzB,OAAO,CAAC,QAAQ,CAAC;wBACf,IAAI,EAAE,OAAC,CAAC,YAAY,CAAC,MAAM;wBAC3B,OAAO,EAAE,2BAA2B,KAAK,GAAG;wBAC5C,IAAI,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC;qBACzB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC,CAAC;aACD,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAA0C,CAAC;KACpE,CAAC;AACJ,CAAC"}

package/src/lib/query/createSort.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"createSort.js","sourceRoot":"","sources":["../../../../../../packages/json-api-nestjs/src/lib/query/createSort.ts"],"names":[],"mappings":";;AAaA,gCAsBC;AAnCD,6BAAwB;AAExB,yDAAsD;AAGtD;;;;;;;GAOG;AACH,SAAgB,UAAU,CAAoD,MAAc;IAC1F,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO;QACL,IAAI,EAAE,OAAC;aACJ,UAAU,CAAC,yBAAW,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;aACvD,WAAW,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAC9B,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO;YACT,CAAC;YAED,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;gBAC1B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;oBAClE,OAAO,CAAC,QAAQ,CAAC;wBACf,IAAI,EAAE,OAAC,CAAC,YAAY,CAAC,MAAM;wBAC3B,OAAO,EAAE,wBAAwB,KAAK,GAAG;wBACzC,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;qBACtB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC,CAAC;aACD,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAiE,CAAC;KAC3F,CAAC;AACJ,CAAC"}