@xano/cli 0.0.20 → 0.0.22

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

@@ -0,0 +1,135 @@
+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 BranchGet extends BaseCommand {
+    static args = {
+        branch_label: Args.string({
+            description: 'Branch label (e.g., "v1", "dev")',
+            required: true,
+        }),
+    };
+    static description = 'Get details for a specific branch';
+    static examples = [
+        `$ xano branch get v1
+Branch: v1 (live)
+  Created: 2024-01-15
+`,
+        `$ xano branch get dev -w 123
+Branch: dev
+  Created: 2024-02-01
+`,
+        `$ xano branch get staging --output json
+{
+  "created_at": "2024-02-10T09:15:00Z",
+  "label": "staging",
+  "backup": false,
+  "live": false
+}
+`,
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        output: Flags.string({
+            char: 'o',
+            default: 'summary',
+            description: 'Output format',
+            options: ['summary', 'json'],
+            required: false,
+        }),
+        workspace: Flags.integer({
+            char: 'w',
+            description: 'Workspace ID (uses profile workspace if not provided)',
+            required: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(BranchGet);
+        // Get profile name (default or from flag/env)
+        const profileName = flags.profile || this.getDefaultProfile();
+        // Load credentials
+        const credentials = this.loadCredentials();
+        // Get the profile configuration
+        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];
+        // Validate required fields
+        if (!profile.instance_origin) {
+            this.error(`Profile '${profileName}' is missing instance_origin`);
+        }
+        if (!profile.access_token) {
+            this.error(`Profile '${profileName}' is missing access_token`);
+        }
+        // Get workspace ID from flag or profile
+        const workspaceId = flags.workspace || profile.workspace;
+        if (!workspaceId) {
+            this.error('No workspace ID provided. Either use --workspace flag or set one in your profile.\n' +
+                'Usage: xano branch get <branch_label> --workspace <workspace_id>');
+        }
+        const branchLabel = args.branch_label;
+        // Construct the API URL
+        const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/branch/${encodeURIComponent(branchLabel)}`;
+        // Fetch branch from the API
+        try {
+            const response = await fetch(apiUrl, {
+                headers: {
+                    'accept': 'application/json',
+                    'Authorization': `Bearer ${profile.access_token}`,
+                },
+                method: 'GET',
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+            }
+            const branch = await response.json();
+            // Output results
+            if (flags.output === 'json') {
+                this.log(JSON.stringify(branch, null, 2));
+            }
+            else {
+                // summary format
+                const liveIndicator = branch.live ? ' (live)' : '';
+                const backupIndicator = branch.backup ? ' (backup)' : '';
+                this.log(`Branch: ${branch.label}${liveIndicator}${backupIndicator}`);
+                if (branch.created_at) {
+                    const createdDate = branch.created_at.split('T')[0];
+                    this.log(`  Created: ${createdDate}`);
+                }
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.error(`Failed to fetch branch: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to fetch branch: ${String(error)}`);
+            }
+        }
+    }
+    loadCredentials() {
+        const configDir = path.join(os.homedir(), '.xano');
+        const credentialsPath = path.join(configDir, 'credentials.yaml');
+        // Check if credentials file exists
+        if (!fs.existsSync(credentialsPath)) {
+            this.error(`Credentials file not found at ${credentialsPath}\n` +
+                `Create a profile using 'xano profile create'`);
+        }
+        // Read credentials file
+        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/branch/list/index.d.ts

@@ -0,0 +1,18 @@
+import BaseCommand from '../../../base-command.js';
+export default class BranchList extends BaseCommand {
+    static args: {
+        workspace_id: import("@oclif/core/interfaces").Arg<number | undefined, {
+            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/branch/list/index.js

@@ -0,0 +1,138 @@
+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 BranchList extends BaseCommand {
+    static args = {
+        workspace_id: Args.integer({
+            description: 'Workspace ID (uses profile workspace if not provided)',
+            required: false,
+        }),
+    };
+    static description = 'List all branches in a workspace';
+    static examples = [
+        `$ xano branch list
+Available branches:
+  - v1 (live)
+  - dev
+  - staging
+`,
+        `$ xano branch list 123
+Available branches:
+  - v1 (live)
+  - feature-auth
+`,
+        `$ xano branch list --output json
+[
+  {
+    "created_at": "2024-01-15T10:30:00Z",
+    "label": "v1",
+    "backup": false,
+    "live": true
+  }
+]
+`,
+    ];
+    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(BranchList);
+        // Get profile name (default or from flag/env)
+        const profileName = flags.profile || this.getDefaultProfile();
+        // Load credentials
+        const credentials = this.loadCredentials();
+        // Get the profile configuration
+        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];
+        // Validate required fields
+        if (!profile.instance_origin) {
+            this.error(`Profile '${profileName}' is missing instance_origin`);
+        }
+        if (!profile.access_token) {
+            this.error(`Profile '${profileName}' is missing access_token`);
+        }
+        // Get workspace ID from args or profile
+        const workspaceId = args.workspace_id || profile.workspace;
+        if (!workspaceId) {
+            this.error('No workspace ID provided. Either pass a workspace ID as an argument or set one in your profile.\n' +
+                'Usage: xano branch list [workspace_id]');
+        }
+        // Construct the API URL
+        const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/branch`;
+        // Fetch branches from the API
+        try {
+            const response = await fetch(apiUrl, {
+                headers: {
+                    'accept': 'application/json',
+                    'Authorization': `Bearer ${profile.access_token}`,
+                },
+                method: 'GET',
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+            }
+            const branches = await response.json();
+            // Output results
+            if (flags.output === 'json') {
+                this.log(JSON.stringify(branches, null, 2));
+            }
+            else {
+                // summary format
+                if (branches.length === 0) {
+                    this.log('No branches found');
+                }
+                else {
+                    this.log('Available branches:');
+                    for (const branch of branches) {
+                        const liveIndicator = branch.live ? ' (live)' : '';
+                        const backupIndicator = branch.backup ? ' (backup)' : '';
+                        this.log(`  - ${branch.label}${liveIndicator}${backupIndicator}`);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.error(`Failed to fetch branches: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to fetch branches: ${String(error)}`);
+            }
+        }
+    }
+    loadCredentials() {
+        const configDir = path.join(os.homedir(), '.xano');
+        const credentialsPath = path.join(configDir, 'credentials.yaml');
+        // Check if credentials file exists
+        if (!fs.existsSync(credentialsPath)) {
+            this.error(`Credentials file not found at ${credentialsPath}\n` +
+                `Create a profile using 'xano profile create'`);
+        }
+        // Read credentials file
+        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/branch/set-live/index.d.ts

@@ -0,0 +1,18 @@
+import BaseCommand from '../../../base-command.js';
+export default class BranchSetLive extends BaseCommand {
+    static args: {
+        branch_label: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        workspace: import("@oclif/core/interfaces").OptionFlag<number | 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 confirm;
+    private loadCredentials;
+}

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

@@ -0,0 +1,155 @@
+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 BranchSetLive extends BaseCommand {
+    static args = {
+        branch_label: Args.string({
+            description: 'Branch label to set as live (use "v1" for default branch)',
+            required: true,
+        }),
+    };
+    static description = 'Set a branch as the live (active) branch for API requests';
+    static examples = [
+        `$ xano branch set-live staging
+Are you sure you want to set 'staging' as the live branch? (y/N) y
+Branch 'staging' is now live
+`,
+        `$ xano branch set-live v1 --force
+Branch 'v1' is now live
+`,
+        `$ xano branch set-live production -f -o json
+{
+  "created_at": "2024-02-10T09:15:00Z",
+  "label": "production",
+  "backup": false,
+  "live": true
+}
+`,
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        force: Flags.boolean({
+            char: 'f',
+            default: false,
+            description: 'Skip confirmation prompt',
+            required: false,
+        }),
+        output: Flags.string({
+            char: 'o',
+            default: 'summary',
+            description: 'Output format',
+            options: ['summary', 'json'],
+            required: false,
+        }),
+        workspace: Flags.integer({
+            char: 'w',
+            description: 'Workspace ID (uses profile workspace if not provided)',
+            required: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(BranchSetLive);
+        // Get profile name (default or from flag/env)
+        const profileName = flags.profile || this.getDefaultProfile();
+        // Load credentials
+        const credentials = this.loadCredentials();
+        // Get the profile configuration
+        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];
+        // Validate required fields
+        if (!profile.instance_origin) {
+            this.error(`Profile '${profileName}' is missing instance_origin`);
+        }
+        if (!profile.access_token) {
+            this.error(`Profile '${profileName}' is missing access_token`);
+        }
+        // Get workspace ID from flag or profile
+        const workspaceId = flags.workspace || profile.workspace;
+        if (!workspaceId) {
+            this.error('No workspace ID provided. Either use --workspace flag or set one in your profile.\n' +
+                'Usage: xano branch set-live <branch_label> [--workspace <workspace_id>]');
+        }
+        const branchLabel = args.branch_label;
+        // Confirmation prompt unless --force is used
+        if (!flags.force) {
+            const confirmed = await this.confirm(`Are you sure you want to set '${branchLabel}' as the live branch?`);
+            if (!confirmed) {
+                this.log('Operation cancelled.');
+                return;
+            }
+        }
+        // Construct the API URL
+        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, {
+                headers: {
+                    'accept': 'application/json',
+                    'Authorization': `Bearer ${profile.access_token}`,
+                },
+                method: 'POST',
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+            }
+            const branch = await response.json();
+            // Output results
+            if (flags.output === 'json') {
+                this.log(JSON.stringify(branch, null, 2));
+            }
+            else {
+                this.log(`Branch '${branch.label}' is now live`);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.error(`Failed to set branch as live: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to set branch as live: ${String(error)}`);
+            }
+        }
+    }
+    async confirm(message) {
+        // Use readline for simple yes/no confirmation
+        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');
+            });
+        });
+    }
+    loadCredentials() {
+        const configDir = path.join(os.homedir(), '.xano');
+        const credentialsPath = path.join(configDir, 'credentials.yaml');
+        // Check if credentials file exists
+        if (!fs.existsSync(credentialsPath)) {
+            this.error(`Credentials file not found at ${credentialsPath}\n` +
+                `Create a profile using 'xano profile create'`);
+        }
+        // Read credentials file
+        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/function/create/index.d.ts

@@ -1,19 +1,19 @@
 import BaseCommand from '../../../base-command.js';
 export default class FunctionCreate extends BaseCommand {
     static args: {};
+    static description: string;
+    static examples: string[];
     static flags: {
-        workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        stdin: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         edit: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        stdin: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        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>;
     };
-    static description: string;
-    static examples: string[];
     run(): Promise<void>;
     private editFile;
-    private readStdin;
     private loadCredentials;
+    private readStdin;
 }

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

@@ -1,47 +1,12 @@
 import { Flags } from '@oclif/core';
+import * as yaml from 'js-yaml';
 import { execSync } from 'node:child_process';
 import * as fs from 'node:fs';
 import * as os from 'node:os';
 import * as path from 'node:path';
-import * as yaml from 'js-yaml';
 import BaseCommand from '../../../base-command.js';
 export default class FunctionCreate extends BaseCommand {
     static args = {};
-    static flags = {
-        ...BaseCommand.baseFlags,
-        workspace: Flags.string({
-            char: 'w',
-            description: 'Workspace ID (optional if set in profile)',
-            required: false,
-        }),
-        file: Flags.string({
-            char: 'f',
-            description: 'Path to file containing XanoScript code',
-            required: false,
-            exclusive: ['stdin'],
-        }),
-        stdin: Flags.boolean({
-            char: 's',
-            description: 'Read XanoScript code from stdin',
-            required: false,
-            default: false,
-            exclusive: ['file'],
-        }),
-        edit: Flags.boolean({
-            char: 'e',
-            description: 'Open file in editor before creating function (requires --file)',
-            required: false,
-            default: false,
-            dependsOn: ['file'],
-        }),
-        output: Flags.string({
-            char: 'o',
-            description: 'Output format',
-            required: false,
-            default: 'summary',
-            options: ['summary', 'json'],
-        }),
-    };
     static description = 'Create a new function in a workspace';
     static examples = [
         `$ xano function:create -w 40 -f function.xs
@@ -73,6 +38,41 @@ Name: my_function
 }
 `,
     ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        edit: Flags.boolean({
+            char: 'e',
+            default: false,
+            dependsOn: ['file'],
+            description: 'Open file in editor before creating function (requires --file)',
+            required: false,
+        }),
+        file: Flags.string({
+            char: 'f',
+            description: 'Path to file containing XanoScript code',
+            exclusive: ['stdin'],
+            required: false,
+        }),
+        output: Flags.string({
+            char: 'o',
+            default: 'summary',
+            description: 'Output format',
+            options: ['summary', 'json'],
+            required: false,
+        }),
+        stdin: Flags.boolean({
+            char: 's',
+            default: false,
+            description: 'Read XanoScript code from stdin',
+            exclusive: ['file'],
+            required: false,
+        }),
+        workspace: Flags.string({
+            char: 'w',
+            description: 'Workspace ID (optional if set in profile)',
+            required: false,
+        }),
+    };
     async run() {
         const { flags } = await this.parse(FunctionCreate);
         // Get profile name (default or from flag/env)
@@ -154,13 +154,13 @@ Name: my_function
         // Create function via API
         try {
             const response = await fetch(apiUrl, {
-                method: 'POST',
+                body: xanoscript,
                 headers: {
                     'accept': 'application/json',
-                    'Content-Type': 'text/x-xanoscript',
                     'Authorization': `Bearer ${profile.access_token}`,
+                    'Content-Type': 'text/x-xanoscript',
                 },
-                body: xanoscript,
+                method: 'POST',
             });
             if (!response.ok) {
                 const errorText = await response.text();
@@ -240,22 +240,6 @@ Name: my_function
         }
         return tmpFile;
     }
-    async readStdin() {
-        return new Promise((resolve, reject) => {
-            const chunks = [];
-            process.stdin.on('data', (chunk) => {
-                chunks.push(chunk);
-            });
-            process.stdin.on('end', () => {
-                resolve(Buffer.concat(chunks).toString('utf8'));
-            });
-            process.stdin.on('error', (error) => {
-                reject(error);
-            });
-            // Resume stdin if it was paused
-            process.stdin.resume();
-        });
-    }
     loadCredentials() {
         const configDir = path.join(os.homedir(), '.xano');
         const credentialsPath = path.join(configDir, 'credentials.yaml');
@@ -277,4 +261,20 @@ Name: my_function
             this.error(`Failed to parse credentials file: ${error}`);
         }
     }
+    async readStdin() {
+        return new Promise((resolve, reject) => {
+            const chunks = [];
+            process.stdin.on('data', (chunk) => {
+                chunks.push(chunk);
+            });
+            process.stdin.on('end', () => {
+                resolve(Buffer.concat(chunks).toString('utf8'));
+            });
+            process.stdin.on('error', (error) => {
+                reject(error);
+            });
+            // Resume stdin if it was paused
+            process.stdin.resume();
+        });
+    }
 }

package/dist/commands/function/edit/index.d.ts

@@ -3,23 +3,23 @@ export default class FunctionEdit extends BaseCommand {
     static args: {
         function_id: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
+    static description: string;
+    static examples: string[];
     static flags: {
-        workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        stdin: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         edit: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        publish: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        publish: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        stdin: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        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>;
     };
-    static description: string;
-    static examples: string[];
     run(): Promise<void>;
-    private fetchFunctionCode;
-    private editFunctionContent;
     private editFile;
-    private readStdin;
-    private promptForFunctionId;
+    private editFunctionContent;
+    private fetchFunctionCode;
     private loadCredentials;
+    private promptForFunctionId;
+    private readStdin;
 }