@meirblachman/azure-pipelines-visualizer 0.1.9 → 0.1.10

package/README.md

@@ -0,0 +1,76 @@
+# Azure Pipelines Visualizer
+
+An interactive visualizer for Azure DevOps pipelines. Paste a pipeline URL and explore its template hierarchy as an expandable diagram with YAML preview and task documentation links.
+
+## Quick Start
+
+```bash
+npx @meirblachman/azure-pipelines-visualizer
+```
+
+> Requires Node.js ≥ 24 and Azure CLI logged in (`az login`).
+
+Open http://localhost:3001. The command bundles both the API server and web UI.
+
+## CLI Options
+
+```
+Usage: apv [options]
+
+Options:
+  -c, --config <path>  Path to apv.config.json
+  -p, --port <number>  Port to listen on (default: 3001)
+  -h, --help           Show this help message
+  -v, --version        Show version number
+```
+
+Examples:
+
+```bash
+# Use a custom config file and port
+npx @meirblachman/azure-pipelines-visualizer --config ./my-config.json --port 8080
+
+# Short flags work too
+npx @meirblachman/azure-pipelines-visualizer -c ./my-config.json -p 8080
+```
+
+The `PORT` environment variable is still supported as a fallback when `--port` is not specified.
+
+## Usage
+
+1. Paste an Azure DevOps file URL, e.g.:
+   ```
+   https://dev.azure.com/{org}/{project}/_git/{repo}?path=/.pipelines/main.yml
+   ```
+2. Click **Load Pipeline** — the root file and its template references appear as a diagram.
+3. Click any template node to expand it and fetch its contents recursively.
+4. Click an expanded node to view its YAML and task list in the detail panel.
+
+## Disk Cache
+
+Fetched pipeline and template files are cached on disk under `.cache/ado-file-cache` by default, keyed by repo identity, file path, branch, and resolved commit SHA.
+
+You can override the cache location and add custom task documentation links in `apv.config.json`:
+
+```jsonc
+{
+  "cacheDir": ".cache/ado-file-cache",
+  "customTaskDocs": {
+    "OneBranch.Pipeline.Build@1": "https://example.com/docs/build-task"
+  }
+}
+```
+
+## Standalone Binary
+
+Pre-built binaries for Linux, macOS, and Windows are available on the [Releases](https://github.com/Meir017/azure-pipelines-visualizer/releases) page.
+
+```bash
+# Download the binary for your platform from the latest release, then:
+chmod +x apv-linux-x64   # Linux/macOS only
+./apv-linux-x64 --config ./apv.config.json --port 8080
+```
+
+## License
+
+See [repository](https://github.com/Meir017/azure-pipelines-visualizer) for details.

package/dist/index.min.js

@@ -40,7 +40,7 @@ Options:
   -p, --port <number>  Port to listen on (default: 3001)
   -h, --help           Show this help message
   -v, --version        Show version number
-`.trim()),process.exit(0));Ee.version&&(console.log("0.1.9"),process.exit(0));var ja=_a(new URL(".",import.meta.url)),It=Nr(ja,"web"),Na={".html":"text/html; charset=utf-8",".js":"application/javascript",".css":"text/css",".ttf":"font/ttf",".woff":"font/woff",".woff2":"font/woff2",".svg":"image/svg+xml",".png":"image/png",".json":"application/json"};function La(e){let r=Ia(e);return Na[r]??"application/octet-stream"}Ee.config&&kn(Ee.config);M();var S=new O;S.use("/*",wn());S.use("/*",vn({origin:"*"}));S.get("/health",e=>e.json({status:"ok"}));S.get("/api/config/task-docs",e=>{let r=M();return e.json({customTaskDocs:r.customTaskDocs??{}})});S.route("/api",Ce);S.route("/api",ae);S.route("/api",jr);S.all("/api/*",e=>e.json({error:`Not found: ${e.req.path}`},404));S.onError((e,r)=>{if(console.error("Server error:",e.message),e.message.includes("DefaultAzureCredential")||e.message.includes("authentication"))return r.json({error:"Authentication failed. Ensure you are logged in via `az login`.",details:e.message},401);let n=e.message.match(/API error \((\d+)\)/);if(n){let t=Number(n[1]);return r.json({error:e.message},t)}return r.json({error:e.message},500)});S.get("/assets/*",e=>{let r=e.req.path,n=Nr(It,r);if(!Pt(n))return e.notFound();let t=Ot(n);return e.body(t,200,{"Content-Type":La(r),"Cache-Control":"public, immutable, max-age=31536000"})});S.get("*",e=>{let r=Nr(It,"index.html");if(!Pt(r))return e.notFound();let n=Ot(r,"utf-8");return e.html(n)});var Da=Number(Ee.port)||Number(process.env.PORT)||3001;Yr({fetch:S.fetch,port:Da},e=>{console.log(`APV server listening on http://localhost:${e.port}`)});export{S as app};
+`.trim()),process.exit(0));Ee.version&&(console.log("0.1.10"),process.exit(0));var ja=_a(new URL(".",import.meta.url)),It=Nr(ja,"web"),Na={".html":"text/html; charset=utf-8",".js":"application/javascript",".css":"text/css",".ttf":"font/ttf",".woff":"font/woff",".woff2":"font/woff2",".svg":"image/svg+xml",".png":"image/png",".json":"application/json"};function La(e){let r=Ia(e);return Na[r]??"application/octet-stream"}Ee.config&&kn(Ee.config);M();var S=new O;S.use("/*",wn());S.use("/*",vn({origin:"*"}));S.get("/health",e=>e.json({status:"ok"}));S.get("/api/config/task-docs",e=>{let r=M();return e.json({customTaskDocs:r.customTaskDocs??{}})});S.route("/api",Ce);S.route("/api",ae);S.route("/api",jr);S.all("/api/*",e=>e.json({error:`Not found: ${e.req.path}`},404));S.onError((e,r)=>{if(console.error("Server error:",e.message),e.message.includes("DefaultAzureCredential")||e.message.includes("authentication"))return r.json({error:"Authentication failed. Ensure you are logged in via `az login`.",details:e.message},401);let n=e.message.match(/API error \((\d+)\)/);if(n){let t=Number(n[1]);return r.json({error:e.message},t)}return r.json({error:e.message},500)});S.get("/assets/*",e=>{let r=e.req.path,n=Nr(It,r);if(!Pt(n))return e.notFound();let t=Ot(n);return e.body(t,200,{"Content-Type":La(r),"Cache-Control":"public, immutable, max-age=31536000"})});S.get("*",e=>{let r=Nr(It,"index.html");if(!Pt(r))return e.notFound();let n=Ot(r,"utf-8");return e.html(n)});var Da=Number(Ee.port)||Number(process.env.PORT)||3001;Yr({fetch:S.fetch,port:Da},e=>{console.log(`APV server listening on http://localhost:${e.port}`)});export{S as app};
 /*! Bundled license information:
 
 js-yaml/dist/js-yaml.mjs:

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@meirblachman/azure-pipelines-visualizer",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "Visualize Azure Pipelines template trees as interactive diagrams",
   "type": "module",
   "bin": {
     "apv": "dist/index.min.js"
   },
   "files": [
-    "dist/"
+    "dist/",
+    "README.md"
   ],
   "repository": {
     "type": "git",