@loopback/repository 3.5.1 → 3.7.2

package/src/relations/belongs-to/belongs-to.accessor.ts

@@ -37,7 +37,7 @@ export function createBelongsToAccessor<
   Target extends Entity,
   TargetId,
   Source extends Entity,
-  SourceId
+  SourceId,
 >(
   belongsToMetadata: BelongsToDefinition,
   targetRepoGetter: Getter<EntityCrudRepository<Target, TargetId>>,
@@ -45,28 +45,26 @@ export function createBelongsToAccessor<
 ): BelongsToAccessor<Target, SourceId> {
   const meta = resolveBelongsToMetadata(belongsToMetadata);
   debug('Resolved BelongsTo relation metadata: %o', meta);
-  const result: BelongsToAccessor<
-    Target,
-    SourceId
-  > = async function getTargetInstanceOfBelongsTo(sourceId: SourceId) {
-    const foreignKey = meta.keyFrom;
-    const primaryKey = meta.keyTo;
-    const sourceModel = await sourceRepository.findById(sourceId);
-    const foreignKeyValue = sourceModel[foreignKey as keyof Source];
-    // workaround to check referential integrity.
-    // should be removed once the memory connector ref integrity is done
-    // GH issue: https://github.com/strongloop/loopback-next/issues/2333
-    if (!foreignKeyValue) {
-      return (undefined as unknown) as Target;
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const constraint: any = {[primaryKey]: foreignKeyValue};
-    const constrainedRepo = new DefaultBelongsToRepository(
-      targetRepoGetter,
-      constraint as DataObject<Target>,
-    );
-    return constrainedRepo.get();
-  };
+  const result: BelongsToAccessor<Target, SourceId> =
+    async function getTargetInstanceOfBelongsTo(sourceId: SourceId) {
+      const foreignKey = meta.keyFrom;
+      const primaryKey = meta.keyTo;
+      const sourceModel = await sourceRepository.findById(sourceId);
+      const foreignKeyValue = sourceModel[foreignKey as keyof Source];
+      // 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 as unknown as Target;
+      }
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      const constraint: any = {[primaryKey]: foreignKeyValue};
+      const constrainedRepo = new DefaultBelongsToRepository(
+        targetRepoGetter,
+        constraint as DataObject<Target>,
+      );
+      return constrainedRepo.get();
+    };
 
   result.inclusionResolver = createBelongsToInclusionResolver(
     meta,

package/src/relations/belongs-to/belongs-to.inclusion-resolver.ts

@@ -33,7 +33,7 @@ import {resolveBelongsToMetadata} from './belongs-to.helpers';
 export function createBelongsToInclusionResolver<
   Target extends Entity,
   TargetID,
-  TargetRelations extends object
+  TargetRelations extends object,
 >(
   meta: BelongsToDefinition,
   getTargetRepo: Getter<

package/src/relations/belongs-to/belongs-to.repository.ts

@@ -25,8 +25,9 @@ export interface BelongsToRepository<Target extends Entity> {
 export class DefaultBelongsToRepository<
   TargetEntity extends Entity,
   TargetId,
-  TargetRepository extends EntityCrudRepository<TargetEntity, TargetId>
-> implements BelongsToRepository<TargetEntity> {
+  TargetRepository extends EntityCrudRepository<TargetEntity, TargetId>,
+> implements BelongsToRepository<TargetEntity>
+{
   /**
    * Constructor of DefaultBelongsToEntityCrudRepository
    * @param getTargetRepository - the getter of the related target model repository instance

package/src/relations/has-many/has-many-through.helpers.ts

@@ -68,7 +68,7 @@ export type HasManyThroughResolvedDefinition = HasManyDefinition & {
  */
 export function createTargetConstraintFromThrough<
   Target extends Entity,
-  Through extends Entity
+  Through extends Entity,
 >(
   relationMeta: HasManyThroughResolvedDefinition,
   throughInstances: Through[],
@@ -125,7 +125,7 @@ export function createTargetConstraintFromThrough<
  */
 export function getTargetKeysFromThroughModels<
   Through extends Entity,
-  TargetID
+  TargetID,
 >(
   relationMeta: HasManyThroughResolvedDefinition,
   throughInstances: Through[],
@@ -166,7 +166,7 @@ export function getTargetKeysFromThroughModels<
  */
 export function createThroughConstraintFromSource<
   Through extends Entity,
-  SourceID
+  SourceID,
 >(
   relationMeta: HasManyThroughResolvedDefinition,
   fkValue: SourceID,
@@ -254,7 +254,7 @@ export function getTargetIdsFromTargetModels<Target extends Entity, TargetID>(
  */
 export function createThroughConstraintFromTarget<
   Through extends Entity,
-  TargetID
+  TargetID,
 >(
   relationMeta: HasManyThroughResolvedDefinition,
   fkValues: TargetID[],

package/src/relations/has-many/has-many-through.inclusion-resolver.ts

@@ -38,7 +38,7 @@ export function createHasManyThroughInclusionResolver<
   ThroughRelations extends object,
   Target extends Entity,
   TargetID,
-  TargetRelations extends object
+  TargetRelations extends object,
 >(
   meta: HasManyDefinition,
   getThroughRepo: Getter<
@@ -118,7 +118,7 @@ export function createHasManyThroughInclusionResolver<
           Target,
           TargetRelations,
           StringKeyOf<Target>
-        >(targetRepo, targetKey, (targetIds as unknown) as [], scope, options);
+        >(targetRepo, targetKey, targetIds as unknown as [], scope, options);
         result.push(targetEntityList);
       } else {
         // no entities found, add undefined to results

package/src/relations/has-many/has-many-through.repository-factory.ts

@@ -37,7 +37,7 @@ export type HasManyThroughRepositoryFactory<
   TargetEntity extends Entity,
   TargetID,
   ThroughEntity extends Entity,
-  SourceID
+  SourceID,
 > = {
   (fkValue: SourceID): HasManyThroughRepository<
     TargetEntity,
@@ -56,7 +56,7 @@ export function createHasManyThroughRepositoryFactory<
   TargetID,
   Through extends Entity,
   ThroughID,
-  SourceID
+  SourceID,
 >(
   relationMetadata: HasManyDefinition,
   targetRepositoryGetter: Getter<EntityCrudRepository<Target, TargetID>>,

package/src/relations/has-many/has-many-through.repository.ts

@@ -27,7 +27,7 @@ import {
 export interface HasManyThroughRepository<
   Target extends Entity,
   TargetID,
-  Through extends Entity
+  Through extends Entity,
 > {
   /**
    * Create a target model instance
@@ -110,6 +110,17 @@ export interface HasManyThroughRepository<
       throughOptions?: Options;
     },
   ): Promise<void>;
+
+  /**
+   * Remove all association to an existing target model instance
+   * @param options
+   * @return A promise which resolves to void
+   */
+  unlinkAll(
+    options?: Options & {
+      throughOptions?: Options;
+    },
+  ): Promise<void>;
 }
 
 /**
@@ -125,8 +136,9 @@ export class DefaultHasManyThroughRepository<
   TargetRepository extends EntityCrudRepository<TargetEntity, TargetID>,
   ThroughEntity extends Entity,
   ThroughID,
-  ThroughRepository extends EntityCrudRepository<ThroughEntity, ThroughID>
-> implements HasManyThroughRepository<TargetEntity, TargetID, ThroughEntity> {
+  ThroughRepository extends EntityCrudRepository<ThroughEntity, ThroughID>,
+> implements HasManyThroughRepository<TargetEntity, TargetID, ThroughEntity>
+{
   constructor(
     public getTargetRepository: Getter<TargetRepository>,
     public getThroughRepository: Getter<ThroughRepository>,
@@ -170,9 +182,8 @@ export class DefaultHasManyThroughRepository<
       constrainFilter(undefined, sourceConstraint),
       options?.throughOptions,
     );
-    const targetConstraint = this.getTargetConstraintFromThroughModels(
-      throughInstances,
-    );
+    const targetConstraint =
+      this.getTargetConstraintFromThroughModels(throughInstances);
     return targetRepository.find(
       constrainFilter(filter, targetConstraint),
       options,
@@ -210,17 +221,15 @@ export class DefaultHasManyThroughRepository<
       // otherwise, delete through models that relate to the sourceId
       const targetFkValues = this.getTargetKeys(throughInstances);
       // delete through instances that have the targets that are going to be deleted
-      const throughFkConstraint = this.getThroughConstraintFromTarget(
-        targetFkValues,
-      );
+      const throughFkConstraint =
+        this.getThroughConstraintFromTarget(targetFkValues);
       await throughRepository.deleteAll(
         constrainWhereOr({}, [sourceConstraint, throughFkConstraint]),
       );
     }
     // delete target(s)
-    const targetConstraint = this.getTargetConstraintFromThroughModels(
-      throughInstances,
-    );
+    const targetConstraint =
+      this.getTargetConstraintFromThroughModels(throughInstances);
     return targetRepository.deleteAll(
       constrainWhere(where, targetConstraint as Where<TargetEntity>),
       options,
@@ -241,9 +250,8 @@ export class DefaultHasManyThroughRepository<
       constrainFilter(undefined, sourceConstraint),
       options?.throughOptions,
     );
-    const targetConstraint = this.getTargetConstraintFromThroughModels(
-      throughInstances,
-    );
+    const targetConstraint =
+      this.getTargetConstraintFromThroughModels(throughInstances);
     return targetRepository.updateAll(
       constrainDataObject(dataObject, targetConstraint),
       constrainWhere(where, targetConstraint as Where<TargetEntity>),
@@ -286,4 +294,25 @@ export class DefaultHasManyThroughRepository<
       options?.throughOptions,
     );
   }
+
+  async unlinkAll(
+    options?: Options & {
+      throughOptions?: Options;
+    },
+  ): Promise<void> {
+    const throughRepository = await this.getThroughRepository();
+    const sourceConstraint = this.getThroughConstraintFromSource();
+    const throughInstances = await throughRepository.find(
+      constrainFilter(undefined, sourceConstraint),
+      options?.throughOptions,
+    );
+    const targetFkValues = this.getTargetKeys(throughInstances);
+    const targetConstraint =
+      this.getThroughConstraintFromTarget(targetFkValues);
+    const constraints = {...targetConstraint, ...sourceConstraint};
+    await throughRepository.deleteAll(
+      constrainDataObject({}, constraints as DataObject<ThroughEntity>),
+      options?.throughOptions,
+    );
+  }
 }

package/src/relations/has-many/has-many.inclusion-resolver.ts

@@ -33,7 +33,7 @@ const debug = debugFactory(
 export function createHasManyInclusionResolver<
   Target extends Entity,
   TargetID,
-  TargetRelations extends object
+  TargetRelations extends object,
 >(
   meta: HasManyDefinition,
   getTargetRepo: Getter<

package/src/relations/has-many/has-many.repository-factory.ts

@@ -21,7 +21,7 @@ const debug = debugFactory(
 
 export interface HasManyRepositoryFactory<
   Target extends Entity,
-  ForeignKeyType
+  ForeignKeyType,
 > {
   /**
    * Invoke the function to obtain HasManyRepository.
@@ -50,7 +50,7 @@ export interface HasManyRepositoryFactory<
 export function createHasManyRepositoryFactory<
   Target extends Entity,
   TargetID,
-  ForeignKeyType
+  ForeignKeyType,
 >(
   relationMetadata: HasManyDefinition,
   targetRepositoryGetter: Getter<EntityCrudRepository<Target, TargetID>>,

package/src/relations/has-many/has-many.repository.ts

@@ -59,8 +59,9 @@ export interface HasManyRepository<Target extends Entity> {
 export class DefaultHasManyRepository<
   TargetEntity extends Entity,
   TargetID,
-  TargetRepository extends EntityCrudRepository<TargetEntity, TargetID>
-> implements HasManyRepository<TargetEntity> {
+  TargetRepository extends EntityCrudRepository<TargetEntity, TargetID>,
+> implements HasManyRepository<TargetEntity>
+{
   /**
    * Constructor of DefaultHasManyEntityCrudRepository
    * @param getTargetRepository - the getter of the related target model repository instance

package/src/relations/has-one/has-one.inclusion-resolver.ts

@@ -28,7 +28,7 @@ import {resolveHasOneMetadata} from './has-one.helpers';
 export function createHasOneInclusionResolver<
   Target extends Entity,
   TargetID,
-  TargetRelations extends object
+  TargetRelations extends object,
 >(
   meta: HasOneDefinition,
   getTargetRepo: Getter<

package/src/relations/has-one/has-one.repository-factory.ts

@@ -18,7 +18,7 @@ const debug = debugFactory(
 
 export interface HasOneRepositoryFactory<
   Target extends Entity,
-  ForeignKeyType
+  ForeignKeyType,
 > {
   /**
    * Invoke the function to obtain HasOneRepository.
@@ -46,7 +46,7 @@ export interface HasOneRepositoryFactory<
 export function createHasOneRepositoryFactory<
   Target extends Entity,
   TargetID,
-  ForeignKeyType
+  ForeignKeyType,
 >(
   relationMetadata: HasOneDefinition,
   targetRepositoryGetter: Getter<EntityCrudRepository<Target, TargetID>>,

package/src/relations/has-one/has-one.repository.ts

@@ -61,8 +61,9 @@ export interface HasOneRepository<Target extends Entity> {
 export class DefaultHasOneRepository<
   TargetEntity extends Entity,
   TargetID,
-  TargetRepository extends EntityCrudRepository<TargetEntity, TargetID>
-> implements HasOneRepository<TargetEntity> {
+  TargetRepository extends EntityCrudRepository<TargetEntity, TargetID>,
+> implements HasOneRepository<TargetEntity>
+{
   /**
    * Constructor of DefaultHasOneEntityCrudRepository
    * @param getTargetRepository - the getter of the related target model repository instance

package/src/relations/relation.helpers.ts

@@ -30,7 +30,7 @@ const debug = debugFactory('loopback:repository:relation-helpers');
 export async function findByForeignKeys<
   Target extends Entity,
   TargetRelations extends object,
-  ForeignKey extends StringKeyOf<Target>
+  ForeignKey extends StringKeyOf<Target>,
 >(
   targetRepository: EntityCrudRepository<Target, unknown, TargetRelations>,
   fkName: ForeignKey,
@@ -48,7 +48,7 @@ export async function findByForeignKeys<
     value = fkValues;
   }
 
-  const where = ({[fkName]: value} as unknown) as Where<Target>;
+  const where = {[fkName]: value} as unknown as Where<Target>;
 
   if (scope && !_.isEmpty(scope)) {
     // combine where clause to scope filter
@@ -74,7 +74,7 @@ export type StringKeyOf<T> = Extract<keyof T, string>;
 
 export async function includeRelatedModels<
   T extends Entity,
-  Relations extends object = {}
+  Relations extends object = {},
 >(
   targetRepository: EntityCrudRepository<T, unknown, Relations>,
   entities: T[],

package/src/repositories/kv.repository.bridge.ts

@@ -13,7 +13,8 @@ import {ensurePromise, juggler} from './legacy-juggler-bridge';
  * An implementation of KeyValueRepository based on loopback-datasource-juggler
  */
 export class DefaultKeyValueRepository<T extends Model>
-  implements KeyValueRepository<T> {
+  implements KeyValueRepository<T>
+{
   /**
    * A legacy KeyValueModel class
    */
@@ -29,9 +30,8 @@ export class DefaultKeyValueRepository<T extends Model>
   ) {
     // KVModel class is placeholder to receive methods from KeyValueAccessObject
     // through mixin
-    this.kvModelClass = ds.createModel<typeof juggler.KeyValueModel>(
-      '_kvModel',
-    );
+    this.kvModelClass =
+      ds.createModel<typeof juggler.KeyValueModel>('_kvModel');
   }
 
   delete(key: string, options?: Options): Promise<void> {

package/src/repositories/legacy-juggler-bridge.ts

@@ -111,8 +111,9 @@ export function ensurePromise<T>(p: legacy.PromiseOrVoid<T>): Promise<T> {
 export class DefaultCrudRepository<
   T extends Entity,
   ID,
-  Relations extends object = {}
-> implements EntityCrudRepository<T, ID, Relations> {
+  Relations extends object = {},
+> implements EntityCrudRepository<T, ID, Relations>
+{
   modelClass: juggler.PersistedModelClass;
 
   public readonly inclusionResolvers: Map<
@@ -236,7 +237,7 @@ export class DefaultCrudRepository<
   protected _createHasManyRepositoryFactoryFor<
     Target extends Entity,
     TargetID,
-    ForeignKeyType
+    ForeignKeyType,
   >(
     relationName: string,
     targetRepoGetter: Getter<EntityCrudRepository<Target, TargetID>>,
@@ -278,7 +279,7 @@ export class DefaultCrudRepository<
   protected createHasManyRepositoryFactoryFor<
     Target extends Entity,
     TargetID,
-    ForeignKeyType
+    ForeignKeyType,
   >(
     relationName: string,
     targetRepoGetter: Getter<EntityCrudRepository<Target, TargetID>>,
@@ -325,7 +326,7 @@ export class DefaultCrudRepository<
     TargetID,
     Through extends Entity,
     ThroughID,
-    ForeignKeyType
+    ForeignKeyType,
   >(
     relationName: string,
     targetRepoGetter: Getter<EntityCrudRepository<Target, TargetID>>,
@@ -390,7 +391,7 @@ export class DefaultCrudRepository<
   protected _createHasOneRepositoryFactoryFor<
     Target extends Entity,
     TargetID,
-    ForeignKeyType
+    ForeignKeyType,
   >(
     relationName: string,
     targetRepoGetter: Getter<EntityCrudRepository<Target, TargetID>>,
@@ -410,7 +411,7 @@ export class DefaultCrudRepository<
   protected createHasOneRepositoryFactoryFor<
     Target extends Entity,
     TargetID,
-    ForeignKeyType
+    ForeignKeyType,
   >(
     relationName: string,
     targetRepoGetter: Getter<EntityCrudRepository<Target, TargetID>>,
@@ -770,10 +771,11 @@ export class DefaultCrudRepository<
 export class DefaultTransactionalRepository<
     T extends Entity,
     ID,
-    Relations extends object = {}
+    Relations extends object = {},
   >
   extends DefaultCrudRepository<T, ID, Relations>
-  implements TransactionalEntityRepository<T, ID, Relations> {
+  implements TransactionalEntityRepository<T, ID, Relations>
+{
   async beginTransaction(
     options?: IsolationLevel | Options,
   ): Promise<Transaction> {

package/src/repositories/repository.ts

@@ -46,7 +46,7 @@ export interface ExecutableRepository<T extends Model> extends Repository<T> {
 export type TransactionalEntityRepository<
   T extends Entity,
   ID,
-  Relations extends object = {}
+  Relations extends object = {},
 > = TransactionalRepository<T> & EntityCrudRepository<T, ID>;
 /**
  * Repository Interface for Repositories that support Transactions
@@ -69,7 +69,7 @@ export interface TransactionalRepository<T extends Entity>
  */
 export interface CrudRepository<
   T extends ValueObject | Entity,
-  Relations extends object = {}
+  Relations extends object = {},
 > extends Repository<T> {
   /**
    * Create a new record
@@ -137,7 +137,7 @@ export interface EntityRepository<T extends Entity, ID>
 export interface EntityCrudRepository<
   T extends Entity,
   ID,
-  Relations extends object = {}
+  Relations extends object = {},
 > extends EntityRepository<T, ID>,
     CrudRepository<T, Relations> {
   // entityClass should have type "typeof T", but that's not supported by TSC
@@ -254,7 +254,8 @@ export interface EntityCrudRepository<
  * ```
  */
 export class CrudRepositoryImpl<T extends Entity, ID>
-  implements EntityCrudRepository<T, ID> {
+  implements EntityCrudRepository<T, ID>
+{
   private connector: CrudConnector;
   public readonly inclusionResolvers: Map<
     string,

package/src/type-resolver.ts

@@ -26,7 +26,7 @@ import {Class} from './common-types';
  */
 export type TypeResolver<
   Type extends Object,
-  StaticMembers = Function
+  StaticMembers = Function,
 > = () => Class<Type> & StaticMembers;
 
 /**