@loopback/repository 4.1.2 → 5.0.0

package/dist/relations/has-one/has-one.repository.d.ts

@@ -1,5 +1,6 @@
 import { Getter } from '@loopback/core';
 import { Filter } from '@loopback/filter';
+import { TypeResolver } from '../../';
 import { Count, DataObject, Options } from '../../common-types';
 import { Entity } from '../../model';
 import { EntityCrudRepository } from '../../repositories';
@@ -11,43 +12,89 @@ export interface HasOneRepository<Target extends Entity> {
      * Create a target model instance
      * @param targetModelData - The target model data
      * @param options - Options for the operation
+     * options.polymorphicType - If polymorphic target model,
+     * specify of which concrete model the created instance should be
      * @returns A promise which resolves to the newly created target model instance
      */
-    create(targetModelData: DataObject<Target>, options?: Options): Promise<Target>;
+    create(targetModelData: DataObject<Target>, options?: Options & {
+        polymorphicType?: string;
+    }): Promise<Target>;
     /**
      * Find the only target model instance that belongs to the declaring model.
      * @param filter - Query filter without a Where condition
      * @param options - Options for the operations
+     * options.polymorphicType - a string or a string array of polymorphic type names
+     * to specify which repositories should are expected to be searched
+     * It is highly recommended to contain this param especially for
+     * datasources using deplicated ids across tables
      * @returns A promise resolved with the target object or rejected
      * with an EntityNotFoundError when target model instance was not found.
      */
-    get(filter?: Pick<Filter<Target>, Exclude<keyof Filter<Target>, 'where'>>, options?: Options): Promise<Target>;
+    get(filter?: Pick<Filter<Target>, Exclude<keyof Filter<Target>, 'where'>>, options?: Options & {
+        polymorphicType?: string | string[];
+    }): Promise<Target>;
     /**
      * Delete the related target model instance
      * @param options
+     * options.polymorphicType - a string or a string array of polymorphic type names
+     * to specify which repositories should are expected to be searched
+     * It is highly recommended to contain this param especially for
+     * datasources using deplicated ids across tables
      * @returns A promise which resolves the deleted target model instances
      */
-    delete(options?: Options): Promise<Count>;
+    delete(options?: Options & {
+        polymorphicType?: string | string[];
+    }): Promise<Count>;
     /**
      * Patch the  related target model instance
      * @param dataObject - The target model fields and their new values to patch
+     * If the target models are of different types, this should be a dictionary
      * @param options
+     * options.isPolymorphic - whether dataObject is a dictionary
      * @returns A promise which resolves the patched target model instances
      */
-    patch(dataObject: DataObject<Target>, options?: Options): Promise<Count>;
+    patch(dataObject: DataObject<Target> | {
+        [polymorphicType: string]: DataObject<Target>;
+    }, options?: Options & {
+        isPolymorphic?: boolean;
+    }): Promise<Count>;
 }
 export declare class DefaultHasOneRepository<TargetEntity extends Entity, TargetID, TargetRepository extends EntityCrudRepository<TargetEntity, TargetID>> implements HasOneRepository<TargetEntity> {
-    getTargetRepository: Getter<TargetRepository>;
+    getTargetRepository: Getter<TargetRepository> | {
+        [repoType: string]: Getter<TargetRepository>;
+    };
     constraint: DataObject<TargetEntity>;
+    targetResolver: TypeResolver<Entity, typeof Entity>;
     /**
      * Constructor of DefaultHasOneEntityCrudRepository
-     * @param getTargetRepository - the getter of the related target model repository instance
+     * @param getTargetRepository  - either a dictionary of target model type - target repository instance
+     * or a single target repository instance
+     * e.g. if the target is of a non-polymorphic type "Student", put the studentRepositoryGetterInstance
+     * if the target is of a polymorphic type "Person" which can be either a "Student" or a "Teacher"
+     * then put "{Student: studentRepositoryGetterInstance, Teacher: teacherRepositoryGetterInstance}"
      * @param constraint - the key value pair representing foreign key name to constrain
      * the target repository instance
+     * @param targetResolver - () => Target to resolve the target class
+     * e.g. if the target is of type "Student", then put "() => Student"
      */
-    constructor(getTargetRepository: Getter<TargetRepository>, constraint: DataObject<TargetEntity>);
-    create(targetModelData: DataObject<TargetEntity>, options?: Options): Promise<TargetEntity>;
-    get(filter?: Pick<Filter<TargetEntity>, Exclude<keyof Filter<TargetEntity>, 'where'>>, options?: Options): Promise<TargetEntity>;
-    delete(options?: Options): Promise<Count>;
-    patch(dataObject: DataObject<TargetEntity>, options?: Options): Promise<Count>;
+    constructor(getTargetRepository: Getter<TargetRepository> | {
+        [repoType: string]: Getter<TargetRepository>;
+    }, constraint: DataObject<TargetEntity>, targetResolver: TypeResolver<Entity, typeof Entity>);
+    getTargetRepositoryDict: {
+        [repoType: string]: Getter<TargetRepository>;
+    };
+    create(targetModelData: DataObject<TargetEntity>, options?: Options & {
+        polymorphicType?: string;
+    }): Promise<TargetEntity>;
+    get(filter?: Pick<Filter<TargetEntity>, Exclude<keyof Filter<TargetEntity>, 'where'>>, options?: Options & {
+        polymorphicType?: string | string[];
+    }): Promise<TargetEntity>;
+    delete(options?: Options & {
+        polymorphicType?: string | string[];
+    }): Promise<Count>;
+    patch(dataObject: DataObject<TargetEntity> | {
+        [polymorphicType: string]: DataObject<TargetEntity>;
+    }, options?: Options & {
+        isPolymorphic?: boolean;
+    }): Promise<Count>;
 }

package/dist/relations/has-one/has-one.repository.js

@@ -5,40 +5,143 @@
 // License text available at https://opensource.org/licenses/MIT
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DefaultHasOneRepository = void 0;
+const lodash_1 = require("lodash");
 const errors_1 = require("../../errors");
 const repositories_1 = require("../../repositories");
 class DefaultHasOneRepository {
     /**
      * Constructor of DefaultHasOneEntityCrudRepository
-     * @param getTargetRepository - the getter of the related target model repository instance
+     * @param getTargetRepository  - either a dictionary of target model type - target repository instance
+     * or a single target repository instance
+     * e.g. if the target is of a non-polymorphic type "Student", put the studentRepositoryGetterInstance
+     * if the target is of a polymorphic type "Person" which can be either a "Student" or a "Teacher"
+     * then put "{Student: studentRepositoryGetterInstance, Teacher: teacherRepositoryGetterInstance}"
      * @param constraint - the key value pair representing foreign key name to constrain
      * the target repository instance
+     * @param targetResolver - () => Target to resolve the target class
+     * e.g. if the target is of type "Student", then put "() => Student"
      */
-    constructor(getTargetRepository, constraint) {
+    constructor(getTargetRepository, constraint, targetResolver) {
         this.getTargetRepository = getTargetRepository;
         this.constraint = constraint;
+        this.targetResolver = targetResolver;
+        if (typeof getTargetRepository === 'function') {
+            this.getTargetRepositoryDict = {
+                [targetResolver().name]: getTargetRepository,
+            };
+        }
+        else {
+            this.getTargetRepositoryDict = getTargetRepository;
+        }
     }
     async create(targetModelData, options) {
-        const targetRepository = await this.getTargetRepository();
+        let polymorphicTypeName = options === null || options === void 0 ? void 0 : options.polymorphicType;
+        if (polymorphicTypeName) {
+            if (!this.getTargetRepositoryDict[polymorphicTypeName]) {
+                throw new errors_1.InvalidPolymorphismError(polymorphicTypeName);
+            }
+        }
+        else {
+            if (Object.keys(this.getTargetRepositoryDict).length > 1) {
+                console.warn('It is highly recommended to specify the polymorphicType param when using polymorphic types.');
+            }
+            polymorphicTypeName = this.targetResolver().name;
+            if (!this.getTargetRepositoryDict[polymorphicTypeName]) {
+                throw new errors_1.InvalidPolymorphismError(polymorphicTypeName);
+            }
+        }
+        const targetRepository = await this.getTargetRepositoryDict[polymorphicTypeName]();
         return targetRepository.create((0, repositories_1.constrainDataObject)(targetModelData, this.constraint), options);
     }
     async get(filter, options) {
-        const targetRepository = await this.getTargetRepository();
-        const found = await targetRepository.find(Object.assign({ limit: 1 }, (0, repositories_1.constrainFilter)(filter, this.constraint)), options);
-        if (found.length < 1) {
-            // We don't have a direct access to the foreign key value here :(
-            const id = 'constraint ' + JSON.stringify(this.constraint);
-            throw new errors_1.EntityNotFoundError(targetRepository.entityClass, id);
-        }
-        return found[0];
+        let polymorphicTypes = options === null || options === void 0 ? void 0 : options.polymorphicType;
+        let allKeys;
+        if (Object.keys(this.getTargetRepositoryDict).length <= 1) {
+            allKeys = Object.keys(this.getTargetRepositoryDict);
+        }
+        else if (!polymorphicTypes || polymorphicTypes.length === 0) {
+            console.warn('It is highly recommended to specify the polymorphicType param when using polymorphic types.');
+            allKeys = Object.keys(this.getTargetRepositoryDict);
+        }
+        else {
+            if (typeof polymorphicTypes === 'string') {
+                polymorphicTypes = [polymorphicTypes];
+            }
+            allKeys = [];
+            new Set(polymorphicTypes).forEach(element => {
+                if (Object.keys(this.getTargetRepositoryDict).includes(element)) {
+                    allKeys.push(element);
+                }
+            });
+        }
+        for (const key of allKeys) {
+            const targetRepository = await this.getTargetRepositoryDict[key]();
+            const found = await targetRepository.find(Object.assign({ limit: 1 }, (0, repositories_1.constrainFilter)(filter, this.constraint)), Object.assign((0, lodash_1.cloneDeep)(options !== null && options !== void 0 ? options : {}), { polymorphicType: key }));
+            if (found.length >= 1) {
+                return found[0];
+            }
+        }
+        // We don't have a direct access to the foreign key value here :(
+        const id = 'constraint ' + JSON.stringify(this.constraint);
+        throw new errors_1.EntityNotFoundError(this.targetResolver().name, id);
     }
     async delete(options) {
-        const targetRepository = await this.getTargetRepository();
-        return targetRepository.deleteAll((0, repositories_1.constrainWhere)({}, this.constraint), options);
+        var _a, _b;
+        let polymorphicTypes = options === null || options === void 0 ? void 0 : options.polymorphicType;
+        let allKeys;
+        if (Object.keys(this.getTargetRepositoryDict).length <= 1) {
+            allKeys = Object.keys(this.getTargetRepositoryDict);
+        }
+        else if (!polymorphicTypes || polymorphicTypes.length === 0) {
+            console.warn('It is highly recommended to specify the polymorphicType param when using polymorphic types.');
+            allKeys = Object.keys(this.getTargetRepositoryDict);
+        }
+        else {
+            if (typeof polymorphicTypes === 'string') {
+                polymorphicTypes = [polymorphicTypes];
+            }
+            allKeys = [];
+            new Set(polymorphicTypes).forEach(element => {
+                if (Object.keys(this.getTargetRepositoryDict).includes(element)) {
+                    allKeys.push(element);
+                }
+            });
+        }
+        let total = 0;
+        for (const key of allKeys) {
+            const targetRepository = await this.getTargetRepositoryDict[key]();
+            total +=
+                (_b = (_a = (await targetRepository.deleteAll((0, repositories_1.constrainWhere)({}, this.constraint), options))) === null || _a === void 0 ? void 0 : _a.count) !== null && _b !== void 0 ? _b : 0;
+        }
+        return { count: total };
     }
     async patch(dataObject, options) {
-        const targetRepository = await this.getTargetRepository();
-        return targetRepository.updateAll((0, repositories_1.constrainDataObject)(dataObject, this.constraint), (0, repositories_1.constrainWhere)({}, this.constraint), options);
+        var _a, _b;
+        const isMultipleTypes = options === null || options === void 0 ? void 0 : options.isPolymorphic;
+        let allKeys;
+        if (!isMultipleTypes) {
+            if (Object.keys(this.getTargetRepositoryDict).length > 1) {
+                console.warn('It is highly recommended to specify the isPolymorphic param and pass in a dictionary of dataobjects when using polymorphic types.');
+            }
+            allKeys = Object.keys(this.getTargetRepositoryDict);
+        }
+        else {
+            allKeys = [];
+            new Set(Object.keys(dataObject)).forEach(element => {
+                if (Object.keys(this.getTargetRepositoryDict).includes(element)) {
+                    allKeys.push(element);
+                }
+            });
+        }
+        let total = 0;
+        for (const key of allKeys) {
+            const targetRepository = await this.getTargetRepositoryDict[key]();
+            total +=
+                (_b = (_a = (await targetRepository.updateAll((0, repositories_1.constrainDataObject)(isMultipleTypes
+                    ? dataObject[key]
+                    : dataObject, this.constraint), (0, repositories_1.constrainWhere)({}, this.constraint), options))) === null || _a === void 0 ? void 0 : _a.count) !== null && _b !== void 0 ? _b : 0;
+        }
+        return { count: total };
     }
 }
 exports.DefaultHasOneRepository = DefaultHasOneRepository;

package/dist/relations/has-one/has-one.repository.js.map

@@ -1 +1 @@
-{"version":3,"file":"has-one.repository.js","sourceRoot":"","sources":["../../../src/relations/has-one/has-one.repository.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,oCAAoC;AACpC,+CAA+C;AAC/C,gEAAgE;;;AAKhE,yCAAiD;AAEjD,qDAK4B;AA6C5B,MAAa,uBAAuB;IAMlC;;;;;OAKG;IACH,YACS,mBAA6C,EAC7C,UAAoC;QADpC,wBAAmB,GAAnB,mBAAmB,CAA0B;QAC7C,eAAU,GAAV,UAAU,CAA0B;IAC1C,CAAC;IAEJ,KAAK,CAAC,MAAM,CACV,eAAyC,EACzC,OAAiB;QAEjB,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC1D,OAAO,gBAAgB,CAAC,MAAM,CAC5B,IAAA,kCAAmB,EAAC,eAAe,EAAE,IAAI,CAAC,UAAU,CAAC,EACrD,OAAO,CACR,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,GAAG,CACP,MAGC,EACD,OAAiB;QAEjB,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC1D,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,IAAI,CACvC,MAAM,CAAC,MAAM,CAAC,EAAC,KAAK,EAAE,CAAC,EAAC,EAAE,IAAA,8BAAe,EAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,EACnE,OAAO,CACR,CAAC;QACF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE;YACpB,iEAAiE;YACjE,MAAM,EAAE,GAAG,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC3D,MAAM,IAAI,4BAAmB,CAAC,gBAAgB,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;SACjE;QACD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,OAAiB;QAC5B,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC1D,OAAO,gBAAgB,CAAC,SAAS,CAC/B,IAAA,6BAAc,EAAC,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,EACnC,OAAO,CACR,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,CACT,UAAoC,EACpC,OAAiB;QAEjB,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC1D,OAAO,gBAAgB,CAAC,SAAS,CAC/B,IAAA,kCAAmB,EAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,EAChD,IAAA,6BAAc,EAAC,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,EACnC,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AAlED,0DAkEC"}
+{"version":3,"file":"has-one.repository.js","sourceRoot":"","sources":["../../../src/relations/has-one/has-one.repository.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,oCAAoC;AACpC,+CAA+C;AAC/C,gEAAgE;;;AAIhE,mCAAiC;AAGjC,yCAA2E;AAE3E,qDAK4B;AAgE5B,MAAa,uBAAuB;IAMlC;;;;;;;;;;;OAWG;IAEH,YACS,mBAIF,EACE,UAAoC,EACpC,cAAmD;QANnD,wBAAmB,GAAnB,mBAAmB,CAIrB;QACE,eAAU,GAAV,UAAU,CAA0B;QACpC,mBAAc,GAAd,cAAc,CAAqC;QAE1D,IAAI,OAAO,mBAAmB,KAAK,UAAU,EAAE;YAC7C,IAAI,CAAC,uBAAuB,GAAG;gBAC7B,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,EACrB,mBAA+C;aAClD,CAAC;SACH;aAAM;YACL,IAAI,CAAC,uBAAuB,GAAG,mBAE9B,CAAC;SACH;IACH,CAAC;IAMD,KAAK,CAAC,MAAM,CACV,eAAyC,EACzC,OAA8C;QAE9C,IAAI,mBAAmB,GAAG,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,eAAe,CAAC;QACnD,IAAI,mBAAmB,EAAE;YACvB,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,mBAAmB,CAAC,EAAE;gBACtD,MAAM,IAAI,iCAAwB,CAAC,mBAAmB,CAAC,CAAC;aACzD;SACF;aAAM;YACL,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE;gBACxD,OAAO,CAAC,IAAI,CACV,6FAA6F,CAC9F,CAAC;aACH;YACD,mBAAmB,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC;YACjD,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,mBAAmB,CAAC,EAAE;gBACtD,MAAM,IAAI,iCAAwB,CAAC,mBAAmB,CAAC,CAAC;aACzD;SACF;QACD,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,uBAAuB,CACzD,mBAAmB,CACpB,EAAE,CAAC;QACJ,OAAO,gBAAgB,CAAC,MAAM,CAC5B,IAAA,kCAAmB,EAAC,eAAe,EAAE,IAAI,CAAC,UAAU,CAAC,EACrD,OAAO,CACR,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,GAAG,CACP,MAGC,EACD,OAAyD;QAEzD,IAAI,gBAAgB,GAAG,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,eAAe,CAAC;QAChD,IAAI,OAAiB,CAAC;QACtB,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,MAAM,IAAI,CAAC,EAAE;YACzD,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;SACrD;aAAM,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE;YAC7D,OAAO,CAAC,IAAI,CACV,6FAA6F,CAC9F,CAAC;YACF,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;SACrD;aAAM;YACL,IAAI,OAAO,gBAAgB,KAAK,QAAQ,EAAE;gBACxC,gBAAgB,GAAG,CAAC,gBAAgB,CAAC,CAAC;aACvC;YACD,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,CAAC,gBAAiB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;gBAC3C,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE;oBAC/D,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;iBACvB;YACH,CAAC,CAAC,CAAC;SACJ;QACD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE;YACzB,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,EAAE,CAAC;YACnE,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,IAAI,CACvC,MAAM,CAAC,MAAM,CAAC,EAAC,KAAK,EAAE,CAAC,EAAC,EAAE,IAAA,8BAAe,EAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,EACnE,MAAM,CAAC,MAAM,CAAC,IAAA,kBAAS,EAAC,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,EAAE,CAAC,EAAE,EAAC,eAAe,EAAE,GAAG,EAAC,CAAC,CAChE,CAAC;YACF,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE;gBACrB,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;aACjB;SACF;QACD,iEAAiE;QACjE,MAAM,EAAE,GAAG,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3D,MAAM,IAAI,4BAAmB,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,MAAM,CACV,OAAyD;;QAEzD,IAAI,gBAAgB,GAAG,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,eAAe,CAAC;QAChD,IAAI,OAAiB,CAAC;QACtB,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,MAAM,IAAI,CAAC,EAAE;YACzD,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;SACrD;aAAM,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE;YAC7D,OAAO,CAAC,IAAI,CACV,6FAA6F,CAC9F,CAAC;YACF,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;SACrD;aAAM;YACL,IAAI,OAAO,gBAAgB,KAAK,QAAQ,EAAE;gBACxC,gBAAgB,GAAG,CAAC,gBAAgB,CAAC,CAAC;aACvC;YACD,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,CAAC,gBAAiB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;gBAC3C,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE;oBAC/D,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;iBACvB;YACH,CAAC,CAAC,CAAC;SACJ;QACD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE;YACzB,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,EAAE,CAAC;YACnE,KAAK;gBACH,MAAA,MAAA,CACE,MAAM,gBAAgB,CAAC,SAAS,CAC9B,IAAA,6BAAc,EAAC,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,EACnC,OAAO,CACR,CACF,0CAAE,KAAK,mCAAI,CAAC,CAAC;SACjB;QACD,OAAO,EAAC,KAAK,EAAE,KAAK,EAAC,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,KAAK,CACT,UAEyD,EACzD,OAA6C;;QAE7C,MAAM,eAAe,GAAG,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,aAAa,CAAC;QAC/C,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC,eAAe,EAAE;YACpB,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE;gBACxD,OAAO,CAAC,IAAI,CACV,mIAAmI,CACpI,CAAC;aACH;YACD,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;SACrD;aAAM;YACL,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;gBACjD,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE;oBAC/D,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;iBACvB;YACH,CAAC,CAAC,CAAC;SACJ;QACD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE;YACzB,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,EAAE,CAAC;YACnE,KAAK;gBACH,MAAA,MAAA,CACE,MAAM,gBAAgB,CAAC,SAAS,CAC9B,IAAA,kCAAmB,EACjB,eAAe;oBACb,CAAC,CACG,UAGD,CAAC,GAAG,CAAC;oBACR,CAAC,CAAE,UAAuC,EAC5C,IAAI,CAAC,UAAU,CAChB,EACD,IAAA,6BAAc,EAAC,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,EACnC,OAAO,CACR,CACF,0CAAE,KAAK,mCAAI,CAAC,CAAC;SACjB;QACD,OAAO,EAAC,KAAK,EAAE,KAAK,EAAC,CAAC;IACxB,CAAC;CACF;AAtMD,0DAsMC"}

package/dist/relations/index.d.ts

@@ -1,6 +1,8 @@
 export * from './belongs-to';
 export * from './has-many';
 export * from './has-one';
+export * from './references-many';
 export * from './relation.decorator';
+export * from './relation.filter.solver';
 export * from './relation.helpers';
 export * from './relation.types';

package/dist/relations/index.js

@@ -8,7 +8,9 @@ const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./belongs-to"), exports);
 tslib_1.__exportStar(require("./has-many"), exports);
 tslib_1.__exportStar(require("./has-one"), exports);
+tslib_1.__exportStar(require("./references-many"), exports);
 tslib_1.__exportStar(require("./relation.decorator"), exports);
+tslib_1.__exportStar(require("./relation.filter.solver"), exports);
 tslib_1.__exportStar(require("./relation.helpers"), exports);
 tslib_1.__exportStar(require("./relation.types"), exports);
 //# sourceMappingURL=index.js.map

package/dist/relations/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/relations/index.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,oCAAoC;AACpC,+CAA+C;AAC/C,gEAAgE;;;AAEhE,uDAA6B;AAC7B,qDAA2B;AAC3B,oDAA0B;AAC1B,+DAAqC;AACrC,6DAAmC;AACnC,2DAAiC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/relations/index.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,oCAAoC;AACpC,+CAA+C;AAC/C,gEAAgE;;;AAEhE,uDAA6B;AAC7B,qDAA2B;AAC3B,oDAA0B;AAC1B,4DAAkC;AAClC,+DAAqC;AACrC,mEAAyC;AACzC,6DAAmC;AACnC,2DAAiC"}

package/dist/relations/references-many/index.d.ts

@@ -0,0 +1,4 @@
+export * from './references-many.decorator';
+export * from './references-many.repository';
+export * from './references-many.accessor';
+export * from './references-many.inclusion-resolver';

package/dist/relations/references-many/index.js

@@ -0,0 +1,12 @@
+"use strict";
+// Copyright IBM Corp. 2018,2020. All Rights Reserved.
+// Node module: @loopback/repository
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./references-many.decorator"), exports);
+tslib_1.__exportStar(require("./references-many.repository"), exports);
+tslib_1.__exportStar(require("./references-many.accessor"), exports);
+tslib_1.__exportStar(require("./references-many.inclusion-resolver"), exports);
+//# sourceMappingURL=index.js.map

package/dist/relations/references-many/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/relations/references-many/index.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,oCAAoC;AACpC,+CAA+C;AAC/C,gEAAgE;;;AAEhE,sEAA4C;AAC5C,uEAA6C;AAC7C,qEAA2C;AAC3C,+EAAqD"}

package/dist/relations/references-many/references-many.accessor.d.ts

@@ -0,0 +1,17 @@
+import { Entity } from '../../model';
+import { EntityCrudRepository } from '../../repositories/repository';
+import { ReferencesManyDefinition, Getter, InclusionResolver } from '../relation.types';
+export interface ReferencesManyAccessor<Target extends Entity, SourceId> {
+    /**
+     * Invoke the function to obtain HasManyRepository.
+     */
+    (sourceId: SourceId): Promise<Target>;
+    /**
+     * Use `resolver` property to obtain an InclusionResolver for this relation.
+     */
+    inclusionResolver: InclusionResolver<Entity, Target>;
+}
+/**
+ * Enforces a ReferencesMany constraint on a repository
+ */
+export declare function createReferencesManyAccessor<Target extends Entity, TargetIds, Source extends Entity, SourceId>(referencesManyMetadata: ReferencesManyDefinition, targetRepoGetter: Getter<EntityCrudRepository<Target, TargetIds>>, sourceRepository: EntityCrudRepository<Source, SourceId>): ReferencesManyAccessor<Target, SourceId>;

package/dist/relations/references-many/references-many.accessor.js

@@ -0,0 +1,40 @@
+"use strict";
+// Copyright IBM Corp. 2018,2019. All Rights Reserved.
+// Node module: @loopback/repository
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createReferencesManyAccessor = void 0;
+const tslib_1 = require("tslib");
+const debug_1 = tslib_1.__importDefault(require("debug"));
+const references_many_helpers_1 = require("./references-many.helpers");
+const references_many_inclusion_resolver_1 = require("./references-many.inclusion-resolver");
+const references_many_repository_1 = require("./references-many.repository");
+const debug = (0, debug_1.default)('loopback:repository:relations:references-many:accessor');
+/**
+ * Enforces a ReferencesMany constraint on a repository
+ */
+function createReferencesManyAccessor(referencesManyMetadata, targetRepoGetter, sourceRepository) {
+    const meta = (0, references_many_helpers_1.resolveReferencesManyMetadata)(referencesManyMetadata);
+    debug('Resolved ReferencesMany relation metadata: %o', meta);
+    const result = async function getTargetInstancesOfReferencesMany(sourceId) {
+        const foreignKey = meta.keyFrom;
+        const primaryKey = meta.keyTo;
+        const sourceModel = await sourceRepository.findById(sourceId);
+        const foreignKeyValue = sourceModel[foreignKey];
+        // workaround to check referential integrity.
+        // should be removed once the memory connector ref integrity is done
+        // GH issue: https://github.com/loopbackio/loopback-next/issues/2333
+        if (!foreignKeyValue) {
+            return undefined;
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const constraint = { [primaryKey]: foreignKeyValue };
+        const constrainedRepo = new references_many_repository_1.DefaultReferencesManyRepository(targetRepoGetter, constraint);
+        return constrainedRepo.get();
+    };
+    result.inclusionResolver = (0, references_many_inclusion_resolver_1.createReferencesManyInclusionResolver)(meta, targetRepoGetter);
+    return result;
+}
+exports.createReferencesManyAccessor = createReferencesManyAccessor;
+//# sourceMappingURL=references-many.accessor.js.map

package/dist/relations/references-many/references-many.accessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references-many.accessor.js","sourceRoot":"","sources":["../../../src/relations/references-many/references-many.accessor.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,oCAAoC;AACpC,+CAA+C;AAC/C,gEAAgE;;;;AAEhE,0DAAiC;AASjC,uEAAwE;AACxE,6FAA2F;AAC3F,6EAA6E;AAE7E,MAAM,KAAK,GAAG,IAAA,eAAY,EACxB,wDAAwD,CACzD,CAAC;AAcF;;GAEG;AACH,SAAgB,4BAA4B,CAM1C,sBAAgD,EAChD,gBAAiE,EACjE,gBAAwD;IAExD,MAAM,IAAI,GAAG,IAAA,uDAA6B,EAAC,sBAAsB,CAAC,CAAC;IACnE,KAAK,CAAC,+CAA+C,EAAE,IAAI,CAAC,CAAC;IAC7D,MAAM,MAAM,GACV,KAAK,UAAU,kCAAkC,CAAC,QAAkB;QAClE,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC;QAChC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC;QAC9B,MAAM,WAAW,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC9D,MAAM,eAAe,GAAG,WAAW,CAAC,UAA0B,CAAC,CAAC;QAChE,6CAA6C;QAC7C,oEAAoE;QACpE,oEAAoE;QACpE,IAAI,CAAC,eAAe,EAAE;YACpB,OAAO,SAA8B,CAAC;SACvC;QACD,8DAA8D;QAC9D,MAAM,UAAU,GAAQ,EAAC,CAAC,UAAU,CAAC,EAAE,eAAe,EAAC,CAAC;QACxD,MAAM,eAAe,GAAG,IAAI,4DAA+B,CACzD,gBAAgB,EAChB,UAAgC,CACjC,CAAC;QACF,OAAO,eAAe,CAAC,GAAG,EAAE,CAAC;IAC/B,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,GAAG,IAAA,0EAAqC,EAC9D,IAAI,EACJ,gBAAgB,CACjB,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAtCD,oEAsCC"}

package/dist/relations/references-many/references-many.decorator.d.ts

@@ -0,0 +1,11 @@
+import { Entity, EntityResolver, PropertyDefinition } from '../../model';
+import { ReferencesManyDefinition } from '../relation.types';
+/**
+ * Decorator for referencesMany
+ * @param targetResolver - A resolver function that returns the target model for
+ * a referencesMany relation
+ * @param definition - Optional metadata for setting up a referencesMany relation
+ * @param propertyDefinition - Optional metadata for setting up the property
+ * @returns A property decorator
+ */
+export declare function referencesMany<T extends Entity>(targetResolver: EntityResolver<T>, definition?: Partial<ReferencesManyDefinition>, propertyDefinition?: Partial<PropertyDefinition>): (decoratedTarget: Entity, decoratedKey: string) => void;

package/dist/relations/references-many/references-many.decorator.js

@@ -0,0 +1,73 @@
+"use strict";
+// Copyright IBM Corp. 2018,2020. All Rights Reserved.
+// Node module: @loopback/repository
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.referencesMany = void 0;
+const core_1 = require("@loopback/core");
+const decorators_1 = require("../../decorators");
+const relation_decorator_1 = require("../relation.decorator");
+const relation_types_1 = require("../relation.types");
+/**
+ * Decorator for referencesMany
+ * @param targetResolver - A resolver function that returns the target model for
+ * a referencesMany relation
+ * @param definition - Optional metadata for setting up a referencesMany relation
+ * @param propertyDefinition - Optional metadata for setting up the property
+ * @returns A property decorator
+ */
+function referencesMany(targetResolver, definition, propertyDefinition) {
+    return function (decoratedTarget, decoratedKey) {
+        var _a, _b, _c;
+        const propType = (_a = core_1.MetadataInspector.getDesignTypeForProperty(decoratedTarget, decoratedKey)) !== null && _a !== void 0 ? _a : propertyDefinition === null || propertyDefinition === void 0 ? void 0 : propertyDefinition.type;
+        if (!propType) {
+            const fullPropName = core_1.DecoratorFactory.getTargetName(decoratedTarget, decoratedKey);
+            throw new Error(`Cannot infer type of model property ${fullPropName} because ` +
+                'TypeScript compiler option `emitDecoratorMetadata` is not set. ' +
+                'Please enable `emitDecoratorMetadata` or use the third argument of ' +
+                '`@referencesMany` decorator to specify the property type explicitly.');
+        }
+        const sourceKeyType = core_1.MetadataInspector.getDesignTypeForProperty(targetResolver().prototype, (_b = definition === null || definition === void 0 ? void 0 : definition.keyTo) !== null && _b !== void 0 ? _b : 'id');
+        if (!sourceKeyType) {
+            const fullPropName = core_1.DecoratorFactory.getTargetName(targetResolver().prototype, (_c = definition === null || definition === void 0 ? void 0 : definition.keyTo) !== null && _c !== void 0 ? _c : 'id');
+            throw new Error(`Cannot infer type of model property ${fullPropName} because ` +
+                'TypeScript compiler option `emitDecoratorMetadata` is not set. ' +
+                'Please enable `emitDecoratorMetadata` or use the second argument of ' +
+                '`@referencesMany` decorator to specify the property type explicitly.');
+        }
+        const propMeta = Object.assign({}, 
+        // properties provided by the caller
+        propertyDefinition, 
+        // properties enforced by the decorator
+        {
+            type: propType,
+            itemType: sourceKeyType,
+            // TODO(bajtos) Make the foreign key required once our REST API layer
+            // allows controller methods to exclude required properties
+            // required: true,
+        });
+        (0, decorators_1.property)(propMeta)(decoratedTarget, decoratedKey);
+        // @referencesMany() is typically decorating the foreign key property,
+        // e.g. customerIds. We need to strip the trailing "Ids" suffix from the name.
+        const relationName = decoratedKey.replace(/Ids$/, 's');
+        const meta = Object.assign(
+        // default values, can be customized by the caller
+        {
+            keyFrom: decoratedKey,
+            name: relationName,
+        }, 
+        // properties provided by the caller
+        definition, 
+        // properties enforced by the decorator
+        {
+            type: relation_types_1.RelationType.referencesMany,
+            targetsMany: true,
+            source: decoratedTarget.constructor,
+            target: targetResolver,
+        });
+        (0, relation_decorator_1.relation)(meta)(decoratedTarget, decoratedKey);
+    };
+}
+exports.referencesMany = referencesMany;
+//# sourceMappingURL=references-many.decorator.js.map

package/dist/relations/references-many/references-many.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references-many.decorator.js","sourceRoot":"","sources":["../../../src/relations/references-many/references-many.decorator.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,oCAAoC;AACpC,+CAA+C;AAC/C,gEAAgE;;;AAEhE,yCAAmE;AACnE,iDAA0C;AAC1C,8DAA+C;AAE/C,sDAAyE;AAEzE;;;;;;;GAOG;AACH,SAAgB,cAAc,CAC5B,cAAiC,EACjC,UAA8C,EAC9C,kBAAgD;IAEhD,OAAO,UAAU,eAAuB,EAAE,YAAoB;;QAC5D,MAAM,QAAQ,GACZ,MAAA,wBAAiB,CAAC,wBAAwB,CACxC,eAAe,EACf,YAAY,CACb,mCAAI,kBAAkB,aAAlB,kBAAkB,uBAAlB,kBAAkB,CAAE,IAAI,CAAC;QAEhC,IAAI,CAAC,QAAQ,EAAE;YACb,MAAM,YAAY,GAAG,uBAAgB,CAAC,aAAa,CACjD,eAAe,EACf,YAAY,CACb,CAAC;YACF,MAAM,IAAI,KAAK,CACb,uCAAuC,YAAY,WAAW;gBAC5D,iEAAiE;gBACjE,qEAAqE;gBACrE,sEAAsE,CACzE,CAAC;SACH;QAED,MAAM,aAAa,GAAG,wBAAiB,CAAC,wBAAwB,CAC9D,cAAc,EAAE,CAAC,SAAS,EAC1B,MAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,KAAK,mCAAI,IAAI,CAC1B,CAAC;QAEF,IAAI,CAAC,aAAa,EAAE;YAClB,MAAM,YAAY,GAAG,uBAAgB,CAAC,aAAa,CACjD,cAAc,EAAE,CAAC,SAAS,EAC1B,MAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,KAAK,mCAAI,IAAI,CAC1B,CAAC;YACF,MAAM,IAAI,KAAK,CACb,uCAAuC,YAAY,WAAW;gBAC5D,iEAAiE;gBACjE,sEAAsE;gBACtE,sEAAsE,CACzE,CAAC;SACH;QAED,MAAM,QAAQ,GAAuB,MAAM,CAAC,MAAM,CAChD,EAAE;QACF,oCAAoC;QACpC,kBAAkB;QAClB,uCAAuC;QACvC;YACE,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,aAAa;YACvB,qEAAqE;YACrE,2DAA2D;YAC3D,kBAAkB;SACnB,CACF,CAAC;QACF,IAAA,qBAAQ,EAAC,QAAQ,CAAC,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;QAElD,sEAAsE;QACtE,8EAA8E;QAC9E,MAAM,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAEvD,MAAM,IAAI,GAA6B,MAAM,CAAC,MAAM;QAClD,kDAAkD;QAClD;YACE,OAAO,EAAE,YAAY;YACrB,IAAI,EAAE,YAAY;SACnB;QACD,oCAAoC;QACpC,UAAU;QACV,uCAAuC;QACvC;YACE,IAAI,EAAE,6BAAY,CAAC,cAAc;YACjC,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE,eAAe,CAAC,WAAW;YACnC,MAAM,EAAE,cAAc;SACvB,CACF,CAAC;QACF,IAAA,6BAAQ,EAAC,IAAI,CAAC,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;IAChD,CAAC,CAAC;AACJ,CAAC;AAhFD,wCAgFC"}

package/dist/relations/references-many/references-many.helpers.d.ts

@@ -0,0 +1,17 @@
+import { ReferencesManyDefinition } from '../relation.types';
+/**
+ * Relation definition with optional metadata (e.g. `keyTo`) filled in.
+ * @internal
+ */
+export declare type ReferencesManyResolvedDefinition = ReferencesManyDefinition & {
+    keyFrom: string;
+    keyTo: string;
+};
+/**
+ * Resolves given referencesMany metadata if target is specified to be a resolver.
+ * Mainly used to infer what the `keyTo` property should be from the target's
+ * property id metadata
+ * @param relationMeta - referencesMany metadata to resolve
+ * @internal
+ */
+export declare function resolveReferencesManyMetadata(relationMeta: ReferencesManyDefinition): ReferencesManyResolvedDefinition;

package/dist/relations/references-many/references-many.helpers.js

@@ -0,0 +1,63 @@
+"use strict";
+// Copyright IBM Corp. 2019. All Rights Reserved.
+// Node module: @loopback/repository
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveReferencesManyMetadata = void 0;
+const tslib_1 = require("tslib");
+const debug_1 = tslib_1.__importDefault(require("debug"));
+const lodash_1 = require("lodash");
+const errors_1 = require("../../errors");
+const type_resolver_1 = require("../../type-resolver");
+const relation_types_1 = require("../relation.types");
+const debug = (0, debug_1.default)('loopback:repository:relations:references-many:helpers');
+/**
+ * Resolves given referencesMany metadata if target is specified to be a resolver.
+ * Mainly used to infer what the `keyTo` property should be from the target's
+ * property id metadata
+ * @param relationMeta - referencesMany metadata to resolve
+ * @internal
+ */
+function resolveReferencesManyMetadata(relationMeta) {
+    if (relationMeta.type !== relation_types_1.RelationType.referencesMany) {
+        const reason = 'relation type must be ReferencesMany';
+        throw new errors_1.InvalidRelationError(reason, relationMeta);
+    }
+    if (!(0, type_resolver_1.isTypeResolver)(relationMeta.target)) {
+        const reason = 'target must be a type resolver';
+        throw new errors_1.InvalidRelationError(reason, relationMeta);
+    }
+    const sourceModel = relationMeta.source;
+    if (!sourceModel || !sourceModel.modelName) {
+        const reason = 'source model must be defined';
+        throw new errors_1.InvalidRelationError(reason, relationMeta);
+    }
+    const targetModel = relationMeta.target();
+    const targetName = targetModel.modelName;
+    debug('Resolved model %s from given metadata: %o', targetName, targetModel);
+    let keyFrom;
+    if (relationMeta.keyFrom &&
+        relationMeta.source.definition.properties[relationMeta.keyFrom]) {
+        keyFrom = relationMeta.keyFrom;
+    }
+    else {
+        keyFrom = (0, lodash_1.camelCase)(targetName + '_ids');
+    }
+    const targetProperties = targetModel.definition.properties;
+    debug('relation metadata from %o: %o', targetName, targetProperties);
+    if (relationMeta.keyTo && targetProperties[relationMeta.keyTo]) {
+        // The explicit cast is needed because of a limitation of type inference
+        return Object.assign(relationMeta, {
+            keyFrom,
+        });
+    }
+    const targetPrimaryKey = targetModel.definition.idProperties()[0];
+    if (!targetPrimaryKey) {
+        const reason = `${targetName} does not have any primary key (id property)`;
+        throw new errors_1.InvalidRelationError(reason, relationMeta);
+    }
+    return Object.assign(relationMeta, { keyFrom, keyTo: targetPrimaryKey });
+}
+exports.resolveReferencesManyMetadata = resolveReferencesManyMetadata;
+//# sourceMappingURL=references-many.helpers.js.map

package/dist/relations/references-many/references-many.helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references-many.helpers.js","sourceRoot":"","sources":["../../../src/relations/references-many/references-many.helpers.ts"],"names":[],"mappings":";AAAA,iDAAiD;AACjD,oCAAoC;AACpC,+CAA+C;AAC/C,gEAAgE;;;;AAEhE,0DAAiC;AACjC,mCAAiC;AACjC,yCAAkD;AAClD,uDAAmD;AACnD,sDAAyE;AAEzE,MAAM,KAAK,GAAG,IAAA,eAAY,EACxB,uDAAuD,CACxD,CAAC;AAWF;;;;;;GAMG;AACH,SAAgB,6BAA6B,CAC3C,YAAsC;IAEtC,IAAK,YAAY,CAAC,IAAqB,KAAK,6BAAY,CAAC,cAAc,EAAE;QACvE,MAAM,MAAM,GAAG,sCAAsC,CAAC;QACtD,MAAM,IAAI,6BAAoB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;KACtD;IAED,IAAI,CAAC,IAAA,8BAAc,EAAC,YAAY,CAAC,MAAM,CAAC,EAAE;QACxC,MAAM,MAAM,GAAG,gCAAgC,CAAC;QAChD,MAAM,IAAI,6BAAoB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;KACtD;IAED,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC;IACxC,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE;QAC1C,MAAM,MAAM,GAAG,8BAA8B,CAAC;QAC9C,MAAM,IAAI,6BAAoB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;KACtD;IAED,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC;IAC1C,MAAM,UAAU,GAAG,WAAW,CAAC,SAAS,CAAC;IACzC,KAAK,CAAC,2CAA2C,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAE5E,IAAI,OAAO,CAAC;IACZ,IACE,YAAY,CAAC,OAAO;QACpB,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,EAC/D;QACA,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC;KAChC;SAAM;QACL,OAAO,GAAG,IAAA,kBAAS,EAAC,UAAU,GAAG,MAAM,CAAC,CAAC;KAC1C;IAED,MAAM,gBAAgB,GAAG,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC;IAC3D,KAAK,CAAC,+BAA+B,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC;IAErE,IAAI,YAAY,CAAC,KAAK,IAAI,gBAAgB,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE;QAC9D,wEAAwE;QACxE,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE;YACjC,OAAO;SACR,CAAqC,CAAC;KACxC;IAED,MAAM,gBAAgB,GAAG,WAAW,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC;IAClE,IAAI,CAAC,gBAAgB,EAAE;QACrB,MAAM,MAAM,GAAG,GAAG,UAAU,8CAA8C,CAAC;QAC3E,MAAM,IAAI,6BAAoB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;KACtD;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,EAAC,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAC,CAAC,CAAC;AACzE,CAAC;AAlDD,sEAkDC"}

package/dist/relations/references-many/references-many.inclusion-resolver.d.ts

@@ -0,0 +1,14 @@
+import { Entity } from '../../model';
+import { EntityCrudRepository } from '../../repositories';
+import { ReferencesManyDefinition, Getter, InclusionResolver } from '../relation.types';
+/**
+ * Creates InclusionResolver for ReferencesMany relation.
+ * Notice that this function only generates the inclusionResolver.
+ * It doesn't register it for the source repository.
+ *
+ * Notice: scope field for inclusion is not supported yet
+ *
+ * @param meta - resolved ReferencesManyMetadata
+ * @param getTargetRepo - target repository i.e where related instances are
+ */
+export declare function createReferencesManyInclusionResolver<Target extends Entity, TargetIds, TargetRelations extends object>(meta: ReferencesManyDefinition, getTargetRepo: Getter<EntityCrudRepository<Target, TargetIds, TargetRelations>>): InclusionResolver<Entity, Target>;