@xano/cli 0.0.95-beta.2 → 0.0.95-beta.20

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

@@ -0,0 +1,65 @@
+import { Flags } from '@oclif/core';
+import BaseCommand from '../../../../base-command.js';
+export default class SandboxEnvGet extends BaseCommand {
+    static description = 'Get a single environment variable for a sandbox environment';
+    static examples = [
+        `$ xano sandbox env get --name DATABASE_URL
+postgres://localhost:5432/mydb
+`,
+        `$ xano sandbox env get --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 { flags } = await this.parse(SandboxEnvGet);
+        const { profile } = this.resolveProfile(flags);
+        const envName = flags.name;
+        const apiUrl = `${profile.instance_origin}/api:meta/sandbox/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 message = await this.parseApiError(response, 'API request failed');
+                this.error(message);
+            }
+            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 sandbox environment`);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
+            if (error instanceof Error) {
+                this.error(`Failed to get sandbox environment variable: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to get sandbox environment variable: ${String(error)}`);
+            }
+        }
+    }
+}

package/dist/commands/{ephemeral → sandbox}/env/get_all/index.d.ts

@@ -1,8 +1,5 @@
 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>>;
-    };
+export default class SandboxEnvGetAll extends BaseCommand {
     static description: string;
     static examples: string[];
     static flags: {

package/dist/commands/sandbox/env/get_all/index.js

@@ -0,0 +1,78 @@
+import { Flags } from '@oclif/core';
+import * as yaml from 'js-yaml';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import BaseCommand from '../../../../base-command.js';
+export default class SandboxEnvGetAll extends BaseCommand {
+    static description = 'Get all environment variables for a sandbox environment and save to a YAML file';
+    static examples = [
+        `$ xano sandbox env get_all
+Environment variables saved to env_<tenant>.yaml
+`,
+        `$ xano sandbox env get_all --file ./my-env.yaml`,
+        `$ xano sandbox env get_all --view`,
+        `$ xano sandbox env get_all -o json`,
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        file: Flags.string({
+            char: 'f',
+            description: 'Output file path (default: env_<sandbox_name>.yaml)',
+            required: false,
+        }),
+        output: Flags.string({
+            char: 'o',
+            default: 'summary',
+            description: 'Output format',
+            options: ['summary', 'json'],
+            required: false,
+        }),
+        view: Flags.boolean({
+            default: false,
+            description: 'Print environment variables to stdout instead of saving to file',
+            required: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SandboxEnvGetAll);
+        const { profile } = this.resolveProfile(flags);
+        const apiUrl = `${profile.instance_origin}/api:meta/sandbox/env_all`;
+        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 message = await this.parseApiError(response, 'API request failed');
+                this.error(message);
+            }
+            const envMap = (await response.json());
+            if (flags.output === 'json') {
+                this.log(JSON.stringify(envMap, null, 2));
+            }
+            else if (flags.view) {
+                const envYaml = yaml.dump(envMap, { lineWidth: -1, sortKeys: true });
+                this.log(envYaml.trimEnd());
+            }
+            else {
+                const filePath = path.resolve(flags.file || `env.yaml`);
+                const envYaml = yaml.dump(envMap, { lineWidth: -1, sortKeys: true });
+                fs.writeFileSync(filePath, envYaml, 'utf8');
+                this.log(`Environment variables saved to ${filePath}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
+            if (error instanceof Error) {
+                this.error(`Failed to get sandbox environment variables: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to get sandbox environment variables: ${String(error)}`);
+            }
+        }
+    }
+}

package/dist/commands/{ephemeral → sandbox}/env/list/index.d.ts

@@ -1,8 +1,5 @@
 import BaseCommand from '../../../../base-command.js';
-export default class EphemeralEnvList extends BaseCommand {
-    static args: {
-        tenant_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
+export default class SandboxEnvList extends BaseCommand {
     static description: string;
     static examples: string[];
     static flags: {

package/dist/commands/sandbox/env/list/index.js

@@ -0,0 +1,67 @@
+import { Flags } from '@oclif/core';
+import BaseCommand from '../../../../base-command.js';
+export default class SandboxEnvList extends BaseCommand {
+    static description = 'List environment variable keys for a sandbox environment';
+    static examples = [
+        `$ xano sandbox env list
+Environment variables for sandbox environment:
+  - DATABASE_URL
+  - API_KEY
+`,
+        `$ xano sandbox env list -o json`,
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        output: Flags.string({
+            char: 'o',
+            default: 'summary',
+            description: 'Output format',
+            options: ['summary', 'json'],
+            required: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SandboxEnvList);
+        const { profile } = this.resolveProfile(flags);
+        const apiUrl = `${profile.instance_origin}/api:meta/sandbox/env_key`;
+        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 message = await this.parseApiError(response, 'API request failed');
+                this.error(message);
+            }
+            const data = (await response.json());
+            if (flags.output === 'json') {
+                this.log(JSON.stringify(data, null, 2));
+            }
+            else {
+                const envVars = data.env || [];
+                if (envVars.length === 0) {
+                    this.log(`No environment variables found for sandbox environment`);
+                }
+                else {
+                    this.log(`Environment variables for sandbox environment:`);
+                    for (const envVar of envVars) {
+                        this.log(`  - ${envVar.name}`);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
+            if (error instanceof Error) {
+                this.error(`Failed to list sandbox environment variables: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to list sandbox environment variables: ${String(error)}`);
+            }
+        }
+    }
+}

package/dist/commands/{ephemeral → sandbox}/env/set/index.d.ts

@@ -1,8 +1,5 @@
 import BaseCommand from '../../../../base-command.js';
-export default class EphemeralEnvSet extends BaseCommand {
-    static args: {
-        tenant_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
+export default class SandboxEnvSet extends BaseCommand {
     static description: string;
     static examples: string[];
     static flags: {

package/dist/commands/sandbox/env/set/index.js

@@ -0,0 +1,74 @@
+import { Flags } from '@oclif/core';
+import BaseCommand from '../../../../base-command.js';
+export default class SandboxEnvSet extends BaseCommand {
+    static description = 'Set (create or update) an environment variable for a sandbox environment';
+    static examples = [
+        `$ xano sandbox env set --name DATABASE_URL --value postgres://localhost:5432/mydb
+Environment variable 'DATABASE_URL' set
+`,
+        `$ xano sandbox env set --name DATABASE_URL --value postgres://localhost:5432/mydb -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,
+        }),
+        value: Flags.string({
+            description: 'Environment variable value',
+            required: true,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SandboxEnvSet);
+        const { profile } = this.resolveProfile(flags);
+        const envName = flags.name;
+        const apiUrl = `${profile.instance_origin}/api:meta/sandbox/env/${envName}`;
+        const body = {
+            env: {
+                name: envName,
+                value: flags.value,
+            },
+        };
+        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: 'PATCH',
+            }, flags.verbose, profile.access_token);
+            if (!response.ok) {
+                const message = await this.parseApiError(response, 'API request failed');
+                this.error(message);
+            }
+            if (flags.output === 'json') {
+                const result = await response.json();
+                this.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                this.log(`Environment variable '${envName}' set for sandbox environment`);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
+            if (error instanceof Error) {
+                this.error(`Failed to set sandbox environment variable: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to set sandbox environment variable: ${String(error)}`);
+            }
+        }
+    }
+}

package/dist/commands/{ephemeral → sandbox}/env/set_all/index.d.ts

@@ -1,8 +1,5 @@
 import BaseCommand from '../../../../base-command.js';
-export default class EphemeralEnvSetAll extends BaseCommand {
-    static args: {
-        tenant_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
+export default class SandboxEnvSetAll extends BaseCommand {
     static description: string;
     static examples: string[];
     static flags: {

package/dist/commands/{ephemeral → sandbox}/env/set_all/index.js

@@ -1,22 +1,16 @@
-import { Args, Flags } from '@oclif/core';
+import { Flags } from '@oclif/core';
 import * as yaml from 'js-yaml';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import BaseCommand from '../../../../base-command.js';
-export default class EphemeralEnvSetAll extends BaseCommand {
-    static args = {
-        tenant_name: Args.string({
-            description: 'Ephemeral tenant name',
-            required: true,
-        }),
-    };
-    static description = 'Set all environment variables for an ephemeral tenant from a YAML file (replaces all existing)';
+export default class SandboxEnvSetAll extends BaseCommand {
+    static description = 'Set all environment variables for a sandbox environment from a YAML file (replaces all existing)';
     static examples = [
-        `$ xano ephemeral env set_all my-tenant
-Reads from env_my-tenant.yaml
+        `$ xano sandbox env set_all
+Reads from env_<tenant>.yaml
 `,
-        `$ xano ephemeral env set_all my-tenant --file ./my-env.yaml`,
-        `$ xano ephemeral env set_all my-tenant -o json`,
+        `$ xano sandbox env set_all --file ./my-env.yaml`,
+        `$ xano sandbox env set_all -o json`,
     ];
     static flags = {
         ...BaseCommand.baseFlags,
@@ -27,7 +21,7 @@ Reads from env_my-tenant.yaml
         }),
         file: Flags.string({
             char: 'f',
-            description: 'Path to env file (default: env_<tenant_name>.yaml)',
+            description: 'Path to env file (default: env_<sandbox_name>.yaml)',
             required: false,
         }),
         output: Flags.string({
@@ -39,9 +33,9 @@ Reads from env_my-tenant.yaml
         }),
     };
     async run() {
-        const { args, flags } = await this.parse(EphemeralEnvSetAll);
-        const tenantName = args.tenant_name;
-        const sourceFilePath = path.resolve(flags.file || `env_${tenantName}.yaml`);
+        const { flags } = await this.parse(SandboxEnvSetAll);
+        const { profile } = this.resolveProfile(flags);
+        const sourceFilePath = path.resolve(flags.file || `env.yaml`);
         if (!fs.existsSync(sourceFilePath)) {
             this.error(`File not found: ${sourceFilePath}`);
         }
@@ -51,19 +45,7 @@ Reads from env_my-tenant.yaml
             this.error('Invalid env file format. Expected a YAML map of key: value pairs.');
         }
         const envs = Object.entries(envMap).map(([name, value]) => ({ name, value: String(value) }));
-        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/${tenantName}/env_all`;
+        const apiUrl = `${profile.instance_origin}/api:meta/sandbox/env_all`;
         try {
             const response = await this.verboseFetch(apiUrl, {
                 body: JSON.stringify({ envs }),
@@ -75,15 +57,15 @@ Reads from env_my-tenant.yaml
                 method: 'PUT',
             }, flags.verbose, profile.access_token);
             if (!response.ok) {
-                const errorText = await response.text();
-                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+                const message = await this.parseApiError(response, 'API request failed');
+                this.error(message);
             }
             if (flags.output === 'json') {
                 const result = await response.json();
                 this.log(JSON.stringify(result, null, 2));
             }
             else {
-                this.log(`All environment variables updated for ephemeral tenant ${tenantName} (${envs.length} variables)`);
+                this.log(`All environment variables updated for sandbox environment (${envs.length} variables)`);
             }
             if (flags.clean && fs.existsSync(sourceFilePath)) {
                 fs.unlinkSync(sourceFilePath);
@@ -91,11 +73,13 @@ Reads from env_my-tenant.yaml
             }
         }
         catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
             if (error instanceof Error) {
-                this.error(`Failed to set ephemeral tenant environment variables: ${error.message}`);
+                this.error(`Failed to set sandbox environment variables: ${error.message}`);
             }
             else {
-                this.error(`Failed to set ephemeral tenant environment variables: ${String(error)}`);
+                this.error(`Failed to set sandbox environment variables: ${String(error)}`);
             }
         }
     }

package/dist/commands/{ephemeral → sandbox}/get/index.d.ts

@@ -1,8 +1,5 @@
 import BaseCommand from '../../../base-command.js';
-export default class EphemeralGet extends BaseCommand {
-    static args: {
-        tenant_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
+export default class SandboxGet extends BaseCommand {
     static description: string;
     static examples: string[];
     static flags: {

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

@@ -0,0 +1,63 @@
+import { Flags } from '@oclif/core';
+import BaseCommand from '../../../base-command.js';
+export default class SandboxGet extends BaseCommand {
+    static description = 'Get your sandbox environment (creates one if it does not exist)';
+    static examples = [
+        `$ xano sandbox get
+Sandbox Environment: (tc24-abcd-x1y2)
+  State: ok
+  License: tier1
+`,
+        `$ xano sandbox get -o json`,
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        output: Flags.string({
+            char: 'o',
+            default: 'summary',
+            description: 'Output format',
+            options: ['summary', 'json'],
+            required: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SandboxGet);
+        const { profile } = this.resolveProfile(flags);
+        try {
+            const tenant = await this.getOrCreateSandbox(profile, flags.verbose);
+            if (flags.output === 'json') {
+                this.log(JSON.stringify(tenant, null, 2));
+            }
+            else {
+                this.log(`Sandbox Environment: ${tenant.display || tenant.name} (${tenant.name})`);
+                if (tenant.state)
+                    this.log(`  State: ${tenant.state}`);
+                if (tenant.xano_domain)
+                    this.log(`  Domain: ${tenant.xano_domain}`);
+                if (tenant.sandbox_expires_at) {
+                    const expiresAt = new Date(tenant.sandbox_expires_at);
+                    if (!isNaN(expiresAt.getTime())) {
+                        const msLeft = expiresAt.getTime() - Date.now();
+                        if (msLeft > 0) {
+                            const minsLeft = Math.ceil(msLeft / 60_000);
+                            this.log(`  Session expires: ${expiresAt.toLocaleString()} (${minsLeft} min remaining)`);
+                        }
+                        else {
+                            this.log(`  Session expires: ${expiresAt.toLocaleString()} (expired)`);
+                        }
+                    }
+                }
+            }
+        }
+        catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
+            if (error instanceof Error) {
+                this.error(`Failed to get sandbox environment: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to get sandbox environment: ${String(error)}`);
+            }
+        }
+    }
+}

package/dist/commands/sandbox/impersonate/index.d.ts

@@ -0,0 +1,5 @@
+import SandboxReview from '../review/index.js';
+export default class SandboxImpersonate extends SandboxReview {
+    static description: string;
+    static hidden: boolean;
+}

package/dist/commands/sandbox/impersonate/index.js

@@ -0,0 +1,5 @@
+import SandboxReview from '../review/index.js';
+export default class SandboxImpersonate extends SandboxReview {
+    static description = 'Alias for "sandbox review"';
+    static hidden = true;
+}

package/dist/commands/{ephemeral → sandbox}/license/get/index.d.ts

@@ -1,8 +1,5 @@
 import BaseCommand from '../../../../base-command.js';
-export default class EphemeralLicenseGet extends BaseCommand {
-    static args: {
-        tenant_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
+export default class SandboxLicenseGet extends BaseCommand {
     static description: string;
     static examples: string[];
     static flags: {

package/dist/commands/sandbox/license/get/index.js

@@ -0,0 +1,78 @@
+import { Flags } from '@oclif/core';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import BaseCommand from '../../../../base-command.js';
+export default class SandboxLicenseGet extends BaseCommand {
+    static description = 'Get the license for a sandbox environment';
+    static examples = [
+        `$ xano sandbox license get
+License saved to license_<tenant>.yaml
+`,
+        `$ xano sandbox license get --file ./my-license.yaml`,
+        `$ xano sandbox license get --view`,
+        `$ xano sandbox license get -o json`,
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        file: Flags.string({
+            char: 'f',
+            description: 'Output file path (default: license_<sandbox_name>.yaml)',
+            required: false,
+        }),
+        output: Flags.string({
+            char: 'o',
+            default: 'summary',
+            description: 'Output format',
+            options: ['summary', 'json'],
+            required: false,
+        }),
+        view: Flags.boolean({
+            default: false,
+            description: 'Print license to stdout instead of saving to file',
+            required: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SandboxLicenseGet);
+        const { profile } = this.resolveProfile(flags);
+        const apiUrl = `${profile.instance_origin}/api:meta/sandbox/license`;
+        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 message = await this.parseApiError(response, 'API request failed');
+                this.error(message);
+            }
+            const license = await response.json();
+            const licenseContent = typeof license === 'string' ? license : JSON.stringify(license, null, 2);
+            if (flags.view || flags.output === 'json') {
+                if (flags.output === 'json') {
+                    this.log(JSON.stringify(license, null, 2));
+                }
+                else {
+                    this.log(licenseContent);
+                }
+            }
+            else {
+                const filePath = path.resolve(flags.file || `license.yaml`);
+                fs.writeFileSync(filePath, licenseContent, 'utf8');
+                this.log(`License saved to ${filePath}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error && 'oclif' in error)
+                throw error;
+            if (error instanceof Error) {
+                this.error(`Failed to get sandbox environment license: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to get sandbox environment license: ${String(error)}`);
+            }
+        }
+    }
+}

package/dist/commands/{ephemeral → sandbox}/license/set/index.d.ts

@@ -1,8 +1,5 @@
 import BaseCommand from '../../../../base-command.js';
-export default class EphemeralLicenseSet extends BaseCommand {
-    static args: {
-        tenant_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
+export default class SandboxLicenseSet extends BaseCommand {
     static description: string;
     static examples: string[];
     static flags: {