@memberjunction/core-actions 2.132.0 → 3.0.0

package/dist/custom/ai/generate-image.action.d.ts

@@ -0,0 +1,111 @@
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { BaseAction } from "@memberjunction/actions";
+/**
+ * Action that generates images using AI image generation models (DALL-E, Gemini, etc.)
+ *
+ * @example
+ * ```typescript
+ * // Generate a simple image
+ * await runAction({
+ *   ActionName: 'Generate Image',
+ *   Params: [{
+ *     Name: 'Prompt',
+ *     Value: 'A serene mountain landscape at sunset with snow-capped peaks'
+ *   }]
+ * });
+ *
+ * // Generate with specific model and size
+ * await runAction({
+ *   ActionName: 'Generate Image',
+ *   Params: [{
+ *     Name: 'Prompt',
+ *     Value: 'A futuristic cityscape with flying vehicles'
+ *   }, {
+ *     Name: 'Model',
+ *     Value: 'dall-e-3'
+ *   }, {
+ *     Name: 'Size',
+ *     Value: '1792x1024'
+ *   }, {
+ *     Name: 'Quality',
+ *     Value: 'hd'
+ *   }]
+ * });
+ *
+ * // Generate multiple images
+ * await runAction({
+ *   ActionName: 'Generate Image',
+ *   Params: [{
+ *     Name: 'Prompt',
+ *     Value: 'Abstract art in vibrant colors'
+ *   }, {
+ *     Name: 'NumberOfImages',
+ *     Value: 3
+ *   }]
+ * });
+ *
+ * // Image-to-image editing (transform a source image)
+ * await runAction({
+ *   ActionName: 'Generate Image',
+ *   Params: [{
+ *     Name: 'Prompt',
+ *     Value: 'Transform this into a professional infographic with dark theme'
+ *   }, {
+ *     Name: 'SourceImage',
+ *     Value: 'base64_encoded_image_or_url'
+ *   }]
+ * });
+ * ```
+ */
+export declare class GenerateImageAction extends BaseAction {
+    /**
+     * Generates or edits image(s) using AI image generation models.
+     *
+     * When SourceImage is provided, performs image-to-image editing (style transfer, transformation).
+     * When SourceImage is not provided, performs text-to-image generation.
+     *
+     * @param params - The action parameters containing:
+     *   - Prompt: Text description of the image to generate or edit instructions (required)
+     *   - Model: Model name/ID to use (optional, uses default if not specified)
+     *   - NumberOfImages: Number of images to generate (optional, default: 1)
+     *   - Size: Image size like "1024x1024" (optional)
+     *   - Quality: Quality level - "standard" or "hd" (optional)
+     *   - Style: Style preset - "vivid" or "natural" (optional)
+     *   - NegativePrompt: Things to avoid in the image (optional)
+     *   - OutputFormat: "base64" or "url" (optional, default: "base64")
+     *   - SourceImage: Source image for image-to-image editing (optional, base64 or URL)
+     *   - Mask: Mask image for inpainting - white/transparent areas are regenerated (optional)
+     *
+     * @returns Generated or edited image(s) as base64 or URLs
+     */
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    /**
+     * Prepare an image generator instance using proper metadata lookup
+     */
+    private prepareImageGenerator;
+    /**
+     * Execute text-to-image generation
+     */
+    private executeImageGeneration;
+    /**
+     * Execute image-to-image editing
+     */
+    private executeImageEdit;
+    /**
+     * Format a generated image for output as MediaOutput
+     */
+    private formatImageOutput;
+    /**
+     * Get parameter value by name (case-insensitive)
+     */
+    private getParamValue;
+    /**
+     * Get number parameter with default
+     */
+    private getNumberParam;
+}
+/**
+ * Loader function to ensure the GenerateImageAction class is included in the bundle
+ */
+export declare function LoadGenerateImageAction(): void;
+//# sourceMappingURL=generate-image.action.d.ts.map

package/dist/custom/ai/generate-image.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-image.action.d.ts","sourceRoot":"","sources":["../../../src/custom/ai/generate-image.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEnF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAcrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,qBACa,mBAAoB,SAAQ,UAAU;IAE/C;;;;;;;;;;;;;;;;;;;OAmBG;cACa,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAgIvF;;OAEG;YACW,qBAAqB;IAuEnC;;OAEG;YACW,sBAAsB;IAkCpC;;OAEG;YACW,gBAAgB;IAgC9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB;;OAEG;IACH,OAAO,CAAC,cAAc;CAMzB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,SAEtC"}

package/dist/custom/ai/generate-image.action.js

@@ -0,0 +1,339 @@
+"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.LoadGenerateImageAction = exports.GenerateImageAction = void 0;
+const global_1 = require("@memberjunction/global");
+const actions_1 = require("@memberjunction/actions");
+const global_2 = require("@memberjunction/global");
+const ai_1 = require("@memberjunction/ai");
+const ai_engine_base_1 = require("@memberjunction/ai-engine-base");
+/**
+ * Action that generates images using AI image generation models (DALL-E, Gemini, etc.)
+ *
+ * @example
+ * ```typescript
+ * // Generate a simple image
+ * await runAction({
+ *   ActionName: 'Generate Image',
+ *   Params: [{
+ *     Name: 'Prompt',
+ *     Value: 'A serene mountain landscape at sunset with snow-capped peaks'
+ *   }]
+ * });
+ *
+ * // Generate with specific model and size
+ * await runAction({
+ *   ActionName: 'Generate Image',
+ *   Params: [{
+ *     Name: 'Prompt',
+ *     Value: 'A futuristic cityscape with flying vehicles'
+ *   }, {
+ *     Name: 'Model',
+ *     Value: 'dall-e-3'
+ *   }, {
+ *     Name: 'Size',
+ *     Value: '1792x1024'
+ *   }, {
+ *     Name: 'Quality',
+ *     Value: 'hd'
+ *   }]
+ * });
+ *
+ * // Generate multiple images
+ * await runAction({
+ *   ActionName: 'Generate Image',
+ *   Params: [{
+ *     Name: 'Prompt',
+ *     Value: 'Abstract art in vibrant colors'
+ *   }, {
+ *     Name: 'NumberOfImages',
+ *     Value: 3
+ *   }]
+ * });
+ *
+ * // Image-to-image editing (transform a source image)
+ * await runAction({
+ *   ActionName: 'Generate Image',
+ *   Params: [{
+ *     Name: 'Prompt',
+ *     Value: 'Transform this into a professional infographic with dark theme'
+ *   }, {
+ *     Name: 'SourceImage',
+ *     Value: 'base64_encoded_image_or_url'
+ *   }]
+ * });
+ * ```
+ */
+let GenerateImageAction = class GenerateImageAction extends actions_1.BaseAction {
+    /**
+     * Generates or edits image(s) using AI image generation models.
+     *
+     * When SourceImage is provided, performs image-to-image editing (style transfer, transformation).
+     * When SourceImage is not provided, performs text-to-image generation.
+     *
+     * @param params - The action parameters containing:
+     *   - Prompt: Text description of the image to generate or edit instructions (required)
+     *   - Model: Model name/ID to use (optional, uses default if not specified)
+     *   - NumberOfImages: Number of images to generate (optional, default: 1)
+     *   - Size: Image size like "1024x1024" (optional)
+     *   - Quality: Quality level - "standard" or "hd" (optional)
+     *   - Style: Style preset - "vivid" or "natural" (optional)
+     *   - NegativePrompt: Things to avoid in the image (optional)
+     *   - OutputFormat: "base64" or "url" (optional, default: "base64")
+     *   - SourceImage: Source image for image-to-image editing (optional, base64 or URL)
+     *   - Mask: Mask image for inpainting - white/transparent areas are regenerated (optional)
+     *
+     * @returns Generated or edited image(s) as base64 or URLs
+     */
+    async InternalRunAction(params) {
+        try {
+            const prompt = this.getParamValue(params, 'prompt');
+            const modelName = this.getParamValue(params, 'model');
+            const numberOfImages = this.getNumberParam(params, 'numberofimages', 1);
+            const size = this.getParamValue(params, 'size') || '1024x1024';
+            const quality = this.getParamValue(params, 'quality');
+            const style = this.getParamValue(params, 'style');
+            const negativePrompt = this.getParamValue(params, 'negativeprompt');
+            const outputFormat = this.getParamValue(params, 'outputformat') || 'base64';
+            const sourceImage = this.getParamValue(params, 'sourceimage');
+            const mask = this.getParamValue(params, 'mask');
+            // Validate prompt
+            if (!prompt) {
+                return {
+                    Success: false,
+                    Message: "Prompt parameter is required",
+                    ResultCode: "MISSING_PROMPT"
+                };
+            }
+            // Get image generator model and create instance
+            const { generator, model, apiName } = await this.prepareImageGenerator(params.ContextUser, modelName);
+            let result;
+            if (sourceImage) {
+                // Image-to-image: use EditImage when source image is provided
+                result = await this.executeImageEdit(generator, {
+                    prompt,
+                    apiName,
+                    sourceImage,
+                    mask,
+                    numberOfImages,
+                    size,
+                    outputFormat,
+                    negativePrompt
+                });
+            }
+            else {
+                // Text-to-image: use GenerateImage
+                result = await this.executeImageGeneration(generator, {
+                    prompt,
+                    apiName,
+                    numberOfImages,
+                    size,
+                    outputFormat,
+                    quality,
+                    style,
+                    negativePrompt
+                });
+            }
+            if (!result.success) {
+                return {
+                    Success: false,
+                    Message: `Image generation failed: ${result.errorMessage || 'Unknown error'}`,
+                    ResultCode: "GENERATION_FAILED"
+                };
+            }
+            if (!result.images || result.images.length === 0) {
+                return {
+                    Success: false,
+                    Message: "No images were generated",
+                    ResultCode: "NO_IMAGES"
+                };
+            }
+            // Format output images
+            const outputImages = result.images.map((img, index) => this.formatImageOutput(img, index));
+            // Add output parameters
+            params.Params.push({
+                Name: 'Images',
+                Type: 'Output',
+                Value: outputImages
+            });
+            params.Params.push({
+                Name: 'ImageCount',
+                Type: 'Output',
+                Value: result.images.length
+            });
+            if (result.revisedPrompt) {
+                params.Params.push({
+                    Name: 'RevisedPrompt',
+                    Type: 'Output',
+                    Value: result.revisedPrompt
+                });
+            }
+            params.Params.push({
+                Name: 'ModelUsed',
+                Type: 'Output',
+                Value: model.Name
+            });
+            // Build response - NOTE: images data is in output params, not in Message
+            // This keeps Message lightweight for LLM context (base64 images are ~700K tokens each)
+            const responseData = {
+                message: `Successfully generated ${result.images.length} image(s)`,
+                model: model.Name,
+                imageCount: result.images.length,
+                // Images are available in the 'Images' output parameter
+                // Use the provided placeholder references in your response
+                revisedPrompt: result.revisedPrompt
+            };
+            return {
+                Success: true,
+                ResultCode: "IMAGES_GENERATED",
+                Message: JSON.stringify(responseData, null, 2)
+            };
+        }
+        catch (error) {
+            return {
+                Success: false,
+                Message: `Generate image failed: ${error instanceof Error ? error.message : String(error)}`,
+                ResultCode: "ACTION_FAILED"
+            };
+        }
+    }
+    /**
+     * Prepare an image generator instance using proper metadata lookup
+     */
+    async prepareImageGenerator(contextUser, modelName) {
+        // Ensure AIEngine is loaded
+        await ai_engine_base_1.AIEngineBase.Instance.Config(false, contextUser);
+        // Find image generator models
+        const imageGeneratorModels = ai_engine_base_1.AIEngineBase.Instance.Models.filter(m => m.AIModelType?.toLowerCase() === 'image generator' && m.IsActive);
+        if (imageGeneratorModels.length === 0) {
+            throw new Error('No active image generator models found');
+        }
+        // Select model - use specified or highest power
+        let model;
+        if (modelName) {
+            const foundModel = imageGeneratorModels.find(m => m.Name.toLowerCase() === modelName.toLowerCase() ||
+                (m.APIName && m.APIName.toLowerCase() === modelName.toLowerCase()));
+            if (!foundModel) {
+                throw new Error(`Image generator model '${modelName}' not found`);
+            }
+            model = foundModel;
+        }
+        else {
+            // Get highest power image generator model
+            model = imageGeneratorModels.reduce((best, current) => (current.PowerRank || 0) > (best.PowerRank || 0) ? current : best);
+        }
+        // Find the inference provider from ModelVendors (populated by AIEngineBase)
+        // Inference providers have DriverClass set
+        const inferenceProvider = model.ModelVendors.find(mv => mv.DriverClass && mv.DriverClass.length > 0 && mv.Status === 'Active');
+        if (!inferenceProvider) {
+            throw new Error(`No active inference provider found for model '${model.Name}'`);
+        }
+        // Get API key using the vendor's driver class
+        const driverClass = inferenceProvider.DriverClass;
+        const apiName = inferenceProvider.APIName || model.APIName || model.Name;
+        const apiKey = (0, ai_1.GetAIAPIKey)(driverClass);
+        if (!apiKey) {
+            // Try getting by vendor name as fallback
+            const vendor = ai_engine_base_1.AIEngineBase.Instance.Vendors.find(v => v.ID === inferenceProvider.VendorID);
+            const vendorApiKey = vendor ? (0, ai_1.GetAIAPIKey)(vendor.Name) : null;
+            if (!vendorApiKey) {
+                throw new Error(`No API key found for ${driverClass} or vendor ${vendor?.Name || 'unknown'}`);
+            }
+        }
+        const generator = global_2.MJGlobal.Instance.ClassFactory.CreateInstance(ai_1.BaseImageGenerator, driverClass, apiKey);
+        if (!generator) {
+            throw new Error(`Failed to create image generator instance for ${driverClass}. Ensure the provider is registered.`);
+        }
+        return { generator, model, apiName };
+    }
+    /**
+     * Execute text-to-image generation
+     */
+    async executeImageGeneration(generator, options) {
+        const genParams = {
+            prompt: options.prompt,
+            model: options.apiName,
+            n: options.numberOfImages,
+            size: options.size,
+            outputFormat: options.outputFormat === 'url' ? 'url' : 'b64_json'
+        };
+        if (options.quality) {
+            genParams.quality = options.quality;
+        }
+        if (options.style) {
+            genParams.style = options.style;
+        }
+        if (options.negativePrompt) {
+            genParams.negativePrompt = options.negativePrompt;
+        }
+        return generator.GenerateImage(genParams);
+    }
+    /**
+     * Execute image-to-image editing
+     */
+    async executeImageEdit(generator, options) {
+        const editParams = {
+            prompt: options.prompt,
+            model: options.apiName,
+            image: options.sourceImage,
+            n: options.numberOfImages,
+            size: options.size,
+            outputFormat: options.outputFormat === 'url' ? 'url' : 'b64_json'
+        };
+        if (options.mask) {
+            editParams.mask = options.mask;
+        }
+        if (options.negativePrompt) {
+            editParams.negativePrompt = options.negativePrompt;
+        }
+        return generator.EditImage(editParams);
+    }
+    /**
+     * Format a generated image for output as MediaOutput
+     */
+    formatImageOutput(img, index) {
+        return {
+            modality: 'Image',
+            mimeType: img.format ? `image/${img.format}` : 'image/png',
+            data: img.base64,
+            url: img.url,
+            width: img.width,
+            height: img.height,
+            label: `Generated image ${index + 1}`
+        };
+    }
+    /**
+     * Get parameter value by name (case-insensitive)
+     */
+    getParamValue(params, name) {
+        const param = params.Params.find(p => p.Name.toLowerCase() === name.toLowerCase());
+        return param?.Value;
+    }
+    /**
+     * Get number parameter with default
+     */
+    getNumberParam(params, name, defaultValue) {
+        const value = this.getParamValue(params, name);
+        if (value === undefined || value === null)
+            return defaultValue;
+        const num = Number(value);
+        return isNaN(num) ? defaultValue : num;
+    }
+};
+exports.GenerateImageAction = GenerateImageAction;
+exports.GenerateImageAction = GenerateImageAction = __decorate([
+    (0, global_1.RegisterClass)(actions_1.BaseAction, "Generate Image")
+], GenerateImageAction);
+/**
+ * Loader function to ensure the GenerateImageAction class is included in the bundle
+ */
+function LoadGenerateImageAction() {
+    // Stub function to prevent tree shaking
+}
+exports.LoadGenerateImageAction = LoadGenerateImageAction;
+//# sourceMappingURL=generate-image.action.js.map

package/dist/custom/ai/generate-image.action.js.map

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

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

@@ -1,8 +1,8 @@
 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
+ * Action that creates Excel files from JSON data using the MemberJunction export-engine.
+ * Supports multiple sheets, formatting, styles, and formulas.
  *
  * @example
  * ```typescript
@@ -31,12 +31,14 @@ import { BaseFileHandlerAction } from "../utilities/base-file-handler";
  *       data: salesData,
  *       headers: ['Product', 'Units', 'Revenue'],
  *       columnWidths: [20, 10, 15],
- *       styles: {
- *         headerStyle: { font: { bold: true }, fill: { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FF4472C4' } } }
+ *       headerStyle: {
+ *         font: { bold: true, color: 'FFFFFF' },
+ *         fill: { pattern: 'solid', fgColor: '4472C4' }
  *       }
  *     }, {
  *       name: 'Summary',
- *       data: summaryData
+ *       data: summaryData,
+ *       formulas: [{ cell: 'B10', formula: 'SUM(B2:B9)' }]
  *     }]
  *   }]
  * });
@@ -44,7 +46,7 @@ import { BaseFileHandlerAction } from "../utilities/base-file-handler";
  */
 export declare class ExcelWriterAction extends BaseFileHandlerAction {
     /**
-     * Creates Excel files from JSON data
+     * Creates Excel files from JSON data using the export-engine
      *
      * @param params - The action parameters containing:
      *   - Sheets: Array of sheet definitions, each containing:
@@ -52,8 +54,11 @@ export declare class ExcelWriterAction extends BaseFileHandlerAction {
      *     - 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)
+     *     - headerStyle: Style object for headers (optional)
+     *     - dataStyle: Style object for data rows (optional)
      *     - formulas: Array of formula definitions (optional)
+     *     - autoFilter: Enable auto-filter (optional, boolean or range string)
+     *     - freeze: Freeze panes configuration (optional)
      *   - OutputFileID: Optional MJ Storage file ID to save to
      *   - FileName: Name for the generated Excel file (default: 'workbook.xlsx')
      *   - Author: Author metadata (optional)
@@ -64,13 +69,21 @@ export declare class ExcelWriterAction extends BaseFileHandlerAction {
      */
     protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
     /**
-     * Populate worksheet with data
+     * Convert the input sheet definition to the export-engine SheetDefinition format
      */
-    private populateWorksheet;
+    private convertToSheetDefinition;
     /**
-     * Apply style to a row
+     * Convert legacy ExcelJS-style objects to export-engine CellStyle format
      */
-    private applyRowStyle;
+    private convertLegacyStyle;
+    /**
+     * Extract color value from legacy format (handles both string and { argb: string } formats)
+     */
+    private extractColorValue;
+    /**
+     * Convert a legacy border side definition to export-engine BorderSide format
+     */
+    private convertBorderSide;
 }
 /**
  * Loader function to ensure the ExcelWriterAction class is included in the bundle

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

@@ -1 +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;AAKvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}
+{"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;AAavE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,qBACa,iBAAkB,SAAQ,qBAAqB;IAExD;;;;;;;;;;;;;;;;;;;;;OAqBG;cACa,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAmIvF;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAqDhC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyD1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAczB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAM5B;AAqDD;;GAEG;AACH,wBAAgB,qBAAqB,SAEpC"}