n8n-nodes-prestashop8 2.6.0 → 2.7.0

package/README.md

@@ -30,6 +30,7 @@ A comprehensive n8n community node for PrestaShop 8 integration with automatic X
 - ✅ **25+ resources supported**: products, customers, orders, stocks...
 - ✅ **Advanced filtering** with 10 search operators
 - ✅ **Raw mode** for debugging and advanced use cases
+- ✅ **Retry on error** to automatically recover from transient failures (timeouts, connection drops)
 
 ## 🚀 Quick Start
 
@@ -137,6 +138,7 @@ npm install n8n-nodes-prestashop8
 - **Sorting**: `[price_ASC]`, `[date_add_DESC]`
 - **Fields**: `full`, `minimal`, or custom
 - **Debug**: URL, headers, timeout
+- **Retry on error**: automatically retry a call that fails on a transient error — network timeout, connection drop, 5xx server error or 429 rate-limit (never on 4xx). Configurable max attempts and fixed delay between attempts; the retry budget is reset for each failing call. Each attempt is logged to the n8n server logs.
 
 ## 🎯 Usage Examples
 
@@ -169,7 +171,7 @@ Cron → PrestaShop 8 Node → Calculate KPIs → Email Report
 ### Common Problems
 - **401 Unauthorized** → Check API key and permissions
 - **404 Not Found** → Verify base URL and Webservices enabled
-- **Timeout** → Increase timeout in debug options
+- **Timeout** → Increase timeout in debug options, or enable **Retry on error** to auto-recover from transient timeouts
 
 ### Get Help
 - 🐞 **[GitHub Issues](https://github.com/PPCM/n8n-nodes-prestashop8/issues)** - Bugs and questions

package/dist/nodes/PrestaShop8/PrestaShop8.node.description.js

@@ -682,7 +682,7 @@ exports.PrestaShop8Description = {
                             name: 'retryEnabled',
                             type: 'boolean',
                             default: false,
-                            description: 'Whether to retry a call that fails on a transient error (network timeout, connection drop, 5xx server error or 429 rate-limit). Never retries client errors (4xx).',
+                            description: 'Whether to retry a call that fails on a transient error. Retries on: network timeout, connection drop (ECONNRESET / ECONNREFUSED / socket hang up), 5xx server errors and 429 rate-limit. Never retries client errors (4xx — invalid API key, 404, invalid XML). The retry budget is reset for each failing call.',
                         },
                         {
                             displayName: 'Max Retries',

package/dist/nodes/PrestaShop8/PrestaShop8.node.js

@@ -100,6 +100,12 @@ class PrestaShop8 {
                 let requestDebugInfo = {};
                 const opts = (0, http_1.getOperationOptions)(this, i);
                 const { rawMode, timeout, neverError, includeResponseHeaders, showRequestInfo, showRequestUrl } = opts;
+                // Trace each retry attempt to the n8n server logs (Option A).
+                if (opts.retry.enabled) {
+                    opts.retry.onRetry = (attempt, error) => {
+                        this.logger.warn(`PrestaShop8: retry ${attempt}/${opts.retry.maxRetries} on ${resource}/${operation} after ${(0, http_1.describeError)(error)} — waiting ${opts.retry.retryDelay}ms`);
+                    };
+                }
                 // Throttle: pause before each PrestaShop call except the first.
                 if (i > 0 && opts.delayBetweenCalls > 0) {
                     await (0, http_1.sleep)(opts.delayBetweenCalls);
@@ -270,9 +276,12 @@ class PrestaShop8 {
                             const filterValue = filter.value !== null && filter.value !== undefined ? String(filter.value).trim() : '';
                             const format = http_1.FILTER_OPERATOR_FORMATS[filter.operator];
                             if (format) {
-                                if (!format.requiresValue || filterValue) {
-                                    filterParams[key] = format.template.replace('{v}', filterValue);
+                                // Guard: operators that require a value must not be silently dropped
+                                // when the value is empty, otherwise PrestaShop returns all records.
+                                if (format.requiresValue && !filterValue) {
+                                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Filter operator "${filter.operator}" on field "${filter.field}" requires a value. Use the "IS_EMPTY" operator to match empty fields.`);
                                 }
+                                filterParams[key] = format.template.replace('{v}', filterValue);
                             }
                             else if (filterValue) {
                                 filterParams[key] = `[${filterValue}]`;

package/dist/nodes/PrestaShop8/helpers/http.d.ts

@@ -29,6 +29,8 @@ export interface RetryOptions {
     enabled: boolean;
     maxRetries: number;
     retryDelay: number;
+    /** Optional hook called before each retry wait, with the upcoming retry number (1-based) and the error. */
+    onRetry?: (attempt: number, error: any) => void;
 }
 /**
  * Pause execution for the given number of milliseconds (used to throttle calls).
@@ -40,6 +42,11 @@ export declare function sleep(ms: number): Promise<void>;
  * Never retries on 4xx (invalid key, not found, invalid XML, etc.).
  */
 export declare function isRetryableError(error: any): boolean;
+/**
+ * Build a short human-readable reason from an error, for retry logging.
+ * Prefers the network code, then the HTTP status, then the message.
+ */
+export declare function describeError(error: any): string;
 /**
  * Run an async HTTP operation with per-call retry on transient errors.
  * Each call gets its own retry budget; on the last attempt the error is rethrown

package/dist/nodes/PrestaShop8/helpers/http.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FILTER_OPERATOR_FORMATS = void 0;
 exports.sleep = sleep;
 exports.isRetryableError = isRetryableError;
+exports.describeError = describeError;
 exports.withRetry = withRetry;
 exports.getOperationOptions = getOperationOptions;
 exports.buildHttpOptions = buildHttpOptions;
@@ -69,12 +70,30 @@ function isRetryableError(error) {
     }
     return false;
 }
+/**
+ * Build a short human-readable reason from an error, for retry logging.
+ * Prefers the network code, then the HTTP status, then the message.
+ */
+function describeError(error) {
+    var _a, _b;
+    const code = (error === null || error === void 0 ? void 0 : error.code) || ((_a = error === null || error === void 0 ? void 0 : error.cause) === null || _a === void 0 ? void 0 : _a.code);
+    if (code) {
+        return code;
+    }
+    const status = (error === null || error === void 0 ? void 0 : error.httpCode) || ((_b = error === null || error === void 0 ? void 0 : error.response) === null || _b === void 0 ? void 0 : _b.status);
+    if (status) {
+        return `HTTP ${status}`;
+    }
+    const message = error === null || error === void 0 ? void 0 : error.message;
+    return message ? String(message) : 'unknown error';
+}
 /**
  * Run an async HTTP operation with per-call retry on transient errors.
  * Each call gets its own retry budget; on the last attempt the error is rethrown
  * so existing neverError / continueOnFail handling applies unchanged.
  */
 async function withRetry(retry, fn) {
+    var _a;
     const maxRetries = retry.enabled ? Math.max(0, retry.maxRetries) : 0;
     for (let attempt = 0;; attempt++) {
         try {
@@ -84,6 +103,8 @@ async function withRetry(retry, fn) {
             if (attempt >= maxRetries || !isRetryableError(error)) {
                 throw error;
             }
+            // attempt is 0-based; report the upcoming retry number (1-based)
+            (_a = retry.onRetry) === null || _a === void 0 ? void 0 : _a.call(retry, attempt + 1, error);
             if (retry.retryDelay > 0) {
                 await sleep(retry.retryDelay);
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-prestashop8",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "description": "Nœud n8n personnalisé pour PrestaShop 8 avec support CRUD complet et conversion XML/JSON automatique",
   "keywords": [
     "n8n-community-node-package",
@@ -86,7 +86,7 @@
     "brace-expansion": "^1.1.13",
     "uuid": "^14.0.0",
     "axios": "^1.16.0",
-    "form-data": "^4.0.4",
+    "form-data": "^4.0.6",
     "follow-redirects": "^1.16.0"
   }
 }