EntityHydrator

@vendure/core Sourcev1.3.0

This is a helper class which is used to "hydrate" entity instances, which means to populate them with the specified relations. This is useful when writing plugin code which receives an entity, and you need to ensure that one or more relations are present.

Example

import { Injectable } from '@nestjs/common';import { ID, RequestContext, EntityHydrator, ProductVariantService } from '@vendure/core';@Injectable()export class MyService {  constructor(     private entityHydrator: EntityHydrator, // [!code highlight]     private productVariantService: ProductVariantService,  ) {}  myMethod(ctx: RequestContext, variantId: ID) {    const product = await this.productVariantService      .getProductForVariant(ctx, variantId);    // at this stage, we don't know which of the Product relations    // will be joined at runtime.    await this.entityHydrator // [!code highlight]      .hydrate(ctx, product, { relations: ['facetValues.facet' ]}); // [!code highlight]    // You can be sure now that the `facetValues` & `facetValues.facet` relations are populated // [!code highlight]  }}

In this above example, the product instance will now have the facetValues relation available, and those FacetValues will have their facet relations joined too.

This hydrate method will also automatically take care or translating any translatable entities (e.g. Product, Collection, Facet), and if the applyProductVariantPrices options is used (see HydrateOptions), any related ProductVariant will have the correct Channel-specific prices applied to them.

Custom field relations may also be hydrated:

Example

const customer = await this.customerService  .findOne(ctx, id);await this.entityHydrator  .hydrate(ctx, customer, { relations: ['customFields.avatar' ]});

Signature

class EntityHydrator {    constructor(connection: TransactionalConnection, productPriceApplicator: ProductPriceApplicator, translator: TranslatorService)    hydrate(ctx: RequestContext, target: Entity, options: HydrateOptions<Entity>) => Promise<Entity>;}

constructor

method

(connection: TransactionalConnection, productPriceApplicator: ProductPriceApplicator, translator: TranslatorService) => EntityHydrator

hydrate

method(ctx: RequestContext, target: Entity, options: HydrateOptions<Entity>) => Promise<Entity>v1.3.0

Hydrates (joins) the specified relations to the target entity instance. This method mutates the target entity.

Example

await this.entityHydrator.hydrate(ctx, product, {  relations: [    'variants.stockMovements'    'optionGroups.options',    'featuredAsset',  ],  applyProductVariantPrices: true,});