@memberjunction/core-actions 4.2.0 → 4.3.1

package/dist/__tests__/json-param-helper.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=json-param-helper.test.d.ts.map

package/dist/__tests__/json-param-helper.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-param-helper.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/json-param-helper.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/json-param-helper.test.js

@@ -0,0 +1,127 @@
+import { describe, it, expect, vi } from 'vitest';
+// ---------------------------------------------------------------------------
+// Mock @memberjunction/actions-base to provide the RunActionParams type
+// without pulling in the full MJ framework.
+// ---------------------------------------------------------------------------
+vi.mock('@memberjunction/actions-base', () => {
+    return {};
+});
+// ---------------------------------------------------------------------------
+// Import the class under test
+// ---------------------------------------------------------------------------
+import { JSONParamHelper } from '../custom/utilities/json-param-helper.js';
+/**
+ * Helper to build a minimal RunActionParams-compatible object for testing.
+ */
+function makeParams(params) {
+    return {
+        Params: params.map((p) => ({
+            Name: p.Name,
+            Value: p.Value !== undefined ? p.Value : undefined,
+            Type: p.Type || 'Input',
+        })),
+    };
+}
+// =====================================================================
+// JSONParamHelper.getJSONParam
+// =====================================================================
+describe('JSONParamHelper.getJSONParam', () => {
+    it('should return the object value when the object parameter is present', () => {
+        const params = makeParams([{ Name: 'Requirements', Value: { minLength: 8 } }]);
+        const result = JSONParamHelper.getJSONParam(params, 'Requirements');
+        expect(result).toEqual({ minLength: 8 });
+    });
+    it('should parse and return the string parameter when object param is absent', () => {
+        const params = makeParams([
+            { Name: 'RequirementsString', Value: '{"minLength": 12}' },
+        ]);
+        const result = JSONParamHelper.getJSONParam(params, 'Requirements');
+        expect(result).toEqual({ minLength: 12 });
+    });
+    it('should prefer the object parameter over the string parameter', () => {
+        const params = makeParams([
+            { Name: 'Requirements', Value: { fromObject: true } },
+            { Name: 'RequirementsString', Value: '{"fromString": true}' },
+        ]);
+        const result = JSONParamHelper.getJSONParam(params, 'Requirements');
+        expect(result).toEqual({ fromObject: true });
+    });
+    it('should return undefined when neither parameter exists', () => {
+        const params = makeParams([{ Name: 'SomethingElse', Value: 'irrelevant' }]);
+        const result = JSONParamHelper.getJSONParam(params, 'Requirements');
+        expect(result).toBeUndefined();
+    });
+    it('should throw an error when string parameter contains invalid JSON', () => {
+        const params = makeParams([
+            { Name: 'RequirementsString', Value: 'not valid json' },
+        ]);
+        expect(() => JSONParamHelper.getJSONParam(params, 'Requirements')).toThrow(/Failed to parse/);
+    });
+    it('should be case-insensitive on parameter name matching', () => {
+        const params = makeParams([{ Name: '  requirements  ', Value: { ok: true } }]);
+        const result = JSONParamHelper.getJSONParam(params, 'Requirements');
+        expect(result).toEqual({ ok: true });
+    });
+    it('should return numeric zero as a valid value (not skip it)', () => {
+        const params = makeParams([{ Name: 'Count', Value: 0 }]);
+        const result = JSONParamHelper.getJSONParam(params, 'Count');
+        expect(result).toBe(0);
+    });
+    it('should return false as a valid value (not skip it)', () => {
+        const params = makeParams([{ Name: 'Flag', Value: false }]);
+        const result = JSONParamHelper.getJSONParam(params, 'Flag');
+        expect(result).toBe(false);
+    });
+    it('should skip null values and fall through to string param', () => {
+        const params = makeParams([
+            { Name: 'Data', Value: null },
+            { Name: 'DataString', Value: '{"fallback": true}' },
+        ]);
+        const result = JSONParamHelper.getJSONParam(params, 'Data');
+        expect(result).toEqual({ fallback: true });
+    });
+});
+// =====================================================================
+// JSONParamHelper.hasJSONParam
+// =====================================================================
+describe('JSONParamHelper.hasJSONParam', () => {
+    it('should return true when the object parameter exists', () => {
+        const params = makeParams([{ Name: 'Config', Value: {} }]);
+        expect(JSONParamHelper.hasJSONParam(params, 'Config')).toBe(true);
+    });
+    it('should return true when the string parameter exists', () => {
+        const params = makeParams([{ Name: 'ConfigString', Value: '{}' }]);
+        expect(JSONParamHelper.hasJSONParam(params, 'Config')).toBe(true);
+    });
+    it('should return false when neither parameter exists', () => {
+        const params = makeParams([]);
+        expect(JSONParamHelper.hasJSONParam(params, 'Config')).toBe(false);
+    });
+    it('should return false when parameter value is null', () => {
+        const params = makeParams([{ Name: 'Config', Value: null }]);
+        expect(JSONParamHelper.hasJSONParam(params, 'Config')).toBe(false);
+    });
+    it('should return false when parameter value is undefined', () => {
+        const params = makeParams([{ Name: 'Config', Value: undefined }]);
+        expect(JSONParamHelper.hasJSONParam(params, 'Config')).toBe(false);
+    });
+});
+// =====================================================================
+// JSONParamHelper.getRequiredJSONParam
+// =====================================================================
+describe('JSONParamHelper.getRequiredJSONParam', () => {
+    it('should return the value when parameter exists', () => {
+        const params = makeParams([{ Name: 'Schema', Value: { type: 'object' } }]);
+        const result = JSONParamHelper.getRequiredJSONParam(params, 'Schema');
+        expect(result).toEqual({ type: 'object' });
+    });
+    it('should throw an error when parameter is missing', () => {
+        const params = makeParams([]);
+        expect(() => JSONParamHelper.getRequiredJSONParam(params, 'Schema')).toThrow(/Schema parameter is required/);
+    });
+    it('should throw a helpful error message describing both param formats', () => {
+        const params = makeParams([]);
+        expect(() => JSONParamHelper.getRequiredJSONParam(params, 'MyParam')).toThrow(/MyParam object or MyParamString/);
+    });
+});
+//# sourceMappingURL=json-param-helper.test.js.map

package/dist/__tests__/json-param-helper.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-param-helper.test.js","sourceRoot":"","sources":["../../src/__tests__/json-param-helper.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@memberjunction/core-actions",
   "type": "module",
-  "version": "4.2.0",
+  "version": "4.3.1",
   "description": "Library of generated and custom actions for the core MemberJunction framework. This library is maintained by MemberJunction and includes actions for use within the framework itself.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,7 +11,7 @@
   "scripts": {
     "start": "ts-node-dev src/index.ts",
     "build": "tsc && tsc-alias -f",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "echo \"No tests configured yet\""
   },
   "author": "MemberJunction.com",
   "license": "ISC",
@@ -24,30 +24,30 @@
   "dependencies": {
     "@asamuzakjp/css-color": "^4.1.2",
     "@dagrejs/dagre": "^1.1.8",
-    "@memberjunction/actions": "4.2.0",
-    "@memberjunction/actions-base": "4.2.0",
-    "@memberjunction/ai": "4.2.0",
-    "@memberjunction/ai-mcp-client": "4.2.0",
-    "@memberjunction/ai-agent-manager": "4.2.0",
-    "@memberjunction/ai-agents": "4.2.0",
-    "@memberjunction/ai-betty-bot": "4.2.0",
-    "@memberjunction/ai-core-plus": "4.2.0",
-    "@memberjunction/ai-engine-base": "4.2.0",
-    "@memberjunction/ai-prompts": "4.2.0",
-    "@memberjunction/ai-vector-sync": "4.2.0",
-    "@memberjunction/aiengine": "4.2.0",
-    "@memberjunction/code-execution": "4.2.0",
-    "@memberjunction/communication-engine": "4.2.0",
-    "@memberjunction/communication-types": "4.2.0",
-    "@memberjunction/content-autotagging": "4.2.0",
-    "@memberjunction/core": "4.2.0",
-    "@memberjunction/core-entities": "4.2.0",
-    "@memberjunction/core-entities-server": "4.2.0",
-    "@memberjunction/export-engine": "4.2.0",
-    "@memberjunction/external-change-detection": "4.2.0",
-    "@memberjunction/global": "4.2.0",
-    "@memberjunction/sqlserver-dataprovider": "4.2.0",
-    "@memberjunction/storage": "4.2.0",
+    "@memberjunction/actions": "4.3.1",
+    "@memberjunction/actions-base": "4.3.1",
+    "@memberjunction/ai": "4.3.1",
+    "@memberjunction/ai-mcp-client": "4.3.1",
+    "@memberjunction/ai-agent-manager": "4.3.1",
+    "@memberjunction/ai-agents": "4.3.1",
+    "@memberjunction/ai-betty-bot": "4.3.1",
+    "@memberjunction/ai-core-plus": "4.3.1",
+    "@memberjunction/ai-engine-base": "4.3.1",
+    "@memberjunction/ai-prompts": "4.3.1",
+    "@memberjunction/ai-vector-sync": "4.3.1",
+    "@memberjunction/aiengine": "4.3.1",
+    "@memberjunction/code-execution": "4.3.1",
+    "@memberjunction/communication-engine": "4.3.1",
+    "@memberjunction/communication-types": "4.3.1",
+    "@memberjunction/content-autotagging": "4.3.1",
+    "@memberjunction/core": "4.3.1",
+    "@memberjunction/core-entities": "4.3.1",
+    "@memberjunction/core-entities-server": "4.3.1",
+    "@memberjunction/export-engine": "4.3.1",
+    "@memberjunction/external-change-detection": "4.3.1",
+    "@memberjunction/global": "4.3.1",
+    "@memberjunction/sqlserver-dataprovider": "4.3.1",
+    "@memberjunction/storage": "4.3.1",
     "@types/d3-cloud": "^1.2.9",
     "@types/d3-force": "^3.0.10",
     "@types/d3-hierarchy": "^3.1.7",