@xano/cli 1.3.5-beta.0 → 1.3.5-beta.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xano/cli",
   "description": "CLI for Xano's Metadata API",
-  "version": "1.3.5-beta.0",
+  "version": "1.3.5-beta.1",
   "author": "Sean Montgomery",
   "bin": {
     "xano": "./bin/run.js"

package/dist/commands/tenant/snapshot/create/index.d.ts

@@ -1,17 +0,0 @@
-import BaseCommand from '../../../../base-command.js';
-export default class TenantSnapshotCreate extends BaseCommand {
-    static args: {
-        tenant_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
-    static description: string;
-    static examples: string[];
-    static flags: {
-        label: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        config: 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>;
-}

package/dist/commands/tenant/snapshot/create/index.js

@@ -1,78 +0,0 @@
-import { Args, Flags } from '@oclif/core';
-import BaseCommand from '../../../../base-command.js';
-export default class TenantSnapshotCreate extends BaseCommand {
-    static args = {
-        tenant_name: Args.string({
-            description: 'Tenant name to snapshot',
-            required: true,
-        }),
-    };
-    static description = "Create a database snapshot for a tenant (an instant clone of the tenant's database)";
-    static examples = [
-        `$ xano tenant snapshot create t1234-abcd-xyz1 --label before-v2
-Created snapshot t1234-abcd-xyz1_bk_20260603_203614 for tenant t1234-abcd-xyz1
-`,
-        `$ xano tenant snapshot create t1234-abcd-xyz1 -l before-v2 -o json`,
-    ];
-    static flags = {
-        ...BaseCommand.baseFlags,
-        label: Flags.string({
-            char: 'l',
-            default: '',
-            description: 'Optional label appended to the snapshot description (alphanumeric)',
-            required: false,
-        }),
-        output: Flags.string({
-            char: 'o',
-            default: 'summary',
-            description: 'Output format',
-            options: ['summary', 'json'],
-            required: false,
-        }),
-        workspace: Flags.string({
-            char: 'w',
-            description: 'Workspace ID (uses profile workspace if not provided)',
-            required: false,
-        }),
-    };
-    async run() {
-        const { args, flags } = await this.parse(TenantSnapshotCreate);
-        const { profile } = this.resolveProfile(flags);
-        const workspaceId = flags.workspace || profile.workspace;
-        if (!workspaceId) {
-            this.error('No workspace ID provided. Use --workspace flag or set one in your profile.');
-        }
-        const tenantName = args.tenant_name;
-        const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/tenant/${tenantName}/snapshot`;
-        try {
-            const response = await this.verboseFetch(apiUrl, {
-                body: JSON.stringify({ label: flags.label }),
-                headers: {
-                    'accept': 'application/json',
-                    'Authorization': `Bearer ${profile.access_token}`,
-                    '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}`);
-            }
-            const result = (await response.json());
-            if (flags.output === 'json') {
-                this.log(JSON.stringify(result, null, 2));
-            }
-            else {
-                this.log(`Created snapshot ${result.backup} for tenant ${tenantName}`);
-            }
-        }
-        catch (error) {
-            if (error instanceof Error) {
-                this.error(`Failed to create snapshot: ${error.message}`);
-            }
-            else {
-                this.error(`Failed to create snapshot: ${String(error)}`);
-            }
-        }
-    }
-}

package/dist/commands/tenant/snapshot/delete/index.d.ts

@@ -1,19 +0,0 @@
-import BaseCommand from '../../../../base-command.js';
-export default class TenantSnapshotDelete extends BaseCommand {
-    static args: {
-        tenant_name: 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>;
-        snapshot: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        config: 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 confirm;
-}

package/dist/commands/tenant/snapshot/delete/index.js

@@ -1,102 +0,0 @@
-import { Args, Flags } from '@oclif/core';
-import * as readline from 'node:readline';
-import BaseCommand from '../../../../base-command.js';
-export default class TenantSnapshotDelete extends BaseCommand {
-    static args = {
-        tenant_name: Args.string({
-            description: 'Tenant name that owns the snapshot',
-            required: true,
-        }),
-    };
-    static description = '[CRITICAL] NEVER delete a snapshot without explicit user confirmation; this permanently drops the snapshot database. The live and original databases cannot be deleted.';
-    static examples = [
-        `$ xano tenant snapshot delete t1234-abcd-xyz1 --snapshot t1234-abcd-xyz1_bk_20260603_203614
-Are you sure you want to delete snapshot "t1234-abcd-xyz1_bk_20260603_203614"? This action cannot be undone. (y/N) y
-Deleted snapshot t1234-abcd-xyz1_bk_20260603_203614
-`,
-        `$ xano tenant snapshot delete t1234-abcd-xyz1 --snapshot t1234-abcd-xyz1_bk_20260603_203614 --force`,
-    ];
-    static flags = {
-        ...BaseCommand.baseFlags,
-        force: Flags.boolean({
-            char: 'f',
-            default: false,
-            description: '[CRITICAL] Skips the confirmation prompt.',
-            required: false,
-        }),
-        output: Flags.string({
-            char: 'o',
-            default: 'summary',
-            description: 'Output format',
-            options: ['summary', 'json'],
-            required: false,
-        }),
-        snapshot: Flags.string({
-            description: 'Snapshot database name to delete',
-            required: true,
-        }),
-        workspace: Flags.string({
-            char: 'w',
-            description: 'Workspace ID (uses profile workspace if not provided)',
-            required: false,
-        }),
-    };
-    async run() {
-        const { args, flags } = await this.parse(TenantSnapshotDelete);
-        const { profile } = this.resolveProfile(flags);
-        const workspaceId = flags.workspace || profile.workspace;
-        if (!workspaceId) {
-            this.error('No workspace ID provided. Use --workspace flag or set one in your profile.');
-        }
-        const tenantName = args.tenant_name;
-        const { snapshot } = flags;
-        if (!flags.force) {
-            const confirmed = await this.confirm(`Are you sure you want to delete snapshot "${snapshot}"? This action cannot be undone.`);
-            if (!confirmed) {
-                this.log('Deletion cancelled.');
-                return;
-            }
-        }
-        const queryParams = new URLSearchParams({ snapshot });
-        const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/tenant/${tenantName}/snapshot?${queryParams.toString()}`;
-        try {
-            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}`);
-            }
-            if (flags.output === 'json') {
-                this.log(JSON.stringify({ deleted: true, snapshot, tenant_name: tenantName }, null, 2));
-            }
-            else {
-                this.log(`Deleted snapshot ${snapshot}`);
-            }
-        }
-        catch (error) {
-            if (error instanceof Error) {
-                this.error(`Failed to delete snapshot: ${error.message}`);
-            }
-            else {
-                this.error(`Failed to delete snapshot: ${String(error)}`);
-            }
-        }
-    }
-    async confirm(message) {
-        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/tenant/snapshot/list/index.d.ts

@@ -1,16 +0,0 @@
-import BaseCommand from '../../../../base-command.js';
-export default class TenantSnapshotList extends BaseCommand {
-    static args: {
-        tenant_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
-    static description: string;
-    static examples: string[];
-    static flags: {
-        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        config: 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>;
-}

package/dist/commands/tenant/snapshot/list/index.js

@@ -1,100 +0,0 @@
-import { Args, Flags } from '@oclif/core';
-import BaseCommand from '../../../../base-command.js';
-import { buildPagingJson, formatPagingFooter } from '../../../../utils/paging.js';
-export default class TenantSnapshotList extends BaseCommand {
-    static args = {
-        tenant_name: Args.string({
-            description: 'Tenant name to list snapshots for',
-            required: true,
-        }),
-    };
-    static description = 'List database snapshots for a tenant';
-    static examples = [
-        `$ xano tenant snapshot list t1234-abcd-xyz1
-Snapshots for tenant t1234-abcd-xyz1:
-  - t1234-abcd-xyz1 (25 MB) [ORIGINAL]
-  - t1234-abcd-xyz1_bk_20260603_203614 (25 MB, 2026-06-03 20:36:14) [LIVE]
-`,
-        `$ xano tenant snapshot list t1234-abcd-xyz1 -o json`,
-    ];
-    static flags = {
-        ...BaseCommand.baseFlags,
-        output: Flags.string({
-            char: 'o',
-            default: 'summary',
-            description: 'Output format',
-            options: ['summary', 'json'],
-            required: false,
-        }),
-        workspace: Flags.string({
-            char: 'w',
-            description: 'Workspace ID (uses profile workspace if not provided)',
-            required: false,
-        }),
-    };
-    async run() {
-        const { args, flags } = await this.parse(TenantSnapshotList);
-        const { profile } = this.resolveProfile(flags);
-        const workspaceId = flags.workspace || profile.workspace;
-        if (!workspaceId) {
-            this.error('No workspace ID provided. Use --workspace flag or set one in your profile.');
-        }
-        const tenantName = args.tenant_name;
-        const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/tenant/${tenantName}/snapshot`;
-        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 snapshots;
-            if (Array.isArray(data)) {
-                snapshots = data;
-            }
-            else if (data && typeof data === 'object' && 'items' in data && Array.isArray(data.items)) {
-                snapshots = data.items;
-            }
-            else {
-                this.error('Unexpected API response format');
-            }
-            if (flags.output === 'json') {
-                this.log(JSON.stringify(buildPagingJson({ items: snapshots }, { tier: 'none' }), null, 2));
-            }
-            else if (snapshots.length === 0) {
-                this.log(`No snapshots found for tenant ${tenantName}`);
-            }
-            else {
-                this.log(`Snapshots for tenant ${tenantName}:`);
-                for (const snapshot of snapshots) {
-                    const size = snapshot.size_pretty || (snapshot.size_bytes ? `${snapshot.size_bytes} bytes` : 'unknown');
-                    const meta = snapshot.created ? `${size}, ${snapshot.created}` : size;
-                    const tags = [];
-                    if (snapshot.is_original)
-                        tags.push('ORIGINAL');
-                    if (snapshot.is_live)
-                        tags.push('LIVE');
-                    const tagStr = tags.length > 0 ? ` [${tags.join(', ')}]` : '';
-                    this.log(`  - ${snapshot.name} (${meta})${tagStr}`);
-                }
-                const footer = formatPagingFooter({ items: snapshots }, { noun: 'snapshot', tier: 'none' });
-                if (footer)
-                    this.log(footer);
-            }
-        }
-        catch (error) {
-            if (error instanceof Error) {
-                this.error(`Failed to list snapshots: ${error.message}`);
-            }
-            else {
-                this.error(`Failed to list snapshots: ${String(error)}`);
-            }
-        }
-    }
-}

package/dist/commands/tenant/snapshot/swap/index.d.ts

@@ -1,19 +0,0 @@
-import BaseCommand from '../../../../base-command.js';
-export default class TenantSnapshotSwap extends BaseCommand {
-    static args: {
-        tenant_name: 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>;
-        snapshot: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        config: 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 confirm;
-}

package/dist/commands/tenant/snapshot/swap/index.js

@@ -1,103 +0,0 @@
-import { Args, Flags } from '@oclif/core';
-import * as readline from 'node:readline';
-import BaseCommand from '../../../../base-command.js';
-export default class TenantSnapshotSwap extends BaseCommand {
-    static args = {
-        tenant_name: Args.string({
-            description: 'Tenant name to swap',
-            required: true,
-        }),
-    };
-    static description = "Swap a tenant's live database to a snapshot. This repoints the tenant; the current live database is left untouched, so you can swap back. To roll back, swap to the original database name.";
-    static examples = [
-        `$ xano tenant snapshot swap t1234-abcd-xyz1 --snapshot t1234-abcd-xyz1_bk_20260603_203614
-Swapped tenant t1234-abcd-xyz1 from t1234-abcd-xyz1 to t1234-abcd-xyz1_bk_20260603_203614
-`,
-        `$ xano tenant snapshot swap t1234-abcd-xyz1 --snapshot t1234-abcd-xyz1 --force`,
-    ];
-    static flags = {
-        ...BaseCommand.baseFlags,
-        force: Flags.boolean({
-            char: 'f',
-            default: false,
-            description: 'Skips the confirmation prompt.',
-            required: false,
-        }),
-        output: Flags.string({
-            char: 'o',
-            default: 'summary',
-            description: 'Output format',
-            options: ['summary', 'json'],
-            required: false,
-        }),
-        snapshot: Flags.string({
-            description: 'Snapshot database name to swap to (use the original tenant name to roll back)',
-            required: true,
-        }),
-        workspace: Flags.string({
-            char: 'w',
-            description: 'Workspace ID (uses profile workspace if not provided)',
-            required: false,
-        }),
-    };
-    async run() {
-        const { args, flags } = await this.parse(TenantSnapshotSwap);
-        const { profile } = this.resolveProfile(flags);
-        const workspaceId = flags.workspace || profile.workspace;
-        if (!workspaceId) {
-            this.error('No workspace ID provided. Use --workspace flag or set one in your profile.');
-        }
-        const tenantName = args.tenant_name;
-        const { snapshot } = flags;
-        if (!flags.force) {
-            const confirmed = await this.confirm(`Swap tenant ${tenantName} to "${snapshot}"? This repoints the tenant's live database.`);
-            if (!confirmed) {
-                this.log('Swap cancelled.');
-                return;
-            }
-        }
-        const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/tenant/${tenantName}/snapshot/swap`;
-        try {
-            const response = await this.verboseFetch(apiUrl, {
-                body: JSON.stringify({ snapshot }),
-                headers: {
-                    'accept': 'application/json',
-                    'Authorization': `Bearer ${profile.access_token}`,
-                    '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}`);
-            }
-            const result = (await response.json());
-            if (flags.output === 'json') {
-                this.log(JSON.stringify(result, null, 2));
-            }
-            else {
-                this.log(`Swapped tenant ${tenantName} from ${result.from ?? 'unknown'} to ${result.to ?? snapshot}`);
-            }
-        }
-        catch (error) {
-            if (error instanceof Error) {
-                this.error(`Failed to swap snapshot: ${error.message}`);
-            }
-            else {
-                this.error(`Failed to swap snapshot: ${String(error)}`);
-            }
-        }
-    }
-    async confirm(message) {
-        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');
-            });
-        });
-    }
-}