n8n-nodes-ido-toolbox 0.2.0 → 0.4.0

package/README.md

@@ -1,253 +1,349 @@
-# Ido Toolbox - אוסף כלים שימושיים ל-n8n
-
-נוד קהילתי ל-n8n המכיל מגוון רחב של כלים שימושיים לניהול נתונים, טקסט, תאריכים ופעולות יומיומיות.
-
-## ✨ תכונות עיקריות
-
-- **כלים אקראיים**: יצירת מחרוזות, מספרים וסיסמאות אקראיים
-- **עיבוד טקסט**: חיפוש והחלפה מרובים
-- **יצירת HTML**: המרת נתונים לטבלאות HTML
-- **תיקון אימייל**: תיקון דומיינים שגויים באימיילים
-- **תגובות אקראיות**: בחירה אקראית מתוך רשימת תגובות
-- **תמיכה באייג'נט**: כל הכלים זמינים לשימוש עם AI agents
-
-## 🆕 **חדש בגרסה 0.2.0**
-
-- **כלי UTM** - חילוץ פרמטרי UTM מכתובות URL
-- **פיצול טקסט** - חלוקת טקסט לנתחים עם חפיפה
-- **המרת אזורי זמן** - המרת תאריכים בין אזורי זמן שונים
-- **כלי תאריכים** - יצירת תאריכים אקראיים וחישוב הבדלים
-- **כלי עברית** - קידוד/פענוח מחרוזות עברית ואימות תעודות זהות
-
-## 🔧 הכלים הזמינים
-
-### 1. כלים אקראיים
-
-#### Generate Random String (יצירת מחרוזת אקראית)
-יוצר מחרוזת אקראית באורך נבחר עם אפשרויות התאמה אישית.
-
-**פרמטרים:**
-- **Length**: אורך המחרוזת (ברירת מחדל: 8)
-- **Include Numbers**: האם לכלול מספרים
-- **Include Uppercase**: האם לכלול אותיות גדולות
-- **Include Lowercase**: האם לכלול אותיות קטנות
-
-**פלט:**
-```json
-{
-  "randomString": "Ab3Xy9Kl",
-  "length": 8
-}
-```
-
-#### Generate Random Number (יצירת מספר אקראי)
-יוצר מספר אקראי בטווח מוגדר.
-
-**פרמטרים:**
-- **Minimum Value**: ערך מינימלי (ברירת מחדל: 0)
-- **Maximum Value**: ערך מקסימלי (ברירת מחדל: 100)
-
-**פלט:**
-```json
-{
-  "randomNumber": 42,
-  "min": 0,
-  "max": 100,
-  "range": 101
-}
-```
-
-#### Password Generator (מחולל סיסמאות)
-יוצר סיסמאות חזקות עם אפשרות להתאמה אישית.
-
-**פרמטרים:**
-- **Length**: אורך הסיסמה (ברירת מחדל: 12)
-- **Include Numbers**: האם לכלול מספרים
-- **Include Symbols**: האם לכלול סימנים מיוחדים
-
-**פלט:**
-```json
-{
-  "password": "Tr9@pL2#mN8&k",
-  "length": 12,
-  "strength": "Strong"
-}
-```
-
-### 2. עיבוד טקסט
-
-#### Multiple Search and Replace (חיפוש והחלפה מרובים)
-מבצע חיפוש והחלפה מרובים בטקסט.
-
-**פרמטרים:**
-- **Input Text**: הטקסט שעליו לבצע חיפוש והחלפה
-- **Replacements**: רשימת החלפות לביצוע
-  - **Search For**: הטקסט לחיפוש
-  - **Replace With**: הטקסט להחלפה
-- **Case Sensitive**: האם החיפוש תלוי רישיות
-
-**פלט:**
-```json
-{
-  "inputText": "Hello world!",
-  "outputText": "Hi universe!",
-  "changesMade": true,
-  "replacementsApplied": [
-    {
-      "search": "Hello",
-      "replace": "Hi",
-      "replacementsMade": 1
-    },
-    {
-      "search": "world",
-      "replace": "universe",
-      "replacementsMade": 1
-    }
-  ],
-  "totalReplacements": 2
-}
-```
-
-### 3. יצירת HTML
-
-#### Create HTML From Table (יצירת HTML מטבלה)
-יוצר טבלת HTML בסיסית מנתונים.
-
-**פרמטרים:**
-- **Input Data**: נתוני הקלט (JSON או CSV)
-- **Data Format**: פורמט הנתונים (JSON/CSV)
-- **Include Headers**: האם לכלול כותרות
-
-**פלט:**
-```json
-{
-  "htmlTable": "<table border=\"1\" style=\"border-collapse: collapse;\">...",
-  "rowCount": 3,
-  "columnCount": 2,
-  "headers": ["Name", "Age"]
-}
-```
-
-#### Create HTML From Table - Advanced (יצירת HTML מטבלה - מתקדם)
-יוצר טבלת HTML מתקדמת עם עיצוב ותכונות נוספות.
-
-**פרמטרים:**
-- **Input Data**: נתוני הקלט (JSON או CSV)
-- **Data Format**: פורמט הנתונים (JSON/CSV)
-- **Table Class**: מחלקת CSS לטבלה
-- **Include Headers**: האם לכלול כותרות
-- **Table Title**: כותרת לטבלה (אופציונלי)
-
-**פלט:**
-```json
-{
-  "htmlTable": "<h3>My Data</h3><table class=\"table table-striped\">...",
-  "rowCount": 3,
-  "columnCount": 2,
-  "headers": ["Name", "Age"],
-  "tableClass": "table table-striped",
-  "hasTitle": true
-}
-```
-
-### 4. תיקון נתונים
-
-#### Fix Email Address Domain (תיקון דומיין כתובת אימייל)
-מתקן שגיאות הקלדה נפוצות בדומיינים של אימייל.
-
-**תיקונים נתמכים:**
-- `gmial.com` → `gmail.com`
-- `hotmal.com` → `hotmail.com`
-- `yahho.com` → `yahoo.com`
-- ועוד...
-
-**פרמטרים:**
-- **Email Address**: כתובת האימייל לתיקון
-
-**פלט:**
-```json
-{
-  "originalEmail": "user@gmial.com",
-  "correctedEmail": "user@gmail.com",
-  "domainCorrected": true,
-  "originalDomain": "gmial.com",
-  "correctedDomain": "gmail.com"
-}
-```
-
-### 5. תגובות אקראיות
-
-#### Return a Random Reply (החזרת תגובה אקראית)
-מחזיר תגובה אקראית מתוך רשימה מוגדרת.
-
-**פרמטרים:**
-- **Replies**: רשימת תגובות מופרדות בפסיקים
-
-**פלט:**
-```json
-{
-  "randomReply": "כן",
-  "totalReplies": 4,
-  "selectedIndex": 0,
-  "allReplies": ["כן", "לא", "אולי", "שאל שוב מאוחר יותר"]
-}
-```
-
-## 🚀 התקנה
-
-1. התקן את n8n
-2. התקן את הנוד:
-   ```bash
-   npm install n8n-nodes-ido-toolbox
-   ```
-3. הפעל מחדש את n8n
-4. הנוד "Ido Toolbox" יהיה זמין בפאנל הנודים
-
-## 📝 דוגמאות שימוש
-
-### יצירת סיסמה אקראית
-```javascript
-// הפעל את הנוד עם:
-// Operation: Password Generator
-// Length: 16
-// Include Numbers: true
-// Include Symbols: true
-```
-
-### תיקון אימיילים ברשימת תפוצה
-```javascript
-// הפעל את הנוד עם:
-// Operation: Fix Email Address Domain
-// Email Address: user@gmial.com
-```
-
-### יצירת טבלת HTML מנתונים
-```javascript
-// הפעל את הנוד עם:
-// Operation: Create HTML From Table - Advanced
-// Input Data: [{"name":"John","age":30},{"name":"Jane","age":25}]
-// Data Format: JSON
-// Table Title: User List
-```
-
-## 🤖 תמיכה באייג'נט
-
-כל הכלים בנוד זה מוגדרים ככלי אייג'נט (`usableAsTool: true`), מה שאומר שהם זמינים לשימוש עם AI agents ב-n8n.
-
-## 🐛 דיווח על באגים
-
-אם נתקלת בבאג או יש לך הצעה לשיפור, אנא פתח issue ב-GitHub.
-
-## 📄 רישיון
-
-פרויקט זה מופץ תחת רישיון MIT.
-
-## 👥 תרומה
-
-תרומות מתקבלות בברכה! אנא קרא את [קובץ התרומה](CONTRIBUTING.md) לפני שליחת Pull Request.
-
----
-
-**פותח על ידי:** Ovadiah Ben-David
-**גרסה:** 0.2.0
+# Ido Toolbox - Comprehensive n8n Community Node
+
+A community node for n8n containing a wide variety of useful tools for data management, text processing, date operations, and daily tasks.
+
+## ✨ Key Features
+
+- **Random Tools**: Generate random strings, numbers, and passwords
+- **Text Processing**: Multiple search and replace operations
+- **HTML Generation**: Convert data to HTML tables
+- **Email Fixing**: Correct typos in email domains
+- **Random Replies**: Select random responses from a list
+- **AI Agent Support**: All tools are usable with AI agents
+
+## 🆕 **חדש בגרסה 0.4.0**
+
+- **Complete text translation** - All Hebrew text replaced with English
+- **Enhanced random number tool** - Added option to choose between integers and decimals
+- **Improved timezone converter** - Dropdown with predefined timezone options
+- **Extended email domain corrections** - Added dozens more domain correction examples
+- **Removed QR Code tool** - Removed due to implementation issues
+
+## 🆕 **חדש בגרסה 0.3.0**
+
+- **כלי UTM** - חילוץ פרמטרי UTM מכתובות URL
+- **פיצול טקסט** - חלוקת טקסט לנתחים עם חפיפה
+- **המרת אזורי זמן** - המרת תאריכים בין אזורי זמן שונים
+- **כלי תאריכים** - יצירת תאריכים אקראיים וחישוב הבדלים
+- **כלי עברית** - קידוד/פענוח מחרוזות עברית ואימות תעודות זהות
+
+## 🔧 Available Tools
+
+### 1. Random Tools
+
+#### Generate Random String
+Creates a random string of specified length with customizable options.
+
+**פרמטרים:**
+- **Length**: אורך המחרוזת (ברירת מחדל: 8)
+- **Include Numbers**: האם לכלול מספרים
+- **Include Uppercase**: האם לכלול אותיות גדולות
+- **Include Lowercase**: האם לכלול אותיות קטנות
+
+**פלט:**
+```json
+{
+  "randomString": "Ab3Xy9Kl",
+  "length": 8
+}
+```
+
+#### Generate Random Number (יצירת מספר אקראי)
+יוצר מספר אקראי בטווח מוגדר.
+
+**פרמטרים:**
+- **Minimum Value**: ערך מינימלי (ברירת מחדל: 0)
+- **Maximum Value**: ערך מקסימלי (ברירת מחדל: 100)
+
+**פלט:**
+```json
+{
+  "randomNumber": 42,
+  "min": 0,
+  "max": 100,
+  "range": 101
+}
+```
+
+#### Password Generator (מחולל סיסמאות)
+יוצר סיסמאות חזקות עם אפשרות להתאמה אישית.
+
+**פרמטרים:**
+- **Length**: אורך הסיסמה (ברירת מחדל: 12)
+- **Include Numbers**: האם לכלול מספרים
+- **Include Symbols**: האם לכלול סימנים מיוחדים
+
+**פלט:**
+```json
+{
+  "password": "Tr9@pL2#mN8&k",
+  "length": 12,
+  "strength": "Strong"
+}
+```
+
+### 2. עיבוד טקסט
+
+#### Multiple Search and Replace (חיפוש והחלפה מרובים)
+מבצע חיפוש והחלפה מרובים בטקסט.
+
+**פרמטרים:**
+- **Input Text**: הטקסט שעליו לבצע חיפוש והחלפה
+- **Replacements**: רשימת החלפות לביצוע
+  - **Search For**: הטקסט לחיפוש
+  - **Replace With**: הטקסט להחלפה
+- **Case Sensitive**: האם החיפוש תלוי רישיות
+
+**פלט:**
+```json
+{
+  "inputText": "Hello world!",
+  "outputText": "Hi universe!",
+  "changesMade": true,
+  "replacementsApplied": [
+    {
+      "search": "Hello",
+      "replace": "Hi",
+      "replacementsMade": 1
+    },
+    {
+      "search": "world",
+      "replace": "universe",
+      "replacementsMade": 1
+    }
+  ],
+  "totalReplacements": 2
+}
+```
+
+### 3. יצירת HTML
+
+#### Create HTML From Table (יצירת HTML מטבלה)
+יוצר טבלת HTML בסיסית מנתונים.
+
+**פרמטרים:**
+- **Input Data**: נתוני הקלט (JSON או CSV)
+- **Data Format**: פורמט הנתונים (JSON/CSV)
+- **Include Headers**: האם לכלול כותרות
+
+**פלט:**
+```json
+{
+  "htmlTable": "<table border=\"1\" style=\"border-collapse: collapse;\">...",
+  "rowCount": 3,
+  "columnCount": 2,
+  "headers": ["Name", "Age"]
+}
+```
+
+#### Create HTML From Table - Advanced (יצירת HTML מטבלה - מתקדם)
+יוצר טבלת HTML מתקדמת עם עיצוב ותכונות נוספות.
+
+**פרמטרים:**
+- **Input Data**: נתוני הקלט (JSON או CSV)
+- **Data Format**: פורמט הנתונים (JSON/CSV)
+- **Table Class**: מחלקת CSS לטבלה
+- **Include Headers**: האם לכלול כותרות
+- **Table Title**: כותרת לטבלה (אופציונלי)
+
+**פלט:**
+```json
+{
+  "htmlTable": "<h3>My Data</h3><table class=\"table table-striped\">...",
+  "rowCount": 3,
+  "columnCount": 2,
+  "headers": ["Name", "Age"],
+  "tableClass": "table table-striped",
+  "hasTitle": true
+}
+```
+
+### 4. תיקון נתונים
+
+#### Fix Email Address Domain (תיקון דומיין כתובת אימייל)
+מתקן שגיאות הקלדה נפוצות בדומיינים של אימייל.
+
+**תיקונים נתמכים:**
+- `gmial.com` → `gmail.com`
+- `hotmal.com` → `hotmail.com`
+- `yahho.com` → `yahoo.com`
+- ועוד...
+
+**פרמטרים:**
+- **Email Address**: כתובת האימייל לתיקון
+
+**פלט:**
+```json
+{
+  "originalEmail": "user@gmial.com",
+  "correctedEmail": "user@gmail.com",
+  "domainCorrected": true,
+  "originalDomain": "gmial.com",
+  "correctedDomain": "gmail.com"
+}
+```
+
+### 5. תגובות אקראיות
+
+#### Return a Random Reply (החזרת תגובה אקראית)
+מחזיר תגובה אקראית מתוך רשימה מוגדרת.
+
+**פרמטרים:**
+- **Replies**: רשימת תגובות מופרדות בפסיקים
+
+**פלט:**
+```json
+{
+  "randomReply": "כן",
+  "totalReplies": 4,
+  "selectedIndex": 0,
+  "allReplies": ["כן", "לא", "אולי", "שאל שוב מאוחר יותר"]
+}
+```
+
+## 🚀 התקנה
+
+1. התקן את n8n
+2. התקן את הנוד:
+   ```bash
+   npm install n8n-nodes-ido-toolbox
+   ```
+3. הפעל מחדש את n8n
+4. הנוד "Ido Toolbox" יהיה זמין בפאנל הנודים
+
+## 📝 דוגמאות שימוש
+
+### יצירת סיסמה אקראית
+```javascript
+// הפעל את הנוד עם:
+// Operation: Password Generator
+// Length: 16
+// Include Numbers: true
+// Include Symbols: true
+```
+
+### תיקון אימיילים ברשימת תפוצה
+```javascript
+// הפעל את הנוד עם:
+// Operation: Fix Email Address Domain
+// Email Address: user@gmial.com
+```
+
+### יצירת טבלת HTML מנתונים
+```javascript
+// הפעל את הנוד עם:
+// Operation: Create HTML From Table - Advanced
+// Input Data: [{"name":"John","age":30},{"name":"Jane","age":25}]
+// Data Format: JSON
+// Table Title: User List
+```
+
+## 🤖 תמיכה באייג'נט
+
+כל הכלים בנוד זה מוגדרים ככלי אייג'נט (`usableAsTool: true`), מה שאומר שהם זמינים לשימוש עם AI agents ב-n8n.
+
+## 🐛 דיווח על באגים
+
+אם נתקלת בבאג או יש לך הצעה לשיפור, אנא פתח issue ב-GitHub.
+
+## 📄 רישיון
+
+פרויקט זה מופץ תחת רישיון MIT.
+
+## 👥 תרומה
+
+תרומות מתקבלות בברכה! אנא קרא את [קובץ התרומה](CONTRIBUTING.md) לפני שליחת Pull Request.
+
+---
+
+### 6. כלי XML ו-JSON
+
+#### Convert XML to JSON Object (המרת XML לאובייקט JSON)
+ממיר מחרוזת XML לאובייקט JSON בצורה היררכית.
+
+**פרמטרים:**
+- **XML String**: מחרוזת XML להמרה
+
+**פלט:**
+```json
+{
+  "xmlString": "<user><name>John</name><age>30</age></user>",
+  "jsonResult": {
+    "user": {
+      "name": {"_value": "John"},
+      "age": {"_value": "30"}
+    }
+  },
+  "conversionSuccessful": true
+}
+```
+
+### 7. יצירת QR Code
+
+#### Generate QR Code (יצירת קוד QR)
+יוצר קוד QR מכתובת URL או טקסט (יישום בסיסי).
+
+**פרמטרים:**
+- **Content**: התוכן להמרה לקוד QR
+- **Size**: גודל קוד ה-QR בפיקסלים
+- **Format**: פורמט הפלט (Base64/Data URL)
+
+**פלט:**
+```json
+{
+  "content": "https://example.com",
+  "size": 256,
+  "format": "base64",
+  "qrCode": "base64_encoded_qr_placeholder",
+  "note": "This is a placeholder. Use qrcode library for real QR generation."
+}
+```
+
+### 8. ניתוח HTML
+
+#### HTML Parser (מנתח HTML)
+מנתח מחרוזת HTML לחילוץ מידע שונה.
+
+**פרמטרים:**
+- **HTML String**: מחרוזת HTML לניתוח
+- **Parse Type**: סוג המידע לחילוץ (טקסט/קישורים/תמונות/כותרות)
+
+**פלט:**
+```json
+{
+  "htmlString": "<html>...</html>",
+  "parseType": "links",
+  "parsedData": {
+    "links": [
+      {"url": "https://example.com", "text": "Example"}
+    ],
+    "linkCount": 1
+  },
+  "parsingSuccessful": true
+}
+```
+
+### 9. חילוץ תווים מספריים
+
+#### Get Numeric Characters (קבלת תווים מספריים)
+מחלץ תווים מספריים ממחרוזת.
+
+**פרמטרים:**
+- **Input String**: המחרוזת שממנה לחלץ תווים מספריים
+- **Extract as Numbers**: האם להחזיר כמספרים או כמחרוזות
+
+**פלט:**
+```json
+{
+  "inputString": "Price: 123.45 USD",
+  "numericString": "12345",
+  "numbers": [1, 2, 3, 4, 5],
+  "count": 5
+}
+```
+
+---
+
+**פותח על ידי:** Ovadiah Ben-David
+**גרסה:** 0.4.0
 **תאימות:** n8n 1.0+