@memberjunction/core-actions 2.54.0 → 2.56.0

package/dist/custom/data/aggregate-data.action.d.ts

@@ -0,0 +1,91 @@
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { BaseAction } from "@memberjunction/actions";
+/**
+ * Action that performs aggregation operations on arrays of data
+ * Supports grouping, counting, summing, averaging, and other statistical operations
+ *
+ * @example
+ * ```typescript
+ * // Simple aggregation
+ * await runAction({
+ *   ActionName: 'Aggregate Data',
+ *   Params: [{
+ *     Name: 'InputData',
+ *     Value: [
+ *       { category: 'A', value: 10 },
+ *       { category: 'A', value: 20 },
+ *       { category: 'B', value: 15 }
+ *     ]
+ *   }, {
+ *     Name: 'Aggregations',
+ *     Value: [
+ *       { field: 'value', operation: 'sum', outputName: 'totalValue' },
+ *       { field: 'value', operation: 'avg', outputName: 'avgValue' }
+ *     ]
+ *   }]
+ * });
+ *
+ * // Group by aggregation
+ * await runAction({
+ *   ActionName: 'Aggregate Data',
+ *   Params: [{
+ *     Name: 'InputData',
+ *     Value: salesData
+ *   }, {
+ *     Name: 'GroupBy',
+ *     Value: ['region', 'product']
+ *   }, {
+ *     Name: 'Aggregations',
+ *     Value: [
+ *       { field: 'sales', operation: 'sum', outputName: 'totalSales' },
+ *       { field: 'sales', operation: 'count', outputName: 'transactionCount' }
+ *     ]
+ *   }]
+ * });
+ * ```
+ */
+export declare class AggregateDataAction extends BaseAction {
+    /**
+     * Performs aggregation operations on data arrays
+     *
+     * @param params - The action parameters containing:
+     *   - InputData: Array of objects to aggregate
+     *   - GroupBy: Field name(s) to group by (string or array, optional)
+     *   - Aggregations: Array of aggregation specifications
+     *   - IncludeEmptyGroups: Include groups with no data (default: false)
+     *   - SortBy: Field to sort results by (optional)
+     *   - SortOrder: "asc" | "desc" (default: "asc")
+     *
+     * @returns Aggregated results
+     */
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    /**
+     * Aggregate without grouping (single result)
+     */
+    private aggregateWithoutGrouping;
+    /**
+     * Aggregate with grouping (multiple results)
+     */
+    private aggregateWithGrouping;
+    /**
+     * Calculate a single aggregation
+     */
+    private calculateAggregation;
+    /**
+     * Get numeric value, handling null/undefined
+     */
+    private getNumericValue;
+    /**
+     * Calculate standard deviation
+     */
+    private calculateStandardDeviation;
+    /**
+     * Calculate variance
+     */
+    private calculateVariance;
+}
+/**
+ * Loader function to ensure the AggregateDataAction class is included in the bundle
+ */
+export declare function LoadAggregateDataAction(): void;
+//# sourceMappingURL=aggregate-data.action.d.ts.map

package/dist/custom/data/aggregate-data.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate-data.action.d.ts","sourceRoot":"","sources":["../../../src/custom/data/aggregate-data.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAIrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,qBACa,mBAAoB,SAAQ,UAAU;IAE/C;;;;;;;;;;;;OAYG;cACa,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA2IvF;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAUhC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAmC7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA0D5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAKlC;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAQ5B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,SAEtC"}

package/dist/custom/data/aggregate-data.action.js

@@ -0,0 +1,333 @@
+"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.LoadAggregateDataAction = exports.AggregateDataAction = void 0;
+const actions_1 = require("@memberjunction/actions");
+const global_1 = require("@memberjunction/global");
+const json_param_helper_1 = require("../utilities/json-param-helper");
+/**
+ * Action that performs aggregation operations on arrays of data
+ * Supports grouping, counting, summing, averaging, and other statistical operations
+ *
+ * @example
+ * ```typescript
+ * // Simple aggregation
+ * await runAction({
+ *   ActionName: 'Aggregate Data',
+ *   Params: [{
+ *     Name: 'InputData',
+ *     Value: [
+ *       { category: 'A', value: 10 },
+ *       { category: 'A', value: 20 },
+ *       { category: 'B', value: 15 }
+ *     ]
+ *   }, {
+ *     Name: 'Aggregations',
+ *     Value: [
+ *       { field: 'value', operation: 'sum', outputName: 'totalValue' },
+ *       { field: 'value', operation: 'avg', outputName: 'avgValue' }
+ *     ]
+ *   }]
+ * });
+ *
+ * // Group by aggregation
+ * await runAction({
+ *   ActionName: 'Aggregate Data',
+ *   Params: [{
+ *     Name: 'InputData',
+ *     Value: salesData
+ *   }, {
+ *     Name: 'GroupBy',
+ *     Value: ['region', 'product']
+ *   }, {
+ *     Name: 'Aggregations',
+ *     Value: [
+ *       { field: 'sales', operation: 'sum', outputName: 'totalSales' },
+ *       { field: 'sales', operation: 'count', outputName: 'transactionCount' }
+ *     ]
+ *   }]
+ * });
+ * ```
+ */
+let AggregateDataAction = class AggregateDataAction extends actions_1.BaseAction {
+    /**
+     * Performs aggregation operations on data arrays
+     *
+     * @param params - The action parameters containing:
+     *   - InputData: Array of objects to aggregate
+     *   - GroupBy: Field name(s) to group by (string or array, optional)
+     *   - Aggregations: Array of aggregation specifications
+     *   - IncludeEmptyGroups: Include groups with no data (default: false)
+     *   - SortBy: Field to sort results by (optional)
+     *   - SortOrder: "asc" | "desc" (default: "asc")
+     *
+     * @returns Aggregated results
+     */
+    async InternalRunAction(params) {
+        try {
+            // Extract parameters
+            let inputData;
+            let aggregations;
+            try {
+                inputData = json_param_helper_1.JSONParamHelper.getRequiredJSONParam(params, 'InputData');
+            }
+            catch (error) {
+                return {
+                    Success: false,
+                    Message: error instanceof Error ? error.message : String(error),
+                    ResultCode: "MISSING_PARAMETERS"
+                };
+            }
+            try {
+                aggregations = json_param_helper_1.JSONParamHelper.getRequiredJSONParam(params, 'Aggregations');
+            }
+            catch (error) {
+                return {
+                    Success: false,
+                    Message: error instanceof Error ? error.message : String(error),
+                    ResultCode: "MISSING_PARAMETERS"
+                };
+            }
+            const groupByParam = params.Params.find(p => p.Name.trim().toLowerCase() === 'groupby');
+            const includeEmptyGroupsParam = params.Params.find(p => p.Name.trim().toLowerCase() === 'includeemptygroups');
+            const sortByParam = params.Params.find(p => p.Name.trim().toLowerCase() === 'sortby');
+            const sortOrderParam = params.Params.find(p => p.Name.trim().toLowerCase() === 'sortorder');
+            if (!Array.isArray(inputData)) {
+                return {
+                    Success: false,
+                    Message: "InputData must be an array",
+                    ResultCode: "INVALID_INPUT_DATA"
+                };
+            }
+            // Parse group by fields
+            let groupByFields = [];
+            if (groupByParam?.Value) {
+                if (typeof groupByParam.Value === 'string') {
+                    groupByFields = [groupByParam.Value];
+                }
+                else if (Array.isArray(groupByParam.Value)) {
+                    groupByFields = groupByParam.Value;
+                }
+                else {
+                    return {
+                        Success: false,
+                        Message: "GroupBy must be a string or array of strings",
+                        ResultCode: "INVALID_GROUP_BY"
+                    };
+                }
+            }
+            if (!Array.isArray(aggregations)) {
+                return {
+                    Success: false,
+                    Message: "Aggregations must be an array",
+                    ResultCode: "INVALID_AGGREGATIONS"
+                };
+            }
+            // Validate aggregations
+            const validOperations = ['sum', 'avg', 'min', 'max', 'count', 'countDistinct', 'first', 'last', 'stdDev', 'variance'];
+            for (const agg of aggregations) {
+                if (!agg.operation || !validOperations.includes(agg.operation)) {
+                    return {
+                        Success: false,
+                        Message: `Invalid operation: ${agg.operation}. Valid operations are: ${validOperations.join(', ')}`,
+                        ResultCode: "INVALID_OPERATION"
+                    };
+                }
+                if (!agg.outputName) {
+                    return {
+                        Success: false,
+                        Message: "Each aggregation must have an outputName",
+                        ResultCode: "MISSING_OUTPUT_NAME"
+                    };
+                }
+            }
+            // Get other parameters
+            const includeEmptyGroups = includeEmptyGroupsParam?.Value?.toString()?.toLowerCase() === 'true' ?? false;
+            const sortBy = sortByParam?.Value?.toString();
+            const sortOrder = (sortOrderParam?.Value?.toString() || 'asc').toLowerCase();
+            // Perform aggregation
+            let result;
+            if (groupByFields.length > 0) {
+                result = this.aggregateWithGrouping(inputData, groupByFields, aggregations, includeEmptyGroups);
+            }
+            else {
+                result = this.aggregateWithoutGrouping(inputData, aggregations);
+            }
+            // Sort results if requested
+            if (sortBy && Array.isArray(result)) {
+                result.sort((a, b) => {
+                    const aVal = a[sortBy];
+                    const bVal = b[sortBy];
+                    if (aVal === bVal)
+                        return 0;
+                    if (aVal === null || aVal === undefined)
+                        return 1;
+                    if (bVal === null || bVal === undefined)
+                        return -1;
+                    const comparison = aVal < bVal ? -1 : 1;
+                    return sortOrder === 'asc' ? comparison : -comparison;
+                });
+            }
+            // Prepare output
+            const output = {
+                result: result,
+                rowCount: Array.isArray(result) ? result.length : 1,
+                inputRowCount: inputData.length,
+                groupBy: groupByFields.length > 0 ? groupByFields : undefined,
+                aggregations: aggregations.map(a => ({
+                    field: a.field,
+                    operation: a.operation,
+                    outputName: a.outputName
+                }))
+            };
+            return {
+                Success: true,
+                ResultCode: "SUCCESS",
+                Message: JSON.stringify(output, null, 2)
+            };
+        }
+        catch (error) {
+            return {
+                Success: false,
+                Message: `Failed to aggregate data: ${error instanceof Error ? error.message : String(error)}`,
+                ResultCode: "FAILED"
+            };
+        }
+    }
+    /**
+     * Aggregate without grouping (single result)
+     */
+    aggregateWithoutGrouping(data, aggregations) {
+        const result = {};
+        for (const agg of aggregations) {
+            result[agg.outputName] = this.calculateAggregation(data, agg);
+        }
+        return result;
+    }
+    /**
+     * Aggregate with grouping (multiple results)
+     */
+    aggregateWithGrouping(data, groupByFields, aggregations, includeEmptyGroups) {
+        // Group the data
+        const groups = new Map();
+        for (const item of data) {
+            const key = groupByFields.map(field => item[field] ?? 'null').join('|');
+            if (!groups.has(key)) {
+                groups.set(key, []);
+            }
+            groups.get(key).push(item);
+        }
+        // Calculate aggregations for each group
+        const results = [];
+        for (const [key, groupData] of groups) {
+            const result = {};
+            // Add group by values
+            const keyParts = key.split('|');
+            groupByFields.forEach((field, index) => {
+                result[field] = keyParts[index] === 'null' ? null : groupData[0][field];
+            });
+            // Calculate aggregations
+            for (const agg of aggregations) {
+                result[agg.outputName] = this.calculateAggregation(groupData, agg);
+            }
+            results.push(result);
+        }
+        return results;
+    }
+    /**
+     * Calculate a single aggregation
+     */
+    calculateAggregation(data, aggregation) {
+        if (data.length === 0) {
+            return aggregation.operation === 'count' ? 0 : null;
+        }
+        switch (aggregation.operation) {
+            case 'count':
+                return data.length;
+            case 'countDistinct':
+                if (!aggregation.field)
+                    return data.length;
+                const uniqueValues = new Set(data.map(item => item[aggregation.field]));
+                return uniqueValues.size;
+            case 'sum':
+                return data.reduce((sum, item) => {
+                    const value = this.getNumericValue(item[aggregation.field]);
+                    return sum + (value ?? 0);
+                }, 0);
+            case 'avg':
+                const total = data.reduce((sum, item) => {
+                    const value = this.getNumericValue(item[aggregation.field]);
+                    return sum + (value ?? 0);
+                }, 0);
+                return total / data.length;
+            case 'min':
+                return data.reduce((min, item) => {
+                    const value = item[aggregation.field];
+                    if (value === null || value === undefined)
+                        return min;
+                    return min === null || value < min ? value : min;
+                }, null);
+            case 'max':
+                return data.reduce((max, item) => {
+                    const value = item[aggregation.field];
+                    if (value === null || value === undefined)
+                        return max;
+                    return max === null || value > max ? value : max;
+                }, null);
+            case 'first':
+                return data[0][aggregation.field];
+            case 'last':
+                return data[data.length - 1][aggregation.field];
+            case 'stdDev':
+                return this.calculateStandardDeviation(data, aggregation.field);
+            case 'variance':
+                return this.calculateVariance(data, aggregation.field);
+            default:
+                return null;
+        }
+    }
+    /**
+     * Get numeric value, handling null/undefined
+     */
+    getNumericValue(value) {
+        if (value === null || value === undefined)
+            return null;
+        const num = Number(value);
+        return isNaN(num) ? null : num;
+    }
+    /**
+     * Calculate standard deviation
+     */
+    calculateStandardDeviation(data, field) {
+        const variance = this.calculateVariance(data, field);
+        return variance === null ? null : Math.sqrt(variance);
+    }
+    /**
+     * Calculate variance
+     */
+    calculateVariance(data, field) {
+        const values = data.map(item => this.getNumericValue(item[field])).filter(v => v !== null);
+        if (values.length === 0)
+            return null;
+        const mean = values.reduce((sum, val) => sum + val, 0) / values.length;
+        const squaredDifferences = values.map(val => Math.pow(val - mean, 2));
+        return squaredDifferences.reduce((sum, val) => sum + val, 0) / values.length;
+    }
+};
+exports.AggregateDataAction = AggregateDataAction;
+exports.AggregateDataAction = AggregateDataAction = __decorate([
+    (0, global_1.RegisterClass)(actions_1.BaseAction, "Aggregate Data")
+], AggregateDataAction);
+/**
+ * Loader function to ensure the AggregateDataAction class is included in the bundle
+ */
+function LoadAggregateDataAction() {
+    // Stub function to prevent tree shaking
+}
+exports.LoadAggregateDataAction = LoadAggregateDataAction;
+//# sourceMappingURL=aggregate-data.action.js.map

package/dist/custom/data/aggregate-data.action.js.map

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

package/dist/custom/data/csv-parser.action.d.ts

@@ -0,0 +1,68 @@
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { BaseFileHandlerAction } from "../utilities/base-file-handler";
+/**
+ * Action that parses CSV data into structured JSON format
+ * Supports multiple input sources, custom delimiters, and various parsing options
+ *
+ * @example
+ * ```typescript
+ * // Parse CSV with headers
+ * await runAction({
+ *   ActionName: 'CSV Parser',
+ *   Params: [{
+ *     Name: 'CSVData',
+ *     Value: 'Name,Age,City\nJohn,30,NYC\nJane,25,LA'
+ *   }]
+ * });
+ *
+ * // Parse CSV from URL with custom delimiter
+ * await runAction({
+ *   ActionName: 'CSV Parser',
+ *   Params: [{
+ *     Name: 'FileURL',
+ *     Value: 'https://example.com/data.csv'
+ *   }, {
+ *     Name: 'Delimiter',
+ *     Value: ';'
+ *   }]
+ * });
+ *
+ * // Parse CSV without headers
+ * await runAction({
+ *   ActionName: 'CSV Parser',
+ *   Params: [{
+ *     Name: 'CSVData',
+ *     Value: 'John,30,NYC\nJane,25,LA'
+ *   }, {
+ *     Name: 'HasHeaders',
+ *     Value: false
+ *   }]
+ * });
+ * ```
+ */
+export declare class CSVParserAction extends BaseFileHandlerAction {
+    /**
+     * Parses CSV data into JSON format
+     *
+     * @param params - The action parameters containing:
+     *   - CSVData: String containing CSV data (direct input)
+     *   - FileID: UUID of MJ Storage file (alternative)
+     *   - FileURL: URL of CSV file (alternative)
+     *   - HasHeaders: Boolean indicating if first row contains headers (default: true)
+     *   - Delimiter: Field delimiter character (default: ",")
+     *   - QuoteChar: Character used to quote fields (default: '"')
+     *   - EscapeChar: Character used to escape quotes (default: '"')
+     *   - SkipEmptyRows: Skip empty rows (default: true)
+     *   - TrimValues: Trim whitespace from values (default: true)
+     *   - DynamicTyping: Convert numeric strings to numbers (default: true)
+     *   - MaxRows: Maximum number of rows to parse (optional)
+     *
+     * @returns Parsed CSV data as array of objects (if headers) or array of arrays
+     */
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+}
+/**
+ * Loader function to ensure the CSVParserAction class is included in the bundle
+ */
+export declare function LoadCSVParserAction(): void;
+//# sourceMappingURL=csv-parser.action.d.ts.map

package/dist/custom/data/csv-parser.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-parser.action.d.ts","sourceRoot":"","sources":["../../../src/custom/data/csv-parser.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAGvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,qBACa,eAAgB,SAAQ,qBAAqB;IAEtD;;;;;;;;;;;;;;;;;OAiBG;cACa,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAwF1F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,SAElC"}