@memberjunction/core-actions 2.48.0 → 2.49.0

package/dist/custom/business-days-calculator.action.d.ts

@@ -0,0 +1,65 @@
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { BaseAction } from "@memberjunction/actions";
+/**
+ * Action that calculates business days between two dates, accounting for weekends
+ * and optionally holidays. Can also add/subtract business days from a date.
+ *
+ * @example
+ * ```typescript
+ * // Calculate business days between dates
+ * await runAction({
+ *   ActionName: 'Business Days Calculator',
+ *   Params: [{
+ *     Name: 'Operation',
+ *     Value: 'DaysBetween'
+ *   }, {
+ *     Name: 'StartDate',
+ *     Value: '2024-01-01'
+ *   }, {
+ *     Name: 'EndDate',
+ *     Value: '2024-01-31'
+ *   }]
+ * });
+ *
+ * // Add business days to a date
+ * await runAction({
+ *   ActionName: 'Business Days Calculator',
+ *   Params: [{
+ *     Name: 'Operation',
+ *     Value: 'AddDays'
+ *   }, {
+ *     Name: 'StartDate',
+ *     Value: '2024-01-01'
+ *   }, {
+ *     Name: 'Days',
+ *     Value: 10
+ *   }]
+ * });
+ * ```
+ */
+export declare class BusinessDaysCalculatorAction extends BaseAction {
+    private defaultHolidays;
+    /**
+     * Executes the business days calculation
+     *
+     * @param params - The action parameters containing:
+     *   - Operation: 'DaysBetween', 'AddDays', or 'SubtractDays'
+     *   - StartDate: Starting date (YYYY-MM-DD format)
+     *   - EndDate: Ending date (for DaysBetween operation)
+     *   - Days: Number of business days to add/subtract
+     *   - ExcludeHolidays: Boolean to exclude holidays (default: true)
+     *   - Country: Country code for holiday calendar (default: 'US')
+     *
+     * @returns Business days calculation results
+     */
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    private calculateDaysBetween;
+    private addBusinessDays;
+    private isHoliday;
+    private formatDate;
+}
+/**
+ * Loader function to ensure the BusinessDaysCalculatorAction class is included in the bundle.
+ */
+export declare function LoadBusinessDaysCalculatorAction(): void;
+//# sourceMappingURL=business-days-calculator.action.d.ts.map

package/dist/custom/business-days-calculator.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"business-days-calculator.action.d.ts","sourceRoot":"","sources":["../../src/custom/business-days-calculator.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAe,MAAM,8BAA8B,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBACa,4BAA6B,SAAQ,UAAU;IAExD,OAAO,CAAC,eAAe,CASrB;IAEF;;;;;;;;;;;;OAYG;cACa,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAwGvF,OAAO,CAAC,oBAAoB;IAkD5B,OAAO,CAAC,eAAe;IAqCvB,OAAO,CAAC,SAAS;IAyCjB,OAAO,CAAC,UAAU;CAGrB;AAED;;GAEG;AACH,wBAAgB,gCAAgC,SAE/C"}

package/dist/custom/business-days-calculator.action.js

@@ -0,0 +1,299 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoadBusinessDaysCalculatorAction = exports.BusinessDaysCalculatorAction = void 0;
+const actions_1 = require("@memberjunction/actions");
+const global_1 = require("@memberjunction/global");
+/**
+ * Action that calculates business days between two dates, accounting for weekends
+ * and optionally holidays. Can also add/subtract business days from a date.
+ *
+ * @example
+ * ```typescript
+ * // Calculate business days between dates
+ * await runAction({
+ *   ActionName: 'Business Days Calculator',
+ *   Params: [{
+ *     Name: 'Operation',
+ *     Value: 'DaysBetween'
+ *   }, {
+ *     Name: 'StartDate',
+ *     Value: '2024-01-01'
+ *   }, {
+ *     Name: 'EndDate',
+ *     Value: '2024-01-31'
+ *   }]
+ * });
+ *
+ * // Add business days to a date
+ * await runAction({
+ *   ActionName: 'Business Days Calculator',
+ *   Params: [{
+ *     Name: 'Operation',
+ *     Value: 'AddDays'
+ *   }, {
+ *     Name: 'StartDate',
+ *     Value: '2024-01-01'
+ *   }, {
+ *     Name: 'Days',
+ *     Value: 10
+ *   }]
+ * });
+ * ```
+ */
+let BusinessDaysCalculatorAction = class BusinessDaysCalculatorAction extends actions_1.BaseAction {
+    // US Federal holidays (fixed dates - actual dates may vary)
+    defaultHolidays = {
+        'US': [
+            '01-01', // New Year's Day
+            '07-04', // Independence Day
+            '12-25', // Christmas Day
+            '12-24', // Christmas Eve (many businesses closed)
+            '11-11', // Veterans Day
+            // Note: Some holidays like Memorial Day, Labor Day, Thanksgiving are calculated
+        ]
+    };
+    /**
+     * Executes the business days calculation
+     *
+     * @param params - The action parameters containing:
+     *   - Operation: 'DaysBetween', 'AddDays', or 'SubtractDays'
+     *   - StartDate: Starting date (YYYY-MM-DD format)
+     *   - EndDate: Ending date (for DaysBetween operation)
+     *   - Days: Number of business days to add/subtract
+     *   - ExcludeHolidays: Boolean to exclude holidays (default: true)
+     *   - Country: Country code for holiday calendar (default: 'US')
+     *
+     * @returns Business days calculation results
+     */
+    async InternalRunAction(params) {
+        try {
+            const operationParam = params.Params.find(p => p.Name === 'Operation');
+            const startDateParam = params.Params.find(p => p.Name === 'StartDate');
+            const endDateParam = params.Params.find(p => p.Name === 'EndDate');
+            const daysParam = params.Params.find(p => p.Name === 'Days');
+            const excludeHolidaysParam = params.Params.find(p => p.Name === 'ExcludeHolidays');
+            const countryParam = params.Params.find(p => p.Name === 'Country');
+            if (!operationParam || !operationParam.Value) {
+                return {
+                    Success: false,
+                    Message: "Operation parameter is required (DaysBetween, AddDays, SubtractDays)",
+                    ResultCode: "MISSING_PARAMETERS"
+                };
+            }
+            if (!startDateParam || !startDateParam.Value) {
+                return {
+                    Success: false,
+                    Message: "StartDate parameter is required",
+                    ResultCode: "MISSING_PARAMETERS"
+                };
+            }
+            const operation = operationParam.Value;
+            const startDate = new Date(startDateParam.Value);
+            const excludeHolidays = excludeHolidaysParam?.Value !== false && excludeHolidaysParam?.Value !== 'false';
+            const country = countryParam?.Value || 'US';
+            if (isNaN(startDate.getTime())) {
+                return {
+                    Success: false,
+                    Message: "Invalid StartDate format. Use YYYY-MM-DD",
+                    ResultCode: "INVALID_DATE"
+                };
+            }
+            let result;
+            switch (operation) {
+                case 'DaysBetween':
+                    if (!endDateParam || !endDateParam.Value) {
+                        return {
+                            Success: false,
+                            Message: "EndDate parameter is required for DaysBetween operation",
+                            ResultCode: "MISSING_PARAMETERS"
+                        };
+                    }
+                    const endDate = new Date(endDateParam.Value);
+                    if (isNaN(endDate.getTime())) {
+                        return {
+                            Success: false,
+                            Message: "Invalid EndDate format. Use YYYY-MM-DD",
+                            ResultCode: "INVALID_DATE"
+                        };
+                    }
+                    result = this.calculateDaysBetween(startDate, endDate, excludeHolidays, country);
+                    break;
+                case 'AddDays':
+                case 'SubtractDays':
+                    if (!daysParam || daysParam.Value === undefined) {
+                        return {
+                            Success: false,
+                            Message: "Days parameter is required for Add/Subtract operations",
+                            ResultCode: "MISSING_PARAMETERS"
+                        };
+                    }
+                    const days = parseInt(daysParam.Value.toString());
+                    if (isNaN(days)) {
+                        return {
+                            Success: false,
+                            Message: "Days must be a valid number",
+                            ResultCode: "INVALID_VALUE"
+                        };
+                    }
+                    const daysToAdd = operation === 'AddDays' ? days : -days;
+                    result = this.addBusinessDays(startDate, daysToAdd, excludeHolidays, country);
+                    break;
+                default:
+                    return {
+                        Success: false,
+                        Message: "Invalid operation. Use: DaysBetween, AddDays, or SubtractDays",
+                        ResultCode: "INVALID_OPERATION"
+                    };
+            }
+            return {
+                Success: true,
+                ResultCode: "SUCCESS",
+                Message: JSON.stringify(result, null, 2)
+            };
+        }
+        catch (error) {
+            return {
+                Success: false,
+                Message: `Failed to calculate business days: ${error instanceof Error ? error.message : String(error)}`,
+                ResultCode: "FAILED"
+            };
+        }
+    }
+    calculateDaysBetween(startDate, endDate, excludeHolidays, country) {
+        let start = new Date(startDate);
+        let end = new Date(endDate);
+        const isReverse = start > end;
+        if (isReverse) {
+            [start, end] = [end, start];
+        }
+        let businessDays = 0;
+        let totalDays = 0;
+        let weekends = 0;
+        let holidays = 0;
+        const holidayDates = [];
+        const current = new Date(start);
+        while (current <= end) {
+            totalDays++;
+            const dayOfWeek = current.getDay();
+            const isWeekend = dayOfWeek === 0 || dayOfWeek === 6;
+            const isHoliday = excludeHolidays && this.isHoliday(current, country);
+            if (isWeekend) {
+                weekends++;
+            }
+            else if (isHoliday) {
+                holidays++;
+                holidayDates.push(this.formatDate(current));
+            }
+            else {
+                businessDays++;
+            }
+            current.setDate(current.getDate() + 1);
+        }
+        if (isReverse) {
+            businessDays = -businessDays;
+        }
+        return {
+            businessDays,
+            totalDays: totalDays - 1, // Exclusive of start date
+            weekends,
+            holidays,
+            holidayDates,
+            startDate: this.formatDate(startDate),
+            endDate: this.formatDate(endDate),
+            includesPartialDays: false
+        };
+    }
+    addBusinessDays(startDate, days, excludeHolidays, country) {
+        const result = new Date(startDate);
+        const direction = days >= 0 ? 1 : -1;
+        let remainingDays = Math.abs(days);
+        const skippedDates = [];
+        while (remainingDays > 0) {
+            result.setDate(result.getDate() + direction);
+            const dayOfWeek = result.getDay();
+            const isWeekend = dayOfWeek === 0 || dayOfWeek === 6;
+            const isHoliday = excludeHolidays && this.isHoliday(result, country);
+            if (isWeekend) {
+                skippedDates.push({
+                    date: this.formatDate(result),
+                    reason: dayOfWeek === 0 ? 'Sunday' : 'Saturday'
+                });
+            }
+            else if (isHoliday) {
+                skippedDates.push({
+                    date: this.formatDate(result),
+                    reason: 'Holiday'
+                });
+            }
+            else {
+                remainingDays--;
+            }
+        }
+        return {
+            startDate: this.formatDate(startDate),
+            businessDaysAdded: days,
+            resultDate: this.formatDate(result),
+            dayOfWeek: ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'][result.getDay()],
+            skippedDates: skippedDates.slice(-10), // Last 10 skipped dates
+            totalDaysElapsed: Math.abs(Math.ceil((result.getTime() - startDate.getTime()) / (1000 * 60 * 60 * 24)))
+        };
+    }
+    isHoliday(date, country) {
+        const monthDay = `${String(date.getMonth() + 1).padStart(2, '0')}-${String(date.getDate()).padStart(2, '0')}`;
+        const year = date.getFullYear();
+        // Check fixed holidays
+        const holidays = this.defaultHolidays[country] || [];
+        if (holidays.includes(monthDay)) {
+            return true;
+        }
+        // Check calculated US holidays
+        if (country === 'US') {
+            // Memorial Day (last Monday in May)
+            if (date.getMonth() === 4 && date.getDay() === 1 && date.getDate() > 24) {
+                return true;
+            }
+            // Labor Day (first Monday in September)
+            if (date.getMonth() === 8 && date.getDay() === 1 && date.getDate() <= 7) {
+                return true;
+            }
+            // Thanksgiving (fourth Thursday in November)
+            if (date.getMonth() === 10 && date.getDay() === 4 && date.getDate() >= 22 && date.getDate() <= 28) {
+                return true;
+            }
+            // Black Friday (day after Thanksgiving)
+            if (date.getMonth() === 10 && date.getDay() === 5 && date.getDate() >= 23 && date.getDate() <= 29) {
+                return true;
+            }
+            // Martin Luther King Jr. Day (third Monday in January)
+            if (date.getMonth() === 0 && date.getDay() === 1 && date.getDate() >= 15 && date.getDate() <= 21) {
+                return true;
+            }
+            // Presidents Day (third Monday in February)
+            if (date.getMonth() === 1 && date.getDay() === 1 && date.getDate() >= 15 && date.getDate() <= 21) {
+                return true;
+            }
+        }
+        return false;
+    }
+    formatDate(date) {
+        return date.toISOString().split('T')[0];
+    }
+};
+exports.BusinessDaysCalculatorAction = BusinessDaysCalculatorAction;
+exports.BusinessDaysCalculatorAction = BusinessDaysCalculatorAction = __decorate([
+    (0, global_1.RegisterClass)(actions_1.BaseAction, "__BusinessDaysCalculator")
+], BusinessDaysCalculatorAction);
+/**
+ * Loader function to ensure the BusinessDaysCalculatorAction class is included in the bundle.
+ */
+function LoadBusinessDaysCalculatorAction() {
+    // this function is a stub that is used to force the bundler to include the above class in the final bundle and not tree shake them out
+}
+exports.LoadBusinessDaysCalculatorAction = LoadBusinessDaysCalculatorAction;
+//# sourceMappingURL=business-days-calculator.action.js.map

package/dist/custom/business-days-calculator.action.js.map

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

package/dist/custom/calculate-expression.action.d.ts

@@ -0,0 +1,56 @@
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { BaseAction } from "@memberjunction/actions";
+/**
+ * Action that evaluates mathematical expressions safely using JavaScript's built-in math functions.
+ * Supports basic arithmetic operations, parentheses, and common math functions.
+ *
+ * @example
+ * ```typescript
+ * // Simple arithmetic
+ * await runAction({
+ *   ActionName: 'Calculate Expression',
+ *   Params: [{
+ *     Name: 'Expression',
+ *     Value: '(2 * 3) + 4 / 15'
+ *   }]
+ * });
+ *
+ * // Using math functions
+ * await runAction({
+ *   ActionName: 'Calculate Expression',
+ *   Params: [{
+ *     Name: 'Expression',
+ *     Value: 'sqrt(16) + pow(2, 3) + sin(PI/2)'
+ *   }]
+ * });
+ * ```
+ */
+export declare class CalculateExpressionAction extends BaseAction {
+    /**
+     * Executes the calculation for the provided mathematical expression
+     *
+     * @param params - The action parameters containing:
+     *   - Expression: A mathematical expression to evaluate
+     *
+     * @returns A promise resolving to an ActionResultSimple with:
+     *   - Success: true if calculation was successful
+     *   - ResultCode: "SUCCESS", "INVALID_EXPRESSION", or "FAILED"
+     *   - ResultData: Object containing the result and formatted expression
+     *   - Message: Error message if failed
+     */
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    /**
+     * Checks if the expression contains potentially dangerous code patterns
+     */
+    private containsDangerousCode;
+    /**
+     * Formats a number for display, handling very large/small numbers appropriately
+     */
+    private formatNumber;
+}
+/**
+ * Loader function to ensure the CalculateExpressionAction class is included in the bundle.
+ * This prevents tree-shaking from removing the class during the build process.
+ */
+export declare function LoadCalculateExpressionAction(): void;
+//# sourceMappingURL=calculate-expression.action.d.ts.map

package/dist/custom/calculate-expression.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculate-expression.action.d.ts","sourceRoot":"","sources":["../../src/custom/calculate-expression.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAe,MAAM,8BAA8B,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGrD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBACa,yBAA0B,SAAQ,UAAU;IACrD;;;;;;;;;;;OAWG;cACa,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqHvF;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA2C7B;;OAEG;IACH,OAAO,CAAC,YAAY;CAUvB;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,SAE5C"}

package/dist/custom/calculate-expression.action.js

@@ -0,0 +1,226 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoadCalculateExpressionAction = exports.CalculateExpressionAction = void 0;
+const actions_1 = require("@memberjunction/actions");
+const global_1 = require("@memberjunction/global");
+/**
+ * Action that evaluates mathematical expressions safely using JavaScript's built-in math functions.
+ * Supports basic arithmetic operations, parentheses, and common math functions.
+ *
+ * @example
+ * ```typescript
+ * // Simple arithmetic
+ * await runAction({
+ *   ActionName: 'Calculate Expression',
+ *   Params: [{
+ *     Name: 'Expression',
+ *     Value: '(2 * 3) + 4 / 15'
+ *   }]
+ * });
+ *
+ * // Using math functions
+ * await runAction({
+ *   ActionName: 'Calculate Expression',
+ *   Params: [{
+ *     Name: 'Expression',
+ *     Value: 'sqrt(16) + pow(2, 3) + sin(PI/2)'
+ *   }]
+ * });
+ * ```
+ */
+let CalculateExpressionAction = class CalculateExpressionAction extends actions_1.BaseAction {
+    /**
+     * Executes the calculation for the provided mathematical expression
+     *
+     * @param params - The action parameters containing:
+     *   - Expression: A mathematical expression to evaluate
+     *
+     * @returns A promise resolving to an ActionResultSimple with:
+     *   - Success: true if calculation was successful
+     *   - ResultCode: "SUCCESS", "INVALID_EXPRESSION", or "FAILED"
+     *   - ResultData: Object containing the result and formatted expression
+     *   - Message: Error message if failed
+     */
+    async InternalRunAction(params) {
+        try {
+            const expressionParam = params.Params.find(p => p.Name === 'Expression');
+            if (!expressionParam || !expressionParam.Value) {
+                return {
+                    Success: false,
+                    Message: "Expression parameter is required",
+                    ResultCode: "MISSING_PARAMETERS"
+                };
+            }
+            const expression = expressionParam.Value.trim();
+            // Validate the expression doesn't contain dangerous code
+            if (this.containsDangerousCode(expression)) {
+                return {
+                    Success: false,
+                    Message: "Expression contains invalid or potentially dangerous code",
+                    ResultCode: "INVALID_EXPRESSION"
+                };
+            }
+            // Create a safe evaluation context with math functions
+            const mathContext = {
+                // Basic math functions
+                abs: Math.abs,
+                acos: Math.acos,
+                asin: Math.asin,
+                atan: Math.atan,
+                atan2: Math.atan2,
+                ceil: Math.ceil,
+                cos: Math.cos,
+                exp: Math.exp,
+                floor: Math.floor,
+                log: Math.log,
+                log10: Math.log10,
+                max: Math.max,
+                min: Math.min,
+                pow: Math.pow,
+                random: Math.random,
+                round: Math.round,
+                sin: Math.sin,
+                sqrt: Math.sqrt,
+                tan: Math.tan,
+                // Constants
+                E: Math.E,
+                PI: Math.PI,
+                // Additional useful functions
+                sign: Math.sign,
+                trunc: Math.trunc,
+                cbrt: Math.cbrt,
+                log2: Math.log2,
+                // Hyperbolic functions
+                sinh: Math.sinh,
+                cosh: Math.cosh,
+                tanh: Math.tanh
+            };
+            // Prepare the expression by replacing math function names
+            let safeExpression = expression;
+            // Replace common math notations
+            safeExpression = safeExpression.replace(/\^/g, '**'); // Replace ^ with ** for exponentiation
+            // Create the evaluation function
+            const evalFunction = new Function(...Object.keys(mathContext), `
+                "use strict";
+                try {
+                    return (${safeExpression});
+                } catch (e) {
+                    throw new Error('Invalid expression: ' + e.message);
+                }
+            `);
+            // Evaluate the expression
+            const result = evalFunction(...Object.values(mathContext));
+            // Check if result is a valid number
+            if (typeof result !== 'number' || isNaN(result)) {
+                return {
+                    Success: false,
+                    Message: "Expression did not evaluate to a valid number",
+                    ResultCode: "INVALID_EXPRESSION"
+                };
+            }
+            const resultData = {
+                expression: expression,
+                result: result,
+                formattedResult: this.formatNumber(result),
+                isInteger: Number.isInteger(result),
+                scientificNotation: result.toExponential(),
+                evaluatedAt: new Date().toISOString()
+            };
+            // Include both the simple message and the full result data
+            const message = {
+                summary: `${expression} = ${this.formatNumber(result)}`,
+                details: resultData
+            };
+            return {
+                Success: true,
+                ResultCode: "SUCCESS",
+                Message: JSON.stringify(message, null, 2)
+            };
+        }
+        catch (error) {
+            return {
+                Success: false,
+                Message: `Failed to calculate expression: ${error instanceof Error ? error.message : String(error)}`,
+                ResultCode: "INVALID_EXPRESSION"
+            };
+        }
+    }
+    /**
+     * Checks if the expression contains potentially dangerous code patterns
+     */
+    containsDangerousCode(expression) {
+        // List of dangerous patterns to block
+        const dangerousPatterns = [
+            /import\s/i,
+            /require\s*\(/i,
+            /eval\s*\(/i,
+            /function\s*\(/i,
+            /=>/,
+            /new\s+/i,
+            /\.\s*constructor/i,
+            /\[["'`].*["'`]\]/, // Array access with strings
+            /process\./i,
+            /global\./i,
+            /window\./i,
+            /document\./i,
+            /console\./i,
+            /alert\s*\(/i,
+            /prompt\s*\(/i,
+            /confirm\s*\(/i,
+            /while\s*\(/i,
+            /for\s*\(/i,
+            /do\s*{/i,
+            /if\s*\(/i,
+            /else/i,
+            /return/i,
+            /throw/i,
+            /try/i,
+            /catch/i,
+            /finally/i,
+            /await/i,
+            /async/i,
+            /class\s/i,
+            /extends/i,
+            /\${/, // Template literals
+            /`/, // Backticks
+            /;/, // Semicolons (prevent multiple statements)
+            /{/, // Curly braces (prevent code blocks)
+            /}/,
+        ];
+        return dangerousPatterns.some(pattern => pattern.test(expression));
+    }
+    /**
+     * Formats a number for display, handling very large/small numbers appropriately
+     */
+    formatNumber(num) {
+        if (Number.isInteger(num) && num >= -1e15 && num <= 1e15) {
+            return num.toString();
+        }
+        else if (Math.abs(num) < 1e-6 || Math.abs(num) > 1e15) {
+            return num.toExponential(6);
+        }
+        else {
+            // Round to 10 decimal places and remove trailing zeros
+            return parseFloat(num.toFixed(10)).toString();
+        }
+    }
+};
+exports.CalculateExpressionAction = CalculateExpressionAction;
+exports.CalculateExpressionAction = CalculateExpressionAction = __decorate([
+    (0, global_1.RegisterClass)(actions_1.BaseAction, "__CalculateExpression")
+], CalculateExpressionAction);
+/**
+ * Loader function to ensure the CalculateExpressionAction class is included in the bundle.
+ * This prevents tree-shaking from removing the class during the build process.
+ */
+function LoadCalculateExpressionAction() {
+    // this function is a stub that is used to force the bundler to include the above class in the final bundle and not tree shake them out
+}
+exports.LoadCalculateExpressionAction = LoadCalculateExpressionAction;
+//# sourceMappingURL=calculate-expression.action.js.map