@xano/cli 0.0.95-beta.24 → 0.0.95-beta.26

package/README.md

@@ -25,7 +25,7 @@ npm install -g @xano/cli
 
 3. Pull a workspace to local files:
    ```bash
-   xano workspace pull ./my-workspace
+   xano workspace pull
    ```
 
 ## Commands
@@ -108,37 +108,40 @@ xano workspace edit <workspace_id> --require-token       # Require token for doc
 xano workspace delete <workspace_id>
 xano workspace delete <workspace_id> --force
 
-# Pull workspace to local files
-xano workspace pull ./my-workspace
-xano workspace pull ./my-workspace -b dev              # Specific branch
-xano workspace pull ./my-workspace --env --records      # Include env vars and table records
-xano workspace pull ./my-workspace --draft              # Include draft changes
-
-# Push local files to workspace (only changed files by default)
-xano workspace push ./my-workspace
-xano workspace push ./my-workspace -b dev
-xano workspace push ./my-workspace --sync                # Full push — send all files, not just changed ones
-xano workspace push ./my-workspace --sync --delete       # Full push + delete remote objects not included
-xano workspace push ./my-workspace --dry-run             # Preview changes without pushing
-xano workspace push ./my-workspace --records             # Include table records
-xano workspace push ./my-workspace --env                 # Include environment variables
-xano workspace push ./my-workspace --truncate            # Truncate tables before import
-xano workspace push ./my-workspace --no-transaction      # Disable database transaction wrapping
-xano workspace push ./my-workspace --no-guids            # Skip writing GUIDs back to local files
-xano workspace push ./my-workspace --force               # Skip preview and confirmation (for CI/CD)
-xano workspace push ./my-workspace -i "function/*"       # Push only matching files
-xano workspace push ./my-workspace -e "table/*"          # Push all files except tables
-xano workspace push ./my-workspace -i "function/*" -e "**/test*"  # Include functions, exclude tests
-
-# Pull from a git repository to local files
-xano workspace git pull ./output -r https://github.com/owner/repo
-xano workspace git pull ./output -r https://github.com/owner/repo -b main
-xano workspace git pull ./output -r https://github.com/owner/repo/tree/main/path/to/dir
-xano workspace git pull ./output -r https://github.com/owner/repo/blob/main/file.xs
-xano workspace git pull ./output -r git@github.com:owner/repo.git
-xano workspace git pull ./output -r https://gitlab.com/owner/repo/-/tree/master/path
-xano workspace git pull ./output -r https://github.com/owner/private-repo -t ghp_xxx
-xano workspace git pull ./output -r https://github.com/owner/repo --path subdir
+# Pull workspace to local files (defaults to current directory)
+xano workspace pull
+xano workspace pull -d ./my-workspace                    # Specify output directory
+xano workspace pull -b dev                               # Specific branch
+xano workspace pull --env --records                      # Include env vars and table records
+xano workspace pull --draft                              # Include draft changes
+
+# Push local files to workspace (defaults to current directory, only changed files)
+xano workspace push
+xano workspace push -d ./my-workspace                    # Push from a specific directory
+xano workspace push -b dev
+xano workspace push --sync                               # Full push — send all files, not just changed ones
+xano workspace push --sync --delete                      # Full push + delete remote objects not included
+xano workspace push --dry-run                            # Preview changes without pushing
+xano workspace push --records                            # Include table records
+xano workspace push --env                                # Include environment variables
+xano workspace push --truncate                           # Truncate tables before import
+xano workspace push --no-transaction                     # Disable database transaction wrapping
+xano workspace push --no-guids                           # Skip writing GUIDs back to local files
+xano workspace push --force                              # Skip preview and confirmation (for CI/CD)
+xano workspace push -i "function/*"                      # Push only matching files
+xano workspace push -e "table/*"                         # Push all files except tables
+xano workspace push -i "function/*" -e "**/test*"        # Include functions, exclude tests
+
+# Pull from a git repository to local files (defaults to current directory)
+xano workspace git pull -r https://github.com/owner/repo
+xano workspace git pull -d ./output -r https://github.com/owner/repo
+xano workspace git pull -r https://github.com/owner/repo -b main
+xano workspace git pull -r https://github.com/owner/repo/tree/main/path/to/dir
+xano workspace git pull -r https://github.com/owner/repo/blob/main/file.xs
+xano workspace git pull -r git@github.com:owner/repo.git
+xano workspace git pull -r https://gitlab.com/owner/repo/-/tree/master/path
+xano workspace git pull -r https://github.com/owner/private-repo -t ghp_xxx
+xano workspace git pull -r https://github.com/owner/repo --path subdir
 ```
 
 ### Branches
@@ -229,14 +232,16 @@ xano release import --file ./my-release.tar.gz
 xano release delete <release_name>
 xano release delete <release_name> --force
 
-# Pull release to local files
-xano release pull ./my-release -r v1.0
-xano release pull ./my-release -r v1.0 --env --records
+# Pull release to local files (defaults to current directory)
+xano release pull -r v1.0
+xano release pull -d ./my-release -r v1.0
+xano release pull -r v1.0 --env --records
 
-# Push local files as a new release
-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
+# Push local files as a new release (defaults to current directory)
+xano release push -n "v2.0"
+xano release push -d ./my-release -n "v2.0"
+xano release push -n "v2.0" --hotfix --description "Critical fix"
+xano release push -n "v2.0" --no-records --no-env
 
 # Deploy a release to its workspace as a new branch
 xano release deploy "v1.0"
@@ -336,17 +341,19 @@ xano tenant impersonate <tenant_name> -o json
 #### Pull / Push
 
 ```bash
-# Pull tenant to local files
-xano tenant pull ./my-tenant -t <tenant_name>
-xano tenant pull ./my-tenant -t <tenant_name> --env --records
-xano tenant pull ./my-tenant -t <tenant_name> --draft
-
-# Push local files to tenant
-xano tenant push ./my-tenant -t <tenant_name>
-xano tenant push ./my-tenant -t <tenant_name> --records        # Include table records
-xano tenant push ./my-tenant -t <tenant_name> --env            # Include environment variables
-xano tenant push ./my-tenant -t <tenant_name> --truncate
-xano tenant push ./my-tenant -t <tenant_name> --no-transaction # Disable transaction wrapping
+# Pull tenant to local files (defaults to current directory)
+xano tenant pull -t <tenant_name>
+xano tenant pull -d ./my-tenant -t <tenant_name>
+xano tenant pull -t <tenant_name> --env --records
+xano tenant pull -t <tenant_name> --draft
+
+# Push local files to tenant (defaults to current directory)
+xano tenant push -t <tenant_name>
+xano tenant push -d ./my-tenant -t <tenant_name>
+xano tenant push -t <tenant_name> --records                    # Include table records
+xano tenant push -t <tenant_name> --env                        # Include environment variables
+xano tenant push -t <tenant_name> --truncate
+xano tenant push -t <tenant_name> --no-transaction             # Disable transaction wrapping
 ```
 
 #### Deployments
@@ -457,9 +464,27 @@ Manage your sandbox tenant. Each user has a single sandbox tenant that is auto-p
 xano sandbox get
 xano sandbox get -o json
 
-# Push/pull workspace data
-xano sandbox push ./my-workspace
-xano sandbox pull ./my-tenant
+# Pull sandbox to local files (defaults to current directory)
+xano sandbox pull
+xano sandbox pull -d ./my-sandbox
+xano sandbox pull --env --records
+
+# Push local files to sandbox (defaults to current directory, only changed files)
+xano sandbox push
+xano sandbox push -d ./my-workspace                      # Push from a specific directory
+xano sandbox push --sync                                 # Full push — send all files
+xano sandbox push --sync --delete                        # Full push + delete remote objects not included
+xano sandbox push --dry-run                              # Preview changes without pushing
+xano sandbox push --records --env                        # Include records and environment variables
+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)
+xano sandbox review
 
 # Impersonate (open in browser)
 xano sandbox impersonate

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

@@ -127,6 +127,8 @@ Push and open sandbox review in the browser
         const target = {
             buildDryRunUrl: (params) => `${baseUrl}/multidoc/dry-run?${params.toString()}`,
             buildPushUrl: (params) => `${baseUrl}/multidoc?${params.toString()}`,
+            cliVersion: this.config.version,
+            instanceOrigin: profile.instance_origin,
             label: 'sandbox environment',
             supportsBranches: false,
             supportsPartial: false,

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

@@ -161,6 +161,8 @@ Push functions but exclude test files
         const target = {
             buildDryRunUrl: (params) => `${baseUrl}/multidoc/dry-run?${params.toString()}`,
             buildPushUrl: (params) => `${baseUrl}/multidoc?${params.toString()}`,
+            cliVersion: this.config.version,
+            instanceOrigin: profile.instance_origin,
             label: `workspace ${workspaceId}`,
             supportsBranches: true,
             supportsPartial: true,

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

@@ -19,6 +19,10 @@ export interface PushTarget {
     buildDryRunUrl: (queryParams: URLSearchParams) => null | string;
     /** Build the actual push URL */
     buildPushUrl: (queryParams: URLSearchParams) => string;
+    /** CLI version string */
+    cliVersion: string;
+    /** Instance origin URL (e.g., "https://x123-abcd-1234.xano.io") */
+    instanceOrigin: string;
     /** Human-readable label for log messages (e.g., "sandbox environment", "workspace 40") */
     label: string;
     /** Does this target support branches? */

package/dist/utils/multidoc-push.js

@@ -106,9 +106,22 @@ const TYPE_LABELS = {
     workflow_test: 'Workflow Tests',
     workspace: 'Workspace Settings',
 };
-function renderPreview(result, willDelete, targetLabel, verbose, partial, log) {
+function renderPreview(result, willDelete, target, verbose, partial, log) {
     log('');
-    log(ux.colorize('bold', `=== Push Preview: ${targetLabel} ===`));
+    log(ux.colorize('bold', `=== Push Preview: ${target.label} ===`));
+    let instanceHost = target.instanceOrigin;
+    try {
+        instanceHost = new URL(target.instanceOrigin).hostname;
+    }
+    catch { }
+    const contextParts = [
+        `instance: ${instanceHost}`,
+    ];
+    if (result.workspace_name && target.supportsBranches) {
+        contextParts.push(`workspace: ${result.workspace_name}`);
+    }
+    contextParts.push(`cli: v${target.cliVersion}`);
+    log(ux.colorize('dim', `  ${contextParts.join('  |  ')}`));
     if (!partial) {
         log(ux.colorize('red', '  --sync: all documents will be sent, including unchanged'));
     }
@@ -333,7 +346,7 @@ export async function executePush(ctx, target, flags) {
                 method: 'POST',
             }, flags.verbose, accessToken);
             if (!dryRunResponse.ok) {
-                await handleDryRunError(dryRunResponse, command, flags);
+                await handleDryRunError(dryRunResponse, command, flags, target);
                 // If we get here, the user confirmed to proceed without preview
             }
             else {
@@ -341,7 +354,7 @@ export async function executePush(ctx, target, flags) {
                 const preview = JSON.parse(dryRunText);
                 dryRunPreview = preview;
                 if (preview && preview.summary) {
-                    renderPreview(preview, shouldDelete, target.label, flags.verbose, isPartial, log);
+                    renderPreview(preview, shouldDelete, target, flags.verbose, isPartial, log);
                     // Check for bad cross-references using dry-run operations to avoid false positives
                     const badRefs = checkReferences(documentEntries, preview.operations);
                     if (badRefs.length > 0) {
@@ -572,9 +585,22 @@ export async function executePush(ctx, target, flags) {
     log(`Pushed ${pushedCount} documents to ${target.label} from ${relative(process.cwd(), inputDir) || inputDir} in ${elapsed}s`);
 }
 // ── Error Handlers ──────────────────────────────────────────────────────────
-async function handleDryRunError(response, command, flags) {
+async function handleDryRunError(response, command, flags, target) {
     const log = command.log.bind(command);
     if (response.status === 404) {
+        const errorText = await response.text();
+        try {
+            const errorJson = JSON.parse(errorText);
+            if (errorJson.message) {
+                command.error(errorJson.message);
+            }
+        }
+        catch {
+            // Not JSON
+        }
+        if (target.supportsBranches) {
+            command.error('Workspace not found. Check the workspace ID and try again.');
+        }
         log('');
         log(ux.colorize('dim', 'Push preview not yet available on this instance.'));
         log('');
@@ -597,10 +623,7 @@ async function handleDryRunError(response, command, flags) {
                 log('');
                 log(ux.colorize('dim', "Note: Free plan instances don't include sandbox environments, so direct push is always enabled."));
                 log('');
-                // Exit cleanly — this is workspace-specific, but harmless for sandbox since
-                // sandbox won't receive this error
-                command.exit(0);
-                return;
+                process.exit(0);
             }
         }
         catch {

package/dist/utils/reference-checker.js

@@ -196,8 +196,8 @@ function extractSchemaFields(content) {
     if (blockStart < 0 || blockEnd < 0)
         return fields;
     const schemaBlock = content.slice(blockStart, blockEnd);
-    // Match field declarations: "type name" or "type name?" or "type name?=default"
-    const fieldRegex = /^\s*\w+\s+(\w+)[?\s{]/gm;
+    // Match field declarations: "type name" or "type? name" or "type name?=default"
+    const fieldRegex = /^\s*\w+\??\s+(\w+)[?\s{]/gm;
     let match;
     while ((match = fieldRegex.exec(schemaBlock)) !== null) {
         fields.add(match[1]);