@xano/cli 1.0.6-beta.0 → 1.0.6-beta.1

package/README.md

@@ -587,15 +587,40 @@ xano ephemeral edit <tenant_name> --display "New Name" -d "New description"
 xano ephemeral delete <tenant_name> --force
 
 # Pull to / push from local files (multidoc)
-xano ephemeral pull -t <tenant_name> -d ./my-ephemeral
-xano ephemeral push -t <tenant_name> -d ./my-ephemeral --dry-run   # preview first
-xano ephemeral push -t <tenant_name> -d ./my-ephemeral
+xano ephemeral pull <tenant_name> -d ./my-ephemeral
+xano ephemeral push <tenant_name> -d ./my-ephemeral --dry-run   # preview first
+xano ephemeral push <tenant_name> -d ./my-ephemeral
 
 # Open in the browser (or print the URL)
 xano ephemeral impersonate <tenant_name>
 xano ephemeral impersonate <tenant_name> --url-only
 ```
 
+#### Static hosting for an ephemeral tenant
+
+An ephemeral tenant can host static sites, scoped to that tenant. These commands mirror
+`xano static_host *` but take the tenant name as the first argument (the tenant's static
+hosting is isolated inside the tenant's own database).
+
+```bash
+# List / create / inspect a tenant's static hosts
+xano ephemeral static_host list <tenant_name>
+xano ephemeral static_host create <tenant_name> --name marketing --description "Marketing site"
+xano ephemeral static_host get <tenant_name> -H marketing
+xano ephemeral static_host edit <tenant_name> -H marketing --description "Updated"
+
+# Builds: push a directory, list, inspect, deploy to an env, pull, delete
+xano ephemeral static_host build push <tenant_name> -H default -f ./site
+xano ephemeral static_host build list <tenant_name> -H default
+xano ephemeral static_host build get <tenant_name> -H default --build_id 52
+xano ephemeral static_host deploy <tenant_name> -H default --build_id 52 --env prod
+xano ephemeral static_host build pull <tenant_name> -H default --latest
+xano ephemeral static_host build delete <tenant_name> -H default --build_id 52
+```
+
+> Static hosting is currently available for **local** tenants. Remote (tier2/tier3)
+> tenants are not yet supported and will return an error.
+
 ### Sandbox
 
 Manage your sandbox tenant. Each user has a single sandbox tenant that is auto-provisioned on first use.

package/dist/base-command.d.ts

@@ -117,6 +117,7 @@ export default abstract class BaseCommand extends Command {
     protected logStaticHostUrls(opts: {
         profile: ProfileConfig;
         staticHost: string;
+        tenantName?: string;
         verbose: boolean;
         workspaceId: string;
     }): Promise<void>;
@@ -126,6 +127,7 @@ export default abstract class BaseCommand extends Command {
         profile: ProfileConfig;
         quiet?: boolean;
         staticHost: string;
+        tenantName?: string;
         timeoutMs?: number;
         verbose: boolean;
         workspaceId: string;

package/dist/base-command.js

@@ -370,8 +370,11 @@ export default class BaseCommand extends Command {
      * Returns the final status. Resolves to the last-seen status on timeout.
      */
     async logStaticHostUrls(opts) {
-        const { profile, staticHost, verbose, workspaceId } = opts;
-        const url = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/static_host/${staticHost}`;
+        const { profile, staticHost, tenantName, verbose, workspaceId } = opts;
+        // When a tenant is scoped, target the tenant's static hosting; otherwise the
+        // workspace-level static host (default, unchanged behavior).
+        const scope = tenantName ? `/tenant/${tenantName}` : '';
+        const url = `${profile.instance_origin}/api:meta/workspace/${workspaceId}${scope}/static_host/${staticHost}`;
         try {
             const response = await this.verboseFetch(url, {
                 headers: { accept: 'application/json', Authorization: `Bearer ${profile.access_token}` },
@@ -394,11 +397,14 @@ export default class BaseCommand extends Command {
         }
     }
     async waitForBuild(opts) {
-        const { buildId, profile, quiet, staticHost, verbose, workspaceId } = opts;
+        const { buildId, profile, quiet, staticHost, tenantName, verbose, workspaceId } = opts;
         const intervalMs = opts.intervalMs ?? 2000;
         const timeoutMs = opts.timeoutMs ?? 600_000; // 10 min
         const terminal = new Set(['error', 'ok']);
-        const url = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/static_host/${staticHost}/build/${buildId}`;
+        // When a tenant is scoped, target the tenant's static hosting; otherwise the
+        // workspace-level static host (default, unchanged behavior).
+        const scope = tenantName ? `/tenant/${tenantName}` : '';
+        const url = `${profile.instance_origin}/api:meta/workspace/${workspaceId}${scope}/static_host/${staticHost}/build/${buildId}`;
         // Spinner only on an interactive TTY and when not emitting JSON. Verbose mode
         // also disables it (the spinner would interleave with request/response logs).
         const animate = Boolean(process.stdout.isTTY) && !quiet && !verbose;

package/dist/commands/ephemeral/pull/index.d.ts

@@ -1,5 +1,8 @@
 import BaseCommand from '../../../base-command.js';
 export default class EphemeralPull extends BaseCommand {
+    static args: {
+        tenant_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
     static description: string;
     static examples: string[];
     static flags: {
@@ -7,7 +10,6 @@ export default class EphemeralPull extends BaseCommand {
         draft: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         env: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         records: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        tenant: 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>;
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/ephemeral/pull/index.js

@@ -1,25 +1,31 @@
-import { Flags } from '@oclif/core';
+import { Args, Flags } from '@oclif/core';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import snakeCase from 'lodash.snakecase';
 import BaseCommand from '../../../base-command.js';
 import { buildApiGroupFolderResolver, parseDocument } from '../../../utils/document-parser.js';
 export default class EphemeralPull extends BaseCommand {
+    static args = {
+        tenant_name: Args.string({
+            description: 'Ephemeral tenant name to pull from',
+            required: true,
+        }),
+    };
     static description = 'Pull an ephemeral tenant multidoc from the Xano Metadata API and split into individual files';
     static examples = [
-        `$ xano ephemeral pull -t e4f2-9ab1-xyz1
+        `$ xano ephemeral pull e4f2-9ab1-xyz1
 Pulled 42 documents from tenant e4f2-9ab1-xyz1 to current directory
 `,
-        `$ xano ephemeral pull -d ./my-tenant -t e4f2-9ab1-xyz1
+        `$ xano ephemeral pull e4f2-9ab1-xyz1 -d ./my-tenant
 Pulled 42 documents from tenant e4f2-9ab1-xyz1 to ./my-tenant
 `,
-        `$ xano ephemeral pull -d ./output -t e4f2-9ab1-xyz1 -w 40
+        `$ xano ephemeral pull e4f2-9ab1-xyz1 -d ./output -w 40
 Pulled 15 documents from tenant e4f2-9ab1-xyz1 to ./output
 `,
-        `$ xano ephemeral pull -t e4f2-9ab1-xyz1 --profile production --env --records
+        `$ xano ephemeral pull e4f2-9ab1-xyz1 --profile production --env --records
 Pulled 58 documents from tenant e4f2-9ab1-xyz1
 `,
-        `$ xano ephemeral pull -t e4f2-9ab1-xyz1 --draft`,
+        `$ xano ephemeral pull e4f2-9ab1-xyz1 --draft`,
     ];
     static flags = {
         ...BaseCommand.baseFlags,
@@ -44,11 +50,6 @@ Pulled 58 documents from tenant e4f2-9ab1-xyz1
             description: 'Include records',
             required: false,
         }),
-        tenant: Flags.string({
-            char: 't',
-            description: 'Ephemeral tenant name to pull from',
-            required: true,
-        }),
         workspace: Flags.string({
             char: 'w',
             description: 'Workspace ID (optional if set in profile)',
@@ -56,7 +57,7 @@ Pulled 58 documents from tenant e4f2-9ab1-xyz1
         }),
     };
     async run() {
-        const { flags } = await this.parse(EphemeralPull);
+        const { args, flags } = await this.parse(EphemeralPull);
         const { profileName, profile } = this.resolveProfile(flags);
         // Determine workspace_id from flag or profile
         let workspaceId;
@@ -68,10 +69,10 @@ Pulled 58 documents from tenant e4f2-9ab1-xyz1
         }
         else {
             this.error(`Workspace ID is required. Either:\n` +
-                `  1. Provide it as a flag: xano ephemeral pull -t <tenant_name> -w <workspace_id>\n` +
+                `  1. Provide it as a flag: xano ephemeral pull <tenant_name> -w <workspace_id>\n` +
                 `  2. Set it in your profile using: xano profile:edit ${profileName} -w <workspace_id>`);
         }
-        const tenantName = flags.tenant;
+        const tenantName = args.tenant_name;
         // Build query parameters
         const queryParams = new URLSearchParams({
             env: flags.env.toString(),

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

@@ -1,5 +1,8 @@
 import BaseCommand from '../../../base-command.js';
 export default class EphemeralPush extends BaseCommand {
+    static args: {
+        tenant_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
     static description: string;
     static examples: string[];
     static flags: {
@@ -11,7 +14,6 @@ export default class EphemeralPush extends BaseCommand {
         guids: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         records: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         sync: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        tenant: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         transaction: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         truncate: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

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

@@ -1,31 +1,37 @@
-import { Flags } from '@oclif/core';
+import { Args, Flags } from '@oclif/core';
 import * as fs from 'node:fs';
 import { resolve } from 'node:path';
 import BaseCommand from '../../../base-command.js';
 import { executePush } from '../../../utils/multidoc-push.js';
 export default class EphemeralPush extends BaseCommand {
+    static args = {
+        tenant_name: Args.string({
+            description: 'Ephemeral tenant name to push to',
+            required: true,
+        }),
+    };
     static description = '[IMPORTANT] ALWAYS run --dry-run first and show the user the output before pushing. Push local documents to an ephemeral tenant 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 examples = [
-        `$ xano ephemeral push -t e4f2-9ab1-xyz1
+        `$ xano ephemeral push e4f2-9ab1-xyz1
 Push from current directory (default partial mode)
 `,
-        `$ xano ephemeral push -t e4f2-9ab1-xyz1 -d ./my-workspace
+        `$ xano ephemeral push e4f2-9ab1-xyz1 -d ./my-workspace
 Push from a specific directory
 `,
-        `$ xano ephemeral push -t e4f2-9ab1-xyz1 --sync
+        `$ xano ephemeral push e4f2-9ab1-xyz1 --sync
 Push all files to the ephemeral tenant
 `,
-        `$ xano ephemeral push -t e4f2-9ab1-xyz1 --sync --delete
+        `$ xano ephemeral push e4f2-9ab1-xyz1 --sync --delete
 Push all files and delete remote objects not included
 `,
-        `$ xano ephemeral push -t e4f2-9ab1-xyz1 --dry-run
+        `$ xano ephemeral push e4f2-9ab1-xyz1 --dry-run
 Preview changes without pushing
 `,
-        `$ xano ephemeral push -t e4f2-9ab1-xyz1 --force
+        `$ xano ephemeral push e4f2-9ab1-xyz1 --force
 Skip preview and push immediately
 `,
-        `$ xano ephemeral push -t e4f2-9ab1-xyz1 --records --env`,
-        `$ xano ephemeral push -t e4f2-9ab1-xyz1 --truncate`,
+        `$ xano ephemeral push e4f2-9ab1-xyz1 --records --env`,
+        `$ xano ephemeral push e4f2-9ab1-xyz1 --truncate`,
     ];
     static flags = {
         ...BaseCommand.baseFlags,
@@ -71,11 +77,6 @@ Skip preview and push immediately
             description: 'Full push — send all files, not just changed ones. Required for --delete.',
             required: false,
         }),
-        tenant: Flags.string({
-            char: 't',
-            description: 'Ephemeral tenant name to push to',
-            required: true,
-        }),
         transaction: Flags.boolean({
             allowNo: true,
             default: true,
@@ -94,7 +95,7 @@ Skip preview and push immediately
         }),
     };
     async run() {
-        const { flags } = await this.parse(EphemeralPush);
+        const { args, flags } = await this.parse(EphemeralPush);
         const { profile } = this.resolveProfile(flags);
         const workspaceId = flags.workspace || profile.workspace;
         if (!workspaceId) {
@@ -107,7 +108,7 @@ Skip preview and push immediately
         if (!fs.statSync(inputDir).isDirectory()) {
             this.error(`Not a directory: ${inputDir}`);
         }
-        const tenantName = flags.tenant;
+        const tenantName = args.tenant_name;
         const baseUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/tenant/${tenantName}`;
         const target = {
             buildDryRunUrl: (params) => `${baseUrl}/multidoc/dry-run?${params.toString()}`,

package/dist/commands/ephemeral/static_host/build/delete/index.d.ts

@@ -0,0 +1,20 @@
+import BaseCommand from '../../../../../base-command.js';
+export default class EphemeralStaticHostBuildDelete extends BaseCommand {
+    static args: {
+        tenant_name: 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>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'static-host': 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>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private confirm;
+}

package/dist/commands/ephemeral/static_host/build/delete/index.js

@@ -0,0 +1,121 @@
+import { Args, Flags } from '@oclif/core';
+import BaseCommand from '../../../../../base-command.js';
+export default class EphemeralStaticHostBuildDelete extends BaseCommand {
+    static args = {
+        tenant_name: Args.string({
+            description: 'Ephemeral tenant name',
+            required: true,
+        }),
+    };
+    static description = 'Delete a static host build for an ephemeral tenant permanently. This action cannot be undone.';
+    static examples = [
+        `$ xano ephemeral static_host build delete e4f2-9ab1-xyz1 --static-host default --build_id 52
+Are you sure you want to delete build 52 from static host 'default'? This action cannot be undone. (y/N) y
+Deleted build 52 from static host 'default'
+`,
+        `$ xano ephemeral static_host build delete e4f2-9ab1-xyz1 -H default --build_id 52 --force
+Deleted build 52 from static host 'default'
+`,
+        `$ xano ephemeral static_host build delete e4f2-9ab1-xyz1 -H myhost --build_id 123 -w 40 -f
+Deleted build 123 from static host 'myhost'
+`,
+        `$ xano ephemeral static_host build delete e4f2-9ab1-xyz1 -H default --build_id 52 -f -o json`,
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        build_id: Flags.string({
+            description: 'Build ID to delete',
+            required: true,
+        }),
+        force: Flags.boolean({
+            char: 'f',
+            default: false,
+            description: '[CRITICAL] NEVER run without explicit user confirmation. Skips the confirmation prompt.',
+            required: false,
+        }),
+        output: Flags.string({
+            char: 'o',
+            default: 'summary',
+            description: 'Output format',
+            options: ['summary', 'json'],
+            required: false,
+        }),
+        'static-host': Flags.string({
+            char: 'H',
+            description: 'Static host name',
+            required: true,
+        }),
+        workspace: Flags.string({
+            char: 'w',
+            description: 'Workspace ID (optional if set in profile)',
+            required: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(EphemeralStaticHostBuildDelete);
+        const { profile, profileName } = this.resolveProfile(flags);
+        const tenantName = args.tenant_name;
+        const staticHost = flags['static-host'];
+        // Determine workspace_id from flag or profile
+        let workspaceId;
+        if (flags.workspace) {
+            workspaceId = flags.workspace;
+        }
+        else if (profile.workspace) {
+            workspaceId = profile.workspace;
+        }
+        else {
+            this.error(`Workspace ID is required. Either:\n` +
+                `  1. Provide it as a flag: xano ephemeral static_host build delete <tenant_name> --static-host <static_host> --build_id <id> -w <workspace_id>\n` +
+                `  2. Set it in your profile using: xano profile edit ${profileName} -w <workspace_id>`);
+        }
+        if (!flags.force) {
+            const confirmed = await this.confirm(`Are you sure you want to delete build ${flags.build_id} from static host '${staticHost}'? This action cannot be undone.`);
+            if (!confirmed) {
+                this.log('Deletion cancelled.');
+                return;
+            }
+        }
+        const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/tenant/${tenantName}/static_host/${staticHost}/build/${flags.build_id}`;
+        try {
+            const response = await this.verboseFetch(apiUrl, {
+                headers: {
+                    'accept': 'application/json',
+                    'Authorization': `Bearer ${profile.access_token}`,
+                },
+                method: 'DELETE',
+            }, flags.verbose, profile.access_token);
+            if (!response.ok) {
+                const errorText = await response.text();
+                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+            }
+            if (flags.output === 'json') {
+                this.log(JSON.stringify({ build_id: flags.build_id, deleted: true, static_host: staticHost }, null, 2));
+            }
+            else {
+                this.log(`Deleted build ${flags.build_id} from static host '${staticHost}'`);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.error(`Failed to delete build: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to delete build: ${String(error)}`);
+            }
+        }
+    }
+    async confirm(message) {
+        const readline = await import('node:readline');
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        return new Promise((resolve) => {
+            rl.question(`${message} (y/N) `, (answer) => {
+                rl.close();
+                resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+            });
+        });
+    }
+}

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

@@ -0,0 +1,18 @@
+import BaseCommand from '../../../../../base-command.js';
+export default class EphemeralStaticHostBuildGet extends BaseCommand {
+    static args: {
+        tenant_name: 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>;
+        'static-host': 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>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/ephemeral/static_host/build/get/index.js

@@ -0,0 +1,137 @@
+import { Args, Flags } from '@oclif/core';
+import BaseCommand from '../../../../../base-command.js';
+export default class EphemeralStaticHostBuildGet extends BaseCommand {
+    static args = {
+        tenant_name: Args.string({
+            description: 'Ephemeral tenant name',
+            required: true,
+        }),
+    };
+    static description = 'Get details of a specific build for a static host of an ephemeral tenant';
+    static examples = [
+        `$ xano ephemeral static_host build get e4f2-9ab1-xyz1 --static-host default --build_id 52
+Build Details:
+ID: 52
+Name: v1.0.0
+Status: completed
+`,
+        `$ xano ephemeral static_host build get e4f2-9ab1-xyz1 -H default --build_id 52 -w 40
+Build Details:
+ID: 52
+Name: v1.0.0
+Status: completed
+`,
+        `$ xano ephemeral static_host build get e4f2-9ab1-xyz1 -H myhost --build_id 123 --profile production
+Build Details:
+ID: 123
+Name: production-build
+`,
+        `$ xano ephemeral static_host build get e4f2-9ab1-xyz1 -H default --build_id 52 -o json
+{
+  "id": 52,
+  "name": "v1.0.0",
+  "status": "completed"
+}
+`,
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        build_id: Flags.string({
+            description: 'Build ID',
+            required: true,
+        }),
+        output: Flags.string({
+            char: 'o',
+            default: 'summary',
+            description: 'Output format',
+            options: ['summary', 'json'],
+            required: false,
+        }),
+        'static-host': Flags.string({
+            char: 'H',
+            description: 'Static host name',
+            required: true,
+        }),
+        workspace: Flags.string({
+            char: 'w',
+            description: 'Workspace ID (optional if set in profile)',
+            required: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(EphemeralStaticHostBuildGet);
+        const { profile, profileName } = this.resolveProfile(flags);
+        const tenantName = args.tenant_name;
+        const staticHost = flags['static-host'];
+        // Determine workspace_id from flag or profile
+        let workspaceId;
+        if (flags.workspace) {
+            workspaceId = flags.workspace;
+        }
+        else if (profile.workspace) {
+            workspaceId = profile.workspace;
+        }
+        else {
+            this.error(`Workspace ID is required. Either:\n` +
+                `  1. Provide it as a flag: xano ephemeral static_host build get <tenant_name> --static-host <static_host> --build_id <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}/tenant/${tenantName}/static_host/${staticHost}/build/${flags.build_id}`;
+        // Fetch build from the API
+        try {
+            const response = await this.verboseFetch(apiUrl, {
+                headers: {
+                    'accept': 'application/json',
+                    'Authorization': `Bearer ${profile.access_token}`,
+                },
+                method: 'GET',
+            }, flags.verbose, profile.access_token);
+            if (!response.ok) {
+                const errorText = await response.text();
+                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+            }
+            const build = await response.json();
+            // Validate response
+            if (!build || typeof build !== 'object') {
+                this.error('Unexpected API response format');
+            }
+            // Output results
+            if (flags.output === 'json') {
+                this.log(JSON.stringify(build, null, 2));
+            }
+            else {
+                // summary format
+                this.log('Build Details:');
+                this.log(`ID: ${build.id}`);
+                this.log(`Name: ${build.name}`);
+                if (build.description) {
+                    this.log(`Description: ${build.description}`);
+                }
+                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}`);
+                }
+                if (build.updated_at) {
+                    this.log(`Updated: ${build.updated_at}`);
+                }
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.error(`Failed to fetch build: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to fetch build: ${String(error)}`);
+            }
+        }
+    }
+}

package/dist/commands/ephemeral/static_host/build/list/index.d.ts

@@ -0,0 +1,19 @@
+import BaseCommand from '../../../../../base-command.js';
+export default class EphemeralStaticHostBuildList extends BaseCommand {
+    static args: {
+        tenant_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        page: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        per_page: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'static-host': 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>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}