n8n-nodes-chatads 0.1.3 → 0.1.5

package/README.md

@@ -44,9 +44,9 @@ The node accepts the following fields (via parameters or `Extra Fields (JSON)`):
 | Field | Type | Description |
 |-------|------|-------------|
 | `message` | string (required) | Message to analyze (1-5000 chars) |
-| `ip` | string | Client IP address for geo-detection |
-| `country` | string | ISO 3166-1 alpha-2 country code for geo-targeting |
-| `message_analysis` | string | Extraction method: `"fast"`, `"balanced"` (default), `"thorough"` |
-| `fill_priority` | string | URL resolution: `"speed"` or `"coverage"` (default) |
-| `min_intent` | string | Intent filter: `"any"`, `"low"` (default), `"medium"`, `"high"` |
-| `skip_message_analysis` | boolean | Skip NLP/LLM and use message directly as search query |
+| `ip` | string | IPv4 address for country detection (max 64 characters) |
+| `country` | string | Country code (e.g., 'US'). If provided, skips IP-based country detection |
+| `message_analysis` | string | Controls keyword extraction method. Use 'fast' to optimize for speed, 'thorough' (default) to optimize for best keyword selection |
+| `fill_priority` | string | Controls affiliate link discovery. Use 'speed' to optimize for speed, 'coverage' (default) to ping multiple sources for the right affiliate link |
+| `min_intent` | string | Minimum purchase intent level required for affiliate resolution. 'any' = no filtering, 'low' (default) = filter garbage, 'medium' = balanced quality/fill, 'high' = high-intent keywords only |
+| `skip_message_analysis` | boolean | Treat exact message as product keyword. When true, goes straight to affiliate link discovery without keyword extraction |

package/dist/credentials/ChatAdsApi.credentials.js

@@ -10,8 +10,8 @@ class ChatAdsApi {
                 displayName: 'Base URL',
                 name: 'baseUrl',
                 type: 'string',
-                default: 'https://app.getchatads.com',
-                description: 'Root domain where the ChatAds FastAPI service (affiliate/chatads_backend.py) is deployed',
+                default: 'https://api.getchatads.com',
+                description: 'ChatAds API endpoint URL',
             },
             {
                 displayName: 'API Key',
@@ -36,7 +36,7 @@ class ChatAdsApi {
         this.test = {
             request: {
                 method: 'GET',
-                url: '={{($credentials.baseUrl || "").replace(/\/+$/, "") || "https://app.getchatads.com"}}',
+                url: '={{($credentials.baseUrl || "").replace(/\/+$/, "") || "https://api.getchatads.com"}}',
                 qs: {
                     source: 'n8n-credential-test',
                 },

package/dist/nodes/ChatAds/ChatAds.node.js

@@ -10,6 +10,8 @@ const OPTIONAL_FIELDS = new Set([
     'fill_priority',
     'min_intent',
     'skip_message_analysis',
+    'demo',
+    'max_offers',
 ]);
 const FIELD_ALIASES = {
     messageanalysis: 'message_analysis',
@@ -20,6 +22,8 @@ const FIELD_ALIASES = {
     min_intent: 'min_intent',
     skipmessageanalysis: 'skip_message_analysis',
     skip_message_analysis: 'skip_message_analysis',
+    maxoffers: 'max_offers',
+    max_offers: 'max_offers',
 };
 const RESERVED_PAYLOAD_KEYS = new Set(['message', ...OPTIONAL_FIELDS]);
 const isPlainObject = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
@@ -90,13 +94,20 @@ const buildPayloadFromObject = (context, input, source, itemIndex) => {
         }
         const optionalKey = normalizeOptionalField(rawKey);
         if (optionalKey) {
-            if (optionalKey === 'skip_message_analysis') {
+            if (optionalKey === 'skip_message_analysis' || optionalKey === 'demo') {
                 if (typeof rawValue !== 'boolean') {
                     throw new n8n_workflow_1.NodeOperationError(context.getNode(), `${source} field "${rawKey}" must be a boolean`, { itemIndex });
                 }
                 payload[optionalKey] = rawValue;
                 continue;
             }
+            if (optionalKey === 'max_offers') {
+                if (typeof rawValue !== 'number') {
+                    throw new n8n_workflow_1.NodeOperationError(context.getNode(), `${source} field "${rawKey}" must be a number`, { itemIndex });
+                }
+                payload[optionalKey] = rawValue;
+                continue;
+            }
             payload[optionalKey] = coerceToString(context, source, rawKey, rawValue, itemIndex);
             continue;
         }
@@ -220,14 +231,14 @@ class ChatAds {
                             name: 'ip',
                             type: 'string',
                             default: '',
-                            description: 'Client IP address for geo-detection',
+                            description: 'IPv4/IPv6 address for country detection (max 45 characters)',
                         },
                         {
                             displayName: 'Country',
                             name: 'country',
                             type: 'string',
                             default: '',
-                            description: 'ISO 3166-1 alpha-2 country code for geo-targeting',
+                            description: "Country code (e.g., 'US'). If provided, skips IP-based country detection",
                         },
                         {
                             displayName: 'Message Analysis',
@@ -235,11 +246,10 @@ class ChatAds {
                             type: 'options',
                             options: [
                                 { name: 'Fast', value: 'fast' },
-                                { name: 'Balanced', value: 'balanced' },
                                 { name: 'Thorough', value: 'thorough' },
                             ],
-                            default: 'balanced',
-                            description: 'Keyword extraction method. Fast uses NLP only (~50ms), others use LLM.',
+                            default: 'thorough',
+                            description: 'Controls keyword extraction method. Use fast to optimize for speed, thorough to optimize for best keyword selection.',
                         },
                         {
                             displayName: 'Fill Priority',
@@ -250,7 +260,7 @@ class ChatAds {
                                 { name: 'Coverage', value: 'coverage' },
                             ],
                             default: 'coverage',
-                            description: 'URL resolution fallback strategy',
+                            description: 'Controls affiliate link discovery. Use speed to optimize for speed, coverage to ping multiple sources for the right affiliate link',
                         },
                         {
                             displayName: 'Min Intent',
@@ -263,14 +273,32 @@ class ChatAds {
                                 { name: 'High', value: 'high' },
                             ],
                             default: 'low',
-                            description: 'Minimum purchase intent level for affiliate resolution',
+                            description: "Minimum purchase intent level required for affiliate resolution. 'any' = no filtering, 'low' = filter garbage, 'medium' = balanced quality/fill, 'high' = high-intent keywords only",
                         },
                         {
                             displayName: 'Skip Message Analysis',
                             name: 'skip_message_analysis',
                             type: 'boolean',
                             default: false,
-                            description: 'Skip NLP/LLM extraction and use message directly as search query. Overrides message_analysis, min_intent, and fill_priority.',
+                            description: 'Treat exact message as product keyword. When true, goes straight to affiliate link discovery without keyword extraction',
+                        },
+                        {
+                            displayName: 'Demo Mode',
+                            name: 'demo',
+                            type: 'boolean',
+                            default: false,
+                            description: 'Enable demo mode',
+                        },
+                        {
+                            displayName: 'Max Offers',
+                            name: 'max_offers',
+                            type: 'number',
+                            typeOptions: {
+                                minValue: 1,
+                                maxValue: 2,
+                            },
+                            default: 1,
+                            description: 'Maximum number of affiliate offers to return (1-2)',
                         },
                         {
                             displayName: 'Extra Fields (JSON)',
@@ -376,13 +404,20 @@ class ChatAds {
                         if (!normalizedKey) {
                             throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Field "${field}" is not supported`, { itemIndex });
                         }
-                        if (normalizedKey === 'skip_message_analysis') {
+                        if (normalizedKey === 'skip_message_analysis' || normalizedKey === 'demo') {
                             if (typeof value !== 'boolean') {
                                 throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Field "${field}" must be provided as a boolean`, { itemIndex });
                             }
                             constructed[normalizedKey] = value;
                             continue;
                         }
+                        if (normalizedKey === 'max_offers') {
+                            if (typeof value !== 'number') {
+                                throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Field "${field}" must be provided as a number`, { itemIndex });
+                            }
+                            constructed[normalizedKey] = value;
+                            continue;
+                        }
                         constructed[normalizedKey] = coerceToString(this, 'Additional fields', field, value, itemIndex);
                     }
                     body = buildPayloadFromObject(this, constructed, 'Additional fields', itemIndex);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-chatads",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "n8n wrapper around the ChatAds FastAPI backend (affiliate/chatads_backend.py)",
   "license": "MIT",
   "main": "dist/index.js",