@xano/cli 0.0.95-beta.3 → 0.0.95

package/README.md

@@ -235,11 +235,6 @@ 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
@@ -307,7 +302,8 @@ xano tenant get <tenant_name>
 
 # Create a tenant
 xano tenant create "My Tenant"
-xano tenant create "My Tenant" -d "Description" --cluster_id 1 --platform_id 5
+xano tenant create "My Tenant" -d "Description" --type tier2 --cluster_id 1 --platform_id 5
+xano tenant create "My Tenant" --type tier2 --cluster_id 1 --license ./license.yaml
 
 # Edit a tenant
 xano tenant edit <tenant_name> --display "New Name" -d "New description"
@@ -445,27 +441,6 @@ xano tenant cluster license set <cluster_id>
 xano tenant cluster license set <cluster_id> --file ./kubeconfig.yaml
 ```
 
-### Sandbox
-
-Manage your sandbox tenant. Each user has a single sandbox tenant that is auto-provisioned on first use.
-
-```bash
-# Get your sandbox tenant (creates if needed)
-xano sandbox get
-xano sandbox get -o json
-
-# Push/pull workspace data
-xano sandbox push ./my-workspace
-xano sandbox pull ./my-tenant
-
-# Impersonate (open in browser)
-xano sandbox impersonate
-
-# Reset all workspace data
-xano sandbox reset
-xano sandbox reset --force
-```
-
 ### Static Hosts
 
 ```bash

package/dist/base-command.d.ts

@@ -14,16 +14,6 @@ export interface CredentialsFile {
     };
 }
 export declare function buildUserAgent(version: string): string;
-export interface SandboxTenant {
-    created_at?: string;
-    description?: string;
-    display?: string;
-    ephemeral?: boolean;
-    id: number;
-    name: string;
-    state?: string;
-    xano_domain?: string;
-}
 export default abstract class BaseCommand extends Command {
     static baseFlags: {
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
@@ -48,20 +38,6 @@ export default abstract class BaseCommand extends Command {
      * Load and parse the credentials file. Returns null if the file doesn't exist.
      */
     protected loadCredentialsFile(): CredentialsFile | null;
-    /**
-     * Get or create the singleton sandbox environment for the authenticated user.
-     * Returns the sandbox object (existing or newly created).
-     */
-    protected getOrCreateSandbox(profile: ProfileConfig, verbose: boolean): Promise<SandboxTenant>;
-    /**
-     * Resolve profile from flags, validating instance_origin and access_token exist.
-     */
-    protected resolveProfile(flags: {
-        profile?: string;
-    }): {
-        profile: ProfileConfig;
-        profileName: string;
-    };
     /**
      * Make an HTTP request with optional verbose logging.
      * Use this for all Metadata API calls to support the --verbose flag.

package/dist/base-command.js

@@ -103,43 +103,6 @@ export default class BaseCommand extends Command {
         }
         return null;
     }
-    /**
-     * Get or create the singleton sandbox environment for the authenticated user.
-     * Returns the sandbox object (existing or newly created).
-     */
-    async getOrCreateSandbox(profile, verbose) {
-        const apiUrl = `${profile.instance_origin}/api:meta/sandbox/me`;
-        const response = await this.verboseFetch(apiUrl, {
-            headers: {
-                accept: 'application/json',
-                Authorization: `Bearer ${profile.access_token}`,
-            },
-            method: 'GET',
-        }, verbose, profile.access_token);
-        if (!response.ok) {
-            const errorText = await response.text();
-            this.error(`Failed to get sandbox environment: ${response.status} ${response.statusText}\n${errorText}`);
-        }
-        return (await response.json());
-    }
-    /**
-     * Resolve profile from flags, validating instance_origin and access_token exist.
-     */
-    resolveProfile(flags) {
-        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`);
-        }
-        return { profile, profileName };
-    }
     /**
      * Make an HTTP request with optional verbose logging.
      * Use this for all Metadata API calls to support the --verbose flag.

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

@@ -9,10 +9,12 @@ export default class TenantCreate extends BaseCommand {
         cluster_id: import("@oclif/core/interfaces").OptionFlag<number | undefined, 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>;
+        ephemeral: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         ingress: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        license: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        license: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         platform_id: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        type: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         tasks: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

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

@@ -16,7 +16,8 @@ export default class TenantCreate extends BaseCommand {
         `$ xano tenant create "Production"
 Created tenant: Production (production) - ID: 42
 `,
-        `$ xano tenant create "Staging" --description "Staging env" --cluster_id 1 --platform_id 1 --license tier2 -o json`,
+        `$ xano tenant create "Staging" --description "Staging env" --cluster_id 1 --platform_id 1 --type tier2 -o json`,
+        `$ xano tenant create "Staging" --type tier2 --cluster_id 1 --license ./license.yaml`,
     ];
     static flags = {
         ...BaseCommand.baseFlags,
@@ -33,15 +34,18 @@ Created tenant: Production (production) - ID: 42
             description: 'Custom domain for the tenant',
             required: false,
         }),
+        ephemeral: Flags.boolean({
+            default: false,
+            description: 'Mark tenant as ephemeral (allows push operations)',
+        }),
         ingress: Flags.boolean({
             allowNo: true,
             default: true,
             description: 'Enable ingress',
         }),
         license: Flags.string({
-            default: 'tier1',
-            description: 'License tier',
-            options: ['tier1', 'tier2', 'tier3'],
+            char: 'l',
+            description: 'Path to a license override file to apply during creation',
             required: false,
         }),
         output: Flags.string({
@@ -55,6 +59,12 @@ Created tenant: Production (production) - ID: 42
             description: 'Platform ID to use',
             required: false,
         }),
+        type: Flags.string({
+            default: 'tier1',
+            description: 'Tenant type',
+            options: ['tier1', 'tier2', 'tier3'],
+            required: false,
+        }),
         tasks: Flags.boolean({
             allowNo: true,
             default: true,
@@ -87,8 +97,9 @@ Created tenant: Production (production) - ID: 42
         }
         const body = {
             display: args.display,
+            ephemeral: flags.ephemeral,
             ingress: flags.ingress,
-            license: flags.license,
+            license: flags.type,
             tag: [],
             tasks: flags.tasks,
         };
@@ -102,7 +113,16 @@ Created tenant: Production (production) - ID: 42
             body.platform_id = flags.platform_id;
         if (flags.domain)
             body.domain = flags.domain;
-        if (flags.license === 'tier2' || flags.license === 'tier3' || flags.cluster_id) {
+        if (flags.license) {
+            const licensePath = path.resolve(flags.license);
+            if (!fs.existsSync(licensePath)) {
+                this.error(`License file not found: ${licensePath}`);
+            }
+            const licenseContent = fs.readFileSync(licensePath, 'utf8');
+            body.license_overrides = yaml.load(licenseContent);
+        }
+        const effectiveType = flags.cluster_id ? 'tier3' : flags.type;
+        if (effectiveType === 'tier2' || effectiveType === 'tier3') {
             this.warn('This may take a few minutes. Please be patient.');
         }
         const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/tenant`;
@@ -129,6 +149,8 @@ Created tenant: Production (production) - ID: 42
                 if (tenant.state) {
                     this.log(`  State: ${tenant.state}`);
                 }
+                if (flags.license)
+                    this.log(`  License: applied`);
             }
         }
         catch (error) {

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

@@ -99,8 +99,8 @@ Tenant: My Tenant (my-tenant)
                     this.log(`  Tasks: ${tenant.tasks}`);
                 if (tenant.ingress !== undefined)
                     this.log(`  Ingress: ${tenant.ingress}`);
-                if (tenant.type)
-                    this.log(`  Type: ${tenant.type}`);
+                if (tenant.ephemeral)
+                    this.log(`  Ephemeral: ${tenant.ephemeral}`);
                 if (tenant.deployed_at) {
                     const d = new Date(tenant.deployed_at);
                     const deployedDate = Number.isNaN(d.getTime()) ? tenant.deployed_at : d.toISOString().split('T')[0];

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

@@ -92,8 +92,8 @@ Tenants in workspace 5:
                     for (const tenant of tenants) {
                         const state = tenant.state ? ` [${tenant.state}]` : '';
                         const license = tenant.license ? ` - ${tenant.license}` : '';
-                        const typeLabel = tenant.type && tenant.type !== 'standard' ? ` [${tenant.type}]` : '';
-                        this.log(`  - ${tenant.display || tenant.name} (${tenant.name})${state}${license}${typeLabel}`);
+                        const ephemeral = tenant.ephemeral ? ' [ephemeral]' : '';
+                        this.log(`  - ${tenant.display || tenant.name} (${tenant.name})${state}${license}${ephemeral}`);
                         if (tenant.cluster?.name)
                             this.log(`      Cluster: ${tenant.cluster.name}`);
                         const releaseName = typeof tenant.release === 'string' ? tenant.release : tenant.release?.name;

package/dist/commands/tenant/push/index.js

@@ -100,6 +100,40 @@ Truncate all table records before importing
                 `  2. Set it in your profile using: xano profile:edit ${profileName} -w <workspace_id>`);
         }
         const tenantName = flags.tenant;
+        // Fetch tenant details and verify it's ephemeral
+        const tenantApiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/tenant/${tenantName}`;
+        try {
+            const tenantResponse = await this.verboseFetch(tenantApiUrl, {
+                headers: {
+                    accept: 'application/json',
+                    Authorization: `Bearer ${profile.access_token}`,
+                },
+                method: 'GET',
+            }, flags.verbose, profile.access_token);
+            if (!tenantResponse.ok) {
+                const errorText = await tenantResponse.text();
+                this.error(`Failed to fetch tenant '${tenantName}' (${tenantResponse.status}): ${errorText}`);
+            }
+            const tenantData = (await tenantResponse.json());
+            if (!tenantData.ephemeral) {
+                this.error(`Tenant '${tenantName}' is not ephemeral. Push is only allowed for ephemeral tenants.\n` +
+                    `Create an ephemeral tenant with: xano tenant create "name" --ephemeral`);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('is not ephemeral')) {
+                throw error;
+            }
+            if (error instanceof Error && error.message.includes('Failed to fetch tenant')) {
+                throw error;
+            }
+            if (error instanceof Error) {
+                this.error(`Failed to verify tenant: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to verify tenant: ${String(error)}`);
+            }
+        }
         // Resolve the input directory
         const inputDir = path.resolve(args.directory);
         if (!fs.existsSync(inputDir)) {

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

@@ -282,24 +282,6 @@ Push functions but exclude test files
                     }
                     else {
                         const errorText = await dryRunResponse.text();
-                        // Check if push is disabled on this workspace
-                        try {
-                            const errorJson = JSON.parse(errorText);
-                            if (errorJson.message?.includes('Push is disabled')) {
-                                this.log('');
-                                this.log(ux.colorize('red', ux.colorize('bold', 'Direct push to this workspace is disabled.')));
-                                this.log(ux.colorize('dim', 'To apply changes to the workspace, use the sandbox review flow:'));
-                                this.log(`  ${ux.colorize('cyan', 'xano sandbox push')}    ${ux.colorize('dim', '— push changes to your sandbox')}`);
-                                this.log(`  ${ux.colorize('cyan', 'xano sandbox review')}  ${ux.colorize('dim', '— edit any logic, inspect the snapshot diff, and promote changes to the workspace')}`);
-                                this.log('');
-                                this.log(ux.colorize('dim', 'To enable direct push, go to Workspace Settings → CLI → Allow Direct Workspace Push.'));
-                                this.log('');
-                                return;
-                            }
-                        }
-                        catch {
-                            // Not JSON, fall through
-                        }
                         this.warn(`Push preview failed (${dryRunResponse.status}). Skipping preview.`);
                         if (flags.verbose) {
                             this.log(ux.colorize('dim', errorText));
@@ -483,14 +465,6 @@ Push functions but exclude test files
                     if (errorJson.payload?.param) {
                         errorMessage += `\n  Parameter: ${errorJson.payload.param}`;
                     }
-                    // Provide clear guidance when push is disabled
-                    if (errorJson.message?.includes('Push is disabled')) {
-                        this.error(`Push is disabled for this workspace.\n\n` +
-                            `To enable, go to Workspace Settings and turn on "Allow Push".\n\n` +
-                            `Alternatively, use sandbox commands:\n` +
-                            `  xano sandbox push ${args.directory}\n` +
-                            `  xano sandbox impersonate`);
-                    }
                 }
                 catch {
                     errorMessage += `\n${errorText}`;

package/dist/help.d.ts

@@ -12,10 +12,9 @@ declare class CustomCommandHelp extends BaseCommandHelp {
     protected flagHelpLabel(flag: Command.Flag.Any, showOptions?: boolean): string;
 }
 /**
- * Custom Help class that injects promoted commands into the COMMANDS list
+ * Custom Help class that uses CustomCommandHelp
  */
 export default class Help extends BaseHelp {
     protected CommandHelpClass: typeof CustomCommandHelp;
-    formatCommands(commands: Command.Loadable[]): string;
 }
 export {};

package/dist/help.js

@@ -1,15 +1,5 @@
 import { Help as BaseHelp } from '@oclif/core';
 import { CommandHelp as BaseCommandHelp } from '@oclif/core/help';
-/**
- * Extra commands to include in the top-level COMMANDS list.
- * These are nested commands promoted for discoverability.
- */
-const PROMOTED_COMMANDS = [
-    { description: 'Create a new workspace', label: 'workspace create' },
-    { description: 'List workspaces', label: 'workspace list' },
-    { description: 'Pull a workspace to local files', label: 'workspace pull' },
-    { description: 'Push local documents to a workspace', label: 'workspace push' },
-];
 /**
  * Custom CommandHelp class that extends the default to display environment variables
  * alongside flag descriptions
@@ -29,36 +19,8 @@ class CustomCommandHelp extends BaseCommandHelp {
     }
 }
 /**
- * Custom Help class that injects promoted commands into the COMMANDS list
+ * Custom Help class that uses CustomCommandHelp
  */
 export default class Help extends BaseHelp {
     CommandHelpClass = CustomCommandHelp;
-    formatCommands(commands) {
-        if (commands.length === 0 && PROMOTED_COMMANDS.length === 0)
-            return '';
-        // Check before IDs are mutated: root help has top-level commands (no colons)
-        const isRootHelp = commands.some((c) => !c.id.includes(':'));
-        const entries = commands
-            .filter((c) => (this.opts.hideAliasesFromRoot ? !c.aliases?.includes(c.id) : true))
-            .filter((c) => c.id !== 'plugins')
-            .map((c) => {
-            if (this.config.topicSeparator !== ':')
-                c.id = c.id.replaceAll(':', this.config.topicSeparator);
-            const summary = this.summary(c);
-            return [c.id, summary ? summary.replace(/\u001B\[\d+m/g, '') : ''];
-        });
-        // Only add promoted commands at the root level, not within a specific topic
-        if (isRootHelp) {
-            for (const promoted of PROMOTED_COMMANDS) {
-                entries.push([promoted.label, promoted.description]);
-            }
-        }
-        entries.sort((a, b) => a[0].localeCompare(b[0]));
-        const body = this.renderList(entries, {
-            indentation: 2,
-            spacer: '\n',
-            stripAnsi: this.opts.stripAnsi,
-        });
-        return this.section('COMMANDS', body + `\n\n\x1b[2mSee xano <topic> --help for all commands in a topic.\x1b[0m`);
-    }
 }