@deenruv/core 1.0.0

package/dist/service/services/product-option-group.service.js

@@ -0,0 +1,205 @@
+"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.ProductOptionGroupService = void 0;
+const common_1 = require("@nestjs/common");
+const generated_types_1 = require("@deenruv/common/lib/generated-types");
+const typeorm_1 = require("typeorm");
+const utils_1 = require("../../common/utils");
+const deenruv_logger_1 = require("../../config/logger/deenruv-logger");
+const transactional_connection_1 = require("../../connection/transactional-connection");
+const product_entity_1 = require("../../entity/product/product.entity");
+const product_option_group_translation_entity_1 = require("../../entity/product-option-group/product-option-group-translation.entity");
+const product_option_group_entity_1 = require("../../entity/product-option-group/product-option-group.entity");
+const product_variant_entity_1 = require("../../entity/product-variant/product-variant.entity");
+const event_bus_1 = require("../../event-bus");
+const product_option_group_event_1 = require("../../event-bus/events/product-option-group-event");
+const custom_field_relation_service_1 = require("../helpers/custom-field-relation/custom-field-relation.service");
+const translatable_saver_1 = require("../helpers/translatable-saver/translatable-saver");
+const translator_service_1 = require("../helpers/translator/translator.service");
+const product_option_service_1 = require("./product-option.service");
+/**
+ * @description
+ * Contains methods relating to {@link ProductOptionGroup} entities.
+ *
+ * @docsCategory services
+ */
+let ProductOptionGroupService = class ProductOptionGroupService {
+    constructor(connection, translatableSaver, customFieldRelationService, productOptionService, eventBus, translator) {
+        this.connection = connection;
+        this.translatableSaver = translatableSaver;
+        this.customFieldRelationService = customFieldRelationService;
+        this.productOptionService = productOptionService;
+        this.eventBus = eventBus;
+        this.translator = translator;
+    }
+    findAll(ctx, filterTerm, relations) {
+        const findOptions = {
+            relations: relations !== null && relations !== void 0 ? relations : ["options"],
+        };
+        if (filterTerm) {
+            findOptions.where = {
+                code: (0, typeorm_1.Like)(`%${filterTerm}%`),
+            };
+        }
+        return this.connection
+            .getRepository(ctx, product_option_group_entity_1.ProductOptionGroup)
+            .find(findOptions)
+            .then((groups) => groups.map((group) => this.translator.translate(group, ctx, ["options"])));
+    }
+    findOne(ctx, id, relations) {
+        return this.connection
+            .getRepository(ctx, product_option_group_entity_1.ProductOptionGroup)
+            .findOne({
+            where: { id },
+            relations: relations !== null && relations !== void 0 ? relations : ["options"],
+        })
+            .then((group) => {
+            var _a;
+            return (_a = (group && this.translator.translate(group, ctx, ["options"]))) !== null && _a !== void 0 ? _a : undefined;
+        });
+    }
+    getOptionGroupsByProductId(ctx, id) {
+        return this.connection
+            .getRepository(ctx, product_option_group_entity_1.ProductOptionGroup)
+            .find({
+            relations: ["options"],
+            where: {
+                product: { id },
+            },
+            order: {
+                id: "ASC",
+            },
+        })
+            .then((groups) => groups.map((group) => this.translator.translate(group, ctx, ["options"])));
+    }
+    async create(ctx, input) {
+        const group = await this.translatableSaver.create({
+            ctx,
+            input,
+            entityType: product_option_group_entity_1.ProductOptionGroup,
+            translationType: product_option_group_translation_entity_1.ProductOptionGroupTranslation,
+        });
+        const groupWithRelations = await this.customFieldRelationService.updateRelations(ctx, product_option_group_entity_1.ProductOptionGroup, input, group);
+        await this.eventBus.publish(new product_option_group_event_1.ProductOptionGroupEvent(ctx, groupWithRelations, "created", input));
+        return (0, utils_1.assertFound)(this.findOne(ctx, group.id));
+    }
+    async update(ctx, input) {
+        const group = await this.translatableSaver.update({
+            ctx,
+            input,
+            entityType: product_option_group_entity_1.ProductOptionGroup,
+            translationType: product_option_group_translation_entity_1.ProductOptionGroupTranslation,
+        });
+        await this.customFieldRelationService.updateRelations(ctx, product_option_group_entity_1.ProductOptionGroup, input, group);
+        await this.eventBus.publish(new product_option_group_event_1.ProductOptionGroupEvent(ctx, group, "updated", input));
+        return (0, utils_1.assertFound)(this.findOne(ctx, group.id));
+    }
+    /**
+     * @description
+     * Deletes the ProductOptionGroup and any associated ProductOptions. If the ProductOptionGroup
+     * is still referenced by a soft-deleted Product, then a soft-delete will be used to preserve
+     * referential integrity. Otherwise a hard-delete will be performed.
+     */
+    async deleteGroupAndOptionsFromProduct(ctx, id, productId) {
+        const optionGroup = await this.connection.getEntityOrThrow(ctx, product_option_group_entity_1.ProductOptionGroup, id, {
+            relationLoadStrategy: "query",
+            loadEagerRelations: false,
+            relations: ["options", "product"],
+        });
+        const deletedOptionGroup = new product_option_group_entity_1.ProductOptionGroup(optionGroup);
+        const inUseByActiveProducts = await this.isInUseByOtherProducts(ctx, optionGroup, productId);
+        if (0 < inUseByActiveProducts) {
+            return {
+                result: generated_types_1.DeletionResult.NOT_DELETED,
+                message: ctx.translate("message.product-option-group-used", {
+                    code: optionGroup.code,
+                    count: inUseByActiveProducts,
+                }),
+            };
+        }
+        const optionsToDelete = optionGroup.options &&
+            optionGroup.options.filter((group) => !group.deletedAt);
+        for (const option of optionsToDelete) {
+            const { result, message } = await this.productOptionService.delete(ctx, option.id);
+            if (result === generated_types_1.DeletionResult.NOT_DELETED) {
+                await this.connection.rollBackTransaction(ctx);
+                return { result, message };
+            }
+        }
+        const hasOptionsWhichAreInUse = await this.groupOptionsAreInUse(ctx, optionGroup);
+        if (0 < hasOptionsWhichAreInUse) {
+            // soft delete
+            optionGroup.deletedAt = new Date();
+            await this.connection
+                .getRepository(ctx, product_option_group_entity_1.ProductOptionGroup)
+                .save(optionGroup, { reload: false });
+        }
+        else {
+            // hard delete
+            const product = await this.connection
+                .getRepository(ctx, product_entity_1.Product)
+                .findOne({
+                relationLoadStrategy: "query",
+                loadEagerRelations: false,
+                where: { id: productId },
+                relations: ["optionGroups"],
+            });
+            if (product) {
+                product.optionGroups = product.optionGroups.filter((og) => !(0, utils_1.idsAreEqual)(og.id, id));
+                await this.connection
+                    .getRepository(ctx, product_entity_1.Product)
+                    .save(product, { reload: false });
+            }
+            try {
+                await this.connection
+                    .getRepository(ctx, product_option_group_entity_1.ProductOptionGroup)
+                    .remove(optionGroup);
+            }
+            catch (e) {
+                deenruv_logger_1.Logger.error(e.message, undefined, e.stack);
+            }
+        }
+        await this.eventBus.publish(new product_option_group_event_1.ProductOptionGroupEvent(ctx, deletedOptionGroup, "deleted", id));
+        return {
+            result: generated_types_1.DeletionResult.DELETED,
+        };
+    }
+    async isInUseByOtherProducts(ctx, productOptionGroup, targetProductId) {
+        return this.connection
+            .getRepository(ctx, product_entity_1.Product)
+            .createQueryBuilder("product")
+            .leftJoin("product.optionGroups", "optionGroup")
+            .where("product.deletedAt IS NULL")
+            .andWhere("optionGroup.id = :id", { id: productOptionGroup.id })
+            .andWhere("product.id != :productId", { productId: targetProductId })
+            .getCount();
+    }
+    async groupOptionsAreInUse(ctx, productOptionGroup) {
+        return this.connection
+            .getRepository(ctx, product_variant_entity_1.ProductVariant)
+            .createQueryBuilder("variant")
+            .leftJoin("variant.options", "option")
+            .where("option.groupId = :groupId", { groupId: productOptionGroup.id })
+            .getCount();
+    }
+};
+exports.ProductOptionGroupService = ProductOptionGroupService;
+exports.ProductOptionGroupService = ProductOptionGroupService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [transactional_connection_1.TransactionalConnection,
+        translatable_saver_1.TranslatableSaver,
+        custom_field_relation_service_1.CustomFieldRelationService,
+        product_option_service_1.ProductOptionService,
+        event_bus_1.EventBus,
+        translator_service_1.TranslatorService])
+], ProductOptionGroupService);
+//# sourceMappingURL=product-option-group.service.js.map

package/dist/service/services/product-option-group.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-option-group.service.js","sourceRoot":"","sources":["../../../src/service/services/product-option-group.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,yEAI6C;AAE7C,qCAAgD;AAKhD,8CAA8D;AAC9D,uEAA4D;AAC5D,wFAAoF;AACpF,wEAA8D;AAC9D,uIAA0H;AAC1H,+GAAmG;AACnG,gGAAqF;AACrF,+CAA2C;AAC3C,kGAA4F;AAC5F,kHAA4G;AAC5G,yFAAqF;AACrF,iFAA6E;AAE7E,qEAAgE;AAEhE;;;;;GAKG;AAEI,IAAM,yBAAyB,GAA/B,MAAM,yBAAyB;IACpC,YACU,UAAmC,EACnC,iBAAoC,EACpC,0BAAsD,EACtD,oBAA0C,EAC1C,QAAkB,EAClB,UAA6B;QAL7B,eAAU,GAAV,UAAU,CAAyB;QACnC,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,+BAA0B,GAA1B,0BAA0B,CAA4B;QACtD,yBAAoB,GAApB,oBAAoB,CAAsB;QAC1C,aAAQ,GAAR,QAAQ,CAAU;QAClB,eAAU,GAAV,UAAU,CAAmB;IACpC,CAAC;IAEJ,OAAO,CACL,GAAmB,EACnB,UAAmB,EACnB,SAA6C;QAE7C,MAAM,WAAW,GAAoB;YACnC,SAAS,EAAE,SAAS,aAAT,SAAS,cAAT,SAAS,GAAI,CAAC,SAAS,CAAC;SACpC,CAAC;QACF,IAAI,UAAU,EAAE,CAAC;YACf,WAAW,CAAC,KAAK,GAAG;gBAClB,IAAI,EAAE,IAAA,cAAI,EAAC,IAAI,UAAU,GAAG,CAAC;aAC9B,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,UAAU;aACnB,aAAa,CAAC,GAAG,EAAE,gDAAkB,CAAC;aACtC,IAAI,CAAC,WAAW,CAAC;aACjB,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CACf,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACnB,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CACnD,CACF,CAAC;IACN,CAAC;IAED,OAAO,CACL,GAAmB,EACnB,EAAM,EACN,SAA6C;QAE7C,OAAO,IAAI,CAAC,UAAU;aACnB,aAAa,CAAC,GAAG,EAAE,gDAAkB,CAAC;aACtC,OAAO,CAAC;YACP,KAAK,EAAE,EAAE,EAAE,EAAE;YACb,SAAS,EAAE,SAAS,aAAT,SAAS,cAAT,SAAS,GAAI,CAAC,SAAS,CAAC;SACpC,CAAC;aACD,IAAI,CACH,CAAC,KAAK,EAAE,EAAE;;YACR,OAAA,MAAA,CAAC,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,mCAC7D,SAAS,CAAA;SAAA,CACZ,CAAC;IACN,CAAC;IAED,0BAA0B,CACxB,GAAmB,EACnB,EAAM;QAEN,OAAO,IAAI,CAAC,UAAU;aACnB,aAAa,CAAC,GAAG,EAAE,gDAAkB,CAAC;aACtC,IAAI,CAAC;YACJ,SAAS,EAAE,CAAC,SAAS,CAAC;YACtB,KAAK,EAAE;gBACL,OAAO,EAAE,EAAE,EAAE,EAAE;aAChB;YACD,KAAK,EAAE;gBACL,EAAE,EAAE,KAAK;aACV;SACF,CAAC;aACD,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CACf,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACnB,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CACnD,CACF,CAAC;IACN,CAAC;IAED,KAAK,CAAC,MAAM,CACV,GAAmB,EACnB,KAAqD;QAErD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC;YAChD,GAAG;YACH,KAAK;YACL,UAAU,EAAE,gDAAkB;YAC9B,eAAe,EAAE,uEAA6B;SAC/C,CAAC,CAAC;QACH,MAAM,kBAAkB,GACtB,MAAM,IAAI,CAAC,0BAA0B,CAAC,eAAe,CACnD,GAAG,EACH,gDAAkB,EAClB,KAAK,EACL,KAAK,CACN,CAAC;QACJ,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CACzB,IAAI,oDAAuB,CAAC,GAAG,EAAE,kBAAkB,EAAE,SAAS,EAAE,KAAK,CAAC,CACvE,CAAC;QACF,OAAO,IAAA,mBAAW,EAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,MAAM,CACV,GAAmB,EACnB,KAAoC;QAEpC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC;YAChD,GAAG;YACH,KAAK;YACL,UAAU,EAAE,gDAAkB;YAC9B,eAAe,EAAE,uEAA6B;SAC/C,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,0BAA0B,CAAC,eAAe,CACnD,GAAG,EACH,gDAAkB,EAClB,KAAK,EACL,KAAK,CACN,CAAC;QACF,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CACzB,IAAI,oDAAuB,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAC1D,CAAC;QACF,OAAO,IAAA,mBAAW,EAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAClD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,gCAAgC,CACpC,GAAmB,EACnB,EAAM,EACN,SAAa;QAEb,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,gBAAgB,CACxD,GAAG,EACH,gDAAkB,EAClB,EAAE,EACF;YACE,oBAAoB,EAAE,OAAO;YAC7B,kBAAkB,EAAE,KAAK;YACzB,SAAS,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;SAClC,CACF,CAAC;QACF,MAAM,kBAAkB,GAAG,IAAI,gDAAkB,CAAC,WAAW,CAAC,CAAC;QAC/D,MAAM,qBAAqB,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAC7D,GAAG,EACH,WAAW,EACX,SAAS,CACV,CAAC;QACF,IAAI,CAAC,GAAG,qBAAqB,EAAE,CAAC;YAC9B,OAAO;gBACL,MAAM,EAAE,gCAAc,CAAC,WAAW;gBAClC,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,mCAAmC,EAAE;oBAC1D,IAAI,EAAE,WAAW,CAAC,IAAI;oBACtB,KAAK,EAAE,qBAAqB;iBAC7B,CAAC;aACH,CAAC;QACJ,CAAC;QAED,MAAM,eAAe,GACnB,WAAW,CAAC,OAAO;YACnB,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAE1D,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;YACrC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAChE,GAAG,EACH,MAAM,CAAC,EAAE,CACV,CAAC;YACF,IAAI,MAAM,KAAK,gCAAc,CAAC,WAAW,EAAE,CAAC;gBAC1C,MAAM,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;gBAC/C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;YAC7B,CAAC;QACH,CAAC;QACD,MAAM,uBAAuB,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAC7D,GAAG,EACH,WAAW,CACZ,CAAC;QACF,IAAI,CAAC,GAAG,uBAAuB,EAAE,CAAC;YAChC,cAAc;YACd,WAAW,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;YACnC,MAAM,IAAI,CAAC,UAAU;iBAClB,aAAa,CAAC,GAAG,EAAE,gDAAkB,CAAC;iBACtC,IAAI,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,cAAc;YAEd,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU;iBAClC,aAAa,CAAC,GAAG,EAAE,wBAAO,CAAC;iBAC3B,OAAO,CAAC;gBACP,oBAAoB,EAAE,OAAO;gBAC7B,kBAAkB,EAAE,KAAK;gBACzB,KAAK,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE;gBACxB,SAAS,EAAE,CAAC,cAAc,CAAC;aAC5B,CAAC,CAAC;YACL,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAChD,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAA,mBAAW,EAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAChC,CAAC;gBACF,MAAM,IAAI,CAAC,UAAU;qBAClB,aAAa,CAAC,GAAG,EAAE,wBAAO,CAAC;qBAC3B,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YACtC,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,UAAU;qBAClB,aAAa,CAAC,GAAG,EAAE,gDAAkB,CAAC;qBACtC,MAAM,CAAC,WAAW,CAAC,CAAC;YACzB,CAAC;YAAC,OAAO,CAAM,EAAE,CAAC;gBAChB,uBAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QACD,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CACzB,IAAI,oDAAuB,CAAC,GAAG,EAAE,kBAAkB,EAAE,SAAS,EAAE,EAAE,CAAC,CACpE,CAAC;QACF,OAAO;YACL,MAAM,EAAE,gCAAc,CAAC,OAAO;SAC/B,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,sBAAsB,CAClC,GAAmB,EACnB,kBAAsC,EACtC,eAAmB;QAEnB,OAAO,IAAI,CAAC,UAAU;aACnB,aAAa,CAAC,GAAG,EAAE,wBAAO,CAAC;aAC3B,kBAAkB,CAAC,SAAS,CAAC;aAC7B,QAAQ,CAAC,sBAAsB,EAAE,aAAa,CAAC;aAC/C,KAAK,CAAC,2BAA2B,CAAC;aAClC,QAAQ,CAAC,sBAAsB,EAAE,EAAE,EAAE,EAAE,kBAAkB,CAAC,EAAE,EAAE,CAAC;aAC/D,QAAQ,CAAC,0BAA0B,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;aACpE,QAAQ,EAAE,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,oBAAoB,CAChC,GAAmB,EACnB,kBAAsC;QAEtC,OAAO,IAAI,CAAC,UAAU;aACnB,aAAa,CAAC,GAAG,EAAE,uCAAc,CAAC;aAClC,kBAAkB,CAAC,SAAS,CAAC;aAC7B,QAAQ,CAAC,iBAAiB,EAAE,QAAQ,CAAC;aACrC,KAAK,CAAC,2BAA2B,EAAE,EAAE,OAAO,EAAE,kBAAkB,CAAC,EAAE,EAAE,CAAC;aACtE,QAAQ,EAAE,CAAC;IAChB,CAAC;CACF,CAAA;AAjPY,8DAAyB;oCAAzB,yBAAyB;IADrC,IAAA,mBAAU,GAAE;qCAGW,kDAAuB;QAChB,sCAAiB;QACR,0DAA0B;QAChC,6CAAoB;QAChC,oBAAQ;QACN,sCAAiB;GAP5B,yBAAyB,CAiPrC"}

package/dist/service/services/product-option.service.d.ts

@@ -0,0 +1,40 @@
+import { CreateGroupOptionInput, CreateProductOptionInput, DeletionResponse, UpdateProductOptionInput } from "@deenruv/common/lib/generated-types";
+import { ID } from "@deenruv/common/lib/shared-types";
+import { RequestContext } from "../../api/common/request-context";
+import { Translated } from "../../common/types/locale-types";
+import { TransactionalConnection } from "../../connection/transactional-connection";
+import { ProductOption } from "../../entity/product-option/product-option.entity";
+import { ProductOptionGroup } from "../../entity/product-option-group/product-option-group.entity";
+import { EventBus } from "../../event-bus";
+import { CustomFieldRelationService } from "../helpers/custom-field-relation/custom-field-relation.service";
+import { TranslatableSaver } from "../helpers/translatable-saver/translatable-saver";
+import { TranslatorService } from "../helpers/translator/translator.service";
+/**
+ * @description
+ * Contains methods relating to {@link ProductOption} entities.
+ *
+ * @docsCategory services
+ */
+export declare class ProductOptionService {
+    private connection;
+    private translatableSaver;
+    private customFieldRelationService;
+    private eventBus;
+    private translator;
+    constructor(connection: TransactionalConnection, translatableSaver: TranslatableSaver, customFieldRelationService: CustomFieldRelationService, eventBus: EventBus, translator: TranslatorService);
+    findAll(ctx: RequestContext): Promise<Array<Translated<ProductOption>>>;
+    findOne(ctx: RequestContext, id: ID): Promise<Translated<ProductOption> | undefined>;
+    create(ctx: RequestContext, group: ProductOptionGroup | ID, input: CreateGroupOptionInput | CreateProductOptionInput): Promise<Translated<ProductOption>>;
+    update(ctx: RequestContext, input: UpdateProductOptionInput): Promise<Translated<ProductOption>>;
+    /**
+     * @description
+     * Deletes a ProductOption.
+     *
+     * - If the ProductOption is used by any ProductVariants, the deletion will fail.
+     * - If the ProductOption is used only by soft-deleted ProductVariants, the option will itself
+     *   be soft-deleted.
+     * - If the ProductOption is not used by any ProductVariant at all, it will be hard-deleted.
+     */
+    delete(ctx: RequestContext, id: ID): Promise<DeletionResponse>;
+    private isInUse;
+}

package/dist/service/services/product-option.service.js

@@ -0,0 +1,151 @@
+"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.ProductOptionService = void 0;
+const common_1 = require("@nestjs/common");
+const generated_types_1 = require("@deenruv/common/lib/generated-types");
+const utils_1 = require("../../common/utils");
+const deenruv_logger_1 = require("../../config/logger/deenruv-logger");
+const transactional_connection_1 = require("../../connection/transactional-connection");
+const product_option_translation_entity_1 = require("../../entity/product-option/product-option-translation.entity");
+const product_option_entity_1 = require("../../entity/product-option/product-option.entity");
+const product_option_group_entity_1 = require("../../entity/product-option-group/product-option-group.entity");
+const product_variant_entity_1 = require("../../entity/product-variant/product-variant.entity");
+const event_bus_1 = require("../../event-bus");
+const product_option_event_1 = require("../../event-bus/events/product-option-event");
+const custom_field_relation_service_1 = require("../helpers/custom-field-relation/custom-field-relation.service");
+const translatable_saver_1 = require("../helpers/translatable-saver/translatable-saver");
+const translator_service_1 = require("../helpers/translator/translator.service");
+/**
+ * @description
+ * Contains methods relating to {@link ProductOption} entities.
+ *
+ * @docsCategory services
+ */
+let ProductOptionService = class ProductOptionService {
+    constructor(connection, translatableSaver, customFieldRelationService, eventBus, translator) {
+        this.connection = connection;
+        this.translatableSaver = translatableSaver;
+        this.customFieldRelationService = customFieldRelationService;
+        this.eventBus = eventBus;
+        this.translator = translator;
+    }
+    findAll(ctx) {
+        return this.connection
+            .getRepository(ctx, product_option_entity_1.ProductOption)
+            .find({
+            relations: ["group"],
+        })
+            .then((options) => options.map((option) => this.translator.translate(option, ctx)));
+    }
+    findOne(ctx, id) {
+        return this.connection
+            .getRepository(ctx, product_option_entity_1.ProductOption)
+            .findOne({
+            where: { id },
+            relations: ["group"],
+        })
+            .then((option) => { var _a; return (_a = (option && this.translator.translate(option, ctx))) !== null && _a !== void 0 ? _a : undefined; });
+    }
+    async create(ctx, group, input) {
+        const productOptionGroup = group instanceof product_option_group_entity_1.ProductOptionGroup
+            ? group
+            : await this.connection.getEntityOrThrow(ctx, product_option_group_entity_1.ProductOptionGroup, group);
+        const option = await this.translatableSaver.create({
+            ctx,
+            input,
+            entityType: product_option_entity_1.ProductOption,
+            translationType: product_option_translation_entity_1.ProductOptionTranslation,
+            beforeSave: (po) => (po.group = productOptionGroup),
+        });
+        const optionWithRelations = await this.customFieldRelationService.updateRelations(ctx, product_option_entity_1.ProductOption, input, option);
+        await this.eventBus.publish(new product_option_event_1.ProductOptionEvent(ctx, optionWithRelations, "created", input));
+        return (0, utils_1.assertFound)(this.findOne(ctx, option.id));
+    }
+    async update(ctx, input) {
+        const option = await this.translatableSaver.update({
+            ctx,
+            input,
+            entityType: product_option_entity_1.ProductOption,
+            translationType: product_option_translation_entity_1.ProductOptionTranslation,
+        });
+        await this.customFieldRelationService.updateRelations(ctx, product_option_entity_1.ProductOption, input, option);
+        await this.eventBus.publish(new product_option_event_1.ProductOptionEvent(ctx, option, "updated", input));
+        return (0, utils_1.assertFound)(this.findOne(ctx, option.id));
+    }
+    /**
+     * @description
+     * Deletes a ProductOption.
+     *
+     * - If the ProductOption is used by any ProductVariants, the deletion will fail.
+     * - If the ProductOption is used only by soft-deleted ProductVariants, the option will itself
+     *   be soft-deleted.
+     * - If the ProductOption is not used by any ProductVariant at all, it will be hard-deleted.
+     */
+    async delete(ctx, id) {
+        const productOption = await this.connection.getEntityOrThrow(ctx, product_option_entity_1.ProductOption, id);
+        const deletedProductOption = new product_option_entity_1.ProductOption(productOption);
+        const inUseByActiveVariants = await this.isInUse(ctx, productOption, "active");
+        if (0 < inUseByActiveVariants) {
+            return {
+                result: generated_types_1.DeletionResult.NOT_DELETED,
+                message: ctx.translate("message.product-option-used", {
+                    code: productOption.code,
+                    count: inUseByActiveVariants,
+                }),
+            };
+        }
+        const isInUseBySoftDeletedVariants = await this.isInUse(ctx, productOption, "soft-deleted");
+        if (0 < isInUseBySoftDeletedVariants) {
+            // soft delete
+            productOption.deletedAt = new Date();
+            await this.connection
+                .getRepository(ctx, product_option_entity_1.ProductOption)
+                .save(productOption, { reload: false });
+        }
+        else {
+            // hard delete
+            try {
+                await this.connection
+                    .getRepository(ctx, product_option_entity_1.ProductOption)
+                    .remove(productOption);
+            }
+            catch (e) {
+                deenruv_logger_1.Logger.error(e.message, undefined, e.stack);
+            }
+        }
+        await this.eventBus.publish(new product_option_event_1.ProductOptionEvent(ctx, deletedProductOption, "deleted", id));
+        return {
+            result: generated_types_1.DeletionResult.DELETED,
+        };
+    }
+    async isInUse(ctx, productOption, variantState) {
+        return this.connection
+            .getRepository(ctx, product_variant_entity_1.ProductVariant)
+            .createQueryBuilder("variant")
+            .leftJoin("variant.options", "option")
+            .where(variantState === "active"
+            ? "variant.deletedAt IS NULL"
+            : "variant.deletedAt IS NOT NULL")
+            .andWhere("option.id = :id", { id: productOption.id })
+            .getCount();
+    }
+};
+exports.ProductOptionService = ProductOptionService;
+exports.ProductOptionService = ProductOptionService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [transactional_connection_1.TransactionalConnection,
+        translatable_saver_1.TranslatableSaver,
+        custom_field_relation_service_1.CustomFieldRelationService,
+        event_bus_1.EventBus,
+        translator_service_1.TranslatorService])
+], ProductOptionService);
+//# sourceMappingURL=product-option.service.js.map

package/dist/service/services/product-option.service.js.map

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

package/dist/service/services/product-variant.service.d.ts

@@ -0,0 +1,153 @@
+import { AssignProductVariantsToChannelInput, CreateProductVariantInput, CurrencyCode, DeletionResponse, RemoveProductVariantsFromChannelInput, UpdateProductVariantInput } from "@deenruv/common/lib/generated-types";
+import { ID, PaginatedList } from "@deenruv/common/lib/shared-types";
+import { RequestContext } from "../../api/common/request-context";
+import { RelationPaths } from "../../api/decorators/relations.decorator";
+import { RequestContextCacheService } from "../../cache/request-context-cache.service";
+import { ListQueryOptions } from "../../common/types/common-types";
+import { Translated } from "../../common/types/locale-types";
+import { ConfigService } from "../../config/config.service";
+import { TransactionalConnection } from "../../connection/transactional-connection";
+import { Channel, Order, ProductVariantPrice } from "../../entity";
+import { FacetValue } from "../../entity/facet-value/facet-value.entity";
+import { Product } from "../../entity/product/product.entity";
+import { ProductOption } from "../../entity/product-option/product-option.entity";
+import { ProductVariant } from "../../entity/product-variant/product-variant.entity";
+import { EventBus } from "../../event-bus/event-bus";
+import { CustomFieldRelationService } from "../helpers/custom-field-relation/custom-field-relation.service";
+import { ListQueryBuilder } from "../helpers/list-query-builder/list-query-builder";
+import { ProductPriceApplicator } from "../helpers/product-price-applicator/product-price-applicator";
+import { TranslatableSaver } from "../helpers/translatable-saver/translatable-saver";
+import { TranslatorService } from "../helpers/translator/translator.service";
+import { AssetService } from "./asset.service";
+import { ChannelService } from "./channel.service";
+import { FacetValueService } from "./facet-value.service";
+import { GlobalSettingsService } from "./global-settings.service";
+import { RoleService } from "./role.service";
+import { StockLevelService } from "./stock-level.service";
+import { StockMovementService } from "./stock-movement.service";
+import { TaxCategoryService } from "./tax-category.service";
+/**
+ * @description
+ * Contains methods relating to {@link ProductVariant} entities.
+ *
+ * @docsCategory services
+ */
+export declare class ProductVariantService {
+    private connection;
+    private configService;
+    private taxCategoryService;
+    private facetValueService;
+    private assetService;
+    private translatableSaver;
+    private eventBus;
+    private listQueryBuilder;
+    private globalSettingsService;
+    private stockMovementService;
+    private stockLevelService;
+    private channelService;
+    private roleService;
+    private customFieldRelationService;
+    private requestCache;
+    private productPriceApplicator;
+    private translator;
+    constructor(connection: TransactionalConnection, configService: ConfigService, taxCategoryService: TaxCategoryService, facetValueService: FacetValueService, assetService: AssetService, translatableSaver: TranslatableSaver, eventBus: EventBus, listQueryBuilder: ListQueryBuilder, globalSettingsService: GlobalSettingsService, stockMovementService: StockMovementService, stockLevelService: StockLevelService, channelService: ChannelService, roleService: RoleService, customFieldRelationService: CustomFieldRelationService, requestCache: RequestContextCacheService, productPriceApplicator: ProductPriceApplicator, translator: TranslatorService);
+    private dataloaderKey;
+    private findByIdsDataloader;
+    private findByProductIdsDataloader;
+    findAll(ctx: RequestContext, options?: ListQueryOptions<ProductVariant>): Promise<PaginatedList<Translated<ProductVariant>>>;
+    findOne(ctx: RequestContext, productVariantId: ID, relations?: RelationPaths<ProductVariant>): Promise<Translated<ProductVariant> | undefined>;
+    findByIds(ctx: RequestContext, ids: ID[]): Promise<Array<Translated<ProductVariant>>>;
+    getVariantsByProductId(ctx: RequestContext, productId: ID, options?: ListQueryOptions<ProductVariant>, relations?: RelationPaths<ProductVariant>): Promise<PaginatedList<Translated<ProductVariant>>>;
+    /**
+     * @description
+     * Returns a {@link PaginatedList} of all ProductVariants associated with the given Collection.
+     */
+    getVariantsByCollectionId(ctx: RequestContext, collectionId: ID, options: ListQueryOptions<ProductVariant>, relations?: RelationPaths<ProductVariant>): Promise<PaginatedList<Translated<ProductVariant>>>;
+    /**
+     * @description
+     * Returns all Channels to which the ProductVariant is assigned.
+     */
+    getProductVariantChannels(ctx: RequestContext, productVariantId: ID): Promise<Channel[]>;
+    getProductVariantPrices(ctx: RequestContext, productVariantId: ID): Promise<ProductVariantPrice[]>;
+    /**
+     * @description
+     * Returns the ProductVariant associated with the given {@link OrderLine}.
+     */
+    getVariantByOrderLineId(ctx: RequestContext, orderLineId: ID): Promise<Translated<ProductVariant>>;
+    /**
+     * @description
+     * Returns the {@link ProductOption}s for the given ProductVariant.
+     */
+    getOptionsForVariant(ctx: RequestContext, variantId: ID): Promise<Array<Translated<ProductOption>>>;
+    getFacetValuesForVariant(ctx: RequestContext, variantId: ID): Promise<Array<Translated<FacetValue>>>;
+    /**
+     * @description
+     * Returns the Product associated with the ProductVariant. Whereas the `ProductService.findOne()`
+     * method performs a large multi-table join with all the typical data needed for a "product detail"
+     * page, this method returns only the Product itself.
+     */
+    getProductForVariant(ctx: RequestContext, variant: ProductVariant): Promise<Translated<Product>>;
+    /**
+     * @description
+     * Returns the number of saleable units of the ProductVariant, i.e. how many are available
+     * for purchase by Customers. This is determined by the ProductVariant's `stockOnHand` value,
+     * as well as the local and global `outOfStockThreshold` settings.
+     */
+    getSaleableStockLevel(ctx: RequestContext, variant: ProductVariant): Promise<number>;
+    private getOutOfStockThreshold;
+    /**
+     * @description
+     * Returns the stockLevel to display to the customer, as specified by the configured
+     * {@link StockDisplayStrategy}.
+     */
+    getDisplayStockLevel(ctx: RequestContext, variant: ProductVariant): Promise<string>;
+    /**
+     * @description
+     * Returns the number of fulfillable units of the ProductVariant, equivalent to stockOnHand
+     * for those variants which are tracking inventory.
+     */
+    getFulfillableStockLevel(ctx: RequestContext, variant: ProductVariant): Promise<number>;
+    create(ctx: RequestContext, input: CreateProductVariantInput[]): Promise<Array<Translated<ProductVariant>>>;
+    update(ctx: RequestContext, input: UpdateProductVariantInput[]): Promise<Array<Translated<ProductVariant>>>;
+    private createSingle;
+    private updateSingle;
+    /**
+     * @description
+     * Creates a {@link ProductVariantPrice} for the given ProductVariant/Channel combination.
+     * If the `currencyCode` is not specified, the default currency of the Channel will be used.
+     */
+    createOrUpdateProductVariantPrice(ctx: RequestContext, productVariantId: ID, price: number, channelId: ID, currencyCode?: CurrencyCode): Promise<ProductVariantPrice>;
+    deleteProductVariantPrice(ctx: RequestContext, variantId: ID, channelId: ID, currencyCode: CurrencyCode): Promise<void>;
+    softDelete(ctx: RequestContext, id: ID | ID[]): Promise<DeletionResponse>;
+    /**
+     * @description
+     * This method is intended to be used by the ProductVariant GraphQL entity resolver to resolve the
+     * price-related fields which need to be populated at run-time using the `applyChannelPriceAndTax`
+     * method.
+     *
+     * Is optimized to make as few DB calls as possible using caching based on the open request.
+     */
+    hydratePriceFields<F extends "currencyCode" | "price" | "priceWithTax" | "taxRateApplied">(ctx: RequestContext, variant: ProductVariant, priceField: F): Promise<ProductVariant[F]>;
+    /**
+     * @description
+     * Given an array of ProductVariants from the database, this method will apply the correct price and tax
+     * and translate each item.
+     */
+    private applyPricesAndTranslateVariants;
+    /**
+     * @description
+     * Populates the `price` field with the price for the specified channel.
+     */
+    applyChannelPriceAndTax(variant: ProductVariant, ctx: RequestContext, order?: Order, throwIfNoPriceFound?: boolean): Promise<ProductVariant>;
+    /**
+     * @description
+     * Assigns the specified ProductVariants to the specified Channel. In doing so, it will create a new
+     * {@link ProductVariantPrice} and also assign the associated Product and any Assets to the Channel too.
+     */
+    assignProductVariantsToChannel(ctx: RequestContext, input: AssignProductVariantsToChannelInput): Promise<Array<Translated<ProductVariant>>>;
+    removeProductVariantsFromChannel(ctx: RequestContext, input: RemoveProductVariantsFromChannelInput): Promise<ID[]>;
+    private validateVariantOptionIds;
+    private throwIncompatibleOptionsError;
+    private sortJoin;
+    private getTaxCategoryForNewVariant;
+}