@xano/cli 1.0.2-beta.0 → 1.0.2-beta.2

package/README.md

@@ -151,9 +151,10 @@ 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
+# List branches (backup branches are hidden by default)
 xano branch list
 xano branch list -w <workspace_id>
+xano branch list --backups        # include backup branches
 
 # Get branch details
 xano branch get <branch_label>
@@ -481,8 +482,6 @@ xano sandbox push --records --env                        # Include records and e
 xano sandbox push --truncate                             # Truncate tables before import
 xano sandbox push --no-guids                             # Skip writing GUIDs back to local files
 xano sandbox push --force                                # Skip preview and confirmation
-xano sandbox push -i "function/*"                        # Push only matching files
-xano sandbox push -e "table/*"                           # Push all files except tables
 xano sandbox push --review                               # Push and open sandbox review in the browser
 
 # Review (open in browser)

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

@@ -1,8 +1,16 @@
 import BaseCommand from '../../../base-command.js';
+export interface Branch {
+    backup: boolean;
+    created_at: string;
+    label: string;
+    live: boolean;
+}
+export declare function filterBackups(branches: Branch[], includeBackups: boolean): Branch[];
 export default class BranchList extends BaseCommand {
     static description: string;
     static examples: string[];
     static flags: {
+        backups: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         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>;

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

@@ -2,6 +2,9 @@ import { Flags } from '@oclif/core';
 import * as yaml from 'js-yaml';
 import * as fs from 'node:fs';
 import BaseCommand from '../../../base-command.js';
+export function filterBackups(branches, includeBackups) {
+    return includeBackups ? branches : branches.filter((b) => !b.backup);
+}
 export default class BranchList extends BaseCommand {
     static description = 'List all branches in a workspace';
     static examples = [
@@ -15,6 +18,12 @@ Available branches:
 Available branches:
   - v1 (live)
   - feature-auth
+`,
+        `$ xano branch list --backups
+Available branches:
+  - v1 (live)
+  - dev
+  - backup_2024_01_15 (backup)
 `,
         `$ xano branch list --output json
 [
@@ -29,6 +38,11 @@ Available branches:
     ];
     static flags = {
         ...BaseCommand.baseFlags,
+        backups: Flags.boolean({
+            default: false,
+            description: 'Include backup branches in the output',
+            required: false,
+        }),
         output: Flags.string({
             char: 'o',
             default: 'summary',
@@ -82,7 +96,8 @@ Available branches:
                 const errorText = await response.text();
                 this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
             }
-            const branches = await response.json();
+            const allBranches = await response.json();
+            const branches = filterBackups(allBranches, flags.backups);
             // Output results
             if (flags.output === 'json') {
                 this.log(JSON.stringify(branches, null, 2));

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

@@ -7,10 +7,8 @@ export default class SandboxPush extends BaseCommand {
         delete: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         env: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        exclude: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         guids: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        include: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         records: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         review: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         sync: import("@oclif/core/interfaces").BooleanFlag<boolean>;

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

@@ -5,7 +5,7 @@ import open from 'open';
 import BaseCommand from '../../../base-command.js';
 import { executePush } from '../../../utils/multidoc-push.js';
 export default class SandboxPush extends BaseCommand {
-    static description = 'Push local documents to your sandbox environment via multidoc import. By default, only changed files are pushed (partial mode). Use --sync to push all files. Shows a preview of changes before pushing unless --force is specified. Use --dry-run to preview only.';
+    static description = 'Push local documents to your sandbox environment via multidoc import. By default, only changed files are pushed (partial mode). Use --sync to push all files. Shows a preview of changes before pushing unless --force is specified. Use --dry-run to preview only. Include/exclude glob filters are intentionally not supported on sandbox push — partial pushes can hide deletions during review and lead to data loss when promoted to the workspace. Large pushes against a sandbox loaded with a different workspace will prompt for confirmation; run `xano sandbox reset` first to start clean.';
     static examples = [
         `$ xano sandbox push
 Push from current directory (default partial mode)
@@ -27,15 +27,6 @@ Skip preview and push immediately
 `,
         `$ xano sandbox push --records --env`,
         `$ xano sandbox push --truncate`,
-        `$ xano sandbox push -i "**/func*"
-Push only files matching the glob pattern
-`,
-        `$ xano sandbox push -i "function/*" -i "table/*"
-Push files matching multiple patterns
-`,
-        `$ xano sandbox push -e "table/*"
-Push all files except tables
-`,
         `$ xano sandbox push --review
 Push and open sandbox review in the browser
 `,
@@ -63,12 +54,6 @@ Push and open sandbox review in the browser
             description: 'Include environment variables in import',
             required: false,
         }),
-        exclude: Flags.string({
-            char: 'e',
-            description: 'Glob pattern to exclude files (e.g. "table/*", "**/test*"). Matched against relative paths from the push directory.',
-            multiple: true,
-            required: false,
-        }),
         force: Flags.boolean({
             default: false,
             description: 'Skip preview and confirmation prompt (for CI/CD pipelines)',
@@ -80,12 +65,6 @@ Push and open sandbox review in the browser
             description: 'Write server-assigned GUIDs back to local files (use --no-guids to skip)',
             required: false,
         }),
-        include: Flags.string({
-            char: 'i',
-            description: 'Glob pattern to include files (e.g. "**/func*", "table/*.xs"). Matched against relative paths from the push directory.',
-            multiple: true,
-            required: false,
-        }),
         records: Flags.boolean({
             default: false,
             description: 'Include records in import',
@@ -132,15 +111,14 @@ Push and open sandbox review in the browser
             label: 'sandbox environment',
             supportsBranches: false,
             supportsPartial: true,
+            warnOnWorkspaceMismatch: true,
         };
         const pushFlags = {
             delete: flags.delete,
             'dry-run': flags['dry-run'],
             env: flags.env,
-            exclude: flags.exclude,
             force: flags.force,
             guids: flags.guids,
-            include: flags.include,
             records: flags.records,
             sync: flags.sync,
             transaction: flags.transaction,

package/dist/utils/multidoc-push.d.ts

@@ -29,6 +29,12 @@ export interface PushTarget {
     supportsBranches: boolean;
     /** Does this target support the partial query param? */
     supportsPartial: boolean;
+    /**
+     * Warn when the workspace embedded in the local push differs from the workspace currently
+     * loaded on the target (per dry-run). Used by sandbox push because the sandbox is shared
+     * across workspaces and pushing onto a different workspace can leave stale state behind.
+     */
+    warnOnWorkspaceMismatch?: boolean;
 }
 export interface PushContext {
     accessToken: string;
@@ -37,6 +43,17 @@ export interface PushContext {
     inputDir: string;
     verboseFetch: (url: string, options: RequestInit, verbose: boolean, authToken?: string) => Promise<Response>;
 }
+export declare const WORKSPACE_MISMATCH_THRESHOLD = 10;
+/**
+ * Sum all impactful operations in a dry-run summary. `deleted` is only counted when the
+ * caller actually intends to apply deletions (sync mode), matching what the user will see.
+ */
+export declare function countSummaryChanges(summary: Record<string, {
+    created: number;
+    deleted: number;
+    truncated: number;
+    updated: number;
+}>, shouldDelete: boolean): number;
 /**
  * Recursively collect all .xs files from a directory, sorted for deterministic ordering.
  */
@@ -55,6 +72,10 @@ export declare function readDocuments(files: string[]): Array<{
 }>;
 export declare function renderBadReferences(badRefs: BadReference[], log: (msg: string) => void): void;
 export declare function renderBadIndexes(badIndexes: BadIndex[], log: (msg: string) => void): void;
+export declare function findLocalWorkspaceName(entries: Array<{
+    content: string;
+    filePath: string;
+}>): null | string;
 export declare function confirm(message: string): Promise<boolean>;
 /**
  * Execute a multidoc push with preview, validation, partial mode, and GUID sync.

package/dist/utils/multidoc-push.js

@@ -4,6 +4,16 @@ import * as fs from 'node:fs';
 import { join, relative } from 'node:path';
 import { buildDocumentKey, findFilesWithGuid, parseDocument } from './document-parser.js';
 import { checkReferences, checkTableIndexes } from './reference-checker.js';
+// Minimum total operations before a workspace mismatch is treated as worth interrupting for.
+// Small change sets (e.g., editing a single function) aren't worth a reset prompt.
+export const WORKSPACE_MISMATCH_THRESHOLD = 10;
+/**
+ * Sum all impactful operations in a dry-run summary. `deleted` is only counted when the
+ * caller actually intends to apply deletions (sync mode), matching what the user will see.
+ */
+export function countSummaryChanges(summary, shouldDelete) {
+    return Object.values(summary).reduce((sum, c) => sum + c.created + c.updated + (shouldDelete ? c.deleted : 0) + c.truncated, 0);
+}
 // ── File Collection ─────────────────────────────────────────────────────────
 /**
  * Recursively collect all .xs files from a directory, sorted for deterministic ordering.
@@ -211,6 +221,14 @@ function renderPreview(result, willDelete, target, verbose, partial, log) {
     }
     log('');
 }
+export function findLocalWorkspaceName(entries) {
+    for (const entry of entries) {
+        const parsed = parseDocument(entry.content);
+        if (parsed?.type === 'workspace')
+            return parsed.name;
+    }
+    return null;
+}
 // ── Confirmation ────────────────────────────────────────────────────────────
 export async function confirm(message) {
     const readline = await import('node:readline');
@@ -418,6 +436,32 @@ export async function executePush(ctx, target, flags) {
                     if (flags['dry-run']) {
                         return;
                     }
+                    // Warn when the sandbox currently holds a different workspace than the one being
+                    // pushed and the change set is large enough that stale state is a real risk.
+                    if (target.warnOnWorkspaceMismatch && preview.workspace_name) {
+                        const localWorkspaceName = findLocalWorkspaceName(documentEntries);
+                        const totalChanges = countSummaryChanges(preview.summary, shouldDelete);
+                        if (localWorkspaceName &&
+                            localWorkspaceName !== preview.workspace_name &&
+                            totalChanges >= WORKSPACE_MISMATCH_THRESHOLD) {
+                            log('');
+                            log(ux.colorize('yellow', ux.colorize('bold', '=== Workspace Mismatch ===')));
+                            log('');
+                            log(ux.colorize('yellow', `Sandbox currently holds workspace "${preview.workspace_name}", but you're pushing "${localWorkspaceName}" with ${totalChanges} changes.`));
+                            log(ux.colorize('yellow', 'Pushing on top of a different workspace can leave stale data behind. Run `xano sandbox reset` first to start clean.'));
+                            log('');
+                            if (process.stdin.isTTY) {
+                                const proceed = await confirm('Continue with push anyway?');
+                                if (!proceed) {
+                                    log('Push cancelled. Run `xano sandbox reset` then retry.');
+                                    return;
+                                }
+                            }
+                            else {
+                                command.error('Workspace mismatch detected in non-interactive mode. Run `xano sandbox reset` first to start clean.');
+                            }
+                        }
+                    }
                     // Confirm with user
                     const hasDestructive = preview.operations.some((op) => (shouldDelete && (op.action === 'delete' || op.action === 'cascade_delete')) ||
                         op.action === 'truncate' ||