@xano/cli 0.0.20 → 0.0.21

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

@@ -0,0 +1,14 @@
+import BaseCommand from '../../../base-command.js';
+export default class WorkspaceCreate extends BaseCommand {
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        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>;
+    };
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+    private loadCredentials;
+}

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

@@ -0,0 +1,131 @@
+import { Flags } from '@oclif/core';
+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 WorkspaceCreate extends BaseCommand {
+    static flags = {
+        ...BaseCommand.baseFlags,
+        name: Flags.string({
+            char: 'n',
+            description: 'Name of the workspace',
+            required: true,
+        }),
+        description: Flags.string({
+            char: 'd',
+            description: 'Description for the workspace',
+            required: false,
+        }),
+        output: Flags.string({
+            char: 'o',
+            description: 'Output format',
+            required: false,
+            default: 'summary',
+            options: ['summary', 'json'],
+        }),
+    };
+    static description = 'Create a new workspace via the Xano Metadata API';
+    static examples = [
+        `$ xano workspace create --name "my-workspace"
+Created workspace: my-workspace (ID: 123)
+`,
+        `$ xano workspace create --name "my-app" --description "My application workspace"
+Created workspace: my-app (ID: 456)
+  Description: My application workspace
+`,
+        `$ xano workspace create -n "new-project" -d "New project workspace" -o json
+{
+  "id": 789,
+  "name": "new-project",
+  "description": "New project workspace"
+}
+`,
+    ];
+    async run() {
+        const { flags } = await this.parse(WorkspaceCreate);
+        // 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`);
+        }
+        // Construct the API URL
+        const apiUrl = `${profile.instance_origin}/api:meta/workspace`;
+        // Build request body
+        const body = {
+            name: flags.name,
+        };
+        if (flags.description) {
+            body.description = flags.description;
+        }
+        // Create workspace via the API
+        try {
+            const response = await fetch(apiUrl, {
+                method: 'POST',
+                headers: {
+                    'accept': 'application/json',
+                    'content-type': 'application/json',
+                    'Authorization': `Bearer ${profile.access_token}`,
+                },
+                body: JSON.stringify(body),
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+            }
+            const workspace = await response.json();
+            // Output results
+            if (flags.output === 'json') {
+                this.log(JSON.stringify(workspace, null, 2));
+            }
+            else {
+                // summary format
+                this.log(`Created workspace: ${workspace.name} (ID: ${workspace.id})`);
+                if (workspace.description) {
+                    this.log(`  Description: ${workspace.description}`);
+                }
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.error(`Failed to create workspace: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to create workspace: ${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/workspace/delete/index.d.ts

@@ -0,0 +1,20 @@
+import BaseCommand from '../../../base-command.js';
+export default class WorkspaceDelete extends BaseCommand {
+    static args: {
+        workspace_id: import("@oclif/core/interfaces").Arg<number, {
+            max?: number;
+            min?: number;
+        }>;
+    };
+    static flags: {
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        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>;
+    };
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+    private confirm;
+    private loadCredentials;
+}

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

@@ -0,0 +1,141 @@
+import { Args, Flags } from '@oclif/core';
+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 WorkspaceDelete extends BaseCommand {
+    static args = {
+        workspace_id: Args.integer({
+            description: 'Workspace ID to delete',
+            required: true,
+        }),
+    };
+    static flags = {
+        ...BaseCommand.baseFlags,
+        force: Flags.boolean({
+            char: 'f',
+            description: 'Skip confirmation prompt',
+            required: false,
+            default: false,
+        }),
+        output: Flags.string({
+            char: 'o',
+            description: 'Output format',
+            required: false,
+            default: 'summary',
+            options: ['summary', 'json'],
+        }),
+    };
+    static description = 'Delete a workspace via the Xano Metadata API. Cannot delete workspaces with active tenants.';
+    static examples = [
+        `$ xano workspace delete 123
+Are you sure you want to delete workspace 123? This action cannot be undone. (y/N) y
+Deleted workspace 123
+`,
+        `$ xano workspace delete 123 --force
+Deleted workspace 123
+`,
+        `$ xano workspace delete 123 -f -o json
+{
+  "deleted": true,
+  "workspace_id": 123
+}
+`,
+    ];
+    async run() {
+        const { args, flags } = await this.parse(WorkspaceDelete);
+        // 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`);
+        }
+        const workspaceId = args.workspace_id;
+        // Confirmation prompt unless --force is used
+        if (!flags.force) {
+            const confirmed = await this.confirm(`Are you sure you want to delete workspace ${workspaceId}? This action cannot be undone.`);
+            if (!confirmed) {
+                this.log('Deletion cancelled.');
+                return;
+            }
+        }
+        // Construct the API URL
+        const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}`;
+        // Delete workspace via the API
+        try {
+            const response = await fetch(apiUrl, {
+                method: 'DELETE',
+                headers: {
+                    'accept': 'application/json',
+                    'Authorization': `Bearer ${profile.access_token}`,
+                },
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+            }
+            // Output results
+            if (flags.output === 'json') {
+                this.log(JSON.stringify({ deleted: true, workspace_id: workspaceId }, null, 2));
+            }
+            else {
+                this.log(`Deleted workspace ${workspaceId}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.error(`Failed to delete workspace: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to delete workspace: ${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/workspace/edit/index.d.ts

@@ -0,0 +1,22 @@
+import BaseCommand from '../../../base-command.js';
+export default class WorkspaceEdit extends BaseCommand {
+    static args: {
+        workspace_id: import("@oclif/core/interfaces").Arg<number | undefined, {
+            max?: number;
+            min?: number;
+        }>;
+    };
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        swagger: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'require-token': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        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>;
+    };
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+    private loadCredentials;
+}

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

@@ -0,0 +1,176 @@
+import { Args, Flags } from '@oclif/core';
+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 WorkspaceEdit extends BaseCommand {
+    static args = {
+        workspace_id: Args.integer({
+            description: 'Workspace ID to edit (uses profile workspace if not provided)',
+            required: false,
+        }),
+    };
+    static flags = {
+        ...BaseCommand.baseFlags,
+        name: Flags.string({
+            char: 'n',
+            description: 'New name for the workspace',
+            required: false,
+        }),
+        description: Flags.string({
+            char: 'd',
+            description: 'New description for the workspace',
+            required: false,
+        }),
+        swagger: Flags.boolean({
+            description: 'Enable or disable swagger documentation',
+            required: false,
+            allowNo: true,
+        }),
+        'require-token': Flags.boolean({
+            description: 'Whether to require a token for documentation access',
+            required: false,
+            allowNo: true,
+        }),
+        output: Flags.string({
+            char: 'o',
+            description: 'Output format',
+            required: false,
+            default: 'summary',
+            options: ['summary', 'json'],
+        }),
+    };
+    static description = 'Edit an existing workspace via the Xano Metadata API';
+    static examples = [
+        `$ xano workspace edit 123 --name "new-name"
+Updated workspace: new-name (ID: 123)
+`,
+        `$ xano workspace edit --name "updated-workspace" --description "Updated description"
+Updated workspace: updated-workspace (ID: 123)
+  Description: Updated description
+`,
+        `$ xano workspace edit 123 --swagger --require-token
+Updated workspace: my-workspace (ID: 123)
+  Swagger: enabled
+  Require Token: true
+`,
+        `$ xano workspace edit 123 --no-swagger -o json
+{
+  "id": 123,
+  "name": "my-workspace",
+  "swagger": false
+}
+`,
+    ];
+    async run() {
+        const { args, flags } = await this.parse(WorkspaceEdit);
+        // 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 workspace edit <workspace_id> [flags]');
+        }
+        // Build request body - only include fields that were specified
+        const body = {};
+        if (flags.name !== undefined) {
+            body.name = flags.name;
+        }
+        if (flags.description !== undefined) {
+            body.description = flags.description;
+        }
+        if (flags.swagger !== undefined) {
+            body.swagger = flags.swagger;
+        }
+        if (flags['require-token'] !== undefined) {
+            body.documentation = { require_token: flags['require-token'] };
+        }
+        // Check if at least one field is being updated
+        if (Object.keys(body).length === 0) {
+            this.error('No fields specified to update. Use --name, --description, --swagger, or --require-token flags.\n' +
+                'Example: xano workspace edit 123 --name "new-name"');
+        }
+        // Construct the API URL
+        const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}`;
+        // Update workspace via the API
+        try {
+            const response = await fetch(apiUrl, {
+                method: 'PUT',
+                headers: {
+                    'accept': 'application/json',
+                    'content-type': 'application/json',
+                    'Authorization': `Bearer ${profile.access_token}`,
+                },
+                body: JSON.stringify(body),
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+            }
+            const workspace = await response.json();
+            // Output results
+            if (flags.output === 'json') {
+                this.log(JSON.stringify(workspace, null, 2));
+            }
+            else {
+                // summary format
+                this.log(`Updated workspace: ${workspace.name} (ID: ${workspace.id})`);
+                if (workspace.description) {
+                    this.log(`  Description: ${workspace.description}`);
+                }
+                if (workspace.swagger !== undefined) {
+                    this.log(`  Swagger: ${workspace.swagger ? 'enabled' : 'disabled'}`);
+                }
+                if (workspace.documentation?.require_token !== undefined) {
+                    this.log(`  Require Token: ${workspace.documentation.require_token}`);
+                }
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.error(`Failed to update workspace: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to update workspace: ${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/workspace/get/index.d.ts

@@ -0,0 +1,18 @@
+import BaseCommand from '../../../base-command.js';
+export default class WorkspaceGet extends BaseCommand {
+    static args: {
+        workspace_id: import("@oclif/core/interfaces").Arg<number | undefined, {
+            max?: number;
+            min?: number;
+        }>;
+    };
+    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>;
+    };
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+    private loadCredentials;
+}

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

@@ -0,0 +1,136 @@
+import { Args, Flags } from '@oclif/core';
+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 WorkspaceGet extends BaseCommand {
+    static args = {
+        workspace_id: Args.integer({
+            description: 'Workspace ID to get details for (uses profile workspace if not provided)',
+            required: false,
+        }),
+    };
+    static flags = {
+        ...BaseCommand.baseFlags,
+        output: Flags.string({
+            char: 'o',
+            description: 'Output format',
+            required: false,
+            default: 'summary',
+            options: ['summary', 'json'],
+        }),
+    };
+    static description = 'Get details of a specific workspace from the Xano Metadata API';
+    static examples = [
+        `$ xano workspace get 123
+Workspace: my-workspace (ID: 123)
+  Description: My workspace description
+  Created: 2024-01-15
+`,
+        `$ xano workspace get --output json
+{
+  "id": 123,
+  "name": "my-workspace",
+  "description": "My workspace description"
+}
+`,
+        `$ xano workspace get 456 -p production -o json
+{
+  "id": 456,
+  "name": "production-workspace"
+}
+`,
+    ];
+    async run() {
+        const { args, flags } = await this.parse(WorkspaceGet);
+        // 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 workspace get <workspace_id>');
+        }
+        // Construct the API URL
+        const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}`;
+        // Fetch workspace from the API
+        try {
+            const response = await fetch(apiUrl, {
+                method: 'GET',
+                headers: {
+                    'accept': 'application/json',
+                    'Authorization': `Bearer ${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 workspace = await response.json();
+            // Output results
+            if (flags.output === 'json') {
+                this.log(JSON.stringify(workspace, null, 2));
+            }
+            else {
+                // summary format
+                this.log(`Workspace: ${workspace.name} (ID: ${workspace.id})`);
+                if (workspace.description) {
+                    this.log(`  Description: ${workspace.description}`);
+                }
+                if (workspace.created_at) {
+                    const createdDate = new Date(workspace.created_at * 1000).toISOString().split('T')[0];
+                    this.log(`  Created: ${createdDate}`);
+                }
+                if (workspace.updated_at) {
+                    const updatedDate = new Date(workspace.updated_at * 1000).toISOString().split('T')[0];
+                    this.log(`  Updated: ${updatedDate}`);
+                }
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.error(`Failed to fetch workspace: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to fetch workspace: ${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/lib/run-http-client.d.ts

@@ -2,7 +2,7 @@
  * HTTP client for Xano Run API
  * Based on @xano/run-sdk HttpClient
  */
-export declare const DEFAULT_RUN_BASE_URL = "https://app.xano.com/";
+export declare const DEFAULT_RUN_BASE_URL = "https://app.dev.xano.com/";
 export interface RunHttpClientConfig {
     baseUrl: string;
     authToken: string;

package/dist/lib/run-http-client.js

@@ -2,7 +2,7 @@
  * HTTP client for Xano Run API
  * Based on @xano/run-sdk HttpClient
  */
-export const DEFAULT_RUN_BASE_URL = 'https://app.xano.com/';
+export const DEFAULT_RUN_BASE_URL = 'https://app.dev.xano.com/';
 export class RunHttpClient {
     config;
     constructor(config) {