@xano/cli 1.0.3-beta.8 → 1.0.3

package/dist/commands/static_host/build/create/index.js

@@ -2,42 +2,20 @@ import { Args, Flags } from '@oclif/core';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import BaseCommand from '../../../../base-command.js';
-const pad2 = (n) => String(n).padStart(2, '0');
-/**
- * Generate a default build name from a compact timestamp: `YYYYMMDD-HHmmss`
- * (e.g. `20260531-143022`). Sortable, distinct down to the second, and uses
- * local time so it lines up with when the user ran the command.
- */
-export function generateBuildName(date = new Date()) {
-    const y = date.getFullYear();
-    const mo = pad2(date.getMonth() + 1);
-    const d = pad2(date.getDate());
-    const h = pad2(date.getHours());
-    const mi = pad2(date.getMinutes());
-    const s = pad2(date.getSeconds());
-    return `${y}${mo}${d}-${h}${mi}${s}`;
-}
 export default class StaticHostBuildCreate extends BaseCommand {
-    static hidden = true;
     static args = {
         static_host: Args.string({
             description: 'Static Host name',
             required: true,
         }),
     };
-    static description = '[Deprecated: use "static_host build push -f <file>" instead] Create a new build from a zip file';
+    static description = 'Create a new build for a static host';
     static examples = [
         `$ xano static_host:build:create default -f ./build.zip -n "v1.0.0"
 Build created successfully!
 ID: 123
 Name: v1.0.0
 Status: pending
-`,
-        `$ xano static_host:build:create default -f ./build.zip
-Build created successfully!
-ID: 123
-Name: 20260531-143022
-Status: pending
 `,
         `$ xano static_host:build:create default -w 40 -f ./dist.zip -n "production" -d "Production build"
 Build created successfully!
@@ -67,13 +45,8 @@ Description: Production build
         }),
         name: Flags.string({
             char: 'n',
-            description: 'Build name (auto-generated from the current timestamp if omitted)',
-            required: false,
-        }),
-        'no-wait': Flags.boolean({
-            default: false,
-            description: 'Return immediately after upload instead of waiting for the build to finish',
-            required: false,
+            description: 'Build name',
+            required: true,
         }),
         output: Flags.string({
             char: 'o',
@@ -89,7 +62,6 @@ Description: Production build
         }),
     };
     async run() {
-        this.warn('`static_host build create` is deprecated. Use `static_host build push -f <file>` instead.');
         const { args, flags } = await this.parse(StaticHostBuildCreate);
         const { profile, profileName } = this.resolveProfile(flags);
         // Determine workspace_id from flag or profile
@@ -130,10 +102,7 @@ Description: Production build
         const fileBuffer = fs.readFileSync(filePath);
         const blob = new Blob([fileBuffer], { type: 'application/zip' });
         formData.append('file', blob, path.basename(filePath));
-        // Name is optional — fall back to a timestamped name so builds can be
-        // created without thinking up a label each time.
-        const buildName = flags.name ?? generateBuildName();
-        formData.append('name', buildName);
+        formData.append('name', flags.name);
         if (flags.description) {
             formData.append('description', flags.description);
         }
@@ -172,25 +141,6 @@ Description: Production build
                     this.log(`Description: ${flags.description}`);
                 }
             }
-            // Async (package.json) builds keep running after upload. Unless --no-wait,
-            // poll until the build finishes so the CLI mirrors the UI's progress.
-            const inProgress = result.status !== undefined && !['error', 'ok'].includes(result.status);
-            if (inProgress && !flags['no-wait']) {
-                const finalStatus = await this.waitForBuild({
-                    buildId: result.id,
-                    profile,
-                    quiet: flags.output === 'json',
-                    staticHost: args.static_host,
-                    verbose: flags.verbose,
-                    workspaceId,
-                });
-                if (finalStatus === 'error') {
-                    this.error(`Build ${result.id} failed (status: error). Check the build log with: xano static_host build get ${args.static_host} --build_id ${result.id}`);
-                }
-            }
-            if (flags.output !== 'json') {
-                await this.logStaticHostUrls({ profile, staticHost: args.static_host, verbose: flags.verbose, workspaceId });
-            }
         }
         catch (error) {
             if (error instanceof Error) {

package/dist/commands/static_host/build/get/index.d.ts

@@ -1,12 +1,12 @@
 import BaseCommand from '../../../../base-command.js';
 export default class StaticHostBuildGet extends BaseCommand {
     static args: {
+        build_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
         static_host: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
     static description: string;
     static examples: string[];
     static flags: {
-        build_id: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         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/static_host/build/get/index.js

@@ -2,6 +2,10 @@ import { Args, Flags } from '@oclif/core';
 import BaseCommand from '../../../../base-command.js';
 export default class StaticHostBuildGet extends BaseCommand {
     static args = {
+        build_id: Args.string({
+            description: 'Build ID',
+            required: true,
+        }),
         static_host: Args.string({
             description: 'Static Host name',
             required: true,
@@ -9,24 +13,24 @@ export default class StaticHostBuildGet extends BaseCommand {
     };
     static description = 'Get details of a specific build for a static host';
     static examples = [
-        `$ xano static_host:build:get default --build_id 52
+        `$ xano static_host:build:get default 52
 Build Details:
 ID: 52
 Name: v1.0.0
 Status: completed
 `,
-        `$ xano static_host:build:get default --build_id 52 -w 40
+        `$ xano static_host:build:get default 52 -w 40
 Build Details:
 ID: 52
 Name: v1.0.0
 Status: completed
 `,
-        `$ xano static_host:build:get myhost --build_id 123 --profile production
+        `$ xano static_host:build:get myhost 123 --profile production
 Build Details:
 ID: 123
 Name: production-build
 `,
-        `$ xano static_host:build:get default --build_id 52 -o json
+        `$ xano static_host:build:get default 52 -o json
 {
   "id": 52,
   "name": "v1.0.0",
@@ -36,10 +40,6 @@ Name: production-build
     ];
     static flags = {
         ...BaseCommand.baseFlags,
-        build_id: Flags.string({
-            description: 'Build ID',
-            required: true,
-        }),
         output: Flags.string({
             char: 'o',
             default: 'summary',
@@ -66,11 +66,11 @@ Name: production-build
         }
         else {
             this.error(`Workspace ID is required. Either:\n` +
-                `  1. Provide it as a flag: xano static_host:build:get <static_host> --build_id <id> -w <workspace_id>\n` +
+                `  1. Provide it as a flag: xano static_host:build:get <static_host> <build_id> -w <workspace_id>\n` +
                 `  2. Set it in your profile using: xano profile:edit ${profileName} -w <workspace_id>`);
         }
         // Construct the API URL
-        const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/static_host/${args.static_host}/build/${flags.build_id}`;
+        const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/static_host/${args.static_host}/build/${args.build_id}`;
         // Fetch build from the API
         try {
             const response = await this.verboseFetch(apiUrl, {
@@ -104,12 +104,6 @@ Name: production-build
                 if (build.status) {
                     this.log(`Status: ${build.status}`);
                 }
-                if (typeof build.file_count === 'number') {
-                    this.log(`Files: ${build.file_count}`);
-                }
-                if (typeof build.file_bytes === 'number') {
-                    this.log(`Size: ${build.file_bytes} bytes`);
-                }
                 if (build.created_at) {
                     this.log(`Created: ${build.created_at}`);
                 }

package/dist/utils/multidoc-push.js

@@ -476,7 +476,6 @@ export async function executePush(ctx, target, flags) {
                     }
                     // 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.
-                    let mismatchConfirmed = false;
                     if (target.warnOnWorkspaceMismatch && preview.workspace_name) {
                         const localWorkspaceName = findLocalWorkspaceName(documentEntries);
                         const totalChanges = countSummaryChanges(preview.summary, shouldDelete);
@@ -495,33 +494,30 @@ export async function executePush(ctx, target, flags) {
                                     log('Push cancelled. Run `xano sandbox reset` then retry.');
                                     return;
                                 }
-                                mismatchConfirmed = true;
                             }
                             else {
                                 command.error('Workspace mismatch detected in non-interactive mode. Run `xano sandbox reset` first to start clean.');
                             }
                         }
                     }
-                    // Confirm with user (skip if workspace mismatch prompt already obtained confirmation)
-                    if (!mismatchConfirmed) {
-                        const hasDestructive = preview.operations.some((op) => (shouldDelete && (op.action === 'delete' || op.action === 'cascade_delete')) ||
-                            op.action === 'truncate' ||
-                            op.action === 'drop_field' ||
-                            op.action === 'alter_field');
-                        const message = hasDestructive
-                            ? 'Proceed with push? This includes DESTRUCTIVE operations listed above.'
-                            : 'Proceed with push?';
-                        if (process.stdin.isTTY) {
-                            const confirmed = await confirm(message);
-                            if (!confirmed) {
-                                log('Push cancelled.');
-                                return;
-                            }
-                        }
-                        else {
-                            command.error('Non-interactive environment detected. Use --force to skip confirmation.');
+                    // Confirm with user
+                    const hasDestructive = preview.operations.some((op) => (shouldDelete && (op.action === 'delete' || op.action === 'cascade_delete')) ||
+                        op.action === 'truncate' ||
+                        op.action === 'drop_field' ||
+                        op.action === 'alter_field');
+                    const message = hasDestructive
+                        ? 'Proceed with push? This includes DESTRUCTIVE operations listed above.'
+                        : 'Proceed with push?';
+                    if (process.stdin.isTTY) {
+                        const confirmed = await confirm(message);
+                        if (!confirmed) {
+                            log('Push cancelled.');
+                            return;
                         }
                     }
+                    else {
+                        command.error('Non-interactive environment detected. Use --force to skip confirmation.');
+                    }
                 }
                 else {
                     // Server returned unexpected response
@@ -593,7 +589,7 @@ export async function executePush(ctx, target, flags) {
             }
             catch {
                 if (flags.verbose) {
-                    log(`Server response is not JSON; skipping GUID sync\n${responseText}`);
+                    log('Server response is not JSON; skipping GUID sync');
                 }
             }
         }
@@ -645,18 +641,89 @@ export async function executePush(ctx, target, flags) {
     catch (error) {
         if (error instanceof Error && 'oclif' in error)
             throw error;
-        if (error instanceof Error) {
-            command.error(`Failed to push multidoc: ${error.message}`);
-        }
-        else {
-            command.error(`Failed to push multidoc: ${String(error)}`);
-        }
+        const elapsedMs = Date.now() - startTime;
+        command.error(`Failed to push multidoc: ${describeNetworkError(error, apiUrl, elapsedMs)}`);
     }
     const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
     const pushedCount = multidoc.split('\n---\n').length;
     log(`Pushed ${pushedCount} documents to ${target.label} from ${relative(process.cwd(), inputDir) || inputDir} in ${elapsed}s`);
 }
 // ── Error Handlers ──────────────────────────────────────────────────────────
+/**
+ * Turn a thrown fetch/network error into an actionable message.
+ *
+ * Node's native fetch throws a TypeError with the unhelpful message "fetch
+ * failed" for all transport-level failures (DNS, connection refused, TLS,
+ * resets, timeouts). The real reason lives in `error.cause` as a system error
+ * with a `code` (ECONNREFUSED, ENOTFOUND, ETIMEDOUT, etc.). This unwraps it so
+ * the user sees what actually went wrong and where.
+ *
+ * `elapsedMs` is appended so the user can see how long the request ran before
+ * failing — a failure landing near a round boundary (e.g. ~300s) is a strong
+ * signal of a server-side or proxy timeout rather than a local network blip.
+ */
+function describeNetworkError(error, url, elapsedMs) {
+    if (!(error instanceof Error))
+        return String(error);
+    let host = url;
+    try {
+        host = new URL(url).host;
+    }
+    catch { }
+    // AbortSignal.timeout() fires our explicit request-timeout ceiling.
+    if (error.name === 'TimeoutError' || error.name === 'AbortError') {
+        return `request to ${host} exceeded the CLI timeout. Raise it with XANO_CLI_REQUEST_TIMEOUT_MS (ms; 0 disables), or split the push into smaller batches.${formatFailureDuration(elapsedMs)}`;
+    }
+    const { cause } = error;
+    const code = cause && typeof cause === 'object' && 'code' in cause ? String(cause.code) : undefined;
+    const causeMessage = cause instanceof Error ? cause.message : undefined;
+    const hints = {
+        ECONNREFUSED: `Connection refused by ${host}. The instance may be down or starting up.`,
+        ECONNRESET: `Connection to ${host} was reset. The request may have been too large or the server restarted mid-push.`,
+        ENOTFOUND: `Could not resolve host "${host}". Check the instance origin and your network/DNS.`,
+        ETIMEDOUT: `Connection to ${host} timed out. Check your network or VPN, then retry.`,
+        UND_ERR_CONNECT_TIMEOUT: `Connection to ${host} timed out. Check your network or VPN, then retry.`,
+        UND_ERR_HEADERS_TIMEOUT: `${host} accepted the connection but did not respond in time. The push may be too large; try splitting it or retrying.`,
+    };
+    let base;
+    if (code && hints[code]) {
+        base = `${hints[code]} (${code})`;
+    }
+    else if (code?.startsWith('ERR_TLS') || code?.startsWith('CERT_') || /certificate|tls|ssl/i.test(error.message)) {
+        // TLS/cert failures surface their reason on the cause message.
+        base = `TLS/certificate error connecting to ${host}: ${causeMessage ?? error.message}`;
+    }
+    else if (error.message === 'fetch failed') {
+        // "fetch failed" with no recognized code — surface the underlying cause if any.
+        base = causeMessage
+            ? `network error connecting to ${host}: ${causeMessage}${code ? ` (${code})` : ''}`
+            : `network error connecting to ${host}${code ? ` (${code})` : ''}. Run with --verbose for more detail.`;
+    }
+    else {
+        base = error.message;
+    }
+    return base + formatFailureDuration(elapsedMs);
+}
+/**
+ * Render how long the request ran before failing, e.g. " (after 5m 0s)".
+ * Flags durations sitting near a common timeout boundary (30/60/120/300/600s),
+ * which usually points at a server-side or proxy/load-balancer timeout rather
+ * than a local network problem.
+ */
+function formatFailureDuration(elapsedMs) {
+    if (elapsedMs === undefined || elapsedMs < 0)
+        return '';
+    const totalSeconds = elapsedMs / 1000;
+    const human = totalSeconds < 60
+        ? `${totalSeconds.toFixed(1)}s`
+        : `${Math.floor(totalSeconds / 60)}m ${Math.round(totalSeconds % 60)}s`;
+    // Within 5% of a common timeout boundary → likely a hard cutoff, not a blip.
+    const boundaries = [30, 60, 120, 300, 600];
+    const nearTimeout = boundaries.some((b) => Math.abs(totalSeconds - b) <= b * 0.05);
+    return nearTimeout
+        ? ` (failed after ~${human}, near a common ${boundaries.find((b) => Math.abs(totalSeconds - b) <= b * 0.05)}s timeout — likely a server or proxy cutoff)`
+        : ` (failed after ${human})`;
+}
 async function handleDryRunError(response, command, flags, target) {
     const log = command.log.bind(command);
     if (response.status === 404) {

package/dist/utils/reference-checker.js

@@ -170,8 +170,8 @@ export function checkTableIndexes(documents) {
     return badIndexes;
 }
 function extractSchemaFields(content) {
-    // id, created_at, and xdo are system fields not declared in the schema
-    const fields = new Set(['id', 'created_at', 'xdo']);
+    // id and created_at are auto-added during import
+    const fields = new Set(['id', 'created_at']);
     // Find the schema block by matching braces
     const schemaStart = content.match(/\bschema\s*\{/);
     if (!schemaStart || schemaStart.index === undefined)