@trishchuk/nestjs-query-core 0.0.0-stage → 9.5.0

package/README.md

@@ -1,3 +1,22 @@
-# Temporary Holding Version
+<p align="center">
+  <a href="https://tripss.github.io/nestjs-query" target="blank"><img src="https://tripss.github.io/nestjs-query/img/logo.svg" width="120" alt="Nestjs-query Logo" /></a>
+</p>
+
+[![npm version](https://img.shields.io/npm/v/@ptc-org/nestjs-query-core.svg)](https://www.npmjs.org/package/@ptc-org/nestjs-query-core)
+[![Test](https://github.com/tripss/nestjs-query/workflows/Test/badge.svg?branch=master)](https://github.com/tripss/nestjs-query/actions?query=workflow%3ATest+and+branch%3Amaster+)
+[![Coverage Status](https://codecov.io/gh/TriPSs/nestjs-query/branch/master/graph/badge.svg?token=29EX71ID2P)](https://codecov.io/gh/TriPSs/nestjs-query)
+[![Known Vulnerabilities](https://snyk.io/test/github/tripss/nestjs-query/badge.svg?targetFile=packages/core/package.json)](https://snyk.io/test/github/tripss/nestjs-query?targetFile=packages/core/package.json)
+
+# `@ptc-org/nestjs-query-core`
+
+Core package that contains interfaces for types used by [`@ptc-org/nestjs-query-graphql`](../query-graphql)
+and [`@ptc-org/nestjs-query-typeorm`](../query-typeorm)
+
+## Installation
+
+[Install Guide](https://tripss.github.io/nestjs-query/docs/introduction/install)
+
+## Docs
+
+* [Nestjs-query Docs](https://tripss.github.io/nestjs-query/docs/introduction/getting-started)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.

package/package.json

@@ -1,6 +1,43 @@
 {
   "name": "@trishchuk/nestjs-query-core",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "9.5.0",
+  "description": "Base query package",
+  "homepage": "https://github.com/x51xxx/nestjs-query#readme",
+  "bugs": {
+    "url": "https://github.com/x51xxx/nestjs-query/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/x51xxx/nestjs-query.git"
+  },
+  "license": "MIT",
+  "author": "doug-martin <doug@dougamartin.com>",
+  "main": "src/index.js",
+  "types": "src/index.d.ts",
+  "directories": {
+    "lib": "src",
+    "test": "__tests__"
+  },
+  "files": [
+    "src/**"
+  ],
+  "dependencies": {
+    "lodash.merge": "^4.6.2",
+    "reflect-metadata": "^0.2.2",
+    "tslib": "^2.8.1"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^9.0.0 || ^10.0.0 || ^11.0.0",
+    "class-transformer": "^0.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "yarn@4.13.0",
+  "resolutions": {
+    "@apollo/gateway": "2.14.1",
+    "@apollo/server": "^5.5.1",
+    "@apollo/subgraph": "2.14.1"
+  },
+  "type": "commonjs"
+}

package/src/assemblers/abstract.assembler.d.ts

@@ -0,0 +1,29 @@
+import { Class, DeepPartial } from '../common';
+import { AggregateQuery, AggregateResponse, Query } from '../interfaces';
+import { Assembler } from './assembler';
+/**
+ * Base implementation for Assemblers that requires the implementation of.
+ * * convertToDTO
+ * * convertToEntity
+ * * convertQuery
+ *
+ */
+export declare abstract class AbstractAssembler<DTO, Entity, C = DeepPartial<DTO>, CE = DeepPartial<Entity>, U = C, UE = CE> implements Assembler<DTO, Entity, C, CE, U, UE> {
+    readonly DTOClass: Class<DTO>;
+    readonly EntityClass: Class<Entity>;
+    /**
+     * @param DTOClass - Optional class definition for the DTO. If not provided it will be looked up from the \@Assembler annotation.
+     * @param EntityClass - Optional class definition for the entity. If not provided it will be looked up from the \@Assembler annotation.
+     */
+    constructor(DTOClass?: Class<DTO>, EntityClass?: Class<Entity>);
+    abstract convertToDTO(entity: Entity): Promise<DTO> | DTO;
+    abstract convertToEntity(dto: DTO): Promise<Entity> | Entity;
+    abstract convertQuery(query: Query<DTO>): Query<Entity>;
+    abstract convertAggregateQuery(aggregate: AggregateQuery<DTO>): AggregateQuery<Entity>;
+    abstract convertAggregateResponse(aggregate: AggregateResponse<Entity>): AggregateResponse<DTO>;
+    abstract convertToCreateEntity(create: C): Promise<CE> | CE;
+    abstract convertToUpdateEntity(update: U): Promise<UE> | UE;
+    convertToDTOs(entities: Entity[]): Promise<DTO[]>;
+    convertToEntities(dtos: DTO[]): Promise<Entity[]>;
+    convertToCreateEntities(createDtos: C[]): Promise<CE[]>;
+}

package/src/assemblers/abstract.assembler.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractAssembler = void 0;
+const assembler_1 = require("./assembler");
+/**
+ * Base implementation for Assemblers that requires the implementation of.
+ * * convertToDTO
+ * * convertToEntity
+ * * convertQuery
+ *
+ */
+class AbstractAssembler {
+    /**
+     * @param DTOClass - Optional class definition for the DTO. If not provided it will be looked up from the \@Assembler annotation.
+     * @param EntityClass - Optional class definition for the entity. If not provided it will be looked up from the \@Assembler annotation.
+     */
+    constructor(DTOClass, EntityClass) {
+        const classes = (0, assembler_1.getAssemblerClasses)(this.constructor);
+        const DTOClas = DTOClass ?? classes?.DTOClass;
+        const EntityClas = EntityClass ?? classes?.EntityClass;
+        if (!DTOClas || !EntityClas) {
+            // the DTO and entity classes were not provided and we didnt find them in the metadata storage.
+            throw new Error(`Unable to determine DTO or Entity types for ${this.constructor.name}. Did you annotate your assembler with @Assembler`);
+        }
+        this.DTOClass = DTOClas;
+        this.EntityClass = EntityClas;
+    }
+    convertToDTOs(entities) {
+        return Promise.all(entities.map((e) => this.convertToDTO(e)));
+    }
+    convertToEntities(dtos) {
+        return Promise.all(dtos.map((dto) => this.convertToEntity(dto)));
+    }
+    convertToCreateEntities(createDtos) {
+        return Promise.all(createDtos.map((c) => this.convertToCreateEntity(c)));
+    }
+}
+exports.AbstractAssembler = AbstractAssembler;
+//# sourceMappingURL=abstract.assembler.js.map

package/src/assemblers/abstract.assembler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.assembler.js","sourceRoot":"","sources":["../../../../../packages/core/src/assemblers/abstract.assembler.ts"],"names":[],"mappings":";;;AAEA,2CAA4D;AAE5D;;;;;;GAMG;AACH,MAAsB,iBAAiB;IAYrC;;;OAGG;IACH,YAAY,QAAqB,EAAE,WAA2B;QAC5D,MAAM,OAAO,GAAG,IAAA,+BAAmB,EAAC,IAAI,CAAC,WAA0D,CAAC,CAAA;QACpG,MAAM,OAAO,GAAG,QAAQ,IAAI,OAAO,EAAE,QAAQ,CAAA;QAC7C,MAAM,UAAU,GAAG,WAAW,IAAI,OAAO,EAAE,WAAW,CAAA;QACtD,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;YAC5B,+FAA+F;YAC/F,MAAM,IAAI,KAAK,CACb,+CAA+C,IAAI,CAAC,WAAW,CAAC,IAAI,mDAAmD,CACxH,CAAA;QACH,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAA;QACvB,IAAI,CAAC,WAAW,GAAG,UAAU,CAAA;IAC/B,CAAC;IAgBM,aAAa,CAAC,QAAkB;QACrC,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC/D,CAAC;IAEM,iBAAiB,CAAC,IAAW;QAClC,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IAClE,CAAC;IAEM,uBAAuB,CAAC,UAAe;QAC5C,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC1E,CAAC;CACF;AAvDD,8CAuDC"}

package/src/assemblers/assembler.d.ts

@@ -0,0 +1,66 @@
+import { Class, DeepPartial, MetaValue } from '../common';
+import { AggregateQuery, AggregateResponse, Query } from '../interfaces';
+export interface Assembler<DTO, Entity, CreateDTO = DeepPartial<DTO>, CreateEntity = DeepPartial<Entity>, UpdateDTO = CreateDTO, UpdateEntity = CreateEntity> {
+    /**
+     * Convert an entity to a DTO
+     * @param entity - the entity to convert
+     */
+    convertToDTO(entity: Entity): Promise<DTO> | DTO;
+    /**
+     * Convert a DTO to an entity.
+     * @param dto - The dto to convert.
+     */
+    convertToEntity(dto: DTO): Promise<Entity> | Entity;
+    /**
+     * Convert a DTO query to an entity query.
+     * @param query - the query to convert.
+     */
+    convertQuery(query: Query<DTO>): Query<Entity>;
+    /**
+     * Convert a DTO query to an entity query.
+     * @param aggregate - the aggregate query to convert.
+     */
+    convertAggregateQuery(aggregate: AggregateQuery<DTO>): AggregateQuery<Entity>;
+    /**
+     * Convert a Entity aggregate response query to an dto aggregate.
+     * @param aggregate - the aggregate query to convert.
+     */
+    convertAggregateResponse(aggregate: AggregateResponse<Entity>): AggregateResponse<DTO>;
+    /**
+     * Convert a create dto input to the equivalent create entity type
+     * @param createDTO
+     */
+    convertToCreateEntity(createDTO: CreateDTO): Promise<CreateEntity> | CreateEntity;
+    /**
+     * Convert a update dto input to the equivalent update entity type
+     * @param createDTO
+     */
+    convertToUpdateEntity(createDTO: UpdateDTO): Promise<UpdateEntity> | UpdateEntity;
+    /**
+     * Convert an array of entities to a an of DTOs
+     * @param entities - the entities to convert.
+     */
+    convertToDTOs(entities: Entity[]): Promise<DTO[]>;
+    /**
+     * Convert an array of DTOs to an array of entities.
+     * @param dtos - the dtos to convert.
+     */
+    convertToEntities(dtos: DTO[]): Promise<Entity[]>;
+    /**
+     * Convert an array of create DTOs to an array of create entities
+     * @param createDtos
+     */
+    convertToCreateEntities(createDtos: CreateDTO[]): Promise<CreateEntity[]>;
+}
+export interface AssemblerClasses<DTO, Entity> {
+    DTOClass: Class<DTO>;
+    EntityClass: Class<Entity>;
+}
+/**
+ * Class decorator for Assemblers to register them with nestjs-query
+ * @param DTOClass - the DTO class.
+ * @param EntityClass - The entity class.
+ */
+export declare function Assembler<DTO, Entity, C = DeepPartial<DTO>, CE = DeepPartial<Entity>, U = DeepPartial<DTO>, UE = DeepPartial<Entity>>(DTOClass: Class<DTO>, EntityClass: Class<Entity>): <Cls extends Class<Assembler<DTO, Entity, C, CE, U, UE>>>(cls: Cls) => Cls | void;
+export declare function getAssemblers<DTO>(DTOClass: Class<DTO>): MetaValue<Map<Class<unknown>, Class<Assembler<DTO, unknown, unknown, unknown, unknown, unknown>>>>;
+export declare function getAssemblerClasses<DTO, Entity, C, CE, U, UE>(AssemblerClass: Class<Assembler<DTO, Entity, C, CE, U, UE>>): MetaValue<AssemblerClasses<DTO, Entity>>;

package/src/assemblers/assembler.deserializer.d.ts

@@ -0,0 +1,4 @@
+import { Class, MetaValue } from '../common';
+export type AssemblerDeserializer<T> = (obj: object) => T;
+export declare function AssemblerDeserializer<T>(deserializer: AssemblerDeserializer<T>): <Cls extends Class<T>>(cls: Cls) => Cls | void;
+export declare function getAssemblerDeserializer<DTO>(DTOClass: Class<DTO>): MetaValue<AssemblerDeserializer<DTO>>;

package/src/assemblers/assembler.deserializer.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssemblerDeserializer = AssemblerDeserializer;
+exports.getAssemblerDeserializer = getAssemblerDeserializer;
+const common_1 = require("../common");
+const constants_1 = require("./constants");
+const reflector = new common_1.ValueReflector(constants_1.ASSEMBLER_DESERIALIZER_KEY);
+// eslint-disable-next-line @typescript-eslint/no-redeclare -- intentional
+function AssemblerDeserializer(deserializer) {
+    return (cls) => {
+        if (reflector.isDefined(cls)) {
+            throw new Error(`Assembler Deserializer already registered for ${cls.name}`);
+        }
+        reflector.set(cls, deserializer);
+        return cls;
+    };
+}
+function getAssemblerDeserializer(DTOClass) {
+    return reflector.get(DTOClass, true);
+}
+//# sourceMappingURL=assembler.deserializer.js.map

package/src/assemblers/assembler.deserializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembler.deserializer.js","sourceRoot":"","sources":["../../../../../packages/core/src/assemblers/assembler.deserializer.ts"],"names":[],"mappings":";;AAQA,sDAQC;AAED,4DAEC;AApBD,sCAA4D;AAC5D,2CAAwD;AAExD,MAAM,SAAS,GAAG,IAAI,uBAAc,CAAC,sCAA0B,CAAC,CAAA;AAIhE,0EAA0E;AAC1E,SAAgB,qBAAqB,CAAI,YAAsC;IAC7E,OAAO,CAAuB,GAAQ,EAAc,EAAE;QACpD,IAAI,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,iDAAiD,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;QAC9E,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;QAChC,OAAO,GAAG,CAAA;IACZ,CAAC,CAAA;AACH,CAAC;AAED,SAAgB,wBAAwB,CAAM,QAAoB;IAChE,OAAO,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;AACtC,CAAC"}

package/src/assemblers/assembler.factory.d.ts

@@ -0,0 +1,8 @@
+import { Class, DeepPartial } from '../common';
+import { Assembler } from './assembler';
+/**
+ * Assembler Service used by query services to look up Assemblers.
+ */
+export declare class AssemblerFactory {
+    static getAssembler<DTO, Entity extends DeepPartial<Entity>, C = DeepPartial<DTO>, CE = DeepPartial<Entity>, U = C, UE = CE>(DTOClass: Class<DTO>, EntityClass: Class<Entity>): Assembler<DTO, Entity, C, CE, U, UE>;
+}

package/src/assemblers/assembler.factory.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssemblerFactory = void 0;
+const assembler_1 = require("./assembler");
+const default_assembler_1 = require("./default.assembler");
+/**
+ * Assembler Service used by query services to look up Assemblers.
+ */
+class AssemblerFactory {
+    static getAssembler(DTOClass, EntityClass) {
+        const AssemblerClasses = (0, assembler_1.getAssemblers)(DTOClass);
+        if (AssemblerClasses) {
+            const AssemblerClass = AssemblerClasses.get(EntityClass);
+            if (AssemblerClass) {
+                return new AssemblerClass();
+            }
+            const keys = [...AssemblerClasses.keys()];
+            const keysWithParent = keys.filter((k) => k.prototype instanceof EntityClass);
+            if (keysWithParent.length === 1) {
+                return this.getAssembler(DTOClass, keysWithParent[0]);
+            }
+        }
+        const defaultAssembler = new default_assembler_1.DefaultAssembler(DTOClass, EntityClass);
+        // if its a default just assume the types can be converted for all types
+        return defaultAssembler;
+    }
+}
+exports.AssemblerFactory = AssemblerFactory;
+//# sourceMappingURL=assembler.factory.js.map

package/src/assemblers/assembler.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembler.factory.js","sourceRoot":"","sources":["../../../../../packages/core/src/assemblers/assembler.factory.ts"],"names":[],"mappings":";;;AACA,2CAAsD;AACtD,2DAAsD;AAEtD;;GAEG;AACH,MAAa,gBAAgB;IAC3B,MAAM,CAAC,YAAY,CACjB,QAAoB,EACpB,WAA0B;QAE1B,MAAM,gBAAgB,GAAG,IAAA,yBAAa,EAAC,QAAQ,CAAC,CAAA;QAChD,IAAI,gBAAgB,EAAE,CAAC;YACrB,MAAM,cAAc,GAAG,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;YACxD,IAAI,cAAc,EAAE,CAAC;gBACnB,OAAO,IAAI,cAAc,EAA0C,CAAA;YACrE,CAAC;YACD,MAAM,IAAI,GAAG,CAAC,GAAG,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAA;YACzC,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,YAAY,WAAW,CAAC,CAAA;YAC7E,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAChC,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAkB,CAAC,CAAA;YACxE,CAAC;QACH,CAAC;QACD,MAAM,gBAAgB,GAAG,IAAI,oCAAgB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;QACpE,wEAAwE;QACxE,OAAO,gBAAmE,CAAA;IAC5E,CAAC;CACF;AArBD,4CAqBC"}

package/src/assemblers/assembler.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Assembler = Assembler;
+exports.getAssemblers = getAssemblers;
+exports.getAssemblerClasses = getAssemblerClasses;
+const common_1 = require("../common");
+const constants_1 = require("./constants");
+const assemblerReflector = new common_1.ValueReflector(constants_1.ASSEMBLER_CLASSES_KEY);
+const reflector = new common_1.MapReflector(constants_1.ASSEMBLER_KEY);
+/**
+ * Class decorator for Assemblers to register them with nestjs-query
+ * @param DTOClass - the DTO class.
+ * @param EntityClass - The entity class.
+ */
+// eslint-disable-next-line @typescript-eslint/no-redeclare -- intentional
+function Assembler(DTOClass, EntityClass) {
+    return (cls) => {
+        if (reflector.has(DTOClass, EntityClass)) {
+            throw new Error(`Assembler already registered for ${DTOClass.name} ${EntityClass.name}`);
+        }
+        assemblerReflector.set(cls, { DTOClass, EntityClass });
+        reflector.set(DTOClass, EntityClass, cls);
+        return cls;
+    };
+}
+function getAssemblers(DTOClass) {
+    return reflector.get(DTOClass);
+}
+function getAssemblerClasses(AssemblerClass) {
+    return assemblerReflector.get(AssemblerClass);
+}
+//# sourceMappingURL=assembler.js.map

package/src/assemblers/assembler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembler.js","sourceRoot":"","sources":["../../../../../packages/core/src/assemblers/assembler.ts"],"names":[],"mappings":";;AAuFA,8BAgBC;AAED,sCAIC;AAED,kDAIC;AAnHD,sCAAuF;AAEvF,2CAAkE;AAuElE,MAAM,kBAAkB,GAAG,IAAI,uBAAc,CAAC,iCAAqB,CAAC,CAAA;AACpE,MAAM,SAAS,GAAG,IAAI,qBAAY,CAAiB,yBAAa,CAAC,CAAA;AAOjE;;;;GAIG;AACH,0EAA0E;AAC1E,SAAgB,SAAS,CAOvB,QAAoB,EAAE,WAA0B;IAChD,OAAO,CAA0D,GAAQ,EAAc,EAAE;QACvF,IAAI,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,oCAAoC,QAAQ,CAAC,IAAI,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,CAAA;QAC1F,CAAC;QACD,kBAAkB,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAA;QACtD,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,CAAC,CAAA;QACzC,OAAO,GAAG,CAAA;IACZ,CAAC,CAAA;AACH,CAAC;AAED,SAAgB,aAAa,CAC3B,QAAoB;IAEpB,OAAO,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;AAChC,CAAC;AAED,SAAgB,mBAAmB,CACjC,cAA2D;IAE3D,OAAO,kBAAkB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;AAC/C,CAAC"}

package/src/assemblers/assembler.serializer.d.ts

@@ -0,0 +1,4 @@
+import { Class, MetaValue } from '../common';
+export type AssemblerSerializer<T> = (instance: T) => object;
+export declare function AssemblerSerializer<T>(serializer: AssemblerSerializer<T>): <Cls extends Class<T>>(cls: Cls) => Cls | void;
+export declare function getAssemblerSerializer<DTO>(DTOClass: Class<DTO>): MetaValue<AssemblerSerializer<DTO>>;

package/src/assemblers/assembler.serializer.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssemblerSerializer = AssemblerSerializer;
+exports.getAssemblerSerializer = getAssemblerSerializer;
+const common_1 = require("../common");
+const constants_1 = require("./constants");
+const reflector = new common_1.ValueReflector(constants_1.ASSEMBLER_SERIALIZER_KEY);
+// eslint-disable-next-line @typescript-eslint/no-redeclare -- intentional
+function AssemblerSerializer(serializer) {
+    return (cls) => {
+        if (reflector.isDefined(cls)) {
+            throw new Error(`Assembler Serializer already registered for ${cls.name}`);
+        }
+        reflector.set(cls, serializer);
+        return cls;
+    };
+}
+function getAssemblerSerializer(DTOClass) {
+    return reflector.get(DTOClass, true);
+}
+//# sourceMappingURL=assembler.serializer.js.map

package/src/assemblers/assembler.serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembler.serializer.js","sourceRoot":"","sources":["../../../../../packages/core/src/assemblers/assembler.serializer.ts"],"names":[],"mappings":";;AAQA,kDAQC;AAED,wDAEC;AApBD,sCAA4D;AAC5D,2CAAsD;AAEtD,MAAM,SAAS,GAAG,IAAI,uBAAc,CAAC,oCAAwB,CAAC,CAAA;AAI9D,0EAA0E;AAC1E,SAAgB,mBAAmB,CAAI,UAAkC;IACvE,OAAO,CAAuB,GAAQ,EAAc,EAAE;QACpD,IAAI,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,+CAA+C,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;QAC5E,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;QAC9B,OAAO,GAAG,CAAA;IACZ,CAAC,CAAA;AACH,CAAC;AAED,SAAgB,sBAAsB,CAAM,QAAoB;IAC9D,OAAO,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;AACtC,CAAC"}

package/src/assemblers/class-transformer.assembler.d.ts

@@ -0,0 +1,18 @@
+import { Class, DeepPartial } from '../common';
+import { AggregateQuery, AggregateResponse, Query } from '../interfaces';
+import { AbstractAssembler } from './abstract.assembler';
+/**
+ * Base assembler that uses class-transformer to transform to and from the DTO/Entity.
+ */
+export declare abstract class ClassTransformerAssembler<DTO, Entity extends DeepPartial<Entity>> extends AbstractAssembler<DTO, Entity, DeepPartial<DTO>, DeepPartial<Entity>, DeepPartial<DTO>, DeepPartial<Entity>> {
+    convertToDTO(entity: Entity): DTO | Promise<DTO>;
+    convertToEntity(dto: DTO): Entity | Promise<Entity>;
+    convertQuery(query: Query<DTO>): Query<Entity>;
+    convertAggregateQuery(aggregate: AggregateQuery<DTO>): AggregateQuery<Entity>;
+    convertAggregateResponse(aggregate: AggregateResponse<Entity>): AggregateResponse<DTO>;
+    convertToCreateEntity(create: DeepPartial<DTO>): DeepPartial<Entity> | Promise<DeepPartial<Entity>>;
+    convertToUpdateEntity(create: DeepPartial<DTO>): DeepPartial<Entity> | Promise<DeepPartial<Entity>>;
+    convert<T>(cls: Class<T>, obj: object): T;
+    isConstructor(x: any): boolean;
+    toPlain(entityOrDto: Entity | DTO): object;
+}

package/src/assemblers/class-transformer.assembler.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClassTransformerAssembler = void 0;
+const class_transformer_1 = require("class-transformer");
+const abstract_assembler_1 = require("./abstract.assembler");
+const assembler_deserializer_1 = require("./assembler.deserializer");
+const assembler_serializer_1 = require("./assembler.serializer");
+/**
+ * Base assembler that uses class-transformer to transform to and from the DTO/Entity.
+ */
+class ClassTransformerAssembler extends abstract_assembler_1.AbstractAssembler {
+    convertToDTO(entity) {
+        return this.convert(this.DTOClass, this.toPlain(entity));
+    }
+    convertToEntity(dto) {
+        return this.convert(this.EntityClass, this.toPlain(dto));
+    }
+    convertQuery(query) {
+        return query;
+    }
+    convertAggregateQuery(aggregate) {
+        return aggregate;
+    }
+    convertAggregateResponse(aggregate) {
+        return aggregate;
+    }
+    convertToCreateEntity(create) {
+        return this.convert(this.EntityClass, create);
+    }
+    convertToUpdateEntity(create) {
+        return this.convert(this.EntityClass, create);
+    }
+    // eslint-disable-next-line @typescript-eslint/ban-types
+    convert(cls, obj) {
+        const deserializer = (0, assembler_deserializer_1.getAssemblerDeserializer)(cls);
+        if (deserializer) {
+            return deserializer(obj);
+        }
+        return (0, class_transformer_1.plainToClass)(cls, obj);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    isConstructor(x) {
+        const handler = {
+            construct() {
+                return handler;
+            }
+        };
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+            return !!new new Proxy(x, handler)();
+        }
+        catch (e) {
+            return false;
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/ban-types
+    toPlain(entityOrDto) {
+        if (entityOrDto && entityOrDto instanceof this.EntityClass) {
+            const serializer = (0, assembler_serializer_1.getAssemblerSerializer)(this.EntityClass);
+            if (serializer) {
+                return serializer(entityOrDto);
+            }
+        }
+        else if (entityOrDto instanceof this.DTOClass) {
+            const serializer = (0, assembler_serializer_1.getAssemblerSerializer)(this.DTOClass);
+            if (serializer) {
+                return serializer(entityOrDto);
+            }
+        }
+        else if (entityOrDto && 'constructor' in entityOrDto) {
+            // eslint-disable-next-line @typescript-eslint/ban-types
+            const serializer = (0, assembler_serializer_1.getAssemblerSerializer)(entityOrDto.constructor);
+            if (serializer) {
+                return serializer(entityOrDto);
+            }
+        }
+        return entityOrDto;
+    }
+}
+exports.ClassTransformerAssembler = ClassTransformerAssembler;
+//# sourceMappingURL=class-transformer.assembler.js.map

package/src/assemblers/class-transformer.assembler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-transformer.assembler.js","sourceRoot":"","sources":["../../../../../packages/core/src/assemblers/class-transformer.assembler.ts"],"names":[],"mappings":";;;AAAA,yDAAgD;AAIhD,6DAAwD;AACxD,qEAAmE;AACnE,iEAA+D;AAE/D;;GAEG;AACH,MAAsB,yBAAmE,SAAQ,sCAOhG;IACQ,YAAY,CAAC,MAAc;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;IAC1D,CAAC;IAEM,eAAe,CAAC,GAAQ;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAA;IAC1D,CAAC;IAEM,YAAY,CAAC,KAAiB;QACnC,OAAO,KAAiC,CAAA;IAC1C,CAAC;IAEM,qBAAqB,CAAC,SAA8B;QACzD,OAAO,SAA8C,CAAA;IACvD,CAAC;IAEM,wBAAwB,CAAC,SAAoC;QAClE,OAAO,SAA8C,CAAA;IACvD,CAAC;IAEM,qBAAqB,CAAC,MAAwB;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;IAC/C,CAAC;IAEM,qBAAqB,CAAC,MAAwB;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;IAC/C,CAAC;IAED,wDAAwD;IACjD,OAAO,CAAI,GAAa,EAAE,GAAW;QAC1C,MAAM,YAAY,GAAG,IAAA,iDAAwB,EAAC,GAAG,CAAC,CAAA;QAClD,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,YAAY,CAAC,GAAG,CAAC,CAAA;QAC1B,CAAC;QACD,OAAO,IAAA,gCAAY,EAAC,GAAG,EAAE,GAAG,CAAC,CAAA;IAC/B,CAAC;IAED,8DAA8D;IACvD,aAAa,CAAC,CAAM;QACzB,MAAM,OAAO,GAAG;YACd,SAAS;gBACP,OAAO,OAAO,CAAA;YAChB,CAAC;SACF,CAAA;QAED,IAAI,CAAC;YACH,6DAA6D;YAC7D,OAAO,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,CAAA;QACtC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC;IAED,wDAAwD;IACjD,OAAO,CAAC,WAAyB;QACtC,IAAI,WAAW,IAAI,WAAW,YAAY,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3D,MAAM,UAAU,GAAG,IAAA,6CAAsB,EAAC,IAAI,CAAC,WAAW,CAAC,CAAA;YAC3D,IAAI,UAAU,EAAE,CAAC;gBACf,OAAO,UAAU,CAAC,WAAW,CAAC,CAAA;YAChC,CAAC;QACH,CAAC;aAAM,IAAI,WAAW,YAAY,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChD,MAAM,UAAU,GAAG,IAAA,6CAAsB,EAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YACxD,IAAI,UAAU,EAAE,CAAC;gBACf,OAAO,UAAU,CAAC,WAAW,CAAC,CAAA;YAChC,CAAC;QACH,CAAC;aAAM,IAAI,WAAW,IAAI,aAAa,IAAK,WAAsB,EAAE,CAAC;YACnE,wDAAwD;YACxD,MAAM,UAAU,GAAG,IAAA,6CAAsB,EAAC,WAAW,CAAC,WAA6B,CAAC,CAAA;YAEpF,IAAI,UAAU,EAAE,CAAC;gBACf,OAAO,UAAU,CAAC,WAAW,CAAC,CAAA;YAChC,CAAC;QACH,CAAC;QACD,OAAO,WAAgC,CAAA;IACzC,CAAC;CACF;AAnFD,8DAmFC"}

package/src/assemblers/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const ASSEMBLER_KEY = "nestjs-query:assembler";
+export declare const ASSEMBLER_CLASSES_KEY = "nestjs-query:assembler-classes";
+export declare const ASSEMBLER_SERIALIZER_KEY = "nestjs-query:assembler-serializer";
+export declare const ASSEMBLER_DESERIALIZER_KEY = "nestjs-query:assembler-deserializer";

package/src/assemblers/constants.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ASSEMBLER_DESERIALIZER_KEY = exports.ASSEMBLER_SERIALIZER_KEY = exports.ASSEMBLER_CLASSES_KEY = exports.ASSEMBLER_KEY = void 0;
+exports.ASSEMBLER_KEY = 'nestjs-query:assembler';
+exports.ASSEMBLER_CLASSES_KEY = 'nestjs-query:assembler-classes';
+exports.ASSEMBLER_SERIALIZER_KEY = 'nestjs-query:assembler-serializer';
+exports.ASSEMBLER_DESERIALIZER_KEY = 'nestjs-query:assembler-deserializer';
+//# sourceMappingURL=constants.js.map

package/src/assemblers/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../packages/core/src/assemblers/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,aAAa,GAAG,wBAAwB,CAAA;AACxC,QAAA,qBAAqB,GAAG,gCAAgC,CAAA;AACxD,QAAA,wBAAwB,GAAG,mCAAmC,CAAA;AAC9D,QAAA,0BAA0B,GAAG,qCAAqC,CAAA"}

package/src/assemblers/default.assembler.d.ts

@@ -0,0 +1,8 @@
+import { Class, DeepPartial } from '../common';
+import { ClassTransformerAssembler } from './class-transformer.assembler';
+/**
+ * DefaultAssembler used when an Assembler was not defined.
+ */
+export declare class DefaultAssembler<DTO, Entity extends DeepPartial<Entity>> extends ClassTransformerAssembler<DTO, Entity> {
+    constructor(DTOClass: Class<DTO>, EntityClass: Class<Entity>);
+}

package/src/assemblers/default.assembler.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultAssembler = void 0;
+const class_transformer_assembler_1 = require("./class-transformer.assembler");
+/**
+ * DefaultAssembler used when an Assembler was not defined.
+ */
+class DefaultAssembler extends class_transformer_assembler_1.ClassTransformerAssembler {
+    constructor(DTOClass, EntityClass) {
+        super(DTOClass, EntityClass);
+    }
+}
+exports.DefaultAssembler = DefaultAssembler;
+//# sourceMappingURL=default.assembler.js.map

package/src/assemblers/default.assembler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.assembler.js","sourceRoot":"","sources":["../../../../../packages/core/src/assemblers/default.assembler.ts"],"names":[],"mappings":";;;AACA,+EAAyE;AAEzE;;GAEG;AACH,MAAa,gBAA0D,SAAQ,uDAAsC;IACnH,YAAY,QAAoB,EAAE,WAA0B;QAC1D,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;IAC9B,CAAC;CACF;AAJD,4CAIC"}

package/src/assemblers/index.d.ts

@@ -0,0 +1,7 @@
+export { AbstractAssembler } from './abstract.assembler';
+export { Assembler, getAssemblerClasses } from './assembler';
+export { AssemblerDeserializer } from './assembler.deserializer';
+export { AssemblerFactory } from './assembler.factory';
+export { AssemblerSerializer } from './assembler.serializer';
+export { ClassTransformerAssembler } from './class-transformer.assembler';
+export { DefaultAssembler } from './default.assembler';

package/src/assemblers/index.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultAssembler = exports.ClassTransformerAssembler = exports.AssemblerSerializer = exports.AssemblerFactory = exports.AssemblerDeserializer = exports.getAssemblerClasses = exports.Assembler = exports.AbstractAssembler = void 0;
+var abstract_assembler_1 = require("./abstract.assembler");
+Object.defineProperty(exports, "AbstractAssembler", { enumerable: true, get: function () { return abstract_assembler_1.AbstractAssembler; } });
+var assembler_1 = require("./assembler");
+Object.defineProperty(exports, "Assembler", { enumerable: true, get: function () { return assembler_1.Assembler; } });
+Object.defineProperty(exports, "getAssemblerClasses", { enumerable: true, get: function () { return assembler_1.getAssemblerClasses; } });
+var assembler_deserializer_1 = require("./assembler.deserializer");
+Object.defineProperty(exports, "AssemblerDeserializer", { enumerable: true, get: function () { return assembler_deserializer_1.AssemblerDeserializer; } });
+var assembler_factory_1 = require("./assembler.factory");
+Object.defineProperty(exports, "AssemblerFactory", { enumerable: true, get: function () { return assembler_factory_1.AssemblerFactory; } });
+var assembler_serializer_1 = require("./assembler.serializer");
+Object.defineProperty(exports, "AssemblerSerializer", { enumerable: true, get: function () { return assembler_serializer_1.AssemblerSerializer; } });
+var class_transformer_assembler_1 = require("./class-transformer.assembler");
+Object.defineProperty(exports, "ClassTransformerAssembler", { enumerable: true, get: function () { return class_transformer_assembler_1.ClassTransformerAssembler; } });
+var default_assembler_1 = require("./default.assembler");
+Object.defineProperty(exports, "DefaultAssembler", { enumerable: true, get: function () { return default_assembler_1.DefaultAssembler; } });
+//# sourceMappingURL=index.js.map

package/src/assemblers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/core/src/assemblers/index.ts"],"names":[],"mappings":";;;AAAA,2DAAwD;AAA/C,uHAAA,iBAAiB,OAAA;AAC1B,yCAA4D;AAAnD,sGAAA,SAAS,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AACvC,mEAAgE;AAAvD,+HAAA,qBAAqB,OAAA;AAC9B,yDAAsD;AAA7C,qHAAA,gBAAgB,OAAA;AACzB,+DAA4D;AAAnD,2HAAA,mBAAmB,OAAA;AAC5B,6EAAyE;AAAhE,wIAAA,yBAAyB,OAAA;AAClC,yDAAsD;AAA7C,qHAAA,gBAAgB,OAAA"}

package/src/common/class.type.d.ts

@@ -0,0 +1,8 @@
+/**
+ * A function that acts as a constructor for a class.
+ *
+ * @typeparam T - the class instance type the constructor returns.
+ */
+export interface Class<T> {
+    new (...args: any[]): T;
+}

package/src/common/class.type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=class.type.js.map

package/src/common/class.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class.type.js","sourceRoot":"","sources":["../../../../../packages/core/src/common/class.type.ts"],"names":[],"mappings":""}

package/src/common/class.utils.d.ts

@@ -0,0 +1,2 @@
+import { Class } from './class.type';
+export declare function getPrototypeChain(Cls: Class<unknown>): Class<unknown>[];

package/src/common/class.utils.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPrototypeChain = getPrototypeChain;
+function getPrototypeChain(Cls) {
+    const baseClass = Object.getPrototypeOf(Cls);
+    if (baseClass) {
+        return [Cls, ...getPrototypeChain(baseClass)];
+    }
+    return [Cls];
+}
+//# sourceMappingURL=class.utils.js.map

package/src/common/class.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class.utils.js","sourceRoot":"","sources":["../../../../../packages/core/src/common/class.utils.ts"],"names":[],"mappings":";;AAEA,8CAMC;AAND,SAAgB,iBAAiB,CAAC,GAAmB;IACnD,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,GAAG,CAAmB,CAAA;IAC9D,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,EAAE,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAA;IAC/C,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,CAAA;AACd,CAAC"}

package/src/common/deep-partial.type.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Create a Partial that will allow for partials of nested objects and arrays.
+ */
+export declare type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends Array<infer U> ? Array<DeepPartial<U>> : T[P] extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : DeepPartial<T[P]> | T[P];
+};

package/src/common/deep-partial.type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=deep-partial.type.js.map

package/src/common/deep-partial.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-partial.type.js","sourceRoot":"","sources":["../../../../../packages/core/src/common/deep-partial.type.ts"],"names":[],"mappings":""}

package/src/common/index.d.ts

@@ -0,0 +1,5 @@
+export * from './class.type';
+export * from './class.utils';
+export * from './deep-partial.type';
+export * from './misc.utils';
+export * from './reflect.utils';

package/src/common/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./class.type"), exports);
+tslib_1.__exportStar(require("./class.utils"), exports);
+tslib_1.__exportStar(require("./deep-partial.type"), exports);
+tslib_1.__exportStar(require("./misc.utils"), exports);
+tslib_1.__exportStar(require("./reflect.utils"), exports);
+//# sourceMappingURL=index.js.map