@memberjunction/core-actions 2.54.0 → 2.55.0

package/dist/custom/files/excel-reader.action.js

@@ -0,0 +1,348 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+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 __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoadExcelReaderAction = exports.ExcelReaderAction = void 0;
+const global_1 = require("@memberjunction/global");
+const base_file_handler_1 = require("../utilities/base-file-handler");
+const ExcelJS = __importStar(require("exceljs"));
+/**
+ * Action that reads Excel files and converts them to JSON format
+ * Supports multiple sheets, ranges, and various data types
+ *
+ * @example
+ * ```typescript
+ * // Read entire Excel file
+ * await runAction({
+ *   ActionName: 'Excel Reader',
+ *   Params: [{
+ *     Name: 'FileURL',
+ *     Value: 'https://example.com/data.xlsx'
+ *   }]
+ * });
+ *
+ * // Read specific sheet with headers
+ * await runAction({
+ *   ActionName: 'Excel Reader',
+ *   Params: [{
+ *     Name: 'FileID',
+ *     Value: 'uuid-of-excel-file'
+ *   }, {
+ *     Name: 'SheetName',
+ *     Value: 'Sales Data'
+ *   }, {
+ *     Name: 'HasHeaders',
+ *     Value: true
+ *   }]
+ * });
+ *
+ * // Read specific range
+ * await runAction({
+ *   ActionName: 'Excel Reader',
+ *   Params: [{
+ *     Name: 'ExcelData',
+ *     Value: base64ExcelData
+ *   }, {
+ *     Name: 'Range',
+ *     Value: 'A1:D10'
+ *   }]
+ * });
+ * ```
+ */
+let ExcelReaderAction = class ExcelReaderAction extends base_file_handler_1.BaseFileHandlerAction {
+    /**
+     * Reads Excel files and converts to JSON
+     *
+     * @param params - The action parameters containing:
+     *   - FileID: UUID of MJ Storage file (optional)
+     *   - FileURL: URL of Excel file (optional)
+     *   - ExcelData: Base64 encoded Excel data (optional)
+     *   - SheetName: Specific sheet name to read (optional, default: first sheet)
+     *   - SheetIndex: Sheet index (0-based, alternative to SheetName)
+     *   - Range: A1 notation range like 'A1:D10' (optional)
+     *   - HasHeaders: Boolean - first row contains headers (default: true)
+     *   - DateFormat: How to format dates - 'ISO' | 'Excel' | 'Local' (default: 'ISO')
+     *   - EmptyCellValue: Value to use for empty cells (default: null)
+     *   - IncludeHidden: Include hidden rows/columns (default: false)
+     *
+     * @returns Array of objects (if headers) or array of arrays
+     */
+    async InternalRunAction(params) {
+        try {
+            // Get file content
+            const fileContent = await this.getFileContent(params, 'exceldata', 'fileid', 'fileurl');
+            // Get parameters
+            const sheetName = this.getParamValue(params, 'sheetname');
+            const sheetIndex = this.getNumericParam(params, 'sheetindex', -1);
+            const range = this.getParamValue(params, 'range');
+            const hasHeaders = this.getBooleanParam(params, 'hasheaders', true);
+            const dateFormat = this.getParamValue(params, 'dateformat') || 'ISO';
+            const emptyCellValue = this.getParamValue(params, 'emptycellvalue') ?? null;
+            const includeHidden = this.getBooleanParam(params, 'includehidden', false);
+            // Convert to Buffer if needed
+            let excelBuffer;
+            if (typeof fileContent.content === 'string') {
+                // Check if it's base64
+                if (this.isBase64(fileContent.content)) {
+                    excelBuffer = Buffer.from(fileContent.content, 'base64');
+                }
+                else {
+                    excelBuffer = Buffer.from(fileContent.content, 'binary');
+                }
+            }
+            else {
+                excelBuffer = fileContent.content;
+            }
+            // Read Excel file
+            const workbook = new ExcelJS.Workbook();
+            await workbook.xlsx.load(excelBuffer);
+            // Get the target worksheet
+            let worksheet;
+            if (sheetName) {
+                worksheet = workbook.getWorksheet(sheetName);
+                if (!worksheet) {
+                    return {
+                        Success: false,
+                        Message: `Sheet '${sheetName}' not found in Excel file`,
+                        ResultCode: "SHEET_NOT_FOUND"
+                    };
+                }
+            }
+            else if (sheetIndex >= 0) {
+                worksheet = workbook.getWorksheet(sheetIndex + 1); // ExcelJS uses 1-based index
+                if (!worksheet) {
+                    return {
+                        Success: false,
+                        Message: `Sheet index ${sheetIndex} not found in Excel file`,
+                        ResultCode: "SHEET_NOT_FOUND"
+                    };
+                }
+            }
+            else {
+                // Get first worksheet
+                worksheet = workbook.worksheets[0];
+                if (!worksheet) {
+                    return {
+                        Success: false,
+                        Message: "No worksheets found in Excel file",
+                        ResultCode: "NO_SHEETS"
+                    };
+                }
+            }
+            // Extract data
+            const data = this.extractSheetData(worksheet, {
+                range,
+                hasHeaders,
+                dateFormat,
+                emptyCellValue,
+                includeHidden
+            });
+            // Get workbook metadata
+            const metadata = {
+                sheetName: worksheet.name,
+                totalSheets: workbook.worksheets.length,
+                sheetNames: workbook.worksheets.map(ws => ws.name),
+                rowCount: data.rowCount,
+                columnCount: data.columnCount,
+                source: fileContent.source,
+                fileName: fileContent.fileName
+            };
+            // Add output parameter
+            params.Params.push({
+                Name: 'ExtractedData',
+                Type: 'Output',
+                Value: data.data
+            });
+            return {
+                Success: true,
+                ResultCode: "SUCCESS",
+                Message: JSON.stringify({
+                    data: data.data,
+                    ...metadata,
+                    headers: data.headers
+                }, null, 2)
+            };
+        }
+        catch (error) {
+            return {
+                Success: false,
+                Message: `Failed to read Excel file: ${error instanceof Error ? error.message : String(error)}`,
+                ResultCode: "READ_FAILED"
+            };
+        }
+    }
+    /**
+     * Check if string is base64 encoded
+     */
+    isBase64(str) {
+        try {
+            return Buffer.from(str, 'base64').toString('base64') === str;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Extract data from worksheet
+     */
+    extractSheetData(worksheet, options) {
+        const rows = [];
+        let headers = [];
+        let rowCount = 0;
+        let columnCount = 0;
+        // Determine range
+        let startRow = 1;
+        let endRow = worksheet.rowCount;
+        let startCol = 1;
+        let endCol = worksheet.columnCount;
+        if (options.range) {
+            const rangeMatch = options.range.match(/([A-Z]+)(\d+):([A-Z]+)(\d+)/);
+            if (rangeMatch) {
+                startCol = this.columnToNumber(rangeMatch[1]);
+                startRow = parseInt(rangeMatch[2]);
+                endCol = this.columnToNumber(rangeMatch[3]);
+                endRow = parseInt(rangeMatch[4]);
+            }
+        }
+        // Extract headers if present
+        if (options.hasHeaders && startRow <= endRow) {
+            const headerRow = worksheet.getRow(startRow);
+            if (!options.includeHidden && headerRow.hidden) {
+                startRow++;
+            }
+            else {
+                for (let col = startCol; col <= endCol; col++) {
+                    const cell = headerRow.getCell(col);
+                    headers.push(this.getCellValue(cell, options) || `Column${col}`);
+                }
+                startRow++;
+            }
+        }
+        // Extract data rows
+        for (let rowNum = startRow; rowNum <= endRow; rowNum++) {
+            const row = worksheet.getRow(rowNum);
+            // Skip hidden rows if requested
+            if (!options.includeHidden && row.hidden) {
+                continue;
+            }
+            const rowData = options.hasHeaders ? {} : [];
+            let hasData = false;
+            for (let col = startCol; col <= endCol; col++) {
+                const cell = row.getCell(col);
+                const value = this.getCellValue(cell, options);
+                if (value !== null && value !== undefined && value !== '') {
+                    hasData = true;
+                }
+                if (options.hasHeaders) {
+                    const header = headers[col - startCol];
+                    rowData[header] = value;
+                }
+                else {
+                    rowData.push(value);
+                }
+            }
+            // Only add row if it has data
+            if (hasData || options.emptyCellValue !== null) {
+                rows.push(rowData);
+                rowCount++;
+            }
+        }
+        columnCount = endCol - startCol + 1;
+        return {
+            data: rows,
+            headers: options.hasHeaders ? headers : null,
+            rowCount,
+            columnCount
+        };
+    }
+    /**
+     * Get cell value with proper type handling
+     */
+    getCellValue(cell, options) {
+        if (!cell || cell.value === null || cell.value === undefined) {
+            return options.emptyCellValue;
+        }
+        // Handle different cell types
+        switch (cell.type) {
+            case ExcelJS.ValueType.Number:
+                return cell.value;
+            case ExcelJS.ValueType.String:
+                return cell.value;
+            case ExcelJS.ValueType.Date:
+                const date = cell.value;
+                switch (options.dateFormat) {
+                    case 'Excel':
+                        return cell.value; // Return as Excel serial number
+                    case 'Local':
+                        return date.toLocaleString();
+                    case 'ISO':
+                    default:
+                        return date.toISOString();
+                }
+            case ExcelJS.ValueType.Boolean:
+                return cell.value;
+            case ExcelJS.ValueType.Error:
+                return `#ERROR: ${cell.value}`;
+            case ExcelJS.ValueType.Formula:
+                // Return the result of the formula
+                return cell.value.result || options.emptyCellValue;
+            case ExcelJS.ValueType.Hyperlink:
+                const hyperlink = cell.value;
+                return hyperlink.text || hyperlink.hyperlink;
+            case ExcelJS.ValueType.RichText:
+                const richText = cell.value;
+                return richText.richText.map(rt => rt.text).join('');
+            default:
+                return cell.value;
+        }
+    }
+    /**
+     * Convert column letter to number (A=1, B=2, etc.)
+     */
+    columnToNumber(column) {
+        let result = 0;
+        for (let i = 0; i < column.length; i++) {
+            result = result * 26 + (column.charCodeAt(i) - 64);
+        }
+        return result;
+    }
+};
+exports.ExcelReaderAction = ExcelReaderAction;
+exports.ExcelReaderAction = ExcelReaderAction = __decorate([
+    (0, global_1.RegisterClass)(base_file_handler_1.BaseFileHandlerAction, "Excel Reader")
+], ExcelReaderAction);
+/**
+ * Loader function to ensure the ExcelReaderAction class is included in the bundle
+ */
+function LoadExcelReaderAction() {
+    // Stub function to prevent tree shaking
+}
+exports.LoadExcelReaderAction = LoadExcelReaderAction;
+//# sourceMappingURL=excel-reader.action.js.map

package/dist/custom/files/excel-reader.action.js.map

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

package/dist/custom/files/excel-writer.action.d.ts

@@ -0,0 +1,79 @@
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { BaseFileHandlerAction } from "../utilities/base-file-handler";
+/**
+ * Action that creates Excel files from JSON data
+ * Supports multiple sheets, formatting, and formulas
+ *
+ * @example
+ * ```typescript
+ * // Create simple Excel with one sheet
+ * await runAction({
+ *   ActionName: 'Excel Writer',
+ *   Params: [{
+ *     Name: 'Sheets',
+ *     Value: [{
+ *       name: 'Sales Data',
+ *       data: [
+ *         { Product: 'Widget A', Sales: 100, Revenue: 1000 },
+ *         { Product: 'Widget B', Sales: 150, Revenue: 1500 }
+ *       ]
+ *     }]
+ *   }]
+ * });
+ *
+ * // Create Excel with multiple sheets and formatting
+ * await runAction({
+ *   ActionName: 'Excel Writer',
+ *   Params: [{
+ *     Name: 'Sheets',
+ *     Value: [{
+ *       name: 'Q1 Sales',
+ *       data: salesData,
+ *       headers: ['Product', 'Units', 'Revenue'],
+ *       columnWidths: [20, 10, 15],
+ *       styles: {
+ *         headerStyle: { font: { bold: true }, fill: { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FF4472C4' } } }
+ *       }
+ *     }, {
+ *       name: 'Summary',
+ *       data: summaryData
+ *     }]
+ *   }]
+ * });
+ * ```
+ */
+export declare class ExcelWriterAction extends BaseFileHandlerAction {
+    /**
+     * Creates Excel files from JSON data
+     *
+     * @param params - The action parameters containing:
+     *   - Sheets: Array of sheet definitions, each containing:
+     *     - name: Sheet name (required)
+     *     - data: Array of data rows (required)
+     *     - headers: Array of column headers (optional, derived from data if not provided)
+     *     - columnWidths: Array of column widths in characters (optional)
+     *     - styles: Object with style definitions (optional)
+     *     - formulas: Array of formula definitions (optional)
+     *   - OutputFileID: Optional MJ Storage file ID to save to
+     *   - FileName: Name for the generated Excel file (default: 'workbook.xlsx')
+     *   - Author: Author metadata (optional)
+     *   - Title: Title metadata (optional)
+     *   - Description: Description metadata (optional)
+     *
+     * @returns Base64 encoded Excel data or FileID if saved
+     */
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    /**
+     * Populate worksheet with data
+     */
+    private populateWorksheet;
+    /**
+     * Apply style to a row
+     */
+    private applyRowStyle;
+}
+/**
+ * Loader function to ensure the ExcelWriterAction class is included in the bundle
+ */
+export declare function LoadExcelWriterAction(): void;
+//# sourceMappingURL=excel-writer.action.d.ts.map

package/dist/custom/files/excel-writer.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel-writer.action.d.ts","sourceRoot":"","sources":["../../../src/custom/files/excel-writer.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAIvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,qBACa,iBAAkB,SAAQ,qBAAqB;IAExD;;;;;;;;;;;;;;;;;;OAkBG;cACa,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA+HvF;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyFzB;;OAEG;IACH,OAAO,CAAC,aAAa;CAiBxB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,SAEpC"}