@memberjunction/core-actions 2.53.0 → 2.55.0

package/dist/custom/data/xml-parser.action.js

@@ -0,0 +1,326 @@
+"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.LoadXMLParserAction = exports.XMLParserAction = void 0;
+const global_1 = require("@memberjunction/global");
+const base_file_handler_1 = require("../utilities/base-file-handler");
+const xml2js = __importStar(require("xml2js"));
+const xpath = __importStar(require("xpath"));
+const xmldom_1 = require("@xmldom/xmldom");
+const json_param_helper_1 = require("../utilities/json-param-helper");
+/**
+ * Action that parses XML data and extracts content using XPath expressions
+ * Supports namespaces, various return types, and multiple input sources
+ *
+ * @example
+ * ```typescript
+ * // Parse XML and extract with XPath
+ * await runAction({
+ *   ActionName: 'XML Parser',
+ *   Params: [{
+ *     Name: 'XMLData',
+ *     Value: '<users><user id="1"><name>John</name></user><user id="2"><name>Jane</name></user></users>'
+ *   }, {
+ *     Name: 'XPathExpression',
+ *     Value: '//user[@id="1"]/name/text()'
+ *   }]
+ * });
+ *
+ * // Parse XML with namespaces
+ * await runAction({
+ *   ActionName: 'XML Parser',
+ *   Params: [{
+ *     Name: 'XMLData',
+ *     Value: '<ns:root xmlns:ns="http://example.com"><ns:value>Test</ns:value></ns:root>'
+ *   }, {
+ *     Name: 'XPathExpression',
+ *     Value: '//ns:value/text()'
+ *   }, {
+ *     Name: 'NamespaceMap',
+ *     Value: { ns: 'http://example.com' }
+ *   }]
+ * });
+ *
+ * // Convert entire XML to JSON
+ * await runAction({
+ *   ActionName: 'XML Parser',
+ *   Params: [{
+ *     Name: 'XMLData',
+ *     Value: '<root><item>Value 1</item><item>Value 2</item></root>'
+ *   }]
+ * });
+ * ```
+ */
+let XMLParserAction = class XMLParserAction extends base_file_handler_1.BaseFileHandlerAction {
+    /**
+     * Parses XML and extracts data using XPath expressions
+     *
+     * @param params - The action parameters containing:
+     *   - XMLData: String containing XML data (direct input)
+     *   - FileID: UUID of MJ Storage file (alternative)
+     *   - FileURL: URL of XML file (alternative)
+     *   - XPathExpression: XPath query to extract data (optional - if not provided, converts entire XML to JSON)
+     *   - NamespaceMap: Object mapping namespace prefixes to URIs
+     *   - ReturnType: "string" | "number" | "boolean" | "node" | "nodes" | "json" (default: "string")
+     *   - PreserveAttributes: Boolean - include attributes in JSON conversion (default: true)
+     *   - ExplicitArray: Boolean - always put child nodes in array (default: false)
+     *   - IgnoreAttributes: Boolean - ignore attributes in conversion (default: false)
+     *
+     * @returns Extracted data based on XPath or full JSON conversion
+     */
+    async InternalRunAction(params) {
+        try {
+            // Get file content from various sources
+            const fileContent = await this.getFileContent(params, 'xmldata');
+            // Get parameters
+            const xpathExpression = this.getParamValue(params, 'xpathexpression');
+            const namespaceMap = json_param_helper_1.JSONParamHelper.getJSONParam(params, 'namespacemap') || {};
+            const returnType = (this.getParamValue(params, 'returntype') || 'string').toLowerCase();
+            const preserveAttributes = this.getBooleanParam(params, 'preserveattributes', true);
+            const explicitArray = this.getBooleanParam(params, 'explicitarray', false);
+            const ignoreAttributes = this.getBooleanParam(params, 'ignoreattributes', false);
+            // Convert Buffer to string if necessary
+            const xmlString = typeof fileContent.content === 'string'
+                ? fileContent.content
+                : fileContent.content.toString();
+            // Validate XML
+            if (!xmlString.trim()) {
+                return {
+                    Success: false,
+                    Message: "XML data is empty",
+                    ResultCode: "EMPTY_DATA"
+                };
+            }
+            let result;
+            if (xpathExpression) {
+                // Use XPath to extract specific data
+                result = await this.extractWithXPath(xmlString, xpathExpression, namespaceMap, returnType);
+            }
+            else {
+                // Convert entire XML to JSON
+                result = await this.convertToJSON(xmlString, {
+                    preserveAttributes,
+                    explicitArray,
+                    ignoreAttributes
+                });
+            }
+            // Prepare output
+            const output = {
+                result: result,
+                source: fileContent.source,
+                fileName: fileContent.fileName,
+                extractionMethod: xpathExpression ? 'xpath' : 'full-conversion'
+            };
+            if (xpathExpression) {
+                output['xpath'] = xpathExpression;
+                output['returnType'] = returnType;
+                if (Object.keys(namespaceMap).length > 0) {
+                    output['namespaces'] = namespaceMap;
+                }
+            }
+            return {
+                Success: true,
+                ResultCode: "SUCCESS",
+                Message: JSON.stringify(output, null, 2)
+            };
+        }
+        catch (error) {
+            return {
+                Success: false,
+                Message: `Failed to parse XML: ${error instanceof Error ? error.message : String(error)}`,
+                ResultCode: "FAILED"
+            };
+        }
+    }
+    /**
+     * Extract data using XPath
+     */
+    async extractWithXPath(xmlString, xpathExpression, namespaceMap, returnType) {
+        try {
+            const doc = new xmldom_1.DOMParser().parseFromString(xmlString, 'text/xml');
+            // Check for parsing errors
+            const parseError = doc.getElementsByTagName('parsererror');
+            if (parseError.length > 0) {
+                throw new Error('XML parsing error: ' + parseError[0].textContent);
+            }
+            let nodes;
+            if (Object.keys(namespaceMap).length > 0) {
+                // Use namespace resolver
+                const select = xpath.useNamespaces(namespaceMap);
+                nodes = select(xpathExpression, doc);
+            }
+            else {
+                // No namespaces
+                nodes = xpath.select(xpathExpression, doc);
+            }
+            // Process results based on return type
+            switch (returnType) {
+                case 'string':
+                    if (Array.isArray(nodes)) {
+                        return nodes.map(n => this.nodeToString(n));
+                    }
+                    return this.nodeToString(nodes);
+                case 'number':
+                    const numResult = Array.isArray(nodes) ? nodes[0] : nodes;
+                    return Number(this.nodeToString(numResult));
+                case 'boolean':
+                    return Boolean(nodes && (Array.isArray(nodes) ? nodes.length > 0 : true));
+                case 'node':
+                    if (Array.isArray(nodes) && nodes.length > 0) {
+                        return this.nodeToJSON(nodes[0]);
+                    }
+                    return nodes ? this.nodeToJSON(nodes) : null;
+                case 'nodes':
+                    if (Array.isArray(nodes)) {
+                        return nodes.map(n => this.nodeToJSON(n));
+                    }
+                    return nodes ? [this.nodeToJSON(nodes)] : [];
+                case 'json':
+                default:
+                    if (Array.isArray(nodes)) {
+                        return nodes.map(n => this.nodeToJSON(n));
+                    }
+                    return nodes ? this.nodeToJSON(nodes) : null;
+            }
+        }
+        catch (error) {
+            throw new Error(`XPath extraction failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Convert node to string
+     */
+    nodeToString(node) {
+        if (!node)
+            return '';
+        if (typeof node === 'string')
+            return node;
+        if (node.nodeValue !== undefined)
+            return node.nodeValue;
+        if (node.textContent !== undefined)
+            return node.textContent;
+        if (node.data !== undefined)
+            return node.data;
+        return node.toString();
+    }
+    /**
+     * Convert node to JSON representation
+     */
+    nodeToJSON(node) {
+        if (!node)
+            return null;
+        // Text node
+        if (node.nodeType === 3) {
+            return node.nodeValue;
+        }
+        // Attribute node
+        if (node.nodeType === 2) {
+            return node.nodeValue;
+        }
+        // Element node
+        if (node.nodeType === 1) {
+            const result = {};
+            // Add attributes
+            if (node.attributes && node.attributes.length > 0) {
+                result['@attributes'] = {};
+                for (let i = 0; i < node.attributes.length; i++) {
+                    const attr = node.attributes[i];
+                    result['@attributes'][attr.nodeName] = attr.nodeValue;
+                }
+            }
+            // Add child nodes
+            if (node.childNodes && node.childNodes.length > 0) {
+                for (let i = 0; i < node.childNodes.length; i++) {
+                    const child = node.childNodes[i];
+                    if (child.nodeType === 1) { // Element
+                        const childName = child.nodeName;
+                        const childValue = this.nodeToJSON(child);
+                        if (result[childName]) {
+                            // Convert to array if multiple children with same name
+                            if (!Array.isArray(result[childName])) {
+                                result[childName] = [result[childName]];
+                            }
+                            result[childName].push(childValue);
+                        }
+                        else {
+                            result[childName] = childValue;
+                        }
+                    }
+                    else if (child.nodeType === 3 && child.nodeValue.trim()) { // Text
+                        result['@text'] = child.nodeValue;
+                    }
+                }
+            }
+            // If only text content, return it directly
+            if (Object.keys(result).length === 1 && result['@text']) {
+                return result['@text'];
+            }
+            return result;
+        }
+        return null;
+    }
+    /**
+     * Convert entire XML to JSON using xml2js
+     */
+    async convertToJSON(xmlString, options) {
+        const parser = new xml2js.Parser({
+            explicitArray: options.explicitArray,
+            ignoreAttrs: options.ignoreAttributes,
+            preserveChildrenOrder: true,
+            explicitCharkey: true,
+            trim: true,
+            normalize: true,
+            normalizeTags: false
+        });
+        return new Promise((resolve, reject) => {
+            parser.parseString(xmlString, (err, result) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve(result);
+                }
+            });
+        });
+    }
+};
+exports.XMLParserAction = XMLParserAction;
+exports.XMLParserAction = XMLParserAction = __decorate([
+    (0, global_1.RegisterClass)(base_file_handler_1.BaseFileHandlerAction, "XML Parser")
+], XMLParserAction);
+/**
+ * Loader function to ensure the XMLParserAction class is included in the bundle
+ */
+function LoadXMLParserAction() {
+    // Stub function to prevent tree shaking
+}
+exports.LoadXMLParserAction = LoadXMLParserAction;
+//# sourceMappingURL=xml-parser.action.js.map

package/dist/custom/data/xml-parser.action.js.map

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

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

@@ -0,0 +1,86 @@
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { BaseFileHandlerAction } from "../utilities/base-file-handler";
+/**
+ * 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'
+ *   }]
+ * });
+ * ```
+ */
+export declare class ExcelReaderAction extends 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
+     */
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    /**
+     * Check if string is base64 encoded
+     */
+    private isBase64;
+    /**
+     * Extract data from worksheet
+     */
+    private extractSheetData;
+    /**
+     * Get cell value with proper type handling
+     */
+    private getCellValue;
+    /**
+     * Convert column letter to number (A=1, B=2, etc.)
+     */
+    private columnToNumber;
+}
+/**
+ * Loader function to ensure the ExcelReaderAction class is included in the bundle
+ */
+export declare function LoadExcelReaderAction(): void;
+//# sourceMappingURL=excel-reader.action.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"excel-reader.action.d.ts","sourceRoot":"","sources":["../../../src/custom/files/excel-reader.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAGvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,qBACa,iBAAkB,SAAQ,qBAAqB;IAExD;;;;;;;;;;;;;;;;OAgBG;cACa,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA6GvF;;OAEG;IACH,OAAO,CAAC,QAAQ;IAQhB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiFxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAgDpB;;OAEG;IACH,OAAO,CAAC,cAAc;CAOzB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,SAEpC"}