@xano/developer-mcp 1.0.45 → 1.0.47

package/dist/xanoscript_docs/cheatsheet.md

@@ -33,21 +33,46 @@ conditional {
 
 > **Note:** Use `elseif` (one word), not `else if`.
 
+## Switch
+
+```xs
+switch ($input.status) {
+  case ("active") {
+    var $message { value = "User is active" }
+  } break
+  case ("pending") {
+    var $message { value = "User is pending" }
+  } break
+  default {
+    var $message { value = "Unknown status" }
+  }
+}
+```
+
+> **Note:** `break` goes **after** the closing `}` of each `case` block. The `default` case does not need `break`.
+
 ## Loops
 
 ```xs
 // For each loop
-each ($input.items as $item) {
-  debug.log { value = $item.name }
+foreach ($input.items) {
+  each as $item {
+    debug.log { value = $item.name }
+  }
 }
 
-// While loop (must be inside stack block)
-stack {
-  var $counter { value = 0 }
-  while ($counter < 10) {
-    each {
-      var.update $counter { value = $counter + 1 }
-    }
+// For loop (iterate N times)
+for (10) {
+  each as $index {
+    debug.log { value = $index }
+  }
+}
+
+// While loop
+var $counter { value = 0 }
+while ($counter < 10) {
+  each {
+    var.update $counter { value = $counter + 1 }
   }
 }
 

package/dist/xanoscript_docs/integrations/external-apis.md

@@ -149,25 +149,29 @@ var $content_type { value = $api_result.response.headers|first }
 var $retries { value = 0 }
 var $success { value = false }
 
-while ($retries < 3 && $success == false) {
-  try_catch {
-    try {
-      api.request {
-        url = "https://api.example.com/data"
-        method = "GET"
-        timeout = 10
-      } as $api_result
-
-      conditional {
-        if ($api_result.response.status == 200) {
-          var.update $success { value = true }
+stack {
+  while ($retries < 3 && $success == false) {
+    each {
+      try_catch {
+        try {
+          api.request {
+            url = "https://api.example.com/data"
+            method = "GET"
+            timeout = 10
+          } as $api_result
+
+          conditional {
+            if ($api_result.response.status == 200) {
+              var.update $success { value = true }
+            }
+          }
+        }
+        catch {
+          var.update $retries { value = $retries + 1 }
+          util.sleep { value = 2 }
         }
       }
     }
-    catch {
-      var.update $retries { value = $retries + 1 }
-      util.sleep { value = 2 }
-    }
   }
 }
 ```

package/dist/xanoscript_docs/performance.md

@@ -286,11 +286,14 @@ For basic rate limiting setup, see `xanoscript_docs({ topic: "security" })`. Bel
 
 ```xs
 // Different limits by user tier
-var $limit {
-  value = conditional {
-    if ($auth.tier == "premium") { 1000 }
-    elseif ($auth.tier == "pro") { 500 }
-    else { 100 }
+var $limit { value = 100 }
+
+conditional {
+  if ($auth.tier == "premium") { 
+    var.update $limit { value = 1000 } 
+  }
+  elseif ($auth.tier == "pro") {
+    var.update $limit { value = 500 } 
   }
 }
 

package/dist/xanoscript_docs/syntax.md

@@ -150,16 +150,19 @@ conditional {
 
 > **Important:** Use `elseif` (one word), not `else if` or `else { if (...) }`. Nested `if` inside `else` blocks is not supported.
 
-### Conditional as Expression
+### Conditional with Variable Updates
 
-Use conditional blocks inline to return values:
+Use conditional blocks to update a variable based on conditions:
 
 ```xs
-var $tier_limit {
-  value = conditional {
-    if ($auth.tier == "premium") { 1000 }
-    elseif ($auth.tier == "pro") { 500 }
-    else { 100 }
+var $tier_limit { value = 100 }
+
+conditional {
+  if ($auth.tier == "premium") { 
+    var.update $tier_limit { value = 1000 }
+  }
+  elseif ($auth.tier == "pro") { 
+    var.update $tier_limit { value = 500 }
   }
 }
 ```

package/dist/xanoscript_docs/workflow-tests.md

@@ -55,6 +55,8 @@ addon.call "<addon_name>" as $result
 
 ### function.call
 
+> **Important:** Always use `function.call` in workflow tests, not `function.run`. `function.call` handles errors internally, which is required for `expect` assertions (such as `expect.to_throw`) to work correctly. `function.run` is for calling functions from other primitives (APIs, functions, tasks, etc.) outside of workflow tests.
+
 ```xs
 function.call "<function_name>" {
   input = { key: "value" }
@@ -319,7 +321,8 @@ workflow_test "comprehensive_test" {
 2. **Tag for filtering** — Use tags like `critical`, `e2e`, `smoke` to organize test suites
 3. **Avoid `datasource = "live"`** — The entire datasource is cloned before each test run, which can be slow. Use no datasource or a smaller custom datasource instead
 4. **Keep tests independent** — Each workflow test should be self-contained and not depend on other tests
-5. **Use assertions over preconditions** — Prefer `expect.*` assertions for clearer test intent
+5. **Use `function.call`, not `function.run`** — `function.call` handles errors so that `expect` assertions work correctly. `function.run` is for calling functions outside of workflow tests
+6. **Use assertions over preconditions** — Prefer `expect.*` assertions for clearer test intent
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xano/developer-mcp",
-  "version": "1.0.45",
+  "version": "1.0.47",
   "description": "MCP server and library for Xano development - XanoScript validation, Meta API, Run API, and CLI documentation",
   "type": "module",
   "main": "dist/lib.js",