@deenruv/core 1.0.0

package/dist/service/helpers/external-authentication/external-authentication.service.js

@@ -0,0 +1,212 @@
+"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.ExternalAuthenticationService = void 0;
+const common_1 = require("@nestjs/common");
+const generated_types_1 = require("@deenruv/common/lib/generated-types");
+const transactional_connection_1 = require("../../../connection/transactional-connection");
+const administrator_entity_1 = require("../../../entity/administrator/administrator.entity");
+const external_authentication_method_entity_1 = require("../../../entity/authentication-method/external-authentication-method.entity");
+const customer_entity_1 = require("../../../entity/customer/customer.entity");
+const user_entity_1 = require("../../../entity/user/user.entity");
+const administrator_service_1 = require("../../services/administrator.service");
+const channel_service_1 = require("../../services/channel.service");
+const customer_service_1 = require("../../services/customer.service");
+const history_service_1 = require("../../services/history.service");
+const role_service_1 = require("../../services/role.service");
+/**
+ * @description
+ * This is a helper service which exposes methods related to looking up and creating Users based on an
+ * external {@link AuthenticationStrategy}.
+ *
+ * @docsCategory auth
+ */
+let ExternalAuthenticationService = class ExternalAuthenticationService {
+    constructor(connection, roleService, historyService, customerService, administratorService, channelService) {
+        this.connection = connection;
+        this.roleService = roleService;
+        this.historyService = historyService;
+        this.customerService = customerService;
+        this.administratorService = administratorService;
+        this.channelService = channelService;
+    }
+    /**
+     * @description
+     * Looks up a User based on their identifier from an external authentication
+     * provider, ensuring this User is associated with a Customer account.
+     *
+     * By default, only customers in the currently-active Channel will be checked.
+     * By passing `false` as the `checkCurrentChannelOnly` argument, _all_ channels
+     * will be checked.
+     */
+    async findCustomerUser(ctx, strategy, externalIdentifier, checkCurrentChannelOnly = true) {
+        const user = await this.findUser(ctx, strategy, externalIdentifier);
+        if (user) {
+            // Ensure this User is associated with a Customer
+            const customer = await this.customerService.findOneByUserId(ctx, user.id, checkCurrentChannelOnly);
+            if (customer) {
+                return user;
+            }
+        }
+    }
+    /**
+     * @description
+     * Looks up a User based on their identifier from an external authentication
+     * provider, ensuring this User is associated with an Administrator account.
+     */
+    async findAdministratorUser(ctx, strategy, externalIdentifier) {
+        const user = await this.findUser(ctx, strategy, externalIdentifier);
+        if (user) {
+            // Ensure this User is associated with an Administrator
+            const administrator = await this.administratorService.findOneByUserId(ctx, user.id);
+            if (administrator) {
+                return user;
+            }
+        }
+    }
+    /**
+     * @description
+     * If a customer has been successfully authenticated by an external authentication provider, yet cannot
+     * be found using `findCustomerUser`, then we need to create a new User and
+     * Customer record in Deenruv for that user. This method encapsulates that logic as well as additional
+     * housekeeping such as adding a record to the Customer's history.
+     */
+    async createCustomerAndUser(ctx, config) {
+        let user;
+        const existingUser = await this.findExistingCustomerUserByEmailAddress(ctx, config.emailAddress);
+        if (existingUser) {
+            user = existingUser;
+        }
+        else {
+            const customerRole = await this.roleService.getCustomerRole(ctx);
+            user = new user_entity_1.User({
+                identifier: config.emailAddress,
+                roles: [customerRole],
+                verified: config.verified || false,
+                authenticationMethods: [],
+            });
+        }
+        const authMethod = await this.connection
+            .getRepository(ctx, external_authentication_method_entity_1.ExternalAuthenticationMethod)
+            .save(new external_authentication_method_entity_1.ExternalAuthenticationMethod({
+            externalIdentifier: config.externalIdentifier,
+            strategy: config.strategy,
+        }));
+        user.authenticationMethods = [
+            ...(user.authenticationMethods || []),
+            authMethod,
+        ];
+        const savedUser = await this.connection.getRepository(ctx, user_entity_1.User).save(user);
+        let customer;
+        const existingCustomer = await this.customerService.findOneByUserId(ctx, savedUser.id);
+        if (existingCustomer) {
+            customer = existingCustomer;
+        }
+        else {
+            customer = new customer_entity_1.Customer({
+                emailAddress: config.emailAddress,
+                firstName: config.firstName,
+                lastName: config.lastName,
+                user: savedUser,
+            });
+        }
+        await this.channelService.assignToCurrentChannel(customer, ctx);
+        await this.connection.getRepository(ctx, customer_entity_1.Customer).save(customer);
+        await this.historyService.createHistoryEntryForCustomer({
+            customerId: customer.id,
+            ctx,
+            type: generated_types_1.HistoryEntryType.CUSTOMER_REGISTERED,
+            data: {
+                strategy: config.strategy,
+            },
+        });
+        if (config.verified) {
+            await this.historyService.createHistoryEntryForCustomer({
+                customerId: customer.id,
+                ctx,
+                type: generated_types_1.HistoryEntryType.CUSTOMER_VERIFIED,
+                data: {
+                    strategy: config.strategy,
+                },
+            });
+        }
+        return savedUser;
+    }
+    /**
+     * @description
+     * If an administrator has been successfully authenticated by an external authentication provider, yet cannot
+     * be found using `findAdministratorUser`, then we need to create a new User and
+     * Administrator record in Deenruv for that user.
+     */
+    async createAdministratorAndUser(ctx, config) {
+        const newUser = new user_entity_1.User({
+            identifier: config.identifier,
+            roles: config.roles,
+            verified: true,
+        });
+        const authMethod = await this.connection
+            .getRepository(ctx, external_authentication_method_entity_1.ExternalAuthenticationMethod)
+            .save(new external_authentication_method_entity_1.ExternalAuthenticationMethod({
+            externalIdentifier: config.externalIdentifier,
+            strategy: config.strategy,
+        }));
+        newUser.authenticationMethods = [authMethod];
+        const savedUser = await this.connection
+            .getRepository(ctx, user_entity_1.User)
+            .save(newUser);
+        const administrator = await this.connection
+            .getRepository(ctx, administrator_entity_1.Administrator)
+            .save(new administrator_entity_1.Administrator({
+            emailAddress: config.emailAddress,
+            firstName: config.firstName,
+            lastName: config.lastName,
+            user: savedUser,
+        }));
+        return newUser;
+    }
+    async findUser(ctx, strategy, externalIdentifier) {
+        const user = await this.connection
+            .getRepository(ctx, user_entity_1.User)
+            .createQueryBuilder("user")
+            .leftJoinAndSelect("user.authenticationMethods", "aums")
+            .leftJoin("user.authenticationMethods", "authMethod")
+            .andWhere("authMethod.externalIdentifier = :externalIdentifier", {
+            externalIdentifier,
+        })
+            .andWhere("authMethod.strategy = :strategy", { strategy })
+            .andWhere("user.deletedAt IS NULL")
+            .getOne();
+        return user || undefined;
+    }
+    async findExistingCustomerUserByEmailAddress(ctx, emailAddress) {
+        const customer = await this.connection
+            .getRepository(ctx, customer_entity_1.Customer)
+            .createQueryBuilder("customer")
+            .leftJoinAndSelect("customer.user", "user")
+            .leftJoin("customer.channels", "channel")
+            .leftJoinAndSelect("user.authenticationMethods", "authMethod")
+            .andWhere("customer.emailAddress = :emailAddress", { emailAddress })
+            .andWhere("user.deletedAt IS NULL")
+            .getOne();
+        return customer === null || customer === void 0 ? void 0 : customer.user;
+    }
+};
+exports.ExternalAuthenticationService = ExternalAuthenticationService;
+exports.ExternalAuthenticationService = ExternalAuthenticationService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [transactional_connection_1.TransactionalConnection,
+        role_service_1.RoleService,
+        history_service_1.HistoryService,
+        customer_service_1.CustomerService,
+        administrator_service_1.AdministratorService,
+        channel_service_1.ChannelService])
+], ExternalAuthenticationService);
+//# sourceMappingURL=external-authentication.service.js.map

package/dist/service/helpers/external-authentication/external-authentication.service.js.map

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

package/dist/service/helpers/fulfillment-state-machine/fulfillment-state-machine.d.ts

@@ -0,0 +1,19 @@
+import { RequestContext } from "../../../api/common/request-context";
+import { StateMachineConfig } from "../../../common/finite-state-machine/types";
+import { ConfigService } from "../../../config/config.service";
+import { Fulfillment } from "../../../entity/fulfillment/fulfillment.entity";
+import { Order } from "../../../entity/order/order.entity";
+import { FulfillmentState, FulfillmentTransitionData } from "./fulfillment-state";
+export declare class FulfillmentStateMachine {
+    private configService;
+    readonly config: StateMachineConfig<FulfillmentState, FulfillmentTransitionData>;
+    private readonly initialState;
+    constructor(configService: ConfigService);
+    getInitialState(): FulfillmentState;
+    canTransition(currentState: FulfillmentState, newState: FulfillmentState): boolean;
+    getNextStates(fulfillment: Fulfillment): readonly FulfillmentState[];
+    transition(ctx: RequestContext, fulfillment: Fulfillment, orders: Order[], state: FulfillmentState): Promise<{
+        finalize: () => Promise<any>;
+    }>;
+    private initConfig;
+}

package/dist/service/helpers/fulfillment-state-machine/fulfillment-state-machine.js

@@ -0,0 +1,98 @@
+"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.FulfillmentStateMachine = void 0;
+const common_1 = require("@nestjs/common");
+const errors_1 = require("../../../common/error/errors");
+const finite_state_machine_1 = require("../../../common/finite-state-machine/finite-state-machine");
+const merge_transition_definitions_1 = require("../../../common/finite-state-machine/merge-transition-definitions");
+const validate_transition_definition_1 = require("../../../common/finite-state-machine/validate-transition-definition");
+const utils_1 = require("../../../common/utils");
+const config_service_1 = require("../../../config/config.service");
+const deenruv_logger_1 = require("../../../config/logger/deenruv-logger");
+let FulfillmentStateMachine = class FulfillmentStateMachine {
+    constructor(configService) {
+        this.configService = configService;
+        this.initialState = "Created";
+        this.config = this.initConfig();
+    }
+    getInitialState() {
+        return this.initialState;
+    }
+    canTransition(currentState, newState) {
+        return new finite_state_machine_1.FSM(this.config, currentState).canTransitionTo(newState);
+    }
+    getNextStates(fulfillment) {
+        const fsm = new finite_state_machine_1.FSM(this.config, fulfillment.state);
+        return fsm.getNextStates();
+    }
+    async transition(ctx, fulfillment, orders, state) {
+        const fsm = new finite_state_machine_1.FSM(this.config, fulfillment.state);
+        const result = await fsm.transitionTo(state, { ctx, orders, fulfillment });
+        fulfillment.state = fsm.currentState;
+        return result;
+    }
+    initConfig() {
+        var _a, _b;
+        // TODO: remove once the customFulfillmentProcess option is removed
+        const customProcesses = (_a = this.configService.shippingOptions.customFulfillmentProcess) !== null && _a !== void 0 ? _a : [];
+        const processes = [
+            ...customProcesses,
+            ...((_b = this.configService.shippingOptions.process) !== null && _b !== void 0 ? _b : []),
+        ];
+        const allTransitions = processes.reduce((transitions, process) => (0, merge_transition_definitions_1.mergeTransitionDefinitions)(transitions, process.transitions), {});
+        const validationResult = (0, validate_transition_definition_1.validateTransitionDefinition)(allTransitions, this.initialState);
+        if (!validationResult.valid && validationResult.error) {
+            deenruv_logger_1.Logger.error(`The fulfillment process has an invalid configuration:`);
+            throw new Error(validationResult.error);
+        }
+        if (validationResult.valid && validationResult.error) {
+            deenruv_logger_1.Logger.warn(`Fulfillment process: ${validationResult.error}`);
+        }
+        return {
+            transitions: allTransitions,
+            onTransitionStart: async (fromState, toState, data) => {
+                for (const process of processes) {
+                    if (typeof process.onTransitionStart === "function") {
+                        const result = await (0, utils_1.awaitPromiseOrObservable)(process.onTransitionStart(fromState, toState, data));
+                        if (result === false || typeof result === "string") {
+                            return result;
+                        }
+                    }
+                }
+            },
+            onTransitionEnd: async (fromState, toState, data) => {
+                for (const process of processes) {
+                    if (typeof process.onTransitionEnd === "function") {
+                        await (0, utils_1.awaitPromiseOrObservable)(process.onTransitionEnd(fromState, toState, data));
+                    }
+                }
+            },
+            onError: async (fromState, toState, message) => {
+                for (const process of processes) {
+                    if (typeof process.onTransitionError === "function") {
+                        await (0, utils_1.awaitPromiseOrObservable)(process.onTransitionError(fromState, toState, message));
+                    }
+                }
+                throw new errors_1.IllegalOperationError(message || "error.cannot-transition-fulfillment-from-to", {
+                    fromState,
+                    toState,
+                });
+            },
+        };
+    }
+};
+exports.FulfillmentStateMachine = FulfillmentStateMachine;
+exports.FulfillmentStateMachine = FulfillmentStateMachine = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [config_service_1.ConfigService])
+], FulfillmentStateMachine);
+//# sourceMappingURL=fulfillment-state-machine.js.map

package/dist/service/helpers/fulfillment-state-machine/fulfillment-state-machine.js.map

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

package/dist/service/helpers/fulfillment-state-machine/fulfillment-state.d.ts

@@ -0,0 +1,39 @@
+import { RequestContext } from "../../../api/common/request-context";
+import { Fulfillment } from "../../../entity/fulfillment/fulfillment.entity";
+import { Order } from "../../../entity/order/order.entity";
+/**
+ * @description
+ * An interface to extend standard {@link FulfillmentState}.
+ *
+ * @deprecated use FulfillmentStates
+ */
+export interface CustomFulfillmentStates {
+}
+/**
+ * @description
+ * An interface to extend standard {@link FulfillmentState}.
+ *
+ * @docsCategory fulfillment
+ */
+export interface FulfillmentStates {
+}
+/**
+ * @description
+ * These are the default states of the fulfillment process. By default, they will be extended
+ * by the {@link defaultFulfillmentProcess} to also include `Shipped` and `Delivered`.
+ *
+ *
+ * @docsCategory fulfillment
+ */
+export type FulfillmentState = "Created" | "Pending" | "Cancelled" | keyof CustomFulfillmentStates | keyof FulfillmentStates;
+/**
+ * @description
+ * The data which is passed to the state transition handler of the FulfillmentStateMachine.
+ *
+ * @docsCategory fulfillment
+ */
+export interface FulfillmentTransitionData {
+    ctx: RequestContext;
+    orders: Order[];
+    fulfillment: Fulfillment;
+}

package/dist/service/helpers/fulfillment-state-machine/fulfillment-state.js

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

package/dist/service/helpers/fulfillment-state-machine/fulfillment-state.js.map

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

package/dist/service/helpers/list-query-builder/connection-utils.d.ts

@@ -0,0 +1,18 @@
+import { Type } from "@deenruv/common/lib/shared-types";
+import { DataSource } from "typeorm";
+import { ColumnMetadata } from "typeorm/metadata/ColumnMetadata";
+/**
+ * @description
+ * Returns TypeORM ColumnMetadata for the given entity type.
+ */
+export declare function getColumnMetadata<T>(connection: DataSource, entity: Type<T>): {
+    columns: ColumnMetadata[];
+    translationColumns: ColumnMetadata[];
+    alias: string;
+};
+export declare function getEntityAlias<T>(connection: DataSource, entity: Type<T>): string;
+/**
+ * @description
+ * Escapes identifiers in an expression according to the current database driver.
+ */
+export declare function escapeCalculatedColumnExpression(connection: DataSource, expression: string): string;

package/dist/service/helpers/list-query-builder/connection-utils.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.escapeCalculatedColumnExpression = exports.getEntityAlias = exports.getColumnMetadata = void 0;
+/**
+ * @description
+ * Returns TypeORM ColumnMetadata for the given entity type.
+ */
+function getColumnMetadata(connection, entity) {
+    const metadata = connection.getMetadata(entity);
+    const columns = metadata.columns;
+    let translationColumns = [];
+    const relations = metadata.relations;
+    const translationRelation = relations.find((r) => r.propertyName === "translations");
+    if (translationRelation) {
+        const commonFields = [
+            "id",
+            "createdAt",
+            "updatedAt",
+            "languageCode",
+        ];
+        const translationMetadata = connection.getMetadata(translationRelation.type);
+        translationColumns = translationColumns.concat(translationMetadata.columns.filter((c) => !c.relationMetadata && !commonFields.includes(c.propertyName)));
+    }
+    const alias = metadata.name.toLowerCase();
+    return { columns, translationColumns, alias };
+}
+exports.getColumnMetadata = getColumnMetadata;
+function getEntityAlias(connection, entity) {
+    return connection.getMetadata(entity).name.toLowerCase();
+}
+exports.getEntityAlias = getEntityAlias;
+/**
+ * @description
+ * Escapes identifiers in an expression according to the current database driver.
+ */
+function escapeCalculatedColumnExpression(connection, expression) {
+    return expression.replace(/\b([a-z]+[A-Z]\w+)\b/g, (substring) => connection.driver.escape(substring));
+}
+exports.escapeCalculatedColumnExpression = escapeCalculatedColumnExpression;
+//# sourceMappingURL=connection-utils.js.map

package/dist/service/helpers/list-query-builder/connection-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-utils.js","sourceRoot":"","sources":["../../../../src/service/helpers/list-query-builder/connection-utils.ts"],"names":[],"mappings":";;;AAOA;;;GAGG;AACH,SAAgB,iBAAiB,CAAI,UAAsB,EAAE,MAAe;IAC1E,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IACjC,IAAI,kBAAkB,GAAqB,EAAE,CAAC;IAC9C,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;IAErC,MAAM,mBAAmB,GAAG,SAAS,CAAC,IAAI,CACxC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,cAAc,CACzC,CAAC;IACF,IAAI,mBAAmB,EAAE,CAAC;QACxB,MAAM,YAAY,GAAkD;YAClE,IAAI;YACJ,WAAW;YACX,WAAW;YACX,cAAc;SACf,CAAC;QACF,MAAM,mBAAmB,GAAG,UAAU,CAAC,WAAW,CAChD,mBAAmB,CAAC,IAAI,CACzB,CAAC;QACF,kBAAkB,GAAG,kBAAkB,CAAC,MAAM,CAC5C,mBAAmB,CAAC,OAAO,CAAC,MAAM,CAChC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,CAAC,gBAAgB,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAmB,CAAC,CACvE,CACF,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IAC1C,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC;AAChD,CAAC;AA5BD,8CA4BC;AAED,SAAgB,cAAc,CAC5B,UAAsB,EACtB,MAAe;IAEf,OAAO,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;AAC3D,CAAC;AALD,wCAKC;AAED;;;GAGG;AACH,SAAgB,gCAAgC,CAC9C,UAAsB,EACtB,UAAkB;IAElB,OAAO,UAAU,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC,SAAS,EAAE,EAAE,CAC/D,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CACpC,CAAC;AACJ,CAAC;AAPD,4EAOC"}

package/dist/service/helpers/list-query-builder/get-calculated-columns.d.ts

@@ -0,0 +1,7 @@
+import { Type } from "@deenruv/common/lib/shared-types";
+import { CalculatedColumnDefinition } from "../../../common/calculated-decorator";
+/**
+ * @description
+ * Returns calculated columns definitions for the given entity type.
+ */
+export declare function getCalculatedColumns(entity: Type<any>): CalculatedColumnDefinition[];

package/dist/service/helpers/list-query-builder/get-calculated-columns.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCalculatedColumns = void 0;
+const calculated_decorator_1 = require("../../../common/calculated-decorator");
+/**
+ * @description
+ * Returns calculated columns definitions for the given entity type.
+ */
+function getCalculatedColumns(entity) {
+    const calculatedColumns = [];
+    const prototype = entity.prototype;
+    if (prototype.hasOwnProperty(calculated_decorator_1.CALCULATED_PROPERTIES)) {
+        for (const property of prototype[calculated_decorator_1.CALCULATED_PROPERTIES]) {
+            calculatedColumns.push(property);
+        }
+    }
+    return calculatedColumns;
+}
+exports.getCalculatedColumns = getCalculatedColumns;
+//# sourceMappingURL=get-calculated-columns.js.map

package/dist/service/helpers/list-query-builder/get-calculated-columns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-calculated-columns.js","sourceRoot":"","sources":["../../../../src/service/helpers/list-query-builder/get-calculated-columns.ts"],"names":[],"mappings":";;;AAEA,+EAG8C;AAE9C;;;GAGG;AACH,SAAgB,oBAAoB,CAAC,MAAiB;IACpD,MAAM,iBAAiB,GAAiC,EAAE,CAAC;IAC3D,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACnC,IAAI,SAAS,CAAC,cAAc,CAAC,4CAAqB,CAAC,EAAE,CAAC;QACpD,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,4CAAqB,CAAC,EAAE,CAAC;YACxD,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AATD,oDASC"}