@xano/cli 0.0.94 → 0.0.95-beta.2

package/dist/commands/ephemeral/license/get/index.d.ts

@@ -0,0 +1,16 @@
+import BaseCommand from '../../../../base-command.js';
+export default class EphemeralLicenseGet extends BaseCommand {
+    static args: {
+        tenant_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        view: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        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/license/get/index.js

@@ -0,0 +1,94 @@
+import { Args, Flags } from '@oclif/core';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import BaseCommand from '../../../../base-command.js';
+export default class EphemeralLicenseGet extends BaseCommand {
+    static args = {
+        tenant_name: Args.string({
+            description: 'Ephemeral tenant name',
+            required: true,
+        }),
+    };
+    static description = 'Get the license for an ephemeral tenant';
+    static examples = [
+        `$ xano ephemeral license get my-tenant
+License saved to license_my-tenant.yaml
+`,
+        `$ xano ephemeral license get my-tenant --file ./my-license.yaml`,
+        `$ xano ephemeral license get my-tenant --view`,
+        `$ xano ephemeral license get my-tenant -o json`,
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        file: Flags.string({
+            char: 'f',
+            description: 'Output file path (default: license_<tenant_name>.yaml)',
+            required: false,
+        }),
+        output: Flags.string({
+            char: 'o',
+            default: 'summary',
+            description: 'Output format',
+            options: ['summary', 'json'],
+            required: false,
+        }),
+        view: Flags.boolean({
+            default: false,
+            description: 'Print license to stdout instead of saving to file',
+            required: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(EphemeralLicenseGet);
+        const profileName = flags.profile || this.getDefaultProfile();
+        const credentials = this.loadCredentialsFile();
+        if (!credentials || !(profileName in credentials.profiles)) {
+            this.error(`Profile '${profileName}' not found.\n` + `Create a profile using 'xano profile create'`);
+        }
+        const profile = credentials.profiles[profileName];
+        if (!profile.instance_origin) {
+            this.error(`Profile '${profileName}' is missing instance_origin`);
+        }
+        if (!profile.access_token) {
+            this.error(`Profile '${profileName}' is missing access_token`);
+        }
+        const tenantName = args.tenant_name;
+        const apiUrl = `${profile.instance_origin}/api:meta/ephemeral/tenant/${tenantName}/license`;
+        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 license = await response.json();
+            const licenseContent = typeof license === 'string' ? license : JSON.stringify(license, null, 2);
+            if (flags.view || flags.output === 'json') {
+                if (flags.output === 'json') {
+                    this.log(JSON.stringify(license, null, 2));
+                }
+                else {
+                    this.log(licenseContent);
+                }
+            }
+            else {
+                const filePath = path.resolve(flags.file || `license_${tenantName}.yaml`);
+                fs.writeFileSync(filePath, licenseContent, 'utf8');
+                this.log(`License saved to ${filePath}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.error(`Failed to get ephemeral tenant license: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to get ephemeral tenant license: ${String(error)}`);
+            }
+        }
+    }
+}

package/dist/commands/ephemeral/license/set/index.d.ts

@@ -0,0 +1,17 @@
+import BaseCommand from '../../../../base-command.js';
+export default class EphemeralLicenseSet extends BaseCommand {
+    static args: {
+        tenant_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        clean: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        value: 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/license/set/index.js

@@ -0,0 +1,111 @@
+import { Args, Flags } from '@oclif/core';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import BaseCommand from '../../../../base-command.js';
+export default class EphemeralLicenseSet extends BaseCommand {
+    static args = {
+        tenant_name: Args.string({
+            description: 'Ephemeral tenant name',
+            required: true,
+        }),
+    };
+    static description = 'Set/update the license for an ephemeral tenant';
+    static examples = [
+        `$ xano ephemeral license set my-tenant
+Reads from license_my-tenant.yaml
+`,
+        `$ xano ephemeral license set my-tenant --file ./license.yaml`,
+        `$ xano ephemeral license set my-tenant --value 'key: value'`,
+        `$ xano ephemeral license set my-tenant -o json`,
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        clean: Flags.boolean({
+            default: false,
+            description: 'Remove the source file after successful upload',
+            exclusive: ['value'],
+            required: false,
+        }),
+        file: Flags.string({
+            char: 'f',
+            description: 'Path to license file (default: license_<tenant_name>.yaml)',
+            exclusive: ['value'],
+            required: false,
+        }),
+        output: Flags.string({
+            char: 'o',
+            default: 'summary',
+            description: 'Output format',
+            options: ['summary', 'json'],
+            required: false,
+        }),
+        value: Flags.string({
+            description: 'Inline license value',
+            exclusive: ['file', 'clean'],
+            required: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(EphemeralLicenseSet);
+        const tenantName = args.tenant_name;
+        let licenseValue;
+        let sourceFilePath;
+        if (flags.value) {
+            licenseValue = flags.value;
+        }
+        else {
+            sourceFilePath = path.resolve(flags.file || `license_${tenantName}.yaml`);
+            if (!fs.existsSync(sourceFilePath)) {
+                this.error(`File not found: ${sourceFilePath}`);
+            }
+            licenseValue = fs.readFileSync(sourceFilePath, 'utf8');
+        }
+        const profileName = flags.profile || this.getDefaultProfile();
+        const credentials = this.loadCredentialsFile();
+        if (!credentials || !(profileName in credentials.profiles)) {
+            this.error(`Profile '${profileName}' not found.\n` + `Create a profile using 'xano profile create'`);
+        }
+        const profile = credentials.profiles[profileName];
+        if (!profile.instance_origin) {
+            this.error(`Profile '${profileName}' is missing instance_origin`);
+        }
+        if (!profile.access_token) {
+            this.error(`Profile '${profileName}' is missing access_token`);
+        }
+        const apiUrl = `${profile.instance_origin}/api:meta/ephemeral/tenant/${tenantName}/license`;
+        try {
+            const response = await this.verboseFetch(apiUrl, {
+                body: JSON.stringify({ value: licenseValue }),
+                headers: {
+                    accept: 'application/json',
+                    Authorization: `Bearer ${profile.access_token}`,
+                    'Content-Type': 'application/json',
+                },
+                method: 'POST',
+            }, 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 result = await response.json();
+            if (flags.output === 'json') {
+                this.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                this.log(`Ephemeral tenant license updated successfully for ${tenantName}`);
+            }
+            if (flags.clean && sourceFilePath && fs.existsSync(sourceFilePath)) {
+                fs.unlinkSync(sourceFilePath);
+                this.log(`Removed ${sourceFilePath}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.error(`Failed to set ephemeral tenant license: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to set ephemeral tenant license: ${String(error)}`);
+            }
+        }
+    }
+}

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

@@ -0,0 +1,15 @@
+import BaseCommand from '../../../base-command.js';
+export default class EphemeralList extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        order: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        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>;
+        sort: import("@oclif/core/interfaces").OptionFlag<string, 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/list/index.js

@@ -0,0 +1,109 @@
+import { Flags } from '@oclif/core';
+import BaseCommand from '../../../base-command.js';
+export default class EphemeralList extends BaseCommand {
+    static description = 'List ephemeral tenants';
+    static examples = [
+        `$ xano ephemeral list
+Ephemeral tenants:
+  - My Tenant (my-tenant) [ok]
+  - CI Tenant (ci-tenant) [ok]
+`,
+        `$ xano ephemeral list -o json`,
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        order: Flags.string({
+            default: 'asc',
+            description: 'Sort order',
+            options: ['asc', 'desc'],
+            required: false,
+        }),
+        output: Flags.string({
+            char: 'o',
+            default: 'summary',
+            description: 'Output format',
+            options: ['summary', 'json'],
+            required: false,
+        }),
+        page: Flags.integer({
+            default: 1,
+            description: 'Page number',
+            required: false,
+        }),
+        per_page: Flags.integer({
+            default: 50,
+            description: 'Items per page',
+            required: false,
+        }),
+        sort: Flags.string({
+            default: 'name',
+            description: 'Sort field',
+            options: ['name', 'created_at', 'state'],
+            required: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(EphemeralList);
+        const profileName = flags.profile || this.getDefaultProfile();
+        const credentials = this.loadCredentialsFile();
+        if (!credentials || !(profileName in credentials.profiles)) {
+            this.error(`Profile '${profileName}' not found.\n` + `Create a profile using 'xano profile create'`);
+        }
+        const profile = credentials.profiles[profileName];
+        if (!profile.instance_origin) {
+            this.error(`Profile '${profileName}' is missing instance_origin`);
+        }
+        if (!profile.access_token) {
+            this.error(`Profile '${profileName}' is missing access_token`);
+        }
+        const params = new URLSearchParams({
+            order: flags.order,
+            page: String(flags.page),
+            per_page: String(flags.per_page),
+            sort: flags.sort,
+        });
+        const apiUrl = `${profile.instance_origin}/api:meta/ephemeral/tenant?${params}`;
+        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 data = (await response.json());
+            const tenants = data.items ?? [];
+            if (flags.output === 'json') {
+                this.log(JSON.stringify(data, null, 2));
+            }
+            else {
+                if (tenants.length === 0) {
+                    this.log('No ephemeral tenants found');
+                }
+                else {
+                    this.log('Ephemeral tenants:');
+                    for (const tenant of tenants) {
+                        const state = tenant.state ? ` [${tenant.state}]` : '';
+                        const access = tenant.ephemeral_access ? ` [${tenant.ephemeral_access}]` : '';
+                        this.log(`  - ${tenant.display || tenant.name} (${tenant.name})${state}${access}`);
+                    }
+                    if (data.nextPage) {
+                        this.log(`\nPage ${data.curPage} — more results available (use --page ${data.nextPage})`);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.error(`Failed to list ephemeral tenants: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to list ephemeral tenants: ${String(error)}`);
+            }
+        }
+    }
+}

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

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

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

@@ -0,0 +1,197 @@
+import { Args, Flags } from '@oclif/core';
+import snakeCase from 'lodash.snakecase';
+import BaseCommand from '../../../base-command.js';
+import { buildApiGroupFolderResolver, parseDocument } from '../../../utils/document-parser.js';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+export default class EphemeralPull extends BaseCommand {
+    static args = {
+        directory: Args.string({
+            description: 'Output directory for pulled documents',
+            required: true,
+        }),
+    };
+    static description = 'Pull an ephemeral tenant multidoc and split into individual files';
+    static examples = [
+        `$ xano ephemeral pull ./my-tenant -t my-tenant
+Pulled 42 documents from ephemeral tenant my-tenant to ./my-tenant
+`,
+        `$ xano ephemeral pull ./backup -t my-tenant --env --records`,
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        draft: Flags.boolean({
+            default: false,
+            description: 'Include draft versions',
+            required: false,
+        }),
+        env: Flags.boolean({
+            default: false,
+            description: 'Include environment variables',
+            required: false,
+        }),
+        records: Flags.boolean({
+            default: false,
+            description: 'Include records',
+            required: false,
+        }),
+        tenant: Flags.string({
+            char: 't',
+            description: 'Ephemeral tenant name to pull from',
+            required: true,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(EphemeralPull);
+        const profileName = flags.profile || this.getDefaultProfile();
+        const credentials = this.loadCredentialsFile();
+        if (!credentials || !(profileName in credentials.profiles)) {
+            this.error(`Profile '${profileName}' not found.\n` + `Create a profile using 'xano profile create'`);
+        }
+        const profile = credentials.profiles[profileName];
+        if (!profile.instance_origin) {
+            this.error(`Profile '${profileName}' is missing instance_origin`);
+        }
+        if (!profile.access_token) {
+            this.error(`Profile '${profileName}' is missing access_token`);
+        }
+        const tenantName = flags.tenant;
+        const queryParams = new URLSearchParams({
+            env: flags.env.toString(),
+            include_draft: flags.draft.toString(),
+            records: flags.records.toString(),
+        });
+        const apiUrl = `${profile.instance_origin}/api:meta/ephemeral/tenant/${tenantName}/multidoc?${queryParams.toString()}`;
+        let responseText;
+        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}`);
+            }
+            responseText = await response.text();
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.error(`Failed to fetch multidoc: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to fetch multidoc: ${String(error)}`);
+            }
+        }
+        const rawDocuments = responseText.split('\n---\n');
+        const documents = [];
+        for (const raw of rawDocuments) {
+            const trimmed = raw.trim();
+            if (!trimmed) {
+                continue;
+            }
+            const parsed = parseDocument(trimmed);
+            if (parsed) {
+                documents.push(parsed);
+            }
+        }
+        if (documents.length === 0) {
+            this.log('No documents found in response');
+            return;
+        }
+        const outputDir = path.resolve(args.directory);
+        fs.mkdirSync(outputDir, { recursive: true });
+        const getApiGroupFolder = buildApiGroupFolderResolver(documents, snakeCase);
+        const filenameCounters = new Map();
+        let writtenCount = 0;
+        for (const doc of documents) {
+            let typeDir;
+            let baseName;
+            if (doc.type === 'workspace') {
+                typeDir = path.join(outputDir, 'workspace');
+                baseName = this.sanitizeFilename(doc.name);
+            }
+            else if (doc.type === 'workspace_trigger') {
+                typeDir = path.join(outputDir, 'workspace', 'trigger');
+                baseName = this.sanitizeFilename(doc.name);
+            }
+            else if (doc.type === 'agent') {
+                typeDir = path.join(outputDir, 'ai', 'agent');
+                baseName = this.sanitizeFilename(doc.name);
+            }
+            else if (doc.type === 'mcp_server') {
+                typeDir = path.join(outputDir, 'ai', 'mcp_server');
+                baseName = this.sanitizeFilename(doc.name);
+            }
+            else if (doc.type === 'tool') {
+                typeDir = path.join(outputDir, 'ai', 'tool');
+                baseName = this.sanitizeFilename(doc.name);
+            }
+            else if (doc.type === 'agent_trigger') {
+                typeDir = path.join(outputDir, 'ai', 'agent', 'trigger');
+                baseName = this.sanitizeFilename(doc.name);
+            }
+            else if (doc.type === 'mcp_server_trigger') {
+                typeDir = path.join(outputDir, 'ai', 'mcp_server', 'trigger');
+                baseName = this.sanitizeFilename(doc.name);
+            }
+            else if (doc.type === 'table_trigger') {
+                typeDir = path.join(outputDir, 'table', 'trigger');
+                baseName = this.sanitizeFilename(doc.name);
+            }
+            else if (doc.type === 'realtime_channel') {
+                typeDir = path.join(outputDir, 'realtime', 'channel');
+                baseName = this.sanitizeFilename(doc.name);
+            }
+            else if (doc.type === 'realtime_trigger') {
+                typeDir = path.join(outputDir, 'realtime', 'trigger');
+                baseName = this.sanitizeFilename(doc.name);
+            }
+            else if (doc.type === 'api_group') {
+                const groupFolder = getApiGroupFolder(doc.name);
+                typeDir = path.join(outputDir, 'api', groupFolder);
+                baseName = this.sanitizeFilename(doc.name);
+            }
+            else if (doc.type === 'query' && doc.apiGroup) {
+                const groupFolder = getApiGroupFolder(doc.apiGroup);
+                const nameParts = doc.name.split('/');
+                const leafName = nameParts.pop();
+                const folderParts = nameParts.map((part) => snakeCase(part));
+                typeDir = path.join(outputDir, 'api', groupFolder, ...folderParts);
+                baseName = this.sanitizeFilename(leafName);
+                if (doc.verb) {
+                    baseName = `${baseName}_${doc.verb}`;
+                }
+            }
+            else {
+                const nameParts = doc.name.split('/');
+                const leafName = nameParts.pop();
+                const folderParts = nameParts.map((part) => snakeCase(part));
+                typeDir = path.join(outputDir, doc.type, ...folderParts);
+                baseName = this.sanitizeFilename(leafName);
+                if (doc.verb) {
+                    baseName = `${baseName}_${doc.verb}`;
+                }
+            }
+            fs.mkdirSync(typeDir, { recursive: true });
+            const dirKey = path.relative(outputDir, typeDir);
+            if (!filenameCounters.has(dirKey)) {
+                filenameCounters.set(dirKey, new Map());
+            }
+            const typeCounters = filenameCounters.get(dirKey);
+            const count = typeCounters.get(baseName) || 0;
+            typeCounters.set(baseName, count + 1);
+            let filename;
+            filename = count === 0 ? `${baseName}.xs` : `${baseName}_${count + 1}.xs`;
+            const filePath = path.join(typeDir, filename);
+            fs.writeFileSync(filePath, doc.content, 'utf8');
+            writtenCount++;
+        }
+        this.log(`Pulled ${writtenCount} documents from ephemeral tenant ${tenantName} to ${args.directory}`);
+    }
+    sanitizeFilename(name) {
+        return snakeCase(name.replaceAll('"', ''));
+    }
+}

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

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