@xano/developer-mcp 1.0.20 → 1.0.22

package/dist/xanoscript_docs_auto/operators.md

@@ -0,0 +1,368 @@
+---
+applyTo: "**/*.xs"
+---
+
+# Operators
+
+Complete reference for XanoScript operators.
+
+## Quick Reference
+
+| Category | Operators |
+|----------|-----------|
+| Arithmetic | `+`, `-`, `*`, `/`, `%` |
+| Comparison | `==`, `!=`, `>`, `<`, `>=`, `<=` |
+| Strict | `===`, `!==` |
+| Logical | `&&`, `\|\|`, `!` |
+| String | `~` (concat) |
+| Null-safe | `==?`, `!=?`, `>=?`, `<=?` |
+| Nullish | `??` |
+| Pipe | `\|` (filters) |
+| Database | `=`, `in`, `like`, `ilike`, `between`, `contains`, `@>`, `~` |
+
+---
+
+## Arithmetic Operators
+
+```xs
+$a + $b      // Addition
+$a - $b      // Subtraction
+$a * $b      // Multiplication
+$a / $b      // Division
+$a % $b      // Modulus (remainder)
+```
+
+### Examples
+
+```xs
+var $total {
+  value = $input.quantity * $input.price
+}
+
+var $remainder {
+  value = $input.value % 10
+}
+
+var $average {
+  value = $sum / $count
+}
+```
+
+---
+
+## Comparison Operators
+
+```xs
+$a == $b      // Equal
+$a != $b      // Not equal
+$a > $b       // Greater than
+$a >= $b      // Greater or equal
+$a < $b       // Less than
+$a <= $b      // Less or equal
+```
+
+### Strict Equality
+
+```xs
+$a === $b     // Strict equal (type + value)
+$a !== $b     // Strict not equal
+```
+
+### Examples
+
+```xs
+conditional {
+  if ($input.age >= 18) {
+    var $status { value = "adult" }
+  }
+  elseif ($input.age >= 13) {
+    var $status { value = "teen" }
+  }
+  else {
+    var $status { value = "child" }
+  }
+}
+```
+
+---
+
+## Logical Operators
+
+```xs
+$a && $b      // AND - both must be true
+$a || $b      // OR - at least one true
+!$a           // NOT - invert boolean
+```
+
+### Examples
+
+```xs
+conditional {
+  if ($user != null && $user.active) {
+    // User exists and is active
+  }
+}
+
+conditional {
+  if ($input.role == "admin" || $input.role == "moderator") {
+    // Has elevated permissions
+  }
+}
+
+conditional {
+  if (!$input.disabled) {
+    // Not disabled
+  }
+}
+```
+
+---
+
+## String Concatenation
+
+Use `~` for string concatenation:
+
+```xs
+var $greeting {
+  value = "Hello, " ~ $input.name ~ "!"
+}
+
+var $full_name {
+  value = $input.first_name ~ " " ~ $input.last_name
+}
+```
+
+---
+
+## Null-Safe Operators
+
+In database queries, ignore condition if value is null:
+
+```xs
+db.query "product" {
+  where = $db.product.category ==? $input.category
+        && $db.product.price >=? $input.min_price
+        && $db.product.price <=? $input.max_price
+} as $products
+```
+
+| Operator | Description |
+|----------|-------------|
+| `==?` | Equal if not null |
+| `!=?` | Not equal if not null |
+| `>=?` | Greater or equal if not null |
+| `<=?` | Less or equal if not null |
+| `>?` | Greater than if not null |
+| `<?` | Less than if not null |
+
+---
+
+## Nullish Coalescing
+
+Return right operand when left is null (not just falsy):
+
+```xs
+$value ?? "default"     // Returns "default" only if $value is null
+$value || "default"     // Returns "default" if $value is null, 0, "", or false
+```
+
+### Difference
+
+```xs
+var $count { value = 0 }
+$count ?? 10            // Returns 0 (not null)
+$count || 10            // Returns 10 (0 is falsy)
+```
+
+---
+
+## Pipe Operator
+
+Chain filters with `|`:
+
+```xs
+$input.email|trim|lower
+$input.name|strlen
+$array|first
+($a + $b)|round:2
+```
+
+### Filter Chaining
+
+```xs
+var $processed {
+  value = $input.text
+         |trim
+         |lower
+         |replace:" ":"-"
+         |substr:0:50
+}
+```
+
+---
+
+## Database Query Operators
+
+### Basic Operators
+
+```xs
+db.query "product" {
+  where = $db.product.status == "active"
+        && $db.product.price > 10
+        && $db.product.stock >= 1
+} as $products
+```
+
+### IN Operator
+
+```xs
+db.query "product" {
+  where = $db.product.category in ["electronics", "clothing", "books"]
+} as $products
+
+db.query "product" {
+  where = $db.product.status not in ["deleted", "archived"]
+} as $products
+```
+
+### LIKE / ILIKE (Pattern Matching)
+
+```xs
+// Case-sensitive pattern
+db.query "product" {
+  where = $db.product.name like "%Widget%"
+} as $products
+
+// Case-insensitive pattern
+db.query "product" {
+  where = $db.product.name ilike "%widget%"
+} as $products
+
+// Negated
+db.query "product" {
+  where = $db.product.name not ilike "%test%"
+} as $products
+```
+
+### BETWEEN
+
+```xs
+db.query "product" {
+  where = $db.product.price between 10:100
+} as $products
+
+db.query "order" {
+  where = $db.order.created_at between $start_date:$end_date
+} as $orders
+```
+
+### Array Contains
+
+```xs
+// Array contains value
+db.query "product" {
+  where = $db.product.tags|contains:"featured"
+} as $products
+
+// String includes substring
+db.query "product" {
+  where = $db.product.description|includes:"sale"
+} as $products
+
+// Arrays share elements
+db.query "product" {
+  where = $db.product.categories|overlaps:["tech", "gadgets"]
+} as $products
+```
+
+### JSON Contains
+
+```xs
+db.query "product" {
+  where = $db.product.metadata @> {"featured": true}
+} as $products
+```
+
+### Regex Match
+
+```xs
+db.query "product" {
+  where = $db.product.sku ~ "^SKU-[0-9]+"
+} as $products
+
+// Negated regex
+db.query "product" {
+  where = $db.product.name !~ "^test"
+} as $products
+```
+
+### Full-Text Search
+
+```xs
+db.query "product" {
+  where = $db.product.description search $input.query
+} as $products
+```
+
+---
+
+## Bitwise Operators
+
+### As Filters
+
+```xs
+5|bitwise_and:3         // 1
+5|bitwise_or:3          // 7
+5|bitwise_xor:3         // 6
+5|bitwise_not           // -6
+```
+
+### As Functions
+
+```xs
+math.bitwise.and {
+  a = 5
+  b = 3
+} as $result            // 1
+
+math.bitwise.or {
+  a = 5
+  b = 3
+} as $result            // 7
+
+math.bitwise.xor {
+  a = 5
+  b = 3
+} as $result            // 6
+```
+
+---
+
+## Operator Precedence
+
+From highest to lowest:
+
+1. `()` - Parentheses
+2. `|` - Pipe/filters
+3. `!` - Logical NOT
+4. `*`, `/`, `%` - Multiplication, division, modulus
+5. `+`, `-` - Addition, subtraction
+6. `~` - String concatenation
+7. `<`, `<=`, `>`, `>=` - Comparison
+8. `==`, `!=`, `===`, `!==` - Equality
+9. `&&` - Logical AND
+10. `||` - Logical OR
+11. `??` - Nullish coalescing
+
+### Examples
+
+```xs
+// Parentheses override precedence
+var $result { value = (2 + 3) * 4 }      // 20, not 14
+
+// Filters bind tightly
+var $len { value = $text|trim|strlen }
+
+// Logical operators
+var $ok { value = $a > 0 && $b < 100 || $override }
+```

package/dist/xanoscript_docs_auto/syntax.md

@@ -0,0 +1,287 @@
+---
+applyTo: "**/*.xs"
+---
+
+# Syntax Reference
+
+Complete reference for XanoScript expressions, operators, and filters.
+
+## Quick Reference
+
+### Operators
+| Category | Operators |
+|----------|-----------|
+| Comparison | `==`, `!=`, `>`, `<`, `>=`, `<=` |
+| Logical | `&&`, `\|\|`, `!` |
+| Math | `+`, `-`, `*`, `/`, `%` |
+| String | `~` (concat) |
+| Null-safe | `==?`, `!=?`, `>=?`, `<=?` (ignore if null) |
+
+### Common Filters
+| Filter | Purpose | Example |
+|--------|---------|---------|
+| `trim` | Remove whitespace | `$s\|trim` |
+| `lower` / `upper` | Case conversion | `$s\|to_lower` |
+| `first` / `last` | Array endpoints | `$arr\|first` |
+| `count` | Array/object length | `$arr\|count` |
+| `get` | Object property | `$obj\|get:"key"` |
+| `set` | Set property | `$obj\|set:"key":"val"` |
+| `json_encode` / `json_decode` | JSON conversion | `$obj\|json_encode` |
+
+---
+
+## Expressions
+
+Expressions evaluate values using operators and filters:
+
+```xs
+var $total { value = $input.qty * $input.price }
+var $name { value = $input.first ~ " " ~ $input.last }
+
+conditional {
+  if ($input.age >= 18) { ... }
+}
+```
+
+---
+
+## Math Filters
+
+| Filter | Example | Result |
+|--------|---------|--------|
+| `add` | `10\|add:5` | `15` |
+| `subtract` | `10\|subtract:3` | `7` |
+| `multiply` | `10\|multiply:2` | `20` |
+| `divide` | `10\|divide:2` | `5` |
+| `modulus` | `10\|modulus:3` | `1` |
+| `floor` | `2.7\|floor` | `2` |
+| `ceil` | `2.3\|ceil` | `3` |
+| `round` | `2.567\|round:2` | `2.57` |
+| `abs` | `-5\|abs` | `5` |
+| `sqrt` | `9\|sqrt` | `3` |
+| `pow` | `2\|pow:3` | `8` |
+| `min` | `5\|min:3` | `3` |
+| `max` | `5\|max:10` | `10` |
+
+### Array Math
+```xs
+[1,2,3,4]|sum        // 10
+[1,2,3,4]|avg        // 2.5
+[1,2,3,4]|product    // 24
+[5,2,8,1]|array_min  // 1
+[5,2,8,1]|array_max  // 8
+```
+
+### Trigonometry
+`sin`, `cos`, `tan`, `asin`, `acos`, `atan`, `deg2rad`, `rad2deg`
+
+---
+
+## String Filters
+
+| Filter | Example | Result |
+|--------|---------|--------|
+| `trim` | `"  hi  "\|trim` | `"hi"` |
+| `ltrim` / `rtrim` | `"  hi"\|ltrim` | `"hi"` |
+| `to_lower` | `"Hi"\|to_lower` | `"hi"` |
+| `to_upper` | `"Hi"\|to_upper` | `"HI"` |
+| `capitalize` | `"hi there"\|capitalize` | `"Hi There"` |
+| `strlen` | `"hello"\|strlen` | `5` |
+| `substr` | `"hello"\|substr:1:3` | `"ell"` |
+| `split` | `"a,b,c"\|split:","` | `["a","b","c"]` |
+| `replace` | `"hello"\|replace:"l":"x"` | `"hexxo"` |
+| `contains` | `"hello"\|contains:"ell"` | `true` |
+| `starts_with` | `"hello"\|starts_with:"he"` | `true` |
+| `ends_with` | `"hello"\|ends_with:"lo"` | `true` |
+| `concat` | `"a"\|concat:"b":"-"` | `"a-b"` |
+
+### Case-Insensitive Variants
+`icontains`, `istarts_with`, `iends_with`, `iindex`
+
+### Regex
+```xs
+"/pattern/"|regex_matches:"subject"           // Boolean match
+"/(\w+)/"|regex_get_first_match:"test"        // First match
+"/\w+/"|regex_get_all_matches:"a b c"         // All matches
+"/\s+/"|regex_replace:"-":"a  b"              // Replace: "a-b"
+```
+
+---
+
+## Array Filters
+
+| Filter | Example | Result |
+|--------|---------|--------|
+| `first` | `[1,2,3]\|first` | `1` |
+| `last` | `[1,2,3]\|last` | `3` |
+| `count` | `[1,2,3]\|count` | `3` |
+| `reverse` | `[1,2,3]\|reverse` | `[3,2,1]` |
+| `unique` | `[1,1,2]\|unique` | `[1,2]` |
+| `flatten` | `[[1,2],[3]]\|flatten` | `[1,2,3]` |
+| `shuffle` | `[1,2,3]\|shuffle` | Random order |
+| `slice` | `[1,2,3,4]\|slice:1:2` | `[2,3]` |
+| `push` | `[1,2]\|push:3` | `[1,2,3]` |
+| `pop` | `[1,2,3]\|pop` | `3` |
+| `shift` | `[1,2,3]\|shift` | `1` |
+| `unshift` | `[1,2]\|unshift:0` | `[0,1,2]` |
+| `merge` | `[1,2]\|merge:[3,4]` | `[1,2,3,4]` |
+| `diff` | `[1,2,3]\|diff:[2]` | `[1,3]` |
+| `intersect` | `[1,2,3]\|intersect:[2,3,4]` | `[2,3]` |
+| `join` | `["a","b"]\|join:","` | `"a,b"` |
+| `range` | `\|range:1:5` | `[1,2,3,4,5]` |
+
+### Functional Operations
+```xs
+// Map - transform each element
+[{v:1},{v:2}]|map:$$.v*2                    // [2,4]
+
+// Filter - keep matching elements
+[1,2,3,4]|filter:$$%2==0                    // [2,4]
+
+// Find - first matching element
+[{id:1},{id:2}]|find:$$.id==2               // {id:2}
+
+// FindIndex - index of first match
+[{id:1},{id:2}]|findIndex:$$.id==2          // 1
+
+// Some - any element matches?
+[1,2,3]|some:$$>2                           // true
+
+// Every - all elements match?
+[2,4,6]|every:$$%2==0                       // true
+
+// Reduce - accumulate to single value
+[1,2,3,4]|reduce:$$+$result:0               // 10
+```
+
+### Grouping & Indexing
+```xs
+// Group by property
+[{g:"a",v:1},{g:"b",v:2},{g:"a",v:3}]|index_by:g
+
+// Sort
+[{n:"z"},{n:"a"}]|sort:n:text:false         // Ascending by n
+```
+
+---
+
+## Object Filters
+
+| Filter | Example | Result |
+|--------|---------|--------|
+| `get` | `{a:1}\|get:"a"` | `1` |
+| `set` | `{a:1}\|set:"b":2` | `{a:1,b:2}` |
+| `unset` | `{a:1,b:2}\|unset:"b"` | `{a:1}` |
+| `has` | `{a:1}\|has:"a"` | `true` |
+| `keys` | `{a:1,b:2}\|keys` | `["a","b"]` |
+| `values` | `{a:1,b:2}\|values` | `[1,2]` |
+| `entries` | `{a:1}\|entries` | `[{key:"a",value:1}]` |
+| `pick` | `{a:1,b:2,c:3}\|pick:[a,c]` | `{a:1,c:3}` |
+| `unpick` | `{a:1,b:2,c:3}\|unpick:[b]` | `{a:1,c:3}` |
+
+### Conditional Set
+```xs
+{a:1}|set_conditional:"b":2:true            // {a:1,b:2} if condition true
+{a:1}|set_ifnotempty:"b":"val"              // Set only if val not empty
+{a:1}|set_ifnotnull:"b":$var                // Set only if $var not null
+```
+
+---
+
+## Type Filters
+
+| Filter | Example | Result |
+|--------|---------|--------|
+| `to_int` | `"123"\|to_int` | `123` |
+| `to_decimal` | `"1.5"\|to_decimal` | `1.5` |
+| `to_text` | `123\|to_text` | `"123"` |
+| `to_bool` | `"true"\|to_bool` | `true` |
+| `is_null` | `null\|is_null` | `true` |
+| `is_empty` | `[]\|is_empty` | `true` |
+| `is_array` | `[1]\|is_array` | `true` |
+| `is_object` | `{}\|is_object` | `true` |
+
+### Null Handling
+```xs
+null|first_notnull:0                        // 0
+""|first_notempty:"default"                 // "default"
+```
+
+---
+
+## Date/Time Filters
+
+| Filter | Example | Description |
+|--------|---------|-------------|
+| `to_timestamp` | `"now"\|to_timestamp` | Parse to timestamp |
+| `to_ms` | `"now"\|to_ms` | Milliseconds since epoch |
+| `to_seconds` | `"now"\|to_seconds` | Seconds since epoch |
+| `format_timestamp` | `$ts\|format_timestamp:"Y-m-d":"UTC"` | Format timestamp |
+| `transform_timestamp` | `$ts\|transform_timestamp:"-7 days"` | Relative time |
+| `add_secs_to_timestamp` | `$ts\|add_secs_to_timestamp:60` | Add seconds |
+
+### Timestamp Parts
+```xs
+$ts|timestamp_year           // Year
+$ts|timestamp_month          // Month (1-12)
+$ts|timestamp_day_of_month   // Day (1-31)
+$ts|timestamp_hour           // Hour (0-23)
+$ts|timestamp_minute         // Minute (0-59)
+$ts|timestamp_day_of_week    // Day (0=Sunday)
+```
+
+---
+
+## Encoding Filters
+
+| Filter | Example |
+|--------|---------|
+| `json_encode` | `{a:1}\|json_encode` |
+| `json_decode` | `'{"a":1}'\|json_decode` |
+| `base64_encode` | `"hello"\|base64_encode` |
+| `base64_decode` | `"aGVsbG8="\|base64_decode` |
+| `url_encode` | `"a b"\|url_encode` |
+| `url_decode` | `"a%20b"\|url_decode` |
+| `xml_decode` | `"<a>1</a>"\|xml_decode` |
+| `yaml_encode` / `yaml_decode` | YAML conversion |
+
+---
+
+## Security Filters
+
+| Filter | Example |
+|--------|---------|
+| `md5` | `"text"\|md5` |
+| `sha1` / `sha256` / `sha512` | Hash functions |
+| `hmac_sha256` | `"msg"\|hmac_sha256:"key"` |
+| `encrypt` | `"data"\|encrypt:"aes-256-cbc":"key":"iv"` |
+| `decrypt` | `$enc\|decrypt:"aes-256-cbc":"key":"iv"` |
+| `uuid` | `\|uuid` |
+
+---
+
+## System Variables
+
+### Request Context
+| Variable | Description |
+|----------|-------------|
+| `$remote_ip` | Client IP address |
+| `$request_method` | HTTP method |
+| `$request_uri` | Full request URI |
+| `$http_headers` | Request headers object |
+| `$request_auth_token` | Authorization token |
+
+### System Context
+| Variable | Description |
+|----------|-------------|
+| `$datasource` | Current data source name |
+| `$branch` | Current branch name |
+| `$tenant` | Tenant ID |
+| `$api_baseurl` | API base URL |
+
+### Access via $env
+```xs
+var $client_ip { value = $env.$remote_ip }
+var $method { value = $env.$request_method }
+var $headers { value = $env.$http_headers }
+```