@nyaruka/temba-components 0.129.8 → 0.129.9

package/test/actions/call_llm.test.ts

@@ -0,0 +1,137 @@
+import { expect } from '@open-wc/testing';
+import { call_llm } from '../../src/flow/actions/call_llm';
+import { CallLLM } from '../../src/store/flow-definition';
+import { ActionTest } from '../ActionHelper';
+
+/**
+ * Test suite for the call_llm action configuration.
+ */
+describe('call_llm action config', () => {
+  const helper = new ActionTest(call_llm, 'call_llm');
+
+  describe('basic properties', () => {
+    helper.testBasicProperties();
+
+    it('has correct name', () => {
+      expect(call_llm.name).to.equal('Call AI');
+    });
+
+    it('has form configuration', () => {
+      expect(call_llm.form).to.exist;
+      expect(call_llm.form.llm).to.exist;
+      expect(call_llm.form.instructions).to.exist;
+      expect(call_llm.form.input).to.exist;
+    });
+
+    it('has layout configuration', () => {
+      expect(call_llm.layout).to.exist;
+      expect(call_llm.layout).to.deep.equal(['llm', 'input', 'instructions']);
+    });
+
+    it('has data transformation functions', () => {
+      expect(call_llm.toFormData).to.be.a('function');
+      expect(call_llm.fromFormData).to.be.a('function');
+    });
+  });
+
+  describe('data transformations', () => {
+    it('converts action to form data correctly', () => {
+      const action: CallLLM = {
+        uuid: 'test-llm-1',
+        type: 'call_llm',
+        input: '@input',
+        llm: { uuid: 'gpt-4', name: 'GPT 4.1' },
+        instructions: 'Translate to French',
+        result_name: 'translated_text'
+      };
+
+      const formData = call_llm.toFormData(action);
+
+      expect(formData.uuid).to.equal('test-llm-1');
+      expect(formData.llm).to.deep.equal([{ value: 'gpt-4', name: 'GPT 4.1' }]);
+      expect(formData.instructions).to.equal('Translate to French');
+      expect(formData.input).to.equal('@input');
+    });
+
+    it('converts form data to action correctly', () => {
+      const formData = {
+        uuid: 'test-llm-2',
+        llm: [{ value: 'gpt-5', name: 'GPT 5' }],
+        instructions: 'Summarize the following text',
+        input: '@input'
+      };
+
+      const action = call_llm.fromFormData(formData) as CallLLM;
+
+      expect(action.uuid).to.equal('test-llm-2');
+      expect(action.type).to.equal('call_llm');
+      expect(action.llm).to.deep.equal({ uuid: 'gpt-5', name: 'GPT 5' });
+      expect(action.instructions).to.equal('Summarize the following text');
+      expect(action.input).to.equal('@input');
+    });
+
+    it('handles empty form data', () => {
+      const formData = {
+        uuid: 'test-llm-3',
+        llm: [],
+        instructions: '',
+        input: ''
+      };
+
+      const action = call_llm.fromFormData(formData) as CallLLM;
+
+      expect(action.llm).to.deep.equal({ uuid: '', name: '' });
+      expect(action.instructions).to.equal('');
+      expect(action.input).to.equal('@input');
+    });
+  });
+
+  describe('action scenarios', () => {
+    helper.testAction(
+      {
+        uuid: 'test-action-1',
+        type: 'call_llm',
+        llm: { uuid: 'gpt-4', name: 'GPT 4.1' },
+        instructions: 'Translate to French',
+        input: '@input'
+      } as CallLLM,
+      'translation-task'
+    );
+
+    helper.testAction(
+      {
+        uuid: 'test-action-2',
+        type: 'call_llm',
+        llm: { uuid: 'gpt-5', name: 'GPT 5' },
+        instructions:
+          'Analyze the sentiment of the following message and classify it as positive, negative, or neutral. Provide a brief explanation for your classification.',
+        input: '@input'
+      } as CallLLM,
+      'sentiment-analysis'
+    );
+
+    helper.testAction(
+      {
+        uuid: 'test-action-3',
+        type: 'call_llm',
+        llm: { uuid: 'gpt-4', name: 'GPT 4.1' },
+        instructions:
+          'Summarize the key points from the conversation above in bullet format.',
+        input: '@input'
+      } as CallLLM,
+      'summarization'
+    );
+
+    helper.testAction(
+      {
+        uuid: 'test-action-4',
+        type: 'call_llm',
+        llm: { uuid: 'gpt-5', name: 'GPT 5' },
+        instructions:
+          'Extract any contact information (phone numbers, email addresses) from the text and format them as a JSON object.',
+        input: '@input'
+      } as CallLLM,
+      'information-extraction'
+    );
+  });
+});

package/test/nodes/README.md

@@ -0,0 +1,78 @@
+# Node Configuration Tests
+
+This directory contains tests for node configurations using the `NodeHelper` testing framework.
+
+## Overview
+
+Similar to how the `ActionHelper` provides a uniform testing strategy for action configurations, the `NodeHelper` class provides a structured approach to testing node configurations. It handles:
+
+1. **Rendering Tests**: Verifies nodes render correctly in the flow editor
+2. **Editor Tests**: Verifies the node editor opens and displays correctly
+3. **Round-trip Conversion**: Tests form data conversion for nodes with `toFormData`/`fromFormData`
+4. **Screenshot Testing**: Captures visual screenshots for regression testing
+
+## Test Structure
+
+Each node test file follows this pattern:
+
+```typescript
+import { expect } from '@open-wc/testing';
+import { node_config } from '../../src/flow/nodes/node_config';
+import { Node } from '../../src/store/flow-definition';
+import { NodeTest } from '../NodeHelper';
+
+describe('node_config node config', () => {
+  const helper = new NodeTest(node_config, 'node_config');
+
+  describe('basic properties', () => {
+    helper.testBasicProperties();
+
+    // Additional property tests...
+  });
+
+  describe('node scenarios', () => {
+    helper.testNode(nodeData, nodeUI, 'test-name');
+
+    // More scenarios...
+  });
+
+  // Optional: data transformation tests for nodes with form configuration
+  describe('data transformation', () => {
+    // Round-trip conversion tests...
+  });
+});
+```
+
+## Node Types Covered
+
+### Simple Nodes
+
+- `wait_for_digits`: Basic node with no form configuration
+- `wait_for_audio`, `wait_for_image`, etc.: Similar wait nodes
+
+### Form-Configured Nodes
+
+- `wait_for_response`: Node with form fields and data transformation
+- `split_by_llm_categorize`: Complex node with form configuration
+
+### Router-Based Nodes
+
+- `split_by_random`: Random distribution node
+- Other split nodes with router configurations
+
+## Screenshots
+
+Screenshots are automatically generated and stored in:
+
+- `screenshots/nodes/{node_name}/render/{test_name}.png` - Flow editor rendering
+- `screenshots/nodes/{node_name}/editor/{test_name}.png` - Node editor dialog
+
+## Running Tests
+
+```bash
+# Run all node tests
+yarn test test/nodes/*.test.ts --no-watch
+
+# Run specific node test
+yarn test test/nodes/wait_for_response.test.ts --no-watch
+```