@xano/cli 0.0.94 → 0.0.95-beta.2

package/README.md

@@ -235,6 +235,11 @@ xano release pull ./my-release -r v1.0 --env --records
 xano release push ./my-release -n "v2.0"
 xano release push ./my-release -n "v2.0" --hotfix -d "Critical fix"
 xano release push ./my-release -n "v2.0" --no-records --no-env
+
+# Deploy a release to its workspace as a new branch
+xano release deploy "v1.0"
+xano release deploy "v1.0" --branch "restore-v1" --no-set_live
+xano release deploy "v1.0" -w 40 -o json
 ```
 
 ### Platforms
@@ -440,6 +445,20 @@ xano tenant cluster license set <cluster_id>
 xano tenant cluster license set <cluster_id> --file ./kubeconfig.yaml
 ```
 
+### Ephemeral
+
+Manage ephemeral tenants. Ephemeral tenants are workspace-agnostic (tier1 only) and do not run background tasks.
+
+```bash
+# Create an ephemeral tenant
+xano ephemeral create "My Ephemeral"
+xano ephemeral create "CI Tenant" -d "For CI/CD" -o json
+
+# Get ephemeral tenant details
+xano ephemeral get <tenant_name>
+xano ephemeral get <tenant_name> -o json
+```
+
 ### Static Hosts
 
 ```bash

package/dist/commands/ephemeral/access/index.d.ts

@@ -0,0 +1,15 @@
+import BaseCommand from '../../../base-command.js';
+export default class EphemeralAccess extends BaseCommand {
+    static args: {
+        tenant_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        access: 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>;
+        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/ephemeral/access/index.js

@@ -0,0 +1,78 @@
+import { Args, Flags } from '@oclif/core';
+import BaseCommand from '../../../base-command.js';
+export default class EphemeralAccess extends BaseCommand {
+    static args = {
+        tenant_name: Args.string({
+            description: 'Ephemeral tenant name',
+            required: true,
+        }),
+        access: Args.string({
+            description: 'Access level to set',
+            options: ['private', 'shared'],
+            required: true,
+        }),
+    };
+    static description = 'Change the access level of an ephemeral tenant';
+    static examples = [
+        `$ xano ephemeral access e1a2-b3c4-x5y6 shared
+Access updated to shared for tenant e1a2-b3c4-x5y6
+`,
+        `$ xano ephemeral access e1a2-b3c4-x5y6 private`,
+    ];
+    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(EphemeralAccess);
+        const profileName = flags.profile || this.getDefaultProfile();
+        const credentials = this.loadCredentialsFile();
+        if (!credentials || !(profileName in credentials.profiles)) {
+            this.error(`Profile '${profileName}' not found.\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/ephemeral/tenant/${encodeURIComponent(args.tenant_name)}/access`;
+        try {
+            const response = await this.verboseFetch(apiUrl, {
+                body: JSON.stringify({ access: args.access }),
+                headers: {
+                    accept: 'application/json',
+                    Authorization: `Bearer ${profile.access_token}`,
+                    'Content-Type': 'application/json',
+                },
+                method: 'PATCH',
+            }, flags.verbose, profile.access_token);
+            if (!response.ok) {
+                const errorText = await response.text();
+                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+            }
+            const tenant = await response.json();
+            if (flags.output === 'json') {
+                this.log(JSON.stringify(tenant, null, 2));
+            }
+            else {
+                this.log(`Access updated to ${args.access} for tenant ${args.tenant_name}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.error(`Failed to update access: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to update access: ${String(error)}`);
+            }
+        }
+    }
+}

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

@@ -0,0 +1,17 @@
+import BaseCommand from '../../../base-command.js';
+export default class EphemeralCreate extends BaseCommand {
+    static args: {
+        display: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        access: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        domain: 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>;
+    };
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,102 @@
+import { Args, Flags } from '@oclif/core';
+import BaseCommand from '../../../base-command.js';
+export default class EphemeralCreate extends BaseCommand {
+    static args = {
+        display: Args.string({
+            description: 'Optional display name for the ephemeral tenant',
+            required: false,
+        }),
+    };
+    static description = 'Create an ephemeral tenant (workspace-agnostic, no background tasks)';
+    static examples = [
+        `$ xano ephemeral create
+Created ephemeral tenant: e1a2-b3c4-x5y6 - ID: 42
+`,
+        `$ xano ephemeral create "My Ephemeral"`,
+        `$ xano ephemeral create "CI Tenant" -d "For CI/CD" -o json`,
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        access: Flags.string({
+            char: 'a',
+            default: 'private',
+            description: 'Access level (private or shared)',
+            options: ['private', 'shared'],
+            required: false,
+        }),
+        description: Flags.string({
+            char: 'd',
+            description: 'Tenant description',
+            required: false,
+        }),
+        domain: Flags.string({
+            description: 'Custom domain for the tenant',
+            required: false,
+        }),
+        output: Flags.string({
+            char: 'o',
+            default: 'summary',
+            description: 'Output format',
+            options: ['summary', 'json'],
+            required: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(EphemeralCreate);
+        const profileName = flags.profile || this.getDefaultProfile();
+        const credentials = this.loadCredentialsFile();
+        if (!credentials || !(profileName in credentials.profiles)) {
+            this.error(`Profile '${profileName}' not found.\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 body = {
+            access: flags.access,
+            display: args.display || '',
+            tag: [],
+        };
+        if (flags.description)
+            body.description = flags.description;
+        if (flags.domain)
+            body.domain = flags.domain;
+        const apiUrl = `${profile.instance_origin}/api:meta/ephemeral/tenant`;
+        try {
+            const response = await this.verboseFetch(apiUrl, {
+                body: JSON.stringify(body),
+                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 tenant = (await response.json());
+            if (flags.output === 'json') {
+                this.log(JSON.stringify(tenant, null, 2));
+            }
+            else {
+                this.log(`Created ephemeral tenant: ${tenant.display || tenant.name} (${tenant.name}) - ID: ${tenant.id}`);
+                if (tenant.state) {
+                    this.log(`  State: ${tenant.state}`);
+                }
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.error(`Failed to create ephemeral tenant: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to create ephemeral tenant: ${String(error)}`);
+            }
+        }
+    }
+}

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

@@ -0,0 +1,16 @@
+import BaseCommand from '../../../base-command.js';
+export default class EphemeralDelete 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>;
+        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/ephemeral/delete/index.js

@@ -0,0 +1,99 @@
+import { Args, Flags } from '@oclif/core';
+import BaseCommand from '../../../base-command.js';
+export default class EphemeralDelete extends BaseCommand {
+    static args = {
+        tenant_name: Args.string({
+            description: 'Ephemeral tenant name to delete',
+            required: true,
+        }),
+    };
+    static description = 'Delete an ephemeral tenant permanently. This cannot be undone.';
+    static examples = [
+        `$ xano ephemeral delete my-tenant
+Are you sure you want to delete ephemeral tenant my-tenant? This action cannot be undone. (y/N) y
+Deleted ephemeral tenant my-tenant
+`,
+        `$ xano ephemeral delete my-tenant --force`,
+        `$ xano ephemeral delete my-tenant -f -o json`,
+    ];
+    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,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(EphemeralDelete);
+        const profileName = flags.profile || this.getDefaultProfile();
+        const credentials = this.loadCredentialsFile();
+        if (!credentials || !(profileName in credentials.profiles)) {
+            this.error(`Profile '${profileName}' not found.\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 tenantName = args.tenant_name;
+        if (!flags.force) {
+            const confirmed = await this.confirm(`Are you sure you want to delete ephemeral tenant ${tenantName}? This action cannot be undone.`);
+            if (!confirmed) {
+                this.log('Deletion cancelled.');
+                return;
+            }
+        }
+        const apiUrl = `${profile.instance_origin}/api:meta/ephemeral/tenant/${encodeURIComponent(tenantName)}`;
+        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, tenant_name: tenantName }, null, 2));
+            }
+            else {
+                this.log(`Deleted ephemeral tenant ${tenantName}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.error(`Failed to delete ephemeral tenant: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to delete ephemeral tenant: ${String(error)}`);
+            }
+        }
+    }
+    async confirm(message) {
+        const readline = await import('node:readline');
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        return new Promise((resolve) => {
+            rl.question(`${message} (y/N) `, (answer) => {
+                rl.close();
+                resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+            });
+        });
+    }
+}

package/dist/commands/ephemeral/env/delete/index.d.ts

@@ -0,0 +1,17 @@
+import BaseCommand from '../../../../base-command.js';
+export default class EphemeralEnvDelete 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>;
+        name: import("@oclif/core/interfaces").OptionFlag<string, 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>;
+    };
+    run(): Promise<void>;
+    private confirm;
+}

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

@@ -0,0 +1,105 @@
+import { Args, Flags } from '@oclif/core';
+import BaseCommand from '../../../../base-command.js';
+export default class EphemeralEnvDelete extends BaseCommand {
+    static args = {
+        tenant_name: Args.string({
+            description: 'Ephemeral tenant name',
+            required: true,
+        }),
+    };
+    static description = 'Delete an environment variable from an ephemeral tenant';
+    static examples = [
+        `$ xano ephemeral env delete my-tenant --name DATABASE_URL
+Are you sure you want to delete environment variable 'DATABASE_URL' from ephemeral tenant my-tenant? (y/N) y
+Environment variable 'DATABASE_URL' deleted from ephemeral tenant my-tenant
+`,
+        `$ xano ephemeral env delete my-tenant --name DATABASE_URL --force`,
+        `$ xano ephemeral env delete my-tenant --name DATABASE_URL -f -o json`,
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        force: Flags.boolean({
+            char: 'f',
+            default: false,
+            description: 'Skip confirmation prompt',
+            required: false,
+        }),
+        name: Flags.string({
+            char: 'n',
+            description: 'Environment variable name',
+            required: true,
+        }),
+        output: Flags.string({
+            char: 'o',
+            default: 'summary',
+            description: 'Output format',
+            options: ['summary', 'json'],
+            required: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(EphemeralEnvDelete);
+        const profileName = flags.profile || this.getDefaultProfile();
+        const credentials = this.loadCredentialsFile();
+        if (!credentials || !(profileName in credentials.profiles)) {
+            this.error(`Profile '${profileName}' not found.\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 tenantName = args.tenant_name;
+        const envName = flags.name;
+        if (!flags.force) {
+            const confirmed = await this.confirm(`Are you sure you want to delete environment variable '${envName}' from ephemeral tenant ${tenantName}?`);
+            if (!confirmed) {
+                this.log('Deletion cancelled.');
+                return;
+            }
+        }
+        const apiUrl = `${profile.instance_origin}/api:meta/ephemeral/tenant/${tenantName}/env/${envName}`;
+        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, env_name: envName, tenant_name: tenantName }, null, 2));
+            }
+            else {
+                this.log(`Environment variable '${envName}' deleted from ephemeral tenant ${tenantName}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.error(`Failed to delete ephemeral tenant environment variable: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to delete ephemeral tenant environment variable: ${String(error)}`);
+            }
+        }
+    }
+    async confirm(message) {
+        const readline = await import('node:readline');
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        return new Promise((resolve) => {
+            rl.question(`${message} (y/N) `, (answer) => {
+                rl.close();
+                resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+            });
+        });
+    }
+}

package/dist/commands/ephemeral/env/get/index.d.ts

@@ -0,0 +1,15 @@
+import BaseCommand from '../../../../base-command.js';
+export default class EphemeralEnvGet extends BaseCommand {
+    static args: {
+        tenant_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string, 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>;
+    };
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,81 @@
+import { Args, Flags } from '@oclif/core';
+import BaseCommand from '../../../../base-command.js';
+export default class EphemeralEnvGet extends BaseCommand {
+    static args = {
+        tenant_name: Args.string({
+            description: 'Ephemeral tenant name',
+            required: true,
+        }),
+    };
+    static description = 'Get a single environment variable for an ephemeral tenant';
+    static examples = [
+        `$ xano ephemeral env get my-tenant --name DATABASE_URL
+postgres://localhost:5432/mydb
+`,
+        `$ xano ephemeral env get my-tenant --name DATABASE_URL -o json`,
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        name: Flags.string({
+            char: 'n',
+            description: 'Environment variable name',
+            required: true,
+        }),
+        output: Flags.string({
+            char: 'o',
+            default: 'summary',
+            description: 'Output format',
+            options: ['summary', 'json'],
+            required: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(EphemeralEnvGet);
+        const profileName = flags.profile || this.getDefaultProfile();
+        const credentials = this.loadCredentialsFile();
+        if (!credentials || !(profileName in credentials.profiles)) {
+            this.error(`Profile '${profileName}' not found.\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 tenantName = args.tenant_name;
+        const envName = flags.name;
+        const apiUrl = `${profile.instance_origin}/api:meta/ephemeral/tenant/${tenantName}/env/${envName}`;
+        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 envVar = (await response.json());
+            if (flags.output === 'json') {
+                this.log(JSON.stringify(envVar, null, 2));
+            }
+            else if (envVar) {
+                this.log(envVar.value);
+            }
+            else {
+                this.log(`Environment variable '${envName}' not found for ephemeral tenant ${tenantName}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.error(`Failed to get ephemeral tenant environment variable: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to get ephemeral tenant environment variable: ${String(error)}`);
+            }
+        }
+    }
+}

package/dist/commands/ephemeral/env/get_all/index.d.ts

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