@xano/cli 0.0.95-beta.10 → 0.0.95-beta.12

package/dist/base-command.d.ts

@@ -63,6 +63,11 @@ export default abstract class BaseCommand extends Command {
         profile: ProfileConfig;
         profileName: string;
     };
+    /**
+     * Parse an API error response and return a clean error message.
+     * Extracts the message from JSON responses and adds context for common errors.
+     */
+    protected parseApiError(response: Response, fallbackPrefix: string): Promise<string>;
     /**
      * Make an HTTP request with optional verbose logging.
      * Use this for all Metadata API calls to support the --verbose flag.

package/dist/base-command.js

@@ -117,8 +117,8 @@ export default class BaseCommand extends Command {
             method: 'GET',
         }, verbose, profile.access_token);
         if (!response.ok) {
-            const errorText = await response.text();
-            this.error(`Failed to get sandbox environment: ${response.status} ${response.statusText}\n${errorText}`);
+            const message = await this.parseApiError(response, 'Failed to get sandbox environment');
+            this.error(message);
         }
         return (await response.json());
     }
@@ -140,6 +140,30 @@ export default class BaseCommand extends Command {
         }
         return { profile, profileName };
     }
+    /**
+     * Parse an API error response and return a clean error message.
+     * Extracts the message from JSON responses and adds context for common errors.
+     */
+    async parseApiError(response, fallbackPrefix) {
+        const errorText = await response.text();
+        let message = `${fallbackPrefix} (${response.status})`;
+        try {
+            const errorJson = JSON.parse(errorText);
+            if (errorJson.message) {
+                message = errorJson.message;
+            }
+        }
+        catch {
+            if (errorText) {
+                message += `\n${errorText}`;
+            }
+        }
+        // Provide guidance when sandbox access is denied (free plan restriction)
+        if (response.status === 500 && message === 'Access Denied.') {
+            message = 'Sandbox is not available on the Free plan. Upgrade your plan to use sandbox features.';
+        }
+        return message;
+    }
     /**
      * Make an HTTP request with optional verbose logging.
      * Use this for all Metadata API calls to support the --verbose flag.

package/dist/commands/sandbox/delete/index.d.ts

@@ -0,0 +1,12 @@
+import BaseCommand from '../../../base-command.js';
+export default class SandboxDelete extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private confirm;
+}

package/dist/commands/sandbox/delete/index.js

@@ -0,0 +1,71 @@
+import { Flags } from '@oclif/core';
+import BaseCommand from '../../../base-command.js';
+export default class SandboxDelete extends BaseCommand {
+    static description = 'Delete your sandbox environment completely (debugging only — it will be re-created on next access)';
+    static examples = [
+        `$ xano sandbox delete
+Are you sure you want to DELETE your sandbox environment? This destroys all data. (y/N) y
+Sandbox environment deleted.
+`,
+        `$ xano sandbox delete --force`,
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        force: Flags.boolean({
+            char: 'f',
+            default: false,
+            description: 'Skip confirmation prompt',
+            required: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SandboxDelete);
+        const { profile } = this.resolveProfile(flags);
+        if (!flags.force) {
+            const confirmed = await this.confirm(`Are you sure you want to DELETE your sandbox environment? This destroys all data and the tenant will be re-created on next access.`);
+            if (!confirmed) {
+                this.log('Delete cancelled.');
+                return;
+            }
+        }
+        const apiUrl = `${profile.instance_origin}/api:meta/sandbox/me`;
+        try {
+            const response = await this.verboseFetch(apiUrl, {
+                headers: {
+                    accept: 'application/json',
+                    Authorization: `Bearer ${profile.access_token}`,
+                    'Content-Type': 'application/json',
+                },
+                method: 'DELETE',
+            }, flags.verbose, profile.access_token);
+            if (!response.ok) {
+                const message = await this.parseApiError(response, 'Failed to delete sandbox environment');
+                this.error(message);
+            }
+            this.log('Sandbox environment deleted.');
+        }
+        catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
+            if (error instanceof Error) {
+                this.error(`Failed to delete sandbox environment: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to delete sandbox environment: ${String(error)}`);
+            }
+        }
+    }
+    async confirm(message) {
+        const readline = await import('node:readline');
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        return new Promise((resolve) => {
+            rl.question(`${message} (y/N) `, (answer) => {
+                rl.close();
+                resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+            });
+        });
+    }
+}

package/dist/commands/sandbox/env/delete/index.js

@@ -52,8 +52,8 @@ Environment variable 'DATABASE_URL' deleted
                 method: 'DELETE',
             }, flags.verbose, profile.access_token);
             if (!response.ok) {
-                const errorText = await response.text();
-                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+                const message = await this.parseApiError(response, 'API request failed');
+                this.error(message);
             }
             if (flags.output === 'json') {
                 this.log(JSON.stringify({ deleted: true, env_name: envName }, null, 2));
@@ -63,6 +63,8 @@ Environment variable 'DATABASE_URL' deleted
             }
         }
         catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
             if (error instanceof Error) {
                 this.error(`Failed to delete sandbox environment variable: ${error.message}`);
             }

package/dist/commands/sandbox/env/get/index.js

@@ -37,8 +37,8 @@ postgres://localhost:5432/mydb
                 method: 'GET',
             }, flags.verbose, profile.access_token);
             if (!response.ok) {
-                const errorText = await response.text();
-                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+                const message = await this.parseApiError(response, 'API request failed');
+                this.error(message);
             }
             const envVar = (await response.json());
             if (flags.output === 'json') {
@@ -52,6 +52,8 @@ postgres://localhost:5432/mydb
             }
         }
         catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
             if (error instanceof Error) {
                 this.error(`Failed to get sandbox environment variable: ${error.message}`);
             }

package/dist/commands/sandbox/env/get_all/index.js

@@ -46,8 +46,8 @@ Environment variables saved to env_<tenant>.yaml
                 method: 'GET',
             }, flags.verbose, profile.access_token);
             if (!response.ok) {
-                const errorText = await response.text();
-                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+                const message = await this.parseApiError(response, 'API request failed');
+                this.error(message);
             }
             const envMap = (await response.json());
             if (flags.output === 'json') {
@@ -65,6 +65,8 @@ Environment variables saved to env_<tenant>.yaml
             }
         }
         catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
             if (error instanceof Error) {
                 this.error(`Failed to get sandbox environment variables: ${error.message}`);
             }

package/dist/commands/sandbox/env/list/index.js

@@ -33,8 +33,8 @@ Environment variables for sandbox environment:
                 method: 'GET',
             }, flags.verbose, profile.access_token);
             if (!response.ok) {
-                const errorText = await response.text();
-                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+                const message = await this.parseApiError(response, 'API request failed');
+                this.error(message);
             }
             const data = (await response.json());
             if (flags.output === 'json') {
@@ -54,6 +54,8 @@ Environment variables for sandbox environment:
             }
         }
         catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
             if (error instanceof Error) {
                 this.error(`Failed to list sandbox environment variables: ${error.message}`);
             }

package/dist/commands/sandbox/env/set/index.js

@@ -49,8 +49,8 @@ Environment variable 'DATABASE_URL' set
                 method: 'PATCH',
             }, flags.verbose, profile.access_token);
             if (!response.ok) {
-                const errorText = await response.text();
-                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+                const message = await this.parseApiError(response, 'API request failed');
+                this.error(message);
             }
             if (flags.output === 'json') {
                 const result = await response.json();
@@ -61,6 +61,8 @@ Environment variable 'DATABASE_URL' set
             }
         }
         catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
             if (error instanceof Error) {
                 this.error(`Failed to set sandbox environment variable: ${error.message}`);
             }

package/dist/commands/sandbox/env/set_all/index.js

@@ -57,8 +57,8 @@ Reads from env_<tenant>.yaml
                 method: 'PUT',
             }, flags.verbose, profile.access_token);
             if (!response.ok) {
-                const errorText = await response.text();
-                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+                const message = await this.parseApiError(response, 'API request failed');
+                this.error(message);
             }
             if (flags.output === 'json') {
                 const result = await response.json();
@@ -73,6 +73,8 @@ Reads from env_<tenant>.yaml
             }
         }
         catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
             if (error instanceof Error) {
                 this.error(`Failed to set sandbox environment variables: ${error.message}`);
             }

package/dist/commands/sandbox/get/index.js

@@ -50,6 +50,8 @@ Sandbox Environment: (tc24-abcd-x1y2)
             }
         }
         catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
             if (error instanceof Error) {
                 this.error(`Failed to get sandbox environment: ${error.message}`);
             }

package/dist/commands/sandbox/license/get/index.js

@@ -45,8 +45,8 @@ License saved to license_<tenant>.yaml
                 method: 'GET',
             }, flags.verbose, profile.access_token);
             if (!response.ok) {
-                const errorText = await response.text();
-                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+                const message = await this.parseApiError(response, 'API request failed');
+                this.error(message);
             }
             const license = await response.json();
             const licenseContent = typeof license === 'string' ? license : JSON.stringify(license, null, 2);
@@ -65,6 +65,8 @@ License saved to license_<tenant>.yaml
             }
         }
         catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
             if (error instanceof Error) {
                 this.error(`Failed to get sandbox environment license: ${error.message}`);
             }

package/dist/commands/sandbox/license/set/index.js

@@ -66,8 +66,8 @@ Reads from license_<tenant>.yaml
                 method: 'POST',
             }, flags.verbose, profile.access_token);
             if (!response.ok) {
-                const errorText = await response.text();
-                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+                const message = await this.parseApiError(response, 'API request failed');
+                this.error(message);
             }
             const result = await response.json();
             if (flags.output === 'json') {
@@ -82,6 +82,8 @@ Reads from license_<tenant>.yaml
             }
         }
         catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
             if (error instanceof Error) {
                 this.error(`Failed to set sandbox environment license: ${error.message}`);
             }

package/dist/commands/sandbox/pull/index.js

@@ -55,12 +55,14 @@ Pulled 42 documents from sandbox environment to ./my-sandbox
                 method: 'GET',
             }, flags.verbose, profile.access_token);
             if (!response.ok) {
-                const errorText = await response.text();
-                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+                const message = await this.parseApiError(response, 'API request failed');
+                this.error(message);
             }
             responseText = await response.text();
         }
         catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
             if (error instanceof Error) {
                 this.error(`Failed to fetch multidoc: ${error.message}`);
             }

package/dist/commands/sandbox/push/index.d.ts

@@ -15,4 +15,5 @@ export default class SandboxPush extends BaseCommand {
     };
     run(): Promise<void>;
     private collectFiles;
+    private renderBadReferences;
 }

package/dist/commands/sandbox/push/index.js

@@ -1,8 +1,9 @@
-import { Args, Flags } from '@oclif/core';
-import BaseCommand from '../../../base-command.js';
-import { findFilesWithGuid } from '../../../utils/document-parser.js';
+import { Args, Flags, ux } from '@oclif/core';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
+import BaseCommand from '../../../base-command.js';
+import { findFilesWithGuid } from '../../../utils/document-parser.js';
+import { checkReferences } from '../../../utils/reference-checker.js';
 export default class SandboxPush extends BaseCommand {
     static args = {
         directory: Args.string({
@@ -66,6 +67,11 @@ Pushed 42 documents to sandbox environment from ./my-workspace
         if (documentEntries.length === 0) {
             this.error(`All .xs files in ${args.directory} are empty`);
         }
+        // Check for bad cross-references within the local file set
+        const badRefs = checkReferences(documentEntries);
+        if (badRefs.length > 0) {
+            this.renderBadReferences(badRefs);
+        }
         const multidoc = documentEntries.map((d) => d.content).join('\n---\n');
         const queryParams = new URLSearchParams({
             env: flags.env.toString(),
@@ -98,6 +104,10 @@ Pushed 42 documents to sandbox environment from ./my-workspace
                 catch {
                     errorMessage += `\n${errorText}`;
                 }
+                // Provide guidance when sandbox access is denied (free plan restriction)
+                if (response.status === 500 && errorMessage.includes('Access Denied')) {
+                    this.error('Sandbox is not available on the Free plan. Upgrade your plan to use sandbox features.');
+                }
                 const guidMatch = errorMessage.match(/Duplicate \w+ guid: (\S+)/);
                 if (guidMatch) {
                     const dupeFiles = findFilesWithGuid(documentEntries, guidMatch[1]);
@@ -114,6 +124,8 @@ Pushed 42 documents to sandbox environment from ./my-workspace
             }
         }
         catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
             if (error instanceof Error) {
                 this.error(`Failed to push multidoc: ${error.message}`);
             }
@@ -138,4 +150,17 @@ Pushed 42 documents to sandbox environment from ./my-workspace
         }
         return files.sort();
     }
+    renderBadReferences(badRefs) {
+        this.log('');
+        this.log(ux.colorize('yellow', ux.colorize('bold', '=== Unresolved References ===')));
+        this.log('');
+        this.log(ux.colorize('yellow', "The following references point to objects that don't exist in this push or on the server."));
+        this.log(ux.colorize('yellow', 'These will become placeholder statements after import.'));
+        this.log('');
+        for (const ref of badRefs) {
+            this.log(`  ${ux.colorize('yellow', 'WARNING'.padEnd(16))} ${ref.sourceType.padEnd(18)} ${ref.source}`);
+            this.log(`  ${' '.repeat(16)} ${' '.repeat(18)} ${ux.colorize('dim', `${ref.statementType} → ${ref.targetType} "${ref.target}" does not exist`)}`);
+        }
+        this.log('');
+    }
 }

package/dist/commands/sandbox/reset/index.js

@@ -39,12 +39,14 @@ Sandbox environment has been reset.
                 method: 'POST',
             }, flags.verbose, profile.access_token);
             if (!response.ok) {
-                const errorText = await response.text();
-                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+                const message = await this.parseApiError(response, 'API request failed');
+                this.error(message);
             }
             this.log('Sandbox environment has been reset.');
         }
         catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
             if (error instanceof Error) {
                 this.error(`Failed to reset sandbox environment: ${error.message}`);
             }

package/dist/commands/sandbox/review/index.js

@@ -40,8 +40,8 @@ Review session started!
                 method: 'GET',
             }, flags.verbose, profile.access_token);
             if (!response.ok) {
-                const errorText = await response.text();
-                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+                const message = await this.parseApiError(response, 'API request failed');
+                this.error(message);
             }
             const result = (await response.json());
             if (!result._ti) {
@@ -68,6 +68,8 @@ Review session started!
             process.exit(0);
         }
         catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
             if (error instanceof Error) {
                 this.error(`Failed to open sandbox review: ${error.message}`);
             }

package/dist/commands/sandbox/unit_test/list/index.js

@@ -48,8 +48,8 @@ Unit tests:
                 method: 'GET',
             }, flags.verbose, profile.access_token);
             if (!response.ok) {
-                const errorText = await response.text();
-                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+                const message = await this.parseApiError(response, 'API request failed');
+                this.error(message);
             }
             const data = (await response.json());
             let tests;
@@ -78,6 +78,8 @@ Unit tests:
             }
         }
         catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
             if (error instanceof Error) {
                 this.error(`Failed to list unit tests: ${error.message}`);
             }

package/dist/commands/sandbox/unit_test/run/index.js

@@ -42,8 +42,8 @@ Result: PASS
                 method: 'POST',
             }, flags.verbose, profile.access_token);
             if (!response.ok) {
-                const errorText = await response.text();
-                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+                const message = await this.parseApiError(response, 'API request failed');
+                this.error(message);
             }
             const result = (await response.json());
             if (flags.output === 'json') {
@@ -66,6 +66,8 @@ Result: PASS
             }
         }
         catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
             if (error instanceof Error) {
                 this.error(`Failed to run unit test: ${error.message}`);
             }

package/dist/commands/sandbox/unit_test/run_all/index.js

@@ -128,6 +128,8 @@ Results: 4 passed, 1 failed
                     }
                 }
                 catch (error) {
+                    if (error instanceof Error && 'oclif' in error)
+                        throw error;
                     const message = error instanceof Error ? error.message : String(error);
                     results.push({
                         message,
@@ -156,6 +158,8 @@ Results: 4 passed, 1 failed
             }
         }
         catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
             if (error instanceof Error) {
                 this.error(`Failed to run unit tests: ${error.message}`);
             }

package/dist/commands/sandbox/workflow_test/delete/index.js

@@ -37,8 +37,8 @@ Deleted workflow test 42
                 method: 'DELETE',
             }, flags.verbose, profile.access_token);
             if (!response.ok) {
-                const errorText = await response.text();
-                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+                const message = await this.parseApiError(response, 'API request failed');
+                this.error(message);
             }
             if (flags.output === 'json') {
                 this.log(JSON.stringify({ deleted: true, workflow_test_id: args.workflow_test_id }, null, 2));
@@ -48,6 +48,8 @@ Deleted workflow test 42
             }
         }
         catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
             if (error instanceof Error) {
                 this.error(`Failed to delete workflow test: ${error.message}`);
             }

package/dist/commands/sandbox/workflow_test/get/index.js

@@ -32,8 +32,8 @@ export default class SandboxWorkflowTestGet extends BaseCommand {
                 method: 'GET',
             }, flags.verbose, profile.access_token);
             if (!response.ok) {
-                const errorText = await response.text();
-                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+                const message = await this.parseApiError(response, 'API request failed');
+                this.error(message);
             }
             const test = await response.json();
             if (flags.output === 'json') {
@@ -47,6 +47,8 @@ export default class SandboxWorkflowTestGet extends BaseCommand {
             }
         }
         catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
             if (error instanceof Error) {
                 this.error(`Failed to get workflow test: ${error.message}`);
             }

package/dist/commands/sandbox/workflow_test/list/index.js

@@ -41,8 +41,8 @@ Workflow tests:
                 method: 'GET',
             }, flags.verbose, profile.access_token);
             if (!response.ok) {
-                const errorText = await response.text();
-                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+                const message = await this.parseApiError(response, 'API request failed');
+                this.error(message);
             }
             const data = (await response.json());
             let tests;
@@ -71,6 +71,8 @@ Workflow tests:
             }
         }
         catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
             if (error instanceof Error) {
                 this.error(`Failed to list workflow tests: ${error.message}`);
             }

package/dist/commands/sandbox/workflow_test/run/index.js

@@ -42,8 +42,8 @@ Result: PASS (0.25s)
                 method: 'POST',
             }, flags.verbose, profile.access_token);
             if (!response.ok) {
-                const errorText = await response.text();
-                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+                const message = await this.parseApiError(response, 'API request failed');
+                this.error(message);
             }
             const result = (await response.json());
             if (flags.output === 'json') {
@@ -64,6 +64,8 @@ Result: PASS (0.25s)
             }
         }
         catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
             if (error instanceof Error) {
                 this.error(`Failed to run workflow test: ${error.message}`);
             }

package/dist/commands/sandbox/workflow_test/run_all/index.js

@@ -116,6 +116,8 @@ Results: 2 passed, 1 failed
                     }
                 }
                 catch (error) {
+                    if (error instanceof Error && 'oclif' in error)
+                        throw error;
                     const message = error instanceof Error ? error.message : String(error);
                     results.push({
                         message,
@@ -142,6 +144,8 @@ Results: 2 passed, 1 failed
             }
         }
         catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
             if (error instanceof Error) {
                 this.error(`Failed to run workflow tests: ${error.message}`);
             }

package/dist/commands/workspace/push/index.d.ts

@@ -30,5 +30,6 @@ export default class Push extends BaseCommand {
      * type subdirectory name then filename for deterministic ordering.
      */
     private collectFiles;
+    private renderBadReferences;
     private loadCredentials;
 }