@xano/cli 0.0.31 → 0.0.32

package/dist/base-command.d.ts

@@ -10,4 +10,9 @@ export default abstract class BaseCommand extends Command {
     };
     protected getDefaultProfile(): string;
     protected getProfile(): string | undefined;
+    /**
+     * Make an HTTP request with optional verbose logging.
+     * Use this for all Metadata API calls to support the --verbose flag.
+     */
+    protected verboseFetch(url: string, options: RequestInit, verbose: boolean, authToken?: string): Promise<Response>;
 }

package/dist/base-command.js

@@ -7,7 +7,7 @@ export default class BaseCommand extends Command {
     static baseFlags = {
         profile: Flags.string({
             char: 'p',
-            description: 'Profile to use for this command',
+            description: 'Profile to use (uses default profile if not specified)',
             env: 'XANO_PROFILE',
             required: false,
         }),
@@ -44,4 +44,35 @@ export default class BaseCommand extends Command {
     getProfile() {
         return this.flags?.profile;
     }
+    /**
+     * Make an HTTP request with optional verbose logging.
+     * Use this for all Metadata API calls to support the --verbose flag.
+     */
+    async verboseFetch(url, options, verbose, authToken) {
+        const method = options.method || 'GET';
+        const contentType = options.headers?.['Content-Type'] || 'application/json';
+        if (verbose) {
+            this.log('');
+            this.log('─'.repeat(60));
+            this.log(`→ ${method} ${url}`);
+            this.log(`  Content-Type: ${contentType}`);
+            if (authToken) {
+                this.log(`  Authorization: Bearer ${authToken.slice(0, 8)}...${authToken.slice(-4)}`);
+            }
+            if (options.body) {
+                const bodyStr = typeof options.body === 'string' ? options.body : String(options.body);
+                const bodyPreview = bodyStr.length > 500 ? bodyStr.slice(0, 500) + '...' : bodyStr;
+                this.log(`  Body: ${bodyPreview}`);
+            }
+        }
+        const startTime = Date.now();
+        const response = await fetch(url, options);
+        const elapsed = Date.now() - startTime;
+        if (verbose) {
+            this.log(`← ${response.status} ${response.statusText} (${elapsed}ms)`);
+            this.log('─'.repeat(60));
+            this.log('');
+        }
+        return response;
+    }
 }

package/dist/commands/branch/create/index.js

@@ -101,15 +101,15 @@ Created branch: feature-auth
         const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/branch`;
         // Create branch via the API
         try {
-            const response = await fetch(apiUrl, {
+            const response = await this.verboseFetch(apiUrl, {
                 body: JSON.stringify(body),
                 headers: {
                     'accept': 'application/json',
                     'Authorization': `Bearer ${profile.access_token}`,
-                    'content-type': 'application/json',
+                    'Content-Type': 'application/json',
                 },
                 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}`);

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

@@ -90,13 +90,13 @@ Deleted branch: dev
         const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/branch/${encodeURIComponent(branchLabel)}`;
         // Delete branch via the API
         try {
-            const response = await fetch(apiUrl, {
+            const response = await this.verboseFetch(apiUrl, {
                 headers: {
                     'accept': 'application/json',
                     'Authorization': `Bearer ${profile.access_token}`,
                 },
                 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}`);

package/dist/commands/branch/edit/index.js

@@ -104,15 +104,15 @@ Updated branch: feature-authentication
         const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/branch/${encodeURIComponent(branchLabel)}`;
         // Update branch via the API
         try {
-            const response = await fetch(apiUrl, {
+            const response = await this.verboseFetch(apiUrl, {
                 body: JSON.stringify(body),
                 headers: {
                     'accept': 'application/json',
                     'Authorization': `Bearer ${profile.access_token}`,
-                    'content-type': 'application/json',
+                    'Content-Type': 'application/json',
                 },
                 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}`);

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

@@ -75,13 +75,13 @@ Branch: dev
         const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/branch/${encodeURIComponent(branchLabel)}`;
         // Fetch branch from the API
         try {
-            const response = await fetch(apiUrl, {
+            const response = await this.verboseFetch(apiUrl, {
                 headers: {
                     'accept': 'application/json',
                     'Authorization': `Bearer ${profile.access_token}`,
                 },
                 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}`);

package/dist/commands/branch/list/index.js

@@ -74,13 +74,13 @@ Available branches:
         const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/branch`;
         // Fetch branches from the API
         try {
-            const response = await fetch(apiUrl, {
+            const response = await this.verboseFetch(apiUrl, {
                 headers: {
                     'accept': 'application/json',
                     'Authorization': `Bearer ${profile.access_token}`,
                 },
                 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}`);

package/dist/commands/branch/set-live/index.js

@@ -88,13 +88,13 @@ Branch 'v1' is now live
         const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/branch/${encodeURIComponent(branchLabel)}/live`;
         // Set branch as live via the API
         try {
-            const response = await fetch(apiUrl, {
+            const response = await this.verboseFetch(apiUrl, {
                 headers: {
                     'accept': 'application/json',
                     'Authorization': `Bearer ${profile.access_token}`,
                 },
                 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}`);

package/dist/commands/function/create/index.js

@@ -153,7 +153,7 @@ Name: my_function
         const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/function?${queryParams.toString()}`;
         // Create function via API
         try {
-            const response = await fetch(apiUrl, {
+            const response = await this.verboseFetch(apiUrl, {
                 body: xanoscript,
                 headers: {
                     'accept': 'application/json',
@@ -161,7 +161,7 @@ Name: my_function
                     'Content-Type': 'text/x-xanoscript',
                 },
                 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}`);

package/dist/commands/function/edit/index.js

@@ -196,7 +196,7 @@ Name: my_function
         const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/function/${functionId}?${queryParams.toString()}`;
         // Update function via API
         try {
-            const response = await fetch(apiUrl, {
+            const response = await this.verboseFetch(apiUrl, {
                 body: xanoscript,
                 headers: {
                     'accept': 'application/json',
@@ -204,7 +204,7 @@ Name: my_function
                     'Content-Type': 'text/x-xanoscript',
                 },
                 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}`);

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

@@ -122,13 +122,13 @@ function yo {
         const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/function/${functionId}?${queryParams.toString()}`;
         // Fetch function from the API
         try {
-            const response = await fetch(apiUrl, {
+            const response = await this.verboseFetch(apiUrl, {
                 headers: {
                     'accept': 'application/json',
                     'Authorization': `Bearer ${profile.access_token}`,
                 },
                 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}`);

package/dist/commands/function/list/index.js

@@ -127,13 +127,13 @@ Available functions:
         const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/function?${queryParams.toString()}`;
         // Fetch functions from the API
         try {
-            const response = await fetch(apiUrl, {
+            const response = await this.verboseFetch(apiUrl, {
                 headers: {
                     'accept': 'application/json',
                     'Authorization': `Bearer ${profile.access_token}`,
                 },
                 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}`);

package/dist/commands/platform/get/index.d.ts

@@ -0,0 +1,18 @@
+import BaseCommand from '../../../base-command.js';
+export default class PlatformGet extends BaseCommand {
+    static args: {
+        platform_id: import("@oclif/core/interfaces").Arg<number, {
+            max?: number;
+            min?: number;
+        }>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private loadCredentials;
+}

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

@@ -0,0 +1,126 @@
+import { Args, Flags } from '@oclif/core';
+import * as yaml from 'js-yaml';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import BaseCommand from '../../../base-command.js';
+export default class PlatformGet extends BaseCommand {
+    static args = {
+        platform_id: Args.integer({
+            description: 'Platform ID to retrieve',
+            required: true,
+        }),
+    };
+    static description = 'Get details of a specific platform';
+    static examples = [
+        `$ xano platform get 23629
+Platform ID: 23629
+  Created: 2025-11-28
+  Helm: 0.1.356
+  Images:
+    backend          0.0.2985
+    frontend         0.1.3427
+    database         0.1.6
+    node             0.1.192
+    deno             0.0.212
+    redis            0.1.34
+    realtime         0.1.149
+    standalone       0.0.2456
+    playwright       0.0.992
+    static           0.0.10
+    static-build     0.0.4
+    backend-encoded  0.0.1396
+`,
+        `$ xano platform get 23629 -o json`,
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        output: Flags.string({
+            char: 'o',
+            default: 'summary',
+            description: 'Output format',
+            options: ['summary', 'json'],
+            required: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(PlatformGet);
+        const profileName = flags.profile || this.getDefaultProfile();
+        const credentials = this.loadCredentials();
+        if (!(profileName in credentials.profiles)) {
+            this.error(`Profile '${profileName}' not found. Available profiles: ${Object.keys(credentials.profiles).join(', ')}\n` +
+                `Create a profile using 'xano profile create'`);
+        }
+        const profile = credentials.profiles[profileName];
+        if (!profile.instance_origin) {
+            this.error(`Profile '${profileName}' is missing instance_origin`);
+        }
+        if (!profile.access_token) {
+            this.error(`Profile '${profileName}' is missing access_token`);
+        }
+        const platformId = args.platform_id;
+        const apiUrl = `${profile.instance_origin}/api:meta/platform/${platformId}`;
+        try {
+            const response = await this.verboseFetch(apiUrl, {
+                headers: {
+                    'accept': 'application/json',
+                    'Authorization': `Bearer ${profile.access_token}`,
+                },
+                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 platform = await response.json();
+            if (flags.output === 'json') {
+                this.log(JSON.stringify(platform, null, 2));
+            }
+            else {
+                const label = platform.name ? `Platform: ${platform.name} (ID: ${platform.id})` : `Platform ID: ${platform.id}`;
+                this.log(label);
+                if (platform.created_at) {
+                    const createdDate = new Date(platform.created_at).toISOString().split('T')[0];
+                    this.log(`  Created: ${createdDate}`);
+                }
+                if (platform.helm?.tag) {
+                    this.log(`  Helm: ${platform.helm.tag}`);
+                }
+                if (platform.images && Object.keys(platform.images).length > 0) {
+                    this.log('  Images:');
+                    const maxLen = Math.max(...Object.keys(platform.images).map(k => k.length));
+                    for (const [name, image] of Object.entries(platform.images)) {
+                        this.log(`    ${name.padEnd(maxLen)}  ${image.tag ?? 'unknown'}`);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.error(`Failed to get platform: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to get platform: ${String(error)}`);
+            }
+        }
+    }
+    loadCredentials() {
+        const configDir = path.join(os.homedir(), '.xano');
+        const credentialsPath = path.join(configDir, 'credentials.yaml');
+        if (!fs.existsSync(credentialsPath)) {
+            this.error(`Credentials file not found at ${credentialsPath}\n` +
+                `Create a profile using 'xano profile create'`);
+        }
+        try {
+            const fileContent = fs.readFileSync(credentialsPath, 'utf8');
+            const parsed = yaml.load(fileContent);
+            if (!parsed || typeof parsed !== 'object' || !('profiles' in parsed)) {
+                this.error('Credentials file has invalid format.');
+            }
+            return parsed;
+        }
+        catch (error) {
+            this.error(`Failed to parse credentials file: ${error}`);
+        }
+    }
+}

package/dist/commands/platform/list/index.d.ts

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

package/dist/commands/platform/list/index.js

@@ -0,0 +1,113 @@
+import { Flags } from '@oclif/core';
+import * as yaml from 'js-yaml';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import BaseCommand from '../../../base-command.js';
+export default class PlatformList extends BaseCommand {
+    static description = 'List all platforms';
+    static examples = [
+        `$ xano platform list
+Platforms:
+  ID: 23629 | Helm: 0.1.356 | Created: 2025-11-28
+`,
+        `$ xano platform list --output json`,
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        output: Flags.string({
+            char: 'o',
+            default: 'summary',
+            description: 'Output format',
+            options: ['summary', 'json'],
+            required: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(PlatformList);
+        const profileName = flags.profile || this.getDefaultProfile();
+        const credentials = this.loadCredentials();
+        if (!(profileName in credentials.profiles)) {
+            this.error(`Profile '${profileName}' not found. Available profiles: ${Object.keys(credentials.profiles).join(', ')}\n` +
+                `Create a profile using 'xano profile create'`);
+        }
+        const profile = credentials.profiles[profileName];
+        if (!profile.instance_origin) {
+            this.error(`Profile '${profileName}' is missing instance_origin`);
+        }
+        if (!profile.access_token) {
+            this.error(`Profile '${profileName}' is missing access_token`);
+        }
+        const apiUrl = `${profile.instance_origin}/api:meta/platform`;
+        try {
+            const response = await this.verboseFetch(apiUrl, {
+                headers: {
+                    'accept': 'application/json',
+                    'Authorization': `Bearer ${profile.access_token}`,
+                },
+                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 data = await response.json();
+            let platforms;
+            if (Array.isArray(data)) {
+                platforms = data;
+            }
+            else if (data && typeof data === 'object' && 'items' in data && Array.isArray(data.items)) {
+                platforms = data.items;
+            }
+            else {
+                this.error('Unexpected API response format');
+            }
+            if (flags.output === 'json') {
+                this.log(JSON.stringify(platforms, null, 2));
+            }
+            else {
+                if (platforms.length === 0) {
+                    this.log('No platforms found');
+                }
+                else {
+                    this.log('Platforms:');
+                    for (const platform of platforms) {
+                        const label = platform.name || `ID: ${platform.id}`;
+                        const helmTag = platform.helm?.tag ? ` | Helm: ${platform.helm.tag}` : '';
+                        const created = platform.created_at
+                            ? ` | Created: ${new Date(platform.created_at).toISOString().split('T')[0]}`
+                            : '';
+                        this.log(`  ${label}${helmTag}${created}`);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.error(`Failed to list platforms: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to list platforms: ${String(error)}`);
+            }
+        }
+    }
+    loadCredentials() {
+        const configDir = path.join(os.homedir(), '.xano');
+        const credentialsPath = path.join(configDir, 'credentials.yaml');
+        if (!fs.existsSync(credentialsPath)) {
+            this.error(`Credentials file not found at ${credentialsPath}\n` +
+                `Create a profile using 'xano profile create'`);
+        }
+        try {
+            const fileContent = fs.readFileSync(credentialsPath, 'utf8');
+            const parsed = yaml.load(fileContent);
+            if (!parsed || typeof parsed !== 'object' || !('profiles' in parsed)) {
+                this.error('Credentials file has invalid format.');
+            }
+            return parsed;
+        }
+        catch (error) {
+            this.error(`Failed to parse credentials file: ${error}`);
+        }
+    }
+}

package/dist/commands/profile/me/index.js

@@ -60,13 +60,13 @@ User Information:
         const apiUrl = `${profile.instance_origin}/api:meta/auth/me`;
         // Fetch user info from the API
         try {
-            const response = await fetch(apiUrl, {
+            const response = await this.verboseFetch(apiUrl, {
                 headers: {
                     'accept': 'application/json',
                     'Authorization': `Bearer ${profile.access_token}`,
                 },
                 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}`);

package/dist/commands/release/create/index.d.ts

@@ -0,0 +1,18 @@
+import BaseCommand from '../../../base-command.js';
+export default class ReleaseCreate extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        branch: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        hotfix: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'table-ids': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private loadCredentials;
+}