@xano/developer-mcp 1.0.34 → 1.0.36

package/dist/xanoscript_docs/integrations/redis.md

@@ -0,0 +1,194 @@
+---
+applyTo: "function/**/*.xs, api/**/*.xs, task/**/*.xs"
+---
+
+# Redis Integration
+
+> **TL;DR:** `redis.*` for caching, counters, lists, and rate limiting. Key-value storage with TTL support.
+
+## Quick Reference
+
+| Operation | Purpose |
+|-----------|---------|
+| `redis.set` | Store value with optional TTL |
+| `redis.get` | Retrieve value |
+| `redis.has` | Check if key exists |
+| `redis.del` | Delete key |
+| `redis.incr` / `redis.decr` | Increment/decrement counters |
+| `redis.push` / `redis.pop` | List operations (end) |
+| `redis.unshift` / `redis.shift` | List operations (front) |
+| `redis.range` | Get list range |
+| `redis.count` | Get list length |
+| `redis.ratelimit` | Rate limiting |
+
+---
+
+## Key-Value Operations
+
+```xs
+// Set value
+redis.set {
+  key = "user:123:session"
+  data = $session_data
+  ttl = 3600                            // Expires in 1 hour
+}
+
+// Get value
+redis.get { key = "user:123:session" } as $session
+
+// Check exists
+redis.has { key = "user:123:session" } as $exists
+
+// Delete
+redis.del { key = "user:123:session" }
+```
+
+---
+
+## Counters
+
+```xs
+# Increment
+redis.incr {
+  key = "page_views"
+  by = 1
+} as $new_count
+
+# Decrement
+redis.decr {
+  key = "inventory:item-123"
+  by = 1
+} as $new_count
+```
+
+---
+
+## Lists
+
+```xs
+# Push to end
+redis.push {
+  key = "queue:tasks"
+  value = $task
+} as $length
+
+# Push to front
+redis.unshift {
+  key = "queue:priority"
+  value = $urgent_task
+}
+
+# Pop from end
+redis.pop { key = "queue:tasks" } as $task
+
+# Pop from front
+redis.shift { key = "queue:tasks" } as $task
+
+# Get range
+redis.range {
+  key = "recent:logs"
+  start = 0
+  stop = 9
+} as $logs
+
+# Count
+redis.count { key = "queue:tasks" } as $count
+```
+
+---
+
+## Rate Limiting
+
+```xs
+redis.ratelimit {
+  key = "api:" ~ $env.$remote_ip
+  max = 100
+  ttl = 60
+  error = "Rate limit exceeded"
+} as $status
+```
+
+---
+
+## Common Patterns
+
+### Session Caching
+
+```xs
+// Store session
+redis.set {
+  key = "session:" ~ $token
+  data = { user_id: $user.id, role: $user.role }
+  ttl = 86400  // 24 hours
+}
+
+// Retrieve session
+redis.get { key = "session:" ~ $input.token } as $session
+
+precondition ($session != null) {
+  error_type = "accessdenied"
+  error = "Invalid session"
+}
+```
+
+### API Response Caching
+
+```xs
+// Check cache first
+redis.get { key = "cache:products:" ~ $input.category } as $cached
+
+conditional {
+  if ($cached != null) {
+    var $products { value = $cached }
+  }
+  else {
+    // Fetch from database
+    db.query "product" {
+      where = $db.product.category == $input.category
+    } as $products
+
+    // Cache for 5 minutes
+    redis.set {
+      key = "cache:products:" ~ $input.category
+      data = $products
+      ttl = 300
+    }
+  }
+}
+```
+
+### Queue Processing
+
+```xs
+// Add to queue
+redis.push {
+  key = "queue:emails"
+  value = { to: $user.email, subject: "Welcome", body: $message }
+}
+
+// Process queue (in a task)
+redis.shift { key = "queue:emails" } as $email
+
+conditional {
+  if ($email != null) {
+    util.send_email {
+      service_provider = "resend"
+      api_key = $env.RESEND_API_KEY
+      to = $email.to
+      from = "noreply@example.com"
+      subject = $email.subject
+      message = $email.body
+    }
+  }
+}
+```
+
+---
+
+## Related Topics
+
+| Topic | Description |
+|-------|-------------|
+| `performance` | Caching strategies |
+| `security` | Rate limiting patterns |
+| `integrations` | All integrations index |

package/dist/xanoscript_docs/integrations/search.md

@@ -0,0 +1,242 @@
+---
+applyTo: "function/**/*.xs, api/**/*.xs, task/**/*.xs"
+---
+
+# Search Integrations
+
+> **TL;DR:** `cloud.elasticsearch.*` for Elasticsearch, `cloud.aws.opensearch.*` for AWS OpenSearch, `cloud.algolia.*` for Algolia. Full-text search, document operations, and bulk indexing.
+
+## Quick Reference
+
+| Provider | Prefix | Operations |
+|----------|--------|------------|
+| Elasticsearch | `cloud.elasticsearch.*` | query, document, bulk |
+| AWS OpenSearch | `cloud.aws.opensearch.*` | query, document |
+| Algolia | `cloud.algolia.*` | search, save_object, save_objects, delete_object, set_settings |
+
+---
+
+## Elasticsearch
+
+### Search Query
+
+```xs
+cloud.elasticsearch.query {
+  auth_type = "API Key"
+  key_id = $env.ES_KEY_ID
+  access_key = $env.ES_ACCESS_KEY
+  base_url = "https://my-cluster.es.io"
+  index = "products"
+  return_type = "search"
+  expression = [{ field: "category", value: "electronics", op: "eq" }]
+  size = 10
+  sort = [{ field: "price", order: "asc" }]
+} as $results
+```
+
+### Document Operations
+
+```xs
+// Get document
+cloud.elasticsearch.document {
+  auth_type = "API Key"
+  key_id = $env.ES_KEY_ID
+  access_key = $env.ES_ACCESS_KEY
+  base_url = "https://my-cluster.es.io"
+  index = "products"
+  method = "GET"
+  doc_id = "product-123"
+} as $doc
+
+// Index document
+cloud.elasticsearch.document {
+  auth_type = "API Key"
+  key_id = $env.ES_KEY_ID
+  access_key = $env.ES_ACCESS_KEY
+  base_url = "https://my-cluster.es.io"
+  index = "products"
+  method = "PUT"
+  doc_id = "product-123"
+  body = {
+    name: "Product Name",
+    category: "electronics",
+    price: 99.99
+  }
+}
+
+// Delete document
+cloud.elasticsearch.document {
+  auth_type = "API Key"
+  key_id = $env.ES_KEY_ID
+  access_key = $env.ES_ACCESS_KEY
+  base_url = "https://my-cluster.es.io"
+  index = "products"
+  method = "DELETE"
+  doc_id = "product-123"
+}
+```
+
+### Bulk Operations
+
+```xs
+cloud.elasticsearch.bulk {
+  auth_type = "API Key"
+  key_id = $env.ES_KEY_ID
+  access_key = $env.ES_ACCESS_KEY
+  base_url = "https://my-cluster.es.io"
+  index = "products"
+  operations = [
+    { action: "index", id: "1", doc: { name: "Product 1" } },
+    { action: "update", id: "2", doc: { price: 29.99 } },
+    { action: "delete", id: "3" }
+  ]
+} as $result
+```
+
+### Advanced Search
+
+```xs
+cloud.elasticsearch.query {
+  auth_type = "API Key"
+  key_id = $env.ES_KEY_ID
+  access_key = $env.ES_ACCESS_KEY
+  base_url = "https://my-cluster.es.io"
+  index = "products"
+  return_type = "search"
+  query = {
+    bool: {
+      must: [
+        { match: { name: $input.search } }
+      ],
+      filter: [
+        { range: { price: { gte: $input.min_price, lte: $input.max_price } } },
+        { term: { is_active: true } }
+      ]
+    }
+  }
+  aggregations = {
+    categories: { terms: { field: "category.keyword" } },
+    avg_price: { avg: { field: "price" } }
+  }
+  size = 20
+  from = $input.offset
+} as $results
+```
+
+---
+
+## AWS OpenSearch
+
+```xs
+cloud.aws.opensearch.query {
+  region = "us-east-1"
+  access_key = $env.AWS_ACCESS_KEY
+  secret_key = $env.AWS_SECRET_KEY
+  endpoint = "https://search-domain.us-east-1.es.amazonaws.com"
+  index = "logs"
+  query = {
+    bool: {
+      must: [
+        { match: { level: "error" } }
+      ],
+      filter: [
+        { range: { timestamp: { gte: "now-24h" } } }
+      ]
+    }
+  }
+  size = 100
+} as $logs
+
+// Index document
+cloud.aws.opensearch.document {
+  region = "us-east-1"
+  access_key = $env.AWS_ACCESS_KEY
+  secret_key = $env.AWS_SECRET_KEY
+  endpoint = "https://search-domain.us-east-1.es.amazonaws.com"
+  index = "logs"
+  method = "PUT"
+  doc_id = $log_id
+  body = $log_data
+}
+```
+
+---
+
+## Algolia
+
+### Search
+
+```xs
+cloud.algolia.search {
+  app_id = $env.ALGOLIA_APP_ID
+  api_key = $env.ALGOLIA_API_KEY
+  index = "products"
+  query = $input.search
+  filters = "category:electronics AND price<100"
+  facets = ["category", "brand"]
+  hitsPerPage = 20
+  page = $input.page
+} as $results
+```
+
+### Manage Records
+
+```xs
+// Add/update record
+cloud.algolia.save_object {
+  app_id = $env.ALGOLIA_APP_ID
+  api_key = $env.ALGOLIA_ADMIN_KEY
+  index = "products"
+  object = {
+    objectID: $product.id|to_text,
+    name: $product.name,
+    category: $product.category,
+    price: $product.price
+  }
+}
+
+// Batch save
+cloud.algolia.save_objects {
+  app_id = $env.ALGOLIA_APP_ID
+  api_key = $env.ALGOLIA_ADMIN_KEY
+  index = "products"
+  objects = $products|map:{
+    objectID: $$.id|to_text,
+    name: $$.name,
+    category: $$.category
+  }
+}
+
+// Delete record
+cloud.algolia.delete_object {
+  app_id = $env.ALGOLIA_APP_ID
+  api_key = $env.ALGOLIA_ADMIN_KEY
+  index = "products"
+  objectID = $input.product_id|to_text
+}
+```
+
+### Configure Index
+
+```xs
+cloud.algolia.set_settings {
+  app_id = $env.ALGOLIA_APP_ID
+  api_key = $env.ALGOLIA_ADMIN_KEY
+  index = "products"
+  settings = {
+    searchableAttributes: ["name", "description", "category"],
+    attributesForFaceting: ["category", "brand", "filterOnly(is_active)"],
+    ranking: ["typo", "geo", "words", "filters", "proximity", "attribute", "exact", "custom"]
+  }
+}
+```
+
+---
+
+## Related Topics
+
+| Topic | Description |
+|-------|-------------|
+| `database` | Built-in database queries |
+| `integrations` | All integrations index |
+| `performance` | Caching search results |