@memberjunction/core-actions 2.106.0 → 2.108.0

package/dist/custom/visualization/create-svg-chart.action.js

@@ -0,0 +1,290 @@
+"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.LoadCreateSVGChartAction = exports.CreateSVGChartAction = void 0;
+const actions_1 = require("@memberjunction/actions");
+const global_1 = require("@memberjunction/global");
+const vega = __importStar(require("vega"));
+const vegaLite = __importStar(require("vega-lite"));
+/**
+ * Action that generates SVG charts from data using Vega-Lite.
+ * Supports various chart types including bar, line, pie, scatter, area, and more.
+ *
+ * This action is designed for AI agents and workflows to create publication-quality
+ * visualizations from structured data without writing visualization code.
+ *
+ * @example
+ * ```typescript
+ * // Simple bar chart
+ * await runAction({
+ *   ActionName: 'Create SVG Chart',
+ *   Params: [
+ *     { Name: 'ChartType', Value: 'bar' },
+ *     { Name: 'Data', Value: JSON.stringify([
+ *       { category: 'A', value: 28 },
+ *       { category: 'B', value: 55 },
+ *       { category: 'C', value: 43 }
+ *     ]) },
+ *     { Name: 'XField', Value: 'category' },
+ *     { Name: 'YField', Value: 'value' },
+ *     { Name: 'Title', Value: 'Sample Bar Chart' }
+ *   ]
+ * });
+ *
+ * // Pie chart
+ * await runAction({
+ *   ActionName: 'Create SVG Chart',
+ *   Params: [
+ *     { Name: 'ChartType', Value: 'pie' },
+ *     { Name: 'Data', Value: JSON.stringify([
+ *       { category: 'LLM', count: 67 },
+ *       { category: 'Embeddings', count: 10 }
+ *     ]) },
+ *     { Name: 'ThetaField', Value: 'count' },
+ *     { Name: 'ColorField', Value: 'category' },
+ *     { Name: 'Width', Value: '400' },
+ *     { Name: 'Height', Value: '300' }
+ *   ]
+ * });
+ * ```
+ */
+let CreateSVGChartAction = class CreateSVGChartAction extends actions_1.BaseAction {
+    /**
+     * Generates an SVG chart from the provided data and configuration
+     *
+     * @param params - The action parameters containing:
+     *   - ChartType: Type of chart (bar, line, pie, scatter, area, etc.)
+     *   - Data: JSON array of data objects
+     *   - XField: Field name for X axis (for bar, line, scatter, area)
+     *   - YField: Field name for Y axis (for bar, line, scatter, area)
+     *   - ThetaField: Field name for pie slice size (for pie charts)
+     *   - ColorField: Field name for color encoding (optional)
+     *   - Title: Chart title (optional)
+     *   - Width: Chart width in pixels (optional, default: 400)
+     *   - Height: Chart height in pixels (optional, default: 300)
+     *   - VegaLiteSpec: Full Vega-Lite JSON spec (optional, overrides other params)
+     *
+     * @returns A promise resolving to an ActionResultSimple with:
+     *   - Success: true if chart was generated successfully
+     *   - ResultCode: "SUCCESS" or error code
+     *   - Message: The SVG string or error message
+     */
+    async InternalRunAction(params) {
+        try {
+            // Check if a full Vega-Lite spec was provided
+            const specParam = this.getParamValue(params, 'VegaLiteSpec');
+            let vlSpec;
+            if (specParam) {
+                // Use the provided spec directly
+                vlSpec = this.parseJSON(specParam, 'VegaLiteSpec');
+            }
+            else {
+                // Build spec from individual parameters
+                const chartType = this.getParamValue(params, 'ChartType');
+                const dataParam = this.getParamValue(params, 'Data');
+                if (!chartType) {
+                    return {
+                        Success: false,
+                        Message: "ChartType parameter is required (or provide VegaLiteSpec)",
+                        ResultCode: "MISSING_PARAMETERS"
+                    };
+                }
+                if (!dataParam) {
+                    return {
+                        Success: false,
+                        Message: "Data parameter is required (or provide VegaLiteSpec)",
+                        ResultCode: "MISSING_PARAMETERS"
+                    };
+                }
+                const data = this.parseJSON(dataParam, 'Data');
+                if (!Array.isArray(data)) {
+                    return {
+                        Success: false,
+                        Message: "Data parameter must be a JSON array",
+                        ResultCode: "INVALID_DATA"
+                    };
+                }
+                // Build the Vega-Lite spec
+                vlSpec = this.buildVegaLiteSpec(params, chartType.toLowerCase(), data);
+            }
+            // Compile Vega-Lite to Vega
+            const vegaSpec = vegaLite.compile(vlSpec).spec;
+            // Create a headless view and render to SVG
+            const view = new vega.View(vega.parse(vegaSpec), { renderer: 'none' });
+            const svg = await view.toSVG();
+            return {
+                Success: true,
+                ResultCode: "SUCCESS",
+                Message: svg
+            };
+        }
+        catch (error) {
+            return {
+                Success: false,
+                Message: `Failed to generate chart: ${error instanceof Error ? error.message : String(error)}`,
+                ResultCode: "CHART_GENERATION_FAILED"
+            };
+        }
+    }
+    /**
+     * Builds a Vega-Lite specification from action parameters
+     */
+    buildVegaLiteSpec(params, chartType, data) {
+        const title = this.getParamValue(params, 'Title');
+        const width = parseInt(this.getParamValue(params, 'Width') || '400');
+        const height = parseInt(this.getParamValue(params, 'Height') || '300');
+        const baseSpec = {
+            $schema: "https://vega.github.io/schema/vega-lite/v5.json",
+            width,
+            height,
+            data: { values: data }
+        };
+        if (title) {
+            baseSpec.title = title;
+        }
+        // Build encoding based on chart type
+        switch (chartType) {
+            case 'bar':
+            case 'line':
+            case 'area':
+            case 'point':
+            case 'scatter':
+                baseSpec.mark = chartType === 'scatter' ? 'point' : chartType;
+                baseSpec.encoding = this.buildCartesianEncoding(params);
+                break;
+            case 'pie':
+            case 'arc':
+                baseSpec.mark = 'arc';
+                baseSpec.encoding = this.buildPieEncoding(params);
+                break;
+            default:
+                throw new Error(`Unsupported chart type: ${chartType}. Supported types: bar, line, area, point, scatter, pie`);
+        }
+        return baseSpec;
+    }
+    /**
+     * Builds encoding for Cartesian charts (bar, line, scatter, area)
+     */
+    buildCartesianEncoding(params) {
+        const xField = this.getParamValue(params, 'XField');
+        const yField = this.getParamValue(params, 'YField');
+        const colorField = this.getParamValue(params, 'ColorField');
+        if (!xField || !yField) {
+            throw new Error("XField and YField are required for this chart type");
+        }
+        const encoding = {
+            x: { field: xField, type: this.inferFieldType(xField) },
+            y: { field: yField, type: 'quantitative' }
+        };
+        if (colorField) {
+            encoding.color = { field: colorField, type: 'nominal' };
+        }
+        return encoding;
+    }
+    /**
+     * Builds encoding for pie/arc charts
+     */
+    buildPieEncoding(params) {
+        const thetaField = this.getParamValue(params, 'ThetaField');
+        const colorField = this.getParamValue(params, 'ColorField');
+        if (!thetaField) {
+            throw new Error("ThetaField is required for pie charts");
+        }
+        const encoding = {
+            theta: { field: thetaField, type: 'quantitative' }
+        };
+        if (colorField) {
+            encoding.color = { field: colorField, type: 'nominal' };
+        }
+        return encoding;
+    }
+    /**
+     * Infers the Vega-Lite field type from field name
+     */
+    inferFieldType(fieldName) {
+        const lowerName = fieldName.toLowerCase();
+        // Temporal hints
+        if (lowerName.includes('date') || lowerName.includes('time') || lowerName.includes('year') || lowerName.includes('month')) {
+            return 'temporal';
+        }
+        // Quantitative hints
+        if (lowerName.includes('count') || lowerName.includes('value') || lowerName.includes('amount') || lowerName.includes('total')) {
+            return 'quantitative';
+        }
+        // Default to nominal for categorical data
+        return 'nominal';
+    }
+    /**
+     * Helper to safely parse JSON that might already be an object
+     */
+    parseJSON(value, paramName) {
+        // If it's already an object/array, return it
+        if (typeof value === 'object' && value !== null) {
+            return value;
+        }
+        // If it's a string, parse it
+        if (typeof value === 'string') {
+            try {
+                return JSON.parse(value);
+            }
+            catch (error) {
+                throw new Error(`Parameter '${paramName}' contains invalid JSON: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        // For other types, error
+        throw new Error(`Parameter '${paramName}' must be a JSON string or object. Received ${typeof value}.`);
+    }
+    /**
+     * Helper to get parameter value by name (case-insensitive)
+     */
+    getParamValue(params, paramName) {
+        const param = params.Params.find(p => p.Name.trim().toLowerCase() === paramName.toLowerCase());
+        if (param?.Value && typeof param.Value === 'string') {
+            return param?.Value?.trim() || null;
+        }
+        else {
+            return param?.Value || null;
+        }
+    }
+};
+exports.CreateSVGChartAction = CreateSVGChartAction;
+exports.CreateSVGChartAction = CreateSVGChartAction = __decorate([
+    (0, global_1.RegisterClass)(actions_1.BaseAction, "__CreateSVGChart")
+], CreateSVGChartAction);
+/**
+ * Loader function to ensure the CreateSVGChartAction class is included in the bundle.
+ * This prevents tree-shaking from removing the class during the build process.
+ */
+function LoadCreateSVGChartAction() {
+    // 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.LoadCreateSVGChartAction = LoadCreateSVGChartAction;
+//# sourceMappingURL=create-svg-chart.action.js.map

package/dist/custom/visualization/create-svg-chart.action.js.map

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

package/dist/custom/visualization/create-svg-diagram.action.d.ts

@@ -0,0 +1,151 @@
+import { RunActionParams } from '@memberjunction/actions-base';
+import { BaseAction } from '@memberjunction/actions';
+import { SVGActionResult } from './shared/svg-types';
+/**
+ * Action that generates SVG diagrams including flowcharts, org charts, and ER diagrams.
+ *
+ * This action provides server-side SVG generation for structured diagrams, designed for
+ * AI agents and workflows to create publication-quality visualizations from structured data.
+ *
+ * @example
+ * ```typescript
+ * // Flowchart example
+ * await runAction({
+ *   ActionName: 'Create SVG Diagram',
+ *   Params: [
+ *     { Name: 'DiagramType', Value: 'flow' },
+ *     { Name: 'Nodes', Value: JSON.stringify([
+ *       { id: '1', kind: 'start', label: 'Start' },
+ *       { id: '2', kind: 'process', label: 'Process Data' },
+ *       { id: '3', kind: 'end', label: 'End' }
+ *     ]) },
+ *     { Name: 'Edges', Value: JSON.stringify([
+ *       { from: '1', to: '2', label: 'Begin' },
+ *       { from: '2', to: '3' }
+ *     ]) },
+ *     { Name: 'Direction', Value: 'TB' },
+ *     { Name: 'Width', Value: '800' },
+ *     { Name: 'Height', Value: '600' }
+ *   ]
+ * });
+ *
+ * // Org chart example
+ * await runAction({
+ *   ActionName: 'Create SVG Diagram',
+ *   Params: [
+ *     { Name: 'DiagramType', Value: 'org' },
+ *     { Name: 'Nodes', Value: JSON.stringify({
+ *       id: '1',
+ *       label: 'CEO',
+ *       role: 'Chief Executive Officer',
+ *       children: [
+ *         { id: '2', label: 'CTO', role: 'Technology' },
+ *         { id: '3', label: 'CFO', role: 'Finance' }
+ *       ]
+ *     }) }
+ *   ]
+ * });
+ * ```
+ */
+export declare class CreateSVGDiagramAction extends BaseAction {
+    /**
+     * Generates an SVG diagram from the provided data and configuration
+     *
+     * @param params - The action parameters containing:
+     *   - DiagramType: Type of diagram ('flow' | 'org' | 'er')
+     *   - Nodes: JSON array or object of nodes
+     *   - Edges: JSON array of edges (for flow and ER diagrams)
+     *   - Direction: Layout direction ('TB' | 'LR' | 'RL' | 'BT') for flow diagrams
+     *   - Width: Diagram width in pixels (optional, default: 800)
+     *   - Height: Diagram height in pixels (optional, default: 600)
+     *   - Title: Diagram title (optional)
+     *   - Palette: Color palette ('mjDefault' | 'gray' | 'pastel' | 'highContrast')
+     *   - Seed: Random seed for deterministic layouts (optional)
+     *
+     * @returns A promise resolving to an SVGActionResult with:
+     *   - Success: true if diagram was generated successfully
+     *   - ResultCode: "SUCCESS" or error code
+     *   - Message: The SVG string or error message
+     *   - svg: The SVG XML string
+     *   - width: Diagram width in pixels
+     *   - height: Diagram height in pixels
+     */
+    protected InternalRunAction(params: RunActionParams): Promise<SVGActionResult>;
+    /**
+     * Renders a flowchart using dagre layout
+     */
+    private renderFlowDiagram;
+    /**
+     * Gets dimensions for flow node based on kind
+     */
+    private getNodeDimensions;
+    /**
+     * Renders a single flow node
+     */
+    private renderFlowNode;
+    /**
+     * Gets color index for node kind
+     */
+    private getNodeColorIndex;
+    /**
+     * Renders an ellipse shape
+     */
+    private renderEllipse;
+    /**
+     * Renders a diamond shape
+     */
+    private renderDiamond;
+    /**
+     * Renders a rounded rectangle
+     */
+    private renderRoundedRect;
+    /**
+     * Renders a flow edge
+     */
+    private renderFlowEdge;
+    /**
+     * Renders an org chart using d3-hierarchy
+     */
+    private renderOrgChart;
+    /**
+     * Renders an org chart link
+     */
+    private renderOrgLink;
+    /**
+     * Renders an org chart node
+     */
+    private renderOrgNode;
+    /**
+     * Renders an ER diagram using dagre layout
+     */
+    private renderERDiagram;
+    /**
+     * Renders an ER table
+     */
+    private renderERTable;
+    /**
+     * Renders an ER relation
+     */
+    private renderERRelation;
+    /**
+     * Adds a title to the SVG
+     */
+    private addTitle;
+    /**
+     * Helper to safely parse JSON that might already be an object
+     */
+    private parseJSON;
+    /**
+     * Helper to ensure a parameter value is a string, with type conversion and validation
+     */
+    private ensureString;
+    /**
+     * Helper to get parameter value by name (case-insensitive)
+     */
+    private getParamValue;
+}
+/**
+ * Loader function to ensure the CreateSVGDiagramAction class is included in the bundle.
+ */
+export declare function LoadCreateSVGDiagramAction(): void;
+//# sourceMappingURL=create-svg-diagram.action.d.ts.map

package/dist/custom/visualization/create-svg-diagram.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-svg-diagram.action.d.ts","sourceRoot":"","sources":["../../../src/custom/visualization/create-svg-diagram.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAKrD,OAAO,EAOH,eAAe,EAIlB,MAAM,oBAAoB,CAAC;AAI5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,qBACa,sBAAuB,SAAQ,UAAU;IAClD;;;;;;;;;;;;;;;;;;;;;OAqBG;cACa,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAsEpF;;OAEG;YACW,iBAAiB;IA0F/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAgDtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAuCtB;;OAEG;YACW,cAAc;IA+D5B;;OAEG;IACH,OAAO,CAAC,aAAa;IAwBrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAuErB;;OAEG;YACW,eAAe;IA2F7B;;OAEG;IACH,OAAO,CAAC,aAAa;IAgFrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmCxB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAahB;;OAEG;IACH,OAAO,CAAC,SAAS;IAuBjB;;OAEG;IACH,OAAO,CAAC,YAAY;IAqBpB;;OAEG;IACH,OAAO,CAAC,aAAa;CAQxB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,SAEzC"}