@xano/cli 0.0.95-beta.16 → 0.0.95-beta.19

package/README.md

@@ -145,6 +145,8 @@ xano workspace git pull ./output -r https://github.com/owner/repo --path subdir
 
 All branch commands use **branch labels** (e.g., `v1`, `dev`), not IDs.
 
+The `v1` branch is the default branch and always exists. It cannot be created, edited, or deleted.
+
 ```bash
 # List branches
 xano branch list
@@ -153,9 +155,9 @@ xano branch list
 xano branch get <branch_label>
 
 # Create a branch
-xano branch create --label dev
-xano branch create -l feature-auth -s dev -d "Auth feature"
-xano branch create -l staging --color "#ebc346"
+xano branch create dev
+xano branch create feature-auth -s dev -d "Auth feature"
+xano branch create staging --color "#ebc346"
 
 # Edit a branch
 xano branch edit <branch_label> --label "new-label"

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

@@ -1,11 +1,13 @@
 import BaseCommand from '../../../base-command.js';
 export default class BranchCreate extends BaseCommand {
     static description: string;
+    static args: {
+        label: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
     static examples: string[];
     static flags: {
         color: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        label: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         source: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         workspace: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;

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

@@ -1,4 +1,4 @@
-import { Flags } from '@oclif/core';
+import { Args, Flags } from '@oclif/core';
 import * as yaml from 'js-yaml';
 import * as fs from 'node:fs';
 import * as os from 'node:os';
@@ -6,17 +6,23 @@ import * as path from 'node:path';
 import BaseCommand from '../../../base-command.js';
 export default class BranchCreate extends BaseCommand {
     static description = 'Create a new branch by cloning from an existing branch';
+    static args = {
+        label: Args.string({
+            description: 'Label for the new branch',
+            required: true,
+        }),
+    };
     static examples = [
-        `$ xano branch create --label dev
+        `$ xano branch create dev
 Created branch: dev
   Cloned from: v1
 `,
-        `$ xano branch create -l feature-auth -s dev -d "Authentication feature"
+        `$ xano branch create feature-auth -s dev -d "Authentication feature"
 Created branch: feature-auth
   Cloned from: dev
   Description: Authentication feature
 `,
-        `$ xano branch create --label staging --color "#ebc346" --output json
+        `$ xano branch create staging --color "#ebc346" --output json
 {
   "created_at": "2024-02-11T10:00:00Z",
   "label": "staging",
@@ -37,11 +43,6 @@ Created branch: feature-auth
             description: 'Description for the new branch',
             required: false,
         }),
-        label: Flags.string({
-            char: 'l',
-            description: 'Label for the new branch',
-            required: true,
-        }),
         output: Flags.string({
             char: 'o',
             default: 'summary',
@@ -62,7 +63,7 @@ Created branch: feature-auth
         }),
     };
     async run() {
-        const { flags } = await this.parse(BranchCreate);
+        const { args, flags } = await this.parse(BranchCreate);
         // Get profile name (default or from flag/env)
         const profileName = flags.profile || this.getDefaultProfile();
         // Load credentials
@@ -84,11 +85,15 @@ Created branch: feature-auth
         const workspaceId = flags.workspace || profile.workspace;
         if (!workspaceId) {
             this.error('No workspace ID provided. Either use --workspace flag or set one in your profile.\n' +
-                'Usage: xano branch create --label <label> [--workspace <workspace_id>]');
+                'Usage: xano branch create <label> [--workspace <workspace_id>]');
+        }
+        // Validate reserved branch names
+        if (args.label.toLowerCase() === 'v1') {
+            this.error("Cannot create a branch named 'v1'. This is the default branch and always exists.");
         }
         // Build request body
         const body = {
-            label: flags.label,
+            label: args.label,
             source_branch: flags.source,
         };
         if (flags.description) {
@@ -104,8 +109,8 @@ Created branch: feature-auth
             const response = await this.verboseFetch(apiUrl, {
                 body: JSON.stringify(body),
                 headers: {
-                    'accept': 'application/json',
-                    'Authorization': `Bearer ${profile.access_token}`,
+                    accept: 'application/json',
+                    Authorization: `Bearer ${profile.access_token}`,
                     'Content-Type': 'application/json',
                 },
                 method: 'POST',
@@ -114,7 +119,7 @@ Created branch: feature-auth
                 const errorText = await response.text();
                 this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
             }
-            const branch = await response.json();
+            const branch = (await response.json());
             // Output results
             if (flags.output === 'json') {
                 this.log(JSON.stringify(branch, null, 2));
@@ -145,8 +150,7 @@ Created branch: feature-auth
         const credentialsPath = path.join(configDir, 'credentials.yaml');
         // Check if credentials file exists
         if (!fs.existsSync(credentialsPath)) {
-            this.error(`Credentials file not found at ${credentialsPath}\n` +
-                `Create a profile using 'xano profile create'`);
+            this.error(`Credentials file not found at ${credentialsPath}\n` + `Create a profile using 'xano profile create'`);
         }
         // Read credentials file
         try {

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

@@ -159,8 +159,7 @@ Pushed 42 documents to sandbox environment from ./my-workspace
         this.log('');
         this.log(ux.colorize('red', ux.colorize('bold', '=== CRITICAL: Invalid Indexes ===')));
         this.log('');
-        this.log(ux.colorize('red', 'The following tables have indexes referencing fields that do not exist in the schema.'));
-        this.log(ux.colorize('red', 'These will cause the import to fail.'));
+        this.log(ux.colorize('red', 'The following tables have indexed referencing fields that do not exist in the schema, which may cause related issues.'));
         this.log('');
         for (const idx of badIndexes) {
             this.log(`  ${ux.colorize('red', 'CRITICAL'.padEnd(16))} ${'table'.padEnd(18)} ${idx.table}`);

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

@@ -288,13 +288,16 @@ Push functions but exclude test files
                             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('red', ux.colorize('bold', 'Direct push is disabled to protect your production workspace from unintended changes.')));
+                                this.log(ux.colorize('dim', 'Use your sandbox environment to test and review changes before applying them to your production workspace.'));
+                                this.log('');
                                 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(ux.colorize('dim', 'Note: This setting does not apply to Free plan instances.'));
+                                this.log('');
+                                this.log(ux.colorize('dim', "Note: Free plan instances don't include sandbox environments, so direct push is always enabled."));
                                 this.log('');
                                 return;
                             }
@@ -505,12 +508,13 @@ Push functions but exclude test files
                     }
                     // 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` +
-                            `Note: This setting does not apply to Free plan instances.\n\n` +
+                        this.error(`Direct push is disabled to protect your production workspace from unintended changes.\n` +
+                            `Use your sandbox environment to test and review changes before applying them to your production workspace.\n\n` +
                             `Alternatively, use sandbox commands:\n` +
                             `  xano sandbox push ${args.directory}\n` +
-                            `  xano sandbox impersonate`);
+                            `  xano sandbox review\n\n` +
+                            `To enable direct push, go to Workspace Settings → CLI → Allow Direct Workspace Push.\n\n` +
+                            `Note: Free plan instances don't include sandbox environments, so direct push is always enabled.`);
                     }
                 }
                 catch {
@@ -760,8 +764,7 @@ Push functions but exclude test files
         this.log('');
         this.log(ux.colorize('red', ux.colorize('bold', '=== CRITICAL: Invalid Indexes ===')));
         this.log('');
-        this.log(ux.colorize('red', 'The following tables have indexes referencing fields that do not exist in the schema.'));
-        this.log(ux.colorize('red', 'These will cause the import to fail.'));
+        this.log(ux.colorize('red', 'The following tables have indexed referencing fields that do not exist in the schema, which may cause related issues.'));
         this.log('');
         for (const idx of badIndexes) {
             this.log(`  ${ux.colorize('red', 'CRITICAL'.padEnd(16))} ${'table'.padEnd(18)} ${idx.table}`);