@xano/developer-mcp 1.0.26 → 1.0.27

package/dist/xanoscript_docs_auto/operators.md

@@ -1,368 +0,0 @@
----
-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

@@ -1,287 +0,0 @@
----
-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 }
-```