@datashow/super-visual-cli 0.0.0-stage → 0.1.0-rc.0

package/bin/supervisual.mjs

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import { main } from "../src/main.mjs";
+
+main().catch((error) => {
+  const json = process.argv.includes("--json");
+  const message = error instanceof Error ? error.message : String(error);
+  process.stderr.write(`${json ? JSON.stringify({ ok: false, error: message }) : `supervisual: ${message}`}\n`);
+  process.exitCode = 1;
+});

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "@datashow/super-visual-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0-rc.0",
+  "description": "CLI for validating, compiling, packaging, verifying, and deploying Super Visual projects.",
+  "type": "module",
+  "bin": {
+    "supervisual": "bin/supervisual.mjs"
+  },
+  "files": [
+    "bin",
+    "src",
+    "templates"
+  ],
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Datashow-Pty-Ltd/super-visual.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/Datashow-Pty-Ltd/super-visual#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@datashow/super-visual-adapter-claude-dashboard": "0.1.0-rc.0",
+    "@datashow/super-visual-compiler": "0.1.0-rc.0",
+    "@datashow/super-visual-contracts": "0.1.0-rc.0",
+    "@datashow/super-visual-fabric": "0.1.0-rc.0",
+    "@fontsource/source-serif-4": "5.3.1",
+    "@nivo/bar": "0.99.0",
+    "@nivo/line": "0.99.0",
+    "@nivo/pie": "0.99.0",
+    "@nivo/sankey": "0.99.0",
+    "@nivo/tree": "0.99.0",
+    "commander": "15.0.0",
+    "d3": "7.9.0",
+    "less": "4.9.1",
+    "playwright": "1.64.1",
+    "react": "19.3.1",
+    "react-dom": "19.3.1",
+    "react-router-dom": "7.18.4",
+    "vite": "8.3.4"
+  }
+}

package/src/fabric-client.mjs

@@ -0,0 +1,101 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+
+const run = promisify(execFile);
+const base = "https://api.fabric.microsoft.com/v1";
+const powerBiBase = "https://api.powerbi.com/v1.0/myorg";
+const fabricOrigin = new URL(base).origin;
+const powerBiOrigin = new URL(powerBiBase).origin;
+
+function trustedUrl(pathOrUrl, serviceBase, expectedOrigin) {
+  const value = String(pathOrUrl);
+  const candidate = /^https:\/\//i.test(value)
+    ? new URL(value)
+    : new URL(`${serviceBase}${value.startsWith("/") ? value : `/${value}`}`);
+  const regionalFabricOperation = expectedOrigin === fabricOrigin && candidate.hostname.endsWith(".analysis.windows.net");
+  if (candidate.protocol !== "https:" || (candidate.origin !== expectedOrigin && !regionalFabricOperation) || candidate.username || candidate.password) {
+    throw new Error(`Refusing untrusted service URL: ${candidate.origin}`);
+  }
+  return candidate;
+}
+
+const segment = (value) => encodeURIComponent(String(value));
+
+export class FabricHttpClient {
+  constructor({ timeoutSeconds = 900, token, powerBiToken } = {}) { this.timeoutSeconds = timeoutSeconds; this.providedToken = token; this.providedPowerBiToken = powerBiToken; }
+
+  async accessToken(resource = "fabric") {
+    if (resource === "fabric" && this.providedToken) return this.providedToken;
+    if (resource === "powerbi" && this.providedPowerBiToken) return this.providedPowerBiToken;
+    const audience = resource === "fabric" ? "https://api.fabric.microsoft.com" : "https://analysis.windows.net/powerbi/api";
+    const { stdout } = await run("az", ["account", "get-access-token", "--resource", audience, "--query", "accessToken", "--output", "tsv"]);
+    const token = stdout.trim();
+    if (!token) throw new Error("Azure CLI did not return a Fabric access token; run az login first");
+    return token;
+  }
+
+  async request(pathOrUrl, method, skill, body) {
+    const url = trustedUrl(pathOrUrl, base, fabricOrigin);
+    // Body data is deliberately sent only to allowlisted Microsoft Fabric service hosts after contract validation.
+    const response = await fetch(url, { method, redirect: "error", headers: { Authorization: `Bearer ${await this.accessToken("fabric")}`, "x-ms-fabric-skill": skill, ...(body === undefined ? {} : { "Content-Type": "application/json" }) }, ...(body === undefined ? {} : { body: JSON.stringify(body) }) });
+    return this.complete(response, skill);
+  }
+
+  async body(response) { const text = await response.text(); if (!text) return {}; try { return JSON.parse(text); } catch { return { text }; } }
+  async assert(response) { const body = await this.body(response); if (!response.ok) throw new Error(`Fabric HTTP ${response.status}: ${JSON.stringify(body)}`); return body; }
+
+  async complete(response, skill) {
+    if (response.status !== 202) return this.assert(response);
+    const operationId = response.headers.get("x-ms-operation-id") ?? response.headers.get("operation-id");
+    const locationHeader = response.headers.get("Location");
+    if (!locationHeader && !operationId) throw new Error("Fabric returned 202 without an operation location");
+    const location = trustedUrl(locationHeader ?? `${base}/operations/${segment(operationId)}`, base, fabricOrigin);
+    const started = Date.now();
+    while ((Date.now() - started) / 1000 < this.timeoutSeconds) {
+      await new Promise((resolve) => setTimeout(resolve, Math.max(1000, Number(response.headers.get("Retry-After") ?? 3) * 1000)));
+      const poll = await fetch(location, { redirect: "error", headers: { Authorization: `Bearer ${await this.accessToken("fabric")}`, "x-ms-fabric-skill": skill } });
+      const state = await this.assert(poll);
+      if (state.status === "Failed" || state.status === "Cancelled") throw new Error(`Fabric operation ${state.status}: ${JSON.stringify(state.error ?? state)}`);
+      if (state.status === "Succeeded") {
+        const resultUrl = new URL(location);
+        resultUrl.pathname = `${resultUrl.pathname.replace(/\/$/, "")}/result`;
+        resultUrl.search = "";
+        resultUrl.hash = "";
+        const result = await fetch(resultUrl, { redirect: "error", headers: { Authorization: `Bearer ${await this.accessToken("fabric")}`, "x-ms-fabric-skill": skill } });
+        if (result.status === 404) return state;
+        if (result.status === 400) {
+          const resultBody = await this.body(result);
+          if (resultBody.errorCode === "OperationHasNoResult") return state;
+          throw new Error(`Fabric HTTP 400: ${JSON.stringify(resultBody)}`);
+        }
+        return this.assert(result);
+      }
+    }
+    throw new Error(`Fabric operation exceeded ${this.timeoutSeconds}s`);
+  }
+
+  skill(type) { return type === "Report" ? "powerbi-report-management" : "semantic-model-authoring"; }
+  collection(type) { return type === "Report" ? "reports" : "semanticModels"; }
+  async listWorkspaces() { const output = []; let next = "/workspaces"; while (next) { const page = await this.request(next, "GET", "semantic-model-authoring"); output.push(...(page.value ?? [])); next = page.continuationUri; } return output; }
+  async getWorkspace(id) { return this.request(`/workspaces/${segment(id)}`, "GET", "semantic-model-authoring"); }
+  async listItems(workspaceId, type) {
+    const output = []; let next = `/workspaces/${segment(workspaceId)}/items?type=${segment(type)}`;
+    while (next) { const page = await this.request(next, "GET", this.skill(type)); output.push(...(page.value ?? [])); next = page.continuationUri; }
+    return output;
+  }
+  async createItem(workspaceId, type, displayName, format, parts) { return this.request(`/workspaces/${segment(workspaceId)}/${this.collection(type)}`, "POST", this.skill(type), { displayName, definition: { format, parts } }); }
+  async updateItem(workspaceId, type, id, format, parts) { await this.request(`/workspaces/${segment(workspaceId)}/${this.collection(type)}/${segment(id)}/updateDefinition`, "POST", this.skill(type), { definition: { format, parts } }); return { id }; }
+  async getDefinition(workspaceId, type, id, format) { const response = await this.request(`/workspaces/${segment(workspaceId)}/items/${segment(id)}/getDefinition?format=${segment(format)}`, "POST", this.skill(type), {}); return { format: response.definition?.format ?? format, parts: response.definition?.parts ?? [] }; }
+  async listConnections() { const output = []; let next = "/connections"; while (next) { const page = await this.request(next, "GET", "semantic-model-authoring"); output.push(...(page.value ?? [])); next = page.continuationUri; } return output; }
+  async getSemanticConnections(workspaceId, semanticModelId) { const response = await this.request(`/workspaces/${segment(workspaceId)}/items/${segment(semanticModelId)}/connections`, "GET", "semantic-model-authoring"); return response.value ?? []; }
+  async bindSemanticConnection(workspaceId, semanticModelId, connectionBinding) { return this.request(`/workspaces/${segment(workspaceId)}/semanticModels/${segment(semanticModelId)}/bindConnection`, "POST", "semantic-model-authoring", { connectionBinding }); }
+  async powerBi(pathName, method, body) {
+    const url = trustedUrl(pathName, powerBiBase, powerBiOrigin);
+    // DAX and deployment identifiers are deliberately sent only to the fixed Microsoft Power BI origin.
+    const response = await fetch(url, { method, redirect: "error", headers: { Authorization: `Bearer ${await this.accessToken("powerbi")}`, ...(body === undefined ? {} : { "Content-Type": "application/json" }) }, ...(body === undefined ? {} : { body: JSON.stringify(body) }) });
+    return this.assert(response);
+  }
+  async triggerRefresh(workspaceId, semanticModelId) { return this.powerBi(`/groups/${segment(workspaceId)}/datasets/${segment(semanticModelId)}/refreshes`, "POST", { notifyOption: "NoNotification" }); }
+  async getRefreshHistory(workspaceId, semanticModelId) { const response = await this.powerBi(`/groups/${segment(workspaceId)}/datasets/${segment(semanticModelId)}/refreshes?$top=5`, "GET"); return response.value ?? []; }
+  async executeDax(workspaceId, semanticModelId, query) { const response = await this.powerBi(`/groups/${segment(workspaceId)}/datasets/${segment(semanticModelId)}/executeQueries`, "POST", { queries: [{ query }], serializerSettings: { includeNulls: true } }); return response.results?.[0]?.tables?.[0]?.rows ?? []; }
+}