@statechange/xano-cli 0.2.0

package/dist/xano-client.js

@@ -0,0 +1,399 @@
+/**
+ * Xano API Client - Portable version for CLI use
+ * Based on src/workers/xanoapi.ts
+ */
+const sinkCache = new Map();
+const SINK_TTL_MS = 60_000; // 1 minute
+/** Flush all sink caches (or a specific key) */
+export function flushSinkCache(key) {
+    if (key) {
+        sinkCache.delete(key);
+    }
+    else {
+        sinkCache.clear();
+    }
+}
+export class XanoClient {
+    instance;
+    token;
+    onTokenExpired;
+    constructor(config) {
+        this.instance = config.instance;
+        this.token = config.token;
+        this.onTokenExpired = config.onTokenExpired;
+    }
+    /** Flush the sink cache (call after writes) */
+    flushCache() {
+        flushSinkCache();
+    }
+    getCached(key) {
+        const entry = sinkCache.get(key);
+        if (entry && Date.now() - entry.timestamp < SINK_TTL_MS) {
+            return entry.data;
+        }
+        if (entry)
+            sinkCache.delete(key);
+        return undefined;
+    }
+    setCache(key, data) {
+        sinkCache.set(key, { data, timestamp: Date.now() });
+    }
+    async fetch(path, options) {
+        const uri = `https://${this.instance}/${path}`;
+        const response = await fetch(uri, {
+            ...(options || {}),
+            headers: {
+                ...(options?.headers || {}),
+                Authorization: `Bearer ${this.token}`,
+                "Content-Type": "application/json",
+            },
+        });
+        return response;
+    }
+    async fetchJson(path, options, attempts = 6, attemptTimeout = 10000) {
+        let currentAttempt = 0;
+        const opts = options ? { ...options } : {};
+        while (true) {
+            try {
+                const response = await this.fetch(path, opts);
+                if (!response.ok) {
+                    if (currentAttempt >= attempts) {
+                        throw new Error(`Failed to fetch ${path} after ${attempts} attempts: ${response.status} ${response.statusText}`);
+                    }
+                    else if (response.status >= 500) {
+                        await new Promise((resolve) => setTimeout(resolve, attemptTimeout * (currentAttempt + 1)));
+                        currentAttempt++;
+                        continue;
+                    }
+                    else if (response.status === 401 && this.onTokenExpired && currentAttempt === 0) {
+                        // Token rejected — try to refresh via callback
+                        try {
+                            this.token = await this.onTokenExpired();
+                            currentAttempt++;
+                            continue;
+                        }
+                        catch {
+                            // Refresh failed — fall through to throw the API error
+                        }
+                        const errorText = await response.text();
+                        const apiError = new Error(`Xano API error: 401 Unauthorized - ${errorText}\n\nYour Xano session may have expired. Run 'sc-xano auth status' to check token health.`);
+                        apiError.isApiError = true;
+                        throw apiError;
+                    }
+                    else {
+                        const errorText = await response.text();
+                        let hint = "";
+                        if (response.status === 401 || response.status === 403) {
+                            hint = `\n\nRun 'sc-xano auth status' to check your Xano session.`;
+                        }
+                        const apiError = new Error(`Xano API error: ${response.status} ${response.statusText} - ${errorText}${hint}`);
+                        apiError.isApiError = true;
+                        throw apiError;
+                    }
+                }
+                const json = (await response.json());
+                return json;
+            }
+            catch (error) {
+                // Don't retry on 4xx API errors — only retry on network/timeout failures
+                if (error.isApiError || currentAttempt >= attempts) {
+                    throw error;
+                }
+                await new Promise((resolve) => setTimeout(resolve, attemptTimeout * (currentAttempt + 1)));
+                currentAttempt++;
+            }
+        }
+    }
+    // Workspace methods
+    async getWorkspaces() {
+        return this.fetchJson(`api:mvp-admin/workspace`);
+    }
+    // Function methods (cached via sink)
+    async getFunctions(workspaceId, branchId = 0) {
+        const cacheKey = `functions:${workspaceId}:${branchId}`;
+        const cached = this.getCached(cacheKey);
+        if (cached)
+            return cached;
+        const result = await this.fetchJson(`api:mvp-admin/workspace/${workspaceId}/sink/functions?branch_id=${branchId}`);
+        this.setCache(cacheKey, result);
+        return result;
+    }
+    /** Get a single function by plucking from the sink list */
+    async getFunction(functionId, workspaceId, branchId = 0) {
+        if (workspaceId != null) {
+            const { functions } = await this.getFunctions(workspaceId, branchId);
+            const func = functions.find((f) => f.id === functionId);
+            if (func)
+                return func;
+        }
+        // Fallback to individual endpoint (may 404 on some instances)
+        return this.fetchJson(`api:mvp-admin/function/${functionId}`);
+    }
+    // App/API methods (cached via sink)
+    async getAPIAppsAndQueries(workspaceId, branchId = 0) {
+        const cacheKey = `api:${workspaceId}:${branchId}`;
+        const cached = this.getCached(cacheKey);
+        if (cached)
+            return cached;
+        const result = await this.fetchJson(`api:mvp-admin/workspace/${workspaceId}/sink/api?branch_id=${branchId}`);
+        this.setCache(cacheKey, result);
+        return result;
+    }
+    async getApp(appId, branchId) {
+        return this.fetchJson(`api:mvp-admin/app/${appId}?branch_id=${branchId}`);
+    }
+    async updateApp(app) {
+        this.flushCache();
+        return this.fetchJson(`api:mvp-admin/app/${app.id}`, {
+            method: "POST",
+            body: JSON.stringify({
+                data: app,
+                last_updated_at: app.updated_at,
+            }),
+        });
+    }
+    // Query (endpoint) methods
+    async getQuery(queryId) {
+        return this.fetchJson(`api:mvp-admin/query/${queryId}`);
+    }
+    async updateQuery(query) {
+        this.flushCache();
+        return this.fetchJson(`api:mvp-admin/query/${query.id}`, {
+            method: "POST",
+            body: JSON.stringify({
+                data: query,
+                last_updated_at: query.updated_at,
+            }),
+        });
+    }
+    // Task update
+    async updateTask(task) {
+        this.flushCache();
+        return this.fetchJson(`api:mvp-admin/task/${task.id}`, {
+            method: "POST",
+            body: JSON.stringify({
+                data: task,
+                last_updated_at: task.updated_at,
+            }),
+        });
+    }
+    // Trigger update
+    async updateTrigger(trigger) {
+        this.flushCache();
+        return this.fetchJson(`api:mvp-admin/trigger/${trigger.id}`, {
+            method: "POST",
+            body: JSON.stringify({
+                data: trigger,
+                last_updated_at: trigger.updated_at,
+            }),
+        });
+    }
+    // History methods
+    async getRequestHistory(workspaceId, page = 1, branchId = -1) {
+        return this.fetchJson(`api:mvp-admin/workspace/${workspaceId}/request?page=${page}&branch_id=${branchId}`);
+    }
+    async getRequestHistoryForQuery(queryId, page = 1, branchId = -1) {
+        return this.fetchJson(`api:mvp-admin/query/${queryId}/request?page=${page}&branch_id=${branchId}`);
+    }
+    async getRequest(requestId) {
+        return this.fetchJson(`api:mvp-admin/request/${requestId}`);
+    }
+    // Task methods (cached via sink)
+    async getTasks(workspaceId, branchId = 0) {
+        const cacheKey = `tasks:${workspaceId}:${branchId}`;
+        const cached = this.getCached(cacheKey);
+        if (cached)
+            return cached;
+        const payload = await this.fetchJson(`api:mvp-admin/workspace/${workspaceId}/sink/tasks?branch_id=${branchId}`);
+        const tasks = payload.tasks ?? [];
+        this.setCache(cacheKey, tasks);
+        return tasks;
+    }
+    async getTaskHistory(taskId, page = 1) {
+        return this.fetchJson(`api:mvp-admin/task/${taskId}/history?page=${page}`);
+    }
+    // Trigger methods (cached via sink)
+    async getTriggers(workspaceId, branchId = 0) {
+        const cacheKey = `triggers:${workspaceId}:${branchId}`;
+        const cached = this.getCached(cacheKey);
+        if (cached)
+            return cached;
+        const payload = await this.fetchJson(`api:mvp-admin/workspace/${workspaceId}/sink/trigger?branch_id=${branchId}`);
+        const triggers = payload.triggers ?? [];
+        this.setCache(cacheKey, triggers);
+        return triggers;
+    }
+    async getTriggerHistory(triggerId, branchId = 0, page = 1) {
+        return this.fetchJson(`api:mvp-admin/trigger/${triggerId}/request?branch_id=${branchId}&page=${page}`);
+    }
+    // MCP/Tool methods (cached via sink)
+    async getMCPServers(workspaceId, branchId = 0) {
+        const cacheKey = `toolsets:${workspaceId}:${branchId}`;
+        const cached = this.getCached(cacheKey);
+        if (cached)
+            return cached;
+        const payload = await this.fetchJson(`api:mvp-admin/workspace/${workspaceId}/sink/toolset?branch_id=${branchId}`);
+        const toolsets = payload.toolsets ?? [];
+        this.setCache(cacheKey, toolsets);
+        return toolsets;
+    }
+    async getMCPServerHistory(toolId, branchId = 0, page = 1) {
+        return this.fetchJson(`api:mvp-admin/toolset/${toolId}/request?branch_id=${branchId}&page=${page}`);
+    }
+    // Middleware methods (cached via sink)
+    async getMiddleware(workspaceId, branchId = 0) {
+        const cacheKey = `middleware:${workspaceId}:${branchId}`;
+        const cached = this.getCached(cacheKey);
+        if (cached)
+            return cached;
+        const payload = await this.fetchJson(`api:mvp-admin/workspace/${workspaceId}/sink/middleware?branch_id=${branchId}`);
+        const middleware = payload.middleware ?? [];
+        this.setCache(cacheKey, middleware);
+        return middleware;
+    }
+    // Addon methods (cached via sink)
+    async getAddons(workspaceId, branchId = 0) {
+        const cacheKey = `addons:${workspaceId}:${branchId}`;
+        const cached = this.getCached(cacheKey);
+        if (cached)
+            return cached;
+        const payload = await this.fetchJson(`api:mvp-admin/workspace/${workspaceId}/sink/addons?branch_id=${branchId}`);
+        const addons = payload.addons ?? [];
+        this.setCache(cacheKey, addons);
+        return addons;
+    }
+    // Workspace sink — tables/dbos (cached)
+    async getWorkspaceSink(workspaceId) {
+        const cacheKey = `sink:${workspaceId}`;
+        const cached = this.getCached(cacheKey);
+        if (cached)
+            return cached;
+        const result = await this.fetchJson(`api:mvp-admin/workspace/${workspaceId}/sink`);
+        this.setCache(cacheKey, result);
+        return result;
+    }
+    /** Get a single table by plucking from the workspace sink */
+    async getTable(tableId, workspaceId) {
+        if (workspaceId != null) {
+            const sink = await this.getWorkspaceSink(workspaceId);
+            const table = (sink.dbos ?? []).find((t) => t.id === tableId);
+            if (table)
+                return table;
+        }
+        // Fallback to individual endpoint
+        return this.fetchJson(`api:mvp-admin/dbo/${tableId}`);
+    }
+    // Task history item detail
+    async getTaskHistoryItem(taskId, runId) {
+        return this.fetchJson(`api:mvp-admin/task/${taskId}/history/${runId}`);
+    }
+    // XanoScript generation with 429 rate-limit retry
+    async generateXanoScript(workspaceId, data, kind) {
+        const body = JSON.stringify({ data, kind, path: "", type: "xs" });
+        const maxRetries = 5;
+        const baseDelay = 1000;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            const response = await this.fetch(`api:mvp-admin/workspace/${workspaceId}/script`, { method: "POST", body });
+            if (response.ok) {
+                const result = await response.json();
+                return { status: "success", payload: result };
+            }
+            if (response.status === 429 && attempt < maxRetries) {
+                const delay = baseDelay * Math.pow(2, attempt);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                continue;
+            }
+            try {
+                const result = await response.json();
+                return { status: "error", payload: result };
+            }
+            catch {
+                return {
+                    status: "error",
+                    payload: {
+                        message: response.status === 429
+                            ? `Rate limited. Failed after ${maxRetries} retries.`
+                            : "Failed to generate XanoScript",
+                        doIgnore: response.status !== 429,
+                    },
+                };
+            }
+        }
+        return { status: "error", payload: { message: "Failed to generate XanoScript", doIgnore: true } };
+    }
+    // XanoScript conversion with 429 rate-limit retry
+    async convertXanoScript(workspaceId, script) {
+        const body = JSON.stringify({ script, type: "xs" });
+        const maxRetries = 5;
+        const baseDelay = 1000;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            const response = await this.fetch(`api:mvp-admin/workspace/${workspaceId}/script/convert`, { method: "POST", body });
+            if (response.ok) {
+                const result = await response.json();
+                return { status: "success", payload: result };
+            }
+            if (response.status === 429 && attempt < maxRetries) {
+                const delay = baseDelay * Math.pow(2, attempt);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                continue;
+            }
+            try {
+                const result = await response.json();
+                return { status: "error", payload: result };
+            }
+            catch {
+                return {
+                    status: "error",
+                    payload: {
+                        message: response.status === 429
+                            ? `Rate limited. Failed after ${maxRetries} retries.`
+                            : "Failed to convert XanoScript",
+                        doIgnore: response.status !== 429,
+                    },
+                };
+            }
+        }
+        return { status: "error", payload: { message: "Failed to convert XanoScript", doIgnore: true } };
+    }
+}
+export class XanoMasterClient {
+    token;
+    constructor(config) {
+        this.token = config.token;
+    }
+    async fetchJson(path, options) {
+        const url = `https://app.xano.com/api:master/${path}`;
+        const response = await fetch(url, {
+            ...(options || {}),
+            headers: {
+                ...(options?.headers || {}),
+                Authorization: `Bearer ${this.token}`,
+                "Content-Type": "application/json",
+            },
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Xano Master API error: ${response.status} ${response.statusText} - ${errorText}`);
+        }
+        return (await response.json());
+    }
+    async getInstances() {
+        return this.fetchJson("instance");
+    }
+    async getInstanceDatabases(instanceId) {
+        return this.fetchJson(`instance/${instanceId}/request-history/database`);
+    }
+    async clearInstanceDatabases(instanceId, tables, force = false) {
+        await this.fetchJson(`instance/${instanceId}/request-history/database/clear`, {
+            method: "POST",
+            body: JSON.stringify({ tables, force }),
+        });
+    }
+    async restartDeployment(instanceId, name) {
+        await this.fetchJson(`instance/${instanceId}/deployments/restart`, {
+            method: "POST",
+            body: JSON.stringify({ name }),
+        });
+    }
+}
+//# sourceMappingURL=xano-client.js.map

package/dist/xano-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xano-client.js","sourceRoot":"","sources":["../src/xano-client.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@statechange/xano-cli",
+  "version": "0.2.0",
+  "description": "CLI for Xano workspace management, performance analysis, XanoScript generation, and operational insights via private APIs",
+  "type": "module",
+  "bin": {
+    "sc-xano": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "skills",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "xano",
+    "cli",
+    "statechange",
+    "xanoscript",
+    "performance",
+    "audit",
+    "no-code",
+    "backend"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/statechange/xano-cli.git"
+  },
+  "homepage": "https://github.com/statechange/xano-cli#readme",
+  "bugs": {
+    "url": "https://github.com/statechange/xano-cli/issues"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@statechange/xano-xray": "^0.1.0",
+    "commander": "^11.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.3.0"
+  }
+}

package/skills/performance-analysis/SKILL.md

@@ -0,0 +1,135 @@
+---
+name: performance-analysis
+description: Analyze and optimize Xano workspace performance. Use when the user wants to find slow endpoints, trace execution bottlenecks, deep-dive request stacks, or understand why their Xano API is slow. Also use when the user mentions "performance," "slow endpoint," "bottleneck," "stack trace," or "optimization."
+---
+
+# Xano Performance Analysis
+
+Requires the `sc-xano` CLI to be authenticated (see the `sc-xano` skill).
+
+## Workflow: "Why is my workspace slow?"
+
+Start broad, then drill into specifics.
+
+### Step 1: Identify the hottest endpoints
+
+```bash
+npx @statechange/xano-cli performance top-endpoints --lookback 24 --format yaml
+```
+
+Returns all endpoints, tasks, triggers, and MCP tools ranked by total duration. Look at:
+- **Total duration** — which objects consume the most aggregate server time
+- **Avg duration** — which individual calls are slowest
+- **Request count** — high-frequency low-duration items may still matter
+
+### Step 2: Trace the worst offender
+
+```bash
+npx @statechange/xano-cli performance trace endpoint <query-id> --samples 10 --format yaml
+npx @statechange/xano-cli performance trace task <task-id> --samples 10 --format yaml
+npx @statechange/xano-cli performance trace trigger <trigger-id> --samples 10 --format yaml
+```
+
+**Note:** Task history items don't include stack traces (Xano API limitation). Trace will show duration percentiles but no step breakdown for tasks.
+
+The trace output shows:
+- **Duration percentiles** (avg, p50, p95, p99) across samples
+- **Step breakdown** aggregated by `_xsid` — which steps consume the most time across all executions
+- **Functions called** — which custom functions are invoked and how often
+- Steps with high `occurrences` relative to `samples` indicate they run inside loops
+
+### Step 3: Deep-dive a single request
+
+```bash
+npx @statechange/xano-cli performance deep-dive <request-id> --format yaml
+```
+
+This shows:
+- **Recursive stack tree** with direct vs rollup timing at each step
+- **pct_of_total** / **pct_of_parent** — percentage breakdowns
+- **iterations** — how many times loop bodies executed
+- **Warnings** for slow steps inside loops (DB queries, lambdas, external API calls)
+- **functions_called** summary with call counts and total time
+- **stack_truncated: true** means Xano capped the stack — see "Handling truncated stacks" below
+
+### Step 4: X-Ray the hot function
+
+```bash
+npx @statechange/xano-cli xray function --id <function-id> --format yaml
+```
+
+Static analysis of the function's step hierarchy — warnings about nested slow steps, dependencies on other functions.
+
+### Step 5: Read the source
+
+```bash
+npx @statechange/xano-cli xanoscript generate function <function-id>
+```
+
+Generate XanoScript source to understand what the function does and recommend fixes.
+
+## Workflow: "Why do I get errors?"
+
+```bash
+# 1. Find requests with error status codes
+npx @statechange/xano-cli history requests --format yaml
+
+# 2. Deep-dive the error request to see which step failed
+npx @statechange/xano-cli performance deep-dive <error-request-id> --format yaml
+
+# 3. X-Ray the failing function for structural issues
+npx @statechange/xano-cli xray function --id <failing-function-id> --format yaml
+```
+
+## Workflow: "Which functions should I optimize first?"
+
+```bash
+# 1. Get endpoint ranking
+npx @statechange/xano-cli performance top-endpoints --lookback 24 --format yaml
+
+# 2. Trace the top 3-5 endpoints
+npx @statechange/xano-cli performance trace endpoint <id1> --format yaml
+npx @statechange/xano-cli performance trace endpoint <id2> --format yaml
+npx @statechange/xano-cli performance trace endpoint <id3> --format yaml
+
+# 3. Look at functions_called across all traces
+# Rank by: avg_seconds_per_call x total_calls x number_of_callers
+# This gives "optimization ROI" — fixing one function improves many endpoints
+```
+
+## Handling truncated stacks
+
+When `stack_truncated: true` appears in a deep-dive, Xano capped the stack at the endpoint's retention limit. Large `direct_seconds` on a function step with truncation means the real bottleneck is hidden.
+
+```bash
+# 1. Check current retention settings
+npx @statechange/xano-cli logs show endpoint <id>
+
+# 2. Set to unlimited to capture full stacks
+npx @statechange/xano-cli logs set endpoint <id> --limit -1
+
+# 3. Watch for new executions
+npx @statechange/xano-cli logs watch endpoint <id>
+
+# 4. Deep-dive the new (untruncated) execution
+npx @statechange/xano-cli performance deep-dive <new-request-id> --format yaml
+
+# 5. Restore the default limit when done
+npx @statechange/xano-cli logs set endpoint <id> --limit 100
+```
+
+## Interpreting Results
+
+- **High `direct_seconds` with no children** — the step itself is slow (external API call, lambda, complex query)
+- **Low `direct_seconds` but high `rollup_seconds`** — children are slow, drill deeper
+- **Same `_xsid` with high `occurrences`** in trace — step runs inside a loop. Multiply `avg_rollup_seconds` by occurrences/samples to get per-request impact
+- **DB queries inside loops** (warnings) — classic N+1 problem. Move the query outside the loop or use a batch query
+- **Lambda steps with high timing** — interpreted code blocks are slower than native Xano steps
+
+### History retention values
+
+- `limit: 100` (default) — keeps top 100 stack steps, may truncate deep stacks
+- `limit: -1` — unlimited, captures full stack (use for debugging)
+- `limit: 0` — disabled, no history retained
+- `inherit: true` — inherits from the parent API app settings
+- `enabled: false` — history recording is off entirely