@deenruv/core 1.0.0

package/dist/service/helpers/active-order/active-order.service.d.ts

@@ -0,0 +1,43 @@
+import { RequestContext } from "../../../api/common/request-context";
+import { ConfigService } from "../../../config/config.service";
+import { TransactionalConnection } from "../../../connection/transactional-connection";
+import { Order } from "../../../entity/order/order.entity";
+import { OrderService } from "../../services/order.service";
+import { SessionService } from "../../services/session.service";
+/**
+ * @description
+ * This helper class is used to get a reference to the active Order from the current RequestContext.
+ *
+ * @docsCategory orders
+ */
+export declare class ActiveOrderService {
+    private sessionService;
+    private orderService;
+    private connection;
+    private configService;
+    constructor(sessionService: SessionService, orderService: OrderService, connection: TransactionalConnection, configService: ConfigService);
+    /**
+     * @description
+     * Gets the active Order object from the current Session. Optionally can create a new Order if
+     * no active Order exists.
+     *
+     * Intended to be used at the Resolver layer for those resolvers that depend upon an active Order
+     * being present.
+     *
+     * @deprecated From v1.9.0, use the `getActiveOrder` method which uses any configured ActiveOrderStrategies
+     */
+    getOrderFromContext(ctx: RequestContext): Promise<Order | undefined>;
+    getOrderFromContext(ctx: RequestContext, createIfNotExists: true): Promise<Order>;
+    /**
+     * @description
+     * Retrieves the active Order based on the configured {@link ActiveOrderStrategy}.
+     *
+     * @since 1.9.0
+     */
+    getActiveOrder(ctx: RequestContext, input: {
+        [strategyName: string]: any;
+    } | undefined): Promise<Order | undefined>;
+    getActiveOrder(ctx: RequestContext, input: {
+        [strategyName: string]: any;
+    } | undefined, createIfNotExists: true): Promise<Order>;
+}

package/dist/service/helpers/active-order/active-order.service.js

@@ -0,0 +1,109 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActiveOrderService = void 0;
+const common_1 = require("@nestjs/common");
+const errors_1 = require("../../../common/error/errors");
+const config_service_1 = require("../../../config/config.service");
+const transactional_connection_1 = require("../../../connection/transactional-connection");
+const order_entity_1 = require("../../../entity/order/order.entity");
+const order_service_1 = require("../../services/order.service");
+const session_service_1 = require("../../services/session.service");
+/**
+ * @description
+ * This helper class is used to get a reference to the active Order from the current RequestContext.
+ *
+ * @docsCategory orders
+ */
+let ActiveOrderService = class ActiveOrderService {
+    constructor(sessionService, orderService, connection, configService) {
+        this.sessionService = sessionService;
+        this.orderService = orderService;
+        this.connection = connection;
+        this.configService = configService;
+    }
+    async getOrderFromContext(ctx, createIfNotExists = false) {
+        if (!ctx.session) {
+            throw new errors_1.InternalServerError("error.no-active-session");
+        }
+        let order = ctx.session.activeOrderId
+            ? await this.connection
+                .getRepository(ctx, order_entity_1.Order)
+                .createQueryBuilder("order")
+                .leftJoin("order.channels", "channel")
+                .where("order.id = :orderId", { orderId: ctx.session.activeOrderId })
+                .andWhere("channel.id = :channelId", { channelId: ctx.channelId })
+                .getOne()
+            : undefined;
+        if (order && order.active === false) {
+            // edge case where an inactive order may not have been
+            // removed from the session, i.e. the regular process was interrupted
+            await this.sessionService.unsetActiveOrder(ctx, ctx.session);
+            order = undefined;
+        }
+        if (!order) {
+            if (ctx.activeUserId) {
+                order = await this.orderService.getActiveOrderForUser(ctx, ctx.activeUserId);
+            }
+            if (!order && createIfNotExists) {
+                order = await this.orderService.create(ctx, ctx.activeUserId);
+            }
+            if (order) {
+                await this.sessionService.setActiveOrder(ctx, ctx.session, order);
+            }
+        }
+        return order || undefined;
+    }
+    async getActiveOrder(ctx, input, createIfNotExists = false) {
+        var _a;
+        let order;
+        if (!order) {
+            const { activeOrderStrategy } = this.configService.orderOptions;
+            const strategyArray = Array.isArray(activeOrderStrategy)
+                ? activeOrderStrategy
+                : [activeOrderStrategy];
+            for (const strategy of strategyArray) {
+                const strategyInput = (_a = input === null || input === void 0 ? void 0 : input[strategy.name]) !== null && _a !== void 0 ? _a : {};
+                order = await strategy.determineActiveOrder(ctx, strategyInput);
+                if (order) {
+                    break;
+                }
+                if (createIfNotExists &&
+                    typeof strategy.createActiveOrder === "function") {
+                    order = await strategy.createActiveOrder(ctx, strategyInput);
+                }
+                if (order) {
+                    break;
+                }
+            }
+            if (!order && createIfNotExists) {
+                // No order has been found, and none could be created, which indicates that
+                // none of the configured strategies have a `createActiveOrder` method defined.
+                // In this case, we should throw an error because it is assumed that such a configuration
+                // indicates that an external order creation mechanism should be defined.
+                throw new errors_1.UserInputError("error.order-could-not-be-determined-or-created");
+            }
+            if (order && ctx.session) {
+                await this.sessionService.setActiveOrder(ctx, ctx.session, order);
+            }
+        }
+        return order || undefined;
+    }
+};
+exports.ActiveOrderService = ActiveOrderService;
+exports.ActiveOrderService = ActiveOrderService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [session_service_1.SessionService,
+        order_service_1.OrderService,
+        transactional_connection_1.TransactionalConnection,
+        config_service_1.ConfigService])
+], ActiveOrderService);
+//# sourceMappingURL=active-order.service.js.map

package/dist/service/helpers/active-order/active-order.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-order.service.js","sourceRoot":"","sources":["../../../../src/service/helpers/active-order/active-order.service.ts"],"names":[],"mappings":"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"}

package/dist/service/helpers/config-arg/config-arg.service.d.ts

@@ -0,0 +1,39 @@
+import { ConfigurableOperation, ConfigurableOperationInput } from "@deenruv/common/lib/generated-types";
+import { CollectionFilter } from "../../../config/catalog/collection-filter";
+import { ConfigService } from "../../../config/config.service";
+import { EntityDuplicator } from "../../../config/entity/entity-duplicator";
+import { FulfillmentHandler } from "../../../config/fulfillment/fulfillment-handler";
+import { PaymentMethodEligibilityChecker } from "../../../config/payment/payment-method-eligibility-checker";
+import { PaymentMethodHandler } from "../../../config/payment/payment-method-handler";
+import { PromotionAction } from "../../../config/promotion/promotion-action";
+import { PromotionCondition } from "../../../config/promotion/promotion-condition";
+import { ShippingCalculator } from "../../../config/shipping-method/shipping-calculator";
+import { ShippingEligibilityChecker } from "../../../config/shipping-method/shipping-eligibility-checker";
+export type ConfigDefTypeMap = {
+    CollectionFilter: CollectionFilter;
+    EntityDuplicator: EntityDuplicator;
+    FulfillmentHandler: FulfillmentHandler;
+    PaymentMethodEligibilityChecker: PaymentMethodEligibilityChecker;
+    PaymentMethodHandler: PaymentMethodHandler;
+    PromotionAction: PromotionAction;
+    PromotionCondition: PromotionCondition;
+    ShippingCalculator: ShippingCalculator;
+    ShippingEligibilityChecker: ShippingEligibilityChecker;
+};
+export type ConfigDefType = keyof ConfigDefTypeMap;
+/**
+ * This helper class provides methods relating to ConfigurableOperationDef instances.
+ */
+export declare class ConfigArgService {
+    private configService;
+    private readonly definitionsByType;
+    constructor(configService: ConfigService);
+    getDefinitions<T extends ConfigDefType>(defType: T): Array<ConfigDefTypeMap[T]>;
+    getByCode<T extends ConfigDefType>(defType: T, code: string): ConfigDefTypeMap[T];
+    /**
+     * Parses and validates the input to a ConfigurableOperation.
+     */
+    parseInput(defType: ConfigDefType, input: ConfigurableOperationInput): ConfigurableOperation;
+    private orderArgsToMatchDef;
+    private validateRequiredFields;
+}

package/dist/service/helpers/config-arg/config-arg.service.js

@@ -0,0 +1,102 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigArgService = void 0;
+const common_1 = require("@nestjs/common");
+const errors_1 = require("../../../common/error/errors");
+const config_service_1 = require("../../../config/config.service");
+/**
+ * This helper class provides methods relating to ConfigurableOperationDef instances.
+ */
+let ConfigArgService = class ConfigArgService {
+    constructor(configService) {
+        this.configService = configService;
+        this.definitionsByType = {
+            CollectionFilter: this.configService.catalogOptions.collectionFilters,
+            EntityDuplicator: this.configService.entityOptions.entityDuplicators,
+            FulfillmentHandler: this.configService.shippingOptions.fulfillmentHandlers,
+            PaymentMethodEligibilityChecker: this.configService.paymentOptions.paymentMethodEligibilityCheckers ||
+                [],
+            PaymentMethodHandler: this.configService.paymentOptions.paymentMethodHandlers,
+            PromotionAction: this.configService.promotionOptions.promotionActions,
+            PromotionCondition: this.configService.promotionOptions.promotionConditions,
+            ShippingCalculator: this.configService.shippingOptions.shippingCalculators,
+            ShippingEligibilityChecker: this.configService.shippingOptions.shippingEligibilityCheckers,
+        };
+    }
+    getDefinitions(defType) {
+        return this.definitionsByType[defType];
+    }
+    getByCode(defType, code) {
+        const defsOfType = this.getDefinitions(defType);
+        const match = defsOfType.find((def) => def.code === code);
+        if (!match) {
+            throw new errors_1.UserInputError("error.no-configurable-operation-def-with-code-found", {
+                code,
+                type: defType,
+            });
+        }
+        return match;
+    }
+    /**
+     * Parses and validates the input to a ConfigurableOperation.
+     */
+    parseInput(defType, input) {
+        const match = this.getByCode(defType, input.code);
+        this.validateRequiredFields(input, match);
+        const orderedArgs = this.orderArgsToMatchDef(match, input.arguments);
+        return {
+            code: input.code,
+            args: orderedArgs,
+        };
+    }
+    orderArgsToMatchDef(def, args) {
+        const output = [];
+        for (const name of Object.keys(def.args)) {
+            const match = args.find((arg) => arg.name === name);
+            if (match) {
+                output.push(match);
+            }
+        }
+        return output;
+    }
+    validateRequiredFields(input, def) {
+        for (const [name, argDef] of Object.entries(def.args)) {
+            if (argDef.required) {
+                const inputArg = input.arguments.find((a) => a.name === name);
+                let valid = false;
+                try {
+                    if (["string", "ID", "datetime"].includes(argDef.type)) {
+                        valid =
+                            !!inputArg && inputArg.value !== "" && inputArg.value != null;
+                    }
+                    else {
+                        valid = !!inputArg && JSON.parse(inputArg.value) != null;
+                    }
+                }
+                catch (e) {
+                    // ignore
+                }
+                if (!valid) {
+                    throw new errors_1.UserInputError("error.configurable-argument-is-required", {
+                        name,
+                    });
+                }
+            }
+        }
+    }
+};
+exports.ConfigArgService = ConfigArgService;
+exports.ConfigArgService = ConfigArgService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [config_service_1.ConfigService])
+], ConfigArgService);
+//# sourceMappingURL=config-arg.service.js.map

package/dist/service/helpers/config-arg/config-arg.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-arg.service.js","sourceRoot":"","sources":["../../../../src/service/helpers/config-arg/config-arg.service.ts"],"names":[],"mappings":"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"}

package/dist/service/helpers/custom-field-relation/custom-field-relation.service.d.ts

@@ -0,0 +1,24 @@
+import { Type } from "@deenruv/common/lib/shared-types";
+import { RequestContext } from "../../../api/common/request-context";
+import { ConfigService } from "../../../config/config.service";
+import { HasCustomFields } from "../../../config/custom-field/custom-field-types";
+import { TransactionalConnection } from "../../../connection/transactional-connection";
+import { DeenruvEntity } from "../../../entity/base/base.entity";
+export declare class CustomFieldRelationService {
+    private connection;
+    private configService;
+    constructor(connection: TransactionalConnection, configService: ConfigService);
+    /**
+     * @description
+     * If the entity being created or updated has any custom fields of type `relation`, this
+     * method will get the values from the input object and persist those relations in the
+     * database.
+     */
+    updateRelations<T extends HasCustomFields & DeenruvEntity>(ctx: RequestContext, entityType: Type<T>, input: {
+        customFields?: {
+            [key: string]: any;
+        };
+    }, entity: T): Promise<T>;
+    private isRelationalType;
+    private isId;
+}

package/dist/service/helpers/custom-field-relation/custom-field-relation.service.js

@@ -0,0 +1,86 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomFieldRelationService = void 0;
+const common_1 = require("@nestjs/common");
+const pick_1 = require("@deenruv/common/lib/pick");
+const shared_utils_1 = require("@deenruv/common/lib/shared-utils");
+const typeorm_1 = require("typeorm");
+const config_service_1 = require("../../../config/config.service");
+const transactional_connection_1 = require("../../../connection/transactional-connection");
+let CustomFieldRelationService = class CustomFieldRelationService {
+    constructor(connection, configService) {
+        this.connection = connection;
+        this.configService = configService;
+    }
+    /**
+     * @description
+     * If the entity being created or updated has any custom fields of type `relation`, this
+     * method will get the values from the input object and persist those relations in the
+     * database.
+     */
+    async updateRelations(ctx, entityType, input, entity) {
+        if (input.customFields) {
+            const relationCustomFields = this.configService.customFields[entityType.name].filter(this.isRelationalType);
+            for (const field of relationCustomFields) {
+                const inputIdName = (0, shared_utils_1.getGraphQlInputName)(field);
+                const idOrIds = input.customFields[inputIdName];
+                if (idOrIds !== undefined) {
+                    let relations;
+                    if (idOrIds === null) {
+                        // an explicitly `null` value means remove the relation
+                        relations = null;
+                    }
+                    else if (field.list &&
+                        Array.isArray(idOrIds) &&
+                        idOrIds.every((id) => this.isId(id))) {
+                        relations = await this.connection
+                            .getRepository(ctx, field.entity)
+                            .findBy({ id: (0, typeorm_1.In)(idOrIds) });
+                    }
+                    else if (!field.list && this.isId(idOrIds)) {
+                        relations = await this.connection
+                            .getRepository(ctx, field.entity)
+                            .findOne({ where: { id: idOrIds } });
+                    }
+                    if (relations !== undefined) {
+                        const entityWithCustomFields = await this.connection
+                            .getRepository(ctx, entityType)
+                            .findOne({
+                            where: { id: entity.id },
+                            loadEagerRelations: false,
+                        });
+                        entity.customFields = Object.assign(Object.assign(Object.assign({}, entity.customFields), entityWithCustomFields === null || entityWithCustomFields === void 0 ? void 0 : entityWithCustomFields.customFields), { [field.name]: relations });
+                        await this.connection
+                            .getRepository(ctx, entityType)
+                            .save((0, pick_1.pick)(entity, ["id", "customFields"]), {
+                            reload: false,
+                        });
+                    }
+                }
+            }
+        }
+        return entity;
+    }
+    isRelationalType(input) {
+        return input.type === "relation";
+    }
+    isId(input) {
+        return typeof input === "string" || typeof input === "number";
+    }
+};
+exports.CustomFieldRelationService = CustomFieldRelationService;
+exports.CustomFieldRelationService = CustomFieldRelationService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [transactional_connection_1.TransactionalConnection,
+        config_service_1.ConfigService])
+], CustomFieldRelationService);
+//# sourceMappingURL=custom-field-relation.service.js.map

package/dist/service/helpers/custom-field-relation/custom-field-relation.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-field-relation.service.js","sourceRoot":"","sources":["../../../../src/service/helpers/custom-field-relation/custom-field-relation.service.ts"],"names":[],"mappings":"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"}

package/dist/service/helpers/entity-duplicator/entity-duplicator.service.d.ts

@@ -0,0 +1,30 @@
+import { DuplicateEntityInput, DuplicateEntityResult, EntityDuplicatorDefinition } from "@deenruv/common/lib/generated-types";
+import { RequestContext } from "../../../api/common/request-context";
+import { ConfigService } from "../../../config/config.service";
+import { TransactionalConnection } from "../../../connection/transactional-connection";
+import { ConfigArgService } from "../config-arg/config-arg.service";
+/**
+ * @description
+ * This service is used to duplicate entities using one of the configured
+ * {@link EntityDuplicator} functions.
+ *
+ * @docsCategory service-helpers
+ * @since 2.2.0
+ */
+export declare class EntityDuplicatorService {
+    private configService;
+    private configArgService;
+    private connection;
+    constructor(configService: ConfigService, configArgService: ConfigArgService, connection: TransactionalConnection);
+    /**
+     * @description
+     * Returns all configured {@link EntityDuplicator} definitions.
+     */
+    getEntityDuplicators(ctx: RequestContext): EntityDuplicatorDefinition[];
+    /**
+     * @description
+     * Duplicates an entity using the specified {@link EntityDuplicator}. The duplication is performed
+     * within a transaction, so if an error occurs, the transaction will be rolled back.
+     */
+    duplicateEntity(ctx: RequestContext, input: DuplicateEntityInput): Promise<DuplicateEntityResult>;
+}

package/dist/service/helpers/entity-duplicator/entity-duplicator.service.js

@@ -0,0 +1,94 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityDuplicatorService = void 0;
+const common_1 = require("@nestjs/common");
+const generated_graphql_admin_errors_1 = require("../../../common/error/generated-graphql-admin-errors");
+const config_service_1 = require("../../../config/config.service");
+const deenruv_logger_1 = require("../../../config/logger/deenruv-logger");
+const transactional_connection_1 = require("../../../connection/transactional-connection");
+const config_arg_service_1 = require("../config-arg/config-arg.service");
+/**
+ * @description
+ * This service is used to duplicate entities using one of the configured
+ * {@link EntityDuplicator} functions.
+ *
+ * @docsCategory service-helpers
+ * @since 2.2.0
+ */
+let EntityDuplicatorService = class EntityDuplicatorService {
+    constructor(configService, configArgService, connection) {
+        this.configService = configService;
+        this.configArgService = configArgService;
+        this.connection = connection;
+    }
+    /**
+     * @description
+     * Returns all configured {@link EntityDuplicator} definitions.
+     */
+    getEntityDuplicators(ctx) {
+        return this.configArgService
+            .getDefinitions("EntityDuplicator")
+            .map((x) => (Object.assign(Object.assign({}, x.toGraphQlType(ctx)), { __typename: "EntityDuplicatorDefinition", forEntities: x.forEntities, requiresPermission: x.requiresPermission })));
+    }
+    /**
+     * @description
+     * Duplicates an entity using the specified {@link EntityDuplicator}. The duplication is performed
+     * within a transaction, so if an error occurs, the transaction will be rolled back.
+     */
+    async duplicateEntity(ctx, input) {
+        const duplicator = this.configService.entityOptions.entityDuplicators.find((s) => s.forEntities.includes(input.entityName) &&
+            s.code === input.duplicatorInput.code);
+        if (!duplicator) {
+            return new generated_graphql_admin_errors_1.DuplicateEntityError({
+                duplicationError: ctx.translate(`message.entity-duplication-no-strategy-found`, {
+                    entityName: input.entityName,
+                    code: input.duplicatorInput.code,
+                }),
+            });
+        }
+        // Check permissions
+        if (duplicator.requiresPermission.length === 0 ||
+            !ctx.userHasPermissions(duplicator.requiresPermission)) {
+            return new generated_graphql_admin_errors_1.DuplicateEntityError({
+                duplicationError: ctx.translate(`message.entity-duplication-no-permission`),
+            });
+        }
+        const parsedInput = this.configArgService.parseInput("EntityDuplicator", input.duplicatorInput);
+        return await this.connection.withTransaction(ctx, async (innerCtx) => {
+            var _a;
+            try {
+                const newEntity = await duplicator.duplicate({
+                    ctx: innerCtx,
+                    entityName: input.entityName,
+                    id: input.entityId,
+                    args: parsedInput.args,
+                });
+                return { newEntityId: newEntity.id };
+            }
+            catch (e) {
+                await this.connection.rollBackTransaction(innerCtx);
+                deenruv_logger_1.Logger.error(e.message, undefined, e.stack);
+                return new generated_graphql_admin_errors_1.DuplicateEntityError({
+                    duplicationError: (_a = e.message) !== null && _a !== void 0 ? _a : e.toString(),
+                });
+            }
+        });
+    }
+};
+exports.EntityDuplicatorService = EntityDuplicatorService;
+exports.EntityDuplicatorService = EntityDuplicatorService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [config_service_1.ConfigService,
+        config_arg_service_1.ConfigArgService,
+        transactional_connection_1.TransactionalConnection])
+], EntityDuplicatorService);
+//# sourceMappingURL=entity-duplicator.service.js.map

package/dist/service/helpers/entity-duplicator/entity-duplicator.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-duplicator.service.js","sourceRoot":"","sources":["../../../../src/service/helpers/entity-duplicator/entity-duplicator.service.ts"],"names":[],"mappings":"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"}

package/dist/service/helpers/entity-hydrator/entity-hydrator-types.d.ts

@@ -0,0 +1,28 @@
+import { EntityRelationPaths } from "../../../common/types/entity-relation-paths";
+import { DeenruvEntity } from "../../../entity/base/base.entity";
+/**
+ * @description
+ * Options used to control which relations of the entity get hydrated
+ * when using the {@link EntityHydrator} helper.
+ *
+ * @since 1.3.0
+ * @docsCategory data-access
+ */
+export interface HydrateOptions<Entity extends DeenruvEntity> {
+    /**
+     * @description
+     * Defines the relations to hydrate, using strings with dot notation to indicate
+     * nested joins. If the entity already has a particular relation available, that relation
+     * will be skipped (no extra DB join will be added).
+     */
+    relations: Array<EntityRelationPaths<Entity>>;
+    /**
+     * @description
+     * If set to `true`, any ProductVariants will also have their `price` and `priceWithTax` fields
+     * applied based on the current context. If prices are not required, this can be left `false` which
+     * will be slightly more efficient.
+     *
+     * @default false
+     */
+    applyProductVariantPrices?: boolean;
+}

package/dist/service/helpers/entity-hydrator/entity-hydrator-types.js

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

package/dist/service/helpers/entity-hydrator/entity-hydrator-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-hydrator-types.js","sourceRoot":"","sources":["../../../../src/service/helpers/entity-hydrator/entity-hydrator-types.ts"],"names":[],"mappings":""}