@burdenoff/bigconsole-cli 2026.802.1

package/dist/graphql/client.js

@@ -0,0 +1,274 @@
+/**
+ * GraphQL client for CLI operations.
+ * Dual-endpoint: workspace gateway (bigconsole ops) + global gateway (auth ops).
+ * Auto-injects auth headers, auto-refreshes both platform and workspace tokens.
+ */
+import { GraphQLClient } from 'graphql-request';
+import { readConfig } from '../config/index.js';
+import { readAuth, writeAuth, isTokenExpiringSoon, isWorkspaceTokenExpiringSoon, } from '../auth/store.js';
+import { issueWorkspaceToken, clientCredentialsFlow } from '../auth/device-code.js';
+import { printError } from '../utils/output.js';
+const DEFAULT_TIMEOUT = 30000;
+const MAX_RETRIES = 3;
+const INITIAL_RETRY_DELAY_MS = 1000;
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function isNetworkOrServerError(error) {
+    if (error instanceof TypeError)
+        return true;
+    if (error && typeof error === 'object' && 'response' in error) {
+        const resp = error.response;
+        if (resp && typeof resp.status === 'number' && resp.status >= 500)
+            return true;
+    }
+    return false;
+}
+/**
+ * Trim a backend-provided error message to something safe + readable.
+ * Subgraph errors can carry stack fragments, multi-line traces, or very
+ * long strings; for user-facing CLI output we only want the first line
+ * and a reasonable length cap. Returns undefined if the input isn't a
+ * usable string so callers can fall through to the next source.
+ */
+function sanitizeBackendMessage(raw) {
+    if (typeof raw !== 'string' || raw.length === 0)
+        return undefined;
+    const firstLine = raw.split(/\r?\n/)[0].trim();
+    if (!firstLine)
+        return undefined;
+    const MAX = 500;
+    return firstLine.length > MAX ? `${firstLine.slice(0, MAX)}…` : firstLine;
+}
+function extractErrorMessage(error) {
+    if (error && typeof error === 'object' && 'response' in error) {
+        const resp = error;
+        const firstError = resp.response?.errors?.[0];
+        // Federated subgraph errors land under extensions.originalError.message;
+        // the top-level message is usually "Unexpected error." and useless.
+        const original = sanitizeBackendMessage(firstError?.extensions?.originalError?.message);
+        if (original)
+            return original;
+        const wrapper = sanitizeBackendMessage(firstError?.message);
+        if (wrapper)
+            return wrapper;
+        if (resp.message)
+            return resp.message;
+    }
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+let workspaceClient = null;
+let globalClient = null;
+function getHeaders(auth) {
+    const headers = {};
+    if (auth?.accessToken) {
+        headers['Authorization'] = `Bearer ${auth.accessToken}`;
+    }
+    return headers;
+}
+function getWorkspaceHeaders(auth) {
+    const headers = getHeaders(auth);
+    if (auth?.workspaceToken) {
+        headers['X-Workspace-Authorization'] = `Bearer ${auth.workspaceToken}`;
+    }
+    if (auth?.organizationId) {
+        headers['x-org-id'] = auth.organizationId;
+    }
+    return headers;
+}
+function initClients() {
+    const config = readConfig();
+    const auth = readAuth();
+    workspaceClient = new GraphQLClient(config.workspaceEndpoint);
+    workspaceClient.setHeaders(getWorkspaceHeaders(auth));
+    globalClient = new GraphQLClient(config.globalEndpoint);
+    globalClient.setHeaders(getHeaders(auth));
+    return { workspace: workspaceClient, global: globalClient };
+}
+/**
+ * Refresh the platform access token.
+ * For client_credentials: re-authenticate with stored credentials.
+ * For device_code/api_key: use the stored refresh token.
+ */
+async function refreshPlatformToken() {
+    const auth = readAuth();
+    if (!auth)
+        return;
+    if (auth.authMethod === 'client_credentials' && auth.clientId && auth.clientSecret) {
+        const config = readConfig();
+        try {
+            const result = await clientCredentialsFlow(config.globalEndpoint, auth.clientId, auth.clientSecret);
+            writeAuth({
+                ...auth,
+                accessToken: result.accessToken,
+                expiresAt: Date.now() + result.expiresIn * 1000,
+            });
+            workspaceClient = null;
+            globalClient = null;
+        }
+        catch (error) {
+            printError(`App token refresh failed: ${extractErrorMessage(error)}`);
+        }
+        return;
+    }
+    if (!auth.refreshToken)
+        return;
+    const config = readConfig();
+    const client = new GraphQLClient(config.globalEndpoint);
+    client.setHeaders({ Authorization: `Bearer ${auth.accessToken}` });
+    const REFRESH_MUTATION = `
+    mutation RefreshToken($token: String!) {
+      refreshToken(token: $token) {
+        accessToken
+        refreshToken
+        expiresIn
+      }
+    }
+  `;
+    try {
+        const data = await client.request(REFRESH_MUTATION, {
+            token: auth.refreshToken,
+        });
+        const result = data.refreshToken;
+        const expiresAt = Date.now() + result.expiresIn * 1000;
+        writeAuth({
+            ...auth,
+            accessToken: result.accessToken,
+            refreshToken: result.refreshToken,
+            expiresAt,
+        });
+        workspaceClient = null;
+        globalClient = null;
+    }
+    catch (error) {
+        printError(`Token refresh failed: ${extractErrorMessage(error)}`);
+    }
+}
+/**
+ * Refresh the workspace token using the current platform token.
+ */
+async function refreshWorkspaceToken() {
+    const auth = readAuth();
+    if (!auth?.accessToken || !auth.workspaceId || !auth.organizationId)
+        return;
+    const config = readConfig();
+    try {
+        const result = await issueWorkspaceToken(config.workspaceEndpoint, auth.accessToken, auth.workspaceId, auth.organizationId);
+        writeAuth({
+            ...auth,
+            workspaceToken: result.token,
+            workspaceTokenExpiresAt: new Date(result.expiresAt).getTime(),
+        });
+        workspaceClient = null;
+    }
+    catch (error) {
+        printError(`Workspace token refresh failed: ${extractErrorMessage(error)}`);
+    }
+}
+export async function ensureFreshTokens() {
+    const auth = readAuth();
+    if (!auth)
+        return;
+    if (isTokenExpiringSoon(auth)) {
+        await refreshPlatformToken();
+    }
+    const freshAuth = readAuth();
+    if (freshAuth && freshAuth.workspaceToken && isWorkspaceTokenExpiringSoon(freshAuth)) {
+        await refreshWorkspaceToken();
+    }
+}
+/**
+ * Inspect a GraphQL document to decide whether it is safe to retry.
+ * Mutations are NOT retried — a transient error may land the write
+ * server-side even if the client observed a timeout, so blindly
+ * retrying create/update/delete could create duplicates. Queries are
+ * always retryable.
+ */
+function isRetryableDocument(document) {
+    const text = typeof document === 'string'
+        ? document
+        : typeof document?.loc?.source?.body ===
+            'string'
+            ? document.loc.source.body
+            : '';
+    const m = text.match(/\b(query|mutation|subscription)\b/i);
+    return !m || m[1].toLowerCase() === 'query';
+}
+async function executeWithRetry(client, document, variables) {
+    const retryable = isRetryableDocument(document);
+    const maxAttempts = retryable ? MAX_RETRIES : 1;
+    let lastError;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        try {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT);
+            try {
+                return await client.request({
+                    document,
+                    variables,
+                    signal: controller.signal,
+                });
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        }
+        catch (error) {
+            lastError = error;
+            if (error && typeof error === 'object' && 'response' in error) {
+                const resp = error.response;
+                if (resp && typeof resp.status === 'number' && resp.status >= 400 && resp.status < 500) {
+                    break;
+                }
+            }
+            if (retryable && isNetworkOrServerError(error) && attempt < maxAttempts - 1) {
+                const delay = INITIAL_RETRY_DELAY_MS * Math.pow(2, attempt);
+                await sleep(delay);
+                continue;
+            }
+            break;
+        }
+    }
+    throw new Error(extractErrorMessage(lastError));
+}
+/**
+ * Execute a GraphQL request against the workspace gateway.
+ * Auto-refreshes both platform and workspace tokens when they are about to expire.
+ */
+export async function workspaceRequest(document, variables) {
+    await ensureFreshTokens();
+    const { workspace } = workspaceClient ? { workspace: workspaceClient } : initClients();
+    const auth = readAuth();
+    workspace.setHeaders(getWorkspaceHeaders(auth));
+    return executeWithRetry(workspace, document, variables);
+}
+/**
+ * Execute a GraphQL request against the global gateway (auth operations).
+ * Does NOT auto-refresh tokens (to prevent loops during refresh itself).
+ */
+export async function globalRequest(document, variables) {
+    const { global: client } = globalClient ? { global: globalClient } : initClients();
+    const auth = readAuth();
+    client.setHeaders(getHeaders(auth));
+    return executeWithRetry(client, document, variables);
+}
+/**
+ * Execute a request against the workspace gateway with ONLY the platform auth token.
+ * Used for IssueWorkspaceToken which does not require an existing workspace token.
+ */
+export async function workspaceAuthOnlyRequest(document, variables) {
+    const config = readConfig();
+    const auth = readAuth();
+    const client = new GraphQLClient(config.workspaceEndpoint);
+    client.setHeaders(getHeaders(auth));
+    return executeWithRetry(client, document, variables);
+}
+/**
+ * Reset cached clients (useful after auth changes).
+ */
+export function resetClients() {
+    workspaceClient = null;
+    globalClient = null;
+}

package/dist/graphql/operations.d.ts

@@ -0,0 +1,48 @@
+/**
+ * GraphQL operations for bigconsole-cli.
+ * All queries/mutations match the real wspace-bigconsole-svc schema
+ * (see ~/products/wspace/bigconsole/wspace-bigconsole-svc/.hive-schema.graphql).
+ */
+export declare const SIGN_OUT = "\n  mutation SignOut {\n    signOut\n  }\n";
+export declare const REFRESH_TOKEN = "\n  mutation RefreshToken($token: String!) {\n    refreshToken(token: $token) {\n      accessToken\n      refreshToken\n      expiresIn\n    }\n  }\n";
+export declare const MY_WORKSPACES = "\n  query MyWorkspaces($limit: Int) {\n    myWorkspaces(limit: $limit) {\n      items { id name slug tenantId organizationId }\n    }\n  }\n";
+export declare const LIST_DASHBOARDS = "\n  query ListDashboards(\n    $first: Int\n    $after: String\n    $search: String\n    $visibility: DashboardVisibility\n    $category: DashboardCategory\n    $includeArchived: Boolean\n    $sortBy: DashboardSortField\n    $sortOrder: SortOrder\n  ) {\n    listDashboards(\n      first: $first\n      after: $after\n      search: $search\n      visibility: $visibility\n      category: $category\n      includeArchived: $includeArchived\n      sortBy: $sortBy\n      sortOrder: $sortOrder\n    ) {\n      edges {\n        node {\n          id\n          name\n          description\n          status\n          visibility\n          category\n          ownerId\n          createdAt\n          updatedAt\n        }\n      }\n      pageInfo { hasNextPage endCursor }\n      totalCount\n    }\n  }\n";
+export declare const GET_DASHBOARD = "\n  query GetDashboard($id: ID!) {\n    getDashboard(id: $id) {\n      id\n      name\n      description\n      status\n      visibility\n      category\n      ownerId\n      definitionVersion\n      createdAt\n      updatedAt\n    }\n  }\n";
+export declare const ARCHIVE_DASHBOARD = "\n  mutation ArchiveDashboard($id: ID!) {\n    archiveDashboard(id: $id) {\n      id\n      name\n      status\n    }\n  }\n";
+export declare const DELETE_DASHBOARD = "\n  mutation DeleteDashboard($id: ID!) {\n    deleteBigConsoleDashboard(id: $id)\n  }\n";
+export declare const LIST_WIDGETS = "\n  query ListWidgets($pageId: ID!, $first: Int, $after: String, $type: WidgetType) {\n    listWidgets(pageId: $pageId, first: $first, after: $after, type: $type) {\n      edges {\n        node {\n          id\n          pageId\n          dashboardId\n          type\n          title\n          dataSinkId\n          lastRefreshedAt\n          createdAt\n          updatedAt\n        }\n      }\n      pageInfo { hasNextPage endCursor }\n      totalCount\n    }\n  }\n";
+export declare const GET_WIDGET = "\n  query GetWidget($id: ID!) {\n    getWidget(id: $id) {\n      id\n      pageId\n      dashboardId\n      type\n      title\n      config\n      dataSinkId\n      datasetId\n      lastRefreshedAt\n      cacheTTL\n      createdAt\n      updatedAt\n    }\n  }\n";
+export declare const DELETE_WIDGET = "\n  mutation DeleteWidget($id: ID!) {\n    deleteBigConsoleWidget(id: $id)\n  }\n";
+export declare const LIST_DATASINKS = "\n  query ListDataSinks(\n    $first: Int\n    $after: String\n    $search: String\n    $status: DataSinkStatus\n    $setupState: DataSinkSetupState\n    $isActive: Boolean\n  ) {\n    listDataSinks(\n      first: $first\n      after: $after\n      search: $search\n      status: $status\n      setupState: $setupState\n      isActive: $isActive\n    ) {\n      edges {\n        node {\n          id\n          name\n          key\n          description\n          status\n          setupState\n          isActive\n          createdAt\n          updatedAt\n        }\n      }\n      pageInfo { hasNextPage endCursor }\n      totalCount\n    }\n  }\n";
+export declare const GET_DATASINK = "\n  query GetDataSink($id: ID, $key: String) {\n    getDataSink(id: $id, key: $key) {\n      id\n      name\n      key\n      description\n      status\n      setupState\n      isActive\n      createdAt\n      updatedAt\n    }\n  }\n";
+export declare const GET_DATASINK_DATA = "\n  query GetDataSinkData($id: ID, $key: String, $dataPath: String, $forceRefresh: Boolean) {\n    getDataSinkData(id: $id, key: $key, dataPath: $dataPath, forceRefresh: $forceRefresh)\n  }\n";
+export declare const DELETE_DATASINK = "\n  mutation DeleteDataSink($id: ID!) {\n    deleteDataSink(id: $id)\n  }\n";
+export declare const LIST_PARSERS = "\n  query ListParsers($first: Int, $after: String, $filter: ParserFilterInput) {\n    listParsers(first: $first, after: $after, filter: $filter) {\n      edges {\n        node {\n          id\n          name\n          description\n          type\n          status\n          inputSinkKey\n          outputKey\n          outputWidgetId\n          ttl\n          version\n          createdAt\n          updatedAt\n        }\n      }\n      pageInfo { hasNextPage endCursor }\n      totalCount\n    }\n  }\n";
+export declare const GET_PARSER = "\n  query GetParser($id: ID!) {\n    parser(id: $id) {\n      id\n      name\n      description\n      type\n      status\n      expression\n      inputSinkKey\n      outputKey\n      outputWidgetId\n      ttl\n      version\n      createdAt\n      updatedAt\n    }\n  }\n";
+export declare const DELETE_PARSER = "\n  mutation DeleteParser($id: ID!) {\n    deleteParser(id: $id)\n  }\n";
+export declare const LIST_PIPELINES = "\n  query ListPipelines($first: Int, $after: String, $filter: PipelineFilterInput) {\n    listPipelines(first: $first, after: $after, filter: $filter) {\n      edges {\n        node {\n          id\n          name\n          description\n          status\n          version\n          lastExecutedAt\n          createdAt\n          updatedAt\n        }\n      }\n      pageInfo { hasNextPage endCursor }\n      totalCount\n    }\n  }\n";
+export declare const GET_PIPELINE = "\n  query GetPipeline($id: ID!) {\n    pipeline(id: $id) {\n      id\n      name\n      description\n      status\n      version\n      lastExecutedAt\n      stages {\n        id\n        position\n        inputKey\n        outputKey\n        enabled\n        parserName\n        parserType\n      }\n      createdAt\n      updatedAt\n    }\n  }\n";
+export declare const DELETE_PIPELINE = "\n  mutation DeletePipeline($id: ID!) {\n    deletePipeline(id: $id)\n  }\n";
+export declare const CREATE_DASHBOARD = "\n  mutation CreateDashboard($input: BigConsoleCreateDashboardInput!) {\n    createBigConsoleDashboard(input: $input) {\n      id\n      name\n      status\n      visibility\n      category\n      createdAt\n    }\n  }\n";
+export declare const UPDATE_DASHBOARD = "\n  mutation UpdateDashboard($input: BigConsoleUpdateDashboardInput!) {\n    updateBigConsoleDashboard(input: $input) {\n      id\n      name\n      status\n      visibility\n      category\n      updatedAt\n    }\n  }\n";
+export declare const IMPORT_DASHBOARD = "\n  mutation ImportDashboard($input: ImportDashboardInput!) {\n    importDashboard(input: $input) {\n      id\n      name\n      status\n      visibility\n      category\n      createdAt\n    }\n  }\n";
+export declare const EXPORT_DASHBOARD = "\n  query ExportDashboard($id: ID!, $includeComments: Boolean, $options: ExportDashboardOptions) {\n    exportDashboard(id: $id, includeComments: $includeComments, options: $options)\n  }\n";
+export declare const CREATE_WIDGET = "\n  mutation CreateWidget($input: BigConsoleCreateWidgetInput!) {\n    createBigConsoleWidget(input: $input) {\n      id\n      pageId\n      type\n      title\n      createdAt\n    }\n  }\n";
+export declare const UPDATE_WIDGET = "\n  mutation UpdateWidget($input: BigConsoleUpdateWidgetInput!) {\n    updateBigConsoleWidget(input: $input) {\n      id\n      pageId\n      type\n      title\n      updatedAt\n    }\n  }\n";
+export declare const CREATE_DATASINK = "\n  mutation CreateDataSink($input: CreateDataSinkInput!) {\n    createDataSink(input: $input) {\n      id\n      name\n      key\n      status\n      setupState\n      isActive\n      createdAt\n    }\n  }\n";
+export declare const UPDATE_DATASINK = "\n  mutation UpdateDataSink($input: UpdateDataSinkInput!) {\n    updateDataSink(input: $input) {\n      id\n      name\n      key\n      status\n      isActive\n      updatedAt\n    }\n  }\n";
+export declare const CREATE_PARSER = "\n  mutation CreateParser($input: CreateParserInput!) {\n    createParser(input: $input) {\n      id\n      name\n      type\n      status\n      inputSinkKey\n      outputKey\n      version\n      createdAt\n    }\n  }\n";
+export declare const UPDATE_PARSER = "\n  mutation UpdateParser($id: ID!, $version: Int!, $input: UpdateParserInput!) {\n    updateParser(id: $id, version: $version, input: $input) {\n      id\n      name\n      type\n      status\n      version\n      updatedAt\n    }\n  }\n";
+export declare const CREATE_PIPELINE = "\n  mutation CreatePipeline($input: CreatePipelineInput!) {\n    createPipeline(input: $input) {\n      id\n      name\n      status\n      version\n      createdAt\n    }\n  }\n";
+export declare const UPDATE_PIPELINE = "\n  mutation UpdatePipeline($id: ID!, $version: Int!, $input: UpdatePipelineInput!) {\n    updatePipeline(id: $id, version: $version, input: $input) {\n      id\n      name\n      status\n      version\n      updatedAt\n    }\n  }\n";
+export declare const GET_WIDGET_ACTIONS = "\n  query GetWidgetActions($widgetId: ID!) {\n    getWidgetActions(widgetId: $widgetId) {\n      id\n      widgetId\n      type\n      label\n      config\n      createdAt\n    }\n  }\n";
+export declare const DELETE_WIDGET_DRILLDOWN = "\n  mutation DeleteWidgetDrilldown($widgetId: ID!) {\n    deleteWidgetDrilldown(widgetId: $widgetId)\n  }\n";
+export declare const LIST_DASHBOARD_SHARES = "\n  query ListDashboardShares(\n    $dashboardId: ID!\n    $first: Int\n    $after: String\n    $isActive: Boolean\n    $permission: SharePermission\n    $recipientType: ShareRecipientType\n  ) {\n    listDashboardShares(\n      dashboardId: $dashboardId\n      first: $first\n      after: $after\n      isActive: $isActive\n      permission: $permission\n      recipientType: $recipientType\n    ) {\n      edges {\n        node {\n          id\n          dashboardId\n          permission\n          isActive\n          expiresAt\n          createdAt\n        }\n      }\n      pageInfo { hasNextPage endCursor }\n      totalCount\n    }\n  }\n";
+export declare const LIST_TEMPLATES = "\n  query ListTemplates(\n    $first: Int\n    $after: String\n    $category: DashboardCategory\n    $search: String\n    $isFeatured: Boolean\n  ) {\n    listTemplates(\n      first: $first\n      after: $after\n      category: $category\n      search: $search\n      isFeatured: $isFeatured\n    ) {\n      edges {\n        node {\n          id\n          name\n          description\n          category\n          isFeatured\n          status\n          createdAt\n        }\n      }\n      pageInfo { hasNextPage endCursor }\n      totalCount\n    }\n  }\n";
+export declare const GET_TEMPLATE = "\n  query GetTemplate($id: ID!) {\n    getTemplate(id: $id) {\n      id\n      name\n      description\n      category\n      isFeatured\n      status\n      createdAt\n    }\n  }\n";
+export declare const GENERATE_DASHBOARD_FROM_PROMPT = "\n  mutation GenerateDashboardFromPrompt($input: GenerateDashboardFromPromptInput!) {\n    generateDashboardFromPrompt(input: $input) {\n      id\n      status\n      prompt\n      createdAt\n    }\n  }\n";
+export declare const LIST_PROMPT_GENERATIONS = "\n  query ListPromptGenerations($first: Int, $after: String, $status: PromptGenerationStatus) {\n    listPromptGenerations(first: $first, after: $after, status: $status) {\n      edges {\n        node {\n          id\n          status\n          prompt\n          createdAt\n        }\n      }\n      pageInfo { hasNextPage endCursor }\n      totalCount\n    }\n  }\n";
+export declare const GET_PROMPT_GENERATION = "\n  query GetPromptGeneration($id: ID!) {\n    getPromptGeneration(id: $id) {\n      id\n      status\n      prompt\n      createdAt\n    }\n  }\n";
+export declare const CANCEL_PROMPT_GENERATION = "\n  mutation CancelPromptGeneration($id: ID!) {\n    cancelPromptGeneration(id: $id) {\n      id\n      status\n    }\n  }\n";
+export declare const LIST_WORKFLOWS = "\n  query ListWorkflows($filter: FluidGridsWorkflowFilterInput) {\n    workflows(filter: $filter) {\n      id\n      name\n      key\n      description\n      status\n      executionCount\n      linkedDataSinkCount\n      lastExecutedAt\n      createdAt\n      updatedAt\n    }\n  }\n";
+export declare const GET_WORKFLOW = "\n  query GetWorkflow($id: ID!) {\n    workflow(id: $id) {\n      id\n      name\n      key\n      description\n      status\n      executionCount\n      linkedDataSinkCount\n      externalWorkflowId\n      lastExecutionId\n      lastExecutedAt\n      webhookUrl\n      createdAt\n      updatedAt\n    }\n  }\n";