// Copyright IBM Corp. and LoopBack contributors 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 import debugFactory from 'debug'; import {DataObject} from '../../common-types'; import {Entity} from '../../model'; import {EntityCrudRepository} from '../../repositories'; import {Getter, HasManyDefinition, InclusionResolver} from '../relation.types'; import {resolveHasManyMetadata} from './has-many.helpers'; import {createHasManyInclusionResolver} from './has-many.inclusion-resolver'; import { DefaultHasManyRepository, HasManyRepository, } from './has-many.repository'; const debug = debugFactory( 'loopback:repository:relations:has-many:repository-factory', ); export interface HasManyRepositoryFactory< Target extends Entity, ForeignKeyType, > { /** * Invoke the function to obtain HasManyRepository. */ (fkValue: ForeignKeyType): HasManyRepository; /** * Use `resolver` property to obtain an InclusionResolver for this relation. */ inclusionResolver: InclusionResolver; } /** * Enforces a constraint on a repository based on a relationship contract * between models. For example, if a Customer model is related to an Order model * via a HasMany relation, then, the relational repository returned by the * factory function would be constrained by a Customer model instance's id(s). * * @param relationMetadata - The relation metadata used to describe the * relationship and determine how to apply the constraint. * @param targetRepositoryGetter - The repository which represents the target model of a * relation attached to a datasource. * @returns The factory function which accepts a foreign key value to constrain * the given target repository */ export function createHasManyRepositoryFactory< Target extends Entity, TargetID, ForeignKeyType, >( relationMetadata: HasManyDefinition, targetRepositoryGetter: Getter>, ): HasManyRepositoryFactory { const meta = resolveHasManyMetadata(relationMetadata); debug('Resolved HasMany relation metadata: %o', meta); const result: HasManyRepositoryFactory = function ( fkValue: ForeignKeyType, ) { // eslint-disable-next-line @typescript-eslint/no-explicit-any const constraint: any = {[meta.keyTo]: fkValue}; return new DefaultHasManyRepository< Target, TargetID, EntityCrudRepository >(targetRepositoryGetter, constraint as DataObject); }; result.inclusionResolver = createHasManyInclusionResolver( meta, targetRepositoryGetter, ); return result; }