@xano/cli 0.0.95 → 1.0.0

package/dist/help.d.ts

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

package/dist/help.js

@@ -1,5 +1,15 @@
 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
@@ -19,8 +29,36 @@ class CustomCommandHelp extends BaseCommandHelp {
     }
 }
 /**
- * Custom Help class that uses CustomCommandHelp
+ * Custom Help class that injects promoted commands into the COMMANDS list
  */
 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`);
+    }
 }

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

@@ -0,0 +1,63 @@
+import { Command } from '@oclif/core';
+import { type BadIndex, type BadReference } from './reference-checker.js';
+export interface PushFlags {
+    delete: boolean;
+    'dry-run': boolean;
+    env: boolean;
+    exclude?: string[];
+    force: boolean;
+    guids: boolean;
+    include?: string[];
+    records: boolean;
+    sync: boolean;
+    transaction: boolean;
+    truncate: boolean;
+    verbose: boolean;
+}
+export interface PushTarget {
+    /** Build the dry-run URL. Return null if dry-run is not supported for this target. */
+    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? */
+    supportsBranches: boolean;
+    /** Does this target support the partial query param? */
+    supportsPartial: boolean;
+}
+export interface PushContext {
+    accessToken: string;
+    branch: string;
+    command: Command;
+    inputDir: string;
+    verboseFetch: (url: string, options: RequestInit, verbose: boolean, authToken?: string) => Promise<Response>;
+}
+/**
+ * Recursively collect all .xs files from a directory, sorted for deterministic ordering.
+ */
+export declare function collectFiles(dir: string): string[];
+/**
+ * Apply include/exclude glob filters to a file list. Logs filter results.
+ * Returns the filtered file list.
+ */
+export declare function applyFilters(files: string[], inputDir: string, include: string[] | undefined, exclude: string[] | undefined, log: (msg: string) => void): string[];
+/**
+ * Read .xs files into document entries, skipping empty files.
+ */
+export declare function readDocuments(files: string[]): Array<{
+    content: string;
+    filePath: string;
+}>;
+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 confirm(message: string): Promise<boolean>;
+/**
+ * Execute a multidoc push with preview, validation, partial mode, and GUID sync.
+ * Shared by both sandbox:push and workspace:push commands.
+ */
+export declare function executePush(ctx: PushContext, target: PushTarget, flags: PushFlags): Promise<void>;