@burdenoff/bigconsole-cli 2026.802.1

package/dist/commands/cli-config.js

@@ -0,0 +1,79 @@
+/**
+ * cli-config commands — manage CLI-level endpoint + auth configuration.
+ * Separate from `config` (which will later manage platform-level BigConsole config).
+ */
+import { readConfig, writeConfig, getConfigPath, DEFAULT_CONFIG, KNOWN_CONFIG_KEYS, } from '../config/index.js';
+import { printSuccess, printError, formatDate } from '../utils/output.js';
+import { formatAndOutput, handleCommandError } from './base.js';
+export function registerCLIConfigCommands(program) {
+    const cli = program.command('cli-config').description('CLI configuration (endpoints, client ID)');
+    cli
+        .command('show')
+        .description('Show current CLI configuration')
+        .option('-f, --format <format>', 'Output format (json, table, yaml)')
+        .action((options) => {
+        const config = readConfig();
+        formatAndOutput(options, config, {
+            headers: ['Key', 'Value'],
+            rows: Object.entries(config).map(([k, v]) => [k, v == null ? '-' : String(v)]),
+        });
+    });
+    cli
+        .command('path')
+        .description('Show CLI config file path')
+        .action(() => {
+        console.log(getConfigPath());
+    });
+    cli
+        .command('get <key>')
+        .description('Get a single config value')
+        .action((key) => {
+        try {
+            if (!KNOWN_CONFIG_KEYS.includes(key)) {
+                printError(`Unknown config key: ${key}. Known keys: ${KNOWN_CONFIG_KEYS.join(', ')}`);
+                process.exit(1);
+            }
+            const config = readConfig();
+            const value = config[key];
+            if (value === undefined || value === null) {
+                console.log('-');
+            }
+            else {
+                console.log(String(value));
+            }
+        }
+        catch (error) {
+            handleCommandError(error);
+        }
+    });
+    cli
+        .command('set <key> <value>')
+        .description('Set a config value')
+        .action((key, value) => {
+        try {
+            if (!KNOWN_CONFIG_KEYS.includes(key)) {
+                printError(`Unknown config key: ${key}. Known keys: ${KNOWN_CONFIG_KEYS.join(', ')}`);
+                process.exit(1);
+            }
+            const config = readConfig();
+            config[key] = value;
+            writeConfig(config);
+            printSuccess(`Set ${key} = ${value} (last updated ${formatDate(new Date().toISOString())})`);
+        }
+        catch (error) {
+            handleCommandError(error);
+        }
+    });
+    cli
+        .command('reset')
+        .description('Reset to default CLI configuration')
+        .action(() => {
+        try {
+            writeConfig({ ...DEFAULT_CONFIG });
+            printSuccess('CLI configuration reset to defaults');
+        }
+        catch (error) {
+            handleCommandError(error);
+        }
+    });
+}

package/dist/commands/dashboard.d.ts

@@ -0,0 +1,5 @@
+/**
+ * dashboard commands — list, get, archive, delete.
+ */
+import { Command } from 'commander';
+export declare function registerDashboardCommands(program: Command): void;

package/dist/commands/dashboard.js

@@ -0,0 +1,220 @@
+/**
+ * dashboard commands — list, get, archive, delete.
+ */
+import { readFileSync, writeFileSync } from 'fs';
+import * as ops from '../graphql/operations.js';
+import { execWorkspace, formatAndOutput, handleCommandError, loadJsonInput } from './base.js';
+import { printSuccess, printError, formatDate, formatStatus, truncate } from '../utils/output.js';
+export function registerDashboardCommands(program) {
+    const dash = program.command('dashboard').description('Dashboard operations');
+    dash
+        .command('list')
+        .description('List dashboards in the current workspace')
+        .option('--search <term>', 'Search by name')
+        .option('--category <c>', 'Filter by category')
+        .option('--visibility <v>', 'PRIVATE | WORKSPACE | PUBLIC')
+        .option('--include-archived', 'Include archived dashboards')
+        .option('--first <n>', 'Page size', (v) => parseInt(v, 10), 25)
+        .option('--after <cursor>', 'Cursor for next page')
+        .option('-f, --format <format>', 'Output format')
+        .action(async (o) => {
+        try {
+            const d = await execWorkspace(ops.LIST_DASHBOARDS, {
+                first: o.first ?? 25,
+                after: o.after,
+                search: o.search,
+                category: o.category ? o.category.toUpperCase() : undefined,
+                visibility: o.visibility ? o.visibility.toUpperCase() : undefined,
+                includeArchived: o.includeArchived ?? false,
+            });
+            const items = d.listDashboards.edges.map((e) => e.node);
+            formatAndOutput(o, items, {
+                headers: ['ID', 'Name', 'Status', 'Visibility', 'Category', 'Updated'],
+                rows: items.map((x) => [
+                    truncate(x.id, 14),
+                    truncate(x.name, 30),
+                    formatStatus(x.status),
+                    x.visibility,
+                    x.category,
+                    formatDate(x.updatedAt),
+                ]),
+            });
+        }
+        catch (e) {
+            handleCommandError(e);
+        }
+    });
+    dash
+        .command('get')
+        .description('Get a dashboard by ID')
+        .argument('<id>')
+        .option('-f, --format <format>', 'Output format')
+        .action(async (id, o) => {
+        try {
+            const d = await execWorkspace(ops.GET_DASHBOARD, {
+                id,
+            });
+            if (!d.getDashboard) {
+                printError('Dashboard not found');
+                process.exit(1);
+            }
+            formatAndOutput(o, d.getDashboard);
+        }
+        catch (e) {
+            handleCommandError(e);
+        }
+    });
+    dash
+        .command('archive')
+        .description('Archive a dashboard (soft-delete, can be restored)')
+        .argument('<id>')
+        .action(async (id) => {
+        try {
+            const d = await execWorkspace(ops.ARCHIVE_DASHBOARD, {
+                id,
+            });
+            printSuccess(`Archived: ${d.archiveDashboard.name} (${d.archiveDashboard.id})`);
+        }
+        catch (e) {
+            handleCommandError(e);
+        }
+    });
+    dash
+        .command('delete')
+        .description('Permanently delete a dashboard')
+        .argument('<id>')
+        .action(async (id) => {
+        try {
+            await execWorkspace(ops.DELETE_DASHBOARD, { id });
+            printSuccess(`Deleted dashboard ${id}`);
+        }
+        catch (e) {
+            handleCommandError(e);
+        }
+    });
+    dash
+        .command('create')
+        .description('Create a dashboard')
+        .requiredOption('--name <name>', 'Dashboard name')
+        .requiredOption('--category <cat>', 'Category (e.g. ANALYTICS, OPERATIONS)')
+        .option('--description <d>', 'Description')
+        .option('--visibility <v>', 'PRIVATE | WORKSPACE | PUBLIC', 'PRIVATE')
+        .option('--layout <l>', 'GRID | FREEFORM', 'GRID')
+        .option('--no-default-page', 'Skip creating the default page')
+        .option('--metadata-file <path>', 'JSON file with custom metadata')
+        .option('--metadata-json <json>', 'Inline JSON for custom metadata')
+        .option('-f, --format <format>', 'Output format')
+        .action(async (o) => {
+        try {
+            const metadata = loadJsonInput(o.metadataFile, o.metadataJson);
+            const input = {
+                name: o.name,
+                category: o.category.toUpperCase(),
+                description: o.description,
+                visibility: (o.visibility ?? 'PRIVATE').toUpperCase(),
+                layout: (o.layout ?? 'GRID').toUpperCase(),
+                createDefaultPage: o.defaultPage !== false,
+                metadata,
+            };
+            const d = await execWorkspace(ops.CREATE_DASHBOARD, { input });
+            printSuccess(`Created dashboard: ${d.createBigConsoleDashboard.name} (${d.createBigConsoleDashboard.id})`);
+            formatAndOutput(o, d.createBigConsoleDashboard);
+        }
+        catch (e) {
+            handleCommandError(e);
+        }
+    });
+    dash
+        .command('update')
+        .description('Update a dashboard')
+        .argument('<id>')
+        .option('--name <name>')
+        .option('--description <d>')
+        .option('--category <cat>')
+        .option('--visibility <v>', 'PRIVATE | WORKSPACE | PUBLIC')
+        .option('--layout <l>', 'GRID | FREEFORM')
+        .option('-f, --format <format>', 'Output format')
+        .action(async (id, o) => {
+        try {
+            const input = { id };
+            if (o.name)
+                input.name = o.name;
+            if (o.description !== undefined)
+                input.description = o.description;
+            if (o.category)
+                input.category = o.category.toUpperCase();
+            if (o.visibility)
+                input.visibility = o.visibility.toUpperCase();
+            if (o.layout)
+                input.layout = o.layout.toUpperCase();
+            const d = await execWorkspace(ops.UPDATE_DASHBOARD, { input });
+            printSuccess(`Updated dashboard ${id}`);
+            formatAndOutput(o, d.updateBigConsoleDashboard);
+        }
+        catch (e) {
+            handleCommandError(e);
+        }
+    });
+    dash
+        .command('import')
+        .description('Import a dashboard from a JSON file (dashboard definition)')
+        .requiredOption('--file <path>', 'Dashboard JSON file produced by `dashboard export`')
+        .option('--name <name>', 'Override dashboard name')
+        .option('--visibility <v>', 'Override visibility: PRIVATE | WORKSPACE | PUBLIC')
+        .option('--conflict <strategy>', 'Conflict resolution: RENAME | REPLACE | FAIL', 'RENAME')
+        .action(async (o) => {
+        try {
+            const json = readFileSync(o.file, 'utf8');
+            const input = {
+                json,
+                conflictResolution: (o.conflict ?? 'RENAME').toUpperCase(),
+            };
+            if (o.name)
+                input.name = o.name;
+            if (o.visibility)
+                input.visibility = o.visibility.toUpperCase();
+            const d = await execWorkspace(ops.IMPORT_DASHBOARD, {
+                input,
+            });
+            printSuccess(`Imported dashboard: ${d.importDashboard.name} (${d.importDashboard.id})`);
+        }
+        catch (e) {
+            handleCommandError(e);
+        }
+    });
+    dash
+        .command('export')
+        .description('Export a dashboard definition as JSON (stdout or --out file)')
+        .argument('<id>')
+        .option('--out <path>', 'Write JSON to file instead of stdout')
+        .option('--include-comments', 'Include dashboard comments')
+        .option('--include-data-refs', 'Include data source references', true)
+        .option('--include-webhook-mappings', 'Include webhook mappings')
+        .option('--pretty', 'Pretty-print JSON', true)
+        .action(async (id, o) => {
+        try {
+            const options = {
+                includeDataSourceRefs: o.includeDataRefs !== false,
+                includeWebhookMappings: o.includeWebhookMappings ?? false,
+                prettyPrint: o.pretty !== false,
+            };
+            const d = await execWorkspace(ops.EXPORT_DASHBOARD, {
+                id,
+                includeComments: o.includeComments ?? false,
+                options,
+            });
+            if (o.out) {
+                writeFileSync(o.out, d.exportDashboard, 'utf8');
+                printSuccess(`Exported to ${o.out}`);
+            }
+            else {
+                process.stdout.write(d.exportDashboard);
+                if (!d.exportDashboard.endsWith('\n'))
+                    process.stdout.write('\n');
+            }
+        }
+        catch (e) {
+            handleCommandError(e);
+        }
+    });
+}

package/dist/commands/datasink.d.ts

@@ -0,0 +1,5 @@
+/**
+ * datasink commands — list, get (by id OR key), fetch data, delete.
+ */
+import { Command } from 'commander';
+export declare function registerDataSinkCommands(program: Command): void;

package/dist/commands/datasink.js

@@ -0,0 +1,175 @@
+/**
+ * datasink commands — list, get (by id OR key), fetch data, delete.
+ */
+import * as ops from '../graphql/operations.js';
+import { execWorkspace, formatAndOutput, handleCommandError, loadJsonInput } from './base.js';
+import { printSuccess, printError, formatDate, formatStatus, truncate } from '../utils/output.js';
+export function registerDataSinkCommands(program) {
+    const ds = program.command('datasink').description('DataSink operations');
+    ds.command('list')
+        .description('List DataSinks in the current workspace')
+        .option('--search <term>', 'Search by name')
+        .option('--status <s>', 'Filter by status')
+        .option('--setup-state <s>', 'Filter by setup state')
+        .option('--active <bool>', 'Filter by isActive (true/false)')
+        .option('--first <n>', 'Page size', (v) => parseInt(v, 10), 25)
+        .option('--after <cursor>', 'Cursor for next page')
+        .option('-f, --format <format>', 'Output format')
+        .action(async (o) => {
+        try {
+            const d = await execWorkspace(ops.LIST_DATASINKS, {
+                first: o.first ?? 25,
+                after: o.after,
+                search: o.search,
+                status: o.status ? o.status.toUpperCase() : undefined,
+                setupState: o.setupState ? o.setupState.toUpperCase() : undefined,
+                isActive: o.active === undefined
+                    ? undefined
+                    : o.active.toLowerCase() === 'true' || o.active === '1',
+            });
+            const items = d.listDataSinks.edges.map((e) => e.node);
+            formatAndOutput(o, items, {
+                headers: ['ID', 'Name', 'Key', 'Status', 'Setup', 'Active', 'Updated'],
+                rows: items.map((x) => [
+                    truncate(x.id, 14),
+                    truncate(x.name ?? '-', 24),
+                    truncate(x.key, 20),
+                    formatStatus(x.status),
+                    x.setupState,
+                    x.isActive ? 'yes' : 'no',
+                    formatDate(x.updatedAt),
+                ]),
+            });
+        }
+        catch (e) {
+            handleCommandError(e);
+        }
+    });
+    ds.command('get')
+        .description('Get a DataSink by ID or key')
+        .option('--id <id>', 'DataSink ID')
+        .option('--key <key>', 'DataSink key')
+        .option('-f, --format <format>', 'Output format')
+        .action(async (o) => {
+        try {
+            if (!o.id && !o.key) {
+                printError('Provide --id or --key');
+                process.exit(1);
+            }
+            const d = await execWorkspace(ops.GET_DATASINK, {
+                id: o.id,
+                key: o.key,
+            });
+            if (!d.getDataSink) {
+                printError('DataSink not found');
+                process.exit(1);
+            }
+            formatAndOutput(o, d.getDataSink);
+        }
+        catch (e) {
+            handleCommandError(e);
+        }
+    });
+    ds.command('data')
+        .description('Fetch the current data payload of a DataSink')
+        .option('--id <id>', 'DataSink ID')
+        .option('--key <key>', 'DataSink key')
+        .option('--path <p>', 'JSONPath-like filter (e.g. items[0].value)')
+        .option('--force-refresh', 'Bypass cache')
+        .option('-f, --format <format>', 'Output format (json recommended)')
+        .action(async (o) => {
+        try {
+            if (!o.id && !o.key) {
+                printError('Provide --id or --key');
+                process.exit(1);
+            }
+            const d = await execWorkspace(ops.GET_DATASINK_DATA, {
+                id: o.id,
+                key: o.key,
+                dataPath: o.path,
+                forceRefresh: o.forceRefresh ?? false,
+            });
+            formatAndOutput({ format: o.format ?? 'json' }, d.getDataSinkData);
+        }
+        catch (e) {
+            handleCommandError(e);
+        }
+    });
+    ds.command('delete')
+        .description('Delete a DataSink')
+        .argument('<id>')
+        .action(async (id) => {
+        try {
+            await execWorkspace(ops.DELETE_DATASINK, { id });
+            printSuccess(`Deleted DataSink ${id}`);
+        }
+        catch (e) {
+            handleCommandError(e);
+        }
+    });
+    ds.command('create')
+        .description('Create a DataSink')
+        .requiredOption('--key <key>', 'Unique key within workspace (e.g. sales_metrics_q4)')
+        .option('--name <name>', 'Display name')
+        .option('--description <d>', 'Description')
+        .option('--data-file <path>', 'JSON file with initial payload')
+        .option('--data-json <json>', 'Inline JSON for initial payload')
+        .option('--config-file <path>', 'JSON file with DataSink config')
+        .option('--config-json <json>', 'Inline JSON for DataSink config')
+        .option('-f, --format <format>', 'Output format')
+        .action(async (o) => {
+        try {
+            const data = loadJsonInput(o.dataFile, o.dataJson);
+            const config = loadJsonInput(o.configFile, o.configJson);
+            const input = { key: o.key };
+            if (o.name)
+                input.name = o.name;
+            if (o.description)
+                input.description = o.description;
+            if (data !== undefined)
+                input.data = data;
+            if (config !== undefined)
+                input.config = config;
+            const d = await execWorkspace(ops.CREATE_DATASINK, {
+                input,
+            });
+            printSuccess(`Created DataSink: ${d.createDataSink.key} (${d.createDataSink.id})`);
+            formatAndOutput(o, d.createDataSink);
+        }
+        catch (e) {
+            handleCommandError(e);
+        }
+    });
+    ds.command('update')
+        .description('Update a DataSink')
+        .argument('<id>')
+        .option('--name <name>')
+        .option('--description <d>')
+        .option('--active <bool>', 'true / false')
+        .option('--data-file <path>', 'JSON file to replace data payload')
+        .option('--data-json <json>', 'Inline JSON to replace data payload')
+        .option('-f, --format <format>', 'Output format')
+        .action(async (id, o) => {
+        try {
+            const data = loadJsonInput(o.dataFile, o.dataJson);
+            const input = { id };
+            if (o.name)
+                input.name = o.name;
+            if (o.description !== undefined)
+                input.description = o.description;
+            if (o.active !== undefined) {
+                input.isActive = o.active.toLowerCase() === 'true' || o.active === '1';
+            }
+            if (data !== undefined)
+                input.data = data;
+            const d = await execWorkspace(ops.UPDATE_DATASINK, {
+                input,
+            });
+            printSuccess(`Updated DataSink ${id}`);
+            formatAndOutput(o, d.updateDataSink);
+        }
+        catch (e) {
+            handleCommandError(e);
+        }
+    });
+}

package/dist/commands/drilldown.d.ts

@@ -0,0 +1,9 @@
+/**
+ * drilldown commands — list actions on a widget, delete drilldown config.
+ *
+ * Drilldown creation is JSON-heavy (parameter mappings, target routes,
+ * modal/push/replace navigation). It's deferred to a future pass where we
+ * can offer a generator-style UX rather than a flag firehose.
+ */
+import { Command } from 'commander';
+export declare function registerDrilldownCommands(program: Command): void;

package/dist/commands/drilldown.js

@@ -0,0 +1,47 @@
+/**
+ * drilldown commands — list actions on a widget, delete drilldown config.
+ *
+ * Drilldown creation is JSON-heavy (parameter mappings, target routes,
+ * modal/push/replace navigation). It's deferred to a future pass where we
+ * can offer a generator-style UX rather than a flag firehose.
+ */
+import * as ops from '../graphql/operations.js';
+import { execWorkspace, formatAndOutput, handleCommandError } from './base.js';
+import { printSuccess, formatDate, truncate } from '../utils/output.js';
+export function registerDrilldownCommands(program) {
+    const dd = program.command('drilldown').description('Widget drilldown actions');
+    dd.command('list')
+        .description('List widget actions (includes drilldowns)')
+        .requiredOption('--widget <id>', 'Widget ID')
+        .option('-f, --format <format>', 'Output format')
+        .action(async (o) => {
+        try {
+            const d = await execWorkspace(ops.GET_WIDGET_ACTIONS, { widgetId: o.widget });
+            formatAndOutput(o, d.getWidgetActions, {
+                headers: ['ID', 'Widget', 'Type', 'Label', 'Created'],
+                rows: d.getWidgetActions.map((a) => [
+                    truncate(a.id, 14),
+                    truncate(a.widgetId, 14),
+                    a.type,
+                    truncate(a.label ?? '-', 24),
+                    formatDate(a.createdAt),
+                ]),
+            });
+        }
+        catch (e) {
+            handleCommandError(e);
+        }
+    });
+    dd.command('delete')
+        .description('Delete the drilldown configuration from a widget')
+        .requiredOption('--widget <id>', 'Widget ID')
+        .action(async (o) => {
+        try {
+            await execWorkspace(ops.DELETE_WIDGET_DRILLDOWN, { widgetId: o.widget });
+            printSuccess(`Removed drilldown from widget ${o.widget}`);
+        }
+        catch (e) {
+            handleCommandError(e);
+        }
+    });
+}

package/dist/commands/index.d.ts

@@ -0,0 +1,13 @@
+export { registerAuthCommands } from './auth.js';
+export { registerCLIConfigCommands } from './cli-config.js';
+export { registerWorkspaceCommands } from './workspace.js';
+export { registerDashboardCommands } from './dashboard.js';
+export { registerWidgetCommands } from './widget.js';
+export { registerDataSinkCommands } from './datasink.js';
+export { registerParserCommands } from './parser.js';
+export { registerPipelineCommands } from './pipeline.js';
+export { registerWorkflowCommands } from './workflow.js';
+export { registerDrilldownCommands } from './drilldown.js';
+export { registerShareCommands } from './share.js';
+export { registerTemplateCommands } from './template.js';
+export { registerPromptCommands } from './prompt.js';

package/dist/commands/index.js

@@ -0,0 +1,13 @@
+export { registerAuthCommands } from './auth.js';
+export { registerCLIConfigCommands } from './cli-config.js';
+export { registerWorkspaceCommands } from './workspace.js';
+export { registerDashboardCommands } from './dashboard.js';
+export { registerWidgetCommands } from './widget.js';
+export { registerDataSinkCommands } from './datasink.js';
+export { registerParserCommands } from './parser.js';
+export { registerPipelineCommands } from './pipeline.js';
+export { registerWorkflowCommands } from './workflow.js';
+export { registerDrilldownCommands } from './drilldown.js';
+export { registerShareCommands } from './share.js';
+export { registerTemplateCommands } from './template.js';
+export { registerPromptCommands } from './prompt.js';

package/dist/commands/parser.d.ts

@@ -0,0 +1,5 @@
+/**
+ * parser commands — list, get, delete.
+ */
+import { Command } from 'commander';
+export declare function registerParserCommands(program: Command): void;