@deenruv/core 1.0.0

package/dist/service/helpers/shipping-calculator/shipping-calculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shipping-calculator.js","sourceRoot":"","sources":["../../../../src/service/helpers/shipping-calculator/shipping-calculator.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAE5C,mEAAsE;AAMtE,oFAA+E;AAQxE,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAC7B,YAAoB,qBAA4C;QAA5C,0BAAqB,GAArB,qBAAqB,CAAuB;IAAG,CAAC;IAEpE;;;;;OAKG;IACH,KAAK,CAAC,0BAA0B,CAC9B,GAAmB,EACnB,KAAY,EACZ,UAAgB,EAAE;QAElB,MAAM,eAAe,GAAG,CACtB,MAAM,IAAI,CAAC,qBAAqB,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAC/D,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAEnD,MAAM,wBAAwB,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAC9D,IAAI,CAAC,gCAAgC,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAC1D,CAAC;QACF,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QAEpE,OAAO,eAAe;aACnB,MAAM,CAAC,iCAAkB,CAAC;aAC1B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,GAAmB,EACnB,KAAY,EACZ,gBAAoB;QAEpB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,OAAO,CACrD,GAAG,EACH,gBAAgB,CACjB,CAAC;QACF,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC/C,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,gCAAgC,CAC5C,GAAmB,EACnB,KAAY,EACZ,MAAsB;QAEtB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC/C,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC9C,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAA;AA1DY,gDAAkB;6BAAlB,kBAAkB;IAD9B,IAAA,mBAAU,GAAE;qCAEgC,+CAAqB;GADrD,kBAAkB,CA0D9B"}

package/dist/service/helpers/slug-validator/slug-validator.d.ts

@@ -0,0 +1,44 @@
+import { LanguageCode } from "@deenruv/common/lib/generated-types";
+import { ID, Type } from "@deenruv/common/lib/shared-types";
+import { RequestContext } from "../../../api/common/request-context";
+import { TransactionalConnection } from "../../../connection/transactional-connection";
+import { DeenruvEntity } from "../../../entity/base/base.entity";
+/**
+ * @docsCategory service-helpers
+ * @docsPage SlugValidator
+ */
+export type InputWithSlug = {
+    id?: ID | null;
+    translations?: Array<{
+        id?: ID | null;
+        languageCode: LanguageCode;
+        slug?: string | null;
+    }> | null;
+};
+/**
+ * @docsCategory service-helpers
+ * @docsPage SlugValidator
+ */
+export type TranslationEntity = DeenruvEntity & {
+    id: ID;
+    languageCode: LanguageCode;
+    slug: string;
+    base: any;
+};
+/**
+ * @description
+ * Used to validate slugs to ensure they are URL-safe and unique. Designed to be used with translatable
+ * entities such as {@link Product} and {@link Collection}.
+ *
+ * @docsCategory service-helpers
+ * @docsWeight 0
+ */
+export declare class SlugValidator {
+    private connection;
+    constructor(connection: TransactionalConnection);
+    /**
+     * Normalizes the slug to be URL-safe, and ensures it is unique for the given languageCode.
+     * Mutates the input.
+     */
+    validateSlugs<T extends InputWithSlug, E extends TranslationEntity>(ctx: RequestContext, input: T, translationEntity: Type<E>): Promise<T>;
+}

package/dist/service/helpers/slug-validator/slug-validator.js

@@ -0,0 +1,85 @@
+"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.SlugValidator = void 0;
+const common_1 = require("@nestjs/common");
+const normalize_string_1 = require("@deenruv/common/lib/normalize-string");
+const transactional_connection_1 = require("../../../connection/transactional-connection");
+/**
+ * @description
+ * Used to validate slugs to ensure they are URL-safe and unique. Designed to be used with translatable
+ * entities such as {@link Product} and {@link Collection}.
+ *
+ * @docsCategory service-helpers
+ * @docsWeight 0
+ */
+let SlugValidator = class SlugValidator {
+    constructor(connection) {
+        this.connection = connection;
+    }
+    /**
+     * Normalizes the slug to be URL-safe, and ensures it is unique for the given languageCode.
+     * Mutates the input.
+     */
+    async validateSlugs(ctx, input, translationEntity) {
+        if (input.translations) {
+            for (const t of input.translations) {
+                if (t.slug) {
+                    t.slug = (0, normalize_string_1.normalizeString)(t.slug, "-");
+                    let match;
+                    let suffix = 1;
+                    const seen = [];
+                    const alreadySuffixed = /-\d+$/;
+                    do {
+                        const qb = this.connection
+                            .getRepository(ctx, translationEntity)
+                            .createQueryBuilder("translation")
+                            .innerJoinAndSelect("translation.base", "base")
+                            .innerJoinAndSelect("base.channels", "channel")
+                            .where("channel.id = :channelId", { channelId: ctx.channelId })
+                            .andWhere("translation.slug = :slug", { slug: t.slug })
+                            .andWhere("translation.languageCode = :languageCode", {
+                            languageCode: t.languageCode,
+                        });
+                        if (input.id) {
+                            qb.andWhere("translation.base != :id", { id: input.id });
+                        }
+                        if (seen.length) {
+                            qb.andWhere("translation.id NOT IN (:...seen)", { seen });
+                        }
+                        match = await qb.getOne();
+                        if (match) {
+                            if (!match.base.deletedAt) {
+                                suffix++;
+                                if (alreadySuffixed.test(t.slug)) {
+                                    t.slug = t.slug.replace(alreadySuffixed, `-${suffix}`);
+                                }
+                                else {
+                                    t.slug = `${t.slug}-${suffix}`;
+                                }
+                            }
+                            else {
+                                seen.push(match.id);
+                            }
+                        }
+                    } while (match);
+                }
+            }
+        }
+        return input;
+    }
+};
+exports.SlugValidator = SlugValidator;
+exports.SlugValidator = SlugValidator = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [transactional_connection_1.TransactionalConnection])
+], SlugValidator);
+//# sourceMappingURL=slug-validator.js.map

package/dist/service/helpers/slug-validator/slug-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug-validator.js","sourceRoot":"","sources":["../../../../src/service/helpers/slug-validator/slug-validator.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAE5C,2EAAuE;AAIvE,2FAAuF;AA6BvF;;;;;;;GAOG;AAEI,IAAM,aAAa,GAAnB,MAAM,aAAa;IACxB,YAAoB,UAAmC;QAAnC,eAAU,GAAV,UAAU,CAAyB;IAAG,CAAC;IAE3D;;;OAGG;IACH,KAAK,CAAC,aAAa,CACjB,GAAmB,EACnB,KAAQ,EACR,iBAA0B;QAE1B,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;YACvB,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;gBACnC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;oBACX,CAAC,CAAC,IAAI,GAAG,IAAA,kCAAe,EAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;oBACtC,IAAI,KAAe,CAAC;oBACpB,IAAI,MAAM,GAAG,CAAC,CAAC;oBACf,MAAM,IAAI,GAAS,EAAE,CAAC;oBACtB,MAAM,eAAe,GAAG,OAAO,CAAC;oBAChC,GAAG,CAAC;wBACF,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU;6BACvB,aAAa,CAAC,GAAG,EAAE,iBAAiB,CAAC;6BACrC,kBAAkB,CAAC,aAAa,CAAC;6BACjC,kBAAkB,CAAC,kBAAkB,EAAE,MAAM,CAAC;6BAC9C,kBAAkB,CAAC,eAAe,EAAE,SAAS,CAAC;6BAC9C,KAAK,CAAC,yBAAyB,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC;6BAC9D,QAAQ,CAAC,0BAA0B,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;6BACtD,QAAQ,CAAC,0CAA0C,EAAE;4BACpD,YAAY,EAAE,CAAC,CAAC,YAAY;yBAC7B,CAAC,CAAC;wBACL,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;4BACb,EAAE,CAAC,QAAQ,CAAC,yBAAyB,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;wBAC3D,CAAC;wBACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;4BAChB,EAAE,CAAC,QAAQ,CAAC,kCAAkC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;wBAC5D,CAAC;wBACD,KAAK,GAAG,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC;wBAC1B,IAAI,KAAK,EAAE,CAAC;4BACV,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gCAC1B,MAAM,EAAE,CAAC;gCACT,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;oCACjC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,IAAI,MAAM,EAAE,CAAC,CAAC;gCACzD,CAAC;qCAAM,CAAC;oCACN,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,MAAM,EAAE,CAAC;gCACjC,CAAC;4BACH,CAAC;iCAAM,CAAC;gCACN,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;4BACtB,CAAC;wBACH,CAAC;oBACH,CAAC,QAAQ,KAAK,EAAE;gBAClB,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAA;AAxDY,sCAAa;wBAAb,aAAa;IADzB,IAAA,mBAAU,GAAE;qCAEqB,kDAAuB;GAD5C,aAAa,CAwDzB"}

package/dist/service/helpers/translatable-saver/translatable-saver.d.ts

@@ -0,0 +1,62 @@
+import { ID, Type } from "@deenruv/common/lib/shared-types";
+import { RequestContext } from "../../../api/common/request-context";
+import { Translatable, TranslatedInput, Translation } from "../../../common/types/locale-types";
+import { TransactionalConnection } from "../../../connection/transactional-connection";
+import { DeenruvEntity } from "../../../entity/base/base.entity";
+export interface CreateTranslatableOptions<T extends Translatable> {
+    ctx: RequestContext;
+    entityType: Type<T>;
+    translationType: Type<Translation<T>>;
+    input: TranslatedInput<T>;
+    beforeSave?: (newEntity: T) => any | Promise<any>;
+    typeOrmSubscriberData?: any;
+}
+export interface UpdateTranslatableOptions<T extends Translatable> extends CreateTranslatableOptions<T> {
+    input: TranslatedInput<T> & {
+        id: ID;
+    };
+}
+/**
+ * @description
+ * A helper which contains methods for creating and updating entities which implement the {@link Translatable} interface.
+ *
+ * @example
+ * ```ts
+ * export class MyService {
+ *   constructor(private translatableSaver: TranslatableSaver) {}
+ *
+ *   async create(ctx: RequestContext, input: CreateFacetInput): Promise<Translated<Facet>> {
+ *     const facet = await this.translatableSaver.create({
+ *       ctx,
+ *       input,
+ *       entityType: Facet,
+ *       translationType: FacetTranslation,
+ *       beforeSave: async f => {
+ *           f.code = await this.ensureUniqueCode(ctx, f.code);
+ *       },
+ *     });
+ *     return facet;
+ *   }
+ *
+ *   // ...
+ * }
+ * ```
+ *
+ * @docsCategory service-helpers
+ */
+export declare class TranslatableSaver {
+    private connection;
+    constructor(connection: TransactionalConnection);
+    /**
+     * @description
+     * Create a translatable entity, including creating any translation entities according
+     * to the `translations` array.
+     */
+    create<T extends Translatable & DeenruvEntity>(options: CreateTranslatableOptions<T>): Promise<T>;
+    /**
+     * @description
+     * Update a translatable entity. Performs a diff of the `translations` array in order to
+     * perform the correct operation on the translations.
+     */
+    update<T extends Translatable & DeenruvEntity>(options: UpdateTranslatableOptions<T>): Promise<T>;
+}

package/dist/service/helpers/translatable-saver/translatable-saver.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.TranslatableSaver = void 0;
+const common_1 = require("@nestjs/common");
+const omit_1 = require("@deenruv/common/lib/omit");
+const transactional_connection_1 = require("../../../connection/transactional-connection");
+const patch_entity_1 = require("../utils/patch-entity");
+const translation_differ_1 = require("./translation-differ");
+/**
+ * @description
+ * A helper which contains methods for creating and updating entities which implement the {@link Translatable} interface.
+ *
+ * @example
+ * ```ts
+ * export class MyService {
+ *   constructor(private translatableSaver: TranslatableSaver) {}
+ *
+ *   async create(ctx: RequestContext, input: CreateFacetInput): Promise<Translated<Facet>> {
+ *     const facet = await this.translatableSaver.create({
+ *       ctx,
+ *       input,
+ *       entityType: Facet,
+ *       translationType: FacetTranslation,
+ *       beforeSave: async f => {
+ *           f.code = await this.ensureUniqueCode(ctx, f.code);
+ *       },
+ *     });
+ *     return facet;
+ *   }
+ *
+ *   // ...
+ * }
+ * ```
+ *
+ * @docsCategory service-helpers
+ */
+let TranslatableSaver = class TranslatableSaver {
+    constructor(connection) {
+        this.connection = connection;
+    }
+    /**
+     * @description
+     * Create a translatable entity, including creating any translation entities according
+     * to the `translations` array.
+     */
+    async create(options) {
+        const { ctx, entityType, translationType, input, beforeSave, typeOrmSubscriberData, } = options;
+        const entity = new entityType(input);
+        const translations = [];
+        if (input.translations) {
+            for (const translationInput of input.translations) {
+                const translation = new translationType(translationInput);
+                translations.push(translation);
+                await this.connection
+                    .getRepository(ctx, translationType)
+                    .save(translation);
+            }
+        }
+        entity.translations = translations;
+        if (typeof beforeSave === "function") {
+            await beforeSave(entity);
+        }
+        return await this.connection
+            .getRepository(ctx, entityType)
+            .save(entity, { data: typeOrmSubscriberData });
+    }
+    /**
+     * @description
+     * Update a translatable entity. Performs a diff of the `translations` array in order to
+     * perform the correct operation on the translations.
+     */
+    async update(options) {
+        const { ctx, entityType, translationType, input, beforeSave, typeOrmSubscriberData, } = options;
+        const existingTranslations = await this.connection
+            .getRepository(ctx, translationType)
+            .find({
+            relationLoadStrategy: "query",
+            loadEagerRelations: false,
+            where: { base: { id: input.id } },
+            relations: ["base"],
+        });
+        const differ = new translation_differ_1.TranslationDiffer(translationType, this.connection);
+        const diff = differ.diff(existingTranslations, input.translations);
+        const entity = await differ.applyDiff(ctx, new entityType(Object.assign(Object.assign({}, input), { translations: existingTranslations })), diff);
+        entity.updatedAt = new Date();
+        const updatedEntity = (0, patch_entity_1.patchEntity)(entity, (0, omit_1.omit)(input, ["translations"]));
+        if (typeof beforeSave === "function") {
+            await beforeSave(entity);
+        }
+        return this.connection
+            .getRepository(ctx, entityType)
+            .save(updatedEntity, { data: typeOrmSubscriberData });
+    }
+};
+exports.TranslatableSaver = TranslatableSaver;
+exports.TranslatableSaver = TranslatableSaver = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [transactional_connection_1.TransactionalConnection])
+], TranslatableSaver);
+//# sourceMappingURL=translatable-saver.js.map

package/dist/service/helpers/translatable-saver/translatable-saver.js.map

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

package/dist/service/helpers/translatable-saver/translation-differ.d.ts

@@ -0,0 +1,24 @@
+import { DeepPartial } from "@deenruv/common/lib/shared-types";
+import { RequestContext } from "../../../api/common/request-context";
+import { Translatable, Translation, TranslationInput } from "../../../common/types/locale-types";
+import { TransactionalConnection } from "../../../connection/transactional-connection";
+export type TranslationContructor<T> = new (input?: DeepPartial<TranslationInput<T>> | DeepPartial<Translation<T>>) => Translation<T>;
+export interface TranslationDiff<T> {
+    toUpdate: Array<Translation<T>>;
+    toAdd: Array<Translation<T>>;
+}
+/**
+ * This class is to be used when performing an update on a Translatable entity.
+ */
+export declare class TranslationDiffer<Entity extends Translatable> {
+    private translationCtor;
+    private connection;
+    constructor(translationCtor: TranslationContructor<Entity>, connection: TransactionalConnection);
+    /**
+     * Compares the existing translations with the updated translations and produces a diff of
+     * added, removed and updated translations.
+     */
+    diff(existing: Array<Translation<Entity>>, updated?: Array<TranslationInput<Entity>> | null): TranslationDiff<Entity>;
+    applyDiff(ctx: RequestContext, entity: Entity, { toUpdate, toAdd }: TranslationDiff<Entity>): Promise<Entity>;
+    private translationInputsToEntities;
+}

package/dist/service/helpers/translatable-saver/translation-differ.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TranslationDiffer = void 0;
+const errors_1 = require("../../../common/error/errors");
+const utils_1 = require("../../../common/utils");
+/**
+ * This class is to be used when performing an update on a Translatable entity.
+ */
+class TranslationDiffer {
+    constructor(translationCtor, connection) {
+        this.translationCtor = translationCtor;
+        this.connection = connection;
+    }
+    /**
+     * Compares the existing translations with the updated translations and produces a diff of
+     * added, removed and updated translations.
+     */
+    diff(existing, updated) {
+        if (updated) {
+            const translationEntities = this.translationInputsToEntities(updated, existing);
+            const toAdd = translationEntities.filter((0, utils_1.not)((0, utils_1.foundIn)(existing, "languageCode")));
+            const toUpdate = translationEntities.filter((0, utils_1.foundIn)(existing, "languageCode"));
+            return { toUpdate, toAdd };
+        }
+        else {
+            return {
+                toUpdate: [],
+                toAdd: [],
+            };
+        }
+    }
+    async applyDiff(ctx, entity, { toUpdate, toAdd }) {
+        if (toUpdate.length) {
+            for (const translation of toUpdate) {
+                // any cast below is required due to TS issue: https://github.com/Microsoft/TypeScript/issues/21592
+                const updated = await this.connection
+                    .getRepository(ctx, this.translationCtor)
+                    .save(translation);
+                const index = entity.translations.findIndex((t) => t.languageCode === updated.languageCode);
+                entity.translations.splice(index, 1, updated);
+            }
+        }
+        if (toAdd.length) {
+            for (const translation of toAdd) {
+                translation.base = entity;
+                let newTranslation;
+                try {
+                    newTranslation = await this.connection
+                        .getRepository(ctx, this.translationCtor)
+                        .save(translation);
+                }
+                catch (err) {
+                    throw new errors_1.InternalServerError(err.message);
+                }
+                entity.translations.push(newTranslation);
+            }
+        }
+        return entity;
+    }
+    translationInputsToEntities(inputs, existing) {
+        return inputs.map((input) => {
+            const counterpart = existing.find((e) => e.languageCode === input.languageCode);
+            // any cast below is required due to TS issue: https://github.com/Microsoft/TypeScript/issues/21592
+            const entity = new this.translationCtor(input);
+            if (counterpart) {
+                entity.id = counterpart.id;
+                entity.base = counterpart.base;
+            }
+            return entity;
+        });
+    }
+}
+exports.TranslationDiffer = TranslationDiffer;
+//# sourceMappingURL=translation-differ.js.map

package/dist/service/helpers/translatable-saver/translation-differ.js.map

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

package/dist/service/helpers/translator/translator.service.d.ts

@@ -0,0 +1,43 @@
+import { RequestContext } from "../../../api/common/request-context";
+import { Translatable } from "../../../common/types/locale-types";
+import { ConfigService } from "../../../config";
+import { DeenruvEntity } from "../../../entity";
+import { DeepTranslatableRelations } from "../utils/translate-entity";
+/**
+ * @description
+ * The TranslatorService is used to translate entities into the current language.
+ *
+ * @example
+ * ```ts
+ * import { Injectable } from '\@nestjs/common';
+ * import { ID, Product, RequestContext, TransactionalConnection, TranslatorService } from '\@deenruv/core';
+ *
+ * \@Injectable()
+ * export class ProductService {
+ *
+ *     constructor(private connection: TransactionalConnection,
+ *                 private translator: TranslatorService){}
+ *
+ *     async findOne(ctx: RequestContext, productId: ID): Promise<Product | undefined> {
+ *         const product = await this.connection.findOneInChannel(ctx, Product, productId, ctx.channelId, {
+ *             relations: {
+ *                  facetValues: {
+ *                      facet: true,
+ *                  }
+ *             }
+ *         });
+ *         if (!product) {
+ *             return;
+ *         }
+ *         return this.translator.translate(product, ctx, ['facetValues', ['facetValues', 'facet']]);
+ *     }
+ * }
+ * ```
+ *
+ * @docsCategory service-helpers
+ */
+export declare class TranslatorService {
+    private configService;
+    constructor(configService: ConfigService);
+    translate<T extends Translatable & DeenruvEntity>(translatable: T, ctx: RequestContext, translatableRelations?: DeepTranslatableRelations<T>): import("../../../common/types/locale-types").Translated<T>;
+}

package/dist/service/helpers/translator/translator.service.js

@@ -0,0 +1,66 @@
+"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.TranslatorService = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("../../../config");
+const translate_entity_1 = require("../utils/translate-entity");
+/**
+ * @description
+ * The TranslatorService is used to translate entities into the current language.
+ *
+ * @example
+ * ```ts
+ * import { Injectable } from '\@nestjs/common';
+ * import { ID, Product, RequestContext, TransactionalConnection, TranslatorService } from '\@deenruv/core';
+ *
+ * \@Injectable()
+ * export class ProductService {
+ *
+ *     constructor(private connection: TransactionalConnection,
+ *                 private translator: TranslatorService){}
+ *
+ *     async findOne(ctx: RequestContext, productId: ID): Promise<Product | undefined> {
+ *         const product = await this.connection.findOneInChannel(ctx, Product, productId, ctx.channelId, {
+ *             relations: {
+ *                  facetValues: {
+ *                      facet: true,
+ *                  }
+ *             }
+ *         });
+ *         if (!product) {
+ *             return;
+ *         }
+ *         return this.translator.translate(product, ctx, ['facetValues', ['facetValues', 'facet']]);
+ *     }
+ * }
+ * ```
+ *
+ * @docsCategory service-helpers
+ */
+let TranslatorService = class TranslatorService {
+    constructor(configService) {
+        this.configService = configService;
+    }
+    translate(translatable, ctx, translatableRelations = []) {
+        return (0, translate_entity_1.translateDeep)(translatable, [
+            ctx.languageCode,
+            ctx.channel.defaultLanguageCode,
+            this.configService.defaultLanguageCode,
+        ], translatableRelations);
+    }
+};
+exports.TranslatorService = TranslatorService;
+exports.TranslatorService = TranslatorService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [config_1.ConfigService])
+], TranslatorService);
+//# sourceMappingURL=translator.service.js.map

package/dist/service/helpers/translator/translator.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translator.service.js","sourceRoot":"","sources":["../../../../src/service/helpers/translator/translator.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAI5C,4CAAgD;AAEhD,gEAGmC;AAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEI,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAC5B,YAAoB,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;IAAG,CAAC;IAEpD,SAAS,CACP,YAAe,EACf,GAAmB,EACnB,wBAAsD,EAAE;QAExD,OAAO,IAAA,gCAAa,EAClB,YAAY,EACZ;YACE,GAAG,CAAC,YAAY;YAChB,GAAG,CAAC,OAAO,CAAC,mBAAmB;YAC/B,IAAI,CAAC,aAAa,CAAC,mBAAmB;SACvC,EACD,qBAAqB,CACtB,CAAC;IACJ,CAAC;CACF,CAAA;AAlBY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,mBAAU,GAAE;qCAEwB,sBAAa;GADrC,iBAAiB,CAkB7B"}

package/dist/service/helpers/utils/address-to-line.d.ts

@@ -0,0 +1,7 @@
+import { OrderAddress } from "@deenruv/common/lib/generated-types";
+import { Address } from "../../../entity/address/address.entity";
+/**
+ * Given an Address object, this function converts it into a single line
+ * consisting of streetLine1, (postalCode), (countryCode).
+ */
+export declare function addressToLine(address: Address | OrderAddress): string;

package/dist/service/helpers/utils/address-to-line.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addressToLine = void 0;
+/**
+ * Given an Address object, this function converts it into a single line
+ * consisting of streetLine1, (postalCode), (countryCode).
+ */
+function addressToLine(address) {
+    const propsToInclude = [
+        "streetLine1",
+        "postalCode",
+        "country",
+    ];
+    let result = address.streetLine1 || "";
+    if (address.postalCode) {
+        result += ", " + address.postalCode;
+    }
+    if (address.country) {
+        if (typeof address.country === "string") {
+            result += ", " + address.country;
+        }
+        else {
+            result += ", " + address.country.name;
+        }
+    }
+    return result;
+}
+exports.addressToLine = addressToLine;
+//# sourceMappingURL=address-to-line.js.map

package/dist/service/helpers/utils/address-to-line.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-to-line.js","sourceRoot":"","sources":["../../../../src/service/helpers/utils/address-to-line.ts"],"names":[],"mappings":";;;AAIA;;;GAGG;AACH,SAAgB,aAAa,CAAC,OAA+B;IAC3D,MAAM,cAAc,GAA0C;QAC5D,aAAa;QACb,YAAY;QACZ,SAAS;KACV,CAAC;IACF,IAAI,MAAM,GAAG,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;IACvC,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,IAAI,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACxC,MAAM,IAAI,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QACxC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAlBD,sCAkBC"}

package/dist/service/helpers/utils/get-user-channels-permissions.d.ts

@@ -0,0 +1,19 @@
+import { Permission } from "@deenruv/common/lib/generated-types";
+import { ID } from "@deenruv/common/lib/shared-types";
+import { Role } from "../../../entity/role/role.entity";
+import { User } from "../../../entity/user/user.entity";
+export interface UserChannelPermissions {
+    id: ID;
+    token: string;
+    code: string;
+    permissions: Permission[];
+}
+/**
+ * Returns an array of Channels and permissions on those Channels for the given User.
+ */
+export declare function getUserChannelsPermissions(user: User): UserChannelPermissions[];
+/**
+ * @description
+ * Returns an array of Channels and permissions on those Channels for the given Roles.
+ */
+export declare function getChannelPermissions(roles: Role[]): UserChannelPermissions[];

package/dist/service/helpers/utils/get-user-channels-permissions.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getChannelPermissions = exports.getUserChannelsPermissions = void 0;
+const unique_1 = require("@deenruv/common/lib/unique");
+/**
+ * Returns an array of Channels and permissions on those Channels for the given User.
+ */
+function getUserChannelsPermissions(user) {
+    return getChannelPermissions(user.roles);
+}
+exports.getUserChannelsPermissions = getUserChannelsPermissions;
+/**
+ * @description
+ * Returns an array of Channels and permissions on those Channels for the given Roles.
+ */
+function getChannelPermissions(roles) {
+    const channelsMap = {};
+    for (const role of roles) {
+        for (const channel of role.channels) {
+            if (!channelsMap[channel.code]) {
+                channelsMap[channel.code] = {
+                    id: channel.id,
+                    token: channel.token,
+                    code: channel.code,
+                    permissions: [],
+                };
+            }
+            channelsMap[channel.code].permissions = (0, unique_1.unique)([
+                ...channelsMap[channel.code].permissions,
+                ...role.permissions,
+            ]);
+        }
+    }
+    return Object.values(channelsMap).sort((a, b) => (a.id < b.id ? -1 : 1));
+}
+exports.getChannelPermissions = getChannelPermissions;
+//# sourceMappingURL=get-user-channels-permissions.js.map

package/dist/service/helpers/utils/get-user-channels-permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-user-channels-permissions.js","sourceRoot":"","sources":["../../../../src/service/helpers/utils/get-user-channels-permissions.ts"],"names":[],"mappings":";;;AAEA,uDAAoD;AAYpD;;GAEG;AACH,SAAgB,0BAA0B,CACxC,IAAU;IAEV,OAAO,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3C,CAAC;AAJD,gEAIC;AAED;;;GAGG;AACH,SAAgB,qBAAqB,CAAC,KAAa;IACjD,MAAM,WAAW,GAA+C,EAAE,CAAC;IAEnE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/B,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG;oBAC1B,EAAE,EAAE,OAAO,CAAC,EAAE;oBACd,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,WAAW,EAAE,EAAE;iBAChB,CAAC;YACJ,CAAC;YACD,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,GAAG,IAAA,eAAM,EAAC;gBAC7C,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW;gBACxC,GAAG,IAAI,CAAC,WAAW;aACpB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3E,CAAC;AArBD,sDAqBC"}