@dreamtree-org/korm-js 1.0.44 → 1.0.45

package/README.md

@@ -175,9 +175,9 @@ POST /api/Users/crud
 {
   "action": "list",
   "where": {
-    "first_name": { "like": "%John%" },
-    "email": { "like": "%@example.com" },
-    "age": { ">=": 18, "<=": 65 },
+    "first_name": "%John%",
+    "email": "%@example.com",
+    "age": "><18,65",
     "is_active": true
   },
   "select": ["id", "username", "email", "first_name", "last_name"],
@@ -315,7 +315,7 @@ POST /api/Users/crud
   "action": "count",
   "where": {
     "is_active": true,
-    "created_at": { ">=": "2024-01-01" }
+    "created_at": ">=2024-01-01"
   }
 }
 
@@ -386,7 +386,7 @@ POST /api/Users/crud
   },
   "conflict": ["username"],
   "where": {
-    "created_at": { "<": "2024-01-01" }
+    "created_at": "<2024-01-01"
   }
 }
 
@@ -411,11 +411,11 @@ POST /api/Users/crud
 {
   "action": "list",
   "where": {
-    "age": { ">=": 18, "<=": 65 },
-    "email": { "like": "%@example.com" },
-    "first_name": { "in": ["John", "Jane", "Bob"] },
+    "age": "><18,65",
+    "email": "%@example.com",
+    "first_name": "[]John,Jane,Bob",
     "is_active": true,
-    "created_at": { ">=": "2024-01-01", "<=": "2024-12-31" }
+    "created_at": "><2024-01-01,2024-12-31"
   }
 }
 
@@ -440,7 +440,7 @@ POST /api/Users/crud
   "action": "list",
   "where": {
     "status": "active",
-    "Or:name": "like:%john%"
+    "Or:name": "%john%"
   }
 }
 // Generated SQL: WHERE status = 'active' OR name LIKE '%john%'
@@ -463,7 +463,7 @@ POST /api/Users/crud
   "action": "list",
   "where": {
     "status": "active",
-    "age": { ">=": 18 },
+    "age": ">=18",
     "Or:role": "admin",
     "Or:role": "super_admin"
   }
@@ -476,8 +476,8 @@ POST /api/Users/crud
   "action": "list",
   "where": {
     "department": "sales",
-    "Or:email": { "like": "%@company.com" },
-    "Or:created_at": { ">=": "2024-01-01" }
+    "Or:email": "%@company.com",
+    "Or:created_at": ">=2024-01-01"
   }
 }
 // Generated SQL: WHERE department = 'sales' OR email LIKE '%@company.com' OR created_at >= '2024-01-01'
@@ -527,7 +527,7 @@ POST /api/Users/crud
 {
   "action": "list",
   "where": [
-    { "is_active": true, "age": { ">=": 18 } },
+    { "is_active": true, "age": ">=18" },
     { "Or:status": "verified" },
     { "Or:role": "admin" }
   ]
@@ -541,7 +541,7 @@ POST /api/Users/crud
   "where": [
     { "department": "engineering" },
     { "Or:department": "product" },
-    { "created_at": { ">=": "2024-01-01" } }
+    { "created_at": ">=2024-01-01" }
   ]
 }
 // Generated SQL: WHERE department = 'engineering' OR department = 'product' AND created_at >= '2024-01-01'
@@ -549,21 +549,40 @@ POST /api/Users/crud
 
 ### Where Operators Reference
 
-| Operator | Description | Example |
-|----------|-------------|---------|
-| `=` (default) | Equals | `"status": "active"` |
-| `>=` | Greater than or equal | `"age": { ">=": 18 }` |
-| `<=` | Less than or equal | `"age": { "<=": 65 }` |
-| `>` | Greater than | `"price": { ">": 100 }` |
-| `<` | Less than | `"price": { "<": 500 }` |
-| `!=` | Not equal | `"status": { "!=": "deleted" }` |
-| `like` | Pattern matching | `"name": { "like": "%john%" }` |
-| `in` | Value in list | `"status": ["active", "pending"]` |
-| `notIn` | Value not in list | `"role": { "notIn": ["banned", "suspended"] }` |
-| `between` | Range (inclusive) | `"age": { "between": [18, 65] }` |
-| `notBetween` | Outside range | `"score": { "notBetween": [0, 50] }` |
-| `null` | IS NULL check | `"deleted_at": null` |
-| `Or:column` | OR condition prefix | `"Or:name": "John"` |
+| Operator | Description | Syntax | Example |
+|----------|-------------|--------|---------|
+| `=` (default) | Equals | `value` | `"status": "active"` |
+| `>=` | Greater than or equal | `>=value` | `"age": ">=18"` |
+| `<=` | Less than or equal | `<=value` | `"age": "<=65"` |
+| `>` | Greater than | `>value` | `"price": ">100"` |
+| `<` | Less than | `<value` | `"price": "<500"` |
+| `!=` | Not equal | `!value` | `"status": "!deleted"` |
+| `like` | Pattern matching (auto) | `%value%` | `"name": "%john%"` |
+| `in` | Value in list | `[]val1,val2` | `"status": "[]active,pending"` |
+| `notIn` | Value not in list | `![]val1,val2` | `"role": "![]banned,suspended"` |
+| `between` | Range (inclusive) | `><min,max` | `"age": "><18,65"` |
+| `notBetween` | Outside range | `<>min,max` | `"score": "<>0,50"` |
+| `null` | IS NULL check | `null` | `"deleted_at": null` |
+| `Or:column` | OR condition prefix | `Or:column` | `"Or:name": "John"` |
+
+**Examples:**
+
+```javascript
+// Complex query with string-based operators
+POST /api/Users/crud
+{
+  "action": "list",
+  "where": {
+    "age": ">=18",
+    "status": "!deleted",
+    "name": "%john%",
+    "role": "[]admin,moderator,editor",
+    "score": "><50,100"
+  }
+}
+// SQL: WHERE age >= 18 AND status != 'deleted' AND name LIKE '%john%' 
+//      AND role IN ('admin', 'moderator', 'editor') AND score BETWEEN 50 AND 100
+```
 
 ### Sorting
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dreamtree-org/korm-js",
-  "version": "1.0.44",
+  "version": "1.0.45",
   "description": "Knowledge Object-Relational Mapping - A powerful, modular ORM system for Node.js with dynamic database operations, complex queries, relationships, and nested requests",
   "author": {
     "name": "Partha Preetham Krishna",